نمایش مبدأ برای الگو:شعر/توضیحات

{{زیرصفحه توضیحات}}
این الگو برای نمایش اشعار به کار می‌رود.

=== کاربرد ===
قبل از بیت‌های شعر باید از الگوی <nowiki>{{شعر}}</nowiki> استفاده کنید. برای هر بیت از شعر، به صورت زیر از الگوی '''ب''' (مخفف ''بیت'') استفاده کنید:

<nowiki>{{ب|مصراع اول|مصراع دوم}}</nowiki>

در پایان شعر نیز باید از الگوی <nowiki>{{پایان شعر}}</nowiki> استفاده کنید.

این الگو برای نوشتن شعر در ویکی‌پدیا به کار می‌آید.

=== نمونه ===
دستورهای زیر:
<pre>
{{شعر}}
{{ب|دوش وقتِ سحر از غصه نجاتم دادند|وَاندر آن ظلمتِ شب آب حیاتم دادند}}
{{م|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{م|باده از جام تجلیّ صفاتم دادند}}
{{پایان شعر}}
</pre>

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

دستورات زیر:
<pre>
{{شعر|نستعلیق}}
{{ب|دوش وقتِ سحر از غصه نجاتم دادند|وَاندر آن ظلمتِ شب آب حیاتم دادند}}
{{م|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{م|باده از جام تجلیّ صفاتم دادند}}
{{پایان شعر}}
</pre>
چنین نتیجه می‌دهد:
{{شعر|نستعلیق}}
{{ب|دوش وقتِ سحر از غصه نجاتم دادند|وَاندر آن ظلمتِ شب آب حیاتم دادند}}
{{م|بیخود از شعشعهٔ پرتو ذاتم کردند}}
{{م|باده از جام تجلیّ صفاتم دادند}}
{{پایان شعر}}

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

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

نمونه:

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

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

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