2024-03-26T14:29:30Z

Abdalla:

<noinclude>
يستخدم لتنسيق أبيات الشعر؛ مثلا:
{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
يا الطبيعة الواديك ساكن مافي متلك قط في الأماكن
يا جمال النال في ثراكن يا حلاة البرعن أراكن
بي قفاهن تور قرنو ماكن لا غشن لا شافن مساكن
. في الخزام والشيح والبراح .
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
يا الطبيعة الواديك ساكن مافي متلك قط في الأماكن
يا جمال النال في ثراكن يا حلاة البرعن أراكن
بي قفاهن تور قرنو ماكن لا غشن لا شافن مساكن
. في الخزام والشيح والبراح .
</div>}}

== قواعد التنسيق ==

=== التشطير ===

أضف مسافتين أو أكثر بين أشطر البيت؛ شطرين في الغالب وأربعة كحد أقصى؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
ليه كفّك اتحنّن وليه قلبك القاسي ما فيه ليّ حنان؟
يا الراقص الفنّان حبّك ملك قلبي وجنّنت عقلي جنان
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
ليه كفّك اتحنّن وليه قلبك القاسي ما فيه ليّ حنان؟
يا الراقص الفنّان حبّك ملك قلبي وجنّنت عقلي جنان
</div>
}}

أضف نقطة "." في بداية ونهاية السطر لمحاذاة البيت إلى الوسط.

استخدام نقطتين ".." للتنصيص بدل نقطة واحدة تجعل عرض النص مماثلاً لعرض شطر البيت، ممّا يناسب أبيات "القفلة".

الأبيات الطويلة سيتم قسمتها تلقائيّا على سطرين.

لفرض هذا التنسيق اختياريّا، أكتب عجز كلّ بيت في سطر منفصل، مع إضافة مسافتين أو أكثر في بداية السطر؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
يإحساسي بيك مااظن في حاجة بتوصفه
آمنت بيك، يا ألطف إنسان أعرفه
إنسان فريد لاح من بعيد زي أحلى عيد
زار عالمي وقال ليّ داير استكشفه
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
إحساسي بيك مااظن في حاجة بتوصفه
آمنت بيك، يا ألطف إنسان أعرفه
إنسان فريد لاح من بعيد زي أحلى عيد
زار عالمي وقال ليّ داير استكشفه
فتّش معاي لامن لقى الإنسان جواي
فكّاه من قيد السنين الكتّفه
حيّاه بي رقّة ولطافة، وباحترام
ردّ السلام إنساني رحّب، ضيّفه
</div>
}}

يمكن المزاوجة بين أعداد مختلفة من الأشطر؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
لـقيت اليـوم من أهـوى وقــلبي ســائرٌ وِفقه
رفـيقٌ غايةٌ في الحـسـن حـقّــا نعمـة الرفقة
رقـــيــقٌ وافــرٌ خـُلـقــا حــرامٌ بــعـده الـرقّة
شقيق القلب مهما غاب مهـما زادت الشُقّة
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
لـقيت اليـوم من أهـوى وقــلبي ســائرٌ وِفقه
رفـيقٌ غايةٌ في الحـسـن حـقّــا نعمـة الرفقة
رقـــيــقٌ وافــرٌ خـُلـقــا حــرامٌ بــعـده الـرقّة
شقيق القلب مهما غاب مهـما زادت الشُقّة
</div>
}}

كخيار بديل لقطع الكلمات:

{{تنصيص|1=
<div class="abyat">
لـقيت اليـوم من أهـوى وقــلبي ســائرٌ وِفقه
رفـيقٌ غايةٌ في الحـســ ـن حـقّــا نعمـة الرفقة
رقـــيــقٌ وافــرٌ خـُلـقــا حــرامٌ بــعـده الـرقّة
شقيق القلب مهما غا ب مهـما زادت الشُقّة
</div>
}}

=== المحاذاة ===

المحاذاة في كلّ شطر تكون عند أوّل وآخر حرف، وتكون علامات الترقيم وغيرها خارج حد المحاذاة، وذلك بغرض محاذاة نصّ البيت وحرف القافية كناحية جماليّة؛ مثلا:
{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
لو قدرت غيب عليّ وابقى بي وصلك ضنين
يا حياتي ونور عينيّ وين تروح من حبّي وين؟!
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
لو قدرت غيب عليّ وابقى بي وصلك ضنين
يا حياتي ونور عينيّ وين تروح من حبّي وين؟!
</div>
}}

بدلاً عن:

{{تنصيص|1=
<div class="abyat">
لو قدرت غيب عليّ وابقى بي وصلك ضنين
يا حياتي ونور عينيّ {}{وين تروح من حبّي وين؟!}{}
</div>
}}

القاعدة بسيطة، وهي اعتبار أصل شطر البيت ما بين أوّل وآخر حرف، وفصل الترقيم ونحوه قبل وبعد المحاذاة. يستثنى من ذلك النقاط ".."، إثنتان أو أكثر، التي تستخدم عادة مكان التفعيلات الناقصة؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
حان الزفاف .. .. وانا حالي كيفن بوصفو؟
ياريت هواك لي ما انقسم ولا قلبي ريدك نزّفو
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
حان الزفاف .. .. وانا حالي كيفن بوصفو؟
ياريت هواك لي ما انقسم ولا قلبي ريدك نزّفو
</div>
}}

إذا لم يكن التنسيق التلقائي بالصورة المطلوبة فيمكن تحديد الأقسام الثلاثة لشطر البيت باستخدام أقواس متعرّجة لتنصيص الأجزاء:
::{ترقيم سابق}{نص أساسي}{ترقيم لاحق}
لاحظ ضرورة وجود الأقواس الثلاثة، حتّى لو كانت فارغة؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
وأقول تدّيني بس لايك بتعمل ليّ subsistence
واتفاعل وأكون آكتيڤ والاقيك انتا passive tense
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
وأقول تدّيني بس لايك بتعمل ليّ subsistence
واتفاعل وأكون آكتيڤ والاقيك انتا passive tense
</div>
}}

بسبب اعتبار "ڤ" خارج نطاق الحروف في نسخة البرنامج الحاليّة, ويمكن تفادي هذا الخطأ بكتابة:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
وأقول تدّيني بس لايك بتعمل ليّ subsistence
{}{واتفاعل وأكون آكتيڤ}{} والاقيك انتا passive tense
}}
</nowiki></div>
}}

وسيظهر:

{{تنصيص|1=
<div class="abyat">
وأقول تدّيني بس لايك بتعمل ليّ subsistence
{}{واتفاعل وأكون آكتيڤ}{} والاقيك انتا passive tense
</div>
}}

=== الفواصل ===

يمكن إدراج فاصل بين الأبيات باستخدام علامات "----" كما في الويكي، أربعة أو أكثر، ولكن يتم تنسيق الفاصل بعرض الأبيات؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
السمحة ان تدور منو فينا نحن البابى؟
----
ان دارت صديق ايّانا نحن احبابا
وان دارت غفير يانا البنلزم بابا
وان فاقدة الحنان نبقالا ماما وبابا
وان فاقدة الامان نحميها بالدبّابة
وان دايرة المعاني انحن ديل اربابا
وان طرت الاغاني نغنّي عود وربابة
وان شكت السخانة بننقلب هبّابة
وان دايرة السما بنوصل نجيب اسبابا
وان دارت عمرنا.. نموت ويحيا شبابا
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
السمحة ان تدور منو فينا نحن البابى؟
----
ان دارت صديق ايّانا نحن احبابا
وان دارت غفير يانا البنلزم بابا
وان فاقدة الحنان نبقالا ماما وبابا
وان فاقدة الامان نحميها بالدبّابة
وان دايرة المعاني انحن ديل اربابا
وان طرت الاغاني نغنّي عود وربابة
وان شكت السخانة بننقلب هبّابة
وان دايرة السما بنوصل نجيب اسبابا
وان دارت عمرنا.. نموت ويحيا شبابا
</div>
}}

=== التظهير ===

يمكن تظهير بيت أو تعليق بإضافة "++" علامتي زائد عند نهاية السطر، وسيظهر بلون مختلف؛ مثلاً:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
يا "جنّة" "حيّاها الغمام" وسقاها "طل" أو هتّنا
وكأنّو رضوان بي رقبتو القام علي روضا اعتنى ++
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
يا "جنّة" "حيّاها الغمام" وسقاها "طل" أو هتّنا
وكأنّو رضوان بي رقبـ ـتو القام علي روضا اعتنى ++
</div>
}}

إذا الكان النص نفسه ينتهي بعلامتي زائد، فيمكن تجنّب التظهير ببساطة بإضافة مسافة عند نهاية السطر.

لتظهير كلّ الأبيات استخدم خيار التظهير كما هو مشروح أدناه.

== التعليقات ==

يمكن إصافة تعليقات متنوّعة بين الأبيات وعلى الهامش، وفق الخيارات التالية:

# تنصيص السطر ! بين علامتي تعجّب ! يضيف تعليقاً في الوسط، بما يناسب العناوين مثلا. يختلف ذلك عن التنصيص بين نقطتين في افتراض أنّ النص ليس جزءً من الأبيات.
# وضع ! علامة تعجّب في بداية السطر يضيف تعليقاً يتم محاذاته على الجانبين بالعرض الإجمالي لمساحة الأبيات، افتراضيّا 500px، بما يناسب إضافة فقرات بين النصوص.
# تنصيص أيّ نص (! بين أقواس وعلامات تعجّب !) يضيف النص كفقرة جديدة في الهامش. يمكن تنصيص أكثر من سطر بهذه الطريقة، وستحفظ السطور والمسافات كما هي.
# يمكن استخدام علامة (+) بين قوسين مع تنصيص (+ نص لاحق +) بين علامتين وقوسين لإضافة عنوان، title، في مكان العلامة، يظهر عند التلويح بالماوس. هذا الخيار غير متوفّر في شاشات الموبايل، ولذلك فلا يوصى به في الوقت الحالي.
# يمكن إضافة نقطة مرجعيّة على الهامش باستخدام عدد (1) رقم أو (*) نجمة بين القوسين كعلامة مرجعيّة، وتنصيص نص لاحق بين قوسين و (1 نفس العدد 1) أو (* النجمة *)،
# يمكن استخدام الرقم "(0)" كعلامة مرجعيّة، مع مراعاة ترتيب (0 النصوص المرجعيّة 0)، لترقيم النقاط المرجعيّة بشكل تلقائي.

على سبيل المثال:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
! [[2022-09-09]]
! (١٤) !
صباح اتجاوز الماضي وصبِح بالجد(+) (+ يعني: بالذي جدّ +)
صباح قرشي(0) وصباح نورين(0)، عقول بالجد(+)
صباحات تكنولوجيا الغد، صباح أمجد(17)
صباح الـ للبِريد إن لم يجد .. أوجَد!

(0 محمّد قرشي عبّاس 0)
(!
المثال مأخوذ من أبيات صباحيّات.
تعليقات الهامش تظهر بنفس طريقة كتابتها؛ مثلا
السطر الجديد
يظهر كسطر جديد، و المسافات محفوظة.
لاحظ إمكانيّة كتابة النصوص المرجعيّة داخل أو خارج فقرات الهامش.
(+ يعني في الحقيقة +)
(0 محمّد نورين 0)
!)
(17 أمجد خيري 17)
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
! [[2022-09-09]]
! (١٤) !
صباح اتجاوز الماضي وصبِح بالجد(+) (+ يعني: بالذي جدّ +)
صباح قرشي(0) وصباح نورين(0)، عقول بالجد(+)
صباحات تكنولوجيا الغد، صباح أمجد(17)
صباح الـ للبِريد إن لم يجد .. أوجَد!

(0 محمّد قرشي عبّاس 0)
(!
المثال مأخوذ من أبيات صباحيّات.
تعليقات الهامش تظهر بنفس طريقة كتابتها؛ مثلا
السطر الجديد
يظهر كسطر جديد، و المسافات محفوظة.
لاحظ إمكانيّة كتابة النصوص المرجعيّة داخل أو خارج فقرات الهامش.
(+ يعني في الحقيقة +)
(0 محمّد نورين 0)
!)
(17 أمجد خيري 17)
</div>
}}

== المعطيات ==

يمكن تخصيص المعطيات التالية.

=== العرض ===

العرض الافتراضي هو صفر، 0، وتعنى حساب العرض تلقائيّا باستخدام عرض البيت الأعرض.
يمكن اقتراح العرض الإجمالي للأبيات، مثلا 300px، بإضافة "<nowiki>عرض=300|"</nowiki> للمعطيات؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|عرض=350|
حتّى من شوفتك تمانع تحرم العين سر جمالك
تقسى لي قلبا بريدك ياما تاه في تيه دلالك
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-width="350">
حتّى من شوفتك تمانع تحرم العين سر جمالك
تقسى لي قلبا بريدك ياما تاه في تيه دلالك
</div>
}}

بينما:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|عرض=400|
حتّى من شوفتك تمانع تحرم العين سر جمالك
تقسى لي قلبا بريدك ياما تاه في تيه دلالك
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-width="400">
حتّى من شوفتك تمانع تحرم العين سر جمالك
تقسى لي قلبا بريدك ياما تاه في تيه دلالك
</div>
}}

سيتم مقارنة العرض المقترح بالعرض الأدنى المحسوب، واستخدام أكبرهما.

توحيد العرض مفيد في حالة إدخال نصوص شعريّة مختلفة بنفس الوزن؛ مثلا لتنسيق المسادير.

=== التنسيق ===

يمكن تمرير أيّ خصائص HTML لتنسيق الإطار الحاوي للأبيات: container div، بإضافة "<nowiki>تنسيق=whatever|"</nowiki> للمعطيات؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|تنسيق=</nowiki><span dir="LTR">style=&#34;color:red;&#34;</span><nowiki>|
يا قائد الأسطول تخضع لك الفرسان
يا ذو الفخار والطول أرحم بني الإنسان
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-attribs="style="color:red;"">
يا قائد الأسطول تخضع لك الفرسان
يا ذو الفخار والطول أرحم بني الإنسان
</div>
}}

لاحظ الحاجة لاستخدام
<span dir="LTR">&#34;</span>
بدلاً عن "علامة التنصيص"، وذلك لأنّ المعطيات نفسها سيتم تمريرها بين علامتي تنصيص.

=== التظهير ===

يمكن تظهير كلّ الأبيات باللون والتنسيق المخصّص للتظهير بإضافة "<nowiki>تظهير=1|"</nowiki> للمعطيات؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|تظهير=1|
صباح النور عليك يا زهور
صباحك يوم يقاس بدهور
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-emph="1">
صباح النور عليك يا زهور
صباحك يوم يقاس بدهور
</div>
}}

يمكن استخدام هذه الميزة مثلا لتظهير أبيات شاعر محدّد في مساجلة شعريّة.

=== كلاس التنسيق ===

يمكن تمرير قائمة كلاسات، class list، تضاف لكلاس الجزء الذي يحوي النص، بإضافة "<nowiki>كلاس=class1 class2 ...|"</nowiki> للمعطيات، بما يتيح استخدامها لانتقاء تنسيق مخصّص؛ مثلاً:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|كلاس=bDimOthers|
يا "جنّة" "حيّاها الغمام" وسقاها "طل" أو هتّنا
وكأنّو رضوان بي رقبتو القام علي روضا اعتنى ++
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat bDimOthers">
يا "جنّة" "حيّاها الغمام" وسقاها "طل" أو هتّنا
وكأنّو رضوان بي رقبـ ـتو القام علي روضا اعتنى ++
</div>
}}

مقارنة بتنسيق التظهير أعلاه.

=== الخيارات ===

يمكن تمرير خيارات لبرنامج التنسيق بإضافة "<nowiki>خيارات=bitmask|"</nowiki> للمعطيات؛ في شكل bitmask، بمعنى أنّ الخيار رقم ن، بدئا من صفر، يتم تفعيله بإضافة ٢<sup>ن</sup> لمجموع الخيارات.

تتوفّر الخيارات التالية، مرقّمة بحسب العدد اللازم إضافته لتفعيل الخيار:

==== حر ====

يتم تنسيق القصيدة كشعر حر بإضافة ١ لمجموع الخيارات، وكلّ سطر سيظهر كما هو، مع الاحتفاظ بإمكانيّة إضافة ملاحظات الهامش؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|خيارات=1|
أنا لن أحيد
أنا لست رعديداً
يكبّل(0) خطوه
ثقل الحديد
(0 أيّ يقيّد 0)
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-flags="حر">
أنا لن أحيد
أنا لست رعديداً
يكبّل(0) خطوه
ثقل الحديد
(0 أيّ يقيّد 0)
</div>
}}

==== عمود واحد ====

هذا الخيار يتجاوز تشطير البيت وينسّق الأبيات في عمود واحد؛ بما يناسب شعر المسادير. يتم تفعيله بإضافة ٢ لمجموع الخيارات، مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|خيارات=٢|
بلادي يا سنا الفجر وينبوع الشذى العطري
وملهمتي أناشيدي وآياتٍ من الشعر
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-flags="عمود">
بلادي يا سنا الفجر وينبوع الشذى العطري
وملهمتي أناشيدي وآياتٍ من الشعر
</div>
}}

بدلاً عن

{{تنصيص|1=
<div class="abyat" >
بلادي يا سنا الفجر وينبوع الشذى العطري
وملهمتي أناشيدي وآياتٍ من الشعر
</div>
}}

==== علامات التنصيص ====

استبدال "علامات التنصيص المستقيمة" بـ ”علامات التنسيق اللطيفة“ مفعّل بشكل تلقائي، ويمكن إلغاؤه بإضافة ٤ لمجموع الخيارات، مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|خيارات=4|
إنتِ الجمال سووه ليك يا السمحة وادّونا الشنا
وانت "الزمرّدة كوكبك" واحنا البنحضر "آكشنا"
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-flags="تنصيص">
إنتِ الجمال سووه ليك يا السمحة وادّونا الشنا
وانت "الزمرّدة كوكبك" واحنا البنحضر "آكشنا"
</div>
}}

بدلاً عن:

{{تنصيص|1=
<div class="abyat" >
إنتِ الجمال سووه ليك يا السمحة وادّونا الشنا
وانت "الزمرّدة كوكبك" واحنا البنحضر "آكشنا"
</div>
}}

==== اتّجاه النص ====

الاتّجاه الطبيعي للنصوص من اليمين لليسار، ويمكن عكسه بإضافة ٨ لمجموع الخيارات؛
مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|خيارات=٨|
Why should we learn until we die?
{}{Working hard and earning φ}{}
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat" data-flags="EN">
Why should we learn until we die?
{}{Working hard and earning φ}{}
</div>
}}

بدلا عن:

{{تنصيص|1=
<div class="abyat" >
Why should we learn until we die?
{}{Working hard and earning φ}{}
</div>
}}

== ويكيهات ==

يمكن تضمين وصلات داخليّة وخارجيّة.
في حالة الوصلات الداخليّة، يفضّل تحديد النص البديل لاسم الصفحة كيما يسهل تحريره بما يناسب تنسيق الأبيات؛ مثلا:

{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
بدا يتذكّر، ساعة بساعة، لحظة بلحظة، من ديسمبر
لمّن جات [[:ملف:حرق دار المؤتمر الوطني 2018-12-19.jpg|الصورة الأولى لمّا النار قادت في عطبر]]

}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
بدا يتذكّر، ساعة بساعة، لحظة بلحظة، من ديسمبر
لمّن جات [[:ملف:حرق دار المؤتمر الوطني 2018-12-19.jpg|الصورة الأولى لمّا النار قادت في عطبر]]

</div>
}}

كما يمكن استخدام تحرير الويكي مثل <nowiki>''مائل''، '''غليظ'''، و'''''غليظ مائل'''''</nowiki> في التعليقات أو داخل الأبيات؛ مثلا:
{{تنصيص|1=
<div style="white-space:pre-wrap"><nowiki>{{أبيات|
'''أوعك''' تمشي لي واحدة وتقول "نتعرّف"
اتعرّف براك، شوف ليك طريقة، اتصرّف
ولمن تعرِفا اتذكّر تقول "نتشرّف"
اسمع كلمتي، وما تقول دا عمّك خرّف
}}
</nowiki></div>
}}

سيظهر:

{{تنصيص|1=
<div class="abyat">
'''أوعك''' تمشي لي واحدة وتقول "نتعرّف"
اتعرّف براك، شوف ليك طريقة، اتصرّف
ولمن تعرِفا اتذكّر تقول "نتشرّف"
اسمع كلمتي، وما تقول دا عمّك خرّف
</div>
}}

</noinclude><includeonly><div class="abyat" data-width="{{{عرض|0}}}" data-emph="{{{تظهير|0}}}" data-classList="{{{كلاس|}}}" data-flags="{{{خيارات|0}}}" data-attribs="{{{تنسيق|}}}">{{{1|}}}</div></includeonly>