شابلون:بلگه‌له‌مه/بلگه اوچون قایناغا باخین

<noinclude>{{pp-semi-indef}}
</noinclude>{{ایشتیباه اولماسین|شابلون:بلگه‌نین آلت صفحه‌سی}}
{{Documentation subpage}}
{{Template shortcut|doc}}
{{High-use}}
{{Lua|Module:Documentation}}
{{Nosubst}}

{{Template link expanded|بلگه‌له‌مه}} شابلونو عادتن /بلگه آلت صفحه‌سیندن موعین شابلونون [[WP:TDOC|سندلشدیریلمیش معلوماتلارینی و تعلیماتلارینی]] ایحتیوا ائتمک اوچون ایستیفاده اولونور. همچنین بو شابلونون تظیملریله مضمونلاری آیری صفحه‌لردن یوکله‌ییب و یا موستقیم شکلیده متنلریله یارادتماق اولار.

بو شابلوندان نئجه و نه واخت ایستیفاده ائتمک باره‌ده ایضافه تعلیماتلار اوچون [[ویکی‌پدیا:شابلون بلگه‌له‌مه]] (قیسایول: [[WP:TDOC]]) باخین.

بو شابلون ایکی حیصه‌دن عیبارتدیر: بویوک «سند قوتوسو» ابزارلار پانلینین یانیندا سندلرین ایچریسینده (<code>[باخ][دییشدیر][گئچمیش][تمیزله‌مه]</code> لینکلری) و [[Wikipedia:Template sandbox and test cases|قوم قوتوسو و سیناق کئچیدلری]] ایله یاناشی سندلر حاقیندا متادیتانی گوسترن داها کیچیک «باغلانتلی قوتوسو».

بو شابلوندان ایستیفاده هر کسه سندلری و بؤلمه‌لری دییشیک ائتمک ایجازه وئررکن، لازیم اولدوقدا شابلونلاری [[ویکی‌پدیا:قوْروما سیاستی|موحافیظه]] ائتمیه ایمکان وئریر.

== عومومی قرامری ==
نورمالدا شابلون پارامترسیز ایستیفاده اولونور و شابلون صفحه‌سینین آشاغی قیسمتینده {{Tag|noinclude}} داخیلینده یئرلشدیریلیر. (ایضافه معلومات اوچون {{Section link|#یئرلشدیرمه و تگ‌لر}}.

<syntaxhighlight lang="text">
<!--شابلون کودونوزون سون سطری--><noinclude>
{{بلگه‌له‌مه}}
<!-- /بلگه آلت صفحه‌سینه بؤلمه‌لری علاوه ائدین -->
</noinclude>
</syntaxhighlight>

=== فرقیلی بیر صفحه‌نین یئرلشدیرمه‌سی ===
/بلگه آلت صفحه‌سیندن باشقا صفحه‌نی داخیل ائتمک اوچون ساده‌جه {{Para|1}} یازین:

<syntaxhighlight lang="text">
<!--شابلون کودونوزون سون سطری--><noinclude>
{{بلگه‌له‌مه|شابلون:باشقا صفحه/بلگه}}
</noinclude>
</syntaxhighlight>

قید ائدک کی، سندلری یئرلی /بلگه آلت صفحه‌سیندن باشقا صفحه‌دن یوکلیرکن بؤلمه‌لری ایداره ائتمک چتینلشیر.

=== {{Para|content}} پارامتریندن ایستیفاده ائتمک ===
سندلر همچینین {{Para|content}} پارامتریندن ایستیفاده ائتمکله بیرباشا ({{فارسجا|مستقیم}}) متن کیمی وئریله بیلر:

<syntaxhighlight lang="text">
<!--شابلون کودونوزون سون سطری--><noinclude>
{{بلگه‌له‌مه
 | content =
<!-- شابلون سندلری -->
}}</noinclude>
</syntaxhighlight>

بو پارامتردن ایستیفاده ائدرکن ابزارلار پانلی گورونمه‌یه‌جک. قید ائدک کی، لینک قوتوسونداکی /بلگه آلت صفحه‌سی مووجود اولسا دا گورونجک.

همچنین نظره آلین کی، {{Para|1}} و {{Para|content}} گوستریلدیکده، {{Para|content}} اوستونلوک ({{فارسجا|اولویت}}) تشکیل ائدیر و همیشه سندلر قوتوسوندا گوستریلیر.

== تکمیللشمیش قرامر ==
=== باشلیغین اویغونلاشدیریلماسی ===
سندلر قوتوسونداکی باشلیق، آدفضاسیندان آسیلی اولاراق دییشیلیر. هر بیر آدفضاسیندا دیفالت ({{فارسجا|پیش‌فرض}}) متن اوچون آشاغیداکی لیسته باخین:

* شابلون آدفضاسی: [[File:Test Template Info-Icon - Version (2).svg|32px|link=[[Wikipedia:Template documentation]]]] '''شابلون بلگه‌له‌مه‌سی'''
* ماژول آدفضاسی: [[File:Test Template Info-Icon - Version (2).svg|32px|link=[[Wikipedia:Template documentation]]]] '''ماژول بلگه‌له‌مه‌سی'''
* باشقا آدفضالاری: '''بلگه‌له‌مه'''

باشلیغی فردیلشدیرمک اوچون، سادجه {{Para|heading}} پارامترینی ایستدیینیز هر شئیه تعیین ائدین، میثال اوچون {{Para|heading|بیلگی قوتوسونون بلگه‌له‌مه‌سی}}

نظره آلین کی، باشلیق پارامتری بوشقالسا، اما موعین ائدیلیبسه (مثلا، {{Para|heading|}}) ابزارلار پانلینین یانینداکی باشلیق گوستریلمه‌یه‌جک.

{{Para|heading-style}} پارامترینه {{Para|heading-style|font-size:150%;color:red;}} کیمی [[Cascading Style Sheets|سی‌اس‌اس]] دَیَرلری وئریله بیلر. او دئییل کی، دیرناق ایشاره‌لرین <code>" "</code> بوراخمالی و سون نوقطلی ویرگول <code>;</code> علاوه ائتملیسینیز.

=== لینک قوتوسونون فردیلشدیریلمه‌سی ===
لینک قوتوسونو فردیلشدیرمک اوچون ساده‌جه {{Para|link box}} تعیین ائدین باشقا بیر شئی اوچون، {{Para|link box|یوخاریداکی سندلر [[شابلون:Foo]]-دان اوتوماتیک شکلیده یارادیلیر}} کیمی.

لینک قوتوسونو گیزلتمک اوچون ساده‌جه {{Para|link box}}-ی <code>off</code> تعیین ائدین.

=== تست ===
{{Para|page}} پارامتریندن ایستیفاده ائدرک وئریلمیش صفحه‌نین چیخیشینی سیموایاسییا ({{فارسجا|شبیه‌سازی}}) ائده بیلرسینیز. مثلا، {{Para|page|Template:Edit protected}} کودوندان ایستیفاده ائتسنیز، شابلون [[Template:Edit protected]] صفحه‌سینده اولدوغو کیمی داوراناجاق، او جومله‌دن [[Template:Edit protected/doc]]-دن سندلرین گوستریلمه‌سی، [[Template:Edit protected/sandbox]]-یه کئچید و باشقالار. بو پارامتر سیناق اوچون فایدالیدیر و [[Module:Documentation/testcases|ماژول تست نومونه‌لر]] صفحه‌سینده گئنیش شکیلده ایستیفاده اولونور.

== یئرلشدیرمه و تگ‌لر ==
{{Further|ویکی‌پدیا:شابلون بلگه‌له‌مه#هارادا یئرلشدیرمک اولار}}
بو کود شابلون کود صفحه‌سینین آشاغی حیصه‌سینده علاوه ائدیلمه‌لیدیر، {{Tag|noinclude|o}}-دن قاباق بوشلوق یوخدور (بو، شابلونون داخیل ائدیلدییی صفحه‌لرده علاوه بوشلوقلارین گؤرونمه‌سینه سبب اولور):

<syntaxhighlight lang="text"><!--شابلون کودونوزون سون سطری--><noinclude>
{{بلگه‌له‌مه}}
<!-- /بلگه آلت‌صفحه‌سینه بؤلمه‌لری علاوه ائدین -->
</noinclude></syntaxhighlight>

یوخاریداکی متنی اوتوماتیک داخیل ائتمک اوچون سیز همچینین {{tlxs|doc-code}} [[ویکی‌پدیا:عوض‌ائتمه|عوض‌ائتمه]] کودو قیسا یولوندان ایستیفاده ائده بیلرسینیز.

=== بؤلمه‌لر و اینترویکیلر ===
بلگه‌له‌مه‌لرین هارادا یئرلشدیریلمه‌سیندن آسیلی اولاراق، بؤلمه‌لری و اینترویکی‌لری ائداره ائتمک چتین اولا بیلر. بونلاری علاوه ائتمک حاقّیندا معلومات اوچون {{Section link|ویکی‌پدیا:شابلون بلگه‌له‌مه#بؤلمه‌لر و اینترویکی لینکلری}} باخین

== فنی جوزئیات ==
=== اوتوماتیک تابعلر ===


بلگه‌لر صفحه‌سی مؤوجود دئییلسه، ابزارلار پانلی <code>[یارات]</code> لینکی ایله عوض اوْلونور. اوْ، اوتوماتیک اوْلاراق اساس بلگه‌له‌مه قرامری ایله [[mw:Manual:Creating pages with preloaded text|اوّلجه‌دن یۆکلنمیش متنله صفحه یارادیر]]. اوولجه‌دن یۆکلمه متنی همچینین /قارالاما و /تست [یارات] لینکلری اۆچون ایستیفاده اوْلونور.

/بلگه <code>[یارات]</code> لینکی اۆچون قاباقجادان یوکله‌مه صفحه‌سی [[شابلون:بلگه‌له‌مه/قاباقجادان یوکله‌مه]]-دیر. /قارالاما و /تست لینکلری اۆچون قاباقجادان یوکله‌مه صفحه‌لری [[شابلون:بلگه‌له‌مه/قاباقجادان یوکله‌مه-قارالاما]] و [[شابلون:بلگه‌له‌مه/قاباقجادان یوکله‌مه-تست]]-دیر. /قارالاما <code>[آینا]</code> لینکی اۆچون قاباقجادان یوکله‌مه صفحه‌سی [[شابلون:بلگه‌له‌مه/آینا]]-دیر.

بو شابلون همچینین قورونان شابلون صفحه‌سینه اوتوماتیک اوْلاراق {{شابلون|pp-template}} علاوه ائدیر، اوْنا گؤره ده بۇ شابلونو قورونان صفحه‌لره اَل ایله علاوه ائتمه‌یه ائحتیاج یوخدور.

بو شابلون /قارالاما آلت صفحه‌سینده اوْلدوقدا، اوتوماتیک اوْلاراق {{شابلون|Template sandbox notice}} شابلونونو علاوه ائدیر.

=== Link box features ===
Depending on the namespace, the link box may have less features, or may not show up at all. The following table shows this:

{| class="wikitable"
! Namespace 
! Behavior 
|-
| Template
| Full behavior
|-
| Module
| Full behavior, with the addition of a "create documentation" link when the page foes not exist
|-
| User
| Full behavior
|-
| Other namespaces 
| Hidden, unless {{Para|1}} is specified (which will show "The above documentation is transcluded from {{param|1}}")
|}

Alongside that, if {{Para|1}} or {{Para|content}} is specified, the "Add categories to the /doc subpage" will not show.

=== Subject namespaces vs. talk namespaces ===
This template is usually placed in the [[WP:NS#Subject namespaces|subject namespace]]. But in some cases this template needs to be on the [[WP:TALKSPACE|Talk namespace]]:

* In the MediaWiki namespace, since {{Tag|noinclude|o}} often does not work in system messages, and since the MediaWiki namespace needs to be kept clean for performance reasons.

When placed on talk pages, this template usually is placed near the top of the page and without {{Tag|noinclude}} tags.

The /doc, /sandbox and /testcases pages should normally be in the subject namespace, except in the namespaces that do not have the MediaWiki [[meta:Help:Link#Subpage feature|subpage feature]] enabled: Main, File, and MediaWiki. (Categories can have subpages, but documentation is created in the Category talk namespace to prevent creating empty categories. There are also a whole bunch of other technical reasons why the /doc page must be stored under the talk page for those (but only those) namespaces.

This template automatically points its [create] links for the /doc, /sandbox and /testcases to the right namespace.

== بوتون قرامرلر ==
<pre>
{{بلگه‌له‌مه}}

or

{{بلگه‌له‌مه
 | [path to documentation page]
}}

{{بلگه‌له‌مه
 | content =
}}

or

{{بلگه‌له‌مه
| [path to documentation page]
| heading-style = 
| heading = 
| link box = 
}}

or 

{{بلگه‌له‌مه
| [path to documentation page]
| content = 
| heading-style = 
| heading = 
| link box = 
| page =
}}
</pre>

=== رنگلی طرح ===
{| class="wikitable" style="font-size:90%"
|+ {{شابلون|بلگه‌له‌مه}} اوچون ویکی‌پدیانین فون ({{اینگیلیسجه|background}}) رنگلری <small>([[کؤمک:رنگلردن ایستیفاده ائتمک]])</small>
! !! آرجی‌بی !! اچ‌اس‌وی !! رنگ !! عومومی ایستیفاده !! نوت
|-
| A&nbsp;
| <kbd>#ECFCF4</kbd> || 150&deg;, 6%, 99%
| style="background:#ECFCF4" | &nbsp;
| نومونه || جاری بلگه‌له‌مه فونو
|-
| B
| <kbd>#00FF80</kbd>
| style="font-size:90%;" | {{Nowrap|1=Hue=150&deg; <small>(41.7%; 106/255<small>dec</small>)</small> 100%, 100%}}
| style="background:#00FF80" | &nbsp;
| اساس رنگ || ''رنگ'' دیه بیله‌جه‌ییمیز شئی''
|-
| colspan="6" |
|-
| 1
| <kbd>#A3BFB1</kbd> || 150&deg;, 15%, 75%
| style="background:#A3BFB1" | &nbsp;
| تکجه باشلیق حاشیه‌سی ||
|-
| 2
| <kbd>#CEF2E0</kbd> || 150&deg;, 15%, 95%
| style="background:#CEF2E0" | &nbsp;
| اصلی&nbsp;حاشیه؛ باشلیق&nbsp;فونو ||
|-
| 3
| <kbd>#E6FFF2</kbd> || 150&deg;, 10%, 100%
| style="background:#E6FFF2" | &nbsp;
| ۲-نجی باشلیق، وورغو ({{فارسجا|تاکید}}) رنگی ||
|-
| 4
| <kbd>#F5FFFA</kbd> || 150&deg;, 4%, 100%
| style="background:#F5FFFA" | &nbsp;
| اصلی فون || A-دا دویما ({{اینگیلیسجه|saturation}}) بیر آز آشاغیدیر
|}
{{قاتدانان یۇخاری|title=بلگه‌لر اوچون رنگلر ناوباکسی}}
تکلیف اولاراق، بورادا تکجه بلگه صفحه‌لری اوچون نظرده توتولموش ناوباک اوچون رنگلر وئریلمیشدیر.
اونلار معمولی ماوی ناوباکس رنگلرینین کؤلگسینیایزلییرلر:
<pre>
| titlestyle = background:#ccffe5
| basestyle  = background:#ddffee
<!-- basestyle= sets groupstyle, abovestyle, belowstyle together -->
</pre>
آلت قروپلار اوچون، اوشاق ناوباکس قوتولاریندا:
<pre>
{{Navbox|child
| groupstyle = background:#e6fff2
...
</pre>

میثال:{{Template link expanded|Periodic table templates}}
{{قاتدانان آشاغی}}

==همچینین باخ==
* {{شابلون|Documentation subpage}}, a notice placed at the top of a /doc subpage explaining its role and including a link to the page it documents.
* {{شابلون|Barnstar documentation}}, a variant of {{شابلون|Documentation}} for use with [[Wikipedia:Barnstars|barnstar]] templates.
* [[Wikipedia:Template documentation]] is a how-to guide to template documentation.
* [[Wikipedia:Template sandbox and test cases]] explains the use of /sandbox and /testcases subpages and includes more information about template testing.

<includeonly><!-- Make sure that only page [[شابلون:بلگه‌له‌مه]] is categorised. No other page (no subpages, not when transcluded).
 -->{{#ifeq:{{FULLPAGENAME}}|Template:Documentation|
[[Category:Template documentation| ]]
[[بؤلمه:شابلون آدفضاسی شابلونلار|Documentation]]
}}</includeonly>