Sidebar/توضیحات - فراغیب

{{زیرصفحه توضیحات}}
{{لوآ|پودمان:Sidebar}}
{{High-risk|۳٬۲۸۰+}}
<!-----برای تغییرات از این خط به پایین استفاده کنید----->
{{برای|ناوبری‌های افقی پایین مقاله‌ها|الگو:Navbox}}

این [[wikt:Metatemplate|الگوی متا]] برای ساخت نوار الگوی کناری استفاده می‌گردد.  مانند [[ویکی‌پدیا:الگوهای ناوبری|الگوهای ناوبری]] عمودی.



== استفاده==
الگوی عمومی و ساده بدون پارامترهای پیچیده:<pre style="overflow:auto;">
{{نوار جانبی
| name = {{subst:PAGENAME}}
| pretitle = 
| title = 
| image = 
| headingstyle = 
| contentstyle = 

| above = 

| heading1 = 
| content1 = 

| heading2 = 
| content2 = 

| heading3 = 
| content3 = 

<!-- این روند را برای پارامتر بیشتر میتوانید ادامه دهید: -->

| heading35 = 
| content35 = 

| below = 

}}
</pre>

== پارامترها ==

هیچ‌کدام از پارامترها اجباری نیستند, و در صورت دیدن الگوی{{الگو|navbar}}  {{small|{{Smallcaps|ن{{·}}ب{{·}}و}}}} در انتهای الگو می‌توانید الگو را نمایش یا ویرایش ویا در بحث مربوط شرکت نمایید.
===پارامترهای اصلی===
{| class="wikitable" style="line-height:1.4em;"
!style="width:14.0em<!--(cf table below)-->;padding-left:0.25em;text-align:center;"| پارامتر
!style="padding-left:0.5em;text-align:center;"| توضیح
|-
| {{پارا|name}}
|style="padding-left:0.5em;"| نام نوار کناری(جانبی) که در جلوی "Template:" در ابتدای متن الگو قرار می‌گیرد. 
|-
| {{پارا|outertitle}}
|style="padding-left:0.5em;"| نامی که در ابتدای نوار دیده خواهدشد.
|-
| {{پارا|topimage}}
|style="padding-left:0.5em;"| برای گذاردن نگاره(تصویر) دربالای نوار کناری {{پارا|title}} (درصورت لزوم). از سینتاکس ویکی استفاده کنید (مانند <code><nowiki>[[File:...]]</nowiki></code>). <br />برای افزودن توضیح به نگاره از {{پارا|topcaption}} استفاده کنید.
|-
| {{پارا|pretitle}}
|style="padding-left:0.5em;"| Use to place a line such as "Part of the ''X'' series on" before the title.
|-
| {{پارا|title}}
|style="padding-left:0.5em;"| Use to place a title for the sidebar at the top of the sidebar. (If {{پارا|topimage}} is used, it will appear immediately below it).
|-
| {{پارا|image}}
|style="padding-left:0.5em;"| Use to place an image between the {{پارا|title}} (if used) and first section. As with {{پارا|topimage}}, full wiki syntax is expected (i.e. <code><nowiki>[[File:...]]</nowiki></code>). <br />To add a caption below the image, use {{پارا|caption}}.
|-
| {{پارا|headingstyle}}
|style="padding-left:0.5em;"| Use to alter the default [[Help:Cascading Style Sheets|CSS]] styling set for section headings. <br />To alter the CSS styling for a specific section's heading, use {{پارا|heading{{semisub|n}}style}}, where ''n'' is the number of the section.
|-
| {{پارا|contentstyle}}
|style="padding-left:0.5em;"| Use to alter the default CSS styling set for section content. <br />To alter the CSS styling for a particular section's content, use {{پارا|content{{semisub|n}}style}}, where ''n'' is the number of the section.
|-
| {{پارا|heading1}}<br/>{{پارا|content1}}
|style="padding-left:0.5em;"| First section's heading{{\}}content. ''content1'' is required if ''heading1'' is also to appear.
|-
| {{پارا|heading2}}<br/>{{پارا|content2}}
|style="padding-left:0.5em;"| Second section's heading{{\}}content. (''content2'' required if ''heading2'' also to appear; etc.)
|-
| {{پارا|heading3}}<br/>{{پارا|content3}}
|style="padding-left:0.5em;"| Third section's heading{{\}}content.
|-
|colspan="2" style="padding-left:0.5em;"| ...... etc ......
|-
| {{پارا|heading35}}<br/>{{پارا|content35}}
|style="padding-left:0.5em;"| Currently, the last possible section heading and/or content.
|}

===دیگر پارامترها===
<!--Linked from [[Template:Subinfobox bodystyle/doc]]-->
{| class="wikitable plainlist" style="line-height:1.4em;"
!style="width:14.0em<!--(cf table above)-->;padding-left:0.25em;text-align:center;"| پارامتر
!style="padding-left:0.5em;text-align:center;"| توضیح
|-
| {{پارا|above}}
|style="padding-left:0.5em;"| مانند {{پارا|above}} offered by {{الگو|Navbox}}.
|-
|
*{{Nowrap|{{پارا|class}} or {{پارا|bodyclass}}}}
*{{پارا|outertitleclass}}
*{{پارا|topimageclass}}
*{{پارا|pretitleclass}}
*{{پارا|titleclass}}
*{{پارا|imageclass}}
*{{پارا|aboveclass}}
*{{پارا|headingclass}}
*{{پارا|contentclass}}
*{{پارا|belowclass}}
|style="padding-left:0.5em;"|
[[Wikipedia:WikiProject Microformats#What are microformats?|Microformat]] classes for the corresponding parameters. <br />({{پارا|class}} and {{پارا|bodyclass}} are applied across the whole sidebar.)
|-
| {{پارا|below}}
|style="padding-left:0.5em;"| Same as the {{پارا|below}} offered by {{الگو|Navbox}}.<br />(Use, for example, to add one or more portal links to the bottom of the template (shown, by default, in bold).)
|-
|
*{{Nowrap|{{پارا|style}} or {{پارا|bodystyle}}}}
*{{پارا|outertitlestyle}}
*{{پارا|topimagestyle}}
*{{پارا|topcaptionstyle}}
*{{پارا|pretitlestyle}}
*{{پارا|titlestyle}}
*{{پارا|imagestyle}}
*{{پارا|captionstyle}}
*{{پارا|abovestyle}}
*{{پارا|headingstyle}}
*{{پارا|heading{{semisub|n}}style}}
*{{پارا|contentstyle}}
*{{پارا|content{{semisub|n}}style}}
*{{پارا|belowstyle}}
*{{Longitem|{{پارا|navbarstyle}}<br/>{{فاصله|2}}{{smaller|(or {{پارا|tnavbarstyle}})}}}}
|style="padding-left:0.5em;"|
Use to alter the default [[Help:Cascading Style Sheets|CSS]] styling for the corresponding parameters. <br />({{پارا|style}} and {{پارا|bodystyle}} are applied across the whole sidebar.)
|-
| {{پارا|cellspacing}}<br/>{{پارا|cellpadding}}
|style="padding-left:0.5em;"| Use to amend the default cellspacing{{\}}cellpadding set for the infobox-class table with which the sidebar is built.
|-
| {{Longitem|{{پارا|navbar}}{{Nowrap|{{فاصله|2}}{{smaller|(or {{پارا|tnavbar}})}}}}}}
|style="padding-left:0.5em;"| Set to "off", "none", etc (without quotes) to remove the {{الگو|navbar}} links ({{small|{{Smallcaps|V{{·}}T{{·}}E}}}}) that otherwise appear at the bottom of the sidebar.
|-
| {{Longitem|{{پارا|navbarfontstyle}}<br/>{{فاصله|2}}{{smaller|(or {{پارا|tnavbarfontstyle}})}}}}
|style="padding-left:0.5em;"| Use to specify the font style used by the navbar at the bottom of the sidebar (see {{الگو|navbar}} for options available).
|}

== Handling long links ==

{{الگو|Normalwraplink}} may be used to handle links that should wrap within the sidebar or otherwise need to be made to wrap, in order to prevent the sidebar from becoming too wide. Use {{الگوب|normalwraplink|''longlinkname''}}, where {{پارا||''longlinkname''}} is the long link without its square brackets.

Use the {{پارا|wraplinks|true}} parameter to turn link wrapping off for the whole template.

== کدهای جاسازی==

الگوهای نوارکناری را می‌توانید با استفاده‌از {{پارا|child}} در یک الگوی نوار کناری جای دهید.  برای ایجاد یک ماژول نوار کناری, یا برای ساخت بخشهای منطقی بیشتر.

{{نوار جانبی
| title = Top-level title
| content1 =
 {{نوار جانبی|child=yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| content2 =
 {{نوار جانبی|child=yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
<pre style="position:relative;bottom:0.5em; overflow:auto;">
{{نوار جانبی
| title = Top-level title
| content1 =
 {{نوار جانبی|child=yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| content2 =
 {{نوار جانبی|child=yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
</pre>

Note in the examples above that the child sidebar is placed in a {{Code|content}} field, not a {{Code|heading}} field. Notice also that the section subheadings do not appear in bold if this is not explicitly specified. To obtain bold section headings, place the child sidebar in a {{Code|heading}} field, using either:

{{نوار جانبی
| title = Top-level title
| heading1 =
 {{نوار جانبی|child=yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| heading2 =
 {{نوار جانبی|child=yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
<pre style="position:relative;bottom:0.5em; overflow:auto;">
{{نوار جانبی
| title = Top-level title
| heading1 =
 {{نوار جانبی|child=yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| heading2 =
 {{نوار جانبی|child=yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
</pre>

or:

{{نوار جانبی
| title = Top-level title
| heading1 = First subsection
 {{نوار جانبی|child=yes
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| heading2 = Second subsection
 {{نوار جانبی|child=yes
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
<pre style="position:relative;bottom:0.5em; overflow:auto;">
{{نوار جانبی
| title = Top-level title
| heading1 = First subsection
 {{نوار جانبی|child=yes
  | heading1 = Heading 1.1
  | content1 = Content 1.1
 }}
| heading2 = Second subsection
 {{نوار جانبی|child=yes
  | heading1 = Heading 2.1
  | content1 = Content 2.1
 }}
| below = "below" text
}}
</pre>

Note that omitting the {{پارا|title}} parameter and not including any text preceding the embedded sidebar may result in the creation of gaps by spurious blank rows.

== '''سینتاکس کامل الگو''' ==
{{Generic template demo |name= |outertitle |topimage |pretitle |title |image |caption |above |heading1 |content1 |heading2 |content2 |heading3 |content3 |content4=''…… etc ……'' |heading35 |content35 |below}}

(omitting heading4/content4 to penultimate heading/content parameters)

<pre style="overflow:auto;">
{{نوار جانبی
| name = {{subst:PAGENAME}}
| class =            <!-- or: | bodyclass = -->
| style =            <!-- or: | bodystyle = -->
| width = 
| cellspacing = 
| cellpadding = 
| wraplinks =        <!-- "true" otherwise (default:) omit -->

| outertitleclass = 
| outertitlestyle = 
| outertitle = 

| topimageclass = 
| topimagestyle = 
| topimage = 
| topcaptionstyle = 
| topcaption = 

| pretitleclass = 
| pretitlestyle = 
| pretitle = 

| titleclass = 
| title = 

| imageclass = 
| imagestyle = 
| image = 
| captionstyle = 
| caption = 

| headingclass = 
| headingstyle = 
| contentclass = 
| contentstyle = 

| aboveclass = 
| abovestyle = 
| above = 

| heading1style = 
| heading1 = 
| content1style = 
| content1 = 

| heading2style = 
| heading2 = 
| content2style = 
| content2 = 

| heading3style = 
| heading3 = 
| content3style = 
| content3 = 

<!-- etc, to: -->

| heading35style = 
| heading35 = 
| content35style = 
| content35 = 

| belowclass = 
| belowstyle = 
| below = 

| navbarstyle =      <!-- or: | tnavbarstyle = -->
| navbarfontstyle =  <!-- or: | tnavbarfontstyle = -->
| navbar =           <!-- or: | tnavbar = --> <!-- "off", "none", etc otherwise (default:) omit -->

}}
</pre>

== Supplementary documentation ==

Supplementary related documentation (concerning {{الگو|navbar}} use within a sidebar) is at [[Template:Navbar/doc]].

== همچنین ببینید ==
* [https://en.wikipedia.org/w/index.php?title=Template:Sidebar&oldid=609911857 Last pre-Lua version]
* {{الگو|Sidebar with collapsible lists}}
* {{الگو|Infobox}}
* [[ویکی‌پدیا:شیوه‌نامه/فهرست‌ها]], for help using unbulleted lists within content.
 
<includeonly>
{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}} |
[[رده:الگو:کناری| ]]
[[رده:فراالگوهای ویکی‌پدیا]]
[[رده:جعبه‌های ناوبری| ]]
[[رده:مستثنی از چاپ]]
}}
</includeonly>