الگو:شعر۲/توضیحات

<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.48.0-wmf.1</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>الگو:شعر۲/توضیحات</title>
    <ns>10</ns>
    <id>98249</id>
    <revision>
      <id>305364</id>
      <parentid>305362</parentid>
      <timestamp>2026-10-27T13:45:27Z</timestamp>
      <contributor>
        <username>Hanooz</username>
        <id>17889</id>
      </contributor>
      <origin>305364</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="117583" sha1="9w4goklm55vp6onxylnzcbv0yfqb8r9" 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>9w4goklm55vp6onxylnzcbv0yfqb8r9</sha1>
    </revision>
  </page>
</mediawiki>