برگه:The Blind Owl.pdf/۹۰

<mediawiki xmlns="http://www.mediawiki.org/xml/export-0.11/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mediawiki.org/xml/export-0.11/ http://www.mediawiki.org/xml/export-0.11.xsd" version="0.11" xml:lang="fa">
  <siteinfo>
    <sitename>ویکی‌نبشته</sitename>
    <dbname>fawikisource</dbname>
    <base>https://fa.wikisource.org/wiki/%D8%B5%D9%81%D8%AD%D9%87%D9%94_%D8%A7%D8%B5%D9%84%DB%8C</base>
    <generator>MediaWiki 1.47.0-wmf.24</generator>
    <case>first-letter</case>
    <namespaces>
      <namespace key="-2" case="first-letter">مدیا</namespace>
      <namespace key="-1" case="first-letter">ویژه</namespace>
      <namespace key="0" case="first-letter" />
      <namespace key="1" case="first-letter">بحث</namespace>
      <namespace key="2" case="first-letter">کاربر</namespace>
      <namespace key="3" case="first-letter">بحث کاربر</namespace>
      <namespace key="4" case="first-letter">ویکی‌نبشته</namespace>
      <namespace key="5" case="first-letter">بحث ویکی‌نبشته</namespace>
      <namespace key="6" case="first-letter">پرونده</namespace>
      <namespace key="7" case="first-letter">بحث پرونده</namespace>
      <namespace key="8" case="first-letter">مدیاویکی</namespace>
      <namespace key="9" case="first-letter">بحث مدیاویکی</namespace>
      <namespace key="10" case="first-letter">الگو</namespace>
      <namespace key="11" case="first-letter">بحث الگو</namespace>
      <namespace key="12" case="first-letter">راهنما</namespace>
      <namespace key="13" case="first-letter">بحث راهنما</namespace>
      <namespace key="14" case="first-letter">رده</namespace>
      <namespace key="15" case="first-letter">بحث رده</namespace>
      <namespace key="100" case="first-letter">درگاه</namespace>
      <namespace key="101" case="first-letter">بحث درگاه</namespace>
      <namespace key="102" case="first-letter">پدیدآورنده</namespace>
      <namespace key="103" case="first-letter">بحث پدیدآورنده</namespace>
      <namespace key="104" case="first-letter">برگه</namespace>
      <namespace key="105" case="first-letter">گفتگوی برگه</namespace>
      <namespace key="106" case="first-letter">فهرست</namespace>
      <namespace key="107" case="first-letter">گفتگوی فهرست</namespace>
      <namespace key="710" case="first-letter">TimedText</namespace>
      <namespace key="711" case="first-letter">TimedText talk</namespace>
      <namespace key="828" case="first-letter">پودمان</namespace>
      <namespace key="829" case="first-letter">بحث پودمان</namespace>
      <namespace key="1728" case="first-letter">Event</namespace>
      <namespace key="1729" case="first-letter">Event talk</namespace>
    </namespaces>
  </siteinfo>
  <page>
    <title>برگه:The Blind Owl.pdf/۹۰</title>
    <ns>104</ns>
    <id>46734</id>
    <revision>
      <id>305358</id>
      <parentid>299278</parentid>
      <timestamp>2026-10-26T15:25:02Z</timestamp>
      <contributor>
        <username>Charan Gill</username>
        <id>6444</id>
      </contributor>
      <comment>/* هم‌سنجی‌شده */</comment>
      <origin>305358</origin>
      <model>proofread-page</model>
      <format>text/x-wiki</format>
      <text bytes="1865" sha1="gd05dhnab1kcsana8yphbekpb6ijbmx" xml:space="preserve">&lt;noinclude&gt;&lt;pagequality level=&quot;4&quot; user=&quot;Charan Gill&quot; /&gt;{{سرصفحه‌مستمر|۹۰||}}&lt;/noinclude&gt;شبیه لبهای زنم بود - لبهای او طعم کونه خیار میداد - تلخ مزه و گس بود، لابد لبهای ان لکاته هم همین طعم را داشت.

«در همینوقت دیدم پدرش - آن پیرمرد قوزی که شال گردن بسته بود از در خانه بیرون آمد بی آنکه بطرف من نگاه بکند رد شد، بریده بریده میخندید، خنده ترسناکی بود که مو را بتن آدم راست میکرد و شانه‌هایش از شدت خنده میلرزید، از زور خجالت میخواستم بزمین فرو بروم - نزدیک غروب شده بود بلند شدم، مثل اینکه میخواستم از خودم فرار بکنم. بدون اراده راه خانه را پیش گرفتم، هیچکس و هیچ چیز را نمیدیدیم، بنظرم میامد که از میان یک شهر مجهول و ناشناس حرکت میکردم. خانه‌های عجیب و غریب به اشکال بریده بریده هندسی  با دریچه‌های متروک سیاه اطراف من بود، مثل این بود که هرگز یک جنبنده نمیتوانست در آنها مسکن داشته باشد ولی دیوارهای سفید آنها با روشنائی ناخوشی میدرخشید و چیزیکه غریب بود، چیزیکه نمیتوانستم باور بکنم در مقابل هر یک ازین دیوارها میایستادم جلو مهتاب سایه‌ام بزرگ و غلیظ بدیوار میافتاد ولی بدون سر بود - سایه‌ام سر نداشت - شنیده بودم که اگر سایه کسی سر نداشته باشد تا سر سال میمیرد.

«هراسان وارد خانه‌ام شدم و به اطاقم پناه&lt;noinclude&gt;&lt;/noinclude&gt;</text>
      <sha1>gd05dhnab1kcsana8yphbekpb6ijbmx</sha1>
    </revision>
  </page>
  <page>
    <title>برگه:The Blind Owl.pdf/۹۱</title>
    <ns>104</ns>
    <id>46735</id>
    <revision>
      <id>305359</id>
      <parentid>299279</parentid>
      <timestamp>2026-10-26T16:22:51Z</timestamp>
      <contributor>
        <username>Charan Gill</username>
        <id>6444</id>
      </contributor>
      <comment>/* هم‌سنجی‌شده */</comment>
      <origin>305359</origin>
      <model>proofread-page</model>
      <format>text/x-wiki</format>
      <text bytes="1764" sha1="8t3y3de6okrwe7jz1agjaj5fw8st6g1" xml:space="preserve">&lt;noinclude&gt;&lt;pagequality level=&quot;4&quot; user=&quot;Charan Gill&quot; /&gt;{{سرصفحه‌مستمر|۹۱||}}&lt;/noinclude&gt;بردم، در همینوقت خوندماغ شدم و بعد از آنکه مقدار زیادی خون از دماغم رفت بیهوش در رختخوابم افتادم.- دایه‌ام مشغول پرستاری من شد.

«قبل از اینکه بخوابم در آینه بصورت خود نگاه کردم، دیدم صورتم شکسته محو و بی روح شده بود. بقدری محو بود که خودم را نمیشناختم - رفتم در رختخواب لحاف را روی سرم کشیدم غلت زدم، رویم را بطرف دیوار کردم، پاهایم را جمع کردم، چشمهایم را بستم و دنباله خیالات خودم را گرفتم - این رشته‌هائی که سرنوشت تاریک، غم‌انگیز، مهیب و پر از کیف مرا تشکیل میداد - آنجائیکه زندگی با مرگ بهم آمیخته میشود و تصویرهای منحرف شده بوجود میاید، میل‌های کشته شده دیرین، میلهای محو شده و خفه شده دوباره زنده میشوند و فریاد انتقام میکشند - در اینوقت از طبیعت و دنیای ظاهری کنده میشدم و حاضر بودم که در جریان ازلی محو و نابود بشوم - چندبار با خودم زمزمه کردم: «مرگ.. مرگ.. کجایی؟» همین بمن تسکین داد و چشمهایم بهم رفت.

«چشمهایم که بسته شد دیدم در {{w|میدان محمدیه}} بودم. دار بلندی برپا کرده بودند و پیرمرد خنزرپنزری جلو اطاقم را به چوبه دار آویخته بودند - چند نفر {{w|داروغه}}&lt;noinclude&gt;&lt;/noinclude&gt;</text>
      <sha1>8t3y3de6okrwe7jz1agjaj5fw8st6g1</sha1>
    </revision>
  </page>
  <page>
    <title>برگه:The Blind Owl.pdf/۹۲</title>
    <ns>104</ns>
    <id>46737</id>
    <revision>
      <id>305363</id>
      <parentid>299280</parentid>
      <timestamp>2026-10-27T02:43:20Z</timestamp>
      <contributor>
        <username>Charan Gill</username>
        <id>6444</id>
      </contributor>
      <comment>/* هم‌سنجی‌شده */</comment>
      <origin>305363</origin>
      <model>proofread-page</model>
      <format>text/x-wiki</format>
      <text bytes="1877" sha1="eunlu5zpomowbp87fho01f5vvnhsrpf" xml:space="preserve">&lt;noinclude&gt;&lt;pagequality level=&quot;4&quot; user=&quot;Charan Gill&quot; /&gt;{{سرصفحه‌مستمر|۹۲||}}&lt;/noinclude&gt;مست پای دار شراب میخوردند - مادرزنم با صورت برافروخته با صورتی که در موقع اوقات تلخی زنم حالا می‌بینم که رنگ لبش میپرد و چشمهایش گرد و وحشت زده میشود، دست مرا میکشید از میان مردم رد میکرد و به میرغضب که لباس سرخ پوشیده بود نشان میداد و میگفت: «اینم دار بزنین» من هراسان از خواب پریدم - مثل کوره میسوختم، تنم خیس عرق بود و حرارت سوزانی روی گونه‌هایم شعله‌ور بود - برای اینکه خودم را از دست این کابوس برهانم. بلند شدم آب خوردم و کمی بسرورویم زدم، دوباره خوابیدم ولی خواب بچشمم نمیامد. در سایه روشن اطاق به کوزه آب که روی رف بود خیره شده بودم، بنظرم آمد تا مدتی که کوزه روی رف است خوابم نخواهد برد - یکجور ترس بی جا برایم تولید شده بودکه کوزه خواهد افتاد، بلند شدم که جای کوزه را محفوظ کنم، ولی بواسطه تحریک مجهولی که خودم ملتفت نبودم دستم عمداً بکوزه خورد، کوزه افتاد و شکست. بالاخره پلکهای چشمم را بهم فشار دادم اما بخیالم رسید که دایه‌ام بلند شده بمن نگاه میکند، مشتهای خودم را زیر لحاف گره کردم ولی هیچ اتفاق فوق العاده‌ای رخ نداده بود. در حالت اغما صدای در کوچه را شنیدم، صدای پای دایه‌ام را شنیدم که نعلینش را بزمین میکشید و&lt;noinclude&gt;&lt;/noinclude&gt;</text>
      <sha1>eunlu5zpomowbp87fho01f5vvnhsrpf</sha1>
    </revision>
  </page>
  <page>
    <title>ویکی‌نبشته:دفترخانه</title>
    <ns>4</ns>
    <id>66717</id>
    <revision>
      <id>305357</id>
      <parentid>305250</parentid>
      <timestamp>2026-10-26T14:01:21Z</timestamp>
      <contributor>
        <username>MediaWiki message delivery</username>
        <id>7756</id>
      </contributor>
      <comment>/* ویکی شما به زودی در حالت فقط خواندن قرار خواهد گرفت */ بخش جدید</comment>
      <origin>305357</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="101866" sha1="d0fhafd36dcw9cyijhlgi81rt4qzw6u" xml:space="preserve">{{سردر دفترخانه}}

== بازبینی سالانهٔ آیین‌نامهٔ فراگیر رفتاری: تغییرات پیشنهادی برای نظرخواهی در دسترس‌اند ==

&lt;div lang=&quot;fa&quot; dir=&quot;rtl&quot; class=&quot;mw-content-ltr&quot;&gt;
{{Int:Please-translate}}.

این پیام را برای اطلاع‌رسانی دربارهٔ [[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review/Proposed_Changes|تغییرات پیشنهادی]] در [[foundation:Special:MyLanguage/Policy:Universal_Code_of_Conduct/Enforcement_guidelines|آیین‌نامهٔ فراگیر رفتاری (UCoC)]] و [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|هیئت هماهنگی (U4C)]] ارسال می‌کنم که برای بررسی و ارائهٔ بازخورد در دسترس هستند. '''[[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review/Proposed_Changes|می‌توانید تا پایان روز سه‌شنبه، ۱۸ مارس ۲۰۲۵ بازخورد خود را دربارهٔ تغییرات پیشنهادی ارائه دهید]]'''. این مرحلهٔ دوم از فرایند بازبینی سالانه است و مرحلهٔ نهایی شامل رأی‌گیری جامعه دربارهٔ تغییرات پیشنهادی خواهد بود.
[[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review|برای اطلاعات بیشتر و یافتن پیوندهای مرتبط، صفحهٔ بازبینی سالانهٔ آیین‌نامهٔ فراگیر رفتاری را در فراویکی ببینید]].

[[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|هیئت هماهنگی]] (U4C) یک گروه جهانی است که به اجرای عادلانه و یکپارچهٔ آیین‌نامهٔ فراگیر رفتاری اختصاص دارد. این بازبینی سالانه توسط هیئت هماهنگی برنامه‌ریزی و اجرا شده است. برای اطلاعات بیشتر دربارهٔ مسئولیت‌های هیئت هماهنگی، '''[[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|منشور هیئت هماهنگی را بررسی کنید]]'''.

لطفاً این اطلاعات را با سایر اعضای جامعهٔ خود در مکان‌های مناسب به اشتراک بگذارید.

-- در همکاری با هیئت هماهنگی، [[m:User:Keegan (WMF)|Keegan (WMF)]] مارس ۲۰۲۵، ساعت ۱۸:۵۱ (UTC)

-- ترجمه به فارسی [[کاربر:Darafsh|&lt;span style=&quot;color:Purple; text-shadow:grey 0.1em 0.2em 0.1em;&quot;&gt;درفش کاویانی&lt;/span&gt;]] ([[بحث کاربر:Darafsh|&lt;span title=&quot;پیام بگذارید!&quot; style=&quot;cursor: crosshair;&quot;&gt;بحث&lt;/span&gt;]]) ۱۵ مارس ۲۰۲۵، ساعت ۰۳:۰۸ (UTC)

&lt;/div&gt;

&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28307738 ارسال شده است --&gt;
{{آغاز تاشو | bg=#fafad2 |عنوان = متن اصلی به زبان انگلیسی}}
== Universal Code of Conduct annual review: proposed changes are available for comment ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
My apologies for writing in English.
{{Int:Please-translate}}.

I am writing to you to let you know that [[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review/Proposed_Changes|proposed changes]] to the [[foundation:Special:MyLanguage/Policy:Universal_Code_of_Conduct/Enforcement_guidelines|Universal Code of Conduct (UCoC) Enforcement Guidelines]] and [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|Universal Code of Conduct Coordinating Committee (U4C) Charter]] are open for review. '''[[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review/Proposed_Changes|You can provide feedback on suggested changes]]''' through the [[d:Q614092|end of day]] on Tuesday, 18 March 2025. This is the second step in the annual review process, the final step will be community voting on the proposed changes.
[[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review|Read more information and find relevant links about the process on the UCoC annual review page on Meta]].

The [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee]] (U4C) is a global group dedicated to providing an equitable and consistent implementation of the UCoC. This annual review was planned and implemented by the U4C. For more information and the responsibilities of the U4C, [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|you may review the U4C Charter]].

Please share this information with other members in your community wherever else might be appropriate.

-- In cooperation with the U4C, [[m:User:Keegan (WMF)|Keegan (WMF)]] ۷ مارس ۲۰۲۵، ساعت ۱۸:۵۱ (UTC)
{{پایان تاشو}}
== ویکی شما به زودی در حالت فقط خواندنی قرار خواهد گرفت ==

&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;

[[:m:Special:MyLanguage/Tech/Server switch|این خبرنامه را در زبان دیگری بخوانید]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

بنیاد ویکی مدیا در نظر دارد تا مرکز ثانویه داده خود را به آزمایش بگذارد. این امر سبب می‌شود که ویکی‌پدیا و دیگر ویکی‌های ویکی‌مدیا حتی پس از حوادث نیز برخط بمانند.

&lt;span class=&quot;mw-translate-fuzzy&quot;&gt;عملیات سوئیچ یا همان بازگشت ترافیک کاربران به مرکز داده اصلی در روز '''{{#time:j xg|2025-03-19|fa}}''' انجام می گیرد.&lt;/span&gt; آزمون در  '''[https://zonestamp.toolforge.org/{{#time:U|2025-03-19T14:00|en}} {{#time:H:i e|2025-03-19T14:00}}]''' ساعت هماهنگ جهانی.

متاسفانه به دلیل برخی از محدودیت ها در [[mw:Special:MyLanguage/Manual:What is MediaWiki?|ویکی‌مدیا]]، تمام ویرایش‌ها همزمان با فرآیند عملیات سوئیج متوقف خواهند شد. پیشاپیش به‌خاطر این مشکلات عذرخواهی می‌کنیم و برآنیم تا در آینده چنین اتفاقاتی را به حداقل برسانیم. 

30 دقیقه قبل از اجرای تست، یک بنر اطلاع‌رسانی در همه ویکی‌ها نمایش داده خواهد شد. &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;This banner will remain visible until the end of the operation.&lt;/span&gt; 

'''شما می‌توانید مقالات ویکی‌ها را بخوانید،‌ ولی قابلیت ویرایش برای مدت کوتاهی غیرفعال خواهد شد.'''

*به مدت یک ساعت در {{#time:l j xg Y|2025-03-19|fa}} نمی توانید ویرایش کنید.
*اگر در زمان‌های نام برده تلاش کنید مقاله‌ای را ویرایش یا ذخیره کنید، پیام خطایی را مشاهده خواهید کرد. ما امیدواریم که ویرایشی در زمان های نام برده از بین نرود ولی نمی توانیم این امر را تضمین کنیم. اگر پیام خطا را مشاهده کردید، لطفا تا بازگشت همه چیز به حالت عادی شکیبا باشید. بعد از آن شما باید بتوانید که تغییرات را ذخیره کنید. ولی توصیخ می‌کنیم که برای آسودگی خاطر یک کپی از تغییراتتان تهیه کنید.

''اثرات دیگر'':

*کارهای پس زمینه کندتر خواهند بود و بعضی از انها شاید  رها شوند. ممکن است لینک های قرمز  به سرعت عادی خود اپدیت نشوند. اگر مقاله ای که در جایی دیگر لینک شده را بوجود آورید، لینک آن مدت زمانی طولانی‌تر قرمز خواهند بود. برخی از اسکریپت های سنگین متوقف خواهند شد.
* &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;We expect the code deployments to happen as any other week.&lt;/span&gt; &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;However, some case-by-case code freezes could punctually happen if the operation require them afterwards.&lt;/span&gt;
* [[mw:Special:MyLanguage/GitLab|گیت‌لب]] برای ۹۰ دقیقه قابل دسترس نخواهد بود.

این پروژه ممکن است در صورت لزوم به تعویق بیفتد. شما می توانید  [[wikitech:Switch_Datacenter|برنامه را در  wikitech.wikimedia.org]] مطالعه کنید. هر تغییری از پیش در برنامه اعلان خواهد شد. 

'''لطفا این اطلاعات را با دیگران در اشتراک بگذارید.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[User:MediaWiki message delivery|MediaWiki message delivery]]&lt;/bdi&gt; ۱۴ مارس ۲۰۲۵، ساعت ۲۳:۱۵ (UTC)

&lt;!-- پیام توسط کاربر:Quiddity (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=28307742 ارسال شده است --&gt;

== سالنامه‌نگاری ==

یکی از کارهایی که به نظرم می‌تواند خیلی به ویکی‌پدیا و البته علاقه‌مندان تاریخ کمک کند  این است که اگر وقت اجازه می‌داد سالنامه‌ها (یا همان مقالات سال‌های قمری و شمسی) در ویکی‌پدیا را با اطلاعاتی که از کتب تاریخی در ویکی‌نبشته خوانده و هم‌سنجی می‌کنیم تکمیل کنیم. به نظرم این کار به شدت به غنای مقالات تاریخی ویکی‌پدیا کمک می‌کند. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۱۹ مارس ۲۰۲۵، ساعت ۰۹:۰۱ (UTC)

== Final proposed modifications to the Universal Code of Conduct Enforcement Guidelines and U4C Charter now posted ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
The proposed modifications to the [[foundation:Special:MyLanguage/Policy:Universal_Code_of_Conduct/Enforcement_guidelines|Universal Code of Conduct Enforcement Guidelines]] and the U4C Charter [[m:Universal_Code_of_Conduct/Annual_review/2025/Proposed_Changes|are now on Meta-wiki for community notice]] in advance of the voting period. This final draft was developed from the previous two rounds of community review. Community members will be able to vote on these modifications starting on 17 April 2025. The vote will close on 1 May 2025, and results will be announced no later than 12 May 2025. The U4C election period, starting with a call for candidates, will open immediately following the announcement of the review results. More information will be posted on [[m:Special:MyLanguage//Universal_Code_of_Conduct/Coordinating_Committee/Election|the wiki page for the election]] soon.

Please be advised that this process will require more messages to be sent here over the next two months. 

The [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee (U4C)]] is a global group dedicated to providing an equitable and consistent implementation of the UCoC. This annual review was planned and implemented by the U4C. For more information and the responsibilities of the U4C, you may [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|review the U4C Charter]].

Please share this message with members of your community so they can participate as well.

-- In cooperation with the U4C, [[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User_talk:Keegan (WMF)|talk]]) ۴ آوریل ۲۰۲۵، ساعت ۰۲:۰۵ (UTC)
&lt;/div&gt;
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28469465 ارسال شده است --&gt;

== Vote now on the revised UCoC Enforcement Guidelines and U4C Charter ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;

The voting period for the revisions to the Universal Code of Conduct Enforcement Guidelines (&quot;UCoC EG&quot;) and the UCoC's Coordinating Committee Charter is open now through the end of 1 May (UTC) ([https://zonestamp.toolforge.org/1746162000 find in your time zone]). [[m:Special:MyLanguage/Universal_Code_of_Conduct/Annual_review/2025/Voter_information|Read the information on how to participate and read over the proposal before voting]] on the UCoC page on Meta-wiki.

The [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee (U4C)]] is a global group dedicated to providing an equitable and consistent implementation of the UCoC. This annual review of the EG and Charter was planned and implemented by the U4C. Further information will be provided in the coming months about the review of the UCoC itself. For more information and the responsibilities of the U4C, you may [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Charter|review the U4C Charter]].

Please share this message with members of your community so they can participate as well.

In cooperation with the U4C -- [[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User_talk:Keegan (WMF)|talk]]) ۱۷ آوریل ۲۰۲۵، ساعت ۰۰:۳۵ (UTC)
&lt;/div&gt;
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28469465 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Vote on proposed modifications to the UCoC Enforcement Guidelines and U4C Charter&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
The voting period for the revisions to the Universal Code of Conduct Enforcement Guidelines and U4C Charter closes on 1 May 2025 at 23:59 UTC ([https://zonestamp.toolforge.org/1746162000 find in your time zone]). [[m:Special:MyLanguage/Universal Code of Conduct/Annual review/2025/Voter information|Read the information on how to participate and read over the proposal before voting]] on the UCoC page on Meta-wiki.

The [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee|Universal Code of Conduct Coordinating Committee (U4C)]] is a global group dedicated to providing an equitable and consistent implementation of the UCoC. This annual review was planned and implemented by the U4C. For more information and the responsibilities of the U4C, you may [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee/Charter|review the U4C Charter]].

Please share this message with members of your community in your language, as appropriate, so they can participate as well.

In cooperation with the U4C -- &lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
[[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]]) ۲۹ آوریل ۲۰۲۵، ساعت ۰۳:۴۱ (UTC)&lt;/div&gt;
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28618011 ارسال شده است --&gt;

== We will be enabling the new Charts extension on your wiki soon! ==

''(Apologies for posting in English)''

Hi all! We have good news to share regarding the ongoing problem with graphs and charts affecting all wikis that use them.

As you probably know, the [[:mw:Special:MyLanguage/Extension:Graph|old Graph extension]] was disabled in 2023 [[listarchive:list/wikitech-l@lists.wikimedia.org/thread/EWL4AGBEZEDMNNFTM4FRD4MHOU3CVESO/|due to security reasons]]. We’ve worked in these two years to find a solution that could replace the old extension, and provide a safer and better solution to users who wanted to showcase graphs and charts in their articles. We therefore developed the [[:mw:Special:MyLanguage/Extension:Chart|Charts extension]], which will be replacing the old Graph extension and potentially also the [[:mw:Extension:EasyTimeline|EasyTimeline extension]].

After successfully deploying the extension on Italian, Swedish, and Hebrew Wikipedia, as well as on MediaWiki.org, as part of a pilot phase, we are now happy to announce that we are moving forward with the next phase of deployment, which will also include your wiki.

The deployment will happen in batches, and will start from '''May 6'''. Please, consult [[:mw:Special:MyLanguage/Extension:Chart/Project#Deployment Timeline|our page on MediaWiki.org]] to discover when the new Charts extension will be deployed on your wiki. You can also [[:mw:Special:MyLanguage/Extension:Chart|consult the documentation]] about the extension on MediaWiki.org.

If you have questions, need clarifications, or just want to express your opinion about it, please refer to the [[:mw:Special:MyLanguage/Extension_talk:Chart/Project|project’s talk page on Mediawiki.org]], or ping me directly under this thread. If you encounter issues using Charts once it gets enabled on your wiki, please report it on the [[:mw:Extension_talk:Chart/Project|talk page]] or at [[phab:tag/charts|Phabricator]].

Thank you in advance! -- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) ۶ مهٔ ۲۰۲۵، ساعت ۱۵:۰۸ (UTC)
&lt;!-- پیام توسط کاربر:Sannita (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Sannita_(WMF)/Mass_sending_test&amp;oldid=28663781 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Call for Candidates for the Universal Code of Conduct Coordinating Committee (U4C)&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
The results of voting on the Universal Code of Conduct Enforcement Guidelines and Universal Code of Conduct Coordinating Committee (U4C) Charter is [[m:Special:MyLanguage/Universal Code of Conduct/Annual review/2025#Results|available on Meta-wiki]].

You may now [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee/Election/2025/Candidates|submit your candidacy to serve on the U4C]] through 29 May 2025 at 12:00 UTC. Information about [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee/Election/2025|eligibility, process, and the timeline are on Meta-wiki]]. Voting on candidates will open on 1 June 2025 and run for two weeks, closing on 15 June 2025 at 12:00 UTC.

If you have any questions, you can ask on [[m:Talk:Universal Code of Conduct/Coordinating Committee/Election/2025|the discussion page for the election]]. -- in cooperation with the U4C, &lt;/div&gt;&lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User_talk:Keegan (WMF)|بحث]])&lt;/bdi&gt; ۱۵ مهٔ ۲۰۲۵، ساعت ۲۲:۰۸ (UTC)
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28618011 ارسال شده است --&gt;

== RfC ongoing regarding Abstract Wikipedia (and your project) ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
''(Apologies for posting in English, if this is not your first language)''

Hello all! We opened a discussion on Meta about a very delicate issue for the development of [[:m:Special:MyLanguage/Abstract Wikipedia|Abstract Wikipedia]]: where to store the abstract content that will be developed through functions from Wikifunctions and data from Wikidata. Since some of the hypothesis involve your project, we wanted to hear your thoughts too. 

We want to make the decision process clear: we do not yet know which option we want to use, which is why we are consulting here. We will take the arguments from the Wikimedia communities into account, and we want to consult with the different communities and hear arguments that will help us with the decision. The decision will be made and communicated after the consultation period by the Foundation.

You can read the various hypothesis and have your say at [[:m:Abstract Wikipedia/Location of Abstract Content|Abstract Wikipedia/Location of Abstract Content]]. Thank you in advance! -- [[User:Sannita (WMF)|Sannita (WMF)]] ([[User talk:Sannita (WMF)|&lt;span class=&quot;signature-talk&quot;&gt;{{int:Talkpagelinktext}}&lt;/span&gt;]]) ۲۲ مهٔ ۲۰۲۵، ساعت ۱۵:۲۷ (UTC)
&lt;/div&gt;
&lt;!-- پیام توسط کاربر:Sannita (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Sannita_(WMF)/Mass_sending_test&amp;oldid=28768453 ارسال شده است --&gt;

==  انتخاب و دعوت به پرسش برای هیئت امنای بنیاد ویکی‌مدیا در سال ۲۰۲۵ ==

&lt;section begin=&quot;announcement-content&quot; /&gt;
:''[[m:Special:MyLanguage/Wikimedia Foundation elections/2025/Announcement/Selection announcement|{{int:interlanguage-link-mul}}]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-{{urlencode:Wikimedia Foundation elections/2025/Announcement/Selection announcement}}&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]''

سلام به همگی،

امسال، دورهٔ فعالیت ۲ (دو) نفر از اعضای هیئت امنای بنیاد ویکی‌مدیا که توسط جامعه و گروه‌های وابسته انتخاب شده‌اند، به پایان می‌رسد [۱].  
هیئت امنا از تمام اعضای جنبش دعوت می‌کند تا در فرایند انتخاب امسال مشارکت کرده و برای پر کردن این کرسی‌ها رأی دهند.

کمیتهٔ انتخابات این فرایند را با پشتیبانی کارکنان بنیاد ویکی‌مدیا نظارت خواهد کرد [۲].  
کمیتهٔ حکمرانی، متشکل از اعضای هیئت امنایی که نامزد انتخابات سال ۲۰۲۵ برای کرسی‌های منتخب جامعه و گروه‌های وابسته نیستند (راجو ناریستی، شنی ایونشتاین سیگالوف، لورنزو لوزا، کتی کالینز، ویکتوریا دورونینا و إسراء الشافعی) [۳]، مسئول نظارت هیئت امنا بر فرایند انتخاب اعضا در سال ۲۰۲۵ و اطلاع‌رسانی به هیئت امنا است.  
جزئیات بیشتر دربارهٔ نقش‌های کمیتهٔ انتخابات، هیئت امنا و کارکنان را می‌توانید در اینجا بیابید [۴].

در اینجا تاریخ‌های کلیدی برنامه‌ریزی‌شده آمده است:

* ۲۲ مه تا ۵ ژوئن: اعلام عمومی (همین اطلاعیه) و دورهٔ دریافت پرسش‌ها [۵]
* ۱۷ ژوئن تا ۱ ژوئیهٔ ۲۰۲۵: فراخوان نامزدی
* ژوئیهٔ ۲۰۲۵: در صورت نیاز، رأی‌گیری گروه‌های وابسته برای گزینش فهرست کوتاه اگر بیش از ۱۰ نفر نامزد شوند [۵]
* اوت ۲۰۲۵: دورهٔ کارزار تبلیغاتی
* اوت – سپتامبر ۲۰۲۵: دورهٔ دو هفته‌ای رأی‌گیری جامعه
* اکتبر – نوامبر ۲۰۲۵: بررسی پیشینهٔ نامزدهای منتخب
* نشست هیئت امنا در دسامبر ۲۰۲۵: آغاز به‌کار اعضای جدید هیئت امنا

برای آگاهی بیشتر دربارهٔ فرایند انتخاب سال ۲۰۲۵ — از جمله جدول زمانی دقیق، روند نامزدی، قوانین کارزار انتخاباتی و معیارهای واجد شرایط بودن رأی‌دهندگان — به این صفحه در فراویکی مراجعه کنید [[m:Special:MyLanguage/Wikimedia_Foundation_elections/2025|[پیوند]]].

'''فراخوان پرسش‌ها  '''

در هر فرایند انتخاباتی، جامعه این فرصت را دارد که پرسش‌هایی برای پاسخ‌دهی نامزدهای هیئت امنا ارسال کند.  
کمیتهٔ انتخابات از میان پرسش‌های ارائه‌شده توسط جامعه، پرسش‌هایی را برای پاسخ‌دهی توسط نامزدها انتخاب می‌کند.  
نامزدها موظف‌اند همهٔ پرسش‌های الزامی را در فرم نامزدی پاسخ دهند؛ در غیر این صورت، درخواست آن‌ها رد صلاحیت خواهد شد.  
امسال، کمیتهٔ انتخابات ۵ پرسش برای پاسخ‌دهی نامزدها انتخاب خواهد کرد. این پرسش‌ها ممکن است ترکیبی از پرسش‌های مشابه یا مرتبط ارسال‌شده از سوی جامعه باشند. [[m:Special:MyLanguage/Wikimedia_Foundation_elections/2025/Questions_for_candidates|[پیوند]]]

'''داوطلبان انتخابات  '''

راه دیگری برای مشارکت در فرایند انتخاباتی سال ۲۰۲۵ این است که داوطلب انتخابات شوید.  
داوطلبان انتخابات پل ارتباطی بین کمیتهٔ انتخابات و جامعهٔ مربوط به خود هستند.  
آن‌ها کمک می‌کنند تا جامعه‌شان نمایندگی داشته باشد و برای مشارکت در رأی‌گیری فعال شود.  
دربارهٔ این برنامه و نحوهٔ پیوستن به آن در این صفحه از فراویکی بیشتر بخوانید [[m:Wikimedia_Foundation_elections/2025/Election_volunteers|[پیوند]]].

با سپاس!

[۱] https://meta.wikimedia.org/wiki/Wikimedia_Foundation_elections/2022/Results

[۲] https://foundation.wikimedia.org/wiki/Committee:Elections_Committee_Charter

[۳] https://foundation.wikimedia.org/wiki/Resolution:Committee_Membership,_December_2024

[۴] https://meta.wikimedia.org/wiki/Wikimedia_Foundation_elections_committee/Roles

[۵] https://meta.wikimedia.org/wiki/Wikimedia_Foundation_elections/2025/FAQ

[۶] https://meta.wikimedia.org/wiki/Wikimedia_Foundation_elections/2025/Questions_for_candidates

با احترام،

ویکتوریا دورونینا

نمایندهٔ هیئت امنا در کمیتهٔ انتخابات

کمیتهٔ حکمرانی&lt;section end=&quot;announcement-content&quot; /&gt;

[[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۲۸ مهٔ ۲۰۲۵، ساعت ۰۳:۰۸ (UTC)
&lt;!-- پیام توسط کاربر:RamzyM (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28618011 ارسال شده است --&gt;

== Vote now in the 2025 U4C Election ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
Apologies for writing in English.
{{Int:Please-translate}}

Eligible voters are asked to participate in the 2025 [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee]] election. More information–including an eligibility check, voting process information, candidate information, and a link to the vote–are available on Meta at the [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Election/2025|2025 Election information page]]. The vote closes on 17 June 2025 at [https://zonestamp.toolforge.org/1750161600 12:00 UTC].

Please vote if your account is eligible. Results will be available by 1 July 2025. -- In cooperation with the U4C, [[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]]) ۱۳ ژوئن ۲۰۲۵، ساعت ۲۳:۰۱ (UTC) &lt;/div&gt;
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28848819 ارسال شده است --&gt;

== هیئت امنای بنیاد ویکی‌مدیا ۲۰۲۵ - دعوت به نامزدی ==

&lt;section begin=&quot;announcement-content&quot; /&gt;
:''&lt;div class=&quot;plainlinks&quot;&gt;[[m:Special:MyLanguage/Wikimedia Foundation elections/2025/Announcement/Call for candidates|{{int:interlanguage-link-mul}}]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-{{urlencode:Wikimedia Foundation elections/2025/Announcement/Call for candidates}}&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]&lt;/div&gt;
سلام به همگی،

[[m:Special:MyLanguage/Wikimedia Foundation elections/2025| از ۱۷ ژوئن ۲۰۲۵ تا ۲ ژوئیهٔ ۲۰۲۵ ساعت ۱۱:۵۹ به وقت ساعت هماهنگ جهانی برگزار می‌شود.[۱] ]]هیئت امنا بر فعالیت‌های بنیاد ویکی‌مدیا نظارت دارد و هر عضو هیئت برای یک دورهٔ سه‌ساله خدمت می‌کند.[۲] این یک موقعیت داوطلبانه است.

امسال، جامعهٔ ویکی‌مدیا در اواخر اوت تا سپتامبر ۲۰۲۵ برای پُر کردن دو (۲) کرسی در هیئت امنای بنیاد رأی‌گیری خواهد کرد. آیا شما – یا کسی که می‌شناسید – گزینهٔ مناسبی برای پیوستن به هیئت امنای بنیاد ویکی‌مدیا هستید؟[۳]

برای آگاهی بیشتر از شرایط لازم برای نامزدی در این موقعیت‌های رهبری و نحوهٔ ثبت نامزدی خود، به [[m:Special:MyLanguage/Wikimedia Foundation elections/2025/Candidate application|این صفحه در فراویکی]] مراجعه کنید یا شخص دیگری را به شرکت در انتخابات امسال تشویق کنید.

با احترام،

ابهیشک سوریاوانشی&lt;br /&gt;
رئیس کمیتهٔ انتخابات

از طرف کمیتهٔ انتخابات و کمیتهٔ حاکمیت

[۱] https://meta.wikimedia.org/wiki/Special:MyLanguage/Wikimedia_Foundation_elections/2025/Call_for_candidates

[۲] https://foundation.wikimedia.org/wiki/Legal:Bylaws#(B)_Term.

[۳] https://meta.wikimedia.org/wiki/Special:MyLanguage/Wikimedia_Foundation_elections/2025/Resources_for_candidates&lt;section end=&quot;announcement-content&quot; /&gt;

[[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۱۷ ژوئن ۲۰۲۵، ساعت ۱۷:۴۴ (UTC)
&lt;!-- پیام توسط کاربر:RamzyM (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=28866958 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Sister Projects Task Force reviews Wikispore and Wikinews&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;message&quot;/&gt;
Dear Wikimedia Community,

The [[m:Wikimedia Foundation Community Affairs Committee|Community Affairs Committee (CAC)]]  of the Wikimedia Foundation Board of Trustees assigned [[m:Wikimedia Foundation Community Affairs Committee/Sister Projects Task Force|the Sister Projects Task Force (SPTF)]] to update and implement a procedure for assessing the lifecycle of Sister Projects – wiki [[m:Wikimedia projects|projects supported by Wikimedia Foundation (WMF)]].

A vision of relevant, accessible, and impactful free knowledge has always guided the Wikimedia Movement. As the ecosystem of Wikimedia projects continues to evolve, it is crucial that we periodically review existing projects to ensure they still align with our goals and community capacity.

Despite their noble intent, some projects may no longer effectively serve their original purpose. '''Reviewing such projects is not about giving up – it's about responsible stewardship of shared resources'''. Volunteer time, staff support, infrastructure, and community attention are finite, and the non-technical costs tend to grow significantly as our ecosystem has entered a different age of the internet than the one we were founded in. Supporting inactive projects or projects that didn't meet our ambitions can unintentionally divert these resources from areas with more potential impact.

Moreover, maintaining projects that no longer reflect the quality and reliability of the Wikimedia name stands for, involves a reputational risk. An abandoned or less reliable project affects trust in the Wikimedia movement.

Lastly, '''failing to sunset or reimagine projects that are no longer working can make it much harder to start new ones'''. When the community feels bound to every past decision – no matter how outdated – we risk stagnation. A healthy ecosystem must allow for evolution, adaptation, and, when necessary, letting go. If we create the expectation that every project must exist indefinitely, we limit our ability to experiment and innovate.

Because of this, SPTF reviewed two requests concerning the lifecycle of the Sister Projects to work through and demonstrate the review process. We chose Wikispore as a case study for a possible new Sister Project opening and Wikinews as a case study for a review of an existing project. Preliminary findings were discussed with the CAC, and a community consultation on both proposals was recommended.

=== Wikispore ===

The [[m:Wikispore|application to consider Wikispore]] was submitted in 2019. SPTF decided to review this request in more depth because rather than being concentrated on a specific topic, as most of the proposals for the new Sister Projects are, Wikispore has the potential to nurture multiple start-up Sister Projects.

After careful consideration, the SPTF has decided '''not to recommend''' Wikispore as a Wikimedia Sister Project. Considering the current activity level, the current arrangement allows '''better flexibility''' and experimentation while WMF provides core infrastructural support. 

We acknowledge the initiative's potential and seek community input on what would constitute a sufficient level of activity and engagement to reconsider its status in the future.

As part of the process, we shared the decision with the Wikispore community and invited one of its leaders, Pharos, to an SPTF meeting.

Currently, we especially invite feedback on measurable criteria indicating the project's readiness, such as contributor numbers, content volume, and sustained community support. This would clarify the criteria sufficient for opening a new Sister Project, including possible future Wikispore re-application. However, the numbers will always be a guide because any number can be gamed.

=== Wikinews ===

We chose to review Wikinews among existing Sister Projects because it is the one for which we have observed the highest level of concern in multiple ways.

Since the SPTF was convened in 2023, its members have asked for the community's opinions during conferences and community calls about Sister Projects that did not fulfil their promise in the Wikimedia movement.[https://commons.wikimedia.org/wiki/File:WCNA_2024._Sister_Projects_-_opening%3F_closing%3F_merging%3F_splitting%3F.pdf &lt;nowiki&gt;[1]&lt;/nowiki&gt;][https://meta.wikimedia.org/wiki/Wikimedia_Foundation_Community_Affairs_Committee/Sister_Projects_Task_Force#Wikimania_2023_session_%22Sister_Projects:_past,_present_and_the_glorious_future%22 &lt;nowiki&gt;[2]&lt;/nowiki&gt;][https://meta.wikimedia.org/wiki/WikiConvention_francophone/2024/Programme/Quelle_proc%C3%A9dure_pour_ouvrir_ou_fermer_un_projet_%3F &lt;nowiki&gt;[3]&lt;/nowiki&gt;] Wikinews was the leading candidate for an evaluation because people from multiple language communities proposed it. Additionally, by most measures, it is the least active Sister Project, with the greatest drop in activity over the years.

While the Language Committee routinely opens and closes language versions of the Sister Projects in small languages, there has never been a valid proposal to close Wikipedia in major languages or any project in English. This is not true for Wikinews, where there was a proposal to close English Wikinews, which gained some traction but did not result in any action[https://meta.wikimedia.org/wiki/Proposals_for_closing_projects/Closure_of_English_Wikinews &lt;nowiki&gt;[4]&lt;/nowiki&gt;][https://meta.wikimedia.org/wiki/WikiConvention_francophone/2024/Programme/Quelle_proc%C3%A9dure_pour_ouvrir_ou_fermer_un_projet_%3F &lt;nowiki&gt;[5]&lt;/nowiki&gt;, see section 5] as well as a draft proposal to close all languages of Wikinews[https://meta.wikimedia.org/wiki/Talk:Proposals_for_closing_projects/Archive_2#Close_Wikinews_completely,_all_languages? &lt;nowiki&gt;[6]&lt;/nowiki&gt;].

[[:c:File:Sister Projects Taskforce Wikinews review 2024.pdf|Initial metrics]] compiled by WMF staff also support the community's concerns about Wikinews.

Based on this report, SPTF recommends a community reevaluation of Wikinews. We conclude that its current structure and activity levels are the lowest among the existing sister projects. SPTF also recommends pausing the opening of new language editions while the consultation runs.

SPTF brings this analysis to a discussion and welcomes discussions of alternative outcomes, including potential restructuring efforts or integration with other Wikimedia initiatives.

'''Options''' mentioned so far (which might be applied to just low-activity languages or all languages) include but are not limited to:
*Restructure how Wikinews works and is linked to other current events efforts on the projects,
*Merge the content of Wikinews into the relevant language Wikipedias, possibly in a new namespace,
*Merge content into compatibly licensed external projects,
*Archive Wikinews projects.
Your insights and perspectives are invaluable in shaping the future of these projects. We encourage all interested community members to share their thoughts on the relevant discussion pages or through other designated feedback channels.

=== Feedback and next steps ===

We'd be grateful if you want to take part in a conversation on the future of these projects and the review process. We are setting up two different project pages: [[m:Public consultation about Wikispore|Public consultation about Wikispore]] and [[m:Public consultation about Wikinews|Public consultation about Wikinews]]. Please participate between 27 June 2025 and 27 July 2025, after which we will summarize the discussion to move forward. You can write in your own language.

I will also host a community conversation 16th July Wednesday 11.00 UTC and 17th July Thursday 17.00 UTC (call links to follow shortly) and will be around at Wikimania for more discussions. 
&lt;section end=&quot;message&quot;/&gt;
&lt;/div&gt;

-- [[User:Victoria|Victoria]] on behalf of the Sister Project Task Force, ۲۷ ژوئن ۲۰۲۵، ساعت ۲۰:۵۷ (UTC)
&lt;!-- پیام توسط کاربر:Johan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Johan_(WMF)/Sister_project_MassMassage_on_behalf_of_Victoria/Target_list&amp;oldid=28911188 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;  Upcoming Deployment of the CampaignEvents Extension&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;message&quot;/&gt;
Hello everyone,  

''(Apologies for posting in English if English is not your first language. Please help translate to your language.)''

The Campaigns Product Team is planning a global deployment of the '''[[:mw:Help:Extension:CampaignEvents|CampaignEvents extension]]''' to all Wikisource, including this Wikisource, during the '''week of August 25th'''.

This extension is designed to help organizers plan and manage events, WikiProjects, and other on-wiki collaborations - and to make these efforts more discoverable.

The three main features of this extension are:

* '''[[:m:Event_Center/Registration|Event Registration]]''': A simple way to sign up for events on the wiki.
*  '''[[:m:CampaignEvents/Collaboration_list|Collaboration List]]''': A global list of events and a local list of WikiProjects, accessible at '''[[:m:Special:AllEvents|Special:AllEvents]]'''.
*  '''[[:m:Campaigns/Foundation_Product_Team/Invitation_list|Invitation Lists]]''': A tool to help organizers find editors who might want to join, based on their past contributions.

'''Note''': The extension comes with a new user right called '''&quot;Event Organizer&quot;''', which will be managed by administrators on this Wikisource. Organizer tools like Event Registration and Invitation Lists will only work if someone is granted this right. The Collaboration List is available to everyone immediately after deployment.

The extension is already live on several wikis, including '''all Wikipedia, Meta, Wikidata''', and more ( [[m:CampaignEvents/Deployment_status#Current_Deployment_Status_for_CampaignEvents_extension| See the full deployment list]])

If you have any questions, concerns, or feedback, please feel free to share them on the [[m:Talk:CampaignEvents| extension talkpage]]. We’d love to hear from you before the rollout.

Thank you! &lt;section end=&quot;message&quot;/&gt;
&lt;/div&gt;

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[User:Udehb-WMF|Udehb-WMF]] ([[User talk:Udehb-WMF|بحث]]) ۳۱ ژوئیهٔ ۲۰۲۵، ساعت ۱۵:۴۰ (UTC)&lt;/bdi&gt;
&lt;!-- پیام توسط کاربر:Udehb-WMF@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Udehb-WMF/sandbox/MM_target_Wikisource&amp;oldid=29066664 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Temporary accounts will be rolled out soon&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;body&quot;/&gt;
Hello, we are the Wikimedia Foundation [[mw:Special:MyLanguage/Product Safety and Integrity|Product Safety and Integrity]] team. We would like to announce that '''we plan to enable [[mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts|temporary accounts]] for this wiki in the week of September 1'''.

Temporary accounts are successfully live on 30 wikis, including many large ones like German, Japanese, and French. The change they bring is especially relevant to logged-out editors, who this feature is designed to protect. But it is also relevant to community members like mentors, patrollers, and admins – anyone who reverts edits, blocks users, or otherwise interacts with logged-out editors as part of keeping the wikis safe and accurate. 

'''Why we are building temporary accounts'''

Our wikis should be safer to edit by default for logged-out editors. Temporary accounts allow people to continue editing the wikis without creating an account, while avoiding publicly tying their edits to their IP address. We believe this is in the best interest of our logged-out editors, who make valuable contributions to the wikis and who may later create accounts and grow our community of editors, admins, and other roles. Even though the wikis do warn logged-out editors that their IP address will be associated with their edit, many people may not understand what an IP address is, or that it could be used to connect them to other information about them in ways they might not expect. 

Additionally, our moderation software and tools rely too heavily on network origin (IP addresses) to identify users and patterns of activity, especially as IP addresses themselves are becoming less stable as identifiers. Temporary accounts allow for more precise interactions with logged-out editors, including more precise blocks, and can help limit how often we unintentionally end up blocking good-faith users who use the same IP addresses as bad-faith users.

'''How temporary accounts work'''
[[File:Temporary account banner and empty talk page.png|thumb]]
Any time a logged-out user publishes an edit on this wiki, a cookie will be set in this user's browser, and a temporary account tied with this cookie will be automatically created. This account's name will follow the pattern: &lt;code dir=ltr&gt;~2025-12345-67&lt;/code&gt; (a tilde, current year, a number). On pages like Recent Changes or page history, this name will be displayed. The cookie will expire 90 days after its creation. As long as it exists, all edits made from this device will be attributed to this temporary account. It will be the same account even if the IP address changes, unless the user clears their cookies or uses a different device or web browser. A record of the IP address used at the time of each edit will be stored for 90 days after the edit. However, only some logged-in users will be able to see it.

'''What does this mean for different groups of users?'''

'''For logged-out editors'''

* This increases privacy: currently, if you do not use a registered account to edit, then everybody can see the IP address for the edits you made, even after 90 days. That will no longer be possible on this wiki.
* If you use a temporary account to edit from different locations in the last 90 days (for example at home and at a coffee shop), the edit history and the IP addresses for all those locations will now be recorded together, for the same temporary account. Users who [[foundation:Special:MyLanguage/Policy:Access_to_temporary_account_IP_addresses|meet the relevant requirements]] will be able to view this data. If this creates any personal security concerns for you, please contact talktohumanrights at wikimedia.org for advice.

'''For community members interacting with logged-out editors'''

* A temporary account is uniquely linked to a device. In comparison, an IP address can be shared with different devices and people (for example, different people at school or at work might have the same IP address).
* Compared to the current situation, it will be safer to assume that a temporary user's talk page belongs to only one person, and messages left there will be read by them. As you can see in the screenshot, temporary account users will receive notifications. It will also be possible to thank them for their edits, ping them in discussions, and invite them to get more involved in the community.

'''For users who use IP address data to moderate and maintain the wiki'''

* '''For patrollers''' who track persistent abusers, investigate violations of policies, etc.: Users who [[foundation:Special:MyLanguage/Policy:Access_to_temporary_account_IP_addresses|meet the requirements]] will be able to reveal temporary users' IP addresses and all contributions made by temporary accounts from a specific IP address or range ([[Special:IPContributions]]). They will also have access to useful information about the IP addresses thanks to the [[mw:Special:MyLanguage/Trust and Safety Product/IP Info|IP Info]] feature. Many other pieces of software have been built or adjusted to work with temporary accounts, including AbuseFilter, global blocks, Global User Contributions, and more. (For information for volunteer developers on how to update the code of your tools – see the last part of the message.)
* '''For admins blocking logged-out editors''':
** It will be possible to block many abusers by just blocking their temporary accounts. A blocked person won't be able to create new temporary accounts quickly if the admin selects the [[mw:Special:MyLanguage/Autoblock|autoblock]] option.
** It will still be possible to block an IP address or IP range.
* Temporary accounts will not be retroactively applied to contributions made before the deployment. On Special:Contributions, you will be able to see existing IP user contributions, but not new contributions made by temporary accounts on that IP address. Instead, you should use Special:IPContributions for this.

'''Our requests for you, and next steps'''

* If you know of any tools, bots, gadgets etc. using data about IP addresses or being available for logged-out users, you may want to test if they work on [[testwiki:Main_Page|testwiki]] or [[test2wiki:Main_Page|test2wiki]]. If you are a volunteer developer, [[mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts/For developers|read our documentation for developers]], and in particular, the section on [[mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts/For developers#How should I update my code?|how your code might need to be updated]].
* If you want to test the temporary account experience, for example just to check what it feels like, go to testwiki or test2wiki and edit without logging in.
* Tell us if you know of any difficulties that need to be addressed. We will try to help, and if we are not able, we will consider the available options.
* Look at our [[m:Meta:Babel#Temporary_Accounts:_access_to_IP_addresses_and_next_steps|previous message]] about requirements for users without extended rights who may need access to IP addresses.

To learn more about the project, check out [[mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts/FAQ|our FAQ]] – you will find many useful answers there. You may also [[mw:Special:MyLanguage/Trust and Safety Product/Temporary Accounts/Updates|look at the updates]] (we have just posted one) and [[mw:Newsletter:Product Safety and Integrity|subscribe to our new newsletter]]. If you'd like to talk to me (Szymon) off-wiki, you will find me on Discord and Telegram. Thank you!&lt;section end=&quot;body&quot; /&gt;
&lt;/div&gt;

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[m:user:NKohli (WMF)|NKohli (WMF)]], [[m:user:SGrabarczuk (WMF)|SGrabarczuk (WMF)]]&lt;/bdi&gt; ۲۶ اوت ۲۰۲۵، ساعت ۲۱:۳۶ (UTC)
&lt;!-- پیام توسط کاربر:Quiddity (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Quiddity_(WMF)/sandbox6&amp;oldid=29181713 ارسال شده است --&gt;

== روزنامه‌های ویکی‌نبشته و سالنامه‌های ویکی‌پدیا ==

یکی از کارهایی که دوست دارم انجام بدهم این است که با تکمیل روزنامه‌های قدیمی در ویکی‌نبشته، رخدادهای موجود در آنها را در سال‌های متناظرشان در ویکی‌پدیا پیاده کنم. به نظرم تکمیل این سالنامه‌ها تاثیر خوبی در ایجاد یک نگاه واقعی به تاریخ معاصر خواهد داشت و تصویر مناسبی از پیوستگی تاریخی تا زمان حال نشان می‌دهد. اگر کسی علاقه داشت، من دارم گهگاه روی سال [[W:۱۲۶۷ (قمری)|۱۲۶۷ قمری]] کار می‌کنم. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲۹ اوت ۲۰۲۵، ساعت ۰۶:۲۹ (UTC)

== ویکی شما به زودی در حالت فقط خواندن قرار خواهد گرفت ==

&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;

[[:m:Special:MyLanguage/Tech/Server switch|این خبرنامه را در زبان دیگری بخوانید]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|بنیاد ویکی‌مدیا]] ترافیک را بین مراکز داده‌اش جابه‌جا خواهد کرد. این کار باعث می‌شود که ویکی‌پدیا و دیگر ویکی‌های ویکی‌مدیا حتی پس از یک فاجعه آنلاین بمانند.

تمام ترافیک در '''{{#time:j xg|2025-09-24|fa}}''' جابه‌جا خواهد شد. جابه‌جایی از ساعت '''[https://zonestamp.toolforge.org/{{#time:U|2025-09-24T15:00|en}} {{#time:H:i e|2025-09-24T15:00}}]''' آغاز خواهد شد.

متأسفانه، به دلیل برخی محدودیت‌ها در [[mw:Special:MyLanguage/Manual:What is MediaWiki?|مدیاویکی]]، تمام ویرایش‌ها باید در هنگام جابه‌جایی متوقف شوند. بابت این اختلال پوزش می‌طلبیم و در تلاش هستیم که آن را در آینده به حداقل برسانیم. 

یک بنر ۳۰ دقیقه پیش از انجام این عملیات در تمام ویکی‌ها نمایش داده خواهد شد. این بنر تا پایان عملیات قابل مشاهده خواهد بود. 
&lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;You can contribute to the [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate translation or proofreading] of this banner text.&lt;/span&gt;

'''شما قادر خواهید بود تمام ویکی‌ها را بخوانید، اما برای مدت کوتاهی امکان ویرایش نخواهید داشت.'''

*تا یک ساعت در '''{{#time:l j xg Y|2025-09-24|fa}}''' قادر به ویرایش نخواهید بود.
*اگر در این مدت تلاش کنید ویرایش کنید یا تغییرات را ذخیره نمایید، یک پیام خطا مشاهده خواهید کرد. امیدواریم که در این دقایق هیچ ویرایشی از دست نرود، اما نمی‌توانیم آن را تضمین کنیم. اگر پیام خطا را مشاهده کردید، لطفاً منتظر بمانید تا همه چیز به حالت عادی بازگردد. پس از آن باید بتوانید ویرایش خود را ذخیره کنید. اما توصیه می‌کنیم که برای احتیاط، ابتدا یک نسخه از تغییرات خود تهیه کنید.

''تأثیرات دیگر:''

*وظایف پس‌زمینه کندتر اجرا خواهند شد و برخی ممکن است حذف شوند. پیوندهای قرمز ممکن است به سرعت معمول به‌روز نشوند. اگر مقاله‌ای ایجاد کنید که قبلاً در جای دیگری پیوند داده شده است، پیوند آن بیشتر از حد معمول قرمز خواهد ماند. برخی اسکریپت‌های بلندمدت باید متوقف شوند.
* انتظار داریم که استقرار کد مانند هر هفتهٔ دیگر انجام شود. با این حال، در برخی موارد، در صورت لزوم، مسدودسازی موقتی کد ممکن است به‌صورت موردی انجام شود.
* [[mw:Special:MyLanguage/GitLab|گیت‌لب]] برای حدود ۹۰ دقیقه در دسترس نخواهد بود.

این پروژه در صورت لزوم ممکن است به تعویق بیفتد. می‌توانید [[wikitech:Switch_Datacenter|برنامهٔ زمانی را در wikitech.wikimedia.org بخوانید]]. هرگونه تغییر در برنامهٔ زمانی اعلام خواهد شد. 

'''لطفاً این اطلاعات را با جامعهٔ خود به اشتراک بگذارید.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

&lt;span dir=ltr&gt;[[m:User:Trizek (WMF)|Trizek (WMF)]] ([[m:User talk:Trizek (WMF)|{{int:talk}}]])&lt;/span&gt; ۱۸ سپتامبر ۲۰۲۵، ساعت ۱۵:۴۲ (UTC)
&lt;!-- پیام توسط کاربر:Trizek (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=29170715 ارسال شده است --&gt;

== Upcoming Dark Mode user interface rollout for anonymous Wikimedia sites users ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
{{int:Hello}} Wikimedians,

Apologies if this message is not in your language. {{int:please-translate}}.

The [[mw:Special:MyLanguage/Reading/Web|Reader Experience team]] will launch the Dark mode feature for anonymous users on all Wikimedia sites, including yours, on October 29, 2025.

[[:en:Special:MyLanguage/Light-on-dark color scheme|Dark mode]] is an option that allows users to view pages in light-coloured text, and icons on a dark background. Once it is available for anonymous users, they can enable it when using various devices. More information on ways to enable it can be found on [[:en:Special:MyLanguage/Wikipedia:Dark mode#Options for anyone|this page]].
Given many pages are still not compatible with dark mode this will be an opt-in feature and not automatically apply to pages.

Dark mode requires modifications to content pages and templates, and since our initial launch [https://diff.wikimedia.org/2024/07/17/dark-modes-bright-future-how-dark-mode-will-transform-wikipedias-accessibility/ in July 2024], we have been working with communities and helping them prepare for dark mode. Before the rollout, it is essential that template authors and technical contributors test dark mode and read [[mw:Special:MyLanguage/Reading/Web/Accessibility for reading/Updates/2024-04|this page]] to learn how to make pages Dark mode-ready and address any compatibility issues found in templates.

We will fix most color compatibility issues only on the most-viewed pages on projects with over 5 million monthly page views. Technical contributors with an account should opt into dark mode currently using preferences or settings and test pages and seek help before the release to ensure everything complies before the enablement.

If you have any questions or need help, please [[mw:Special:MyLanguage/Talk:Reading/Web/Accessibility for reading#|contact the Reader Experience team]] for support.

Thank you!
&lt;/div&gt;

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[User:UOzurumba (WMF)|UOzurumba (WMF)]]&lt;/bdi&gt; ۳۰ سپتامبر ۲۰۲۵، ساعت ۰۲:۰۸ (UTC)
&lt;!-- پیام توسط کاربر:UOzurumba (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:UOzurumba_(WMF)/sandbox_Dark_mode_deployment_mass_message_list_(October_2025)&amp;oldid=29358561 ارسال شده است --&gt;

== نظر خود را اعلام کنید: در انتخابات هیئت امنای سال ۲۰۲۵ رأی دهید ==

&lt;section begin=&quot;announcement-content&quot; /&gt;
سلام به همگی،

دورهٔ رأی‌گیری برای [[m:Special:MyLanguage/Wikimedia Foundation elections/2025|انتخابات هیئت امنای سال ۲۰۲۵]] اکنون آغاز شده است. نامزدها برای دو کرسی در هیئت امنا رقابت می‌کنند.

برای بررسی شرایط رأی‌دهی خود، لطفاً به [[m:Special:MyLanguage/Wikimedia Foundation elections/2025/Voter eligibility guidelines|صفحهٔ شرایط رأی‌دهندگان]] مراجعه کنید.

برای آشنایی بیشتر با نامزدها، [[m:Special:MyLanguage/Wikimedia Foundation elections/2025/Candidates|بیانیه‌های معرفی آن‌ها را بخوانید و ویدیوهای نامزدی‌شان را تماشا کنید]].

هر زمان آماده بودید، به [[m:Special:SecurePoll/vote/405|صفحهٔ رأی‌گیری SecurePoll]] بروید و رأی دهید.

'''دورهٔ رأی‌گیری از ۸ اکتبر ساعت ۰۰:۰۰ (UTC) آغاز می‌شود و تا ۲۲ اکتبر ساعت ۲۳:۵۹ (UTC) ادامه دارد.'''

با احترام،

ابهیشک سوریاوانشی&lt;br /&gt;رئیس کمیتهٔ انتخابات&lt;section end=&quot;announcement-content&quot; /&gt;

[[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۹ اکتبر ۲۰۲۵، ساعت ۰۴:۴۹ (UTC)
&lt;!-- پیام توسط کاربر:RamzyM (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29360896 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Help us decide the name of the new Abstract Wikipedia project&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;function1&quot;/&gt;
{{int:Hello}}. Please help pick a name for the new Abstract Wikipedia wiki project. This project will be a wiki that will enable users to combine functions from [[:f:|Wikifunctions]] and data from Wikidata in order to generate natural language sentences in any supported languages. These sentences can then be used by any Wikipedia (or elsewhere).

There will be two rounds of voting, each followed by legal review of candidates, with votes beginning on 20 October and 17 November 2025. Our goal is to have a final project name selected on mid-December 2025. If you would like to participate, then '''[[m:Special:MyLanguage/Abstract Wikipedia/Abstract Wikipedia naming contest|please learn more and vote now]]''' at meta-wiki.
{{Int:Feedback-thanks-title}}
&lt;section end=&quot;function1&quot;/&gt;
&lt;/div&gt;

-- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) ۲۰ اکتبر ۲۰۲۵، ساعت ۱۱:۴۳ (UTC)
&lt;!-- پیام توسط کاربر:Sannita (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29432175 ارسال شده است --&gt;

== حالا می‌توانید فعالیت خود را خودتان سازمان‌دهی کنید! -  Now you can organize your own event! ==
[[پرونده:Ar Campaigns events picto.png|90px|بدون‌قاب|چپ]]
Hello everyone! 👋
I’d like to share some great news 🎉
ou can now use the '''[[metawiki:Connection_Team/Registration|Event Registration Tool]]''' to easily organize your own events — even if you don’t have the “Event Organizer” right!
All you need is to be an '''autoconfirmed user''' on the wiki 👌
If you’d like to try the tool or need any help, I’m here as a '''Product Ambassador''' in the [[metawiki:Connection_Team|Connection Team]], and I’ll be happy to assist you anytime 😉
Don’t hesitate to contact me 💬
[https://phabricator.wikimedia.org/T401445 Phabricator link]

Note: This message was automatically translated to make it easier to read — so feel free to review or correct it.
With all my respect and appreciation

سلام به همه! 👋
می‌خواهم خبر خوبی به شما بدهم 🎉
اکنون می‌توانید از '''[[metawiki:Connection_Team/Registration|ابزار ثبت رویدادها]]''' برای سازمان‌دهی آسان رویدادهای خود استفاده کنید، حتی اگر دسترسی «سازمان‌دهنده رویداد» نداشته باشید!
تنها چیزی که نیاز دارید این است که در ویکی '''کاربر تأییدشده خودکار''' باشید 👌
اگر مایلید ابزار را امتحان کنید یا به کمکی نیاز دارید، من به عنوان '''سفیر محصول''' در [[metawiki:Connection_Team|تیم ارتباطات]] در خدمت شما هستم و با خوشحالی در هر زمان کمکتان خواهم کرد 😉
در تماس بودن با من تردید نکنید 💬
[https://phabricator.wikimedia.org/T401445 پیوند فابریکیتور]
یادداشت: این پیام به‌صورت خودکار ترجمه شده است تا خواندن آن آسان‌تر شود — بنابراین در تصحیح آن تردید نکنید.
با احترام و آرزوی موفقیت 🌷

. [[کاربر:Bachounda (WMF)|Bachounda (WMF)]] ([[بحث کاربر:Bachounda (WMF)|بحث]]) ۲۸ اکتبر ۲۰۲۵، ساعت ۱۳:۱۲ (UTC)

== در پیِ جذب داوطلب برای پیوستن به چندین کمیتهٔ جنبش هستیم ==

&lt;section begin=&quot;announcement-content&quot; /&gt;
هر سال، معمولاً از اکتبر تا دسامبر، چندین کمیتهٔ جنبش به دنبال داوطلبان جدید می‌گردند. 

در مورد این کمیته‌ها در صفحه‌های فراویکی آن‌ها بیشتر بخوانید:
* [[m:Special:MyLanguage/Affiliations Committee|کمیتهٔ وابستگی‌ها (AffCom)]]
* [[m:Special:MyLanguage/Ombuds commission|کمیسیون دادآوران (OC)]]
* [[m:Special:MyLanguage/Wikimedia Foundation/Legal/Community Resilience and Sustainability/Trust and Safety/Case Review Committee|کمیتهٔ بازبینی پرونده‌ها (CRC)]]

درخواست‌ها برای این کمیته‌ها از تاریخ ۳۰ اکتبر ۲۰۲۵ آغاز می‌شود. مهلت ارسال درخواست برای کمیتهٔ وابستگی‌ها تا تاریخ ۱۱ دسامبر ۲۰۲۵ است و مهلت درخواست برای کمیسیون دادآوران و کمیتهٔ بازبینی پرونده‌ها تا تاریخ ۱۱ دسامبر ۲۰۲۵ ادامه دارد. برای آگاهی از نحوهٔ درخواست، با [[m:Special:MyLanguage/Wikimedia Foundation/Legal/Committee appointments|بازدید از صفحهٔ انتصابات در فراویکی]] همراه شوید. در صورت داشتن هرگونه پرسش، می‌توانید در صفحهٔ گفت‌وگو پیام بگذارید یا به نشانی cst[[File:At sign.svg|16x16px|link=|(_AT_)]]wikimedia.org ایمیل بفرستید.

از طرف تیم پشتیبانی کمیته‌ها،
&lt;section end=&quot;announcement-content&quot; /&gt;

-[[m:User:MKaur (WMF)| MKaur (WMF)]] ۳۰ اکتبر ۲۰۲۵، ساعت ۱۴:۱۳ (UTC)
&lt;!-- پیام توسط کاربر:MKaur (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29517125 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Reminder: Help us decide the name of the new Abstract Wikipedia project&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;function2&quot;/&gt;
{{int:Hello}}. Reminder: Please help to choose name for the new Abstract Wikipedia wiki project. The finalist vote starts today. The finalists for the name are: &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;Abstract Wikipedia, Multilingual Wikipedia, Wikiabstracts, Wikigenerator, Proto-Wiki&lt;/span&gt;. If you would like to participate, then '''[[m:Special:MyLanguage/Abstract Wikipedia/Abstract Wikipedia naming contest|please learn more and vote now]]''' at meta-wiki.
{{Int:Feedback-thanks-title}}
&lt;section end=&quot;function2&quot;/&gt;
&lt;/div&gt;

-- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) ۲۰ نوامبر ۲۰۲۵، ساعت ۱۴:۲۲ (UTC)
&lt;!-- پیام توسط کاربر:Sannita (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29583860 ارسال شده است --&gt;

== Thank You for Last Year – Join Wiki Loves Ramadan 2026 ==

Dear Wikimedia communities,

We hope you are doing well, and we wish you a happy New Year.

''Last year, we captured light. This year, we’ll capture legacy.''

In 2025, communities around the world shared the glow of Ramadan nights and the warmth of collective iftars. In 2026, ''Wiki Loves Ramadan'' is expanding, bringing more stories, more cultures, and deeper global connections across Wikimedia projects.

We invite you to explore the ''Wiki Loves Ramadan 2026'' [[m:Special:MyLanguage/Wiki Loves Ramadan 2026|Meta page]] to learn how you can participate and [[m:Special:MyLanguage/Wiki Loves Ramadan 2026/Participating communities|sign up]] your community.

📷 ''Photo campaign on '' [[c:Special:MyLanguage/Commons:Wiki Loves Ramadan 2026|Wikimedia Commons]]

If you have questions about the project, please refer to the FAQs:  
* [[m:Special:MyLanguage/Wiki Loves Ramadan/FAQ/|Meta-Wiki]]
* [[c:Special:MyLanguage/Commons:Wiki Loves Ramadan/FAQ|Wikimedia Commons]]

''Early registration for updates is now open via the '''[[m:Special:RegisterForEvent/2710|Event page]]'''''

''Stay connected and receive updates:''  
* [https://t.me/WikiLovesRamadan Telegram channel]  
* [https://lists.wikimedia.org/postorius/lists/wikilovesramadan.lists.wikimedia.org/ Mailing list]

We look forward to collaborating with you and your community.


'''The Wiki Loves Ramadan 2026 Organizing Team''' ۱۶ ژانویهٔ ۲۰۲۶، ساعت ۱۹:۴۵ (UTC)
&lt;!-- پیام توسط کاربر:ZI Jony@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=29879549 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Annual review of the Universal Code of Conduct and Enforcement Guidelines&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
I am writing to you to let you know the annual review period for the Universal Code of Conduct and Enforcement Guidelines is open now. You can make suggestions for changes through 9 February 2026. This is the first step of several to be taken for the annual review. [[m:Special:MyLanguage/Universal Code of Conduct/Annual review/2026|Read more information and find a conversation to join on the UCoC page on Meta]].

The [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee|Universal Code of Conduct Coordinating Committee]] (U4C) is a global group dedicated to providing an equitable and consistent implementation of the UCoC. This annual review was planned and implemented by the U4C. For more information and the responsibilities of the U4C, [[m:Special:MyLanguage/Universal Code of Conduct/Coordinating Committee/Charter|you may review the U4C Charter]].

Please share this information with other members in your community wherever else might be appropriate.

-- In cooperation with the U4C, [[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]])&lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

۱۹ ژانویهٔ ۲۰۲۶، ساعت ۲۱:۰۲ (UTC)
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=29905753 ارسال شده است --&gt;

== ابزار بررسی وضعیت حق تکثیر برای ویکی‌نبشتهٔ فارسی ==

سلام
یک ابزاری نوشتم که براساس قوانین حق تکثیر ایران، نام نویسنده را می‌گیرد و به کاربر می‌گوید که آثار این شخص در مالکیت عمومی قرار دارند یا نه و آیا می‌توان آثار او را در ویکی‌نبشتهٔ فارسی استفاده کرد یا نه:

https://wikisource-copyright-check.toolforge.org/

لطفاً استفاده کنید و اگر پیشنهادی داشتید بفرمایید. [[کاربر:Darafsh|&lt;span style=&quot;color:Purple; text-shadow:grey 0.1em 0.2em 0.1em;&quot;&gt;درفش کاویانی&lt;/span&gt;]] ([[بحث کاربر:Darafsh|&lt;span title=&quot;پیام بگذارید!&quot; style=&quot;cursor: crosshair;&quot;&gt;بحث&lt;/span&gt;]]) ۲۱ فوریهٔ ۲۰۲۶، ساعت ۱۳:۵۳ (UTC)

:ابزار جالبی است منتهی مقداری disclaimer نیاز دارد. فقط براساس تاریخ مرگ در ویکی‌داده کار می‌کند؟ [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۲۱ فوریهٔ ۲۰۲۶، ساعت ۱۹:۳۳ (UTC)

== Action Required: Update templates/modules for electoral maps (Migrating from P1846 to P14226) ==

Hello everyone,

This is a notice regarding an ongoing data migration on Wikidata that may affect your election-related templates and Lua modules (such as &lt;code&gt;Module:Itemgroup/list&lt;/code&gt;).

'''The Change:'''&lt;br /&gt;
Currently, many templates pull electoral maps from Wikidata using the property [[:d:Property:P1846|P1846]], combined with the qualifier [[:d:Property:P180|P180]]: [[:d:Q19571328|Q19571328]]. 

We are migrating this data (across roughly 4,000 items) to a newly created, dedicated property: '''[[:d:Property:P14226|P14226]]'''.

'''What You Need To Do:'''&lt;br /&gt;
To ensure your templates and infoboxes do not break or lose their maps, please update your local code to fetch data from [[:d:Property:P14226|P14226]] instead of the old [[:d:Property:P1846|P1846]] + [[:d:Property:P180|P180]] structure. A [[m:Wikidata/Property Migration: P1846 to P14226/List|list of pages]] was generated using Wikimedia Global Search.

'''Deadline:'''&lt;br /&gt;
We are temporarily retaining the old data on [[:d:Property:P1846|P1846]] to allow for a smooth transition. However, to complete the data cleanup on Wikidata, the old [[:d:Property:P1846|P1846]] statements will be removed after '''May 1, 2026'''. Please update your modules and templates before this date to prevent any disruption to your wiki's election articles.

Let us know if you have any questions or need assistance with the query logic. Thank you for your help! [[User:ZI Jony|ZI Jony]] using [[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۳ آوریل ۲۰۲۶، ساعت ۱۷:۱۲ (UTC)
&lt;!-- پیام توسط کاربر:ZI Jony@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=29941252 ارسال شده است --&gt;

== Request for comment (global AI policy) ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
Apologies for writing in English. {{int:Please-translate}}
A [[:m:Requests for comment/Artificial intelligence policy|request for comment]] is currently being held to decide on a global AI policy. {{int:Feedback-thanks-title}}
[[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۲۶ آوریل ۲۰۲۶، ساعت ۰۰:۵۸ (UTC)
&lt;/bdi&gt;
&lt;!-- پیام توسط کاربر:Codename Noreste@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30424282 ارسال شده است --&gt;

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Vote now in the 2026 U4C election&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
&lt;section begin=&quot;announcement-content&quot; /&gt;
Eligible voters are asked to participate in the 2026 [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee|Universal Code of Conduct Coordinating Committee]] election. More information–including an eligibility check, voting process information, candidate information, and a link to the vote–are available on Meta at the [[m:Special:MyLanguage/Universal_Code_of_Conduct/Coordinating_Committee/Election/2026|2026 Election information page]]. The vote closes on 2 June 2026 at [https://zonestamp.toolforge.org/1780358400 00:00 UTC].

Please vote if your account is eligible. Results will be available by 14 June 2026. -- In cooperation with the U4C,&lt;section end=&quot;announcement-content&quot; /&gt;
&lt;/div&gt;

[[m:User:Keegan (WMF)|Keegan (WMF)]] ([[m:User talk:Keegan (WMF)|talk]]) ۲۷ مهٔ ۲۰۲۶، ساعت ۱۷:۱۵ (UTC)
&lt;!-- پیام توسط کاربر:Keegan (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 ارسال شده است --&gt;

== RFC about AI-generated content in Wikimedia Commons ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;Apologies for writing in English, please help translate this message to your language. You are invited to participate in a [[c:Commons:Requests for comment/Policy update for AI content|request for comment on Wikimedia Commons about a policy update for AI content]]. This may affect files that are uploaded to Wikimedia Commons for use on this project. Thank you. [[m:User:Codename Noreste|Codename Noreste]] ([[m:User talk:Codename Noreste|بحث]])&lt;/bdi&gt; ۲۳ ژوئن ۲۰۲۶، ساعت ۱۷:۱۲ (UTC)
&lt;!-- پیام توسط کاربر:Codename Noreste@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 ارسال شده است --&gt;

== استقرار پیوند تماس‌های حقوقی و ایمنی در پابرگ ویکی شما ==

&lt;section begin=&quot;Message&quot;/&gt;
'''تماس‌های حقوقی و ایمنی'''

سلام جامعهٔ کاربری، بنیاد ویکی‌مدیا یک [[wmf:Special:MyLanguage/Legal:Wikimedia Foundation Legal and Safety Contact Information|صفحهٔ واحد برای تماس‌های حقوقی و ایمنی]] فراهم کرده است تا در پابرگ ویکی شما پیوند داده شود و دسترسی به اطلاعات حقوقی دقیق تضمین گردد. این یک الزام مقرراتی است. ما پیش‌تر پیوندها را در ویکی‌های انگلیسی، آلمانی، ایتالیایی، اسپانیایی و چند ویکی دیگر فعال کرده‌ایم و به‌زودی آن را در ویکی شما نیز مستقر خواهیم کرد. لطفاً [[m:Special:MyLanguage/Wikimedia_Foundation_Legal_and_Safety_Contacts_FAQ|در صفحهٔ پروژه بیشتر بخوانید]] و هرگونه نظر را در این ریسه یا در [[m:Special:MyLanguage/Talk:Wikimedia Foundation Legal and Safety Contacts FAQ|صفحهٔ بحث]] مطرح کنید.

&lt;section end=&quot;Message&quot;/&gt;

-- [[User:Sannita (WMF)|User:Sannita (WMF)]] ([[User talk:Sannita (WMF)|talk]]) ۲۵ ژوئن ۲۰۲۶، ساعت ۱۳:۳۱ (UTC)
&lt;!-- پیام توسط کاربر:Sannita (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Sannita_(WMF)/Mass_sending_test&amp;oldid=30731267 ارسال شده است --&gt;

== ارجاع به آیات کتاب مقدس ==

@[[کاربر:Hanooz|Hanooz]]، @[[کاربر:Darafsh|Darafsh]]. الان که به همت کاربر Hanooz همهٔ برگ‌های کتاب مقدس پر شده‌اند، می‌توان از قابلیت ارجاع به آیات در سایر پروژه‌های ویکی استفاده کرد. برای مثال به این شکل: &lt;nowiki&gt;[[s:سفر اعداد#۵:۱۹]]&lt;/nowiki&gt; که ارجاع دقیقی به [[سفر اعداد#۵:۱۹|آیه ۱۹ از باب ۵ سفر اعداد]] می‌دهد. همچنین با وارد کردن تنها یک عدد می‌توان مستقیماً سراغ یک باب رفت. مثلا &lt;nowiki&gt;[[s:سفر پیدایش#۴]]&lt;/nowiki&gt; که به [[سفر پیدایش#۴|باب چهارم از سفر پیدایش]] ارجاع می‌دهد. البته این مورد هنوز برای سایر اسفار نیاز به کار دارد. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۳۰ ژوئن ۲۰۲۶، ساعت ۱۹:۰۸ (UTC)
: ممنون. [[Special:Diff/290140/prev]] ویرایش من کار نکرد. چه تغییری در متن باید ایجاد شود؟ [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۲ ژوئیهٔ ۲۰۲۶، ساعت ۰۵:۰۴ (UTC)
:: چه خوب. می‌توانیم در ویکی‌پدیا الگویی ایجاد کنیم که خیلی راحت‌تر بتوان به کتاب مقدس در اینجا ارجاع داد، شبیه ویکی‌پدیای انگلیسی. ممنون از هنوز برای ایجاد صفحات، من هم سعی می‌کنم در نمونه‌خوانی کمک کنم. -- [[کاربر:Darafsh|&lt;span style=&quot;color:Purple; text-shadow:grey 0.1em 0.2em 0.1em;&quot;&gt;درفش کاویانی&lt;/span&gt;]] ([[بحث کاربر:Darafsh|&lt;span title=&quot;پیام بگذارید!&quot; style=&quot;cursor: crosshair;&quot;&gt;بحث&lt;/span&gt;]]) ۲ ژوئیهٔ ۲۰۲۶، ساعت ۰۸:۱۷ (UTC)
:::یک نکته که احتمالا از دست درفش عزیز بر می‌آید این است که در صورت ارجاع به یک آیه یا حتی یک باب، موقعی که کاربر صفحه را باز می‌کند، آن آیه یا باب، برای چند ثانیه یا به طور ثابت هایلایت آبی شود. مثل زمانی که در ویکی‌پدیا روی شمارهٔ یک منبع در متن مقاله کلیک می‌شود و سپس متن مورد ارجاع در پانویس هایلایت می‌شود. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲ ژوئیهٔ ۲۰۲۶، ساعت ۱۷:۰۷ (UTC)
::انگار ارجاع به کل یک باب کار نمی‌کند. مرورگر آن را با شماره برگ اشتباه می‌گیرد. فکر کنم باید در صفحه‌های مربوط به اسفار، کاری کنیم که شماره برگ‌ها (آنها که گوشه سمت راست نمایش پیدا می‌کنند) نشان داده نشوند. اینطوری احتمالا این مشکل هم حل شود. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲ ژوئیهٔ ۲۰۲۶، ساعت ۱۷:۰۲ (UTC)
:::@[[کاربر:Hanooz|Hanooz]] فکر کنم درست شد. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲ ژوئیهٔ ۲۰۲۶، ساعت ۱۷:۲۶ (UTC)

== Request for comment (the future of Abstract Wikipedia) ==

&lt;bdi lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;
Apologies if this has not yet been translated into your wiki's language. {{int:Please-translate}}
You are invited to voice your opinions in a [[:m:Requests for comment/The future of Abstract Wikipedia|request for comment about the future of Abstract Wikipedia]]. {{Int:Feedback-thanks-title}}
[[:m:User:Kowal2701|Kowal2701]] ([[:m:User talk:Kowal2701|talk]])  ۲۴ ژوئیهٔ ۲۰۲۶، ساعت ۱۲:۲۵ (UTC)
&lt;/bdi&gt;
&lt;!-- پیام توسط کاربر:DreamRimmer@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery&amp;oldid=30513860 ارسال شده است --&gt;

== درخواست پرچم برای ربات YoosefBot ==

سلام به دوستان. {{پب|Darafsh}}، {{پب|Hanooz}} هدف ربات YoosefBot پردازش متن برگه‌های فرهنگ نفیسی و ساخت صفحه‌های مربوط به هر مدخل است. محدودهٔ عملکرد آن در فضای نام فهرست و فضای نام اصلی است. زبان برنامه‌نویسی استفاده‌شده در آن فقط پایتون است و به شکل نیمه‌خودکار از روی دستگاه خودم عمل می‌کند. کمی از عملکرد آن را به نمایش می‌گذارم تا نسبت به کارکردش اطمینان حاصل کنید. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲۴ ژوئیهٔ ۲۰۲۶، ساعت ۱۸:۱۰ (UTC)

:سلام. موافقم. به نظرم نتیجه خوب از کار درآمده. [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۲۴ ژوئیهٔ ۲۰۲۶، ساعت ۲۰:۱۰ (UTC)
::@[[کاربر:Yoosef Pooranvary|Yoosef Pooranvary]] سلام. مدیران امکان اعطای دسترسی ربات را ندارند، باید در متا درخواست دهید. با این حال، نیازی به پرچم هم شاید نباشد از آنجایی که ویکی ما بسیار کوچک است. [[کاربر:Darafsh|&lt;span style=&quot;color:Purple; text-shadow:grey 0.1em 0.2em 0.1em;&quot;&gt;درفش کاویانی&lt;/span&gt;]] ([[بحث کاربر:Darafsh|&lt;span title=&quot;پیام بگذارید!&quot; style=&quot;cursor: crosshair;&quot;&gt;بحث&lt;/span&gt;]]) ۲۵ ژوئیهٔ ۲۰۲۶، ساعت ۰۸:۱۲ (UTC)
:::پس همینطور جلو می‌رویم ببینیم چه می‌شود. [[کاربر:Yoosef Pooranvary|یوسف]] ([[بحث کاربر:Yoosef Pooranvary|بحث]]) ۲۵ ژوئیهٔ ۲۰۲۶، ساعت ۱۶:۱۱ (UTC)

== مهاجرت به پارسوید ==

&lt;section begin=&quot;announcement-content&quot; /&gt;
&lt;em&gt;[[m:Special:MyLanguage/Wikimedia Foundation/Product and Technology/Parsoid Read Views/Read View Announcement|این صفحه را به زبان دیگری بخوانید]]&lt;/em&gt;

سلام به همگی! مفتخرم به شما اعلان کنم که به عنوان قدم بعدی در پروژه یکپارچه‌سازی پارسوید، به زودی پارسوید به عنوان موتور رندر‌کننده پیش‌فرض در ویکی فعال می‌شود.
ما با هدف تبدیل فارسوید به تجزیه‌گر پیش‌فرض ویکی‌متن در نسخه پشتیبانی طولانی‌مدت ویکی‌رسانه، به تدریح درحال افزایش شمار صفحاتی که از پارسوید استفاده می‌کنند هستیم.
این عمل افزایش اطمینان و یکپارچگی، ویکی‌ها را برای ویراستاران، خوانندگان، و ابزارهای مورداستفاده همچنین توسعه ویژگی برای ویکی‌متن را در آینده آسان‌تر می‌کند

اگر این عمل چرحه‌کار شما را بهم می‌ریزد، نگران نباشید! شما می‌توانید از طریق قسمت تنظیمات کاربر، یا در منوی ابزارها در صفحه فعلی، پارسوید را خاموش کنید. در سند [[mw:Special:MyLanguage/Help:Extension:ParserMigration|افزونه:کوچ‌پارسه]] می‌توانید جزئیات بیشتر را مطالعه کنید.

[[mw:Special:MyLanguage/Parsoid/Parser Unification/Confidence Framework|اطلاعات بیشتر درباره راهبرد عرضه]]، نظیر آزمایش‌های صورت‌گرفته قبل از فعال‌سازی فارسوید برای یک ویکی جدید در دسترس است.

برای گزارش ایراد و مشکلات، لطفا به قسمت  [[mw:Special:MyLanguage/Parsoid/Parser Unification/Known Issues|مشکلات یافته‌شده]] مراجعه کنید و اگر ایراد جدید یافته‌اید، می‌توانید یک تیکت فب، با برچسب [[phab:project/view/5846|Content Transform Team in Phabricator]] بسازید.
&lt;section end=&quot;announcement-content&quot; /&gt;

[[mw:User:MSantos (WMF)|Content Transform Team]] ۳ اوت ۲۰۲۶، ساعت ۱۶:۳۱ (UTC)
&lt;!-- پیام توسط کاربر:MSantos (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Global_message_delivery/Wikisource&amp;oldid=28221043 ارسال شده است --&gt;

== ویکی شما به زودی در حالت فقط خواندن قرار خواهد گرفت ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;

[[:m:Special:MyLanguage/Tech/Server switch|این خبرنامه را در زبان دیگری بخوانید]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|بنیاد ویکی‌مدیا]] ترافیک را بین مراکز داده‌اش جابه‌جا خواهد کرد. این کار باعث می‌شود که ویکی‌پدیا و دیگر ویکی‌های ویکی‌مدیا حتی پس از یک فاجعه آنلاین بمانند.

تمام ترافیک در '''{{#time:j xg|2026-09-23|fa}}''' جابه‌جا خواهد شد. جابه‌جایی از ساعت '''[https://zonestamp.toolforge.org/{{#time:U|2026-09-23T14:00|en}} {{#time:H:i e|2026-09-23T14:00}}]''' آغاز خواهد شد.

متأسفانه، به دلیل برخی محدودیت‌ها در [[mw:Special:MyLanguage/Manual:What is MediaWiki?|مدیاویکی]]، تمام ویرایش‌ها باید در هنگام جابه‌جایی متوقف شوند. بابت این اختلال پوزش می‌طلبیم و در تلاش هستیم که آن را در آینده به حداقل برسانیم. 

یک بنر ۳۰ دقیقه پیش از انجام این عملیات در تمام ویکی‌ها نمایش داده خواهد شد. این بنر تا پایان عملیات قابل مشاهده خواهد بود. 
&lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;You can contribute to the [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate translation or proofreading] of this banner text.&lt;/span&gt;

'''شما قادر خواهید بود تمام ویکی‌ها را بخوانید، اما برای مدت کوتاهی امکان ویرایش نخواهید داشت.'''

* تا یک ساعت در '''{{#time:l j xg Y|2026-09-23|fa}}''' قادر به ویرایش نخواهید بود.
* اگر در این مدت تلاش کنید ویرایش کنید یا تغییرات را ذخیره نمایید، یک پیام خطا مشاهده خواهید کرد. امیدواریم که در این دقایق هیچ ویرایشی از دست نرود، اما نمی‌توانیم آن را تضمین کنیم. اگر پیام خطا را مشاهده کردید، لطفاً منتظر بمانید تا همه چیز به حالت عادی بازگردد. پس از آن باید بتوانید ویرایش خود را ذخیره کنید. اما توصیه می‌کنیم که برای احتیاط، ابتدا یک نسخه از تغییرات خود تهیه کنید.

''تأثیرات دیگر:''

* وظایف پس‌زمینه کندتر اجرا خواهند شد و برخی ممکن است حذف شوند. پیوندهای قرمز ممکن است به سرعت معمول به‌روز نشوند. اگر مقاله‌ای ایجاد کنید که قبلاً در جای دیگری پیوند داده شده است، پیوند آن بیشتر از حد معمول قرمز خواهد ماند. برخی اسکریپت‌های بلندمدت باید متوقف شوند.
* انتظار داریم که استقرار کد مانند هر هفتهٔ دیگر انجام شود. با این حال، در برخی موارد، در صورت لزوم، مسدودسازی موقتی کد ممکن است به‌صورت موردی انجام شود.
* [[mw:Special:MyLanguage/GitLab|گیت‌لب]] برای حدود ۹۰ دقیقه در دسترس نخواهد بود.

این پروژه در صورت لزوم ممکن است به تعویق بیفتد. می‌توانید [[wikitech:Switch_Datacenter|برنامهٔ زمانی را در wikitech.wikimedia.org بخوانید]]. هرگونه تغییر در برنامهٔ زمانی اعلام خواهد شد. 

'''لطفاً این اطلاعات را با جامعهٔ خود به اشتراک بگذارید.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[m:user:Trizek (WMF)|Trizek (WMF)]] ۱۵ سپتامبر ۲۰۲۶، ساعت ۱۲:۵۸ (UTC)
&lt;!-- پیام توسط کاربر:Trizek (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 ارسال شده است --&gt;

== Your feedback wanted: Remove ''(Language link added:) and similar'' edits from Special:RecentChanges ==
''(Apologies for posting in English. You can help by translating it)''

Hello, I’m Danny from [[:en:w:Wikimedia_Deutschland|Wikimedia Deutschland’s]] [[m:Wikidata_For_Wikimedia_Projects|Wikidata For Wikimedia Projects]] team.&lt;br/&gt;
We have been investigating and examining how Wikidata’s use in the [[Special:RecentChanges]] and [[Special:Watchlist]] pages can be made to be more useful, or less ‘noisy’ (fewer edits that have little value to the reader).

We are currently exploring to make a change in the volume and the type of Wikidata edits that appear in these pages, and '''we need your feedback''' to help us ensure this is a positive change for the Wikis and won’t disrupt your workflows.&lt;br/&gt;
Language links are also known as sitelinks or interlanguage links and describe when a Wikidata item is connected to a Wiki, adding it to the language dropdown tool for other connected Wikis.
[[File:Types of Lang Link changes.png|x350px|frame|A variety of &quot;Language Link&quot; edits as seen in the Recent Changes feed]]

The request for feedback is whether you support the removal of these language link edits from the Recent Changes and Watchlist feed, or would you oppose such a change and if so, why?
Please share you thoughts on the dedicated '''[[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|metawiki Talk page]]'''. 

Further information about this change: [[m:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|m:Wikidata_For_Wikimedia_Projects/Hide_Language_Link_edits]]

Thank you for any participation or feedback you give, -- [[m:User:Danny_Benjafield_(WMDE)|User:Danny Benjafield (WMDE)]] ۲۵ سپتامبر ۲۰۲۶، ساعت ۱۲:۱۸ (UTC)
&lt;!-- پیام توسط کاربر:Danny Benjafield (WMDE)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31080967 ارسال شده است --&gt;

== Wikidata Sitelink changes in Recent Changes and Watchlist ==
''(Apologies for cross-posting in English, translating it will help spread the message)''

Editors on group 1 wikis, including Wikiquote, Wikibooks, Wikiversity, Wikivoyage, and Wikisource, will no longer see notifications on [[Special:RecentChanges|Recent Changes]] and [[Special:Watchlist|Watchlist]] when a link to ''another'' language version of a page is added, removed, or changed in its Wikidata item. This change will begin on '''October 5 at 07:00 UTC''' as a two-week trial to reduce high-volume, low-value notifications and make higher-value changes easier to identify. Editors who rely on these notifications should be aware of the change and can share feedback or concerns on the [[m:Wikidata For Wikimedia Projects/Clearer Wikidata Edit Summaries/Hide Language Link edits|project]] or [[m:Talk:Wikidata_For_Wikimedia_Projects/Clearer_Wikidata_Edit_Summaries/Hide_Language_Link_edits|talk page]].&lt;br/&gt;Please reach out if you have any questions, thank you! -- [[User:Danny_Benjafield_(WMDE)|Danny Benjafield (WMDE)]] ([[User_talk:Danny_Benjafield_(WMDE)|talk]])  sent via [[کاربر:MediaWiki message delivery|MediaWiki message delivery]] ([[بحث کاربر:MediaWiki message delivery|بحث]]) ۱ اکتبر ۲۰۲۶، ساعت ۱۲:۴۲ (UTC)
&lt;!-- پیام توسط کاربر:Danny Benjafield (WMDE)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=User:Danny_Benjafield_(WMDE)/MassMessage_test_list&amp;oldid=31106967 ارسال شده است --&gt;

== فضای نام بحث ==
با وجود [[ویکی‌نبشته:نظرخواهی برای تصحیح فضاهای نامی]]، [[phab:T90340|T90340]] و [[gerrit:190232|190232]] نام فضای نام بحث برگه و فهرست &quot;گفتگو&quot; مانده. [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۸ اکتبر ۲۰۲۶، ساعت ۲۲:۰۵ (UTC)

== &lt;span lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;[[الگو:بدون منبع]] vs [[الگو:منبع تصویر نامعلوم]]&lt;/span&gt; ==

&lt;div lang=&quot;en&quot; dir=&quot;ltr&quot;&gt;
FYI: {{Ping|Hanooz}}

Preamble: [[d:Special:Diff/2522804728/2555147831|diff 1]], [[d:Special:Diff/2550018724/2555147672|diff 2]], [[Special:Diff/70214/304040|diff 3]] and '''[[d:Special:Permalink/2558316316#Q5962027|discussion]]'''.

Hello,

[[d:Q5962027]] has been modified to accommodate a different template.

[[الگو:بدون منبع]] is returned to the correct version and [[الگو:منبع تصویر نامعلوم]] is the new template with the new Wikicode. If that's relevant, I'm happy. Otherwise, please give me feedback.

If you would like the pages currently using the old template to be updated to the new one, I can easily handle that via an automated process. Please let me know your thoughts on this as well.

Best regards. —[[کاربر:Eihel|Eihel]] ([[بحث کاربر:Eihel|بحث]]) ۱۸ اکتبر ۲۰۲۶، ساعت ۰۹:۰۳ (UTC)
:{{Ping|Eihel}} Do you know how many files does Persian Wikisource host? [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۱۸ اکتبر ۲۰۲۶، ساعت ۱۸:۲۳ (UTC)
::There is no connection between your question and what I wrote, {{Ping|Hanooz}}. Why this question? —[[کاربر:Eihel|Eihel]] ([[بحث کاربر:Eihel|بحث]]) ۱۸ اکتبر ۲۰۲۶، ساعت ۲۱:۴۰ (UTC)
::: Your answer shows how uninformed you are regarding this project. You created a file related template — just because there's a Persian '''Wikipedia''' template — in a wiki that host Zero files (and locally uploading are disabled out of a consensus) with the totally unrelated content you copied from the edit I made. You just added to the maintenance work of a very small wiki. You don't even seem to be aware of what Wikisource is or does generally. 
:::There's [[:الگو:صفحه‌های بی‌سند|Template:No scan]] for pages in main namespace that are not created using transclusion of the pages in page namespace and [[:الگو:بدون منبع|Template:No source]] for pages in main namespace that are not backed by Commons files and do not source external sources. [[کاربر:Hanooz|Hanooz]] ([[بحث کاربر:Hanooz|بحث]]) ۱۸ اکتبر ۲۰۲۶، ساعت ۲۲:۰۴ (UTC)
&lt;/div&gt;

== ویکی شما به زودی در حالت فقط خواندن قرار خواهد گرفت ==
&lt;section begin=&quot;server-switch&quot;/&gt;&lt;div class=&quot;plainlinks&quot;&gt;
[[:m:Special:MyLanguage/Tech/Server switch|این خبرنامه را در زبان دیگری بخوانید]] • [https://meta.wikimedia.org/w/index.php?title=Special:Translate&amp;group=page-Tech%2FServer+switch&amp;language=&amp;action=page&amp;filter= {{int:please-translate}}]

[[foundation:|بنیاد ویکی‌مدیا]] ترافیک را بین مراکز داده‌اش جابه‌جا خواهد کرد. این کار باعث می‌شود که ویکی‌پدیا و دیگر ویکی‌های ویکی‌مدیا حتی پس از یک فاجعه آنلاین بمانند.

تمام ترافیک در '''{{#time:j xg|2026-10-28|fa}}''' جابه‌جا خواهد شد. جابه‌جایی از ساعت '''[https://zonestamp.toolforge.org/{{#time:U|2026-10-28T15:00|en}} {{#time:H:i e|2026-10-28T15:00}}]''' آغاز خواهد شد.

متأسفانه، به دلیل برخی محدودیت‌ها در [[mw:Special:MyLanguage/Manual:What is MediaWiki?|مدیاویکی]]، تمام ویرایش‌ها باید در هنگام جابه‌جایی متوقف شوند. بابت این اختلال پوزش می‌طلبیم و در تلاش هستیم که آن را در آینده به حداقل برسانیم. 

یک بنر ۳۰ دقیقه پیش از انجام این عملیات در تمام ویکی‌ها نمایش داده خواهد شد. این بنر تا پایان عملیات قابل مشاهده خواهد بود. 
&lt;span lang=&quot;en&quot; dir=&quot;ltr&quot; class=&quot;mw-content-ltr&quot;&gt;You can contribute to the [https://meta.wikimedia.org/w/index.php?title=Special%3ATranslate&amp;group=Centralnotice-tgroup-read_only_banner&amp;task=view&amp;language=&amp;filter=&amp;action=translate translation or proofreading] of this banner text.&lt;/span&gt;

'''شما قادر خواهید بود تمام ویکی‌ها را بخوانید، اما برای مدت کوتاهی امکان ویرایش نخواهید داشت.'''

* تا یک ساعت در '''{{#time:l j xg Y|2026-10-28|fa}}''' قادر به ویرایش نخواهید بود.
* اگر در این مدت تلاش کنید ویرایش کنید یا تغییرات را ذخیره نمایید، یک پیام خطا مشاهده خواهید کرد. امیدواریم که در این دقایق هیچ ویرایشی از دست نرود، اما نمی‌توانیم آن را تضمین کنیم. اگر پیام خطا را مشاهده کردید، لطفاً منتظر بمانید تا همه چیز به حالت عادی بازگردد. پس از آن باید بتوانید ویرایش خود را ذخیره کنید. اما توصیه می‌کنیم که برای احتیاط، ابتدا یک نسخه از تغییرات خود تهیه کنید.

''تأثیرات دیگر:''

* وظایف پس‌زمینه کندتر اجرا خواهند شد و برخی ممکن است حذف شوند. پیوندهای قرمز ممکن است به سرعت معمول به‌روز نشوند. اگر مقاله‌ای ایجاد کنید که قبلاً در جای دیگری پیوند داده شده است، پیوند آن بیشتر از حد معمول قرمز خواهد ماند. برخی اسکریپت‌های بلندمدت باید متوقف شوند.
* انتظار داریم که استقرار کد مانند هر هفتهٔ دیگر انجام شود. با این حال، در برخی موارد، در صورت لزوم، مسدودسازی موقتی کد ممکن است به‌صورت موردی انجام شود.
* [[mw:Special:MyLanguage/GitLab|گیت‌لب]] برای حدود ۹۰ دقیقه در دسترس نخواهد بود.

این پروژه در صورت لزوم ممکن است به تعویق بیفتد. می‌توانید [[wikitech:Switch_Datacenter|برنامهٔ زمانی را در wikitech.wikimedia.org بخوانید]]. هرگونه تغییر در برنامهٔ زمانی اعلام خواهد شد. 

'''لطفاً این اطلاعات را با جامعهٔ خود به اشتراک بگذارید.'''&lt;/div&gt;&lt;section end=&quot;server-switch&quot;/&gt;

[[user:Trizek_(WMF)|Trizek_(WMF)]] ۲۶ اکتبر ۲۰۲۶، ساعت ۱۴:۰۱ (UTC)
&lt;!-- پیام توسط کاربر:Trizek (WMF)@metawiki با استفاده از فهرست در https://meta.wikimedia.org/w/index.php?title=Distribution_list/Non-Technical_Village_Pumps_distribution_list&amp;oldid=30513874 ارسال شده است --&gt;</text>
      <sha1>d0fhafd36dcw9cyijhlgi81rt4qzw6u</sha1>
    </revision>
  </page>
  <page>
    <title>الگو:شعر۲/توضیحات</title>
    <ns>10</ns>
    <id>98249</id>
    <revision>
      <id>305360</id>
      <timestamp>2026-10-27T02:03:29Z</timestamp>
      <contributor>
        <username>Hanooz</username>
        <id>17889</id>
      </contributor>
      <comment>صفحه‌ای تازه حاوی «{{زیرصفحه توضیحات}} این الگوها برای نمایش اشعار در ویکی‌نبشته به کار می‌روند. کار اصلی را [[پودمان:شعر]] انجام می‌دهد؛ الگوهای {{الگو|شعر}}، {{الگو|پایان شعر}}، {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}}، {{الگو|مصراع}}، {{الگو|بیت خالی}}، {{الگو|مص...» ایجاد کرد</comment>
      <origin>305360</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="117551" sha1="4ddrnqccflz59vg4hmsob1fmvu0fpu6" xml:space="preserve">{{زیرصفحه توضیحات}}
این الگوها برای نمایش اشعار در ویکی‌نبشته به کار می‌روند. کار اصلی را [[پودمان:شعر]] انجام می‌دهد؛ الگوهای {{الگو|شعر}}، {{الگو|پایان شعر}}، {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}}، {{الگو|مصراع}}، {{الگو|بیت خالی}}، {{الگو|مصراع خالی}} و {{الگو|جداکننده بند}} فقط درگاهی به آن‌اند و شیوه‌نامه‌شان در [[الگو:شعر/styles.css]] است. نام‌های کوتاه پیشین (&lt;code&gt;ب&lt;/code&gt;، &lt;code&gt;ب۱&lt;/code&gt;، &lt;code&gt;بن&lt;/code&gt;، &lt;code&gt;م&lt;/code&gt;) تغییرمسیر هستند و همچنان کار می‌کنند.

== امکانات در یک نگاه ==
* '''انواع ردیف:''' بیت دومصراعی، بیت پلکانی/ضربدری ({{الگو|بیت۱}} و {{الگو|بیت نردبانی}})، مصراع تنها و شعر نو؛ همه در یک شعر قابل ترکیب‌اند.
* '''چیدمان ثابت و هم‌تراز:''' همهٔ ابیات یک شعر — حتی اگر در چند جدولِ جدا (صفحه‌های جدا) باشند — از یک نقطه آغاز می‌شوند؛ با &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;حداکثر عرض&lt;/code&gt; قابل تنظیم است.
* '''ترازبندی:''' میانه، وسط، راست، چپ، دوطرفه (پهن) و لبه‌چین؛ برای کل شعر یا فقط یک ردیف.
* '''نماد و فاصله:''' نماد میان دو مصراع (&lt;code&gt;جداکننده&lt;/code&gt;)، نماد میان بندها (&lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt;، {{الگو|جداکننده بند}})، و فاصلهٔ دلخواه میان بندها (&lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;ارتفاع&lt;/code&gt;، &lt;code&gt;@فاصله&lt;/code&gt;).
* '''شماره‌گذاری:''' دستی (راست/وسط/چپ) و خودکار (هر ''n''‌امین بیت)، با تبدیل رقم به فارسی یا لاتین.
* '''نستعلیق:''' با &lt;code&gt;نستعلیق&lt;/code&gt;؛ قلم و اندازه از خودِ الگوی {{الگو|نستعلیق}} می‌آید.
* '''حالت «متن»:''' کل شعر به‌صورت خط‌های ساده در یک فراخوانی؛ با خط‌های &lt;code&gt;@…&lt;/code&gt; نوع ردیف و نماد/فاصلهٔ بندها را در میانهٔ متن عوض می‌کنید؛ نشانه‌های درون‌خطی برای شماره و تراز.
* '''شعر چندصفحه‌ای:''' پیش‌نمایش کامل هر «صفحه:» و دوخته‌شدن صفحه‌ها در صفحهٔ اصلی؛ مصراع یا بیتِ ناتمام در پایان صفحه هم پشتیبانی می‌شود.
* '''نمایش واکنش‌گرا:''' در پنجرهٔ باریک هر بیت «ستونی» می‌شود (دو مصراع زیر هم)؛ در فضای نام «صفحه» آستانهٔ ستونی‌شدن به طول مصراع‌ها بستگی دارد.
* '''پانویس:''' &lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt; در پایان مصراع بدون برهم‌زدن عرض و ترازبندی.
* زبان و جهت، سبک/کلاس/شناسه برای هر ردیف، و رده‌های پیگیری برای خطاها. ساختار خروجی همان جدول ۷ستونی است و برای کتاب الکترونیکی هم کار می‌کند.

== شروع سریع ==
=== با الگوها ===
شعر را با {{الگو|شعر}} باز کنید، هر بیت را با {{الگو|بیت}} بنویسید و با {{الگو|پایان شعر}} ببندید:
&lt;pre&gt;
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}

=== با حالت «متن» ===
همین شعر را می‌توان خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; نوشت؛ هر دو خط پیاپی یک بیت می‌شوند و نیازی به {{الگو|پایان شعر}} نیست:
&lt;pre&gt;
{{شعر|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
&lt;/pre&gt;
نتیجه:
{{شعر|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
حالت «متن» برای ویرایش دیداری و رونویسیِ اشعارِ بلند مناسب‌تر است؛ بخش [[#حالت «متن»|حالت «متن»]] را ببینید.

=== علامت «=» و «|» در مصراع ===
: '''نکته:''' اگر در مصراع علامت &lt;code&gt;=&lt;/code&gt; یا &lt;code&gt;|&lt;/code&gt; دارید، به‌جای آن‌ها &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید؛ وگرنه مصراع به‌عنوان پارامتر ناشناخته خوانده می‌شود و صفحه به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌رود. در حالت «متن» علامت &lt;code&gt;=&lt;/code&gt; مشکلی ندارد (پارامتر نام دارد)، ولی &lt;code&gt;|&lt;/code&gt; را باید با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید.

== الگوها ==
هر الگو فقط یک درگاه به پودمان است: متن آن &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|نقطهٔ ورود}}&lt;/nowiki&gt;&lt;/code&gt; است.
{| class=&quot;wikitable&quot;
! الگو !! نام کوتاه !! نقطهٔ ورود !! کار
|-
| {{الگو|شعر}} || — || &lt;code&gt;open&lt;/code&gt; || آغاز شعر؛ با &lt;code&gt;متن&lt;/code&gt; کل شعر را می‌سازد (بدون نیاز به {{الگو|پایان شعر}})
|-
| {{الگو|پایان شعر}} || — || &lt;code&gt;close&lt;/code&gt; || پایان شعر
|-
| {{الگو|بیت}} || &lt;code&gt;ب&lt;/code&gt; || &lt;code&gt;bayt&lt;/code&gt; || بیت دومصراعی
|-
| {{الگو|بیت۱}} || &lt;code&gt;ب۱&lt;/code&gt; || &lt;code&gt;stagger&lt;/code&gt; || بیت پلکانی (ضربدری)
|-
| {{الگو|بیت نردبانی}} || &lt;code&gt;بن&lt;/code&gt; || &lt;code&gt;ladder&lt;/code&gt; || بیت نردبانی (در نسخهٔ کنونی دقیقاً مانند {{الگو|بیت۱}})
|-
| {{الگو|مصراع}} || &lt;code&gt;م&lt;/code&gt; || &lt;code&gt;mesra&lt;/code&gt; || یک مصراعِ تنها
|-
| {{الگو|بیت خالی}} || — || &lt;code&gt;emptyBayt&lt;/code&gt; || یک خط خالی؛ با &lt;code&gt;ارتفاع&lt;/code&gt; فاصلهٔ دلخواه، با &lt;code&gt;نماد&lt;/code&gt; ردیفِ نماد
|-
| {{الگو|مصراع خالی}} || — || &lt;code&gt;emptyMesra&lt;/code&gt; || مانند {{الگو|بیت خالی}}، برای شعر نو
|-
| {{الگو|جداکننده بند}} || — || &lt;code&gt;divider&lt;/code&gt; || ردیفِ نمادِ سراسری و وسط‌چین میان دو بند
|}

== مرجع پارامترها ==
* نام‌های انگلیسی (ستون «هم‌ارز» در جدول‌ها) هم پذیرفته می‌شوند. نام‌های چندکلمه‌ای را هم با فاصله و هم با نیم‌فاصله می‌توان نوشت (مثلاً «حداکثر عرض» یا «حداکثر‌عرض»).
* پارامتر یا مقدارِ ناشناخته، مصراعِ اضافه و «=» در مصراع صفحه را به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌برد؛ پارامتر نادرست خوانده نمی‌شود ولی صفحه نمی‌شکند.
* مقدارِ «بله/نه» به این صورت‌ها هم نوشته می‌شود: &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;بلی&lt;/code&gt;، &lt;code&gt;آری&lt;/code&gt;، &lt;code&gt;yes&lt;/code&gt;، &lt;code&gt;true&lt;/code&gt;، &lt;code&gt;1&lt;/code&gt; / &lt;code&gt;نه&lt;/code&gt;، &lt;code&gt;خیر&lt;/code&gt;، &lt;code&gt;no&lt;/code&gt;، &lt;code&gt;false&lt;/code&gt;، &lt;code&gt;0&lt;/code&gt;.
* طول‌ها (عرض، تورفتگی، فاصله، ارتفاع…) عدد با واحد &lt;code&gt;%&lt;/code&gt;، &lt;code&gt;px&lt;/code&gt;، &lt;code&gt;em&lt;/code&gt;، &lt;code&gt;ex&lt;/code&gt;، &lt;code&gt;ch&lt;/code&gt;، &lt;code&gt;rem&lt;/code&gt;، &lt;code&gt;vw&lt;/code&gt;، &lt;code&gt;vh&lt;/code&gt;، &lt;code&gt;pt&lt;/code&gt;، &lt;code&gt;cm&lt;/code&gt;، &lt;code&gt;mm&lt;/code&gt; یا &lt;code&gt;in&lt;/code&gt; هستند؛ عدد بدون واحد پیکسل حساب می‌شود. رقم فارسی و «٪» هم پذیرفته است (&lt;code&gt;۲۰٪&lt;/code&gt;).

=== شعر (آغاز) ===
گزینه‌هایی که برای کل شعر اثر دارند در {{الگو|شعر}} داده می‌شوند.
==== گزینه‌های بی‌نام ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || گزینهٔ بی‌نام: &lt;code&gt;نستعلیق&lt;/code&gt; نمای نستعلیق را روشن می‌کند؛ &lt;code&gt;ادامه&lt;/code&gt; یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).
|-
| &lt;code&gt;2&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.
|}
==== چیدمان و اندازه ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;width&lt;/code&gt;&lt;/small&gt; || درصد یا طول (&lt;code&gt;80%&lt;/code&gt;، &lt;code&gt;30em&lt;/code&gt;، &lt;code&gt;480px&lt;/code&gt;) یا &lt;code&gt;خودکار&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; تا سقف &lt;code&gt;حداکثر عرض&lt;/code&gt;؛ با &lt;code&gt;&lt;nowiki&gt;ترازبندی=پهن&lt;/nowiki&gt;&lt;/code&gt; (بی‌عرض): &lt;code&gt;خودکار&lt;/code&gt; || عرض قاب شعر. عدد بدون واحد پیکسل است. &lt;code&gt;خودکار&lt;/code&gt; یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط &lt;code&gt;عرض&lt;/code&gt; بدهید سقف عرض ۱۰۰٪ می‌شود.
|-
| &lt;code&gt;حداکثر عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;max-width&lt;/code&gt;&lt;/small&gt; || طول یا &lt;code&gt;بدون&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض قاب (وقتی عرض ثابت است). &lt;code&gt;بدون&lt;/code&gt; (یا &lt;code&gt;none&lt;/code&gt;، &lt;code&gt;نامحدود&lt;/code&gt;) یعنی بی‌سقف.
|-
| &lt;code&gt;تلفن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;phone&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;ستونی&lt;/code&gt;، &lt;code&gt;دوستونه&lt;/code&gt;، &lt;code&gt;همیشه&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt;: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ &lt;code&gt;دوستونه&lt;/code&gt;: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ &lt;code&gt;همیشه&lt;/code&gt;: همیشه ستونی.
|}
==== ترازبندی و نمادها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;، &lt;code&gt;تراز‌بندی&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;میانه&lt;/code&gt; (&lt;code&gt;درون&lt;/code&gt;)، &lt;code&gt;وسط&lt;/code&gt; (&lt;code&gt;مرکز&lt;/code&gt;)، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;پهن&lt;/code&gt; (&lt;code&gt;دوطرفه&lt;/code&gt;)، &lt;code&gt;لبه&lt;/code&gt; || &lt;code&gt;میانه&lt;/code&gt; برای بیت دومصراعی؛ &lt;code&gt;لبه&lt;/code&gt; برای بیت پلکانی || ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). &lt;code&gt;میانه&lt;/code&gt;: مصراع‌ها به محور میانی می‌چسبند؛ &lt;code&gt;لبه&lt;/code&gt;: مصراع نخست به راست و دوم به چپ؛ &lt;code&gt;پهن&lt;/code&gt;: دوطرفه.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (❖)، &lt;code&gt;نه&lt;/code&gt;، یا یک نمادِ کوتاه مثل &lt;code&gt;✤&lt;/code&gt; || بدون نماد || نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی &lt;code&gt;شو&lt;/code&gt; نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.
|-
| &lt;code&gt;جداکننده بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza-separator&lt;/code&gt;، &lt;code&gt;جداکنندهٔ بند&lt;/code&gt;، &lt;code&gt;نماد بند&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (• • •)، &lt;code&gt;نه&lt;/code&gt;، یا هر نمادِ کوتاه (&lt;code&gt;❖&lt;/code&gt;، &lt;code&gt;❖ ❖ ❖&lt;/code&gt;) || بدون نماد || ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت &lt;code&gt;متن&lt;/code&gt; به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط &lt;code&gt;@نماد&lt;/code&gt; یا الگوی «جداکننده بند» استفاده کنید.
|}
==== حالت «متن» و نوع ردیف‌ها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;متن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;text&lt;/code&gt;&lt;/small&gt; || خط‌های ساده || — || کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.
|-
| &lt;code&gt;نوع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;type&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بیت&lt;/code&gt;، &lt;code&gt;بیت۱&lt;/code&gt; (&lt;code&gt;پلکانی&lt;/code&gt;)، &lt;code&gt;بیت نردبانی&lt;/code&gt; (&lt;code&gt;نردبانی&lt;/code&gt;)، &lt;code&gt;مصراع&lt;/code&gt; (&lt;code&gt;نو&lt;/code&gt;، &lt;code&gt;نیمایی&lt;/code&gt;، &lt;code&gt;آزاد&lt;/code&gt;) || &lt;code&gt;بیت&lt;/code&gt; || نوع پیش‌فرض ردیف‌ها در حالت &lt;code&gt;متن&lt;/code&gt;. با &lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt; ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;راست&lt;/code&gt; در شعر نو؛ &lt;code&gt;وسط&lt;/code&gt; برای مصراع تنهای پایان بند || تراز مصراع‌های تنها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || تورفتگی ردیف‌های پلکانی/نردبانی در حالت &lt;code&gt;متن&lt;/code&gt;. بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.
|-
| &lt;code&gt;واحد تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent-unit&lt;/code&gt;، &lt;code&gt;واحد‌تورفتگی&lt;/code&gt;&lt;/small&gt; || طول || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر «:» در شعر نو (&lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;فاصله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;gap&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصلهٔ میان بندها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;جدید&lt;/code&gt; || — || در حالت &lt;code&gt;متن&lt;/code&gt; و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt;) می‌گذارد.
|}
==== شماره‌گذاری ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;شماره‌گذاری&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;numbering&lt;/code&gt;، &lt;code&gt;شماره&lt;/code&gt;، &lt;code&gt;شمارهگذاری&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، عدد (&lt;code&gt;5&lt;/code&gt;)، &lt;code&gt;نه&lt;/code&gt; || خاموش || &lt;code&gt;بله&lt;/code&gt;: شمارهٔ همهٔ ابیات؛ یک عدد مثل &lt;code&gt;5&lt;/code&gt;: هر پنجمین بیت؛ &lt;code&gt;نه&lt;/code&gt; (یا &lt;code&gt;0&lt;/code&gt;): خاموش.
|-
| &lt;code&gt;شروع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;start&lt;/code&gt;&lt;/small&gt; || عدد || &lt;code&gt;1&lt;/code&gt; || شمارهٔ بیت نخست.
|-
| &lt;code&gt;سمت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;side&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;وسط&lt;/code&gt; || &lt;code&gt;چپ&lt;/code&gt; || سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) &lt;code&gt;وسط&lt;/code&gt; همان &lt;code&gt;چپ&lt;/code&gt; است.
|-
| &lt;code&gt;ارقام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;digits&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فارسی&lt;/code&gt; (&lt;code&gt;fa&lt;/code&gt;)، &lt;code&gt;لاتین&lt;/code&gt; (&lt;code&gt;latin&lt;/code&gt;)، &lt;code&gt;بدون تغییر&lt;/code&gt; (&lt;code&gt;keep&lt;/code&gt;) || &lt;code&gt;فارسی&lt;/code&gt; || تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.
|}
==== ظاهر ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;نستعلیق&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;nastaliq&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن &lt;code&gt;نستعلیق&lt;/code&gt; به‌صورت بی‌نام (&lt;code&gt;&lt;nowiki&gt;{{شعر|نستعلیق}}&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی قاب بیرونی شعر (با &lt;code&gt;&lt;nowiki&gt;عرض=خودکار&lt;/nowiki&gt;&lt;/code&gt;: روی جدول).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به قاب شعر.
|-
| &lt;code&gt;زبان&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;lang&lt;/code&gt;&lt;/small&gt; || کد زبان (&lt;code&gt;ar&lt;/code&gt;، &lt;code&gt;en&lt;/code&gt;، &lt;code&gt;fa&lt;/code&gt;) || — || برای ابیات غیرفارسی؛ خصوصیت &lt;code&gt;lang&lt;/code&gt; را می‌گذارد و &lt;code&gt;جهت&lt;/code&gt; را از آن حدس می‌زند.
|-
| &lt;code&gt;جهت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;dir&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;rtl&lt;/code&gt;، &lt;code&gt;ltr&lt;/code&gt; || از &lt;code&gt;زبان&lt;/code&gt; حدس زده می‌شود || جهت متن.
|}
==== شعر چندصفحه‌ای ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || الگو: &lt;code&gt;ادامه&lt;/code&gt; (بی‌نام) یا &lt;code&gt;قبل&lt;/code&gt;؛ حالت &lt;code&gt;متن&lt;/code&gt;: &lt;code&gt;قبل&lt;/code&gt;، &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || — || شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است (&lt;code&gt;قبل&lt;/code&gt;) و/یا در صفحهٔ بعد ادامه دارد (&lt;code&gt;بعد&lt;/code&gt;، فقط حالت &lt;code&gt;متن&lt;/code&gt;). در حالت &lt;code&gt;متن&lt;/code&gt;، &lt;code&gt;&lt;nowiki&gt;ادامه=بله&lt;/nowiki&gt;&lt;/code&gt; مبهم است و پذیرفته نمی‌شود.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;اول&lt;/code&gt;، &lt;code&gt;دوم&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. &lt;code&gt;اول&lt;/code&gt;/&lt;code&gt;دوم&lt;/code&gt;: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.
|}
==== فضای نام «صفحه» ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;طول مصراع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;hemistich-length&lt;/code&gt;، &lt;code&gt;طول‌مصراع&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;کوتاه&lt;/code&gt;، &lt;code&gt;متوسط&lt;/code&gt;، &lt;code&gt;بلند&lt;/code&gt;، عدد، &lt;code&gt;خودکار&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: خودکار؛ حالت الگو: &lt;code&gt;متوسط&lt;/code&gt; || فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع (&lt;code&gt;کوتاه&lt;/code&gt; تا ۲۰ نویسه، &lt;code&gt;متوسط&lt;/code&gt; تا ۳۰، &lt;code&gt;بلند&lt;/code&gt; بیشتر؛ یا خودِ شمار نویسه).
|}

=== پایان شعر ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;ادامه&lt;/code&gt; || — || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;: شعر در صفحهٔ بعد ادامه دارد (جدول بسته نمی‌شود).
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt;، &lt;code&gt;بله&lt;/code&gt; || — || مانند &lt;code&gt;ادامه&lt;/code&gt; بی‌نام. &lt;code&gt;قبل&lt;/code&gt; را در «شعر» بنویسید.
|}

=== بیت ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست (سمت راست). اگر فقط یکی از دو مصراع پر باشد (و ردیف ناتمام/دنباله نباشد) صفحه به ردهٔ «بیت ناقص» می‌رود.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم (سمت چپ).
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانِ دو مصراع (جای نمادِ &lt;code&gt;جداکننده&lt;/code&gt; را می‌گیرد).
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt;، نماد || از «شعر» || نمادِ میان دو مصراعِ همین بیت (&lt;code&gt;نه&lt;/code&gt; برای حذف).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت۱ و بیت نردبانی ===
هر دو یک پارامتر دارند (در نسخهٔ کنونی خروجی‌شان یکی است). ستون میانی ندارند، پس &lt;code&gt;شو&lt;/code&gt; و &lt;code&gt;جداکننده&lt;/code&gt; در آن‌ها اثری ندارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== مصراع ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || متن مصراع.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;وسط&lt;/code&gt; || تراز مصراع. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت خالی و مصراع خالی ===
این دو الگو سه کار می‌کنند: بدون پارامتر یک خط خالی (در {{الگو|بیت خالی}} با ستون‌های شماره)، با &lt;code&gt;ارتفاع&lt;/code&gt; یک فاصلهٔ دلخواه، و با &lt;code&gt;نماد&lt;/code&gt; (یا وقتی {{الگو|شعر}} پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) یک ردیفِ نماد. جدول زیر برای {{الگو|بیت خالی}} است؛ {{الگو|مصراع خالی}} همین پارامترها را بدون &lt;code&gt;شو&lt;/code&gt; دارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصله (پیش‌فرض یک خط). به‌تنهایی فقط &lt;code&gt;کلاس&lt;/code&gt; اثر دارد؛ همراه &lt;code&gt;نماد&lt;/code&gt; ارتفاعِ ردیف نماد را تعیین می‌کند.
|-
| &lt;code&gt;نماد&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;symbol&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;نه&lt;/code&gt; یا نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) || — || به‌جای خط خالی، یک ردیفِ نمادِ سراسری و وسط‌چین می‌آورد؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت راست؛ فقط در ردیف خالیِ ساده (بدون &lt;code&gt;ارتفاع&lt;/code&gt; و &lt;code&gt;نماد&lt;/code&gt;).
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانی؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت چپ؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف خالی (با &lt;code&gt;نماد&lt;/code&gt;: روی ردیف نماد؛ با &lt;code&gt;ارتفاع&lt;/code&gt; به‌تنهایی اثر ندارد).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف؛ فقط در ردیف خالیِ ساده.
|}

=== جداکننده بند ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) یا &lt;code&gt;نه&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt; شعر، وگرنه • • • || نمادِ ردیف؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده. همان &lt;code&gt;&lt;nowiki&gt;نماد=&lt;/nowiki&gt;&lt;/code&gt; را هم می‌پذیرد.
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع ردیف نماد (پیش‌فرض یک خط)؛ نماد در میانهٔ آن می‌نشیند.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف نماد؛ مثلاً &lt;code&gt;color:#b3362b&lt;/code&gt; برای رنگ یا &lt;code&gt;font-size:150%&lt;/code&gt; برای اندازه.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|}

== چیدمان: عرض ثابت و هم‌تراز ==
جدول شعر به‌طور پیش‌فرض '''عرضی ثابت و مستقل از محتوا''' دارد: عرض ۱۰۰٪ فضای موجود با سقف &lt;code&gt;50em&lt;/code&gt;، با دو ستونِ هم‌اندازه برای مصراع‌ها، یک ستون میانی (فاصلهٔ دو مصراع) و دو ستونِ باریک برای شماره‌ها. نتیجه این است که همهٔ ابیات یک شعر از یک نقطه آغاز می‌شوند و اگر شعر در چند جدول جدا (مثلاً هر صفحه یک جدول) بیاید، قاب‌ها دقیقاً هم‌اندازه و هم‌تراز می‌مانند؛ برخلاف جدولِ هم‌اندازهٔ محتوا که عرضش بسته به بلندترین مصراعِ همان صفحه فرق می‌کند و آغاز شعر را در مرز صفحه جابه‌جا می‌کند.
&lt;pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
* '''عرض=خودکار:''' جدول به اندازهٔ محتوا می‌شود (و وسط‌چین): برای رباعی یا شعر کوتاه که نمی‌خواهید قاب پهن داشته باشد.
{{شعر|عرض=خودکار}}
{{بیت|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''حداکثر عرض:''' سقف عرض را عوض می‌کند: &lt;code&gt;حداکثر عرض=40em&lt;/code&gt;، یا &lt;code&gt;حداکثر عرض=بدون&lt;/code&gt; برای بی‌سقف.
* همهٔ ستون‌ها را همین عرض تعیین می‌کند؛ پس مصراع‌های بلندتر از ستون به چند خط شکسته می‌شوند. برای شعرهای بلندمصراع یا نستعلیق (قلم درشت‌تر) &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید.
* با &lt;code&gt;ترازبندی=پهن&lt;/code&gt; اگر &lt;code&gt;عرض&lt;/code&gt; ندهید، جدول هم‌اندازهٔ محتوا (&lt;code&gt;عرض=خودکار&lt;/code&gt;) است، چون در شعر دوطرفه ستون‌ها باید به اندازهٔ بلندترین مصراع شوند؛ با دادنِ &lt;code&gt;عرض&lt;/code&gt; همان عرضِ ثابت اعمال می‌شود.
* در شعر چندصفحه‌ای فقط گزینه‌های {{الگو|شعر}} صفحهٔ نخست در صفحهٔ اصلی اثر دارد (بخش «شعر چندصفحه‌ای»).
* مدیران پودمان می‌توانند پیش‌فرض را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند (&lt;code&gt;defaultWidth&lt;/code&gt;، &lt;code&gt;maxWidth&lt;/code&gt;؛ مقدار &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند).

== ترازبندی مصراع‌ها ==
پارامتر &lt;code&gt;ترازبندی&lt;/code&gt; در {{الگو|شعر}} (برای همهٔ ابیات) یا در هر ردیف (فقط همان ردیف) مشخص می‌کند متن مصراع‌ها در جایگاه خود چگونه بنشیند:
{| class=&quot;wikitable&quot;
! مقدار !! معنی
|-
| &lt;code&gt;میانه&lt;/code&gt; (یا &lt;code&gt;درون&lt;/code&gt;) || '''پیش‌فرض {{الگو|بیت}}.''' هر دو مصراع به محور میانیِ بیت می‌چسبند (مصراع نخست به چپِ جایگاهش، مصراع دوم به راستِ جایگاهش)؛ فاصلهٔ دو مصراع در همهٔ ابیات یکسان می‌ماند — شیوهٔ کتاب‌های کلاسیک و گنجور.
|-
| &lt;code&gt;وسط&lt;/code&gt; (یا &lt;code&gt;مرکز&lt;/code&gt;) || هر مصراع وسط جایگاهش.
|-
| &lt;code&gt;راست&lt;/code&gt; / &lt;code&gt;چپ&lt;/code&gt; || همهٔ مصراع‌ها به راست/چپ جایگاهشان چسبیده (همهٔ خط‌ها از یک نقطه آغاز می‌شوند).
|-
| &lt;code&gt;پهن&lt;/code&gt; (یا &lt;code&gt;دوطرفه&lt;/code&gt;) || دوطرفه: هر مصراع کل پهنای جایگاهش را می‌گیرد (چیدمان چاپی کلاسیک). همهٔ ستون‌ها به اندازهٔ بلندترین مصراعِ کل شعر می‌شوند. اگر کوتاه‌ترین مصراعِ یک بیت کمتر از ۷۰٪ بلندترینِ همان بیت باشد، آن بیت کشیده نمی‌شود (وسط‌چین می‌ماند) تا فاصلهٔ واژه‌ها بی‌جهت باز نشود.
|-
| &lt;code&gt;لبه&lt;/code&gt; || مصراع نخست به آغاز (راست) و مصراع دوم به پایان (چپ) می‌چسبد؛ '''پیش‌فرض {{الگو|بیت۱}} و {{الگو|بیت نردبانی}}'''.
|}
&lt;pre&gt;
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
'''پهن (دوطرفه):'''
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''میانه (پیش‌فرض):'''
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''وسط:'''
{{شعر|ترازبندی=وسط}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''راست:'''
{{شعر|ترازبندی=راست}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''لبه:'''
{{شعر|ترازبندی=لبه}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
ترازبندی در یک ردیف (بقیه پیش‌فرض می‌مانند): &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|ترازبندی=پهن}}&lt;/nowiki&gt;&lt;/code&gt;

== بیت پلکانی (ضربدری) و نردبانی ==
برای نمایش ابیات به‌صورت ضربدری و نامتقارن از {{الگو|بیت۱}} (یا {{الگو|بیت نردبانی}}) به‌جای {{الگو|بیت}} استفاده کنید؛ هر بیت روی '''دو خط''' می‌آید. بدون پارامتر، مصراع نخست در نیمهٔ راست و مصراع دوم (در خط بعد) در نیمهٔ چپ می‌نشیند و هر دو به لبهٔ خود می‌چسبند (&lt;code&gt;ترازبندی=لبه&lt;/code&gt;):
&lt;pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''تورفتگی:''' با &lt;code&gt;تورفتگی&lt;/code&gt; هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» می‌شود که یکی به راست و دیگری به چپ می‌چسبد؛ هرچه تورفتگی کمتر باشد پله‌ها کوتاه‌ترند:
&lt;pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
* '''ترکیب با بیت دومصراعی:''' انواع ردیف را می‌توان در یک شعر آمیخت:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
* '''{{الگو|بیت نردبانی}}:''' در نسخهٔ کنونی پودمان همان {{الگو|بیت۱}} است و تورفتگی پیش‌فرضِ جداگانه‌ای ندارد؛ برای پله‌های بلندتر یا کوتاه‌تر &lt;code&gt;تورفتگی&lt;/code&gt; بدهید.
* مقدار &lt;code&gt;تورفتگی&lt;/code&gt; را با ٪ یا واحدهای &lt;code&gt;em&lt;/code&gt; و &lt;code&gt;px&lt;/code&gt; می‌توان داد (مقدار بدون واحد پیکسل است).
* ترازبندی پیش‌فرض این دو &lt;code&gt;لبه&lt;/code&gt; است؛ برای وسط‌چین‌کردن جعبه‌ها &lt;code&gt;ترازبندی=وسط&lt;/code&gt; بدهید.
* با &lt;code&gt;عرض=خودکار&lt;/code&gt; (چیدمان هم‌اندازهٔ محتوا) تورفتگی نسبت به عرضِ جدول است و جدول به اندازهٔ محتوا می‌شود.

== نماد میان دو مصراع ==
پارامتر &lt;code&gt;جداکننده&lt;/code&gt; نمادی را میان دو مصراعِ هر بیت می‌گذارد (در ستون میانی). &lt;code&gt;بله&lt;/code&gt; نمادِ پیش‌فرض ❖ را می‌گذارد، هر نمادِ کوتاهی هم پذیرفته است، و &lt;code&gt;نه&lt;/code&gt; آن را حذف می‌کند:
&lt;pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
* در {{الگو|شعر}} برای همهٔ ابیات اثر دارد و در هر ردیف فقط برای همان ردیف.
* اگر شمارهٔ میانی (&lt;code&gt;شو&lt;/code&gt;) آمده باشد جای نماد را می‌گیرد.
* نماد باید کوتاه باشد (تا حدود ۸ نویسه) و &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;&amp;gt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;}&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; &lt;code&gt;]&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; نداشته باشد؛ وگرنه نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* در نمایش ستونی (صفحهٔ باریک) نماد پنهان می‌شود. رنگ و اندازه‌اش با &lt;code&gt;.poem-sep&lt;/code&gt; در [[الگو:شعر/styles.css]] تعیین می‌شود؛ پیش‌فرض همگانی را مدیر پودمان با &lt;code&gt;cfg.separator&lt;/code&gt; می‌دهد.
* این نماد میان '''دو مصراعِ یک بیت''' است؛ برای نمادِ میان '''دو بند''' بخش بعد را ببینید.

== بندها: فاصله و نماد ==
بیت‌ها معمولاً در «بند» دسته می‌شوند (رباعی، چهارپاره و…). میان بندها می‌توان یک فاصله یا یک نماد (مثل • • • یا ❖) گذاشت.

=== فاصلهٔ ساده ===
هنگامی که بخواهید میان ابیات یا مصراع‌های یک قطعه یک خط فاصله ایجاد کنید، از این الگوها استفاده کنید:
* {{الگو|بیت خالی}}
* {{الگو|مصراع خالی}}

برای فاصله‌ای کوتاه‌تر یا بلندتر از یک خط پارامتر &lt;code&gt;ارتفاع&lt;/code&gt; را بدهید: &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» خط خالی میان دو بند همین کار را می‌کند (یک خط؛ اندازه‌اش را &lt;code&gt;فاصله=0.5em&lt;/code&gt; عوض می‌کند).
&lt;pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}

=== نماد میان بندها ===
{{الگو|جداکننده بند}} یک ردیفِ '''سراسری و وسط‌چین''' با نماد می‌گذارد؛ نمادِ پیش‌فرض • • • است و هر نمادِ دیگری را می‌توان به‌صورت پارامتر بی‌نام داد. (همین کار را &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=…}}&lt;/nowiki&gt;&lt;/code&gt; هم می‌کند.)
&lt;pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
اگر نماد را برای '''همهٔ''' بندها می‌خواهید، پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; را در {{الگو|شعر}} بدهید: آن‌گاه هر {{الگو|بیت خالی}}ِ بی‌ارتفاع (و در حالت «متن» هر خط خالی میان دو بند) ردیفِ نماد می‌شود.
&lt;pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
&lt;/pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
* ردیفِ نماد همیشه یک خط بلند است (با &lt;code&gt;ارتفاع&lt;/code&gt; بلندتر می‌شود)، نمادش پررنگ است و رنگش از متن ارث می‌برد؛ برای رنگ دیگر: &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|سبک=color:#b3362b}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» رنگ و اندازه را شیوه‌نامه (&lt;code&gt;.poem-ornament-cell&lt;/code&gt;) تعیین می‌کند.
* ردیفِ نماد در نمایش ستونی هم دیده می‌شود (برخلاف نمادِ میان دو مصراع).
* برای فاصلهٔ ساده در شعری که نمادِ خودکار دارد: {{الگو|جداکننده بند}}&lt;code&gt;|نه&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt;، و در حالت «متن» خط &lt;code&gt;@نماد نه&lt;/code&gt;.
* نمادِ پیش‌فرض را مدیر پودمان با &lt;code&gt;cfg.stanzaOrnament&lt;/code&gt; عوض می‌کند.

=== نماد و فاصله در حالت «متن» ===
در حالت «متن» دو خطِ ویژه، بریدگیِ میان بندها را جداگانه تنظیم می‌کنند (هر کدام در یک خطِ جدا و با &lt;code&gt;@&lt;/code&gt; آغاز می‌شود):
{| class=&quot;wikitable&quot;
! خط !! کار
|-
| &lt;code&gt;@نماد&lt;/code&gt; || یک ردیفِ نمادِ پیش‌فرض (• • •) همین‌جا
|-
| &lt;code&gt;@نماد ❖&lt;/code&gt; || یک ردیفِ نمادِ دلخواه
|-
| &lt;code&gt;@نماد نه&lt;/code&gt; || فاصلهٔ ساده (برای شعری که &lt;code&gt;جداکننده بند&lt;/code&gt; دارد)
|-
| &lt;code&gt;@فاصله&lt;/code&gt; || یک ردیف فاصلهٔ اضافه (یک خط یا اندازهٔ &lt;code&gt;فاصله=&lt;/code&gt;)
|-
| &lt;code&gt;@فاصله 3em&lt;/code&gt; || یک ردیف فاصله با اندازهٔ دلخواه
|}
&lt;pre&gt;
{{شعر|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
&lt;/pre&gt;
{{شعر|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
* این خط‌ها جای خط‌های خالیِ کنارشان را می‌گیرند (خط خالی پیش و پس از آن‌ها شمرده نمی‌شود)؛ پس برای خوانایی می‌توانید دورشان خط خالی بگذارید.
* می‌توان چند خط را پشت‌سرهم نوشت: هر کدام یک ردیف می‌شود، به همان ترتیب (تا هشت ردیف). مثلاً &lt;code&gt;@نماد&lt;/code&gt; و بعد &lt;code&gt;@فاصله&lt;/code&gt; یک نماد و یک فاصلهٔ اضافه می‌دهد.
* '''چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند''' (برای سازگاری با شعرهای پیشین)؛ فاصلهٔ بزرگ‌تر را با &lt;code&gt;@فاصله&lt;/code&gt; بگیرید.
* خط &lt;code&gt;@نماد&lt;/code&gt; یا &lt;code&gt;@فاصله&lt;/code&gt; پیش از نخستین ردیف نادیده گرفته می‌شود. نام‌های دیگرِ پذیرفته‌شده: &lt;code&gt;@جداکننده&lt;/code&gt;، &lt;code&gt;@جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد بند&lt;/code&gt;، &lt;code&gt;@ornament&lt;/code&gt;، &lt;code&gt;@separator&lt;/code&gt;، &lt;code&gt;@symbol&lt;/code&gt; (برای نماد) و &lt;code&gt;@gap&lt;/code&gt; (برای فاصله).
* در پایان بند، مصراعِ تنها (اگر خط‌های بند فرد باشند) پیش از فاصله/نماد جای خود را می‌گیرد.

=== کدام را به کار ببرم؟ ===
{| class=&quot;wikitable&quot;
! می‌خواهم !! با الگوها !! در حالت «متن»
|-
| فاصلهٔ یک‌خطی میان بندها || {{الگو|بیت خالی}} || یک خط خالی
|-
| فاصلهٔ دلخواه || &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;فاصله=0.5em&lt;/code&gt; (همهٔ بندها) یا &lt;code&gt;@فاصله 0.5em&lt;/code&gt; (همان‌جا)
|-
| نماد میان همهٔ بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و {{الگو|بیت خالی}} میان بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و خط خالی میان بندها
|-
| نماد فقط در یک بریدگی || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|• • •}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد • • •&lt;/code&gt;
|-
| فاصلهٔ ساده در شعری که نمادِ خودکار دارد || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|نه}}&lt;/nowiki&gt;&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد نه&lt;/code&gt;
|-
| نماد به‌جای یک فاصلهٔ بلندتر || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|ارتفاع=3em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد ❖&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; پشت‌سرهم
|}

== مصراع‌های تنها و شعر نو ==
الگوی {{الگو|مصراع}} یک مصراع را وسط‌چین می‌نویسد. برای شعر نو می‌توانید تراز و تورفتگی بدهید:
&lt;pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
* &lt;code&gt;تراز&lt;/code&gt;: &lt;code&gt;وسط&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;راست&lt;/code&gt; یا &lt;code&gt;چپ&lt;/code&gt;. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
* مصراعِ تنها در میان ابیات (مثلاً مصراع پایانی یک بند) وسط‌چین می‌آید و زیر دو ستونِ شعر قرار می‌گیرد.
* در شعرِ نو معمولاً {{الگو|شعر}} را با &lt;code&gt;نوع=مصراع&lt;/code&gt; به کار می‌برند تا مصراع‌ها در شماره‌گذاری خودکار شمرده شوند؛ نوشتنِ شعر نو در حالت «متن» ساده‌تر است (بخش «حالت «متن»»).

== شماره‌گذاری ==
=== شماره‌گذاری دستی ===
اگر می‌خواهید در سمت راست یک بیت شمارهٔ آن را درج کنید، از پارامتر «ش» (مخفف «شماره») استفاده کنید. برای شماره در وسط (میان دو مصراع) از «شو» و برای سمت چپ از «شچ» استفاده کنید:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
* '''ارقام:''' رقم‌های لاتین و عربی در شماره‌ها خودکار به رقم فارسی تبدیل می‌شوند (&lt;code&gt;ش=12&lt;/code&gt; ← ۱۲). برای خاموش‌کردن، در {{الگو|شعر}} بنویسید &lt;code&gt;ارقام=بدون تغییر&lt;/code&gt; یا &lt;code&gt;ارقام=لاتین&lt;/code&gt;. مقداری که نشانه‌گذاری دارد (مثلاً پیوند یا قالب‌بندی) دست‌نخورده می‌ماند.

=== شماره‌گذاری خودکار ===
به‌جای نوشتن دستی شماره‌ها، در {{الگو|شعر}} پارامتر &lt;code&gt;شماره‌گذاری&lt;/code&gt; را بدهید:
&lt;pre&gt;
{{شعر|شماره‌گذاری=5|شروع=1}}
{{بیت|مصراع اول|مصراع دوم}}
… (شمارهٔ ۵، ۱۰، ۱۵ و … در سمت چپ نمایش داده می‌شود)
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|شماره‌گذاری=بله|سمت=راست}}
{{بیت|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{پایان شعر}}
* بیت‌های {{الگو|بیت}}، {{الگو|بیت۱}} و {{الگو|بیت نردبانی}} شمرده می‌شوند. {{الگو|مصراع}} فقط وقتی شمرده می‌شود که &lt;code&gt;نوع=مصراع&lt;/code&gt; داده باشید.
* با &lt;code&gt;شماره‌گذاری=5&lt;/code&gt; همهٔ ابیات شمرده می‌شوند ولی فقط شمارهٔ مضرب ۵ نمایش داده می‌شود؛ &lt;code&gt;شروع&lt;/code&gt; شمارهٔ بیت نخست را تعیین می‌کند (برای صفحه‌ای که از میانهٔ شعر آغاز می‌شود، شمارهٔ نخستین بیت همان صفحه را بدهید).
* اگر برای بیتی خودتان ش، شو یا شچ بدهید، همان نمایش داده می‌شود و شمارش خودکار برای آن بیت کنار می‌رود (شمارنده همچنان جلو می‌رود).
* مصراع تنهای پایان بند (در حالت «متن») شمرده نمی‌شود.
* شمارنده در طول رندر یک صفحه نگه داشته می‌شود و با هر {{الگو|شعر}} از نو آغاز می‌شود (مگر در شعر چندصفحه‌ای؛ بخش بعد).

== نستعلیق ==
*نکته: در صورت استفاده از نستعلیق {{الگو|دارای نستعلیق}} را استفاده کنید تا اگر کاربر فونت نستعلیق را ندارد از آن را نصب و استفاده نماید.
{{دارای نستعلیق}}

دستورات زیر:
&lt;pre&gt;
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
چنین نتیجه می‌دهد:
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
* '''چگونه کار می‌کند:''' پودمان خودِ الگوی {{الگو|نستعلیق}} را بسط می‌دهد و کلاس و استایل‌های قلم (&lt;code&gt;font-family&lt;/code&gt;، &lt;code&gt;font-size&lt;/code&gt;، &lt;code&gt;line-height&lt;/code&gt; و…) را که آن الگو می‌گذارد روی شعر می‌نشاند؛ پس هر تغییر در {{الگو|نستعلیق}} (و شیوه‌نامهٔ آن) خودکار به شعرها هم می‌رسد و به &lt;code&gt;Common.css&lt;/code&gt; یا ترتیب شیوه‌نامه‌ها وابسته نیست. اگر آن الگو در دسترس نباشد، فهرستِ قلمِ &lt;code&gt;cfg.nastaliqFonts&lt;/code&gt; به کار می‌رود.
* پارامتر &lt;code&gt;قلم&lt;/code&gt; وجود ندارد. برای قلمی دیگر، یا {{الگو|نستعلیق}} را تغییر دهید یا در {{الگو|شعر}} بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|سبک=font-family: Vazirmatn, serif}}&lt;/nowiki&gt;&lt;/code&gt;.
* قلم‌ها باید روی دستگاه خواننده نصب باشند (وب‌قلم بارگذاری نمی‌شود)؛ اگر نیستند، قلم پیش‌فرض نمایش داده می‌شود.
* اگر نستعلیق اعمال نمی‌شود: (۱) صفحهٔ شیوه‌نامهٔ شعر ([[الگو:شعر/styles.css]]) باید ساخته و از نوع «Sanitized CSS» باشد؛ (۲) قلم روی دستگاه نصب باشد؛ (۳) در &lt;code&gt;Common.css&lt;/code&gt; یا ابزارکی قاعدهٔ &lt;code&gt;!important&lt;/code&gt; برای &lt;code&gt;td&lt;/code&gt; یا &lt;code&gt;.nastaliq&lt;/code&gt; نباشد؛ (۴) اگر نوشته درشت‌تر از انتظار است، اندازهٔ قلم را در {{الگو|نستعلیق}} تنظیم کنید و قاعده‌های تکراریِ &lt;code&gt;.nastaliq&lt;/code&gt; را از &lt;code&gt;Common.css&lt;/code&gt; بردارید.

== پانویس ==
می‌توان در پایان یک مصراع پانویس (&lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt;) گذاشت. نشانهٔ پانویس از متن مصراع جدا می‌شود و بیرون از لبهٔ پایانی آویزان می‌ماند، پس در عرض و ترازبندی مصراع شمرده نمی‌شود و همهٔ مصراع‌ها هم‌اندازه می‌مانند:
&lt;pre&gt;
{{بیت|مصراع نخست&lt;ref&gt;منبع&lt;/ref&gt;|مصراع دوم}}
&lt;/pre&gt;
فقط پانویسی که در '''پایان''' مصراع باشد این‌گونه جدا می‌شود؛ پانویس میانهٔ مصراع همان‌جا می‌ماند.

== سبک، کلاس، شناسه، زبان و جهت ==
* اگر می‌خواهید برای شعر سبک اضافه‌ای به کار بگیرید از &lt;code&gt;سبک&lt;/code&gt; در {{الگو|شعر}} استفاده کنید:
*:برای رنگ پشت‌زمینهٔ دلخواه &lt;nowiki&gt;{{شعر|سبک=background: blue}}&lt;/nowiki&gt;
*:رنگ دلخواه برای متن &lt;nowiki&gt;{{شعر|سبک=color: white}}&lt;/nowiki&gt;
*:برای قرار نگرفتن در وسط &lt;nowiki&gt;{{شعر|سبک=margin: 0}}&lt;/nowiki&gt;
نمونه‌ای از ترکیب هر سه:{{سخ}}
&lt;pre&gt;
{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;

{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}

* در {{الگو|بیت}}، {{الگو|مصراع}} و… پارامتر &lt;code&gt;سبک&lt;/code&gt; روی خودِ مصراع‌ها اثر می‌گذارد (مثلاً برجسته‌کردن یک بیت: &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|سبک=font-weight:bold}}&lt;/nowiki&gt;&lt;/code&gt;). در {{الگو|شعر}} روی قاب بیرونی شعر می‌نشیند (پس &lt;code&gt;margin: 0&lt;/code&gt; شعر را به راست می‌برد).
* &lt;code&gt;کلاس&lt;/code&gt; یک کلاس CSS به شعر (در {{الگو|شعر}}) یا به همان ردیف (در بقیه) می‌افزاید؛ &lt;code&gt;شناسه&lt;/code&gt; به ردیف یک &lt;code&gt;id&lt;/code&gt; می‌دهد تا بتوان به آن بیت پیوند داد (مثلاً &lt;code&gt;[[#ب۱۲]]&lt;/code&gt; برای &lt;code&gt;شناسه=ب۱۲&lt;/code&gt;).
* &lt;code&gt;زبان&lt;/code&gt; (مثل &lt;code&gt;ar&lt;/code&gt;) در {{الگو|شعر}} برای ابیات عربی، انگلیسی و… است؛ &lt;code&gt;جهت&lt;/code&gt; (&lt;code&gt;rtl&lt;/code&gt; یا &lt;code&gt;ltr&lt;/code&gt;) در صورت ندادن، از زبان حدس زده می‌شود.
&lt;pre&gt;
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}

== حالت «متن» ==
به‌جای نوشتن یک‌به‌یک {{الگو|بیت}}ها می‌توانید مصراع‌ها را خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; بنویسید. در این حالت نیازی به {{الگو|پایان شعر}} نیست و همهٔ گزینه‌های {{الگو|شعر}} (عرض، ترازبندی، نستعلیق، شماره‌گذاری، …) به کار می‌آید.
&lt;pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
&lt;/pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
* هر دو خط پیاپی یک بیت می‌شوند. '''خط خالی = پایان بند''' (یک فاصله؛ اندازه‌اش با &lt;code&gt;فاصله=0.5em&lt;/code&gt; تنظیم می‌شود، و نمادش با &lt;code&gt;جداکننده بند&lt;/code&gt; یا &lt;code&gt;@نماد&lt;/code&gt;؛ بخش «بندها»). چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند. اگر شمار خط‌های یک بند فرد باشد، خط آخر تنها و وسط‌چین می‌آید.
* &lt;code&gt;نوع&lt;/code&gt;: &lt;code&gt;بیت&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;بیت۱&lt;/code&gt; (پلکانی)، &lt;code&gt;بیت نردبانی&lt;/code&gt;، یا &lt;code&gt;مصراع&lt;/code&gt; (هر خط یک مصراع جداگانه؛ شعر نو). برای پلکانی و نردبانی &lt;code&gt;تورفتگی&lt;/code&gt; را هم می‌توان داد، و &lt;code&gt;ترازبندی&lt;/code&gt; و &lt;code&gt;عرض&lt;/code&gt; برای همهٔ ردیف‌ها.
* با &lt;code&gt;نوع=مصراع&lt;/code&gt; هر &lt;code&gt;:&lt;/code&gt; ابتدای خط یک پله تورفتگی (&lt;code&gt;واحد تورفتگی&lt;/code&gt;، پیش‌فرض &lt;code&gt;1.5em&lt;/code&gt;) می‌دهد و ترازِ پیش‌فرض راست است؛ &lt;code&gt;تراز&lt;/code&gt; را می‌توانید عوض کنید.
* در &lt;code&gt;متن&lt;/code&gt; فقط متن ساده بنویسید (پیوند و پانویس مشکلی ندارند)؛ الگوهای {{الگو|بیت}} و {{الگو|مصراع}} را داخل آن نگذارید. علامت &lt;code&gt;=&lt;/code&gt; در متن مشکلی ندارد، ولی &lt;code&gt;|&lt;/code&gt; را با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید. این حالت ساختار الگو را کامل و بسته نگه می‌دارد و برای ویرایش دیداری هم مناسب‌تر است.

=== شعر نو در حالت «متن» ===
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;pre&gt;
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;/pre&gt;

=== عوض‌کردن نوع ردیف در میانهٔ متن (خط‌های &lt;code&gt;@&lt;/code&gt;) ===
نوع پیش‌فرض را &lt;code&gt;نوع=&lt;/code&gt; مشخص می‌کند. اگر می‌خواهید در میانهٔ همان متن چند بیت نردبانی یا پلکانی یا یک مصراع تنها بیاید، یک '''خط جداگانه''' بنویسید که با &lt;code&gt;@&lt;/code&gt; آغاز شود؛ از آن خط به بعد نوعِ جدید برقرار است تا خط &lt;code&gt;@&lt;/code&gt; بعدی:
{| class=&quot;wikitable&quot;
! خط !! نوع ردیف‌های بعدی
|-
| &lt;code&gt;@بیت&lt;/code&gt; || بیت دومصراعی (دو ستون)
|-
| &lt;code&gt;@بیت۱&lt;/code&gt; (یا &lt;code&gt;@پلکانی&lt;/code&gt;، &lt;code&gt;@ضربدری&lt;/code&gt;) || بیت پلکانی
|-
| &lt;code&gt;@بیت نردبانی&lt;/code&gt; (یا &lt;code&gt;@نردبانی&lt;/code&gt;) || بیت نردبانی
|-
| &lt;code&gt;@مصراع&lt;/code&gt; (یا &lt;code&gt;@نو&lt;/code&gt;، &lt;code&gt;@نیمایی&lt;/code&gt;، &lt;code&gt;@آزاد&lt;/code&gt;) || هر خط یک مصراع جدا
|}
گزینه‌ها را می‌توان پس از نوع نوشت: &lt;code&gt;تورفتگی=&lt;/code&gt;، &lt;code&gt;تراز=&lt;/code&gt; (برای مصراع) و &lt;code&gt;ترازبندی=&lt;/code&gt;؛ مثلاً &lt;code&gt;@بیت۱ تورفتگی=10%&lt;/code&gt; یا &lt;code&gt;@مصراع تراز=وسط&lt;/code&gt;. (مقدارِ هر گزینه نباید فاصله داشته باشد.)
&lt;pre&gt;
{{شعر|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
&lt;/pre&gt;
{{شعر|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
* هر خط &lt;code&gt;@&lt;/code&gt; گزینه‌های پیشین را کنار می‌گذارد و به پیش‌فرض‌های {{الگو|شعر}} برمی‌گردد (گزینه‌ها جمع نمی‌شوند)؛ پس &lt;code&gt;@بیت۱&lt;/code&gt; بدون گزینه، تورفتگی پیش‌فرض خودِ شعر را دارد.
* خط &lt;code&gt;@&lt;/code&gt; جفت‌شدنِ خط‌ها را قطع می‌کند: اگر پیش از آن خطی تنها مانده باشد، همان‌جا به‌صورت مصراع تنها (وسط‌چین) درمی‌آید. فاصلهٔ بند نمی‌گذارد (برای آن خط خالی بگذارید).
* در شعرِ &lt;code&gt;نوع=بیت&lt;/code&gt;، مصراع‌هایی که با &lt;code&gt;@مصراع&lt;/code&gt; می‌آیند شماره‌گذاری خودکار را نمی‌شمارند؛ در شعرِ &lt;code&gt;نوع=مصراع&lt;/code&gt; همهٔ خط‌ها (و بیت‌های &lt;code&gt;@بیت&lt;/code&gt;) شمرده می‌شوند.
* &lt;code&gt;@مصراع&lt;/code&gt; مانند &lt;code&gt;نوع=مصراع&lt;/code&gt; به‌طور پیش‌فرض راست‌چین است؛ برای وسط‌چین &lt;code&gt;تراز=وسط&lt;/code&gt; بدهید.
* خط &lt;code&gt;@&lt;/code&gt; می‌تواند خط نخست متن باشد. فاصلهٔ پس از &lt;code&gt;@&lt;/code&gt; مهم نیست. نوع یا گزینهٔ ناشناخته نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* دو خطِ ویژهٔ &lt;code&gt;@نماد&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; نوع ردیف را عوض نمی‌کنند؛ آن‌ها بریدگیِ میان بندها را می‌سازند (بخش «نماد و فاصله در حالت «متن»»).
* خط &lt;code&gt;@&lt;/code&gt; با شعر چندصفحه‌ای هم کار می‌کند (ادغام ردیف ناتمام به نوعِ ردیف آخر/نخست وابسته است).

=== نشانه‌های درون‌خطی در حالت متن ===
(برگرفته از الگوی ppoem)
{| class=&quot;wikitable&quot;
! نشانه !! کاربرد
|-
| &lt;code&gt;&amp;gt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، راست‌چین
|-
| &lt;code&gt;&amp;lt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، وسط‌چین
|-
| &lt;code&gt;۱۲ &amp;lt;&amp;lt;&amp;lt; متن&lt;/code&gt; || شمارهٔ سمت راست (مانند &lt;code&gt;ش=۱۲&lt;/code&gt;)
|-
| &lt;code&gt;متن &amp;gt;&amp;gt;&amp;gt; ۱۲&lt;/code&gt; || شمارهٔ سمت چپ (مانند &lt;code&gt;شچ=۱۲&lt;/code&gt;)
|}
نشانه‌های شماره روی هر یک از دو خطِ یک بیت هم کار می‌کنند، و نشانه‌های تراز روی خطِ تنها و مصراع‌های شعر نو:
&lt;pre&gt;
{{شعر|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}
&lt;/pre&gt;
{{شعر|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}

== شعر چندصفحه‌ای (ویژهٔ ویکی‌نبشته) ==
وقتی شعر در چند «صفحه:» ادامه دارد، دو خواسته داریم: در پیش‌نمایش هر صفحه شعر کامل و بسته دیده شود، و در صفحهٔ اصلی (که صفحه‌ها با &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; درج می‌شوند) همهٔ صفحه‌ها یک جدول واحد باشند تا ستون‌ها در مرز صفحه جابه‌جا نشوند. پارامتر &lt;code&gt;ادامه&lt;/code&gt; هر دو را برآورده می‌کند:

{| class=&quot;wikitable&quot;
! صفحه !! بالای صفحه !! پایین صفحه
|-
| نخست || &lt;code&gt;&lt;nowiki&gt;{{شعر}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| میانی || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| آخر || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;
|}
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
* در فضای نام «صفحه» &lt;code&gt;ادامه&lt;/code&gt; نادیده گرفته می‌شود و هر صفحه کامل و بسته نمایش داده می‌شود.
* در صفحهٔ اصلی، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; جدول تازه باز نمی‌کند و &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; نمی‌بندد؛ پس صفحه‌ها به هم دوخته می‌شوند. اگر درج از میانهٔ شعر آغاز شود، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; خودش جدول را باز می‌کند.
* '''هم‌ترازی در مرز صفحه:''' چون عرض جدول ثابت است (بخش «چیدمان»)، حتی اگر صفحه‌ای بدون &lt;code&gt;ادامه&lt;/code&gt; باشد و جدول جدا بسازد، قاب شعر با صفحهٔ قبل هم‌اندازه و هم‌تراز می‌ماند؛ گزینه‌های &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بنویسید.
* گزینه‌های {{الگو|شعر}} (نستعلیق، عرض، سبک، شماره‌گذاری، جداکننده بند و…) را در هر صفحه تکرار کنید تا پیش‌نمایش درست باشد؛ در صفحهٔ اصلی فقط گزینه‌های صفحهٔ نخست اثر دارد و شماره‌گذاری خودکار از صفحهٔ قبل ادامه می‌یابد.
* اگر فقط بخشی از صفحه‌ها را درج می‌کنید و شعر در آخرین صفحهٔ درج‌شده تمام نمی‌شود، بعد از &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; بنویسید &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;.
* این الگوها در صفحهٔ اصلی بدون پارامتر &lt;code&gt;ادامه&lt;/code&gt; همان‌طور که بود کار می‌کنند.

=== مصراع (یا بیت) ناتمام در پایان صفحه ===
گاهی مصراعی در پایان صفحه ناتمام می‌ماند و در صفحهٔ بعد ادامه دارد (یا مصراع دوم یک بیت به صفحهٔ بعد می‌رود). در ردیفِ آخرِ صفحه &lt;code&gt;ناتمام=بله&lt;/code&gt; و در نخستین ردیفِ صفحهٔ بعد &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید؛ در صفحهٔ اصلی این دو ردیف مصراع‌به‌مصراع یکی می‌شوند:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه در صفحهٔ اصلی (دو نیمه پشت سر هم نوشته شده‌اند و یک شعر می‌سازند):
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}

* '''بیتی که میان دو مصراع بریده شده:''' در صفحهٔ اول فقط مصراع نخست را بنویسید و در صفحهٔ بعد مصراع اول را تهی بگذارید:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت||واندر آن ظلمت شب آب حیاتم دادند|دنباله=بله}}
{{پایان شعر}}
&lt;/pre&gt;
* '''اتصال:''' دو تکه به‌طور پیش‌فرض با فاصله به هم می‌چسبند. برای واژهٔ بریده &lt;code&gt;اتصال=چسبیده&lt;/code&gt; و برای «می‌/رود» &lt;code&gt;اتصال=نیم‌فاصله&lt;/code&gt; را در ردیفِ &lt;code&gt;دنباله&lt;/code&gt; بدهید.
* ردیف‌های {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}} و {{الگو|مصراع}} هر کدام جداگانه ادغام می‌شوند؛ دو تکه باید از یک نوع الگو باشند.
* هر ردیف در شماره‌گذاری خودکار یک بار شمرده می‌شود و شماره‌ها را می‌توان در هر دو تکه داد (تکهٔ بعدی مقدم است).
* در فضای نام «صفحه» ردیفِ ناتمام با خط‌چین نشان داده می‌شود. ردیفی که ادامه‌اش هرگز نیاید همان‌طور که هست نمایش داده می‌شود و متنی گم نمی‌شود.
* ادغام به این تکیه دارد که الگوها در یک رندر به ترتیب اجرا شوند. اگر روزی در جایی متنِ ردیف ناتمام گم شد، مدیر پودمان می‌تواند &lt;code&gt;cfg.mergeRows = false&lt;/code&gt; کند: آن‌گاه هر تکه فوراً و به‌صورت ردیفِ جدا نمایش داده می‌شود.

=== شعر چندصفحه‌ای در حالت «متن» ===
در حالت &lt;code&gt;متن&lt;/code&gt; هر صفحه یک فراخوانی است: &lt;code&gt;ادامه=بعد&lt;/code&gt; (صفحهٔ نخست)، &lt;code&gt;ادامه=هر دو&lt;/code&gt; (میانی)، &lt;code&gt;ادامه=قبل&lt;/code&gt; (آخر)؛ و برای مصراع ناتمام &lt;code&gt;ناتمام=بله&lt;/code&gt; / &lt;code&gt;دنباله=بله&lt;/code&gt; (با &lt;code&gt;اتصال&lt;/code&gt;). در حالت متن «ادامه=بله» مبهم است و پذیرفته نمی‌شود.
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر|ادامه=بعد|ناتمام=بله|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
بیخود از شعشعهٔ پرتو
باده از جام تجلی
}}
──── صفحهٔ ۲ ────
{{شعر|ادامه=قبل|دنباله=بله|متن=
ذاتم کردند
صفاتم دادند
}}
&lt;/pre&gt;
* اگر آخرین خطِ ناتمامِ صفحه فرد باشد، بیتی با مصراع نخست می‌شود و خط اول صفحهٔ بعد به‌طور خودکار مصراع دومِ همان بیت است؛ با &lt;code&gt;دنباله=اول&lt;/code&gt; یا &lt;code&gt;دنباله=دوم&lt;/code&gt; می‌توانید صریح بگویید کدام مصراع ادامه دارد.
* &lt;code&gt;بند=جدید&lt;/code&gt; در صفحهٔ ادامه، پیش از نخستین ردیف یک فاصلهٔ بند (یا ردیفِ نماد، اگر شعر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) می‌گذارد.

== نمایش در صفحه‌های باریک ==
مصراع‌های کنار هم در پنجرهٔ باریک جا نمی‌شوند؛ پس پیش‌فرض، شعر در پنجرهٔ باریک (تا حدود ۸۳۲ پیکسل) '''ستونی''' می‌شود: برای هر بیت شماره بالا، دو مصراع وسط‌چین زیر هم، و یک خط‌چین پس از آن (در بیت پلکانی پس از خط دوم). نمادِ میان دو مصراع و نسخهٔ نامرئیِ اندازه‌گیر پنهان می‌شوند؛ ردیفِ نمادِ میان بندها همچنان دیده می‌شود. در پنجره‌های کمی عریض‌تر، فاصلهٔ واژه‌ها در شعر دوطرفه اندکی کم می‌شود تا مصراع‌ها هنوز در یک خط جا شوند.
{| class=&quot;wikitable&quot;
! &lt;code&gt;تلفن=&lt;/code&gt; !! رفتار
|-
| &lt;code&gt;ستونی&lt;/code&gt; (پیش‌فرض) || در پنجرهٔ باریک ستونی؛ در پنجرهٔ عریض دوستونه.
|-
| &lt;code&gt;دوستونه&lt;/code&gt; || همیشه دوستونه؛ در پنجرهٔ بسیار باریک (تا ۴۸۰ پیکسل) فاصله‌ها کمتر می‌شود تا جا برای متن بماند.
|-
| &lt;code&gt;همیشه&lt;/code&gt; || همیشه ستونی، حتی در پنجرهٔ عریض.
|}

=== فضای نام «صفحه» ===
در «صفحه:» تصویر کنار متن است و ستونِ متن حدود نیمی از پنجره است؛ پس شعر زودتر باید ستونی شود. اما مرورگر پهنای واقعیِ ستونِ متن را به شیوه‌نامه نمی‌دهد (TemplateStyles از ''container query'' پشتیبانی نمی‌کند) و فقط پهنای پنجره در دسترس است. برای این‌که هر شعر نه زودتر از لازم ستونی شود و نه دیرتر، پودمان '''طولِ بلندترین مصراع''' را می‌سنجد و یکی از سه کلاس را روی شعر می‌گذارد؛ هر سطح آستانهٔ خودش را دارد:
{| class=&quot;wikitable&quot;
! سطح (کلاس) !! بلندترین مصراع !! فشرده‌شدن (فاصله‌ها کم می‌شود) !! ستونی‌شدن
|-
| کوتاه (&lt;code&gt;poem-w1&lt;/code&gt;) || تا ۲۰ نویسه || پنجرهٔ ≤ ۸۶em (۱۳۷۶px) || پنجرهٔ ≤ ۷۶em (۱۲۱۶px)
|-
| متوسط (&lt;code&gt;poem-w2&lt;/code&gt;) || تا ۳۰ نویسه || پنجرهٔ ≤ ۱۰۶em (۱۶۹۶px) || پنجرهٔ ≤ ۹۶em (۱۵۳۶px)
|-
| بلند (&lt;code&gt;poem-w3&lt;/code&gt;) || بیشتر از ۳۰ نویسه || پنجرهٔ ≤ ۱۲۶em (۲۰۱۶px) || پنجرهٔ ≤ ۱۱۶em (۱۸۵۶px)
|}
* '''فشرده‌شدن:''' پیش از ستونی‌شدن، فاصلهٔ دو مصراع از ≈ ۵٫۹em به ≈ ۳٫۴em می‌رسد (هنوز فاصلهٔ معقول) و ستون‌های شماره باریک می‌شوند؛ مصراع‌ها دست‌نخورده می‌مانند. بالاتر از آستانهٔ فشرده‌شدن، شعر با فاصله‌های عادی و دوستونه نمایش داده می‌شود.
* در حالت &lt;code&gt;متن&lt;/code&gt; سطح به‌طور خودکار از روی طول مصراع‌ها تعیین می‌شود. در حالت الگو (مصراع‌ها بعداً می‌رسند) پیش‌فرض «متوسط» است؛ برای شعرِ کوتاه‌مصراع بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=کوتاه}}&lt;/nowiki&gt;&lt;/code&gt; و برای شعرِ بلندمصراع &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=بلند}}&lt;/nowiki&gt;&lt;/code&gt; (یا شمار نویسهٔ بلندترین مصراع، مثلاً &lt;code&gt;طول مصراع=24&lt;/code&gt;).
* '''پایهٔ حساب:''' هر نویسه ≈ ۰٫۵em؛ جدولِ فشرده ≈ (نویسه + ۸٫۴)em و جدولِ عادی ≈ (نویسه + ۱۳٫۹)em پهنا می‌خواهد؛ ستونِ متن ≈ نیمی از پنجره منهای ۹em فرض شده (em در media query همیشه ۱۶px است). اگر قلمِ صفحه درشت‌تر است، عددها را در [[الگو:شعر/styles.css]] بالا ببرید.
* اگر پنجرهٔ «صفحه:»ی شما عمودی است (تصویر بالای متن) و ستونِ متن پهن است، برای آن شعر &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید تا هرگز ستونی نشود.
* پس از به‌روزرسانی پودمان، صفحه‌های «صفحه:»ی قدیمی با یک ویرایش تهی (null edit) یا پاک‌سازی (purge) کلاس سطح را می‌گیرند؛ تا آن زمان به‌عنوان «متوسط» رفتار می‌کنند.

== رده‌های پیگیری و خطاها ==
فقط در صفحه‌های اصلی و فضای نام «صفحه» (نه در الگو و پودمان):
* [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] — پارامتر یا مقدار نادرست (عرض، ترازبندی، نماد، خط &lt;code&gt;@&lt;/code&gt; ناشناخته، …)، مصراع اضافه، «=» در مصراع، یا ادامهٔ ناسازگار.
* [[:رده:صفحه‌های دارای بیت ناقص]] — بیتی که فقط یک مصراع دارد (به‌جز ردیف‌های ناتمام/دنباله).
* [[:رده:صفحه‌های دارای خطا در پودمان شعر]] — خطای پیش‌بینی‌نشده (به‌جای شکستن صفحه، پیام قرمز نشان داده می‌شود).

== پرسش‌های رایج ==
{| class=&quot;wikitable&quot;
! مشکل !! راه‌حل
|-
| آغاز شعر در مرز دو صفحه جابه‌جا می‌شود || &lt;code&gt;عرض&lt;/code&gt;/&lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بگذارید (یا ندهید: پیش‌فرض ثابت است) و صفحه‌ها را با &lt;code&gt;ادامه&lt;/code&gt; بدوزید.
|-
| در «صفحه:» شعر زیر هم (ستونی) نمایش داده می‌شود || بخش «فضای نام «صفحه»»: آستانه به طول مصراع بستگی دارد؛ برای شعرِ کوتاه‌مصراع &lt;code&gt;طول مصراع=کوتاه&lt;/code&gt;، و برای هرگز-ستونی‌نشدن &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید.
|-
| مصراع‌ها بیش از اندازه می‌شکنند || &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید؛ یا &lt;code&gt;عرض=خودکار&lt;/code&gt;.
|-
| نماد میان بندها نمی‌آید || در حالت الگو، الگوی {{الگو|جداکننده بند}} باید ساخته شده باشد (متنش &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|divider}}&lt;/nowiki&gt;&lt;/code&gt;) یا از &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=• • •}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید. در حالت «متن» خط &lt;code&gt;@نماد&lt;/code&gt; باید خطی جدا باشد و &lt;code&gt;جداکننده بند&lt;/code&gt; فقط جای خط‌های خالی را می‌گیرد.
|-
| چند خط خالی فاصلهٔ بزرگ‌تر نمی‌دهد || چند خط خالیِ پشت‌سرهم عمداً یک فاصله‌اند؛ برای فاصلهٔ بزرگ‌تر &lt;code&gt;@فاصله&lt;/code&gt; (یا &lt;code&gt;@فاصله 3em&lt;/code&gt;) بنویسید.
|-
| نستعلیق اعمال نمی‌شود || بخش «نستعلیق»، فهرست بررسی (۱) تا (۴).
|-
| &lt;code&gt;قلم=&lt;/code&gt; کار نمی‌کند || چنین پارامتری وجود ندارد (صفحه به ردهٔ پارامتر ناشناخته می‌رود). قلم را {{الگو|نستعلیق}} تعیین می‌کند، یا &lt;code&gt;سبک=font-family: …&lt;/code&gt; بدهید.
|-
| می‌خواهم یک بیتِ پلکانی وسط شعرِ دومصراعی بیاورم || در حالت متن خط &lt;code&gt;@بیت۱&lt;/code&gt; و بعد &lt;code&gt;@بیت&lt;/code&gt;؛ یا در حالت الگو، {{الگو|بیت۱}}.
|-
| شماره‌گذاری در صفحهٔ دوم از نو شروع می‌شود || در «صفحه:» طبیعی است (از &lt;code&gt;شروع&lt;/code&gt; می‌گیرد)؛ در صفحهٔ اصلی با &lt;code&gt;ادامه&lt;/code&gt; ادامه می‌یابد.
|-
| متن ردیف ناتمام نمایش داده نمی‌شود || صفحهٔ بعد را با &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید و درج کنید؛ یا {{الگو|پایان شعر}} بگذارید. اگر باز هم نشد: &lt;code&gt;cfg.mergeRows = false&lt;/code&gt;.
|-
| صفحه به ردهٔ «پارامتر ناشناخته» رفت || نام پارامتر یا مقدارش را بررسی کنید؛ «=» یا «|» در مصراع (از &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید)؛ مصراع سوم؛ یا نمادی که &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; دارد.
|-
| پیام قرمز «خطا در پودمان شعر» || پارامترها را بررسی کنید و خطا را در [[بحث پودمان:شعر]] گزارش کنید؛ صفحه نمی‌شکند.
|}

== نکات فنی ==
=== ساختار خروجی ===
هر شعر یک &lt;code&gt;div&lt;/code&gt; با یک جدول است؛ هر سطرِ جدول ۷ ستونی است (شماره | مصراع ۱ (۲ ستون) | شمارهٔ میانی | مصراع ۲ (۲ ستون) | شماره). در چیدمان ثابت یک ردیف نامرئی &lt;code&gt;.poem-sizer&lt;/code&gt; ستون‌ها را تعیین می‌کند؛ با &lt;code&gt;عرض=خودکار&lt;/code&gt; جدول بدون آن و بدون &lt;code&gt;.poem-fixed&lt;/code&gt; ساخته می‌شود.
&lt;pre&gt;
&lt;div class=&quot;poem poem-fixed poem-stack&quot; style=&quot;width:100%;max-width:50em;margin:0 auto&quot;&gt;
 &lt;table class=&quot;poem-table&quot; role=&quot;presentation&quot; style=&quot;width:100%;table-layout:fixed&quot;&gt;
  &lt;tr class=&quot;poem-sizer&quot;&gt; … ۷ سلول … &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-bayt&quot;&gt;
   &lt;td class=&quot;poem-num poem-num-r&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m1 poem-a-end&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۱&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-c&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m2 poem-a-start&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۲&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-l&quot;&gt;&lt;/td&gt;
  &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-ornament&quot;&gt;&lt;td class=&quot;poem-ornament-cell&quot; colspan=&quot;7&quot;&gt;• • •&lt;/td&gt;&lt;/tr&gt;
 &lt;/table&gt;
&lt;/div&gt;
&lt;/pre&gt;

=== کلاس‌های CSS ===
{| class=&quot;wikitable&quot;
! کلاس !! روی چه !! کار
|-
| &lt;code&gt;poem&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; بیرونی || قاب شعر
|-
| &lt;code&gt;poem-fixed&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || چیدمان ثابت (جدول با ردیف اندازه‌گیر)
|-
| &lt;code&gt;poem-stack&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || امکان ستونی‌شدن در صفحهٔ باریک (نبود آن = &lt;code&gt;تلفن=دوستونه&lt;/code&gt;)
|-
| &lt;code&gt;poem-stack-always&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || همیشه ستونی (&lt;code&gt;تلفن=همیشه&lt;/code&gt;)
|-
| &lt;code&gt;poem-just&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || ترازبندی پهن در کل شعر
|-
| &lt;code&gt;poem-page&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || شعر در فضای نام «صفحه»
|-
| &lt;code&gt;poem-w1&lt;/code&gt;، &lt;code&gt;poem-w2&lt;/code&gt;، &lt;code&gt;poem-w3&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; (فقط فضای نام «صفحه») || طول مصراع: کوتاه، متوسط، بلند
|-
| &lt;code&gt;poem-table&lt;/code&gt;، &lt;code&gt;nastaliq&lt;/code&gt; || &lt;code&gt;table&lt;/code&gt; || جدول؛ کلاس نستعلیق
|-
| &lt;code&gt;poem-sizer&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئیِ تعیین‌کنندهٔ ستون‌ها (فقط چیدمان ثابت)
|-
| &lt;code&gt;poem-row&lt;/code&gt; + &lt;code&gt;poem-bayt&lt;/code&gt; / &lt;code&gt;poem-stagger&lt;/code&gt; (و &lt;code&gt;-1&lt;/code&gt;، &lt;code&gt;-2&lt;/code&gt;) / &lt;code&gt;poem-mesra&lt;/code&gt; / &lt;code&gt;poem-gap&lt;/code&gt; / &lt;code&gt;poem-ornament&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || نوع ردیف
|-
| &lt;code&gt;poem-skip&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئی که جای «ادامه» می‌نشیند (تا خط خالی و &lt;code&gt;&amp;lt;p&amp;gt;&lt;/code&gt; پدید نیاید)
|-
| &lt;code&gt;poem-partial-end&lt;/code&gt;، &lt;code&gt;poem-partial-start&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیفِ ناتمام/دنباله در پیش‌نمایش «صفحه:» (خط‌چین)
|-
| &lt;code&gt;poem-num&lt;/code&gt; (و &lt;code&gt;-r&lt;/code&gt;، &lt;code&gt;-c&lt;/code&gt;، &lt;code&gt;-l&lt;/code&gt;) || &lt;code&gt;td&lt;/code&gt; || ستون‌های شماره
|-
| &lt;code&gt;b&lt;/code&gt;، &lt;code&gt;poem-m&lt;/code&gt;، &lt;code&gt;poem-m1&lt;/code&gt;، &lt;code&gt;poem-m2&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول مصراع (&lt;code&gt;b&lt;/code&gt; و &lt;code&gt;beyt&lt;/code&gt; برای سازگاری با شیوه‌های قدیمی حفظ شده‌اند)
|-
| &lt;code&gt;poem-a-start&lt;/code&gt;، &lt;code&gt;poem-a-end&lt;/code&gt;، &lt;code&gt;poem-a-right&lt;/code&gt;، &lt;code&gt;poem-a-left&lt;/code&gt;، &lt;code&gt;poem-a-justify&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || ترازبندی مصراع
|-
| &lt;code&gt;poem-m-right&lt;/code&gt;، &lt;code&gt;poem-m-left&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || مصراع تنها با تراز راست/چپ
|-
| &lt;code&gt;beyt&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || متن مصراع
|-
| &lt;code&gt;poem-ref&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || پانویسِ آویزان در پایان مصراع
|-
| &lt;code&gt;poem-sz&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نسخهٔ نامرئیِ اندازه‌گیر (ترازبندی پهن)
|-
| &lt;code&gt;poem-sep&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نمادِ میان دو مصراع
|-
| &lt;code&gt;poem-ornament-cell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیفِ نمادِ میان بندها
|-
| &lt;code&gt;poem-gapcell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیف فاصله
|-
| &lt;code&gt;poem-st&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || جعبهٔ هر خط در بیت پلکانیِ تورفتگی‌دار (چیدمان ثابت)
|-
| &lt;code&gt;poem-indent&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول فاصله‌گذار در بیت پلکانیِ تورفتگی‌دار (چیدمان خودکار)
|-
| &lt;code&gt;poem-s&lt;/code&gt;، &lt;code&gt;poem-g&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; در &lt;code&gt;.poem-sizer&lt;/code&gt; || ستون کناری و ستون میانی
|}

=== شیوه‌نامه ===
اندازه‌ها در [[الگو:شعر/styles.css]] تعریف شده‌اند (نشانی شیوه‌نامه را مدیر پودمان با &lt;code&gt;cfg.styles&lt;/code&gt; تعیین می‌کند):
{| class=&quot;wikitable&quot;
! انتخابگر !! مقدار !! کار
|-
| &lt;code&gt;.poem-g&lt;/code&gt; || &lt;code&gt;4.7em&lt;/code&gt; || ستون میانیِ چیدمان ثابت
|-
| &lt;code&gt;.poem-s&lt;/code&gt; || &lt;code&gt;3.4em&lt;/code&gt; || ستون‌های کناریِ چیدمان ثابت
|-
| &lt;code&gt;.poem-m&lt;/code&gt; || &lt;code&gt;0.6em&lt;/code&gt; || حاشیهٔ درونیِ هر مصراع (چپ و راست)
|-
| &lt;code&gt;.poem-num-c&lt;/code&gt; || &lt;code&gt;5.5em&lt;/code&gt; || ستون میانی در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num-r&lt;/code&gt;، &lt;code&gt;.poem-num-l&lt;/code&gt; || &lt;code&gt;4em&lt;/code&gt; || ستون‌های کناری در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num&lt;/code&gt; || &lt;code&gt;85%&lt;/code&gt; || اندازهٔ شماره‌ها
|-
| &lt;code&gt;.poem-sep&lt;/code&gt; || &lt;code&gt;#b3362b&lt;/code&gt;، &lt;code&gt;90%&lt;/code&gt; || رنگ و اندازهٔ نمادِ میان دو مصراع
|-
| &lt;code&gt;.poem-ornament-cell&lt;/code&gt; || پررنگ || ردیفِ نمادِ میان بندها
|}
فاصلهٔ دو مصراع در حالت عادی ≈ ۴٫۷em + ۲×۰٫۶em ≈ ۵٫۹em است. آستانه‌های ستونی‌شدن (۵۲em برای صفحهٔ اصلی، و جدول بخش «فضای نام «صفحه»») و اندازه‌های حالت فشرده نیز همان‌جا و با توضیح آمده‌اند.

=== تنظیمات پودمان (&lt;code&gt;cfg&lt;/code&gt;) ===
مدیران پودمان می‌توانند پیش‌فرض‌ها را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند:
{| class=&quot;wikitable&quot;
! کلید !! پیش‌فرض !! کار
|-
| &lt;code&gt;styles&lt;/code&gt; || &lt;code&gt;Template:شعر۲/styles.css&lt;/code&gt; || صفحهٔ TemplateStyles
|-
| &lt;code&gt;pageNs&lt;/code&gt; || &lt;code&gt;104&lt;/code&gt; || شمارهٔ فضای نام «صفحه»
|-
| &lt;code&gt;mesraUnit&lt;/code&gt; || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر &lt;code&gt;:&lt;/code&gt; در شعر نو
|-
| &lt;code&gt;defaultWidth&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; || عرض پیش‌فرض؛ &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند
|-
| &lt;code&gt;maxWidth&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض (وقتی عرض داده نشده)
|-
| &lt;code&gt;justDefault&lt;/code&gt; || &lt;code&gt;{ bayt = 'inner', stagger = 'edge' }&lt;/code&gt; || ترازبندی پیش‌فرض هر نوع بیت
|-
| &lt;code&gt;justifyMinRatio&lt;/code&gt; || &lt;code&gt;0.7&lt;/code&gt; || در ترازبندی پهن، کمترین نسبتِ کوتاه‌ترین به بلندترین مصراعِ بیت برای کشیده‌شدن
|-
| &lt;code&gt;nastaliqTemplate&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; || الگوی ویکی که نمای نستعلیق از آن گرفته می‌شود
|-
| &lt;code&gt;nastaliqFonts&lt;/code&gt; || فهرست قلم‌های نستعلیق || آخرین چاره، فقط اگر آن الگو در دسترس نبود
|-
| &lt;code&gt;separator&lt;/code&gt; || &lt;code&gt;''&lt;/code&gt; (بدون نماد) || نمادِ میان دو مصراعِ همهٔ شعرها
|-
| &lt;code&gt;ornament&lt;/code&gt; || &lt;code&gt;❖&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده=بله&lt;/code&gt;
|-
| &lt;code&gt;stanzaOrnament&lt;/code&gt; || &lt;code&gt;• • •&lt;/code&gt; || نمادِ پیش‌فرضِ &lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt; و {{الگو|جداکننده بند}}
|-
| &lt;code&gt;hemiShort&lt;/code&gt;، &lt;code&gt;hemiMedium&lt;/code&gt; || &lt;code&gt;20&lt;/code&gt;، &lt;code&gt;30&lt;/code&gt; || مرزِ طول مصراع (نویسه) برای سطح‌های «کوتاه» و «متوسط» در فضای نام «صفحه»
|-
| &lt;code&gt;mergeRows&lt;/code&gt; || &lt;code&gt;true&lt;/code&gt; || ادغام ردیف ناتمام با دنباله‌اش
|-
| &lt;code&gt;cats&lt;/code&gt; || — || نام رده‌های پیگیری
|}
فهرست &lt;code&gt;nastaliqFonts&lt;/code&gt; باید با فهرست قلم در {{الگو|نستعلیق}} سازگار باشد.

=== ساخت الگوها ===
متن هر الگو یک فراخوانی پودمان است، مثلاً برای الگوی تازهٔ {{الگو|جداکننده بند}}:
&lt;pre&gt;
&lt;includeonly&gt;{{#invoke:شعر|divider}}&lt;/includeonly&gt;&lt;noinclude&gt;{{توضیحات}}&lt;/noinclude&gt;
&lt;/pre&gt;
نقطه‌های ورود: &lt;code&gt;open&lt;/code&gt;، &lt;code&gt;close&lt;/code&gt;، &lt;code&gt;bayt&lt;/code&gt;، &lt;code&gt;stagger&lt;/code&gt;، &lt;code&gt;ladder&lt;/code&gt;، &lt;code&gt;mesra&lt;/code&gt;، &lt;code&gt;emptyBayt&lt;/code&gt;، &lt;code&gt;emptyMesra&lt;/code&gt;، &lt;code&gt;divider&lt;/code&gt;.

=== یادداشت‌های فنی ===
* {{الگو|شعر}} و {{الگو|پایان شعر}} باید هر دو از یک نسخه باشند: &lt;code&gt;&amp;lt;div class=&quot;poem&quot;&amp;gt;&amp;lt;table&amp;gt;&lt;/code&gt; را اولی باز و دومی می‌بندد.
* تشخیص فضای نام «صفحه» بر پایهٔ شمارهٔ ۱۰۴ است (&lt;code&gt;cfg.pageNs&lt;/code&gt;).
* رده‌های پیگیری فقط در صفحهٔ اصلی و فضاهای نام محتوایی سفارشی (مثل «صفحه») افزوده می‌شوند.
* دوختن صفحه‌ها، ادغام ردیف ناتمام و شماره‌گذاری خودکار به این تکیه دارند که الگوها در یک رندر به ترتیب اجرا شوند (رندر کلاسیک MediaWiki و &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; چنین‌اند). در رندرهایی که هر الگو جداگانه بسط داده شود (مثلاً برخی خوانش‌های Parsoid) این سه کار نمی‌کنند؛ شعر همچنان درست و هم‌تراز نمایش داده می‌شود چون قاب ثابت است.
* هر خطای پیش‌بینی‌نشده به‌جای شکستن صفحه، پیامی قرمز و ردهٔ خطا می‌دهد.

== الگوهای مرتبط ==
* [[الگو:بیت]] برای نوشتن بیت‌ها
* [[الگو:بیت۱]] برای بیت‌های پلکانی
* [[الگو:بیت نردبانی]] برای بیت‌های نردبانی
* [[الگو:مصراع]] برای نوشتن تک مصراع‌ها
* [[الگو:بیت خالی]] و [[الگو:مصراع خالی]] برای فاصله
* [[الگو:جداکننده بند]] برای نماد میان بندها
* [[الگو:پایان شعر]] برای تمام کردن الگو
* [[الگو:نستعلیق]] برای نوشتن متن‌های دیگر با خط نستعلیق

== داده‌های الگو ==
&lt;templatedata&gt;
{
  &quot;description&quot;: &quot;آغاز شعر (در حالت «متن»: کل شعر). همهٔ گزینه‌هایی که برای کل شعر اثر دارند اینجا داده می‌شوند.&quot;,
  &quot;params&quot;: {
    &quot;1&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام نخست&quot;,
      &quot;description&quot;: &quot;گزینهٔ بی‌نام: «نستعلیق» نمای نستعلیق را روشن می‌کند؛ «ادامه» یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;2&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام دوم&quot;,
      &quot;description&quot;: &quot;مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;عرض&quot;: {
      &quot;label&quot;: &quot;عرض&quot;,
      &quot;description&quot;: &quot;عرض قاب شعر. عدد بدون واحد پیکسل است. «خودکار» یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط «عرض» بدهید سقف عرض ۱۰۰٪ می‌شود.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;width&quot;
      ]
    },
    &quot;حداکثر عرض&quot;: {
      &quot;label&quot;: &quot;حداکثر عرض&quot;,
      &quot;description&quot;: &quot;سقف عرض قاب (وقتی عرض ثابت است). «بدون» (یا «none»، «نامحدود») یعنی بی‌سقف.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;max-width&quot;
      ]
    },
    &quot;تلفن&quot;: {
      &quot;label&quot;: &quot;رفتار در صفحهٔ باریک&quot;,
      &quot;description&quot;: &quot;«ستونی»: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ «دوستونه»: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ «همیشه»: همیشه ستونی.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;phone&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;ستونی&quot;,
        &quot;دوستونه&quot;,
        &quot;همیشه&quot;
      ]
    },
    &quot;ترازبندی&quot;: {
      &quot;label&quot;: &quot;ترازبندی&quot;,
      &quot;description&quot;: &quot;ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). «میانه»: مصراع‌ها به محور میانی می‌چسبند؛ «لبه»: مصراع نخست به راست و دوم به چپ؛ «پهن»: دوطرفه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;justify&quot;,
        &quot;تراز‌بندی&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;میانه&quot;,
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;,
        &quot;پهن&quot;,
        &quot;لبه&quot;
      ]
    },
    &quot;جداکننده&quot;: {
      &quot;label&quot;: &quot;نماد میان دو مصراع&quot;,
      &quot;description&quot;: &quot;نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی «شو» نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;separator&quot;
      ]
    },
    &quot;جداکننده بند&quot;: {
      &quot;label&quot;: &quot;نماد میان بندها&quot;,
      &quot;description&quot;: &quot;ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت «متن» به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط «@نماد» یا الگوی «جداکننده بند» استفاده کنید.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza-separator&quot;,
        &quot;جداکنندهٔ بند&quot;,
        &quot;نماد بند&quot;
      ]
    },
    &quot;متن&quot;: {
      &quot;label&quot;: &quot;متن شعر&quot;,
      &quot;description&quot;: &quot;کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.&quot;,
      &quot;type&quot;: &quot;content&quot;,
      &quot;aliases&quot;: [
        &quot;text&quot;
      ]
    },
    &quot;نوع&quot;: {
      &quot;label&quot;: &quot;نوع ردیف‌ها&quot;,
      &quot;description&quot;: &quot;نوع پیش‌فرض ردیف‌ها در حالت «متن». با «نوع=مصراع» ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;type&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بیت&quot;,
        &quot;بیت۱&quot;,
        &quot;بیت نردبانی&quot;,
        &quot;مصراع&quot;
      ]
    },
    &quot;تراز&quot;: {
      &quot;label&quot;: &quot;تراز مصراع‌های تنها&quot;,
      &quot;description&quot;: &quot;تراز مصراع‌های تنها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;align&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;
      ]
    },
    &quot;تورفتگی&quot;: {
      &quot;label&quot;: &quot;تورفتگی&quot;,
      &quot;description&quot;: &quot;تورفتگی ردیف‌های پلکانی/نردبانی در حالت «متن». بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent&quot;
      ]
    },
    &quot;واحد تورفتگی&quot;: {
      &quot;label&quot;: &quot;اندازهٔ هر پله&quot;,
      &quot;description&quot;: &quot;اندازهٔ هر «:» در شعر نو («نوع=مصراع»).&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent-unit&quot;,
        &quot;واحد‌تورفتگی&quot;
      ]
    },
    &quot;فاصله&quot;: {
      &quot;label&quot;: &quot;فاصلهٔ میان بندها&quot;,
      &quot;description&quot;: &quot;ارتفاع فاصلهٔ میان بندها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;gap&quot;
      ]
    },
    &quot;بند&quot;: {
      &quot;label&quot;: &quot;بند تازه&quot;,
      &quot;description&quot;: &quot;در حالت «متن» و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ «جداکننده بند») می‌گذارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;جدید&quot;
      ]
    },
    &quot;شماره‌گذاری&quot;: {
      &quot;label&quot;: &quot;شماره‌گذاری خودکار&quot;,
      &quot;description&quot;: &quot;«بله»: شمارهٔ همهٔ ابیات؛ یک عدد مثل «5»: هر پنجمین بیت؛ «نه» (یا «0»): خاموش.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;numbering&quot;,
        &quot;شماره&quot;,
        &quot;شمارهگذاری&quot;
      ]
    },
    &quot;شروع&quot;: {
      &quot;label&quot;: &quot;شمارهٔ نخست&quot;,
      &quot;description&quot;: &quot;شمارهٔ بیت نخست.&quot;,
      &quot;type&quot;: &quot;number&quot;,
      &quot;aliases&quot;: [
        &quot;start&quot;
      ]
    },
    &quot;سمت&quot;: {
      &quot;label&quot;: &quot;سمت شماره&quot;,
      &quot;description&quot;: &quot;سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) «وسط» همان «چپ» است.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;side&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;چپ&quot;,
        &quot;راست&quot;,
        &quot;وسط&quot;
      ]
    },
    &quot;ارقام&quot;: {
      &quot;label&quot;: &quot;رقم‌ها&quot;,
      &quot;description&quot;: &quot;تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;digits&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فارسی&quot;,
        &quot;لاتین&quot;,
        &quot;بدون تغییر&quot;
      ]
    },
    &quot;نستعلیق&quot;: {
      &quot;label&quot;: &quot;نمای نستعلیق&quot;,
      &quot;description&quot;: &quot;نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن «نستعلیق» به‌صورت بی‌نام («{{شعر|نستعلیق}}»).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;nastaliq&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;سبک&quot;: {
      &quot;label&quot;: &quot;سبک CSS&quot;,
      &quot;description&quot;: &quot;سبک CSS روی قاب بیرونی شعر (با «عرض=خودکار»: روی جدول).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;style&quot;
      ]
    },
    &quot;کلاس&quot;: {
      &quot;label&quot;: &quot;کلاس CSS&quot;,
      &quot;description&quot;: &quot;کلاسِ افزوده به قاب شعر.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;class&quot;
      ]
    },
    &quot;زبان&quot;: {
      &quot;label&quot;: &quot;زبان&quot;,
      &quot;description&quot;: &quot;برای ابیات غیرفارسی؛ خصوصیت «lang» را می‌گذارد و «جهت» را از آن حدس می‌زند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;lang&quot;
      ]
    },
    &quot;جهت&quot;: {
      &quot;label&quot;: &quot;جهت&quot;,
      &quot;description&quot;: &quot;جهت متن.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;dir&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;rtl&quot;,
        &quot;ltr&quot;
      ]
    },
    &quot;ادامه&quot;: {
      &quot;label&quot;: &quot;ادامه از/به صفحهٔ دیگر&quot;,
      &quot;description&quot;: &quot;شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است («قبل») و/یا در صفحهٔ بعد ادامه دارد («بعد»، فقط حالت «متن»). در حالت «متن»، «ادامه=بله» مبهم است و پذیرفته نمی‌شود.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continue&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;قبل&quot;,
        &quot;بعد&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;ناتمام&quot;: {
      &quot;label&quot;: &quot;ردیف آخر ناتمام&quot;,
      &quot;description&quot;: &quot;حالت «متن»: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;unfinished&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;دنباله&quot;: {
      &quot;label&quot;: &quot;ردیف نخست دنباله&quot;,
      &quot;description&quot;: &quot;حالت «متن»: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. «اول»/«دوم»: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continued&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;اول&quot;,
        &quot;دوم&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;اتصال&quot;: {
      &quot;label&quot;: &quot;نحوهٔ چسباندن&quot;,
      &quot;description&quot;: &quot;نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;join&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فاصله&quot;,
        &quot;چسبیده&quot;,
        &quot;نیم‌فاصله&quot;
      ]
    },
    &quot;طول مصراع&quot;: {
      &quot;label&quot;: &quot;طول مصراع&quot;,
      &quot;description&quot;: &quot;فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع («کوتاه» تا ۲۰ نویسه، «متوسط» تا ۳۰، «بلند» بیشتر؛ یا خودِ شمار نویسه).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;hemistich-length&quot;,
        &quot;طول‌مصراع&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;کوتاه&quot;,
        &quot;متوسط&quot;,
        &quot;بلند&quot;,
        &quot;خودکار&quot;
      ]
    }
  },
  &quot;paramOrder&quot;: [
    &quot;1&quot;,
    &quot;2&quot;,
    &quot;عرض&quot;,
    &quot;حداکثر عرض&quot;,
    &quot;تلفن&quot;,
    &quot;ترازبندی&quot;,
    &quot;جداکننده&quot;,
    &quot;جداکننده بند&quot;,
    &quot;متن&quot;,
    &quot;نوع&quot;,
    &quot;تراز&quot;,
    &quot;تورفتگی&quot;,
    &quot;واحد تورفتگی&quot;,
    &quot;فاصله&quot;,
    &quot;بند&quot;,
    &quot;شماره‌گذاری&quot;,
    &quot;شروع&quot;,
    &quot;سمت&quot;,
    &quot;ارقام&quot;,
    &quot;نستعلیق&quot;,
    &quot;سبک&quot;,
    &quot;کلاس&quot;,
    &quot;زبان&quot;,
    &quot;جهت&quot;,
    &quot;ادامه&quot;,
    &quot;ناتمام&quot;,
    &quot;دنباله&quot;,
    &quot;اتصال&quot;,
    &quot;طول مصراع&quot;
  ]
}
&lt;/templatedata&gt;</text>
      <sha1>4ddrnqccflz59vg4hmsob1fmvu0fpu6</sha1>
    </revision>
    <revision>
      <id>305361</id>
      <parentid>305360</parentid>
      <timestamp>2026-10-27T02:09:26Z</timestamp>
      <contributor>
        <username>Hanooz</username>
        <id>17889</id>
      </contributor>
      <origin>305361</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="117555" sha1="cu64nv85g5l5wa60cvv9h341jka0q3f" xml:space="preserve">{{زیرصفحه توضیحات}}
این الگوها برای نمایش اشعار در ویکی‌نبشته به کار می‌روند. کار اصلی را [[پودمان:شعر]] انجام می‌دهد؛ الگوهای {{الگو|شعر}}، {{الگو|پایان شعر}}، {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}}، {{الگو|مصراع}}، {{الگو|بیت خالی}}، {{الگو|مصراع خالی}} و {{الگو|جداکننده بند}} فقط درگاهی به آن‌اند و شیوه‌نامه‌شان در [[الگو:شعر/styles.css]] است. نام‌های کوتاه پیشین (&lt;code&gt;ب&lt;/code&gt;، &lt;code&gt;ب۱&lt;/code&gt;، &lt;code&gt;بن&lt;/code&gt;، &lt;code&gt;م&lt;/code&gt;) تغییرمسیر هستند و همچنان کار می‌کنند.

== امکانات در یک نگاه ==
* '''انواع ردیف:''' بیت دومصراعی، بیت پلکانی/ضربدری ({{الگو|بیت۱}} و {{الگو|بیت نردبانی}})، مصراع تنها و شعر نو؛ همه در یک شعر قابل ترکیب‌اند.
* '''چیدمان ثابت و هم‌تراز:''' همهٔ ابیات یک شعر — حتی اگر در چند جدولِ جدا (صفحه‌های جدا) باشند — از یک نقطه آغاز می‌شوند؛ با &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;حداکثر عرض&lt;/code&gt; قابل تنظیم است.
* '''ترازبندی:''' میانه، وسط، راست، چپ، دوطرفه (پهن) و لبه‌چین؛ برای کل شعر یا فقط یک ردیف.
* '''نماد و فاصله:''' نماد میان دو مصراع (&lt;code&gt;جداکننده&lt;/code&gt;)، نماد میان بندها (&lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt;، {{الگو|جداکننده بند}})، و فاصلهٔ دلخواه میان بندها (&lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;ارتفاع&lt;/code&gt;، &lt;code&gt;@فاصله&lt;/code&gt;).
* '''شماره‌گذاری:''' دستی (راست/وسط/چپ) و خودکار (هر ''n''‌امین بیت)، با تبدیل رقم به فارسی یا لاتین.
* '''نستعلیق:''' با &lt;code&gt;نستعلیق&lt;/code&gt;؛ قلم و اندازه از خودِ الگوی {{الگو|نستعلیق}} می‌آید.
* '''حالت «متن»:''' کل شعر به‌صورت خط‌های ساده در یک فراخوانی؛ با خط‌های &lt;code&gt;@…&lt;/code&gt; نوع ردیف و نماد/فاصلهٔ بندها را در میانهٔ متن عوض می‌کنید؛ نشانه‌های درون‌خطی برای شماره و تراز.
* '''شعر چندصفحه‌ای:''' پیش‌نمایش کامل هر «صفحه:» و دوخته‌شدن صفحه‌ها در صفحهٔ اصلی؛ مصراع یا بیتِ ناتمام در پایان صفحه هم پشتیبانی می‌شود.
* '''نمایش واکنش‌گرا:''' در پنجرهٔ باریک هر بیت «ستونی» می‌شود (دو مصراع زیر هم)؛ در فضای نام «صفحه» آستانهٔ ستونی‌شدن به طول مصراع‌ها بستگی دارد.
* '''پانویس:''' &lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt; در پایان مصراع بدون برهم‌زدن عرض و ترازبندی.
* زبان و جهت، سبک/کلاس/شناسه برای هر ردیف، و رده‌های پیگیری برای خطاها. ساختار خروجی همان جدول ۷ستونی است و برای کتاب الکترونیکی هم کار می‌کند.

== شروع سریع ==
=== با الگوها ===
شعر را با {{الگو|شعر}} باز کنید، هر بیت را با {{الگو|بیت}} بنویسید و با {{الگو|پایان شعر}} ببندید:
&lt;pre&gt;
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}

=== با حالت «متن» ===
همین شعر را می‌توان خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; نوشت؛ هر دو خط پیاپی یک بیت می‌شوند و نیازی به {{الگو|پایان شعر}} نیست:
&lt;pre&gt;
{{شعر۲|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
&lt;/pre&gt;
نتیجه:
{{شعر۲|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
حالت «متن» برای ویرایش دیداری و رونویسیِ اشعارِ بلند مناسب‌تر است؛ بخش [[#حالت «متن»|حالت «متن»]] را ببینید.

=== علامت «=» و «|» در مصراع ===
: '''نکته:''' اگر در مصراع علامت &lt;code&gt;=&lt;/code&gt; یا &lt;code&gt;|&lt;/code&gt; دارید، به‌جای آن‌ها &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید؛ وگرنه مصراع به‌عنوان پارامتر ناشناخته خوانده می‌شود و صفحه به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌رود. در حالت «متن» علامت &lt;code&gt;=&lt;/code&gt; مشکلی ندارد (پارامتر نام دارد)، ولی &lt;code&gt;|&lt;/code&gt; را باید با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید.

== الگوها ==
هر الگو فقط یک درگاه به پودمان است: متن آن &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|نقطهٔ ورود}}&lt;/nowiki&gt;&lt;/code&gt; است.
{| class=&quot;wikitable&quot;
! الگو !! نام کوتاه !! نقطهٔ ورود !! کار
|-
| {{الگو|شعر}} || — || &lt;code&gt;open&lt;/code&gt; || آغاز شعر؛ با &lt;code&gt;متن&lt;/code&gt; کل شعر را می‌سازد (بدون نیاز به {{الگو|پایان شعر}})
|-
| {{الگو|پایان شعر}} || — || &lt;code&gt;close&lt;/code&gt; || پایان شعر
|-
| {{الگو|بیت}} || &lt;code&gt;ب&lt;/code&gt; || &lt;code&gt;bayt&lt;/code&gt; || بیت دومصراعی
|-
| {{الگو|بیت۱}} || &lt;code&gt;ب۱&lt;/code&gt; || &lt;code&gt;stagger&lt;/code&gt; || بیت پلکانی (ضربدری)
|-
| {{الگو|بیت نردبانی}} || &lt;code&gt;بن&lt;/code&gt; || &lt;code&gt;ladder&lt;/code&gt; || بیت نردبانی (در نسخهٔ کنونی دقیقاً مانند {{الگو|بیت۱}})
|-
| {{الگو|مصراع}} || &lt;code&gt;م&lt;/code&gt; || &lt;code&gt;mesra&lt;/code&gt; || یک مصراعِ تنها
|-
| {{الگو|بیت خالی}} || — || &lt;code&gt;emptyBayt&lt;/code&gt; || یک خط خالی؛ با &lt;code&gt;ارتفاع&lt;/code&gt; فاصلهٔ دلخواه، با &lt;code&gt;نماد&lt;/code&gt; ردیفِ نماد
|-
| {{الگو|مصراع خالی}} || — || &lt;code&gt;emptyMesra&lt;/code&gt; || مانند {{الگو|بیت خالی}}، برای شعر نو
|-
| {{الگو|جداکننده بند}} || — || &lt;code&gt;divider&lt;/code&gt; || ردیفِ نمادِ سراسری و وسط‌چین میان دو بند
|}

== مرجع پارامترها ==
* نام‌های انگلیسی (ستون «هم‌ارز» در جدول‌ها) هم پذیرفته می‌شوند. نام‌های چندکلمه‌ای را هم با فاصله و هم با نیم‌فاصله می‌توان نوشت (مثلاً «حداکثر عرض» یا «حداکثر‌عرض»).
* پارامتر یا مقدارِ ناشناخته، مصراعِ اضافه و «=» در مصراع صفحه را به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌برد؛ پارامتر نادرست خوانده نمی‌شود ولی صفحه نمی‌شکند.
* مقدارِ «بله/نه» به این صورت‌ها هم نوشته می‌شود: &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;بلی&lt;/code&gt;، &lt;code&gt;آری&lt;/code&gt;، &lt;code&gt;yes&lt;/code&gt;، &lt;code&gt;true&lt;/code&gt;، &lt;code&gt;1&lt;/code&gt; / &lt;code&gt;نه&lt;/code&gt;، &lt;code&gt;خیر&lt;/code&gt;، &lt;code&gt;no&lt;/code&gt;، &lt;code&gt;false&lt;/code&gt;، &lt;code&gt;0&lt;/code&gt;.
* طول‌ها (عرض، تورفتگی، فاصله، ارتفاع…) عدد با واحد &lt;code&gt;%&lt;/code&gt;، &lt;code&gt;px&lt;/code&gt;، &lt;code&gt;em&lt;/code&gt;، &lt;code&gt;ex&lt;/code&gt;، &lt;code&gt;ch&lt;/code&gt;، &lt;code&gt;rem&lt;/code&gt;، &lt;code&gt;vw&lt;/code&gt;، &lt;code&gt;vh&lt;/code&gt;، &lt;code&gt;pt&lt;/code&gt;، &lt;code&gt;cm&lt;/code&gt;، &lt;code&gt;mm&lt;/code&gt; یا &lt;code&gt;in&lt;/code&gt; هستند؛ عدد بدون واحد پیکسل حساب می‌شود. رقم فارسی و «٪» هم پذیرفته است (&lt;code&gt;۲۰٪&lt;/code&gt;).

=== شعر (آغاز) ===
گزینه‌هایی که برای کل شعر اثر دارند در {{الگو|شعر}} داده می‌شوند.
==== گزینه‌های بی‌نام ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || گزینهٔ بی‌نام: &lt;code&gt;نستعلیق&lt;/code&gt; نمای نستعلیق را روشن می‌کند؛ &lt;code&gt;ادامه&lt;/code&gt; یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).
|-
| &lt;code&gt;2&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.
|}
==== چیدمان و اندازه ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;width&lt;/code&gt;&lt;/small&gt; || درصد یا طول (&lt;code&gt;80%&lt;/code&gt;، &lt;code&gt;30em&lt;/code&gt;، &lt;code&gt;480px&lt;/code&gt;) یا &lt;code&gt;خودکار&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; تا سقف &lt;code&gt;حداکثر عرض&lt;/code&gt;؛ با &lt;code&gt;&lt;nowiki&gt;ترازبندی=پهن&lt;/nowiki&gt;&lt;/code&gt; (بی‌عرض): &lt;code&gt;خودکار&lt;/code&gt; || عرض قاب شعر. عدد بدون واحد پیکسل است. &lt;code&gt;خودکار&lt;/code&gt; یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط &lt;code&gt;عرض&lt;/code&gt; بدهید سقف عرض ۱۰۰٪ می‌شود.
|-
| &lt;code&gt;حداکثر عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;max-width&lt;/code&gt;&lt;/small&gt; || طول یا &lt;code&gt;بدون&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض قاب (وقتی عرض ثابت است). &lt;code&gt;بدون&lt;/code&gt; (یا &lt;code&gt;none&lt;/code&gt;، &lt;code&gt;نامحدود&lt;/code&gt;) یعنی بی‌سقف.
|-
| &lt;code&gt;تلفن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;phone&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;ستونی&lt;/code&gt;، &lt;code&gt;دوستونه&lt;/code&gt;، &lt;code&gt;همیشه&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt;: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ &lt;code&gt;دوستونه&lt;/code&gt;: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ &lt;code&gt;همیشه&lt;/code&gt;: همیشه ستونی.
|}
==== ترازبندی و نمادها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;، &lt;code&gt;تراز‌بندی&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;میانه&lt;/code&gt; (&lt;code&gt;درون&lt;/code&gt;)، &lt;code&gt;وسط&lt;/code&gt; (&lt;code&gt;مرکز&lt;/code&gt;)، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;پهن&lt;/code&gt; (&lt;code&gt;دوطرفه&lt;/code&gt;)، &lt;code&gt;لبه&lt;/code&gt; || &lt;code&gt;میانه&lt;/code&gt; برای بیت دومصراعی؛ &lt;code&gt;لبه&lt;/code&gt; برای بیت پلکانی || ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). &lt;code&gt;میانه&lt;/code&gt;: مصراع‌ها به محور میانی می‌چسبند؛ &lt;code&gt;لبه&lt;/code&gt;: مصراع نخست به راست و دوم به چپ؛ &lt;code&gt;پهن&lt;/code&gt;: دوطرفه.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (❖)، &lt;code&gt;نه&lt;/code&gt;، یا یک نمادِ کوتاه مثل &lt;code&gt;✤&lt;/code&gt; || بدون نماد || نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی &lt;code&gt;شو&lt;/code&gt; نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.
|-
| &lt;code&gt;جداکننده بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza-separator&lt;/code&gt;، &lt;code&gt;جداکنندهٔ بند&lt;/code&gt;، &lt;code&gt;نماد بند&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (• • •)، &lt;code&gt;نه&lt;/code&gt;، یا هر نمادِ کوتاه (&lt;code&gt;❖&lt;/code&gt;، &lt;code&gt;❖ ❖ ❖&lt;/code&gt;) || بدون نماد || ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت &lt;code&gt;متن&lt;/code&gt; به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط &lt;code&gt;@نماد&lt;/code&gt; یا الگوی «جداکننده بند» استفاده کنید.
|}
==== حالت «متن» و نوع ردیف‌ها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;متن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;text&lt;/code&gt;&lt;/small&gt; || خط‌های ساده || — || کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.
|-
| &lt;code&gt;نوع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;type&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بیت&lt;/code&gt;، &lt;code&gt;بیت۱&lt;/code&gt; (&lt;code&gt;پلکانی&lt;/code&gt;)، &lt;code&gt;بیت نردبانی&lt;/code&gt; (&lt;code&gt;نردبانی&lt;/code&gt;)، &lt;code&gt;مصراع&lt;/code&gt; (&lt;code&gt;نو&lt;/code&gt;، &lt;code&gt;نیمایی&lt;/code&gt;، &lt;code&gt;آزاد&lt;/code&gt;) || &lt;code&gt;بیت&lt;/code&gt; || نوع پیش‌فرض ردیف‌ها در حالت &lt;code&gt;متن&lt;/code&gt;. با &lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt; ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;راست&lt;/code&gt; در شعر نو؛ &lt;code&gt;وسط&lt;/code&gt; برای مصراع تنهای پایان بند || تراز مصراع‌های تنها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || تورفتگی ردیف‌های پلکانی/نردبانی در حالت &lt;code&gt;متن&lt;/code&gt;. بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.
|-
| &lt;code&gt;واحد تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent-unit&lt;/code&gt;، &lt;code&gt;واحد‌تورفتگی&lt;/code&gt;&lt;/small&gt; || طول || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر «:» در شعر نو (&lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;فاصله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;gap&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصلهٔ میان بندها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;جدید&lt;/code&gt; || — || در حالت &lt;code&gt;متن&lt;/code&gt; و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt;) می‌گذارد.
|}
==== شماره‌گذاری ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;شماره‌گذاری&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;numbering&lt;/code&gt;، &lt;code&gt;شماره&lt;/code&gt;، &lt;code&gt;شمارهگذاری&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، عدد (&lt;code&gt;5&lt;/code&gt;)، &lt;code&gt;نه&lt;/code&gt; || خاموش || &lt;code&gt;بله&lt;/code&gt;: شمارهٔ همهٔ ابیات؛ یک عدد مثل &lt;code&gt;5&lt;/code&gt;: هر پنجمین بیت؛ &lt;code&gt;نه&lt;/code&gt; (یا &lt;code&gt;0&lt;/code&gt;): خاموش.
|-
| &lt;code&gt;شروع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;start&lt;/code&gt;&lt;/small&gt; || عدد || &lt;code&gt;1&lt;/code&gt; || شمارهٔ بیت نخست.
|-
| &lt;code&gt;سمت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;side&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;وسط&lt;/code&gt; || &lt;code&gt;چپ&lt;/code&gt; || سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) &lt;code&gt;وسط&lt;/code&gt; همان &lt;code&gt;چپ&lt;/code&gt; است.
|-
| &lt;code&gt;ارقام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;digits&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فارسی&lt;/code&gt; (&lt;code&gt;fa&lt;/code&gt;)، &lt;code&gt;لاتین&lt;/code&gt; (&lt;code&gt;latin&lt;/code&gt;)، &lt;code&gt;بدون تغییر&lt;/code&gt; (&lt;code&gt;keep&lt;/code&gt;) || &lt;code&gt;فارسی&lt;/code&gt; || تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.
|}
==== ظاهر ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;نستعلیق&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;nastaliq&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن &lt;code&gt;نستعلیق&lt;/code&gt; به‌صورت بی‌نام (&lt;code&gt;&lt;nowiki&gt;{{شعر|نستعلیق}}&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی قاب بیرونی شعر (با &lt;code&gt;&lt;nowiki&gt;عرض=خودکار&lt;/nowiki&gt;&lt;/code&gt;: روی جدول).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به قاب شعر.
|-
| &lt;code&gt;زبان&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;lang&lt;/code&gt;&lt;/small&gt; || کد زبان (&lt;code&gt;ar&lt;/code&gt;، &lt;code&gt;en&lt;/code&gt;، &lt;code&gt;fa&lt;/code&gt;) || — || برای ابیات غیرفارسی؛ خصوصیت &lt;code&gt;lang&lt;/code&gt; را می‌گذارد و &lt;code&gt;جهت&lt;/code&gt; را از آن حدس می‌زند.
|-
| &lt;code&gt;جهت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;dir&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;rtl&lt;/code&gt;، &lt;code&gt;ltr&lt;/code&gt; || از &lt;code&gt;زبان&lt;/code&gt; حدس زده می‌شود || جهت متن.
|}
==== شعر چندصفحه‌ای ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || الگو: &lt;code&gt;ادامه&lt;/code&gt; (بی‌نام) یا &lt;code&gt;قبل&lt;/code&gt;؛ حالت &lt;code&gt;متن&lt;/code&gt;: &lt;code&gt;قبل&lt;/code&gt;، &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || — || شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است (&lt;code&gt;قبل&lt;/code&gt;) و/یا در صفحهٔ بعد ادامه دارد (&lt;code&gt;بعد&lt;/code&gt;، فقط حالت &lt;code&gt;متن&lt;/code&gt;). در حالت &lt;code&gt;متن&lt;/code&gt;، &lt;code&gt;&lt;nowiki&gt;ادامه=بله&lt;/nowiki&gt;&lt;/code&gt; مبهم است و پذیرفته نمی‌شود.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;اول&lt;/code&gt;، &lt;code&gt;دوم&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. &lt;code&gt;اول&lt;/code&gt;/&lt;code&gt;دوم&lt;/code&gt;: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.
|}
==== فضای نام «صفحه» ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;طول مصراع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;hemistich-length&lt;/code&gt;، &lt;code&gt;طول‌مصراع&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;کوتاه&lt;/code&gt;، &lt;code&gt;متوسط&lt;/code&gt;، &lt;code&gt;بلند&lt;/code&gt;، عدد، &lt;code&gt;خودکار&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: خودکار؛ حالت الگو: &lt;code&gt;متوسط&lt;/code&gt; || فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع (&lt;code&gt;کوتاه&lt;/code&gt; تا ۲۰ نویسه، &lt;code&gt;متوسط&lt;/code&gt; تا ۳۰، &lt;code&gt;بلند&lt;/code&gt; بیشتر؛ یا خودِ شمار نویسه).
|}

=== پایان شعر ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;ادامه&lt;/code&gt; || — || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;: شعر در صفحهٔ بعد ادامه دارد (جدول بسته نمی‌شود).
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt;، &lt;code&gt;بله&lt;/code&gt; || — || مانند &lt;code&gt;ادامه&lt;/code&gt; بی‌نام. &lt;code&gt;قبل&lt;/code&gt; را در «شعر» بنویسید.
|}

=== بیت ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست (سمت راست). اگر فقط یکی از دو مصراع پر باشد (و ردیف ناتمام/دنباله نباشد) صفحه به ردهٔ «بیت ناقص» می‌رود.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم (سمت چپ).
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانِ دو مصراع (جای نمادِ &lt;code&gt;جداکننده&lt;/code&gt; را می‌گیرد).
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt;، نماد || از «شعر» || نمادِ میان دو مصراعِ همین بیت (&lt;code&gt;نه&lt;/code&gt; برای حذف).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت۱ و بیت نردبانی ===
هر دو یک پارامتر دارند (در نسخهٔ کنونی خروجی‌شان یکی است). ستون میانی ندارند، پس &lt;code&gt;شو&lt;/code&gt; و &lt;code&gt;جداکننده&lt;/code&gt; در آن‌ها اثری ندارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== مصراع ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || متن مصراع.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;وسط&lt;/code&gt; || تراز مصراع. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت خالی و مصراع خالی ===
این دو الگو سه کار می‌کنند: بدون پارامتر یک خط خالی (در {{الگو|بیت خالی}} با ستون‌های شماره)، با &lt;code&gt;ارتفاع&lt;/code&gt; یک فاصلهٔ دلخواه، و با &lt;code&gt;نماد&lt;/code&gt; (یا وقتی {{الگو|شعر}} پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) یک ردیفِ نماد. جدول زیر برای {{الگو|بیت خالی}} است؛ {{الگو|مصراع خالی}} همین پارامترها را بدون &lt;code&gt;شو&lt;/code&gt; دارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصله (پیش‌فرض یک خط). به‌تنهایی فقط &lt;code&gt;کلاس&lt;/code&gt; اثر دارد؛ همراه &lt;code&gt;نماد&lt;/code&gt; ارتفاعِ ردیف نماد را تعیین می‌کند.
|-
| &lt;code&gt;نماد&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;symbol&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;نه&lt;/code&gt; یا نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) || — || به‌جای خط خالی، یک ردیفِ نمادِ سراسری و وسط‌چین می‌آورد؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت راست؛ فقط در ردیف خالیِ ساده (بدون &lt;code&gt;ارتفاع&lt;/code&gt; و &lt;code&gt;نماد&lt;/code&gt;).
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانی؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت چپ؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف خالی (با &lt;code&gt;نماد&lt;/code&gt;: روی ردیف نماد؛ با &lt;code&gt;ارتفاع&lt;/code&gt; به‌تنهایی اثر ندارد).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف؛ فقط در ردیف خالیِ ساده.
|}

=== جداکننده بند ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) یا &lt;code&gt;نه&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt; شعر، وگرنه • • • || نمادِ ردیف؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده. همان &lt;code&gt;&lt;nowiki&gt;نماد=&lt;/nowiki&gt;&lt;/code&gt; را هم می‌پذیرد.
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع ردیف نماد (پیش‌فرض یک خط)؛ نماد در میانهٔ آن می‌نشیند.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف نماد؛ مثلاً &lt;code&gt;color:#b3362b&lt;/code&gt; برای رنگ یا &lt;code&gt;font-size:150%&lt;/code&gt; برای اندازه.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|}

== چیدمان: عرض ثابت و هم‌تراز ==
جدول شعر به‌طور پیش‌فرض '''عرضی ثابت و مستقل از محتوا''' دارد: عرض ۱۰۰٪ فضای موجود با سقف &lt;code&gt;50em&lt;/code&gt;، با دو ستونِ هم‌اندازه برای مصراع‌ها، یک ستون میانی (فاصلهٔ دو مصراع) و دو ستونِ باریک برای شماره‌ها. نتیجه این است که همهٔ ابیات یک شعر از یک نقطه آغاز می‌شوند و اگر شعر در چند جدول جدا (مثلاً هر صفحه یک جدول) بیاید، قاب‌ها دقیقاً هم‌اندازه و هم‌تراز می‌مانند؛ برخلاف جدولِ هم‌اندازهٔ محتوا که عرضش بسته به بلندترین مصراعِ همان صفحه فرق می‌کند و آغاز شعر را در مرز صفحه جابه‌جا می‌کند.
&lt;pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
* '''عرض=خودکار:''' جدول به اندازهٔ محتوا می‌شود (و وسط‌چین): برای رباعی یا شعر کوتاه که نمی‌خواهید قاب پهن داشته باشد.
{{شعر|عرض=خودکار}}
{{بیت|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''حداکثر عرض:''' سقف عرض را عوض می‌کند: &lt;code&gt;حداکثر عرض=40em&lt;/code&gt;، یا &lt;code&gt;حداکثر عرض=بدون&lt;/code&gt; برای بی‌سقف.
* همهٔ ستون‌ها را همین عرض تعیین می‌کند؛ پس مصراع‌های بلندتر از ستون به چند خط شکسته می‌شوند. برای شعرهای بلندمصراع یا نستعلیق (قلم درشت‌تر) &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید.
* با &lt;code&gt;ترازبندی=پهن&lt;/code&gt; اگر &lt;code&gt;عرض&lt;/code&gt; ندهید، جدول هم‌اندازهٔ محتوا (&lt;code&gt;عرض=خودکار&lt;/code&gt;) است، چون در شعر دوطرفه ستون‌ها باید به اندازهٔ بلندترین مصراع شوند؛ با دادنِ &lt;code&gt;عرض&lt;/code&gt; همان عرضِ ثابت اعمال می‌شود.
* در شعر چندصفحه‌ای فقط گزینه‌های {{الگو|شعر}} صفحهٔ نخست در صفحهٔ اصلی اثر دارد (بخش «شعر چندصفحه‌ای»).
* مدیران پودمان می‌توانند پیش‌فرض را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند (&lt;code&gt;defaultWidth&lt;/code&gt;، &lt;code&gt;maxWidth&lt;/code&gt;؛ مقدار &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند).

== ترازبندی مصراع‌ها ==
پارامتر &lt;code&gt;ترازبندی&lt;/code&gt; در {{الگو|شعر}} (برای همهٔ ابیات) یا در هر ردیف (فقط همان ردیف) مشخص می‌کند متن مصراع‌ها در جایگاه خود چگونه بنشیند:
{| class=&quot;wikitable&quot;
! مقدار !! معنی
|-
| &lt;code&gt;میانه&lt;/code&gt; (یا &lt;code&gt;درون&lt;/code&gt;) || '''پیش‌فرض {{الگو|بیت}}.''' هر دو مصراع به محور میانیِ بیت می‌چسبند (مصراع نخست به چپِ جایگاهش، مصراع دوم به راستِ جایگاهش)؛ فاصلهٔ دو مصراع در همهٔ ابیات یکسان می‌ماند — شیوهٔ کتاب‌های کلاسیک و گنجور.
|-
| &lt;code&gt;وسط&lt;/code&gt; (یا &lt;code&gt;مرکز&lt;/code&gt;) || هر مصراع وسط جایگاهش.
|-
| &lt;code&gt;راست&lt;/code&gt; / &lt;code&gt;چپ&lt;/code&gt; || همهٔ مصراع‌ها به راست/چپ جایگاهشان چسبیده (همهٔ خط‌ها از یک نقطه آغاز می‌شوند).
|-
| &lt;code&gt;پهن&lt;/code&gt; (یا &lt;code&gt;دوطرفه&lt;/code&gt;) || دوطرفه: هر مصراع کل پهنای جایگاهش را می‌گیرد (چیدمان چاپی کلاسیک). همهٔ ستون‌ها به اندازهٔ بلندترین مصراعِ کل شعر می‌شوند. اگر کوتاه‌ترین مصراعِ یک بیت کمتر از ۷۰٪ بلندترینِ همان بیت باشد، آن بیت کشیده نمی‌شود (وسط‌چین می‌ماند) تا فاصلهٔ واژه‌ها بی‌جهت باز نشود.
|-
| &lt;code&gt;لبه&lt;/code&gt; || مصراع نخست به آغاز (راست) و مصراع دوم به پایان (چپ) می‌چسبد؛ '''پیش‌فرض {{الگو|بیت۱}} و {{الگو|بیت نردبانی}}'''.
|}
&lt;pre&gt;
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
'''پهن (دوطرفه):'''
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''میانه (پیش‌فرض):'''
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''وسط:'''
{{شعر|ترازبندی=وسط}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''راست:'''
{{شعر|ترازبندی=راست}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''لبه:'''
{{شعر|ترازبندی=لبه}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
ترازبندی در یک ردیف (بقیه پیش‌فرض می‌مانند): &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|ترازبندی=پهن}}&lt;/nowiki&gt;&lt;/code&gt;

== بیت پلکانی (ضربدری) و نردبانی ==
برای نمایش ابیات به‌صورت ضربدری و نامتقارن از {{الگو|بیت۱}} (یا {{الگو|بیت نردبانی}}) به‌جای {{الگو|بیت}} استفاده کنید؛ هر بیت روی '''دو خط''' می‌آید. بدون پارامتر، مصراع نخست در نیمهٔ راست و مصراع دوم (در خط بعد) در نیمهٔ چپ می‌نشیند و هر دو به لبهٔ خود می‌چسبند (&lt;code&gt;ترازبندی=لبه&lt;/code&gt;):
&lt;pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''تورفتگی:''' با &lt;code&gt;تورفتگی&lt;/code&gt; هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» می‌شود که یکی به راست و دیگری به چپ می‌چسبد؛ هرچه تورفتگی کمتر باشد پله‌ها کوتاه‌ترند:
&lt;pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
* '''ترکیب با بیت دومصراعی:''' انواع ردیف را می‌توان در یک شعر آمیخت:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
* '''{{الگو|بیت نردبانی}}:''' در نسخهٔ کنونی پودمان همان {{الگو|بیت۱}} است و تورفتگی پیش‌فرضِ جداگانه‌ای ندارد؛ برای پله‌های بلندتر یا کوتاه‌تر &lt;code&gt;تورفتگی&lt;/code&gt; بدهید.
* مقدار &lt;code&gt;تورفتگی&lt;/code&gt; را با ٪ یا واحدهای &lt;code&gt;em&lt;/code&gt; و &lt;code&gt;px&lt;/code&gt; می‌توان داد (مقدار بدون واحد پیکسل است).
* ترازبندی پیش‌فرض این دو &lt;code&gt;لبه&lt;/code&gt; است؛ برای وسط‌چین‌کردن جعبه‌ها &lt;code&gt;ترازبندی=وسط&lt;/code&gt; بدهید.
* با &lt;code&gt;عرض=خودکار&lt;/code&gt; (چیدمان هم‌اندازهٔ محتوا) تورفتگی نسبت به عرضِ جدول است و جدول به اندازهٔ محتوا می‌شود.

== نماد میان دو مصراع ==
پارامتر &lt;code&gt;جداکننده&lt;/code&gt; نمادی را میان دو مصراعِ هر بیت می‌گذارد (در ستون میانی). &lt;code&gt;بله&lt;/code&gt; نمادِ پیش‌فرض ❖ را می‌گذارد، هر نمادِ کوتاهی هم پذیرفته است، و &lt;code&gt;نه&lt;/code&gt; آن را حذف می‌کند:
&lt;pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
* در {{الگو|شعر}} برای همهٔ ابیات اثر دارد و در هر ردیف فقط برای همان ردیف.
* اگر شمارهٔ میانی (&lt;code&gt;شو&lt;/code&gt;) آمده باشد جای نماد را می‌گیرد.
* نماد باید کوتاه باشد (تا حدود ۸ نویسه) و &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;&amp;gt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;}&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; &lt;code&gt;]&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; نداشته باشد؛ وگرنه نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* در نمایش ستونی (صفحهٔ باریک) نماد پنهان می‌شود. رنگ و اندازه‌اش با &lt;code&gt;.poem-sep&lt;/code&gt; در [[الگو:شعر/styles.css]] تعیین می‌شود؛ پیش‌فرض همگانی را مدیر پودمان با &lt;code&gt;cfg.separator&lt;/code&gt; می‌دهد.
* این نماد میان '''دو مصراعِ یک بیت''' است؛ برای نمادِ میان '''دو بند''' بخش بعد را ببینید.

== بندها: فاصله و نماد ==
بیت‌ها معمولاً در «بند» دسته می‌شوند (رباعی، چهارپاره و…). میان بندها می‌توان یک فاصله یا یک نماد (مثل • • • یا ❖) گذاشت.

=== فاصلهٔ ساده ===
هنگامی که بخواهید میان ابیات یا مصراع‌های یک قطعه یک خط فاصله ایجاد کنید، از این الگوها استفاده کنید:
* {{الگو|بیت خالی}}
* {{الگو|مصراع خالی}}

برای فاصله‌ای کوتاه‌تر یا بلندتر از یک خط پارامتر &lt;code&gt;ارتفاع&lt;/code&gt; را بدهید: &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» خط خالی میان دو بند همین کار را می‌کند (یک خط؛ اندازه‌اش را &lt;code&gt;فاصله=0.5em&lt;/code&gt; عوض می‌کند).
&lt;pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}

=== نماد میان بندها ===
{{الگو|جداکننده بند}} یک ردیفِ '''سراسری و وسط‌چین''' با نماد می‌گذارد؛ نمادِ پیش‌فرض • • • است و هر نمادِ دیگری را می‌توان به‌صورت پارامتر بی‌نام داد. (همین کار را &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=…}}&lt;/nowiki&gt;&lt;/code&gt; هم می‌کند.)
&lt;pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
اگر نماد را برای '''همهٔ''' بندها می‌خواهید، پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; را در {{الگو|شعر}} بدهید: آن‌گاه هر {{الگو|بیت خالی}}ِ بی‌ارتفاع (و در حالت «متن» هر خط خالی میان دو بند) ردیفِ نماد می‌شود.
&lt;pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
&lt;/pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
* ردیفِ نماد همیشه یک خط بلند است (با &lt;code&gt;ارتفاع&lt;/code&gt; بلندتر می‌شود)، نمادش پررنگ است و رنگش از متن ارث می‌برد؛ برای رنگ دیگر: &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|سبک=color:#b3362b}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» رنگ و اندازه را شیوه‌نامه (&lt;code&gt;.poem-ornament-cell&lt;/code&gt;) تعیین می‌کند.
* ردیفِ نماد در نمایش ستونی هم دیده می‌شود (برخلاف نمادِ میان دو مصراع).
* برای فاصلهٔ ساده در شعری که نمادِ خودکار دارد: {{الگو|جداکننده بند}}&lt;code&gt;|نه&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt;، و در حالت «متن» خط &lt;code&gt;@نماد نه&lt;/code&gt;.
* نمادِ پیش‌فرض را مدیر پودمان با &lt;code&gt;cfg.stanzaOrnament&lt;/code&gt; عوض می‌کند.

=== نماد و فاصله در حالت «متن» ===
در حالت «متن» دو خطِ ویژه، بریدگیِ میان بندها را جداگانه تنظیم می‌کنند (هر کدام در یک خطِ جدا و با &lt;code&gt;@&lt;/code&gt; آغاز می‌شود):
{| class=&quot;wikitable&quot;
! خط !! کار
|-
| &lt;code&gt;@نماد&lt;/code&gt; || یک ردیفِ نمادِ پیش‌فرض (• • •) همین‌جا
|-
| &lt;code&gt;@نماد ❖&lt;/code&gt; || یک ردیفِ نمادِ دلخواه
|-
| &lt;code&gt;@نماد نه&lt;/code&gt; || فاصلهٔ ساده (برای شعری که &lt;code&gt;جداکننده بند&lt;/code&gt; دارد)
|-
| &lt;code&gt;@فاصله&lt;/code&gt; || یک ردیف فاصلهٔ اضافه (یک خط یا اندازهٔ &lt;code&gt;فاصله=&lt;/code&gt;)
|-
| &lt;code&gt;@فاصله 3em&lt;/code&gt; || یک ردیف فاصله با اندازهٔ دلخواه
|}
&lt;pre&gt;
{{شعر|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
&lt;/pre&gt;
{{شعر|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
* این خط‌ها جای خط‌های خالیِ کنارشان را می‌گیرند (خط خالی پیش و پس از آن‌ها شمرده نمی‌شود)؛ پس برای خوانایی می‌توانید دورشان خط خالی بگذارید.
* می‌توان چند خط را پشت‌سرهم نوشت: هر کدام یک ردیف می‌شود، به همان ترتیب (تا هشت ردیف). مثلاً &lt;code&gt;@نماد&lt;/code&gt; و بعد &lt;code&gt;@فاصله&lt;/code&gt; یک نماد و یک فاصلهٔ اضافه می‌دهد.
* '''چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند''' (برای سازگاری با شعرهای پیشین)؛ فاصلهٔ بزرگ‌تر را با &lt;code&gt;@فاصله&lt;/code&gt; بگیرید.
* خط &lt;code&gt;@نماد&lt;/code&gt; یا &lt;code&gt;@فاصله&lt;/code&gt; پیش از نخستین ردیف نادیده گرفته می‌شود. نام‌های دیگرِ پذیرفته‌شده: &lt;code&gt;@جداکننده&lt;/code&gt;، &lt;code&gt;@جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد بند&lt;/code&gt;، &lt;code&gt;@ornament&lt;/code&gt;، &lt;code&gt;@separator&lt;/code&gt;، &lt;code&gt;@symbol&lt;/code&gt; (برای نماد) و &lt;code&gt;@gap&lt;/code&gt; (برای فاصله).
* در پایان بند، مصراعِ تنها (اگر خط‌های بند فرد باشند) پیش از فاصله/نماد جای خود را می‌گیرد.

=== کدام را به کار ببرم؟ ===
{| class=&quot;wikitable&quot;
! می‌خواهم !! با الگوها !! در حالت «متن»
|-
| فاصلهٔ یک‌خطی میان بندها || {{الگو|بیت خالی}} || یک خط خالی
|-
| فاصلهٔ دلخواه || &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;فاصله=0.5em&lt;/code&gt; (همهٔ بندها) یا &lt;code&gt;@فاصله 0.5em&lt;/code&gt; (همان‌جا)
|-
| نماد میان همهٔ بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و {{الگو|بیت خالی}} میان بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و خط خالی میان بندها
|-
| نماد فقط در یک بریدگی || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|• • •}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد • • •&lt;/code&gt;
|-
| فاصلهٔ ساده در شعری که نمادِ خودکار دارد || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|نه}}&lt;/nowiki&gt;&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد نه&lt;/code&gt;
|-
| نماد به‌جای یک فاصلهٔ بلندتر || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|ارتفاع=3em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد ❖&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; پشت‌سرهم
|}

== مصراع‌های تنها و شعر نو ==
الگوی {{الگو|مصراع}} یک مصراع را وسط‌چین می‌نویسد. برای شعر نو می‌توانید تراز و تورفتگی بدهید:
&lt;pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
* &lt;code&gt;تراز&lt;/code&gt;: &lt;code&gt;وسط&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;راست&lt;/code&gt; یا &lt;code&gt;چپ&lt;/code&gt;. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
* مصراعِ تنها در میان ابیات (مثلاً مصراع پایانی یک بند) وسط‌چین می‌آید و زیر دو ستونِ شعر قرار می‌گیرد.
* در شعرِ نو معمولاً {{الگو|شعر}} را با &lt;code&gt;نوع=مصراع&lt;/code&gt; به کار می‌برند تا مصراع‌ها در شماره‌گذاری خودکار شمرده شوند؛ نوشتنِ شعر نو در حالت «متن» ساده‌تر است (بخش «حالت «متن»»).

== شماره‌گذاری ==
=== شماره‌گذاری دستی ===
اگر می‌خواهید در سمت راست یک بیت شمارهٔ آن را درج کنید، از پارامتر «ش» (مخفف «شماره») استفاده کنید. برای شماره در وسط (میان دو مصراع) از «شو» و برای سمت چپ از «شچ» استفاده کنید:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
* '''ارقام:''' رقم‌های لاتین و عربی در شماره‌ها خودکار به رقم فارسی تبدیل می‌شوند (&lt;code&gt;ش=12&lt;/code&gt; ← ۱۲). برای خاموش‌کردن، در {{الگو|شعر}} بنویسید &lt;code&gt;ارقام=بدون تغییر&lt;/code&gt; یا &lt;code&gt;ارقام=لاتین&lt;/code&gt;. مقداری که نشانه‌گذاری دارد (مثلاً پیوند یا قالب‌بندی) دست‌نخورده می‌ماند.

=== شماره‌گذاری خودکار ===
به‌جای نوشتن دستی شماره‌ها، در {{الگو|شعر}} پارامتر &lt;code&gt;شماره‌گذاری&lt;/code&gt; را بدهید:
&lt;pre&gt;
{{شعر|شماره‌گذاری=5|شروع=1}}
{{بیت|مصراع اول|مصراع دوم}}
… (شمارهٔ ۵، ۱۰، ۱۵ و … در سمت چپ نمایش داده می‌شود)
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|شماره‌گذاری=بله|سمت=راست}}
{{بیت|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{پایان شعر}}
* بیت‌های {{الگو|بیت}}، {{الگو|بیت۱}} و {{الگو|بیت نردبانی}} شمرده می‌شوند. {{الگو|مصراع}} فقط وقتی شمرده می‌شود که &lt;code&gt;نوع=مصراع&lt;/code&gt; داده باشید.
* با &lt;code&gt;شماره‌گذاری=5&lt;/code&gt; همهٔ ابیات شمرده می‌شوند ولی فقط شمارهٔ مضرب ۵ نمایش داده می‌شود؛ &lt;code&gt;شروع&lt;/code&gt; شمارهٔ بیت نخست را تعیین می‌کند (برای صفحه‌ای که از میانهٔ شعر آغاز می‌شود، شمارهٔ نخستین بیت همان صفحه را بدهید).
* اگر برای بیتی خودتان ش، شو یا شچ بدهید، همان نمایش داده می‌شود و شمارش خودکار برای آن بیت کنار می‌رود (شمارنده همچنان جلو می‌رود).
* مصراع تنهای پایان بند (در حالت «متن») شمرده نمی‌شود.
* شمارنده در طول رندر یک صفحه نگه داشته می‌شود و با هر {{الگو|شعر}} از نو آغاز می‌شود (مگر در شعر چندصفحه‌ای؛ بخش بعد).

== نستعلیق ==
*نکته: در صورت استفاده از نستعلیق {{الگو|دارای نستعلیق}} را استفاده کنید تا اگر کاربر فونت نستعلیق را ندارد از آن را نصب و استفاده نماید.
{{دارای نستعلیق}}

دستورات زیر:
&lt;pre&gt;
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
چنین نتیجه می‌دهد:
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
* '''چگونه کار می‌کند:''' پودمان خودِ الگوی {{الگو|نستعلیق}} را بسط می‌دهد و کلاس و استایل‌های قلم (&lt;code&gt;font-family&lt;/code&gt;، &lt;code&gt;font-size&lt;/code&gt;، &lt;code&gt;line-height&lt;/code&gt; و…) را که آن الگو می‌گذارد روی شعر می‌نشاند؛ پس هر تغییر در {{الگو|نستعلیق}} (و شیوه‌نامهٔ آن) خودکار به شعرها هم می‌رسد و به &lt;code&gt;Common.css&lt;/code&gt; یا ترتیب شیوه‌نامه‌ها وابسته نیست. اگر آن الگو در دسترس نباشد، فهرستِ قلمِ &lt;code&gt;cfg.nastaliqFonts&lt;/code&gt; به کار می‌رود.
* پارامتر &lt;code&gt;قلم&lt;/code&gt; وجود ندارد. برای قلمی دیگر، یا {{الگو|نستعلیق}} را تغییر دهید یا در {{الگو|شعر}} بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|سبک=font-family: Vazirmatn, serif}}&lt;/nowiki&gt;&lt;/code&gt;.
* قلم‌ها باید روی دستگاه خواننده نصب باشند (وب‌قلم بارگذاری نمی‌شود)؛ اگر نیستند، قلم پیش‌فرض نمایش داده می‌شود.
* اگر نستعلیق اعمال نمی‌شود: (۱) صفحهٔ شیوه‌نامهٔ شعر ([[الگو:شعر/styles.css]]) باید ساخته و از نوع «Sanitized CSS» باشد؛ (۲) قلم روی دستگاه نصب باشد؛ (۳) در &lt;code&gt;Common.css&lt;/code&gt; یا ابزارکی قاعدهٔ &lt;code&gt;!important&lt;/code&gt; برای &lt;code&gt;td&lt;/code&gt; یا &lt;code&gt;.nastaliq&lt;/code&gt; نباشد؛ (۴) اگر نوشته درشت‌تر از انتظار است، اندازهٔ قلم را در {{الگو|نستعلیق}} تنظیم کنید و قاعده‌های تکراریِ &lt;code&gt;.nastaliq&lt;/code&gt; را از &lt;code&gt;Common.css&lt;/code&gt; بردارید.

== پانویس ==
می‌توان در پایان یک مصراع پانویس (&lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt;) گذاشت. نشانهٔ پانویس از متن مصراع جدا می‌شود و بیرون از لبهٔ پایانی آویزان می‌ماند، پس در عرض و ترازبندی مصراع شمرده نمی‌شود و همهٔ مصراع‌ها هم‌اندازه می‌مانند:
&lt;pre&gt;
{{بیت|مصراع نخست&lt;ref&gt;منبع&lt;/ref&gt;|مصراع دوم}}
&lt;/pre&gt;
فقط پانویسی که در '''پایان''' مصراع باشد این‌گونه جدا می‌شود؛ پانویس میانهٔ مصراع همان‌جا می‌ماند.

== سبک، کلاس، شناسه، زبان و جهت ==
* اگر می‌خواهید برای شعر سبک اضافه‌ای به کار بگیرید از &lt;code&gt;سبک&lt;/code&gt; در {{الگو|شعر}} استفاده کنید:
*:برای رنگ پشت‌زمینهٔ دلخواه &lt;nowiki&gt;{{شعر|سبک=background: blue}}&lt;/nowiki&gt;
*:رنگ دلخواه برای متن &lt;nowiki&gt;{{شعر|سبک=color: white}}&lt;/nowiki&gt;
*:برای قرار نگرفتن در وسط &lt;nowiki&gt;{{شعر|سبک=margin: 0}}&lt;/nowiki&gt;
نمونه‌ای از ترکیب هر سه:{{سخ}}
&lt;pre&gt;
{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;

{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}

* در {{الگو|بیت}}، {{الگو|مصراع}} و… پارامتر &lt;code&gt;سبک&lt;/code&gt; روی خودِ مصراع‌ها اثر می‌گذارد (مثلاً برجسته‌کردن یک بیت: &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|سبک=font-weight:bold}}&lt;/nowiki&gt;&lt;/code&gt;). در {{الگو|شعر}} روی قاب بیرونی شعر می‌نشیند (پس &lt;code&gt;margin: 0&lt;/code&gt; شعر را به راست می‌برد).
* &lt;code&gt;کلاس&lt;/code&gt; یک کلاس CSS به شعر (در {{الگو|شعر}}) یا به همان ردیف (در بقیه) می‌افزاید؛ &lt;code&gt;شناسه&lt;/code&gt; به ردیف یک &lt;code&gt;id&lt;/code&gt; می‌دهد تا بتوان به آن بیت پیوند داد (مثلاً &lt;code&gt;[[#ب۱۲]]&lt;/code&gt; برای &lt;code&gt;شناسه=ب۱۲&lt;/code&gt;).
* &lt;code&gt;زبان&lt;/code&gt; (مثل &lt;code&gt;ar&lt;/code&gt;) در {{الگو|شعر}} برای ابیات عربی، انگلیسی و… است؛ &lt;code&gt;جهت&lt;/code&gt; (&lt;code&gt;rtl&lt;/code&gt; یا &lt;code&gt;ltr&lt;/code&gt;) در صورت ندادن، از زبان حدس زده می‌شود.
&lt;pre&gt;
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}

== حالت «متن» ==
به‌جای نوشتن یک‌به‌یک {{الگو|بیت}}ها می‌توانید مصراع‌ها را خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; بنویسید. در این حالت نیازی به {{الگو|پایان شعر}} نیست و همهٔ گزینه‌های {{الگو|شعر}} (عرض، ترازبندی، نستعلیق، شماره‌گذاری، …) به کار می‌آید.
&lt;pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
&lt;/pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
* هر دو خط پیاپی یک بیت می‌شوند. '''خط خالی = پایان بند''' (یک فاصله؛ اندازه‌اش با &lt;code&gt;فاصله=0.5em&lt;/code&gt; تنظیم می‌شود، و نمادش با &lt;code&gt;جداکننده بند&lt;/code&gt; یا &lt;code&gt;@نماد&lt;/code&gt;؛ بخش «بندها»). چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند. اگر شمار خط‌های یک بند فرد باشد، خط آخر تنها و وسط‌چین می‌آید.
* &lt;code&gt;نوع&lt;/code&gt;: &lt;code&gt;بیت&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;بیت۱&lt;/code&gt; (پلکانی)، &lt;code&gt;بیت نردبانی&lt;/code&gt;، یا &lt;code&gt;مصراع&lt;/code&gt; (هر خط یک مصراع جداگانه؛ شعر نو). برای پلکانی و نردبانی &lt;code&gt;تورفتگی&lt;/code&gt; را هم می‌توان داد، و &lt;code&gt;ترازبندی&lt;/code&gt; و &lt;code&gt;عرض&lt;/code&gt; برای همهٔ ردیف‌ها.
* با &lt;code&gt;نوع=مصراع&lt;/code&gt; هر &lt;code&gt;:&lt;/code&gt; ابتدای خط یک پله تورفتگی (&lt;code&gt;واحد تورفتگی&lt;/code&gt;، پیش‌فرض &lt;code&gt;1.5em&lt;/code&gt;) می‌دهد و ترازِ پیش‌فرض راست است؛ &lt;code&gt;تراز&lt;/code&gt; را می‌توانید عوض کنید.
* در &lt;code&gt;متن&lt;/code&gt; فقط متن ساده بنویسید (پیوند و پانویس مشکلی ندارند)؛ الگوهای {{الگو|بیت}} و {{الگو|مصراع}} را داخل آن نگذارید. علامت &lt;code&gt;=&lt;/code&gt; در متن مشکلی ندارد، ولی &lt;code&gt;|&lt;/code&gt; را با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید. این حالت ساختار الگو را کامل و بسته نگه می‌دارد و برای ویرایش دیداری هم مناسب‌تر است.

=== شعر نو در حالت «متن» ===
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;pre&gt;
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;/pre&gt;

=== عوض‌کردن نوع ردیف در میانهٔ متن (خط‌های &lt;code&gt;@&lt;/code&gt;) ===
نوع پیش‌فرض را &lt;code&gt;نوع=&lt;/code&gt; مشخص می‌کند. اگر می‌خواهید در میانهٔ همان متن چند بیت نردبانی یا پلکانی یا یک مصراع تنها بیاید، یک '''خط جداگانه''' بنویسید که با &lt;code&gt;@&lt;/code&gt; آغاز شود؛ از آن خط به بعد نوعِ جدید برقرار است تا خط &lt;code&gt;@&lt;/code&gt; بعدی:
{| class=&quot;wikitable&quot;
! خط !! نوع ردیف‌های بعدی
|-
| &lt;code&gt;@بیت&lt;/code&gt; || بیت دومصراعی (دو ستون)
|-
| &lt;code&gt;@بیت۱&lt;/code&gt; (یا &lt;code&gt;@پلکانی&lt;/code&gt;، &lt;code&gt;@ضربدری&lt;/code&gt;) || بیت پلکانی
|-
| &lt;code&gt;@بیت نردبانی&lt;/code&gt; (یا &lt;code&gt;@نردبانی&lt;/code&gt;) || بیت نردبانی
|-
| &lt;code&gt;@مصراع&lt;/code&gt; (یا &lt;code&gt;@نو&lt;/code&gt;، &lt;code&gt;@نیمایی&lt;/code&gt;، &lt;code&gt;@آزاد&lt;/code&gt;) || هر خط یک مصراع جدا
|}
گزینه‌ها را می‌توان پس از نوع نوشت: &lt;code&gt;تورفتگی=&lt;/code&gt;، &lt;code&gt;تراز=&lt;/code&gt; (برای مصراع) و &lt;code&gt;ترازبندی=&lt;/code&gt;؛ مثلاً &lt;code&gt;@بیت۱ تورفتگی=10%&lt;/code&gt; یا &lt;code&gt;@مصراع تراز=وسط&lt;/code&gt;. (مقدارِ هر گزینه نباید فاصله داشته باشد.)
&lt;pre&gt;
{{شعر|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
&lt;/pre&gt;
{{شعر|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
* هر خط &lt;code&gt;@&lt;/code&gt; گزینه‌های پیشین را کنار می‌گذارد و به پیش‌فرض‌های {{الگو|شعر}} برمی‌گردد (گزینه‌ها جمع نمی‌شوند)؛ پس &lt;code&gt;@بیت۱&lt;/code&gt; بدون گزینه، تورفتگی پیش‌فرض خودِ شعر را دارد.
* خط &lt;code&gt;@&lt;/code&gt; جفت‌شدنِ خط‌ها را قطع می‌کند: اگر پیش از آن خطی تنها مانده باشد، همان‌جا به‌صورت مصراع تنها (وسط‌چین) درمی‌آید. فاصلهٔ بند نمی‌گذارد (برای آن خط خالی بگذارید).
* در شعرِ &lt;code&gt;نوع=بیت&lt;/code&gt;، مصراع‌هایی که با &lt;code&gt;@مصراع&lt;/code&gt; می‌آیند شماره‌گذاری خودکار را نمی‌شمارند؛ در شعرِ &lt;code&gt;نوع=مصراع&lt;/code&gt; همهٔ خط‌ها (و بیت‌های &lt;code&gt;@بیت&lt;/code&gt;) شمرده می‌شوند.
* &lt;code&gt;@مصراع&lt;/code&gt; مانند &lt;code&gt;نوع=مصراع&lt;/code&gt; به‌طور پیش‌فرض راست‌چین است؛ برای وسط‌چین &lt;code&gt;تراز=وسط&lt;/code&gt; بدهید.
* خط &lt;code&gt;@&lt;/code&gt; می‌تواند خط نخست متن باشد. فاصلهٔ پس از &lt;code&gt;@&lt;/code&gt; مهم نیست. نوع یا گزینهٔ ناشناخته نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* دو خطِ ویژهٔ &lt;code&gt;@نماد&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; نوع ردیف را عوض نمی‌کنند؛ آن‌ها بریدگیِ میان بندها را می‌سازند (بخش «نماد و فاصله در حالت «متن»»).
* خط &lt;code&gt;@&lt;/code&gt; با شعر چندصفحه‌ای هم کار می‌کند (ادغام ردیف ناتمام به نوعِ ردیف آخر/نخست وابسته است).

=== نشانه‌های درون‌خطی در حالت متن ===
(برگرفته از الگوی ppoem)
{| class=&quot;wikitable&quot;
! نشانه !! کاربرد
|-
| &lt;code&gt;&amp;gt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، راست‌چین
|-
| &lt;code&gt;&amp;lt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، وسط‌چین
|-
| &lt;code&gt;۱۲ &amp;lt;&amp;lt;&amp;lt; متن&lt;/code&gt; || شمارهٔ سمت راست (مانند &lt;code&gt;ش=۱۲&lt;/code&gt;)
|-
| &lt;code&gt;متن &amp;gt;&amp;gt;&amp;gt; ۱۲&lt;/code&gt; || شمارهٔ سمت چپ (مانند &lt;code&gt;شچ=۱۲&lt;/code&gt;)
|}
نشانه‌های شماره روی هر یک از دو خطِ یک بیت هم کار می‌کنند، و نشانه‌های تراز روی خطِ تنها و مصراع‌های شعر نو:
&lt;pre&gt;
{{شعر|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}
&lt;/pre&gt;
{{شعر|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}

== شعر چندصفحه‌ای (ویژهٔ ویکی‌نبشته) ==
وقتی شعر در چند «صفحه:» ادامه دارد، دو خواسته داریم: در پیش‌نمایش هر صفحه شعر کامل و بسته دیده شود، و در صفحهٔ اصلی (که صفحه‌ها با &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; درج می‌شوند) همهٔ صفحه‌ها یک جدول واحد باشند تا ستون‌ها در مرز صفحه جابه‌جا نشوند. پارامتر &lt;code&gt;ادامه&lt;/code&gt; هر دو را برآورده می‌کند:

{| class=&quot;wikitable&quot;
! صفحه !! بالای صفحه !! پایین صفحه
|-
| نخست || &lt;code&gt;&lt;nowiki&gt;{{شعر}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| میانی || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| آخر || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;
|}
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
* در فضای نام «صفحه» &lt;code&gt;ادامه&lt;/code&gt; نادیده گرفته می‌شود و هر صفحه کامل و بسته نمایش داده می‌شود.
* در صفحهٔ اصلی، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; جدول تازه باز نمی‌کند و &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; نمی‌بندد؛ پس صفحه‌ها به هم دوخته می‌شوند. اگر درج از میانهٔ شعر آغاز شود، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; خودش جدول را باز می‌کند.
* '''هم‌ترازی در مرز صفحه:''' چون عرض جدول ثابت است (بخش «چیدمان»)، حتی اگر صفحه‌ای بدون &lt;code&gt;ادامه&lt;/code&gt; باشد و جدول جدا بسازد، قاب شعر با صفحهٔ قبل هم‌اندازه و هم‌تراز می‌ماند؛ گزینه‌های &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بنویسید.
* گزینه‌های {{الگو|شعر}} (نستعلیق، عرض، سبک، شماره‌گذاری، جداکننده بند و…) را در هر صفحه تکرار کنید تا پیش‌نمایش درست باشد؛ در صفحهٔ اصلی فقط گزینه‌های صفحهٔ نخست اثر دارد و شماره‌گذاری خودکار از صفحهٔ قبل ادامه می‌یابد.
* اگر فقط بخشی از صفحه‌ها را درج می‌کنید و شعر در آخرین صفحهٔ درج‌شده تمام نمی‌شود، بعد از &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; بنویسید &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;.
* این الگوها در صفحهٔ اصلی بدون پارامتر &lt;code&gt;ادامه&lt;/code&gt; همان‌طور که بود کار می‌کنند.

=== مصراع (یا بیت) ناتمام در پایان صفحه ===
گاهی مصراعی در پایان صفحه ناتمام می‌ماند و در صفحهٔ بعد ادامه دارد (یا مصراع دوم یک بیت به صفحهٔ بعد می‌رود). در ردیفِ آخرِ صفحه &lt;code&gt;ناتمام=بله&lt;/code&gt; و در نخستین ردیفِ صفحهٔ بعد &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید؛ در صفحهٔ اصلی این دو ردیف مصراع‌به‌مصراع یکی می‌شوند:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه در صفحهٔ اصلی (دو نیمه پشت سر هم نوشته شده‌اند و یک شعر می‌سازند):
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}

* '''بیتی که میان دو مصراع بریده شده:''' در صفحهٔ اول فقط مصراع نخست را بنویسید و در صفحهٔ بعد مصراع اول را تهی بگذارید:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت||واندر آن ظلمت شب آب حیاتم دادند|دنباله=بله}}
{{پایان شعر}}
&lt;/pre&gt;
* '''اتصال:''' دو تکه به‌طور پیش‌فرض با فاصله به هم می‌چسبند. برای واژهٔ بریده &lt;code&gt;اتصال=چسبیده&lt;/code&gt; و برای «می‌/رود» &lt;code&gt;اتصال=نیم‌فاصله&lt;/code&gt; را در ردیفِ &lt;code&gt;دنباله&lt;/code&gt; بدهید.
* ردیف‌های {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}} و {{الگو|مصراع}} هر کدام جداگانه ادغام می‌شوند؛ دو تکه باید از یک نوع الگو باشند.
* هر ردیف در شماره‌گذاری خودکار یک بار شمرده می‌شود و شماره‌ها را می‌توان در هر دو تکه داد (تکهٔ بعدی مقدم است).
* در فضای نام «صفحه» ردیفِ ناتمام با خط‌چین نشان داده می‌شود. ردیفی که ادامه‌اش هرگز نیاید همان‌طور که هست نمایش داده می‌شود و متنی گم نمی‌شود.
* ادغام به این تکیه دارد که الگوها در یک رندر به ترتیب اجرا شوند. اگر روزی در جایی متنِ ردیف ناتمام گم شد، مدیر پودمان می‌تواند &lt;code&gt;cfg.mergeRows = false&lt;/code&gt; کند: آن‌گاه هر تکه فوراً و به‌صورت ردیفِ جدا نمایش داده می‌شود.

=== شعر چندصفحه‌ای در حالت «متن» ===
در حالت &lt;code&gt;متن&lt;/code&gt; هر صفحه یک فراخوانی است: &lt;code&gt;ادامه=بعد&lt;/code&gt; (صفحهٔ نخست)، &lt;code&gt;ادامه=هر دو&lt;/code&gt; (میانی)، &lt;code&gt;ادامه=قبل&lt;/code&gt; (آخر)؛ و برای مصراع ناتمام &lt;code&gt;ناتمام=بله&lt;/code&gt; / &lt;code&gt;دنباله=بله&lt;/code&gt; (با &lt;code&gt;اتصال&lt;/code&gt;). در حالت متن «ادامه=بله» مبهم است و پذیرفته نمی‌شود.
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر|ادامه=بعد|ناتمام=بله|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
بیخود از شعشعهٔ پرتو
باده از جام تجلی
}}
──── صفحهٔ ۲ ────
{{شعر|ادامه=قبل|دنباله=بله|متن=
ذاتم کردند
صفاتم دادند
}}
&lt;/pre&gt;
* اگر آخرین خطِ ناتمامِ صفحه فرد باشد، بیتی با مصراع نخست می‌شود و خط اول صفحهٔ بعد به‌طور خودکار مصراع دومِ همان بیت است؛ با &lt;code&gt;دنباله=اول&lt;/code&gt; یا &lt;code&gt;دنباله=دوم&lt;/code&gt; می‌توانید صریح بگویید کدام مصراع ادامه دارد.
* &lt;code&gt;بند=جدید&lt;/code&gt; در صفحهٔ ادامه، پیش از نخستین ردیف یک فاصلهٔ بند (یا ردیفِ نماد، اگر شعر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) می‌گذارد.

== نمایش در صفحه‌های باریک ==
مصراع‌های کنار هم در پنجرهٔ باریک جا نمی‌شوند؛ پس پیش‌فرض، شعر در پنجرهٔ باریک (تا حدود ۸۳۲ پیکسل) '''ستونی''' می‌شود: برای هر بیت شماره بالا، دو مصراع وسط‌چین زیر هم، و یک خط‌چین پس از آن (در بیت پلکانی پس از خط دوم). نمادِ میان دو مصراع و نسخهٔ نامرئیِ اندازه‌گیر پنهان می‌شوند؛ ردیفِ نمادِ میان بندها همچنان دیده می‌شود. در پنجره‌های کمی عریض‌تر، فاصلهٔ واژه‌ها در شعر دوطرفه اندکی کم می‌شود تا مصراع‌ها هنوز در یک خط جا شوند.
{| class=&quot;wikitable&quot;
! &lt;code&gt;تلفن=&lt;/code&gt; !! رفتار
|-
| &lt;code&gt;ستونی&lt;/code&gt; (پیش‌فرض) || در پنجرهٔ باریک ستونی؛ در پنجرهٔ عریض دوستونه.
|-
| &lt;code&gt;دوستونه&lt;/code&gt; || همیشه دوستونه؛ در پنجرهٔ بسیار باریک (تا ۴۸۰ پیکسل) فاصله‌ها کمتر می‌شود تا جا برای متن بماند.
|-
| &lt;code&gt;همیشه&lt;/code&gt; || همیشه ستونی، حتی در پنجرهٔ عریض.
|}

=== فضای نام «صفحه» ===
در «صفحه:» تصویر کنار متن است و ستونِ متن حدود نیمی از پنجره است؛ پس شعر زودتر باید ستونی شود. اما مرورگر پهنای واقعیِ ستونِ متن را به شیوه‌نامه نمی‌دهد (TemplateStyles از ''container query'' پشتیبانی نمی‌کند) و فقط پهنای پنجره در دسترس است. برای این‌که هر شعر نه زودتر از لازم ستونی شود و نه دیرتر، پودمان '''طولِ بلندترین مصراع''' را می‌سنجد و یکی از سه کلاس را روی شعر می‌گذارد؛ هر سطح آستانهٔ خودش را دارد:
{| class=&quot;wikitable&quot;
! سطح (کلاس) !! بلندترین مصراع !! فشرده‌شدن (فاصله‌ها کم می‌شود) !! ستونی‌شدن
|-
| کوتاه (&lt;code&gt;poem-w1&lt;/code&gt;) || تا ۲۰ نویسه || پنجرهٔ ≤ ۸۶em (۱۳۷۶px) || پنجرهٔ ≤ ۷۶em (۱۲۱۶px)
|-
| متوسط (&lt;code&gt;poem-w2&lt;/code&gt;) || تا ۳۰ نویسه || پنجرهٔ ≤ ۱۰۶em (۱۶۹۶px) || پنجرهٔ ≤ ۹۶em (۱۵۳۶px)
|-
| بلند (&lt;code&gt;poem-w3&lt;/code&gt;) || بیشتر از ۳۰ نویسه || پنجرهٔ ≤ ۱۲۶em (۲۰۱۶px) || پنجرهٔ ≤ ۱۱۶em (۱۸۵۶px)
|}
* '''فشرده‌شدن:''' پیش از ستونی‌شدن، فاصلهٔ دو مصراع از ≈ ۵٫۹em به ≈ ۳٫۴em می‌رسد (هنوز فاصلهٔ معقول) و ستون‌های شماره باریک می‌شوند؛ مصراع‌ها دست‌نخورده می‌مانند. بالاتر از آستانهٔ فشرده‌شدن، شعر با فاصله‌های عادی و دوستونه نمایش داده می‌شود.
* در حالت &lt;code&gt;متن&lt;/code&gt; سطح به‌طور خودکار از روی طول مصراع‌ها تعیین می‌شود. در حالت الگو (مصراع‌ها بعداً می‌رسند) پیش‌فرض «متوسط» است؛ برای شعرِ کوتاه‌مصراع بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=کوتاه}}&lt;/nowiki&gt;&lt;/code&gt; و برای شعرِ بلندمصراع &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=بلند}}&lt;/nowiki&gt;&lt;/code&gt; (یا شمار نویسهٔ بلندترین مصراع، مثلاً &lt;code&gt;طول مصراع=24&lt;/code&gt;).
* '''پایهٔ حساب:''' هر نویسه ≈ ۰٫۵em؛ جدولِ فشرده ≈ (نویسه + ۸٫۴)em و جدولِ عادی ≈ (نویسه + ۱۳٫۹)em پهنا می‌خواهد؛ ستونِ متن ≈ نیمی از پنجره منهای ۹em فرض شده (em در media query همیشه ۱۶px است). اگر قلمِ صفحه درشت‌تر است، عددها را در [[الگو:شعر/styles.css]] بالا ببرید.
* اگر پنجرهٔ «صفحه:»ی شما عمودی است (تصویر بالای متن) و ستونِ متن پهن است، برای آن شعر &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید تا هرگز ستونی نشود.
* پس از به‌روزرسانی پودمان، صفحه‌های «صفحه:»ی قدیمی با یک ویرایش تهی (null edit) یا پاک‌سازی (purge) کلاس سطح را می‌گیرند؛ تا آن زمان به‌عنوان «متوسط» رفتار می‌کنند.

== رده‌های پیگیری و خطاها ==
فقط در صفحه‌های اصلی و فضای نام «صفحه» (نه در الگو و پودمان):
* [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] — پارامتر یا مقدار نادرست (عرض، ترازبندی، نماد، خط &lt;code&gt;@&lt;/code&gt; ناشناخته، …)، مصراع اضافه، «=» در مصراع، یا ادامهٔ ناسازگار.
* [[:رده:صفحه‌های دارای بیت ناقص]] — بیتی که فقط یک مصراع دارد (به‌جز ردیف‌های ناتمام/دنباله).
* [[:رده:صفحه‌های دارای خطا در پودمان شعر]] — خطای پیش‌بینی‌نشده (به‌جای شکستن صفحه، پیام قرمز نشان داده می‌شود).

== پرسش‌های رایج ==
{| class=&quot;wikitable&quot;
! مشکل !! راه‌حل
|-
| آغاز شعر در مرز دو صفحه جابه‌جا می‌شود || &lt;code&gt;عرض&lt;/code&gt;/&lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بگذارید (یا ندهید: پیش‌فرض ثابت است) و صفحه‌ها را با &lt;code&gt;ادامه&lt;/code&gt; بدوزید.
|-
| در «صفحه:» شعر زیر هم (ستونی) نمایش داده می‌شود || بخش «فضای نام «صفحه»»: آستانه به طول مصراع بستگی دارد؛ برای شعرِ کوتاه‌مصراع &lt;code&gt;طول مصراع=کوتاه&lt;/code&gt;، و برای هرگز-ستونی‌نشدن &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید.
|-
| مصراع‌ها بیش از اندازه می‌شکنند || &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید؛ یا &lt;code&gt;عرض=خودکار&lt;/code&gt;.
|-
| نماد میان بندها نمی‌آید || در حالت الگو، الگوی {{الگو|جداکننده بند}} باید ساخته شده باشد (متنش &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|divider}}&lt;/nowiki&gt;&lt;/code&gt;) یا از &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=• • •}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید. در حالت «متن» خط &lt;code&gt;@نماد&lt;/code&gt; باید خطی جدا باشد و &lt;code&gt;جداکننده بند&lt;/code&gt; فقط جای خط‌های خالی را می‌گیرد.
|-
| چند خط خالی فاصلهٔ بزرگ‌تر نمی‌دهد || چند خط خالیِ پشت‌سرهم عمداً یک فاصله‌اند؛ برای فاصلهٔ بزرگ‌تر &lt;code&gt;@فاصله&lt;/code&gt; (یا &lt;code&gt;@فاصله 3em&lt;/code&gt;) بنویسید.
|-
| نستعلیق اعمال نمی‌شود || بخش «نستعلیق»، فهرست بررسی (۱) تا (۴).
|-
| &lt;code&gt;قلم=&lt;/code&gt; کار نمی‌کند || چنین پارامتری وجود ندارد (صفحه به ردهٔ پارامتر ناشناخته می‌رود). قلم را {{الگو|نستعلیق}} تعیین می‌کند، یا &lt;code&gt;سبک=font-family: …&lt;/code&gt; بدهید.
|-
| می‌خواهم یک بیتِ پلکانی وسط شعرِ دومصراعی بیاورم || در حالت متن خط &lt;code&gt;@بیت۱&lt;/code&gt; و بعد &lt;code&gt;@بیت&lt;/code&gt;؛ یا در حالت الگو، {{الگو|بیت۱}}.
|-
| شماره‌گذاری در صفحهٔ دوم از نو شروع می‌شود || در «صفحه:» طبیعی است (از &lt;code&gt;شروع&lt;/code&gt; می‌گیرد)؛ در صفحهٔ اصلی با &lt;code&gt;ادامه&lt;/code&gt; ادامه می‌یابد.
|-
| متن ردیف ناتمام نمایش داده نمی‌شود || صفحهٔ بعد را با &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید و درج کنید؛ یا {{الگو|پایان شعر}} بگذارید. اگر باز هم نشد: &lt;code&gt;cfg.mergeRows = false&lt;/code&gt;.
|-
| صفحه به ردهٔ «پارامتر ناشناخته» رفت || نام پارامتر یا مقدارش را بررسی کنید؛ «=» یا «|» در مصراع (از &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید)؛ مصراع سوم؛ یا نمادی که &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; دارد.
|-
| پیام قرمز «خطا در پودمان شعر» || پارامترها را بررسی کنید و خطا را در [[بحث پودمان:شعر]] گزارش کنید؛ صفحه نمی‌شکند.
|}

== نکات فنی ==
=== ساختار خروجی ===
هر شعر یک &lt;code&gt;div&lt;/code&gt; با یک جدول است؛ هر سطرِ جدول ۷ ستونی است (شماره | مصراع ۱ (۲ ستون) | شمارهٔ میانی | مصراع ۲ (۲ ستون) | شماره). در چیدمان ثابت یک ردیف نامرئی &lt;code&gt;.poem-sizer&lt;/code&gt; ستون‌ها را تعیین می‌کند؛ با &lt;code&gt;عرض=خودکار&lt;/code&gt; جدول بدون آن و بدون &lt;code&gt;.poem-fixed&lt;/code&gt; ساخته می‌شود.
&lt;pre&gt;
&lt;div class=&quot;poem poem-fixed poem-stack&quot; style=&quot;width:100%;max-width:50em;margin:0 auto&quot;&gt;
 &lt;table class=&quot;poem-table&quot; role=&quot;presentation&quot; style=&quot;width:100%;table-layout:fixed&quot;&gt;
  &lt;tr class=&quot;poem-sizer&quot;&gt; … ۷ سلول … &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-bayt&quot;&gt;
   &lt;td class=&quot;poem-num poem-num-r&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m1 poem-a-end&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۱&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-c&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m2 poem-a-start&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۲&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-l&quot;&gt;&lt;/td&gt;
  &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-ornament&quot;&gt;&lt;td class=&quot;poem-ornament-cell&quot; colspan=&quot;7&quot;&gt;• • •&lt;/td&gt;&lt;/tr&gt;
 &lt;/table&gt;
&lt;/div&gt;
&lt;/pre&gt;

=== کلاس‌های CSS ===
{| class=&quot;wikitable&quot;
! کلاس !! روی چه !! کار
|-
| &lt;code&gt;poem&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; بیرونی || قاب شعر
|-
| &lt;code&gt;poem-fixed&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || چیدمان ثابت (جدول با ردیف اندازه‌گیر)
|-
| &lt;code&gt;poem-stack&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || امکان ستونی‌شدن در صفحهٔ باریک (نبود آن = &lt;code&gt;تلفن=دوستونه&lt;/code&gt;)
|-
| &lt;code&gt;poem-stack-always&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || همیشه ستونی (&lt;code&gt;تلفن=همیشه&lt;/code&gt;)
|-
| &lt;code&gt;poem-just&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || ترازبندی پهن در کل شعر
|-
| &lt;code&gt;poem-page&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || شعر در فضای نام «صفحه»
|-
| &lt;code&gt;poem-w1&lt;/code&gt;، &lt;code&gt;poem-w2&lt;/code&gt;، &lt;code&gt;poem-w3&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; (فقط فضای نام «صفحه») || طول مصراع: کوتاه، متوسط، بلند
|-
| &lt;code&gt;poem-table&lt;/code&gt;، &lt;code&gt;nastaliq&lt;/code&gt; || &lt;code&gt;table&lt;/code&gt; || جدول؛ کلاس نستعلیق
|-
| &lt;code&gt;poem-sizer&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئیِ تعیین‌کنندهٔ ستون‌ها (فقط چیدمان ثابت)
|-
| &lt;code&gt;poem-row&lt;/code&gt; + &lt;code&gt;poem-bayt&lt;/code&gt; / &lt;code&gt;poem-stagger&lt;/code&gt; (و &lt;code&gt;-1&lt;/code&gt;، &lt;code&gt;-2&lt;/code&gt;) / &lt;code&gt;poem-mesra&lt;/code&gt; / &lt;code&gt;poem-gap&lt;/code&gt; / &lt;code&gt;poem-ornament&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || نوع ردیف
|-
| &lt;code&gt;poem-skip&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئی که جای «ادامه» می‌نشیند (تا خط خالی و &lt;code&gt;&amp;lt;p&amp;gt;&lt;/code&gt; پدید نیاید)
|-
| &lt;code&gt;poem-partial-end&lt;/code&gt;، &lt;code&gt;poem-partial-start&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیفِ ناتمام/دنباله در پیش‌نمایش «صفحه:» (خط‌چین)
|-
| &lt;code&gt;poem-num&lt;/code&gt; (و &lt;code&gt;-r&lt;/code&gt;، &lt;code&gt;-c&lt;/code&gt;، &lt;code&gt;-l&lt;/code&gt;) || &lt;code&gt;td&lt;/code&gt; || ستون‌های شماره
|-
| &lt;code&gt;b&lt;/code&gt;، &lt;code&gt;poem-m&lt;/code&gt;، &lt;code&gt;poem-m1&lt;/code&gt;، &lt;code&gt;poem-m2&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول مصراع (&lt;code&gt;b&lt;/code&gt; و &lt;code&gt;beyt&lt;/code&gt; برای سازگاری با شیوه‌های قدیمی حفظ شده‌اند)
|-
| &lt;code&gt;poem-a-start&lt;/code&gt;، &lt;code&gt;poem-a-end&lt;/code&gt;، &lt;code&gt;poem-a-right&lt;/code&gt;، &lt;code&gt;poem-a-left&lt;/code&gt;، &lt;code&gt;poem-a-justify&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || ترازبندی مصراع
|-
| &lt;code&gt;poem-m-right&lt;/code&gt;، &lt;code&gt;poem-m-left&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || مصراع تنها با تراز راست/چپ
|-
| &lt;code&gt;beyt&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || متن مصراع
|-
| &lt;code&gt;poem-ref&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || پانویسِ آویزان در پایان مصراع
|-
| &lt;code&gt;poem-sz&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نسخهٔ نامرئیِ اندازه‌گیر (ترازبندی پهن)
|-
| &lt;code&gt;poem-sep&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نمادِ میان دو مصراع
|-
| &lt;code&gt;poem-ornament-cell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیفِ نمادِ میان بندها
|-
| &lt;code&gt;poem-gapcell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیف فاصله
|-
| &lt;code&gt;poem-st&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || جعبهٔ هر خط در بیت پلکانیِ تورفتگی‌دار (چیدمان ثابت)
|-
| &lt;code&gt;poem-indent&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول فاصله‌گذار در بیت پلکانیِ تورفتگی‌دار (چیدمان خودکار)
|-
| &lt;code&gt;poem-s&lt;/code&gt;، &lt;code&gt;poem-g&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; در &lt;code&gt;.poem-sizer&lt;/code&gt; || ستون کناری و ستون میانی
|}

=== شیوه‌نامه ===
اندازه‌ها در [[الگو:شعر/styles.css]] تعریف شده‌اند (نشانی شیوه‌نامه را مدیر پودمان با &lt;code&gt;cfg.styles&lt;/code&gt; تعیین می‌کند):
{| class=&quot;wikitable&quot;
! انتخابگر !! مقدار !! کار
|-
| &lt;code&gt;.poem-g&lt;/code&gt; || &lt;code&gt;4.7em&lt;/code&gt; || ستون میانیِ چیدمان ثابت
|-
| &lt;code&gt;.poem-s&lt;/code&gt; || &lt;code&gt;3.4em&lt;/code&gt; || ستون‌های کناریِ چیدمان ثابت
|-
| &lt;code&gt;.poem-m&lt;/code&gt; || &lt;code&gt;0.6em&lt;/code&gt; || حاشیهٔ درونیِ هر مصراع (چپ و راست)
|-
| &lt;code&gt;.poem-num-c&lt;/code&gt; || &lt;code&gt;5.5em&lt;/code&gt; || ستون میانی در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num-r&lt;/code&gt;، &lt;code&gt;.poem-num-l&lt;/code&gt; || &lt;code&gt;4em&lt;/code&gt; || ستون‌های کناری در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num&lt;/code&gt; || &lt;code&gt;85%&lt;/code&gt; || اندازهٔ شماره‌ها
|-
| &lt;code&gt;.poem-sep&lt;/code&gt; || &lt;code&gt;#b3362b&lt;/code&gt;، &lt;code&gt;90%&lt;/code&gt; || رنگ و اندازهٔ نمادِ میان دو مصراع
|-
| &lt;code&gt;.poem-ornament-cell&lt;/code&gt; || پررنگ || ردیفِ نمادِ میان بندها
|}
فاصلهٔ دو مصراع در حالت عادی ≈ ۴٫۷em + ۲×۰٫۶em ≈ ۵٫۹em است. آستانه‌های ستونی‌شدن (۵۲em برای صفحهٔ اصلی، و جدول بخش «فضای نام «صفحه»») و اندازه‌های حالت فشرده نیز همان‌جا و با توضیح آمده‌اند.

=== تنظیمات پودمان (&lt;code&gt;cfg&lt;/code&gt;) ===
مدیران پودمان می‌توانند پیش‌فرض‌ها را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند:
{| class=&quot;wikitable&quot;
! کلید !! پیش‌فرض !! کار
|-
| &lt;code&gt;styles&lt;/code&gt; || &lt;code&gt;Template:شعر۲/styles.css&lt;/code&gt; || صفحهٔ TemplateStyles
|-
| &lt;code&gt;pageNs&lt;/code&gt; || &lt;code&gt;104&lt;/code&gt; || شمارهٔ فضای نام «صفحه»
|-
| &lt;code&gt;mesraUnit&lt;/code&gt; || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر &lt;code&gt;:&lt;/code&gt; در شعر نو
|-
| &lt;code&gt;defaultWidth&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; || عرض پیش‌فرض؛ &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند
|-
| &lt;code&gt;maxWidth&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض (وقتی عرض داده نشده)
|-
| &lt;code&gt;justDefault&lt;/code&gt; || &lt;code&gt;{ bayt = 'inner', stagger = 'edge' }&lt;/code&gt; || ترازبندی پیش‌فرض هر نوع بیت
|-
| &lt;code&gt;justifyMinRatio&lt;/code&gt; || &lt;code&gt;0.7&lt;/code&gt; || در ترازبندی پهن، کمترین نسبتِ کوتاه‌ترین به بلندترین مصراعِ بیت برای کشیده‌شدن
|-
| &lt;code&gt;nastaliqTemplate&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; || الگوی ویکی که نمای نستعلیق از آن گرفته می‌شود
|-
| &lt;code&gt;nastaliqFonts&lt;/code&gt; || فهرست قلم‌های نستعلیق || آخرین چاره، فقط اگر آن الگو در دسترس نبود
|-
| &lt;code&gt;separator&lt;/code&gt; || &lt;code&gt;''&lt;/code&gt; (بدون نماد) || نمادِ میان دو مصراعِ همهٔ شعرها
|-
| &lt;code&gt;ornament&lt;/code&gt; || &lt;code&gt;❖&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده=بله&lt;/code&gt;
|-
| &lt;code&gt;stanzaOrnament&lt;/code&gt; || &lt;code&gt;• • •&lt;/code&gt; || نمادِ پیش‌فرضِ &lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt; و {{الگو|جداکننده بند}}
|-
| &lt;code&gt;hemiShort&lt;/code&gt;، &lt;code&gt;hemiMedium&lt;/code&gt; || &lt;code&gt;20&lt;/code&gt;، &lt;code&gt;30&lt;/code&gt; || مرزِ طول مصراع (نویسه) برای سطح‌های «کوتاه» و «متوسط» در فضای نام «صفحه»
|-
| &lt;code&gt;mergeRows&lt;/code&gt; || &lt;code&gt;true&lt;/code&gt; || ادغام ردیف ناتمام با دنباله‌اش
|-
| &lt;code&gt;cats&lt;/code&gt; || — || نام رده‌های پیگیری
|}
فهرست &lt;code&gt;nastaliqFonts&lt;/code&gt; باید با فهرست قلم در {{الگو|نستعلیق}} سازگار باشد.

=== ساخت الگوها ===
متن هر الگو یک فراخوانی پودمان است، مثلاً برای الگوی تازهٔ {{الگو|جداکننده بند}}:
&lt;pre&gt;
&lt;includeonly&gt;{{#invoke:شعر|divider}}&lt;/includeonly&gt;&lt;noinclude&gt;{{توضیحات}}&lt;/noinclude&gt;
&lt;/pre&gt;
نقطه‌های ورود: &lt;code&gt;open&lt;/code&gt;، &lt;code&gt;close&lt;/code&gt;، &lt;code&gt;bayt&lt;/code&gt;، &lt;code&gt;stagger&lt;/code&gt;، &lt;code&gt;ladder&lt;/code&gt;، &lt;code&gt;mesra&lt;/code&gt;، &lt;code&gt;emptyBayt&lt;/code&gt;، &lt;code&gt;emptyMesra&lt;/code&gt;، &lt;code&gt;divider&lt;/code&gt;.

=== یادداشت‌های فنی ===
* {{الگو|شعر}} و {{الگو|پایان شعر}} باید هر دو از یک نسخه باشند: &lt;code&gt;&amp;lt;div class=&quot;poem&quot;&amp;gt;&amp;lt;table&amp;gt;&lt;/code&gt; را اولی باز و دومی می‌بندد.
* تشخیص فضای نام «صفحه» بر پایهٔ شمارهٔ ۱۰۴ است (&lt;code&gt;cfg.pageNs&lt;/code&gt;).
* رده‌های پیگیری فقط در صفحهٔ اصلی و فضاهای نام محتوایی سفارشی (مثل «صفحه») افزوده می‌شوند.
* دوختن صفحه‌ها، ادغام ردیف ناتمام و شماره‌گذاری خودکار به این تکیه دارند که الگوها در یک رندر به ترتیب اجرا شوند (رندر کلاسیک MediaWiki و &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; چنین‌اند). در رندرهایی که هر الگو جداگانه بسط داده شود (مثلاً برخی خوانش‌های Parsoid) این سه کار نمی‌کنند؛ شعر همچنان درست و هم‌تراز نمایش داده می‌شود چون قاب ثابت است.
* هر خطای پیش‌بینی‌نشده به‌جای شکستن صفحه، پیامی قرمز و ردهٔ خطا می‌دهد.

== الگوهای مرتبط ==
* [[الگو:بیت]] برای نوشتن بیت‌ها
* [[الگو:بیت۱]] برای بیت‌های پلکانی
* [[الگو:بیت نردبانی]] برای بیت‌های نردبانی
* [[الگو:مصراع]] برای نوشتن تک مصراع‌ها
* [[الگو:بیت خالی]] و [[الگو:مصراع خالی]] برای فاصله
* [[الگو:جداکننده بند]] برای نماد میان بندها
* [[الگو:پایان شعر]] برای تمام کردن الگو
* [[الگو:نستعلیق]] برای نوشتن متن‌های دیگر با خط نستعلیق

== داده‌های الگو ==
&lt;templatedata&gt;
{
  &quot;description&quot;: &quot;آغاز شعر (در حالت «متن»: کل شعر). همهٔ گزینه‌هایی که برای کل شعر اثر دارند اینجا داده می‌شوند.&quot;,
  &quot;params&quot;: {
    &quot;1&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام نخست&quot;,
      &quot;description&quot;: &quot;گزینهٔ بی‌نام: «نستعلیق» نمای نستعلیق را روشن می‌کند؛ «ادامه» یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;2&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام دوم&quot;,
      &quot;description&quot;: &quot;مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;عرض&quot;: {
      &quot;label&quot;: &quot;عرض&quot;,
      &quot;description&quot;: &quot;عرض قاب شعر. عدد بدون واحد پیکسل است. «خودکار» یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط «عرض» بدهید سقف عرض ۱۰۰٪ می‌شود.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;width&quot;
      ]
    },
    &quot;حداکثر عرض&quot;: {
      &quot;label&quot;: &quot;حداکثر عرض&quot;,
      &quot;description&quot;: &quot;سقف عرض قاب (وقتی عرض ثابت است). «بدون» (یا «none»، «نامحدود») یعنی بی‌سقف.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;max-width&quot;
      ]
    },
    &quot;تلفن&quot;: {
      &quot;label&quot;: &quot;رفتار در صفحهٔ باریک&quot;,
      &quot;description&quot;: &quot;«ستونی»: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ «دوستونه»: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ «همیشه»: همیشه ستونی.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;phone&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;ستونی&quot;,
        &quot;دوستونه&quot;,
        &quot;همیشه&quot;
      ]
    },
    &quot;ترازبندی&quot;: {
      &quot;label&quot;: &quot;ترازبندی&quot;,
      &quot;description&quot;: &quot;ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). «میانه»: مصراع‌ها به محور میانی می‌چسبند؛ «لبه»: مصراع نخست به راست و دوم به چپ؛ «پهن»: دوطرفه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;justify&quot;,
        &quot;تراز‌بندی&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;میانه&quot;,
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;,
        &quot;پهن&quot;,
        &quot;لبه&quot;
      ]
    },
    &quot;جداکننده&quot;: {
      &quot;label&quot;: &quot;نماد میان دو مصراع&quot;,
      &quot;description&quot;: &quot;نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی «شو» نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;separator&quot;
      ]
    },
    &quot;جداکننده بند&quot;: {
      &quot;label&quot;: &quot;نماد میان بندها&quot;,
      &quot;description&quot;: &quot;ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت «متن» به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط «@نماد» یا الگوی «جداکننده بند» استفاده کنید.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza-separator&quot;,
        &quot;جداکنندهٔ بند&quot;,
        &quot;نماد بند&quot;
      ]
    },
    &quot;متن&quot;: {
      &quot;label&quot;: &quot;متن شعر&quot;,
      &quot;description&quot;: &quot;کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.&quot;,
      &quot;type&quot;: &quot;content&quot;,
      &quot;aliases&quot;: [
        &quot;text&quot;
      ]
    },
    &quot;نوع&quot;: {
      &quot;label&quot;: &quot;نوع ردیف‌ها&quot;,
      &quot;description&quot;: &quot;نوع پیش‌فرض ردیف‌ها در حالت «متن». با «نوع=مصراع» ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;type&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بیت&quot;,
        &quot;بیت۱&quot;,
        &quot;بیت نردبانی&quot;,
        &quot;مصراع&quot;
      ]
    },
    &quot;تراز&quot;: {
      &quot;label&quot;: &quot;تراز مصراع‌های تنها&quot;,
      &quot;description&quot;: &quot;تراز مصراع‌های تنها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;align&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;
      ]
    },
    &quot;تورفتگی&quot;: {
      &quot;label&quot;: &quot;تورفتگی&quot;,
      &quot;description&quot;: &quot;تورفتگی ردیف‌های پلکانی/نردبانی در حالت «متن». بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent&quot;
      ]
    },
    &quot;واحد تورفتگی&quot;: {
      &quot;label&quot;: &quot;اندازهٔ هر پله&quot;,
      &quot;description&quot;: &quot;اندازهٔ هر «:» در شعر نو («نوع=مصراع»).&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent-unit&quot;,
        &quot;واحد‌تورفتگی&quot;
      ]
    },
    &quot;فاصله&quot;: {
      &quot;label&quot;: &quot;فاصلهٔ میان بندها&quot;,
      &quot;description&quot;: &quot;ارتفاع فاصلهٔ میان بندها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;gap&quot;
      ]
    },
    &quot;بند&quot;: {
      &quot;label&quot;: &quot;بند تازه&quot;,
      &quot;description&quot;: &quot;در حالت «متن» و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ «جداکننده بند») می‌گذارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;جدید&quot;
      ]
    },
    &quot;شماره‌گذاری&quot;: {
      &quot;label&quot;: &quot;شماره‌گذاری خودکار&quot;,
      &quot;description&quot;: &quot;«بله»: شمارهٔ همهٔ ابیات؛ یک عدد مثل «5»: هر پنجمین بیت؛ «نه» (یا «0»): خاموش.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;numbering&quot;,
        &quot;شماره&quot;,
        &quot;شمارهگذاری&quot;
      ]
    },
    &quot;شروع&quot;: {
      &quot;label&quot;: &quot;شمارهٔ نخست&quot;,
      &quot;description&quot;: &quot;شمارهٔ بیت نخست.&quot;,
      &quot;type&quot;: &quot;number&quot;,
      &quot;aliases&quot;: [
        &quot;start&quot;
      ]
    },
    &quot;سمت&quot;: {
      &quot;label&quot;: &quot;سمت شماره&quot;,
      &quot;description&quot;: &quot;سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) «وسط» همان «چپ» است.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;side&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;چپ&quot;,
        &quot;راست&quot;,
        &quot;وسط&quot;
      ]
    },
    &quot;ارقام&quot;: {
      &quot;label&quot;: &quot;رقم‌ها&quot;,
      &quot;description&quot;: &quot;تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;digits&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فارسی&quot;,
        &quot;لاتین&quot;,
        &quot;بدون تغییر&quot;
      ]
    },
    &quot;نستعلیق&quot;: {
      &quot;label&quot;: &quot;نمای نستعلیق&quot;,
      &quot;description&quot;: &quot;نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن «نستعلیق» به‌صورت بی‌نام («{{شعر|نستعلیق}}»).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;nastaliq&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;سبک&quot;: {
      &quot;label&quot;: &quot;سبک CSS&quot;,
      &quot;description&quot;: &quot;سبک CSS روی قاب بیرونی شعر (با «عرض=خودکار»: روی جدول).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;style&quot;
      ]
    },
    &quot;کلاس&quot;: {
      &quot;label&quot;: &quot;کلاس CSS&quot;,
      &quot;description&quot;: &quot;کلاسِ افزوده به قاب شعر.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;class&quot;
      ]
    },
    &quot;زبان&quot;: {
      &quot;label&quot;: &quot;زبان&quot;,
      &quot;description&quot;: &quot;برای ابیات غیرفارسی؛ خصوصیت «lang» را می‌گذارد و «جهت» را از آن حدس می‌زند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;lang&quot;
      ]
    },
    &quot;جهت&quot;: {
      &quot;label&quot;: &quot;جهت&quot;,
      &quot;description&quot;: &quot;جهت متن.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;dir&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;rtl&quot;,
        &quot;ltr&quot;
      ]
    },
    &quot;ادامه&quot;: {
      &quot;label&quot;: &quot;ادامه از/به صفحهٔ دیگر&quot;,
      &quot;description&quot;: &quot;شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است («قبل») و/یا در صفحهٔ بعد ادامه دارد («بعد»، فقط حالت «متن»). در حالت «متن»، «ادامه=بله» مبهم است و پذیرفته نمی‌شود.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continue&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;قبل&quot;,
        &quot;بعد&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;ناتمام&quot;: {
      &quot;label&quot;: &quot;ردیف آخر ناتمام&quot;,
      &quot;description&quot;: &quot;حالت «متن»: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;unfinished&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;دنباله&quot;: {
      &quot;label&quot;: &quot;ردیف نخست دنباله&quot;,
      &quot;description&quot;: &quot;حالت «متن»: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. «اول»/«دوم»: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continued&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;اول&quot;,
        &quot;دوم&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;اتصال&quot;: {
      &quot;label&quot;: &quot;نحوهٔ چسباندن&quot;,
      &quot;description&quot;: &quot;نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;join&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فاصله&quot;,
        &quot;چسبیده&quot;,
        &quot;نیم‌فاصله&quot;
      ]
    },
    &quot;طول مصراع&quot;: {
      &quot;label&quot;: &quot;طول مصراع&quot;,
      &quot;description&quot;: &quot;فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع («کوتاه» تا ۲۰ نویسه، «متوسط» تا ۳۰، «بلند» بیشتر؛ یا خودِ شمار نویسه).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;hemistich-length&quot;,
        &quot;طول‌مصراع&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;کوتاه&quot;,
        &quot;متوسط&quot;,
        &quot;بلند&quot;,
        &quot;خودکار&quot;
      ]
    }
  },
  &quot;paramOrder&quot;: [
    &quot;1&quot;,
    &quot;2&quot;,
    &quot;عرض&quot;,
    &quot;حداکثر عرض&quot;,
    &quot;تلفن&quot;,
    &quot;ترازبندی&quot;,
    &quot;جداکننده&quot;,
    &quot;جداکننده بند&quot;,
    &quot;متن&quot;,
    &quot;نوع&quot;,
    &quot;تراز&quot;,
    &quot;تورفتگی&quot;,
    &quot;واحد تورفتگی&quot;,
    &quot;فاصله&quot;,
    &quot;بند&quot;,
    &quot;شماره‌گذاری&quot;,
    &quot;شروع&quot;,
    &quot;سمت&quot;,
    &quot;ارقام&quot;,
    &quot;نستعلیق&quot;,
    &quot;سبک&quot;,
    &quot;کلاس&quot;,
    &quot;زبان&quot;,
    &quot;جهت&quot;,
    &quot;ادامه&quot;,
    &quot;ناتمام&quot;,
    &quot;دنباله&quot;,
    &quot;اتصال&quot;,
    &quot;طول مصراع&quot;
  ]
}
&lt;/templatedata&gt;</text>
      <sha1>cu64nv85g5l5wa60cvv9h341jka0q3f</sha1>
    </revision>
    <revision>
      <id>305362</id>
      <parentid>305361</parentid>
      <timestamp>2026-10-27T02:15:43Z</timestamp>
      <contributor>
        <username>Hanooz</username>
        <id>17889</id>
      </contributor>
      <origin>305362</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="117567" sha1="jmjf4psvzz2yduvy7d0r4w7ei4mbudf" xml:space="preserve">{{زیرصفحه توضیحات}}
این الگوها برای نمایش اشعار در ویکی‌نبشته به کار می‌روند. کار اصلی را [[پودمان:شعر]] انجام می‌دهد؛ الگوهای {{الگو|شعر}}، {{الگو|پایان شعر}}، {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}}، {{الگو|مصراع}}، {{الگو|بیت خالی}}، {{الگو|مصراع خالی}} و {{الگو|جداکننده بند}} فقط درگاهی به آن‌اند و شیوه‌نامه‌شان در [[الگو:شعر/styles.css]] است. نام‌های کوتاه پیشین (&lt;code&gt;ب&lt;/code&gt;، &lt;code&gt;ب۱&lt;/code&gt;، &lt;code&gt;بن&lt;/code&gt;، &lt;code&gt;م&lt;/code&gt;) تغییرمسیر هستند و همچنان کار می‌کنند.

== امکانات در یک نگاه ==
* '''انواع ردیف:''' بیت دومصراعی، بیت پلکانی/ضربدری ({{الگو|بیت۱}} و {{الگو|بیت نردبانی}})، مصراع تنها و شعر نو؛ همه در یک شعر قابل ترکیب‌اند.
* '''چیدمان ثابت و هم‌تراز:''' همهٔ ابیات یک شعر — حتی اگر در چند جدولِ جدا (صفحه‌های جدا) باشند — از یک نقطه آغاز می‌شوند؛ با &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;حداکثر عرض&lt;/code&gt; قابل تنظیم است.
* '''ترازبندی:''' میانه، وسط، راست، چپ، دوطرفه (پهن) و لبه‌چین؛ برای کل شعر یا فقط یک ردیف.
* '''نماد و فاصله:''' نماد میان دو مصراع (&lt;code&gt;جداکننده&lt;/code&gt;)، نماد میان بندها (&lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt;، {{الگو|جداکننده بند}})، و فاصلهٔ دلخواه میان بندها (&lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;ارتفاع&lt;/code&gt;، &lt;code&gt;@فاصله&lt;/code&gt;).
* '''شماره‌گذاری:''' دستی (راست/وسط/چپ) و خودکار (هر ''n''‌امین بیت)، با تبدیل رقم به فارسی یا لاتین.
* '''نستعلیق:''' با &lt;code&gt;نستعلیق&lt;/code&gt;؛ قلم و اندازه از خودِ الگوی {{الگو|نستعلیق}} می‌آید.
* '''حالت «متن»:''' کل شعر به‌صورت خط‌های ساده در یک فراخوانی؛ با خط‌های &lt;code&gt;@…&lt;/code&gt; نوع ردیف و نماد/فاصلهٔ بندها را در میانهٔ متن عوض می‌کنید؛ نشانه‌های درون‌خطی برای شماره و تراز.
* '''شعر چندصفحه‌ای:''' پیش‌نمایش کامل هر «صفحه:» و دوخته‌شدن صفحه‌ها در صفحهٔ اصلی؛ مصراع یا بیتِ ناتمام در پایان صفحه هم پشتیبانی می‌شود.
* '''نمایش واکنش‌گرا:''' در پنجرهٔ باریک هر بیت «ستونی» می‌شود (دو مصراع زیر هم)؛ در فضای نام «صفحه» آستانهٔ ستونی‌شدن به طول مصراع‌ها بستگی دارد.
* '''پانویس:''' &lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt; در پایان مصراع بدون برهم‌زدن عرض و ترازبندی.
* زبان و جهت، سبک/کلاس/شناسه برای هر ردیف، و رده‌های پیگیری برای خطاها. ساختار خروجی همان جدول ۷ستونی است و برای کتاب الکترونیکی هم کار می‌کند.

== شروع سریع ==
=== با الگوها ===
شعر را با {{الگو|شعر}} باز کنید، هر بیت را با {{الگو|بیت}} بنویسید و با {{الگو|پایان شعر}} ببندید:
&lt;pre&gt;
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر}}
{{بیت|الا یا ایها الساقی ادر کأسا و ناولها|که عشق آسان نمود اول ولی افتاد مشکل‌ها}}
{{بیت|به بوی نافه‌ای کاخر صبا زان طره بگشاید|ز تاب جعد مشکینش چه خون افتاد در دل‌ها}}
{{پایان شعر}}

=== با حالت «متن» ===
همین شعر را می‌توان خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; نوشت؛ هر دو خط پیاپی یک بیت می‌شوند و نیازی به {{الگو|پایان شعر}} نیست:
&lt;pre&gt;
{{شعر۲|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
&lt;/pre&gt;
نتیجه:
{{شعر۲|متن=
الا یا ایها الساقی ادر کأسا و ناولها
که عشق آسان نمود اول ولی افتاد مشکل‌ها
به بوی نافه‌ای کاخر صبا زان طره بگشاید
ز تاب جعد مشکینش چه خون افتاد در دل‌ها
}}
حالت «متن» برای ویرایش دیداری و رونویسیِ اشعارِ بلند مناسب‌تر است؛ بخش [[#حالت «متن»|حالت «متن»]] را ببینید.

=== علامت «=» و «|» در مصراع ===
: '''نکته:''' اگر در مصراع علامت &lt;code&gt;=&lt;/code&gt; یا &lt;code&gt;|&lt;/code&gt; دارید، به‌جای آن‌ها &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید؛ وگرنه مصراع به‌عنوان پارامتر ناشناخته خوانده می‌شود و صفحه به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌رود. در حالت «متن» علامت &lt;code&gt;=&lt;/code&gt; مشکلی ندارد (پارامتر نام دارد)، ولی &lt;code&gt;|&lt;/code&gt; را باید با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید.

== الگوها ==
هر الگو فقط یک درگاه به پودمان است: متن آن &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|نقطهٔ ورود}}&lt;/nowiki&gt;&lt;/code&gt; است.
{| class=&quot;wikitable&quot;
! الگو !! نام کوتاه !! نقطهٔ ورود !! کار
|-
| {{الگو|شعر}} || — || &lt;code&gt;open&lt;/code&gt; || آغاز شعر؛ با &lt;code&gt;متن&lt;/code&gt; کل شعر را می‌سازد (بدون نیاز به {{الگو|پایان شعر}})
|-
| {{الگو|پایان شعر}} || — || &lt;code&gt;close&lt;/code&gt; || پایان شعر
|-
| {{الگو|بیت}} || &lt;code&gt;ب&lt;/code&gt; || &lt;code&gt;bayt&lt;/code&gt; || بیت دومصراعی
|-
| {{الگو|بیت۱}} || &lt;code&gt;ب۱&lt;/code&gt; || &lt;code&gt;stagger&lt;/code&gt; || بیت پلکانی (ضربدری)
|-
| {{الگو|بیت نردبانی}} || &lt;code&gt;بن&lt;/code&gt; || &lt;code&gt;ladder&lt;/code&gt; || بیت نردبانی (در نسخهٔ کنونی دقیقاً مانند {{الگو|بیت۱}})
|-
| {{الگو|مصراع}} || &lt;code&gt;م&lt;/code&gt; || &lt;code&gt;mesra&lt;/code&gt; || یک مصراعِ تنها
|-
| {{الگو|بیت خالی}} || — || &lt;code&gt;emptyBayt&lt;/code&gt; || یک خط خالی؛ با &lt;code&gt;ارتفاع&lt;/code&gt; فاصلهٔ دلخواه، با &lt;code&gt;نماد&lt;/code&gt; ردیفِ نماد
|-
| {{الگو|مصراع خالی}} || — || &lt;code&gt;emptyMesra&lt;/code&gt; || مانند {{الگو|بیت خالی}}، برای شعر نو
|-
| {{الگو|جداکننده بند}} || — || &lt;code&gt;divider&lt;/code&gt; || ردیفِ نمادِ سراسری و وسط‌چین میان دو بند
|}

== مرجع پارامترها ==
* نام‌های انگلیسی (ستون «هم‌ارز» در جدول‌ها) هم پذیرفته می‌شوند. نام‌های چندکلمه‌ای را هم با فاصله و هم با نیم‌فاصله می‌توان نوشت (مثلاً «حداکثر عرض» یا «حداکثر‌عرض»).
* پارامتر یا مقدارِ ناشناخته، مصراعِ اضافه و «=» در مصراع صفحه را به [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] می‌برد؛ پارامتر نادرست خوانده نمی‌شود ولی صفحه نمی‌شکند.
* مقدارِ «بله/نه» به این صورت‌ها هم نوشته می‌شود: &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;بلی&lt;/code&gt;، &lt;code&gt;آری&lt;/code&gt;، &lt;code&gt;yes&lt;/code&gt;، &lt;code&gt;true&lt;/code&gt;، &lt;code&gt;1&lt;/code&gt; / &lt;code&gt;نه&lt;/code&gt;، &lt;code&gt;خیر&lt;/code&gt;، &lt;code&gt;no&lt;/code&gt;، &lt;code&gt;false&lt;/code&gt;، &lt;code&gt;0&lt;/code&gt;.
* طول‌ها (عرض، تورفتگی، فاصله، ارتفاع…) عدد با واحد &lt;code&gt;%&lt;/code&gt;، &lt;code&gt;px&lt;/code&gt;، &lt;code&gt;em&lt;/code&gt;، &lt;code&gt;ex&lt;/code&gt;، &lt;code&gt;ch&lt;/code&gt;، &lt;code&gt;rem&lt;/code&gt;، &lt;code&gt;vw&lt;/code&gt;، &lt;code&gt;vh&lt;/code&gt;، &lt;code&gt;pt&lt;/code&gt;، &lt;code&gt;cm&lt;/code&gt;، &lt;code&gt;mm&lt;/code&gt; یا &lt;code&gt;in&lt;/code&gt; هستند؛ عدد بدون واحد پیکسل حساب می‌شود. رقم فارسی و «٪» هم پذیرفته است (&lt;code&gt;۲۰٪&lt;/code&gt;).

=== شعر (آغاز) ===
گزینه‌هایی که برای کل شعر اثر دارند در {{الگو|شعر}} داده می‌شوند.
==== گزینه‌های بی‌نام ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || گزینهٔ بی‌نام: &lt;code&gt;نستعلیق&lt;/code&gt; نمای نستعلیق را روشن می‌کند؛ &lt;code&gt;ادامه&lt;/code&gt; یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).
|-
| &lt;code&gt;2&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; یا &lt;code&gt;ادامه&lt;/code&gt; || — || مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.
|}
==== چیدمان و اندازه ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;width&lt;/code&gt;&lt;/small&gt; || درصد یا طول (&lt;code&gt;80%&lt;/code&gt;، &lt;code&gt;30em&lt;/code&gt;، &lt;code&gt;480px&lt;/code&gt;) یا &lt;code&gt;خودکار&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; تا سقف &lt;code&gt;حداکثر عرض&lt;/code&gt;؛ با &lt;code&gt;&lt;nowiki&gt;ترازبندی=پهن&lt;/nowiki&gt;&lt;/code&gt; (بی‌عرض): &lt;code&gt;خودکار&lt;/code&gt; || عرض قاب شعر. عدد بدون واحد پیکسل است. &lt;code&gt;خودکار&lt;/code&gt; یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط &lt;code&gt;عرض&lt;/code&gt; بدهید سقف عرض ۱۰۰٪ می‌شود.
|-
| &lt;code&gt;حداکثر عرض&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;max-width&lt;/code&gt;&lt;/small&gt; || طول یا &lt;code&gt;بدون&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض قاب (وقتی عرض ثابت است). &lt;code&gt;بدون&lt;/code&gt; (یا &lt;code&gt;none&lt;/code&gt;، &lt;code&gt;نامحدود&lt;/code&gt;) یعنی بی‌سقف.
|-
| &lt;code&gt;تلفن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;phone&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;ستونی&lt;/code&gt;، &lt;code&gt;دوستونه&lt;/code&gt;، &lt;code&gt;همیشه&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt; || &lt;code&gt;ستونی&lt;/code&gt;: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ &lt;code&gt;دوستونه&lt;/code&gt;: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ &lt;code&gt;همیشه&lt;/code&gt;: همیشه ستونی.
|}
==== ترازبندی و نمادها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;، &lt;code&gt;تراز‌بندی&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;میانه&lt;/code&gt; (&lt;code&gt;درون&lt;/code&gt;)، &lt;code&gt;وسط&lt;/code&gt; (&lt;code&gt;مرکز&lt;/code&gt;)، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;پهن&lt;/code&gt; (&lt;code&gt;دوطرفه&lt;/code&gt;)، &lt;code&gt;لبه&lt;/code&gt; || &lt;code&gt;میانه&lt;/code&gt; برای بیت دومصراعی؛ &lt;code&gt;لبه&lt;/code&gt; برای بیت پلکانی || ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). &lt;code&gt;میانه&lt;/code&gt;: مصراع‌ها به محور میانی می‌چسبند؛ &lt;code&gt;لبه&lt;/code&gt;: مصراع نخست به راست و دوم به چپ؛ &lt;code&gt;پهن&lt;/code&gt;: دوطرفه.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (❖)، &lt;code&gt;نه&lt;/code&gt;، یا یک نمادِ کوتاه مثل &lt;code&gt;✤&lt;/code&gt; || بدون نماد || نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی &lt;code&gt;شو&lt;/code&gt; نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.
|-
| &lt;code&gt;جداکننده بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza-separator&lt;/code&gt;، &lt;code&gt;جداکنندهٔ بند&lt;/code&gt;، &lt;code&gt;نماد بند&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; (• • •)، &lt;code&gt;نه&lt;/code&gt;، یا هر نمادِ کوتاه (&lt;code&gt;❖&lt;/code&gt;، &lt;code&gt;❖ ❖ ❖&lt;/code&gt;) || بدون نماد || ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت &lt;code&gt;متن&lt;/code&gt; به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط &lt;code&gt;@نماد&lt;/code&gt; یا الگوی «جداکننده بند» استفاده کنید.
|}
==== حالت «متن» و نوع ردیف‌ها ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;متن&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;text&lt;/code&gt;&lt;/small&gt; || خط‌های ساده || — || کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.
|-
| &lt;code&gt;نوع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;type&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بیت&lt;/code&gt;، &lt;code&gt;بیت۱&lt;/code&gt; (&lt;code&gt;پلکانی&lt;/code&gt;)، &lt;code&gt;بیت نردبانی&lt;/code&gt; (&lt;code&gt;نردبانی&lt;/code&gt;)، &lt;code&gt;مصراع&lt;/code&gt; (&lt;code&gt;نو&lt;/code&gt;، &lt;code&gt;نیمایی&lt;/code&gt;، &lt;code&gt;آزاد&lt;/code&gt;) || &lt;code&gt;بیت&lt;/code&gt; || نوع پیش‌فرض ردیف‌ها در حالت &lt;code&gt;متن&lt;/code&gt;. با &lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt; ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;راست&lt;/code&gt; در شعر نو؛ &lt;code&gt;وسط&lt;/code&gt; برای مصراع تنهای پایان بند || تراز مصراع‌های تنها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || تورفتگی ردیف‌های پلکانی/نردبانی در حالت &lt;code&gt;متن&lt;/code&gt;. بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.
|-
| &lt;code&gt;واحد تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent-unit&lt;/code&gt;، &lt;code&gt;واحد‌تورفتگی&lt;/code&gt;&lt;/small&gt; || طول || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر «:» در شعر نو (&lt;code&gt;&lt;nowiki&gt;نوع=مصراع&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;فاصله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;gap&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصلهٔ میان بندها در حالت &lt;code&gt;متن&lt;/code&gt;.
|-
| &lt;code&gt;بند&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;stanza&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;جدید&lt;/code&gt; || — || در حالت &lt;code&gt;متن&lt;/code&gt; و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt;) می‌گذارد.
|}
==== شماره‌گذاری ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;شماره‌گذاری&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;numbering&lt;/code&gt;، &lt;code&gt;شماره&lt;/code&gt;، &lt;code&gt;شمارهگذاری&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، عدد (&lt;code&gt;5&lt;/code&gt;)، &lt;code&gt;نه&lt;/code&gt; || خاموش || &lt;code&gt;بله&lt;/code&gt;: شمارهٔ همهٔ ابیات؛ یک عدد مثل &lt;code&gt;5&lt;/code&gt;: هر پنجمین بیت؛ &lt;code&gt;نه&lt;/code&gt; (یا &lt;code&gt;0&lt;/code&gt;): خاموش.
|-
| &lt;code&gt;شروع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;start&lt;/code&gt;&lt;/small&gt; || عدد || &lt;code&gt;1&lt;/code&gt; || شمارهٔ بیت نخست.
|-
| &lt;code&gt;سمت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;side&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;چپ&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;وسط&lt;/code&gt; || &lt;code&gt;چپ&lt;/code&gt; || سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) &lt;code&gt;وسط&lt;/code&gt; همان &lt;code&gt;چپ&lt;/code&gt; است.
|-
| &lt;code&gt;ارقام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;digits&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فارسی&lt;/code&gt; (&lt;code&gt;fa&lt;/code&gt;)، &lt;code&gt;لاتین&lt;/code&gt; (&lt;code&gt;latin&lt;/code&gt;)، &lt;code&gt;بدون تغییر&lt;/code&gt; (&lt;code&gt;keep&lt;/code&gt;) || &lt;code&gt;فارسی&lt;/code&gt; || تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.
|}
==== ظاهر ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;نستعلیق&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;nastaliq&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن &lt;code&gt;نستعلیق&lt;/code&gt; به‌صورت بی‌نام (&lt;code&gt;&lt;nowiki&gt;{{شعر|نستعلیق}}&lt;/nowiki&gt;&lt;/code&gt;).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی قاب بیرونی شعر (با &lt;code&gt;&lt;nowiki&gt;عرض=خودکار&lt;/nowiki&gt;&lt;/code&gt;: روی جدول).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به قاب شعر.
|-
| &lt;code&gt;زبان&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;lang&lt;/code&gt;&lt;/small&gt; || کد زبان (&lt;code&gt;ar&lt;/code&gt;، &lt;code&gt;en&lt;/code&gt;، &lt;code&gt;fa&lt;/code&gt;) || — || برای ابیات غیرفارسی؛ خصوصیت &lt;code&gt;lang&lt;/code&gt; را می‌گذارد و &lt;code&gt;جهت&lt;/code&gt; را از آن حدس می‌زند.
|-
| &lt;code&gt;جهت&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;dir&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;rtl&lt;/code&gt;، &lt;code&gt;ltr&lt;/code&gt; || از &lt;code&gt;زبان&lt;/code&gt; حدس زده می‌شود || جهت متن.
|}
==== شعر چندصفحه‌ای ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || الگو: &lt;code&gt;ادامه&lt;/code&gt; (بی‌نام) یا &lt;code&gt;قبل&lt;/code&gt;؛ حالت &lt;code&gt;متن&lt;/code&gt;: &lt;code&gt;قبل&lt;/code&gt;، &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || — || شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است (&lt;code&gt;قبل&lt;/code&gt;) و/یا در صفحهٔ بعد ادامه دارد (&lt;code&gt;بعد&lt;/code&gt;، فقط حالت &lt;code&gt;متن&lt;/code&gt;). در حالت &lt;code&gt;متن&lt;/code&gt;، &lt;code&gt;&lt;nowiki&gt;ادامه=بله&lt;/nowiki&gt;&lt;/code&gt; مبهم است و پذیرفته نمی‌شود.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;اول&lt;/code&gt;، &lt;code&gt;دوم&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. &lt;code&gt;اول&lt;/code&gt;/&lt;code&gt;دوم&lt;/code&gt;: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.
|}
==== فضای نام «صفحه» ====
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;طول مصراع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;hemistich-length&lt;/code&gt;، &lt;code&gt;طول‌مصراع&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;کوتاه&lt;/code&gt;، &lt;code&gt;متوسط&lt;/code&gt;، &lt;code&gt;بلند&lt;/code&gt;، عدد، &lt;code&gt;خودکار&lt;/code&gt; || حالت &lt;code&gt;متن&lt;/code&gt;: خودکار؛ حالت الگو: &lt;code&gt;متوسط&lt;/code&gt; || فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع (&lt;code&gt;کوتاه&lt;/code&gt; تا ۲۰ نویسه، &lt;code&gt;متوسط&lt;/code&gt; تا ۳۰، &lt;code&gt;بلند&lt;/code&gt; بیشتر؛ یا خودِ شمار نویسه).
|}

=== پایان شعر ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || &lt;code&gt;ادامه&lt;/code&gt; || — || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;: شعر در صفحهٔ بعد ادامه دارد (جدول بسته نمی‌شود).
|-
| &lt;code&gt;ادامه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continue&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بعد&lt;/code&gt;، &lt;code&gt;هر دو&lt;/code&gt;، &lt;code&gt;بله&lt;/code&gt; || — || مانند &lt;code&gt;ادامه&lt;/code&gt; بی‌نام. &lt;code&gt;قبل&lt;/code&gt; را در «شعر» بنویسید.
|}

=== بیت ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست (سمت راست). اگر فقط یکی از دو مصراع پر باشد (و ردیف ناتمام/دنباله نباشد) صفحه به ردهٔ «بیت ناقص» می‌رود.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم (سمت چپ).
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانِ دو مصراع (جای نمادِ &lt;code&gt;جداکننده&lt;/code&gt; را می‌گیرد).
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;جداکننده&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;separator&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt;، نماد || از «شعر» || نمادِ میان دو مصراعِ همین بیت (&lt;code&gt;نه&lt;/code&gt; برای حذف).
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت۱ و بیت نردبانی ===
هر دو یک پارامتر دارند (در نسخهٔ کنونی خروجی‌شان یکی است). ستون میانی ندارند، پس &lt;code&gt;شو&lt;/code&gt; و &lt;code&gt;جداکننده&lt;/code&gt; در آن‌ها اثری ندارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || مصراع نخست.
|-
| &lt;code&gt;2&lt;/code&gt; || متن || — || مصراع دوم.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;ترازبندی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;justify&lt;/code&gt;&lt;/small&gt; || مانند &lt;code&gt;ترازبندی&lt;/code&gt; در «شعر» || ترازبندی شعر || ترازبندی فقط همین ردیف.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== مصراع ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || متن || — || متن مصراع.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت راست ردیف. رقم‌ها طبق &lt;code&gt;ارقام&lt;/code&gt; تبدیل می‌شوند و بر شماره‌گذاری خودکارِ همان ردیف مقدم‌اند.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ دستی در سمت چپ ردیف.
|-
| &lt;code&gt;تراز&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;align&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;وسط&lt;/code&gt;، &lt;code&gt;راست&lt;/code&gt;، &lt;code&gt;چپ&lt;/code&gt; || &lt;code&gt;وسط&lt;/code&gt; || تراز مصراع. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
|-
| &lt;code&gt;تورفتگی&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;indent&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;20%&lt;/code&gt;، &lt;code&gt;3em&lt;/code&gt;) || بدون تورفتگی || بدون آن هر مصراع در نیمهٔ خودش می‌نشیند؛ با آن هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» است که یکی به راست و دیگری به چپ می‌چسبد.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی مصراع‌های (یا مصراعِ) این ردیف؛ مثلاً برای برجسته‌کردن یک بیت.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف، برای پیوند مستقیم به آن بیت.
|-
| &lt;code&gt;ناتمام&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;unfinished&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt;، &lt;code&gt;نه&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف در صفحهٔ بعد ادامه دارد (بخش «شعر چندصفحه‌ای»).
|-
| &lt;code&gt;دنباله&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;continued&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;بله&lt;/code&gt; || &lt;code&gt;نه&lt;/code&gt; || این ردیف ادامهٔ ردیفِ ناتمامِ صفحهٔ پیش است. در حالت الگو، مصراعِ تهی را تهی بگذارید.
|-
| &lt;code&gt;اتصال&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;join&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;فاصله&lt;/code&gt;، &lt;code&gt;چسبیده&lt;/code&gt;، &lt;code&gt;نیم‌فاصله&lt;/code&gt; || &lt;code&gt;فاصله&lt;/code&gt; || نحوهٔ چسباندن دو تکه در ردیفِ دارای &lt;code&gt;دنباله&lt;/code&gt;.
|}

=== بیت خالی و مصراع خالی ===
این دو الگو سه کار می‌کنند: بدون پارامتر یک خط خالی (در {{الگو|بیت خالی}} با ستون‌های شماره)، با &lt;code&gt;ارتفاع&lt;/code&gt; یک فاصلهٔ دلخواه، و با &lt;code&gt;نماد&lt;/code&gt; (یا وقتی {{الگو|شعر}} پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) یک ردیفِ نماد. جدول زیر برای {{الگو|بیت خالی}} است؛ {{الگو|مصراع خالی}} همین پارامترها را بدون &lt;code&gt;شو&lt;/code&gt; دارد.
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع فاصله (پیش‌فرض یک خط). به‌تنهایی فقط &lt;code&gt;کلاس&lt;/code&gt; اثر دارد؛ همراه &lt;code&gt;نماد&lt;/code&gt; ارتفاعِ ردیف نماد را تعیین می‌کند.
|-
| &lt;code&gt;نماد&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;symbol&lt;/code&gt;&lt;/small&gt; || &lt;code&gt;نه&lt;/code&gt; یا نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) || — || به‌جای خط خالی، یک ردیفِ نمادِ سراسری و وسط‌چین می‌آورد؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده.
|-
| &lt;code&gt;ش&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;r&lt;/code&gt;، &lt;code&gt;right&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت راست؛ فقط در ردیف خالیِ ساده (بدون &lt;code&gt;ارتفاع&lt;/code&gt; و &lt;code&gt;نماد&lt;/code&gt;).
|-
| &lt;code&gt;شو&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;c&lt;/code&gt;، &lt;code&gt;center&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ میانی؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;شچ&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;l&lt;/code&gt;، &lt;code&gt;left&lt;/code&gt;&lt;/small&gt; || متن یا عدد || — || شمارهٔ سمت چپ؛ فقط در ردیف خالیِ ساده.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف خالی (با &lt;code&gt;نماد&lt;/code&gt;: روی ردیف نماد؛ با &lt;code&gt;ارتفاع&lt;/code&gt; به‌تنهایی اثر ندارد).
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|-
| &lt;code&gt;شناسه&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;id&lt;/code&gt;&lt;/small&gt; || نام || — || &lt;code&gt;id&lt;/code&gt; ردیف؛ فقط در ردیف خالیِ ساده.
|}

=== جداکننده بند ===
{| class=&quot;wikitable&quot; style=&quot;width:100%&quot;
! پارامتر !! مقدارها !! پیش‌فرض !! توضیح
|-
| &lt;code&gt;1&lt;/code&gt; || نماد (&lt;code&gt;• • •&lt;/code&gt;، &lt;code&gt;❖&lt;/code&gt;) یا &lt;code&gt;نه&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده بند&lt;/code&gt; شعر، وگرنه • • • || نمادِ ردیف؛ &lt;code&gt;نه&lt;/code&gt; = فاصلهٔ ساده. همان &lt;code&gt;&lt;nowiki&gt;نماد=&lt;/nowiki&gt;&lt;/code&gt; را هم می‌پذیرد.
|-
| &lt;code&gt;ارتفاع&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;height&lt;/code&gt;&lt;/small&gt; || طول (&lt;code&gt;0.5em&lt;/code&gt;) || یک خط || ارتفاع ردیف نماد (پیش‌فرض یک خط)؛ نماد در میانهٔ آن می‌نشیند.
|-
| &lt;code&gt;سبک&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;style&lt;/code&gt;&lt;/small&gt; || CSS || — || سبک CSS روی ردیف نماد؛ مثلاً &lt;code&gt;color:#b3362b&lt;/code&gt; برای رنگ یا &lt;code&gt;font-size:150%&lt;/code&gt; برای اندازه.
|-
| &lt;code&gt;کلاس&lt;/code&gt;&lt;br&gt;&lt;small&gt;هم‌ارز: &lt;code&gt;class&lt;/code&gt;&lt;/small&gt; || نام کلاس || — || کلاسِ افزوده به ردیف.
|}

== چیدمان: عرض ثابت و هم‌تراز ==
جدول شعر به‌طور پیش‌فرض '''عرضی ثابت و مستقل از محتوا''' دارد: عرض ۱۰۰٪ فضای موجود با سقف &lt;code&gt;50em&lt;/code&gt;، با دو ستونِ هم‌اندازه برای مصراع‌ها، یک ستون میانی (فاصلهٔ دو مصراع) و دو ستونِ باریک برای شماره‌ها. نتیجه این است که همهٔ ابیات یک شعر از یک نقطه آغاز می‌شوند و اگر شعر در چند جدول جدا (مثلاً هر صفحه یک جدول) بیاید، قاب‌ها دقیقاً هم‌اندازه و هم‌تراز می‌مانند؛ برخلاف جدولِ هم‌اندازهٔ محتوا که عرضش بسته به بلندترین مصراعِ همان صفحه فرق می‌کند و آغاز شعر را در مرز صفحه جابه‌جا می‌کند.
&lt;pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|عرض=70%}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
* '''عرض=خودکار:''' جدول به اندازهٔ محتوا می‌شود (و وسط‌چین): برای رباعی یا شعر کوتاه که نمی‌خواهید قاب پهن داشته باشد.
{{شعر|عرض=خودکار}}
{{بیت|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''حداکثر عرض:''' سقف عرض را عوض می‌کند: &lt;code&gt;حداکثر عرض=40em&lt;/code&gt;، یا &lt;code&gt;حداکثر عرض=بدون&lt;/code&gt; برای بی‌سقف.
* همهٔ ستون‌ها را همین عرض تعیین می‌کند؛ پس مصراع‌های بلندتر از ستون به چند خط شکسته می‌شوند. برای شعرهای بلندمصراع یا نستعلیق (قلم درشت‌تر) &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید.
* با &lt;code&gt;ترازبندی=پهن&lt;/code&gt; اگر &lt;code&gt;عرض&lt;/code&gt; ندهید، جدول هم‌اندازهٔ محتوا (&lt;code&gt;عرض=خودکار&lt;/code&gt;) است، چون در شعر دوطرفه ستون‌ها باید به اندازهٔ بلندترین مصراع شوند؛ با دادنِ &lt;code&gt;عرض&lt;/code&gt; همان عرضِ ثابت اعمال می‌شود.
* در شعر چندصفحه‌ای فقط گزینه‌های {{الگو|شعر}} صفحهٔ نخست در صفحهٔ اصلی اثر دارد (بخش «شعر چندصفحه‌ای»).
* مدیران پودمان می‌توانند پیش‌فرض را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند (&lt;code&gt;defaultWidth&lt;/code&gt;، &lt;code&gt;maxWidth&lt;/code&gt;؛ مقدار &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند).

== ترازبندی مصراع‌ها ==
پارامتر &lt;code&gt;ترازبندی&lt;/code&gt; در {{الگو|شعر}} (برای همهٔ ابیات) یا در هر ردیف (فقط همان ردیف) مشخص می‌کند متن مصراع‌ها در جایگاه خود چگونه بنشیند:
{| class=&quot;wikitable&quot;
! مقدار !! معنی
|-
| &lt;code&gt;میانه&lt;/code&gt; (یا &lt;code&gt;درون&lt;/code&gt;) || '''پیش‌فرض {{الگو|بیت}}.''' هر دو مصراع به محور میانیِ بیت می‌چسبند (مصراع نخست به چپِ جایگاهش، مصراع دوم به راستِ جایگاهش)؛ فاصلهٔ دو مصراع در همهٔ ابیات یکسان می‌ماند — شیوهٔ کتاب‌های کلاسیک و گنجور.
|-
| &lt;code&gt;وسط&lt;/code&gt; (یا &lt;code&gt;مرکز&lt;/code&gt;) || هر مصراع وسط جایگاهش.
|-
| &lt;code&gt;راست&lt;/code&gt; / &lt;code&gt;چپ&lt;/code&gt; || همهٔ مصراع‌ها به راست/چپ جایگاهشان چسبیده (همهٔ خط‌ها از یک نقطه آغاز می‌شوند).
|-
| &lt;code&gt;پهن&lt;/code&gt; (یا &lt;code&gt;دوطرفه&lt;/code&gt;) || دوطرفه: هر مصراع کل پهنای جایگاهش را می‌گیرد (چیدمان چاپی کلاسیک). همهٔ ستون‌ها به اندازهٔ بلندترین مصراعِ کل شعر می‌شوند. اگر کوتاه‌ترین مصراعِ یک بیت کمتر از ۷۰٪ بلندترینِ همان بیت باشد، آن بیت کشیده نمی‌شود (وسط‌چین می‌ماند) تا فاصلهٔ واژه‌ها بی‌جهت باز نشود.
|-
| &lt;code&gt;لبه&lt;/code&gt; || مصراع نخست به آغاز (راست) و مصراع دوم به پایان (چپ) می‌چسبد؛ '''پیش‌فرض {{الگو|بیت۱}} و {{الگو|بیت نردبانی}}'''.
|}
&lt;pre&gt;
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
'''پهن (دوطرفه):'''
{{شعر|ترازبندی=پهن}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''میانه (پیش‌فرض):'''
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''وسط:'''
{{شعر|ترازبندی=وسط}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''راست:'''
{{شعر|ترازبندی=راست}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
'''لبه:'''
{{شعر|ترازبندی=لبه}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
ترازبندی در یک ردیف (بقیه پیش‌فرض می‌مانند): &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|ترازبندی=پهن}}&lt;/nowiki&gt;&lt;/code&gt;

== بیت پلکانی (ضربدری) و نردبانی ==
برای نمایش ابیات به‌صورت ضربدری و نامتقارن از {{الگو|بیت۱}} (یا {{الگو|بیت نردبانی}}) به‌جای {{الگو|بیت}} استفاده کنید؛ هر بیت روی '''دو خط''' می‌آید. بدون پارامتر، مصراع نخست در نیمهٔ راست و مصراع دوم (در خط بعد) در نیمهٔ چپ می‌نشیند و هر دو به لبهٔ خود می‌چسبند (&lt;code&gt;ترازبندی=لبه&lt;/code&gt;):
&lt;pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|آن همه شوکت و ناموس شهان آخر کار|چند سطری است که بر صفحهٔ دفتر گذرد}}
{{بیت۱|عاقبت در دو سه خط جمع شود از بد و نیک|آنچه یک عمر به دارا و سکندر گذرد}}
{{پایان شعر}}
* '''تورفتگی:''' با &lt;code&gt;تورفتگی&lt;/code&gt; هر خط جعبه‌ای به پهنای «۱۰۰٪ منهای تورفتگی» می‌شود که یکی به راست و دیگری به چپ می‌چسبد؛ هرچه تورفتگی کمتر باشد پله‌ها کوتاه‌ترند:
&lt;pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت۱|ش=۲۵۵|شچ=۲۵۶|تورفتگی=5%|یوسف گم‌گشته بازآید بکنعان غم مخور|کلبهٔ احزان شود روزی گلستان غم مخور}}
{{بیت۱|تورفتگی=5%|ای دل غمدیده حالت به شود دل بد مکن|وین سر شوریده بازآید بسامان غم مخور}}
{{پایان شعر}}
* '''ترکیب با بیت دومصراعی:''' انواع ردیف را می‌توان در یک شعر آمیخت:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۲۰۱|شو=۲۰۲|شچ=۲۰۳|ابر و باد و مه و خورشید و فلک در کارند|تا تو نانی بکف آریّ و بغفلت نخوری}}
{{بیت۱|ش=۲۰۴|شچ=۲۰۵|همه از بهر تو سر گشته و فرمانبردار|شرط انصاف نباشد که تو فرمان نبری}}
{{پایان شعر}}
* '''{{الگو|بیت نردبانی}}:''' در نسخهٔ کنونی پودمان همان {{الگو|بیت۱}} است و تورفتگی پیش‌فرضِ جداگانه‌ای ندارد؛ برای پله‌های بلندتر یا کوتاه‌تر &lt;code&gt;تورفتگی&lt;/code&gt; بدهید.
* مقدار &lt;code&gt;تورفتگی&lt;/code&gt; را با ٪ یا واحدهای &lt;code&gt;em&lt;/code&gt; و &lt;code&gt;px&lt;/code&gt; می‌توان داد (مقدار بدون واحد پیکسل است).
* ترازبندی پیش‌فرض این دو &lt;code&gt;لبه&lt;/code&gt; است؛ برای وسط‌چین‌کردن جعبه‌ها &lt;code&gt;ترازبندی=وسط&lt;/code&gt; بدهید.
* با &lt;code&gt;عرض=خودکار&lt;/code&gt; (چیدمان هم‌اندازهٔ محتوا) تورفتگی نسبت به عرضِ جدول است و جدول به اندازهٔ محتوا می‌شود.

== نماد میان دو مصراع ==
پارامتر &lt;code&gt;جداکننده&lt;/code&gt; نمادی را میان دو مصراعِ هر بیت می‌گذارد (در ستون میانی). &lt;code&gt;بله&lt;/code&gt; نمادِ پیش‌فرض ❖ را می‌گذارد، هر نمادِ کوتاهی هم پذیرفته است، و &lt;code&gt;نه&lt;/code&gt; آن را حذف می‌کند:
&lt;pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|جداکننده=بله}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند|جداکننده=✤}}
{{پایان شعر}}
* در {{الگو|شعر}} برای همهٔ ابیات اثر دارد و در هر ردیف فقط برای همان ردیف.
* اگر شمارهٔ میانی (&lt;code&gt;شو&lt;/code&gt;) آمده باشد جای نماد را می‌گیرد.
* نماد باید کوتاه باشد (تا حدود ۸ نویسه) و &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;&amp;gt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;}&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; &lt;code&gt;]&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; نداشته باشد؛ وگرنه نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* در نمایش ستونی (صفحهٔ باریک) نماد پنهان می‌شود. رنگ و اندازه‌اش با &lt;code&gt;.poem-sep&lt;/code&gt; در [[الگو:شعر/styles.css]] تعیین می‌شود؛ پیش‌فرض همگانی را مدیر پودمان با &lt;code&gt;cfg.separator&lt;/code&gt; می‌دهد.
* این نماد میان '''دو مصراعِ یک بیت''' است؛ برای نمادِ میان '''دو بند''' بخش بعد را ببینید.

== بندها: فاصله و نماد ==
بیت‌ها معمولاً در «بند» دسته می‌شوند (رباعی، چهارپاره و…). میان بندها می‌توان یک فاصله یا یک نماد (مثل • • • یا ❖) گذاشت.

=== فاصلهٔ ساده ===
هنگامی که بخواهید میان ابیات یا مصراع‌های یک قطعه یک خط فاصله ایجاد کنید، از این الگوها استفاده کنید:
* {{الگو|بیت خالی}}
* {{الگو|مصراع خالی}}

برای فاصله‌ای کوتاه‌تر یا بلندتر از یک خط پارامتر &lt;code&gt;ارتفاع&lt;/code&gt; را بدهید: &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» خط خالی میان دو بند همین کار را می‌کند (یک خط؛ اندازه‌اش را &lt;code&gt;فاصله=0.5em&lt;/code&gt; عوض می‌کند).
&lt;pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بشنو این نی چون شکایت می‌کند|از جدایی‌ها حکایت می‌کند}}
{{بیت خالی|ارتفاع=1.5em}}
{{بیت|کز نیستان تا مرا ببریده‌اند|در نفیرم مرد و زن نالیده‌اند}}
{{پایان شعر}}

=== نماد میان بندها ===
{{الگو|جداکننده بند}} یک ردیفِ '''سراسری و وسط‌چین''' با نماد می‌گذارد؛ نمادِ پیش‌فرض • • • است و هر نمادِ دیگری را می‌توان به‌صورت پارامتر بی‌نام داد. (همین کار را &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=…}}&lt;/nowiki&gt;&lt;/code&gt; هم می‌کند.)
&lt;pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|بنی‌آدم اعضای یکدیگرند|که در آفرینش ز یک گوهرند}}
{{جداکننده بند}}
{{بیت|چو عضوی به درد آورد روزگار|دگر عضوها را نماند قرار}}
{{جداکننده بند|❖ ❖ ❖}}
{{بیت|تو کز محنت دیگران بی‌غمی|نشاید که نامت نهند آدمی}}
{{پایان شعر}}
اگر نماد را برای '''همهٔ''' بندها می‌خواهید، پارامتر &lt;code&gt;جداکننده بند&lt;/code&gt; را در {{الگو|شعر}} بدهید: آن‌گاه هر {{الگو|بیت خالی}}ِ بی‌ارتفاع (و در حالت «متن» هر خط خالی میان دو بند) ردیفِ نماد می‌شود.
&lt;pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
&lt;/pre&gt;
{{شعر|جداکننده بند=• • •|متن=
بنی‌آدم اعضای یکدیگرند
که در آفرینش ز یک گوهرند

چو عضوی به درد آورد روزگار
دگر عضوها را نماند قرار

تو کز محنت دیگران بی‌غمی
نشاید که نامت نهند آدمی
}}
* ردیفِ نماد همیشه یک خط بلند است (با &lt;code&gt;ارتفاع&lt;/code&gt; بلندتر می‌شود)، نمادش پررنگ است و رنگش از متن ارث می‌برد؛ برای رنگ دیگر: &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|سبک=color:#b3362b}}&lt;/nowiki&gt;&lt;/code&gt;. در حالت «متن» رنگ و اندازه را شیوه‌نامه (&lt;code&gt;.poem-ornament-cell&lt;/code&gt;) تعیین می‌کند.
* ردیفِ نماد در نمایش ستونی هم دیده می‌شود (برخلاف نمادِ میان دو مصراع).
* برای فاصلهٔ ساده در شعری که نمادِ خودکار دارد: {{الگو|جداکننده بند}}&lt;code&gt;|نه&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt;، و در حالت «متن» خط &lt;code&gt;@نماد نه&lt;/code&gt;.
* نمادِ پیش‌فرض را مدیر پودمان با &lt;code&gt;cfg.stanzaOrnament&lt;/code&gt; عوض می‌کند.

=== نماد و فاصله در حالت «متن» ===
در حالت «متن» دو خطِ ویژه، بریدگیِ میان بندها را جداگانه تنظیم می‌کنند (هر کدام در یک خطِ جدا و با &lt;code&gt;@&lt;/code&gt; آغاز می‌شود):
{| class=&quot;wikitable&quot;
! خط !! کار
|-
| &lt;code&gt;@نماد&lt;/code&gt; || یک ردیفِ نمادِ پیش‌فرض (• • •) همین‌جا
|-
| &lt;code&gt;@نماد ❖&lt;/code&gt; || یک ردیفِ نمادِ دلخواه
|-
| &lt;code&gt;@نماد نه&lt;/code&gt; || فاصلهٔ ساده (برای شعری که &lt;code&gt;جداکننده بند&lt;/code&gt; دارد)
|-
| &lt;code&gt;@فاصله&lt;/code&gt; || یک ردیف فاصلهٔ اضافه (یک خط یا اندازهٔ &lt;code&gt;فاصله=&lt;/code&gt;)
|-
| &lt;code&gt;@فاصله 3em&lt;/code&gt; || یک ردیف فاصله با اندازهٔ دلخواه
|}
&lt;pre&gt;
{{شعر۲|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
&lt;/pre&gt;
{{شعر۲|متن=
بشنو این نی چون شکایت می‌کند
از جدایی‌ها حکایت می‌کند

@نماد • • •

کز نیستان تا مرا ببریده‌اند
در نفیرم مرد و زن نالیده‌اند

@فاصله 2em

سینه خواهم شرحه شرحه از فراق
تا بگویم شرح درد اشتیاق
}}
* این خط‌ها جای خط‌های خالیِ کنارشان را می‌گیرند (خط خالی پیش و پس از آن‌ها شمرده نمی‌شود)؛ پس برای خوانایی می‌توانید دورشان خط خالی بگذارید.
* می‌توان چند خط را پشت‌سرهم نوشت: هر کدام یک ردیف می‌شود، به همان ترتیب (تا هشت ردیف). مثلاً &lt;code&gt;@نماد&lt;/code&gt; و بعد &lt;code&gt;@فاصله&lt;/code&gt; یک نماد و یک فاصلهٔ اضافه می‌دهد.
* '''چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند''' (برای سازگاری با شعرهای پیشین)؛ فاصلهٔ بزرگ‌تر را با &lt;code&gt;@فاصله&lt;/code&gt; بگیرید.
* خط &lt;code&gt;@نماد&lt;/code&gt; یا &lt;code&gt;@فاصله&lt;/code&gt; پیش از نخستین ردیف نادیده گرفته می‌شود. نام‌های دیگرِ پذیرفته‌شده: &lt;code&gt;@جداکننده&lt;/code&gt;، &lt;code&gt;@جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد بند&lt;/code&gt;، &lt;code&gt;@ornament&lt;/code&gt;، &lt;code&gt;@separator&lt;/code&gt;، &lt;code&gt;@symbol&lt;/code&gt; (برای نماد) و &lt;code&gt;@gap&lt;/code&gt; (برای فاصله).
* در پایان بند، مصراعِ تنها (اگر خط‌های بند فرد باشند) پیش از فاصله/نماد جای خود را می‌گیرد.

=== کدام را به کار ببرم؟ ===
{| class=&quot;wikitable&quot;
! می‌خواهم !! با الگوها !! در حالت «متن»
|-
| فاصلهٔ یک‌خطی میان بندها || {{الگو|بیت خالی}} || یک خط خالی
|-
| فاصلهٔ دلخواه || &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|ارتفاع=0.5em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;فاصله=0.5em&lt;/code&gt; (همهٔ بندها) یا &lt;code&gt;@فاصله 0.5em&lt;/code&gt; (همان‌جا)
|-
| نماد میان همهٔ بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و {{الگو|بیت خالی}} میان بندها || &lt;code&gt;جداکننده بند=• • •&lt;/code&gt; در {{الگو|شعر}} و خط خالی میان بندها
|-
| نماد فقط در یک بریدگی || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|• • •}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد • • •&lt;/code&gt;
|-
| فاصلهٔ ساده در شعری که نمادِ خودکار دارد || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|نه}}&lt;/nowiki&gt;&lt;/code&gt; یا &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=نه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد نه&lt;/code&gt;
|-
| نماد به‌جای یک فاصلهٔ بلندتر || &lt;code&gt;&lt;nowiki&gt;{{جداکننده بند|❖|ارتفاع=3em}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;@نماد ❖&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; پشت‌سرهم
|}

== مصراع‌های تنها و شعر نو ==
الگوی {{الگو|مصراع}} یک مصراع را وسط‌چین می‌نویسد. برای شعر نو می‌توانید تراز و تورفتگی بدهید:
&lt;pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{مصراع|ای آدمها که بر ساحل نشسته‌اید|تراز=راست}}
{{مصراع|شادمان بر ساحل|تراز=راست|تورفتگی=1.5em}}
{{مصراع|ما در موج|تراز=راست|تورفتگی=3em}}
{{پایان شعر}}
* &lt;code&gt;تراز&lt;/code&gt;: &lt;code&gt;وسط&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;راست&lt;/code&gt; یا &lt;code&gt;چپ&lt;/code&gt;. &lt;code&gt;تورفتگی&lt;/code&gt; فقط برای تراز راست و چپ اثر دارد.
* مصراعِ تنها در میان ابیات (مثلاً مصراع پایانی یک بند) وسط‌چین می‌آید و زیر دو ستونِ شعر قرار می‌گیرد.
* در شعرِ نو معمولاً {{الگو|شعر}} را با &lt;code&gt;نوع=مصراع&lt;/code&gt; به کار می‌برند تا مصراع‌ها در شماره‌گذاری خودکار شمرده شوند؛ نوشتنِ شعر نو در حالت «متن» ساده‌تر است (بخش «حالت «متن»»).

== شماره‌گذاری ==
=== شماره‌گذاری دستی ===
اگر می‌خواهید در سمت راست یک بیت شمارهٔ آن را درج کنید، از پارامتر «ش» (مخفف «شماره») استفاده کنید. برای شماره در وسط (میان دو مصراع) از «شو» و برای سمت چپ از «شچ» استفاده کنید:
&lt;pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
&lt;/pre&gt;
{{شعر}}
{{بیت|ش=۱۰۰|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|شو=۱۰۱|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|شچ=۱۰۲|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{مصراع|ش=۱۰۳|ای مرغ سحر عشق ز پروانه بیاموز}}
{{مصراع|شچ=۱۰۴|کان سوخته را جان شد و آواز نیامد}}
{{پایان شعر}}
* '''ارقام:''' رقم‌های لاتین و عربی در شماره‌ها خودکار به رقم فارسی تبدیل می‌شوند (&lt;code&gt;ش=12&lt;/code&gt; ← ۱۲). برای خاموش‌کردن، در {{الگو|شعر}} بنویسید &lt;code&gt;ارقام=بدون تغییر&lt;/code&gt; یا &lt;code&gt;ارقام=لاتین&lt;/code&gt;. مقداری که نشانه‌گذاری دارد (مثلاً پیوند یا قالب‌بندی) دست‌نخورده می‌ماند.

=== شماره‌گذاری خودکار ===
به‌جای نوشتن دستی شماره‌ها، در {{الگو|شعر}} پارامتر &lt;code&gt;شماره‌گذاری&lt;/code&gt; را بدهید:
&lt;pre&gt;
{{شعر|شماره‌گذاری=5|شروع=1}}
{{بیت|مصراع اول|مصراع دوم}}
… (شمارهٔ ۵، ۱۰، ۱۵ و … در سمت چپ نمایش داده می‌شود)
{{پایان شعر}}
&lt;/pre&gt;
{{شعر|شماره‌گذاری=بله|سمت=راست}}
{{بیت|نیست آواز کسی آنجا که اوست|کی رسد جان کسی آنجا که اوست}}
{{بیت|صد هزاران طور از جان بر ترست|هر چه خواهم گفت او زان برتر است}}
{{بیت|عقل در سودای او حیران بماند|جان ز عجز انگشت در دندان بماند}}
{{پایان شعر}}
* بیت‌های {{الگو|بیت}}، {{الگو|بیت۱}} و {{الگو|بیت نردبانی}} شمرده می‌شوند. {{الگو|مصراع}} فقط وقتی شمرده می‌شود که &lt;code&gt;نوع=مصراع&lt;/code&gt; داده باشید.
* با &lt;code&gt;شماره‌گذاری=5&lt;/code&gt; همهٔ ابیات شمرده می‌شوند ولی فقط شمارهٔ مضرب ۵ نمایش داده می‌شود؛ &lt;code&gt;شروع&lt;/code&gt; شمارهٔ بیت نخست را تعیین می‌کند (برای صفحه‌ای که از میانهٔ شعر آغاز می‌شود، شمارهٔ نخستین بیت همان صفحه را بدهید).
* اگر برای بیتی خودتان ش، شو یا شچ بدهید، همان نمایش داده می‌شود و شمارش خودکار برای آن بیت کنار می‌رود (شمارنده همچنان جلو می‌رود).
* مصراع تنهای پایان بند (در حالت «متن») شمرده نمی‌شود.
* شمارنده در طول رندر یک صفحه نگه داشته می‌شود و با هر {{الگو|شعر}} از نو آغاز می‌شود (مگر در شعر چندصفحه‌ای؛ بخش بعد).

== نستعلیق ==
*نکته: در صورت استفاده از نستعلیق {{الگو|دارای نستعلیق}} را استفاده کنید تا اگر کاربر فونت نستعلیق را ندارد از آن را نصب و استفاده نماید.
{{دارای نستعلیق}}

دستورات زیر:
&lt;pre&gt;
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
چنین نتیجه می‌دهد:
{{شعر|نستعلیق}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{مصراع|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{مصراع|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
* '''چگونه کار می‌کند:''' پودمان خودِ الگوی {{الگو|نستعلیق}} را بسط می‌دهد و کلاس و استایل‌های قلم (&lt;code&gt;font-family&lt;/code&gt;، &lt;code&gt;font-size&lt;/code&gt;، &lt;code&gt;line-height&lt;/code&gt; و…) را که آن الگو می‌گذارد روی شعر می‌نشاند؛ پس هر تغییر در {{الگو|نستعلیق}} (و شیوه‌نامهٔ آن) خودکار به شعرها هم می‌رسد و به &lt;code&gt;Common.css&lt;/code&gt; یا ترتیب شیوه‌نامه‌ها وابسته نیست. اگر آن الگو در دسترس نباشد، فهرستِ قلمِ &lt;code&gt;cfg.nastaliqFonts&lt;/code&gt; به کار می‌رود.
* پارامتر &lt;code&gt;قلم&lt;/code&gt; وجود ندارد. برای قلمی دیگر، یا {{الگو|نستعلیق}} را تغییر دهید یا در {{الگو|شعر}} بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|سبک=font-family: Vazirmatn, serif}}&lt;/nowiki&gt;&lt;/code&gt;.
* قلم‌ها باید روی دستگاه خواننده نصب باشند (وب‌قلم بارگذاری نمی‌شود)؛ اگر نیستند، قلم پیش‌فرض نمایش داده می‌شود.
* اگر نستعلیق اعمال نمی‌شود: (۱) صفحهٔ شیوه‌نامهٔ شعر ([[الگو:شعر/styles.css]]) باید ساخته و از نوع «Sanitized CSS» باشد؛ (۲) قلم روی دستگاه نصب باشد؛ (۳) در &lt;code&gt;Common.css&lt;/code&gt; یا ابزارکی قاعدهٔ &lt;code&gt;!important&lt;/code&gt; برای &lt;code&gt;td&lt;/code&gt; یا &lt;code&gt;.nastaliq&lt;/code&gt; نباشد؛ (۴) اگر نوشته درشت‌تر از انتظار است، اندازهٔ قلم را در {{الگو|نستعلیق}} تنظیم کنید و قاعده‌های تکراریِ &lt;code&gt;.nastaliq&lt;/code&gt; را از &lt;code&gt;Common.css&lt;/code&gt; بردارید.

== پانویس ==
می‌توان در پایان یک مصراع پانویس (&lt;code&gt;&amp;lt;ref&amp;gt;&lt;/code&gt;) گذاشت. نشانهٔ پانویس از متن مصراع جدا می‌شود و بیرون از لبهٔ پایانی آویزان می‌ماند، پس در عرض و ترازبندی مصراع شمرده نمی‌شود و همهٔ مصراع‌ها هم‌اندازه می‌مانند:
&lt;pre&gt;
{{بیت|مصراع نخست&lt;ref&gt;منبع&lt;/ref&gt;|مصراع دوم}}
&lt;/pre&gt;
فقط پانویسی که در '''پایان''' مصراع باشد این‌گونه جدا می‌شود؛ پانویس میانهٔ مصراع همان‌جا می‌ماند.

== سبک، کلاس، شناسه، زبان و جهت ==
* اگر می‌خواهید برای شعر سبک اضافه‌ای به کار بگیرید از &lt;code&gt;سبک&lt;/code&gt; در {{الگو|شعر}} استفاده کنید:
*:برای رنگ پشت‌زمینهٔ دلخواه &lt;nowiki&gt;{{شعر|سبک=background: blue}}&lt;/nowiki&gt;
*:رنگ دلخواه برای متن &lt;nowiki&gt;{{شعر|سبک=color: white}}&lt;/nowiki&gt;
*:برای قرار نگرفتن در وسط &lt;nowiki&gt;{{شعر|سبک=margin: 0}}&lt;/nowiki&gt;
نمونه‌ای از ترکیب هر سه:{{سخ}}
&lt;pre&gt;
{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;

{{شعر|سبک=background: blue; margin: 0; color: white}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر}}

* در {{الگو|بیت}}، {{الگو|مصراع}} و… پارامتر &lt;code&gt;سبک&lt;/code&gt; روی خودِ مصراع‌ها اثر می‌گذارد (مثلاً برجسته‌کردن یک بیت: &lt;code&gt;&lt;nowiki&gt;{{بیت|…|…|سبک=font-weight:bold}}&lt;/nowiki&gt;&lt;/code&gt;). در {{الگو|شعر}} روی قاب بیرونی شعر می‌نشیند (پس &lt;code&gt;margin: 0&lt;/code&gt; شعر را به راست می‌برد).
* &lt;code&gt;کلاس&lt;/code&gt; یک کلاس CSS به شعر (در {{الگو|شعر}}) یا به همان ردیف (در بقیه) می‌افزاید؛ &lt;code&gt;شناسه&lt;/code&gt; به ردیف یک &lt;code&gt;id&lt;/code&gt; می‌دهد تا بتوان به آن بیت پیوند داد (مثلاً &lt;code&gt;[[#ب۱۲]]&lt;/code&gt; برای &lt;code&gt;شناسه=ب۱۲&lt;/code&gt;).
* &lt;code&gt;زبان&lt;/code&gt; (مثل &lt;code&gt;ar&lt;/code&gt;) در {{الگو|شعر}} برای ابیات عربی، انگلیسی و… است؛ &lt;code&gt;جهت&lt;/code&gt; (&lt;code&gt;rtl&lt;/code&gt; یا &lt;code&gt;ltr&lt;/code&gt;) در صورت ندادن، از زبان حدس زده می‌شود.
&lt;pre&gt;
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه:
{{شعر|زبان=en|عرض=خودکار}}
{{بیت|Shall I compare thee to a summer's day?|Thou art more lovely and more temperate}}
{{پایان شعر}}

== حالت «متن» ==
به‌جای نوشتن یک‌به‌یک {{الگو|بیت}}ها می‌توانید مصراع‌ها را خط‌به‌خط در پارامتر &lt;code&gt;متن&lt;/code&gt; بنویسید. در این حالت نیازی به {{الگو|پایان شعر}} نیست و همهٔ گزینه‌های {{الگو|شعر}} (عرض، ترازبندی، نستعلیق، شماره‌گذاری، …) به کار می‌آید.
&lt;pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
&lt;/pre&gt;
{{شعر|نستعلیق|شماره‌گذاری=1|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند

بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
}}
* هر دو خط پیاپی یک بیت می‌شوند. '''خط خالی = پایان بند''' (یک فاصله؛ اندازه‌اش با &lt;code&gt;فاصله=0.5em&lt;/code&gt; تنظیم می‌شود، و نمادش با &lt;code&gt;جداکننده بند&lt;/code&gt; یا &lt;code&gt;@نماد&lt;/code&gt;؛ بخش «بندها»). چند خط خالیِ پشت‌سرهم همچنان یک فاصله‌اند. اگر شمار خط‌های یک بند فرد باشد، خط آخر تنها و وسط‌چین می‌آید.
* &lt;code&gt;نوع&lt;/code&gt;: &lt;code&gt;بیت&lt;/code&gt; (پیش‌فرض)، &lt;code&gt;بیت۱&lt;/code&gt; (پلکانی)، &lt;code&gt;بیت نردبانی&lt;/code&gt;، یا &lt;code&gt;مصراع&lt;/code&gt; (هر خط یک مصراع جداگانه؛ شعر نو). برای پلکانی و نردبانی &lt;code&gt;تورفتگی&lt;/code&gt; را هم می‌توان داد، و &lt;code&gt;ترازبندی&lt;/code&gt; و &lt;code&gt;عرض&lt;/code&gt; برای همهٔ ردیف‌ها.
* با &lt;code&gt;نوع=مصراع&lt;/code&gt; هر &lt;code&gt;:&lt;/code&gt; ابتدای خط یک پله تورفتگی (&lt;code&gt;واحد تورفتگی&lt;/code&gt;، پیش‌فرض &lt;code&gt;1.5em&lt;/code&gt;) می‌دهد و ترازِ پیش‌فرض راست است؛ &lt;code&gt;تراز&lt;/code&gt; را می‌توانید عوض کنید.
* در &lt;code&gt;متن&lt;/code&gt; فقط متن ساده بنویسید (پیوند و پانویس مشکلی ندارند)؛ الگوهای {{الگو|بیت}} و {{الگو|مصراع}} را داخل آن نگذارید. علامت &lt;code&gt;=&lt;/code&gt; در متن مشکلی ندارد، ولی &lt;code&gt;|&lt;/code&gt; را با &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; بنویسید. این حالت ساختار الگو را کامل و بسته نگه می‌دارد و برای ویرایش دیداری هم مناسب‌تر است.

=== شعر نو در حالت «متن» ===
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;pre&gt;
{{شعر|نوع=مصراع|متن=
ای آدمها که بر ساحل نشسته‌اید
:شادمان بر ساحل
::ما در موج
}}
&lt;/pre&gt;

=== عوض‌کردن نوع ردیف در میانهٔ متن (خط‌های &lt;code&gt;@&lt;/code&gt;) ===
نوع پیش‌فرض را &lt;code&gt;نوع=&lt;/code&gt; مشخص می‌کند. اگر می‌خواهید در میانهٔ همان متن چند بیت نردبانی یا پلکانی یا یک مصراع تنها بیاید، یک '''خط جداگانه''' بنویسید که با &lt;code&gt;@&lt;/code&gt; آغاز شود؛ از آن خط به بعد نوعِ جدید برقرار است تا خط &lt;code&gt;@&lt;/code&gt; بعدی:
{| class=&quot;wikitable&quot;
! خط !! نوع ردیف‌های بعدی
|-
| &lt;code&gt;@بیت&lt;/code&gt; || بیت دومصراعی (دو ستون)
|-
| &lt;code&gt;@بیت۱&lt;/code&gt; (یا &lt;code&gt;@پلکانی&lt;/code&gt;، &lt;code&gt;@ضربدری&lt;/code&gt;) || بیت پلکانی
|-
| &lt;code&gt;@بیت نردبانی&lt;/code&gt; (یا &lt;code&gt;@نردبانی&lt;/code&gt;) || بیت نردبانی
|-
| &lt;code&gt;@مصراع&lt;/code&gt; (یا &lt;code&gt;@نو&lt;/code&gt;، &lt;code&gt;@نیمایی&lt;/code&gt;، &lt;code&gt;@آزاد&lt;/code&gt;) || هر خط یک مصراع جدا
|}
گزینه‌ها را می‌توان پس از نوع نوشت: &lt;code&gt;تورفتگی=&lt;/code&gt;، &lt;code&gt;تراز=&lt;/code&gt; (برای مصراع) و &lt;code&gt;ترازبندی=&lt;/code&gt;؛ مثلاً &lt;code&gt;@بیت۱ تورفتگی=10%&lt;/code&gt; یا &lt;code&gt;@مصراع تراز=وسط&lt;/code&gt;. (مقدارِ هر گزینه نباید فاصله داشته باشد.)
&lt;pre&gt;
{{شعر۲|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
&lt;/pre&gt;
{{شعر۲|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
@بیت نردبانی
بیخود از شعشعهٔ پرتو ذاتم کردند
باده از جام تجلی صفاتم دادند
@بیت۱ تورفتگی=10%
یوسف گم‌گشته بازآید بکنعان غم مخور
کلبهٔ احزان شود روزی گلستان غم مخور
@مصراع تراز=وسط
مصراع تنها در میانهٔ شعر
@بیت
عقل در سودای او حیران بماند
جان ز عجز انگشت در دندان بماند
}}
* هر خط &lt;code&gt;@&lt;/code&gt; گزینه‌های پیشین را کنار می‌گذارد و به پیش‌فرض‌های {{الگو|شعر}} برمی‌گردد (گزینه‌ها جمع نمی‌شوند)؛ پس &lt;code&gt;@بیت۱&lt;/code&gt; بدون گزینه، تورفتگی پیش‌فرض خودِ شعر را دارد.
* خط &lt;code&gt;@&lt;/code&gt; جفت‌شدنِ خط‌ها را قطع می‌کند: اگر پیش از آن خطی تنها مانده باشد، همان‌جا به‌صورت مصراع تنها (وسط‌چین) درمی‌آید. فاصلهٔ بند نمی‌گذارد (برای آن خط خالی بگذارید).
* در شعرِ &lt;code&gt;نوع=بیت&lt;/code&gt;، مصراع‌هایی که با &lt;code&gt;@مصراع&lt;/code&gt; می‌آیند شماره‌گذاری خودکار را نمی‌شمارند؛ در شعرِ &lt;code&gt;نوع=مصراع&lt;/code&gt; همهٔ خط‌ها (و بیت‌های &lt;code&gt;@بیت&lt;/code&gt;) شمرده می‌شوند.
* &lt;code&gt;@مصراع&lt;/code&gt; مانند &lt;code&gt;نوع=مصراع&lt;/code&gt; به‌طور پیش‌فرض راست‌چین است؛ برای وسط‌چین &lt;code&gt;تراز=وسط&lt;/code&gt; بدهید.
* خط &lt;code&gt;@&lt;/code&gt; می‌تواند خط نخست متن باشد. فاصلهٔ پس از &lt;code&gt;@&lt;/code&gt; مهم نیست. نوع یا گزینهٔ ناشناخته نادیده گرفته می‌شود و صفحه به ردهٔ پارامتر ناشناخته می‌رود.
* دو خطِ ویژهٔ &lt;code&gt;@نماد&lt;/code&gt; و &lt;code&gt;@فاصله&lt;/code&gt; نوع ردیف را عوض نمی‌کنند؛ آن‌ها بریدگیِ میان بندها را می‌سازند (بخش «نماد و فاصله در حالت «متن»»).
* خط &lt;code&gt;@&lt;/code&gt; با شعر چندصفحه‌ای هم کار می‌کند (ادغام ردیف ناتمام به نوعِ ردیف آخر/نخست وابسته است).

=== نشانه‌های درون‌خطی در حالت متن ===
(برگرفته از الگوی ppoem)
{| class=&quot;wikitable&quot;
! نشانه !! کاربرد
|-
| &lt;code&gt;&amp;gt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، راست‌چین
|-
| &lt;code&gt;&amp;lt;&amp;gt; متن&lt;/code&gt; || مصراعِ تنها، وسط‌چین
|-
| &lt;code&gt;۱۲ &amp;lt;&amp;lt;&amp;lt; متن&lt;/code&gt; || شمارهٔ سمت راست (مانند &lt;code&gt;ش=۱۲&lt;/code&gt;)
|-
| &lt;code&gt;متن &amp;gt;&amp;gt;&amp;gt; ۱۲&lt;/code&gt; || شمارهٔ سمت چپ (مانند &lt;code&gt;شچ=۱۲&lt;/code&gt;)
|}
نشانه‌های شماره روی هر یک از دو خطِ یک بیت هم کار می‌کنند، و نشانه‌های تراز روی خطِ تنها و مصراع‌های شعر نو:
&lt;pre&gt;
{{شعر۲|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}
&lt;/pre&gt;
{{شعر۲|متن=
۱۲ &lt;&lt;&lt; دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند &gt;&gt;&gt; ۱۳

&gt;&gt; مصراعِ تنها، راست‌چین

&lt;&gt; مصراعِ تنها، وسط‌چین
}}

== شعر چندصفحه‌ای (ویژهٔ ویکی‌نبشته) ==
وقتی شعر در چند «صفحه:» ادامه دارد، دو خواسته داریم: در پیش‌نمایش هر صفحه شعر کامل و بسته دیده شود، و در صفحهٔ اصلی (که صفحه‌ها با &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; درج می‌شوند) همهٔ صفحه‌ها یک جدول واحد باشند تا ستون‌ها در مرز صفحه جابه‌جا نشوند. پارامتر &lt;code&gt;ادامه&lt;/code&gt; هر دو را برآورده می‌کند:

{| class=&quot;wikitable&quot;
! صفحه !! بالای صفحه !! پایین صفحه
|-
| نخست || &lt;code&gt;&lt;nowiki&gt;{{شعر}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| میانی || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt;
|-
| آخر || &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; || &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;
|}
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|واندر آن ظلمت شب آب حیاتم دادند}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
* در فضای نام «صفحه» &lt;code&gt;ادامه&lt;/code&gt; نادیده گرفته می‌شود و هر صفحه کامل و بسته نمایش داده می‌شود.
* در صفحهٔ اصلی، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; جدول تازه باز نمی‌کند و &lt;code&gt;&lt;nowiki&gt;{{پایان شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; نمی‌بندد؛ پس صفحه‌ها به هم دوخته می‌شوند. اگر درج از میانهٔ شعر آغاز شود، &lt;code&gt;&lt;nowiki&gt;{{شعر|ادامه}}&lt;/nowiki&gt;&lt;/code&gt; خودش جدول را باز می‌کند.
* '''هم‌ترازی در مرز صفحه:''' چون عرض جدول ثابت است (بخش «چیدمان»)، حتی اگر صفحه‌ای بدون &lt;code&gt;ادامه&lt;/code&gt; باشد و جدول جدا بسازد، قاب شعر با صفحهٔ قبل هم‌اندازه و هم‌تراز می‌ماند؛ گزینه‌های &lt;code&gt;عرض&lt;/code&gt; و &lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بنویسید.
* گزینه‌های {{الگو|شعر}} (نستعلیق، عرض، سبک، شماره‌گذاری، جداکننده بند و…) را در هر صفحه تکرار کنید تا پیش‌نمایش درست باشد؛ در صفحهٔ اصلی فقط گزینه‌های صفحهٔ نخست اثر دارد و شماره‌گذاری خودکار از صفحهٔ قبل ادامه می‌یابد.
* اگر فقط بخشی از صفحه‌ها را درج می‌کنید و شعر در آخرین صفحهٔ درج‌شده تمام نمی‌شود، بعد از &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; بنویسید &lt;code&gt;&lt;nowiki&gt;{{پایان شعر}}&lt;/nowiki&gt;&lt;/code&gt;.
* این الگوها در صفحهٔ اصلی بدون پارامتر &lt;code&gt;ادامه&lt;/code&gt; همان‌طور که بود کار می‌کنند.

=== مصراع (یا بیت) ناتمام در پایان صفحه ===
گاهی مصراعی در پایان صفحه ناتمام می‌ماند و در صفحهٔ بعد ادامه دارد (یا مصراع دوم یک بیت به صفحهٔ بعد می‌رود). در ردیفِ آخرِ صفحه &lt;code&gt;ناتمام=بله&lt;/code&gt; و در نخستین ردیفِ صفحهٔ بعد &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید؛ در صفحهٔ اصلی این دو ردیف مصراع‌به‌مصراع یکی می‌شوند:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}
&lt;/pre&gt;
نتیجه در صفحهٔ اصلی (دو نیمه پشت سر هم نوشته شده‌اند و یک شعر می‌سازند):
{{شعر}}
{{بیت|دوش وقت سحر از غصه|واندر آن ظلمت شب آب|ناتمام=بله}}
{{پایان شعر|ادامه}}
{{شعر|ادامه}}
{{بیت|نجاتم دادند|حیاتم دادند|دنباله=بله}}
{{بیت|بیخود از شعشعهٔ پرتو ذاتم کردند|باده از جام تجلی صفاتم دادند}}
{{پایان شعر}}

* '''بیتی که میان دو مصراع بریده شده:''' در صفحهٔ اول فقط مصراع نخست را بنویسید و در صفحهٔ بعد مصراع اول را تهی بگذارید:
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر}}
{{بیت|دوش وقت سحر از غصه نجاتم دادند|ناتمام=بله}}
{{پایان شعر|ادامه}}
──── صفحهٔ ۲ ────
{{شعر|ادامه}}
{{بیت||واندر آن ظلمت شب آب حیاتم دادند|دنباله=بله}}
{{پایان شعر}}
&lt;/pre&gt;
* '''اتصال:''' دو تکه به‌طور پیش‌فرض با فاصله به هم می‌چسبند. برای واژهٔ بریده &lt;code&gt;اتصال=چسبیده&lt;/code&gt; و برای «می‌/رود» &lt;code&gt;اتصال=نیم‌فاصله&lt;/code&gt; را در ردیفِ &lt;code&gt;دنباله&lt;/code&gt; بدهید.
* ردیف‌های {{الگو|بیت}}، {{الگو|بیت۱}}، {{الگو|بیت نردبانی}} و {{الگو|مصراع}} هر کدام جداگانه ادغام می‌شوند؛ دو تکه باید از یک نوع الگو باشند.
* هر ردیف در شماره‌گذاری خودکار یک بار شمرده می‌شود و شماره‌ها را می‌توان در هر دو تکه داد (تکهٔ بعدی مقدم است).
* در فضای نام «صفحه» ردیفِ ناتمام با خط‌چین نشان داده می‌شود. ردیفی که ادامه‌اش هرگز نیاید همان‌طور که هست نمایش داده می‌شود و متنی گم نمی‌شود.
* ادغام به این تکیه دارد که الگوها در یک رندر به ترتیب اجرا شوند. اگر روزی در جایی متنِ ردیف ناتمام گم شد، مدیر پودمان می‌تواند &lt;code&gt;cfg.mergeRows = false&lt;/code&gt; کند: آن‌گاه هر تکه فوراً و به‌صورت ردیفِ جدا نمایش داده می‌شود.

=== شعر چندصفحه‌ای در حالت «متن» ===
در حالت &lt;code&gt;متن&lt;/code&gt; هر صفحه یک فراخوانی است: &lt;code&gt;ادامه=بعد&lt;/code&gt; (صفحهٔ نخست)، &lt;code&gt;ادامه=هر دو&lt;/code&gt; (میانی)، &lt;code&gt;ادامه=قبل&lt;/code&gt; (آخر)؛ و برای مصراع ناتمام &lt;code&gt;ناتمام=بله&lt;/code&gt; / &lt;code&gt;دنباله=بله&lt;/code&gt; (با &lt;code&gt;اتصال&lt;/code&gt;). در حالت متن «ادامه=بله» مبهم است و پذیرفته نمی‌شود.
&lt;pre&gt;
──── صفحهٔ ۱ ────
{{شعر|ادامه=بعد|ناتمام=بله|متن=
دوش وقت سحر از غصه نجاتم دادند
واندر آن ظلمت شب آب حیاتم دادند
بیخود از شعشعهٔ پرتو
باده از جام تجلی
}}
──── صفحهٔ ۲ ────
{{شعر|ادامه=قبل|دنباله=بله|متن=
ذاتم کردند
صفاتم دادند
}}
&lt;/pre&gt;
* اگر آخرین خطِ ناتمامِ صفحه فرد باشد، بیتی با مصراع نخست می‌شود و خط اول صفحهٔ بعد به‌طور خودکار مصراع دومِ همان بیت است؛ با &lt;code&gt;دنباله=اول&lt;/code&gt; یا &lt;code&gt;دنباله=دوم&lt;/code&gt; می‌توانید صریح بگویید کدام مصراع ادامه دارد.
* &lt;code&gt;بند=جدید&lt;/code&gt; در صفحهٔ ادامه، پیش از نخستین ردیف یک فاصلهٔ بند (یا ردیفِ نماد، اگر شعر &lt;code&gt;جداکننده بند&lt;/code&gt; دارد) می‌گذارد.

== نمایش در صفحه‌های باریک ==
مصراع‌های کنار هم در پنجرهٔ باریک جا نمی‌شوند؛ پس پیش‌فرض، شعر در پنجرهٔ باریک (تا حدود ۸۳۲ پیکسل) '''ستونی''' می‌شود: برای هر بیت شماره بالا، دو مصراع وسط‌چین زیر هم، و یک خط‌چین پس از آن (در بیت پلکانی پس از خط دوم). نمادِ میان دو مصراع و نسخهٔ نامرئیِ اندازه‌گیر پنهان می‌شوند؛ ردیفِ نمادِ میان بندها همچنان دیده می‌شود. در پنجره‌های کمی عریض‌تر، فاصلهٔ واژه‌ها در شعر دوطرفه اندکی کم می‌شود تا مصراع‌ها هنوز در یک خط جا شوند.
{| class=&quot;wikitable&quot;
! &lt;code&gt;تلفن=&lt;/code&gt; !! رفتار
|-
| &lt;code&gt;ستونی&lt;/code&gt; (پیش‌فرض) || در پنجرهٔ باریک ستونی؛ در پنجرهٔ عریض دوستونه.
|-
| &lt;code&gt;دوستونه&lt;/code&gt; || همیشه دوستونه؛ در پنجرهٔ بسیار باریک (تا ۴۸۰ پیکسل) فاصله‌ها کمتر می‌شود تا جا برای متن بماند.
|-
| &lt;code&gt;همیشه&lt;/code&gt; || همیشه ستونی، حتی در پنجرهٔ عریض.
|}

=== فضای نام «صفحه» ===
در «صفحه:» تصویر کنار متن است و ستونِ متن حدود نیمی از پنجره است؛ پس شعر زودتر باید ستونی شود. اما مرورگر پهنای واقعیِ ستونِ متن را به شیوه‌نامه نمی‌دهد (TemplateStyles از ''container query'' پشتیبانی نمی‌کند) و فقط پهنای پنجره در دسترس است. برای این‌که هر شعر نه زودتر از لازم ستونی شود و نه دیرتر، پودمان '''طولِ بلندترین مصراع''' را می‌سنجد و یکی از سه کلاس را روی شعر می‌گذارد؛ هر سطح آستانهٔ خودش را دارد:
{| class=&quot;wikitable&quot;
! سطح (کلاس) !! بلندترین مصراع !! فشرده‌شدن (فاصله‌ها کم می‌شود) !! ستونی‌شدن
|-
| کوتاه (&lt;code&gt;poem-w1&lt;/code&gt;) || تا ۲۰ نویسه || پنجرهٔ ≤ ۸۶em (۱۳۷۶px) || پنجرهٔ ≤ ۷۶em (۱۲۱۶px)
|-
| متوسط (&lt;code&gt;poem-w2&lt;/code&gt;) || تا ۳۰ نویسه || پنجرهٔ ≤ ۱۰۶em (۱۶۹۶px) || پنجرهٔ ≤ ۹۶em (۱۵۳۶px)
|-
| بلند (&lt;code&gt;poem-w3&lt;/code&gt;) || بیشتر از ۳۰ نویسه || پنجرهٔ ≤ ۱۲۶em (۲۰۱۶px) || پنجرهٔ ≤ ۱۱۶em (۱۸۵۶px)
|}
* '''فشرده‌شدن:''' پیش از ستونی‌شدن، فاصلهٔ دو مصراع از ≈ ۵٫۹em به ≈ ۳٫۴em می‌رسد (هنوز فاصلهٔ معقول) و ستون‌های شماره باریک می‌شوند؛ مصراع‌ها دست‌نخورده می‌مانند. بالاتر از آستانهٔ فشرده‌شدن، شعر با فاصله‌های عادی و دوستونه نمایش داده می‌شود.
* در حالت &lt;code&gt;متن&lt;/code&gt; سطح به‌طور خودکار از روی طول مصراع‌ها تعیین می‌شود. در حالت الگو (مصراع‌ها بعداً می‌رسند) پیش‌فرض «متوسط» است؛ برای شعرِ کوتاه‌مصراع بنویسید &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=کوتاه}}&lt;/nowiki&gt;&lt;/code&gt; و برای شعرِ بلندمصراع &lt;code&gt;&lt;nowiki&gt;{{شعر|طول مصراع=بلند}}&lt;/nowiki&gt;&lt;/code&gt; (یا شمار نویسهٔ بلندترین مصراع، مثلاً &lt;code&gt;طول مصراع=24&lt;/code&gt;).
* '''پایهٔ حساب:''' هر نویسه ≈ ۰٫۵em؛ جدولِ فشرده ≈ (نویسه + ۸٫۴)em و جدولِ عادی ≈ (نویسه + ۱۳٫۹)em پهنا می‌خواهد؛ ستونِ متن ≈ نیمی از پنجره منهای ۹em فرض شده (em در media query همیشه ۱۶px است). اگر قلمِ صفحه درشت‌تر است، عددها را در [[الگو:شعر/styles.css]] بالا ببرید.
* اگر پنجرهٔ «صفحه:»ی شما عمودی است (تصویر بالای متن) و ستونِ متن پهن است، برای آن شعر &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید تا هرگز ستونی نشود.
* پس از به‌روزرسانی پودمان، صفحه‌های «صفحه:»ی قدیمی با یک ویرایش تهی (null edit) یا پاک‌سازی (purge) کلاس سطح را می‌گیرند؛ تا آن زمان به‌عنوان «متوسط» رفتار می‌کنند.

== رده‌های پیگیری و خطاها ==
فقط در صفحه‌های اصلی و فضای نام «صفحه» (نه در الگو و پودمان):
* [[:رده:صفحه‌های دارای پارامتر ناشناخته در الگوهای شعر]] — پارامتر یا مقدار نادرست (عرض، ترازبندی، نماد، خط &lt;code&gt;@&lt;/code&gt; ناشناخته، …)، مصراع اضافه، «=» در مصراع، یا ادامهٔ ناسازگار.
* [[:رده:صفحه‌های دارای بیت ناقص]] — بیتی که فقط یک مصراع دارد (به‌جز ردیف‌های ناتمام/دنباله).
* [[:رده:صفحه‌های دارای خطا در پودمان شعر]] — خطای پیش‌بینی‌نشده (به‌جای شکستن صفحه، پیام قرمز نشان داده می‌شود).

== پرسش‌های رایج ==
{| class=&quot;wikitable&quot;
! مشکل !! راه‌حل
|-
| آغاز شعر در مرز دو صفحه جابه‌جا می‌شود || &lt;code&gt;عرض&lt;/code&gt;/&lt;code&gt;ترازبندی&lt;/code&gt; را در همهٔ صفحه‌ها یکسان بگذارید (یا ندهید: پیش‌فرض ثابت است) و صفحه‌ها را با &lt;code&gt;ادامه&lt;/code&gt; بدوزید.
|-
| در «صفحه:» شعر زیر هم (ستونی) نمایش داده می‌شود || بخش «فضای نام «صفحه»»: آستانه به طول مصراع بستگی دارد؛ برای شعرِ کوتاه‌مصراع &lt;code&gt;طول مصراع=کوتاه&lt;/code&gt;، و برای هرگز-ستونی‌نشدن &lt;code&gt;تلفن=دوستونه&lt;/code&gt; بگذارید.
|-
| مصراع‌ها بیش از اندازه می‌شکنند || &lt;code&gt;عرض&lt;/code&gt; یا &lt;code&gt;حداکثر عرض&lt;/code&gt; را بیشتر کنید؛ یا &lt;code&gt;عرض=خودکار&lt;/code&gt;.
|-
| نماد میان بندها نمی‌آید || در حالت الگو، الگوی {{الگو|جداکننده بند}} باید ساخته شده باشد (متنش &lt;code&gt;&lt;nowiki&gt;{{#invoke:شعر|divider}}&lt;/nowiki&gt;&lt;/code&gt;) یا از &lt;code&gt;&lt;nowiki&gt;{{بیت خالی|نماد=• • •}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید. در حالت «متن» خط &lt;code&gt;@نماد&lt;/code&gt; باید خطی جدا باشد و &lt;code&gt;جداکننده بند&lt;/code&gt; فقط جای خط‌های خالی را می‌گیرد.
|-
| چند خط خالی فاصلهٔ بزرگ‌تر نمی‌دهد || چند خط خالیِ پشت‌سرهم عمداً یک فاصله‌اند؛ برای فاصلهٔ بزرگ‌تر &lt;code&gt;@فاصله&lt;/code&gt; (یا &lt;code&gt;@فاصله 3em&lt;/code&gt;) بنویسید.
|-
| نستعلیق اعمال نمی‌شود || بخش «نستعلیق»، فهرست بررسی (۱) تا (۴).
|-
| &lt;code&gt;قلم=&lt;/code&gt; کار نمی‌کند || چنین پارامتری وجود ندارد (صفحه به ردهٔ پارامتر ناشناخته می‌رود). قلم را {{الگو|نستعلیق}} تعیین می‌کند، یا &lt;code&gt;سبک=font-family: …&lt;/code&gt; بدهید.
|-
| می‌خواهم یک بیتِ پلکانی وسط شعرِ دومصراعی بیاورم || در حالت متن خط &lt;code&gt;@بیت۱&lt;/code&gt; و بعد &lt;code&gt;@بیت&lt;/code&gt;؛ یا در حالت الگو، {{الگو|بیت۱}}.
|-
| شماره‌گذاری در صفحهٔ دوم از نو شروع می‌شود || در «صفحه:» طبیعی است (از &lt;code&gt;شروع&lt;/code&gt; می‌گیرد)؛ در صفحهٔ اصلی با &lt;code&gt;ادامه&lt;/code&gt; ادامه می‌یابد.
|-
| متن ردیف ناتمام نمایش داده نمی‌شود || صفحهٔ بعد را با &lt;code&gt;دنباله=بله&lt;/code&gt; بنویسید و درج کنید؛ یا {{الگو|پایان شعر}} بگذارید. اگر باز هم نشد: &lt;code&gt;cfg.mergeRows = false&lt;/code&gt;.
|-
| صفحه به ردهٔ «پارامتر ناشناخته» رفت || نام پارامتر یا مقدارش را بررسی کنید؛ «=» یا «|» در مصراع (از &lt;code&gt;&lt;nowiki&gt;{{=}}&lt;/nowiki&gt;&lt;/code&gt; و &lt;code&gt;&lt;nowiki&gt;{{!}}&lt;/nowiki&gt;&lt;/code&gt; استفاده کنید)؛ مصراع سوم؛ یا نمادی که &lt;code&gt;&amp;lt;&lt;/code&gt; &lt;code&gt;{&lt;/code&gt; &lt;code&gt;|&lt;/code&gt; &lt;code&gt;[&lt;/code&gt; و &lt;code&gt;&quot;&lt;/code&gt; دارد.
|-
| پیام قرمز «خطا در پودمان شعر» || پارامترها را بررسی کنید و خطا را در [[بحث پودمان:شعر]] گزارش کنید؛ صفحه نمی‌شکند.
|}

== نکات فنی ==
=== ساختار خروجی ===
هر شعر یک &lt;code&gt;div&lt;/code&gt; با یک جدول است؛ هر سطرِ جدول ۷ ستونی است (شماره | مصراع ۱ (۲ ستون) | شمارهٔ میانی | مصراع ۲ (۲ ستون) | شماره). در چیدمان ثابت یک ردیف نامرئی &lt;code&gt;.poem-sizer&lt;/code&gt; ستون‌ها را تعیین می‌کند؛ با &lt;code&gt;عرض=خودکار&lt;/code&gt; جدول بدون آن و بدون &lt;code&gt;.poem-fixed&lt;/code&gt; ساخته می‌شود.
&lt;pre&gt;
&lt;div class=&quot;poem poem-fixed poem-stack&quot; style=&quot;width:100%;max-width:50em;margin:0 auto&quot;&gt;
 &lt;table class=&quot;poem-table&quot; role=&quot;presentation&quot; style=&quot;width:100%;table-layout:fixed&quot;&gt;
  &lt;tr class=&quot;poem-sizer&quot;&gt; … ۷ سلول … &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-bayt&quot;&gt;
   &lt;td class=&quot;poem-num poem-num-r&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m1 poem-a-end&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۱&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-c&quot;&gt;&lt;/td&gt;
   &lt;td class=&quot;b poem-m poem-m2 poem-a-start&quot; colspan=&quot;2&quot;&gt;&lt;span class=&quot;beyt&quot;&gt;مصراع ۲&lt;/span&gt;&lt;/td&gt;
   &lt;td class=&quot;poem-num poem-num-l&quot;&gt;&lt;/td&gt;
  &lt;/tr&gt;
  &lt;tr class=&quot;poem-row poem-ornament&quot;&gt;&lt;td class=&quot;poem-ornament-cell&quot; colspan=&quot;7&quot;&gt;• • •&lt;/td&gt;&lt;/tr&gt;
 &lt;/table&gt;
&lt;/div&gt;
&lt;/pre&gt;

=== کلاس‌های CSS ===
{| class=&quot;wikitable&quot;
! کلاس !! روی چه !! کار
|-
| &lt;code&gt;poem&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; بیرونی || قاب شعر
|-
| &lt;code&gt;poem-fixed&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || چیدمان ثابت (جدول با ردیف اندازه‌گیر)
|-
| &lt;code&gt;poem-stack&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || امکان ستونی‌شدن در صفحهٔ باریک (نبود آن = &lt;code&gt;تلفن=دوستونه&lt;/code&gt;)
|-
| &lt;code&gt;poem-stack-always&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || همیشه ستونی (&lt;code&gt;تلفن=همیشه&lt;/code&gt;)
|-
| &lt;code&gt;poem-just&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || ترازبندی پهن در کل شعر
|-
| &lt;code&gt;poem-page&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || شعر در فضای نام «صفحه»
|-
| &lt;code&gt;poem-w1&lt;/code&gt;، &lt;code&gt;poem-w2&lt;/code&gt;، &lt;code&gt;poem-w3&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; (فقط فضای نام «صفحه») || طول مصراع: کوتاه، متوسط، بلند
|-
| &lt;code&gt;poem-table&lt;/code&gt;، &lt;code&gt;nastaliq&lt;/code&gt; || &lt;code&gt;table&lt;/code&gt; || جدول؛ کلاس نستعلیق
|-
| &lt;code&gt;poem-sizer&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئیِ تعیین‌کنندهٔ ستون‌ها (فقط چیدمان ثابت)
|-
| &lt;code&gt;poem-row&lt;/code&gt; + &lt;code&gt;poem-bayt&lt;/code&gt; / &lt;code&gt;poem-stagger&lt;/code&gt; (و &lt;code&gt;-1&lt;/code&gt;، &lt;code&gt;-2&lt;/code&gt;) / &lt;code&gt;poem-mesra&lt;/code&gt; / &lt;code&gt;poem-gap&lt;/code&gt; / &lt;code&gt;poem-ornament&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || نوع ردیف
|-
| &lt;code&gt;poem-skip&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیف نامرئی که جای «ادامه» می‌نشیند (تا خط خالی و &lt;code&gt;&amp;lt;p&amp;gt;&lt;/code&gt; پدید نیاید)
|-
| &lt;code&gt;poem-partial-end&lt;/code&gt;، &lt;code&gt;poem-partial-start&lt;/code&gt; || &lt;code&gt;tr&lt;/code&gt; || ردیفِ ناتمام/دنباله در پیش‌نمایش «صفحه:» (خط‌چین)
|-
| &lt;code&gt;poem-num&lt;/code&gt; (و &lt;code&gt;-r&lt;/code&gt;، &lt;code&gt;-c&lt;/code&gt;، &lt;code&gt;-l&lt;/code&gt;) || &lt;code&gt;td&lt;/code&gt; || ستون‌های شماره
|-
| &lt;code&gt;b&lt;/code&gt;، &lt;code&gt;poem-m&lt;/code&gt;، &lt;code&gt;poem-m1&lt;/code&gt;، &lt;code&gt;poem-m2&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول مصراع (&lt;code&gt;b&lt;/code&gt; و &lt;code&gt;beyt&lt;/code&gt; برای سازگاری با شیوه‌های قدیمی حفظ شده‌اند)
|-
| &lt;code&gt;poem-a-start&lt;/code&gt;، &lt;code&gt;poem-a-end&lt;/code&gt;، &lt;code&gt;poem-a-right&lt;/code&gt;، &lt;code&gt;poem-a-left&lt;/code&gt;، &lt;code&gt;poem-a-justify&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || ترازبندی مصراع
|-
| &lt;code&gt;poem-m-right&lt;/code&gt;، &lt;code&gt;poem-m-left&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || مصراع تنها با تراز راست/چپ
|-
| &lt;code&gt;beyt&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || متن مصراع
|-
| &lt;code&gt;poem-ref&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || پانویسِ آویزان در پایان مصراع
|-
| &lt;code&gt;poem-sz&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نسخهٔ نامرئیِ اندازه‌گیر (ترازبندی پهن)
|-
| &lt;code&gt;poem-sep&lt;/code&gt; || &lt;code&gt;span&lt;/code&gt; || نمادِ میان دو مصراع
|-
| &lt;code&gt;poem-ornament-cell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیفِ نمادِ میان بندها
|-
| &lt;code&gt;poem-gapcell&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول ردیف فاصله
|-
| &lt;code&gt;poem-st&lt;/code&gt; || &lt;code&gt;div&lt;/code&gt; || جعبهٔ هر خط در بیت پلکانیِ تورفتگی‌دار (چیدمان ثابت)
|-
| &lt;code&gt;poem-indent&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; || سلول فاصله‌گذار در بیت پلکانیِ تورفتگی‌دار (چیدمان خودکار)
|-
| &lt;code&gt;poem-s&lt;/code&gt;، &lt;code&gt;poem-g&lt;/code&gt; || &lt;code&gt;td&lt;/code&gt; در &lt;code&gt;.poem-sizer&lt;/code&gt; || ستون کناری و ستون میانی
|}

=== شیوه‌نامه ===
اندازه‌ها در [[الگو:شعر/styles.css]] تعریف شده‌اند (نشانی شیوه‌نامه را مدیر پودمان با &lt;code&gt;cfg.styles&lt;/code&gt; تعیین می‌کند):
{| class=&quot;wikitable&quot;
! انتخابگر !! مقدار !! کار
|-
| &lt;code&gt;.poem-g&lt;/code&gt; || &lt;code&gt;4.7em&lt;/code&gt; || ستون میانیِ چیدمان ثابت
|-
| &lt;code&gt;.poem-s&lt;/code&gt; || &lt;code&gt;3.4em&lt;/code&gt; || ستون‌های کناریِ چیدمان ثابت
|-
| &lt;code&gt;.poem-m&lt;/code&gt; || &lt;code&gt;0.6em&lt;/code&gt; || حاشیهٔ درونیِ هر مصراع (چپ و راست)
|-
| &lt;code&gt;.poem-num-c&lt;/code&gt; || &lt;code&gt;5.5em&lt;/code&gt; || ستون میانی در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num-r&lt;/code&gt;، &lt;code&gt;.poem-num-l&lt;/code&gt; || &lt;code&gt;4em&lt;/code&gt; || ستون‌های کناری در چیدمان هم‌اندازهٔ محتوا
|-
| &lt;code&gt;.poem-num&lt;/code&gt; || &lt;code&gt;85%&lt;/code&gt; || اندازهٔ شماره‌ها
|-
| &lt;code&gt;.poem-sep&lt;/code&gt; || &lt;code&gt;#b3362b&lt;/code&gt;، &lt;code&gt;90%&lt;/code&gt; || رنگ و اندازهٔ نمادِ میان دو مصراع
|-
| &lt;code&gt;.poem-ornament-cell&lt;/code&gt; || پررنگ || ردیفِ نمادِ میان بندها
|}
فاصلهٔ دو مصراع در حالت عادی ≈ ۴٫۷em + ۲×۰٫۶em ≈ ۵٫۹em است. آستانه‌های ستونی‌شدن (۵۲em برای صفحهٔ اصلی، و جدول بخش «فضای نام «صفحه»») و اندازه‌های حالت فشرده نیز همان‌جا و با توضیح آمده‌اند.

=== تنظیمات پودمان (&lt;code&gt;cfg&lt;/code&gt;) ===
مدیران پودمان می‌توانند پیش‌فرض‌ها را در &lt;code&gt;cfg&lt;/code&gt; بالای [[پودمان:شعر]] عوض کنند:
{| class=&quot;wikitable&quot;
! کلید !! پیش‌فرض !! کار
|-
| &lt;code&gt;styles&lt;/code&gt; || &lt;code&gt;Template:شعر۲/styles.css&lt;/code&gt; || صفحهٔ TemplateStyles
|-
| &lt;code&gt;pageNs&lt;/code&gt; || &lt;code&gt;104&lt;/code&gt; || شمارهٔ فضای نام «صفحه»
|-
| &lt;code&gt;mesraUnit&lt;/code&gt; || &lt;code&gt;1.5em&lt;/code&gt; || اندازهٔ هر &lt;code&gt;:&lt;/code&gt; در شعر نو
|-
| &lt;code&gt;defaultWidth&lt;/code&gt; || &lt;code&gt;100%&lt;/code&gt; || عرض پیش‌فرض؛ &lt;code&gt;'auto'&lt;/code&gt; رفتار هم‌اندازهٔ محتوا را برای همهٔ شعرها برمی‌گرداند
|-
| &lt;code&gt;maxWidth&lt;/code&gt; || &lt;code&gt;50em&lt;/code&gt; || سقف عرض (وقتی عرض داده نشده)
|-
| &lt;code&gt;justDefault&lt;/code&gt; || &lt;code&gt;{ bayt = 'inner', stagger = 'edge' }&lt;/code&gt; || ترازبندی پیش‌فرض هر نوع بیت
|-
| &lt;code&gt;justifyMinRatio&lt;/code&gt; || &lt;code&gt;0.7&lt;/code&gt; || در ترازبندی پهن، کمترین نسبتِ کوتاه‌ترین به بلندترین مصراعِ بیت برای کشیده‌شدن
|-
| &lt;code&gt;nastaliqTemplate&lt;/code&gt; || &lt;code&gt;نستعلیق&lt;/code&gt; || الگوی ویکی که نمای نستعلیق از آن گرفته می‌شود
|-
| &lt;code&gt;nastaliqFonts&lt;/code&gt; || فهرست قلم‌های نستعلیق || آخرین چاره، فقط اگر آن الگو در دسترس نبود
|-
| &lt;code&gt;separator&lt;/code&gt; || &lt;code&gt;''&lt;/code&gt; (بدون نماد) || نمادِ میان دو مصراعِ همهٔ شعرها
|-
| &lt;code&gt;ornament&lt;/code&gt; || &lt;code&gt;❖&lt;/code&gt; || نمادِ &lt;code&gt;جداکننده=بله&lt;/code&gt;
|-
| &lt;code&gt;stanzaOrnament&lt;/code&gt; || &lt;code&gt;• • •&lt;/code&gt; || نمادِ پیش‌فرضِ &lt;code&gt;جداکننده بند&lt;/code&gt;، &lt;code&gt;@نماد&lt;/code&gt; و {{الگو|جداکننده بند}}
|-
| &lt;code&gt;hemiShort&lt;/code&gt;، &lt;code&gt;hemiMedium&lt;/code&gt; || &lt;code&gt;20&lt;/code&gt;، &lt;code&gt;30&lt;/code&gt; || مرزِ طول مصراع (نویسه) برای سطح‌های «کوتاه» و «متوسط» در فضای نام «صفحه»
|-
| &lt;code&gt;mergeRows&lt;/code&gt; || &lt;code&gt;true&lt;/code&gt; || ادغام ردیف ناتمام با دنباله‌اش
|-
| &lt;code&gt;cats&lt;/code&gt; || — || نام رده‌های پیگیری
|}
فهرست &lt;code&gt;nastaliqFonts&lt;/code&gt; باید با فهرست قلم در {{الگو|نستعلیق}} سازگار باشد.

=== ساخت الگوها ===
متن هر الگو یک فراخوانی پودمان است، مثلاً برای الگوی تازهٔ {{الگو|جداکننده بند}}:
&lt;pre&gt;
&lt;includeonly&gt;{{#invoke:شعر|divider}}&lt;/includeonly&gt;&lt;noinclude&gt;{{توضیحات}}&lt;/noinclude&gt;
&lt;/pre&gt;
نقطه‌های ورود: &lt;code&gt;open&lt;/code&gt;، &lt;code&gt;close&lt;/code&gt;، &lt;code&gt;bayt&lt;/code&gt;، &lt;code&gt;stagger&lt;/code&gt;، &lt;code&gt;ladder&lt;/code&gt;، &lt;code&gt;mesra&lt;/code&gt;، &lt;code&gt;emptyBayt&lt;/code&gt;، &lt;code&gt;emptyMesra&lt;/code&gt;، &lt;code&gt;divider&lt;/code&gt;.

=== یادداشت‌های فنی ===
* {{الگو|شعر}} و {{الگو|پایان شعر}} باید هر دو از یک نسخه باشند: &lt;code&gt;&amp;lt;div class=&quot;poem&quot;&amp;gt;&amp;lt;table&amp;gt;&lt;/code&gt; را اولی باز و دومی می‌بندد.
* تشخیص فضای نام «صفحه» بر پایهٔ شمارهٔ ۱۰۴ است (&lt;code&gt;cfg.pageNs&lt;/code&gt;).
* رده‌های پیگیری فقط در صفحهٔ اصلی و فضاهای نام محتوایی سفارشی (مثل «صفحه») افزوده می‌شوند.
* دوختن صفحه‌ها، ادغام ردیف ناتمام و شماره‌گذاری خودکار به این تکیه دارند که الگوها در یک رندر به ترتیب اجرا شوند (رندر کلاسیک MediaWiki و &lt;code&gt;&amp;lt;pages/&amp;gt;&lt;/code&gt; چنین‌اند). در رندرهایی که هر الگو جداگانه بسط داده شود (مثلاً برخی خوانش‌های Parsoid) این سه کار نمی‌کنند؛ شعر همچنان درست و هم‌تراز نمایش داده می‌شود چون قاب ثابت است.
* هر خطای پیش‌بینی‌نشده به‌جای شکستن صفحه، پیامی قرمز و ردهٔ خطا می‌دهد.

== الگوهای مرتبط ==
* [[الگو:بیت]] برای نوشتن بیت‌ها
* [[الگو:بیت۱]] برای بیت‌های پلکانی
* [[الگو:بیت نردبانی]] برای بیت‌های نردبانی
* [[الگو:مصراع]] برای نوشتن تک مصراع‌ها
* [[الگو:بیت خالی]] و [[الگو:مصراع خالی]] برای فاصله
* [[الگو:جداکننده بند]] برای نماد میان بندها
* [[الگو:پایان شعر]] برای تمام کردن الگو
* [[الگو:نستعلیق]] برای نوشتن متن‌های دیگر با خط نستعلیق

== داده‌های الگو ==
&lt;templatedata&gt;
{
  &quot;description&quot;: &quot;آغاز شعر (در حالت «متن»: کل شعر). همهٔ گزینه‌هایی که برای کل شعر اثر دارند اینجا داده می‌شوند.&quot;,
  &quot;params&quot;: {
    &quot;1&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام نخست&quot;,
      &quot;description&quot;: &quot;گزینهٔ بی‌نام: «نستعلیق» نمای نستعلیق را روشن می‌کند؛ «ادامه» یعنی این صفحه ادامهٔ شعرِ صفحهٔ پیش است (فقط حالت الگو).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;2&quot;: {
      &quot;label&quot;: &quot;گزینهٔ بی‌نام دوم&quot;,
      &quot;description&quot;: &quot;مانند گزینهٔ بی‌نام نخست؛ هر دو را می‌توان نوشت.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;suggestedvalues&quot;: [
        &quot;نستعلیق&quot;,
        &quot;ادامه&quot;
      ]
    },
    &quot;عرض&quot;: {
      &quot;label&quot;: &quot;عرض&quot;,
      &quot;description&quot;: &quot;عرض قاب شعر. عدد بدون واحد پیکسل است. «خودکار» یعنی جدولِ هم‌اندازهٔ محتوا (وسط‌چین). اگر فقط «عرض» بدهید سقف عرض ۱۰۰٪ می‌شود.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;width&quot;
      ]
    },
    &quot;حداکثر عرض&quot;: {
      &quot;label&quot;: &quot;حداکثر عرض&quot;,
      &quot;description&quot;: &quot;سقف عرض قاب (وقتی عرض ثابت است). «بدون» (یا «none»، «نامحدود») یعنی بی‌سقف.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;max-width&quot;
      ]
    },
    &quot;تلفن&quot;: {
      &quot;label&quot;: &quot;رفتار در صفحهٔ باریک&quot;,
      &quot;description&quot;: &quot;«ستونی»: در پنجرهٔ باریک هر بیت دو مصراعِ زیر هم می‌شود؛ «دوستونه»: همیشه دو ستون (در پنجرهٔ بسیار باریک با فاصلهٔ کمتر)؛ «همیشه»: همیشه ستونی.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;phone&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;ستونی&quot;,
        &quot;دوستونه&quot;,
        &quot;همیشه&quot;
      ]
    },
    &quot;ترازبندی&quot;: {
      &quot;label&quot;: &quot;ترازبندی&quot;,
      &quot;description&quot;: &quot;ترازبندی مصراع‌ها در جایگاهشان برای همهٔ ابیات (در هر ردیف: فقط برای همان ردیف). «میانه»: مصراع‌ها به محور میانی می‌چسبند؛ «لبه»: مصراع نخست به راست و دوم به چپ؛ «پهن»: دوطرفه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;justify&quot;,
        &quot;تراز‌بندی&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;میانه&quot;,
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;,
        &quot;پهن&quot;,
        &quot;لبه&quot;
      ]
    },
    &quot;جداکننده&quot;: {
      &quot;label&quot;: &quot;نماد میان دو مصراع&quot;,
      &quot;description&quot;: &quot;نمادی میان دو مصراعِ هر بیت، در ستون میانی (اگر شمارهٔ میانی «شو» نیامده باشد). در نمایش ستونی پنهان می‌شود. در هر ردیف هم می‌توان داد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;separator&quot;
      ]
    },
    &quot;جداکننده بند&quot;: {
      &quot;label&quot;: &quot;نماد میان بندها&quot;,
      &quot;description&quot;: &quot;ردیفِ نمادِ سراسری و وسط‌چین در هر بریدگیِ بند: در حالت «متن» به‌جای هر خط خالی، و در حالت الگو به‌جای هر «بیت خالی» (بی‌ارتفاع). برای نمادِ تک‌به‌تک از خط «@نماد» یا الگوی «جداکننده بند» استفاده کنید.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza-separator&quot;,
        &quot;جداکنندهٔ بند&quot;,
        &quot;نماد بند&quot;
      ]
    },
    &quot;متن&quot;: {
      &quot;label&quot;: &quot;متن شعر&quot;,
      &quot;description&quot;: &quot;کل شعر به‌صورت خط‌های ساده در یک فراخوانی: هر دو خط پیاپی یک بیت، خط خالی = پایان بند. در این حالت به «پایان شعر» نیازی نیست.&quot;,
      &quot;type&quot;: &quot;content&quot;,
      &quot;aliases&quot;: [
        &quot;text&quot;
      ]
    },
    &quot;نوع&quot;: {
      &quot;label&quot;: &quot;نوع ردیف‌ها&quot;,
      &quot;description&quot;: &quot;نوع پیش‌فرض ردیف‌ها در حالت «متن». با «نوع=مصراع» ردیف‌های «مصراع» هم در شماره‌گذاری خودکار شمرده می‌شوند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;type&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بیت&quot;,
        &quot;بیت۱&quot;,
        &quot;بیت نردبانی&quot;,
        &quot;مصراع&quot;
      ]
    },
    &quot;تراز&quot;: {
      &quot;label&quot;: &quot;تراز مصراع‌های تنها&quot;,
      &quot;description&quot;: &quot;تراز مصراع‌های تنها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;align&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;وسط&quot;,
        &quot;راست&quot;,
        &quot;چپ&quot;
      ]
    },
    &quot;تورفتگی&quot;: {
      &quot;label&quot;: &quot;تورفتگی&quot;,
      &quot;description&quot;: &quot;تورفتگی ردیف‌های پلکانی/نردبانی در حالت «متن». بدون آن هر مصراع در نیمهٔ خودش می‌نشیند.&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent&quot;
      ]
    },
    &quot;واحد تورفتگی&quot;: {
      &quot;label&quot;: &quot;اندازهٔ هر پله&quot;,
      &quot;description&quot;: &quot;اندازهٔ هر «:» در شعر نو («نوع=مصراع»).&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;indent-unit&quot;,
        &quot;واحد‌تورفتگی&quot;
      ]
    },
    &quot;فاصله&quot;: {
      &quot;label&quot;: &quot;فاصلهٔ میان بندها&quot;,
      &quot;description&quot;: &quot;ارتفاع فاصلهٔ میان بندها در حالت «متن».&quot;,
      &quot;type&quot;: &quot;line&quot;,
      &quot;aliases&quot;: [
        &quot;gap&quot;
      ]
    },
    &quot;بند&quot;: {
      &quot;label&quot;: &quot;بند تازه&quot;,
      &quot;description&quot;: &quot;در حالت «متن» و صفحهٔ ادامه: پیش از نخستین ردیف یک فاصلهٔ بند (یا نمادِ «جداکننده بند») می‌گذارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;stanza&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;جدید&quot;
      ]
    },
    &quot;شماره‌گذاری&quot;: {
      &quot;label&quot;: &quot;شماره‌گذاری خودکار&quot;,
      &quot;description&quot;: &quot;«بله»: شمارهٔ همهٔ ابیات؛ یک عدد مثل «5»: هر پنجمین بیت؛ «نه» (یا «0»): خاموش.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;numbering&quot;,
        &quot;شماره&quot;,
        &quot;شمارهگذاری&quot;
      ]
    },
    &quot;شروع&quot;: {
      &quot;label&quot;: &quot;شمارهٔ نخست&quot;,
      &quot;description&quot;: &quot;شمارهٔ بیت نخست.&quot;,
      &quot;type&quot;: &quot;number&quot;,
      &quot;aliases&quot;: [
        &quot;start&quot;
      ]
    },
    &quot;سمت&quot;: {
      &quot;label&quot;: &quot;سمت شماره&quot;,
      &quot;description&quot;: &quot;سمت نمایش شمارهٔ خودکار. در ردیف‌هایی که ستون میانی ندارند (پلکانی، مصراع) «وسط» همان «چپ» است.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;side&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;چپ&quot;,
        &quot;راست&quot;,
        &quot;وسط&quot;
      ]
    },
    &quot;ارقام&quot;: {
      &quot;label&quot;: &quot;رقم‌ها&quot;,
      &quot;description&quot;: &quot;تبدیل رقم‌های شماره‌ها. مقداری که نشانه‌گذاری دارد (پیوند، قالب‌بندی) دست‌نخورده می‌ماند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;digits&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فارسی&quot;,
        &quot;لاتین&quot;,
        &quot;بدون تغییر&quot;
      ]
    },
    &quot;نستعلیق&quot;: {
      &quot;label&quot;: &quot;نمای نستعلیق&quot;,
      &quot;description&quot;: &quot;نمای نستعلیق؛ کلاس و قلم را خودِ الگوی «نستعلیق» تعیین می‌کند. معادل نوشتن «نستعلیق» به‌صورت بی‌نام («{{شعر|نستعلیق}}»).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;nastaliq&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;سبک&quot;: {
      &quot;label&quot;: &quot;سبک CSS&quot;,
      &quot;description&quot;: &quot;سبک CSS روی قاب بیرونی شعر (با «عرض=خودکار»: روی جدول).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;style&quot;
      ]
    },
    &quot;کلاس&quot;: {
      &quot;label&quot;: &quot;کلاس CSS&quot;,
      &quot;description&quot;: &quot;کلاسِ افزوده به قاب شعر.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;class&quot;
      ]
    },
    &quot;زبان&quot;: {
      &quot;label&quot;: &quot;زبان&quot;,
      &quot;description&quot;: &quot;برای ابیات غیرفارسی؛ خصوصیت «lang» را می‌گذارد و «جهت» را از آن حدس می‌زند.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;lang&quot;
      ]
    },
    &quot;جهت&quot;: {
      &quot;label&quot;: &quot;جهت&quot;,
      &quot;description&quot;: &quot;جهت متن.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;dir&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;rtl&quot;,
        &quot;ltr&quot;
      ]
    },
    &quot;ادامه&quot;: {
      &quot;label&quot;: &quot;ادامه از/به صفحهٔ دیگر&quot;,
      &quot;description&quot;: &quot;شعر چندصفحه‌ای: این صفحه ادامهٔ شعرِ صفحهٔ پیش است («قبل») و/یا در صفحهٔ بعد ادامه دارد («بعد»، فقط حالت «متن»). در حالت «متن»، «ادامه=بله» مبهم است و پذیرفته نمی‌شود.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continue&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;قبل&quot;,
        &quot;بعد&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;ناتمام&quot;: {
      &quot;label&quot;: &quot;ردیف آخر ناتمام&quot;,
      &quot;description&quot;: &quot;حالت «متن»: آخرین ردیفِ این صفحه در صفحهٔ بعد ادامه دارد.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;unfinished&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;نه&quot;
      ]
    },
    &quot;دنباله&quot;: {
      &quot;label&quot;: &quot;ردیف نخست دنباله&quot;,
      &quot;description&quot;: &quot;حالت «متن»: نخستین ردیف ادامهٔ ردیف ناتمامِ صفحهٔ پیش است. «اول»/«دوم»: کدام مصراع ادامه دارد (پیش‌فرض: خودکار).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;continued&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;بله&quot;,
        &quot;اول&quot;,
        &quot;دوم&quot;,
        &quot;هر دو&quot;
      ]
    },
    &quot;اتصال&quot;: {
      &quot;label&quot;: &quot;نحوهٔ چسباندن&quot;,
      &quot;description&quot;: &quot;نحوهٔ چسباندن دو تکهٔ یک مصراع در مرز صفحه.&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;join&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;فاصله&quot;,
        &quot;چسبیده&quot;,
        &quot;نیم‌فاصله&quot;
      ]
    },
    &quot;طول مصراع&quot;: {
      &quot;label&quot;: &quot;طول مصراع&quot;,
      &quot;description&quot;: &quot;فقط فضای نام «صفحه»: تعیین دستیِ آستانهٔ ستونی‌شدن بر پایهٔ طول بلندترین مصراع («کوتاه» تا ۲۰ نویسه، «متوسط» تا ۳۰، «بلند» بیشتر؛ یا خودِ شمار نویسه).&quot;,
      &quot;type&quot;: &quot;string&quot;,
      &quot;aliases&quot;: [
        &quot;hemistich-length&quot;,
        &quot;طول‌مصراع&quot;
      ],
      &quot;suggestedvalues&quot;: [
        &quot;کوتاه&quot;,
        &quot;متوسط&quot;,
        &quot;بلند&quot;,
        &quot;خودکار&quot;
      ]
    }
  },
  &quot;paramOrder&quot;: [
    &quot;1&quot;,
    &quot;2&quot;,
    &quot;عرض&quot;,
    &quot;حداکثر عرض&quot;,
    &quot;تلفن&quot;,
    &quot;ترازبندی&quot;,
    &quot;جداکننده&quot;,
    &quot;جداکننده بند&quot;,
    &quot;متن&quot;,
    &quot;نوع&quot;,
    &quot;تراز&quot;,
    &quot;تورفتگی&quot;,
    &quot;واحد تورفتگی&quot;,
    &quot;فاصله&quot;,
    &quot;بند&quot;,
    &quot;شماره‌گذاری&quot;,
    &quot;شروع&quot;,
    &quot;سمت&quot;,
    &quot;ارقام&quot;,
    &quot;نستعلیق&quot;,
    &quot;سبک&quot;,
    &quot;کلاس&quot;,
    &quot;زبان&quot;,
    &quot;جهت&quot;,
    &quot;ادامه&quot;,
    &quot;ناتمام&quot;,
    &quot;دنباله&quot;,
    &quot;اتصال&quot;,
    &quot;طول مصراع&quot;
  ]
}
&lt;/templatedata&gt;</text>
      <sha1>jmjf4psvzz2yduvy7d0r4w7ei4mbudf</sha1>
    </revision>
  </page>
</mediawiki>