الإخراج العربي

الكتاب العربي يسير من اليمين إلى اليسار، من حروفه إلى صفحاته المتقابلة، وكلماته خطوط موصولة لا تقبل القطع.

ينضّد Postext العربية الفصحى المعاصرة والعربية التراثية من Markdown والإعدادات نفسها التي ينضّد بها أي لغة أخرى. إعداد واحد، لغة المستند، يقلب الكتاب كله: تبدأ الأسطر من اليمين، ويكون العمود الأول هو الأيمن، ويُجلَّد الكتاب على حافته اليمنى وتُقرأ صفحاته المتقابلة من اليمين إلى اليسار، بينما تبقى الكلمات اللاتينية والأرقام داخل السطر تُقرأ من اليسار إلى اليمين. تُقاس الكلمات وتُرسم كاملة كما يشكّلها الخط، ويُمدّ السطر المضبوط عند مسافاته وبإطالة الوصلات بين الحروف (الكشيدة)، ولا يُمدّ أبدًا بالمباعدة بين الحروف. تشرح هذه الصفحة ما يفعله المحرّك والإعدادات التي تتحكم فيه. ويسرد مرجع الإعدادات كل مفتاح بقيمته الافتراضية، ويصف صيغة المستند الترميز.

تتبع القواعد وثيقة Arabic & Persian Layout Requirements (متطلبات تخطيط النص العربي والفارسي) الصادرة عن W3C (alreq)، وخوارزمية Unicode للنص ثنائي الاتجاه (UAX #9)، وتتبع في أعراف الكتاب ما جرت عليه الكتب المطبوعة في القاهرة وبيروت ومطبعة بولاق. المصادر مذكورة في آخر الصفحة.

#البدء بكتاب عربي

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

const config: PostextConfig = {
  locale: 'ar',
  bodyText: { fontFamily: 'Amiri', lineHeight: { value: 1.75, unit: 'em' } },
  headings: { fontFamily: 'Amiri' },
};

يقبل locale القيم ar وar-EG وar-MA وأي وسم عربي آخر. وتمنح اللغة الكتاب:

• الاتجاه، من اليمين إلى اليسار (يقرؤه direction: 'auto' من نظام كتابة اللغة)؛
• التجليد، على الحافة اليمنى (page.binding: 'auto')؛
• أرقام الأعداد التي يولّدها المحرّك: ٠–٩ في المشرق و0–9 في المغرب (numerals: 'auto'، انظر أدناه)؛
• عدم تقسيم الكلمات بالواصلة، وعدم المباعدة بين حروف الكلمات العربية أو تتبّعها، وضبط الأسطر بالكشيدة؛
• التوكيد بالخط العريض بدل المائل، والاقتباسات الكتلية قائمة غير مائلة؛
• الكلمات المدمجة: شكل وجدول للأشكال والجداول، مرقّمة حسب الفصل (شكل ٢-٣)، والفصل وص في الإحالات، والمراجع عنوانًا لقائمة المراجع، وانظر وانظر أيضًا في الفهرس، و(تابع) بعد تعليق جدول متواصل؛
• ترتيب الفهرس، هجائيًا، مع إهمال أداة التعريف ال؛
• وسم اللغة في HTML (lang="ar" dir="rtl")، وعلى اللوحة (Canvas) وفي PDF (/Lang)، فتُطبَّق الأشكال الخاصة باللغة في الخط.

ويفعل Sandbox ذلك في خطوة واحدة: اختر العربية ضمن التصميم › نظام الكتابة واضغط الإعدادات الافتراضية للعربية › مراجعة… (انظر في Sandbox).

#الاتجاه وخوارزمية النص ثنائي الاتجاه

تسير الفقرة العربية من اليمين إلى اليسار، لكن الأرقام والكلمات اللاتينية والاقتباسات التي فيها تسير من اليسار إلى اليمين. وخوارزمية Unicode للنص ثنائي الاتجاه هي التي تحدد ترتيب هذه القطع في كل سطر انطلاقًا من المحارف نفسها؛ ويطبّقها Postext كاملة (UAX #9، Unicode 18، وكل حالات اختبارات المطابقة). يُخزَّن النص ويُبحث فيه بالترتيب المنطقي، أي بالترتيب الذي كُتب به؛ ولا يُعاد ترتيب شيء إلا عند الرسم.

#اتجاه المستند والكتلة والنص داخل السطر

يُعيَّن الاتجاه على ثلاثة مستويات:

• المستند: direction: 'auto' | 'ltr' | 'rtl'. القيمة 'auto'، وهي الافتراضية، تعني من اليمين إلى اليسار حين يُكتب نظام كتابة locale من اليمين إلى اليسار (العربية والفارسية والأردية والعبرية والسريانية والثانا وأنكو والأدلم…)، ومن اليسار إلى اليمين في غير ذلك. لا تعيّنه إلا لفرض اتجاه بعينه: الكتاب الإنجليزي لا يحتاج إليه، والكتاب العربي المنضّد من اليسار إلى اليمين خطأ في أغلب الأحوال.
• الكتلة: {dir=ltr} أو {dir=rtl} بعد العنوان، أو على أي حاوية :::: :::paragraphs{dir=ltr} و:::callout{dir=ltr} و:::columns و:::part. كل ما داخل الحاوية يأخذ ذلك الاتجاه، حتى كتلة متداخلة تعيّن اتجاهًا آخر. الفقرات العادية وعناصر القوائم والاقتباسات ليس لها سمة خاصة بها: ضعها داخل :::paragraphs{dir=…}. ومورد الجدول يأخذ table.direction.
• مقطع من النص: يعزل :ltr[…] و:rtl[…] نصهما، مع {lang=…} اختياري يَسِم المقطع في HTML وPDF.

# Introduction {dir=ltr}
 
:::paragraphs{dir=ltr}
An English paragraph quoted in an Arabic book, set left to right with its indent on the left.
:::
 
نشر الكتاب في :ltr[The Arabian Nights, vol. 2]{lang=en} سنة ١٨٣٥.

الكتلة المعيَّن لها اتجاه مخالف لاتجاه المستند تحتفظ بجهة بدايتها: تنتقل المسافة البادئة لسطرها الأول وعلامات قوائمها ونهاية سطرها الأخير المحاذاة إلى الجهة التي يبدأ منها نصها، وتُحاذى أسطرها داخل العمود كما يقتضي نصها. في الكتاب العربي ينبغي أن يكون الاقتباس الإنجليزي {dir=ltr}: فبدونه تنتمي نقطته الختامية، وهي محرف محايد، إلى الفقرة المكتوبة من اليمين إلى اليسار فتُطبع في الطرف الأيسر من السطر، كما يعرضها المتصفح. ويمكن للحاوية أيضًا أن تسمّي لغتها، :::paragraphs{dir=ltr lang=en}: فتُرقَّم القوائم المرتبة داخلها بأرقام تلك اللغة (1. 2. في كتاب عربي، و١. ٢. تحت lang=ar في كتاب إنجليزي). أما أرقام الحواشي والأشكال والجداول والعناوين داخل الكتلة فتبقى بأرقام المستند: فهي تنتمي إلى تسلسلات الكتاب نفسه.

#العوازل

:ltr[…] و:rtl[…] عوازل ثنائية الاتجاه (bidi isolates)، أي LRI…PDI وRLI…PDI في UAX #9: يُرتَّب نصها داخلها، وترى الفقرة كلًا منها محرفًا محايدًا واحدًا. استعمل أحدها حين ينتهي عنوان لاتيني بمحرف محايد (نقطة، أو قوس إغلاق، أو علامة استفهام) كان سيُقرأ لولاه مع النص العربي المحيط به، أو حين يبدأ المقطع برقم أو حرف لاتيني يغيّر تخمين خوارزمية أول حرف قوي الاتجاه (first-strong). والحاشية أو :ref أو الصيغة الرياضية داخل العازل جزء منه. تُحترم محارف التحكم في Unicode نفسها (U+2066–2069 وU+202A–202E وU+200E وU+200F وعلامة الحرف العربي U+061C) إذا وردت في المصدر، لكن التوجيهات أسهل قراءة وتحريرًا.

#الأعداد

العدد يُقرأ من اليسار إلى اليمين في كل نظام أرقام، وخانته الأعلى قيمة على اليسار: ١٤٤٥ و1445 سواء. والأرقام الأوروبية بعد حروف عربية تُقرأ أعدادًا عربية (القاعدة W2)، فيُرتَّب سنة 1835م وسنة ١٨٣٥م بالطريقة نفسها. والعددان المفصولان بشرطة مائلة، كالجزء والصفحة أو السورة والآية (١٣/٩٠)، يبقيان مقطعًا واحدًا؛ أما المدى المكتوب بشرطة (١٢-١٥) فيُقرأ من اليمين إلى اليسار، و12 على اليمين، كما يتوقع القارئ العربي. وعلامة النسبة المئوية ٪ (U+066A) تُكتب بعد العدد وتظهر على يساره. لا يُعاد أبدًا كتابة النص الذي يكتبه المؤلف: الأعداد التي يولّدها المحرّك وحدها تأخذ أرقام المستند (الأرقام).

#الأقواس وعلامات التنصيص

الأقواس الهلالية والمعقوفة والمعقوصة وعلامات التنصيص «» تُعكس في المقاطع المكتوبة من اليمين إلى اليسار: ( المكتوب قبل كلمة عربية يفتحها من يمينها. اكتبها بالترتيب المنطقي، قوس الفتح أولًا، كما تفعل في الإنجليزية؛ ويرسم Canvas وHTML وPDF الشكل المعكوس (بخاصية rtlm في الخط، أو بنقطة الترميز المعكوسة). وبالطريقة نفسها تفتح « » الاقتباس العربي وتغلقه.

أما القوسان المزخرفان لآيات القرآن، ﴿ (U+FD3F) و﴾ (U+FD3E)، فلا يُعكسان: منذ Unicode 14 صار ﴿ قوس الفتح و﴾ قوس الإغلاق، وشكلاهما مرسومان للنص المكتوب من اليمين إلى اليسار. اكتب ﴿ أولًا: ﴿بسم الله الرحمن الرحيم﴾ يُطبع و﴿ على اليمين. وهما كذلك ليسا قوسين متزاوجين، ففي فقرة مكتوبة من اليسار إلى اليمين (آية عربية مقتبسة في كتاب إنجليزي) يأخذ القوسان المجاوران لكلمة لاتينية اتجاه الفقرة: فيقع ﴿ على يسار الآية ويُقرأ الزوج معكوسًا، كما في المتصفح. انضد الاقتباس عازلًا من اليمين إلى اليسار، :rtl[﴿بسم الله الرحمن الرحيم﴾]، فيتبع القوسان الآية، و﴿ على يمينها.

#ترتيب الصفحات والتجليد على اليمين

يُجلَّد الكتاب العربي على حافته اليمنى. صفحته الأولى صفحة يسرى، وتُقرأ صفحتاه المتقابلتان من الصفحة اليمنى إلى اليسرى، وتمتلئ أعمدته من اليمين إلى اليسار. ويُخرج Postext مثل هذه الصفحة كأنها صفحة من اليسار إلى اليمين تُرى في مرآة: كل ما في مجرى النص (الأعمدة والأسطر والمسافات البادئة وعلامات القوائم والعناصر العائمة والحواشي والإطارات والجداول) يوضع بالشيفرة نفسها التي توضع بها في كتاب إنجليزي، ثم تُعكس الصفحة كلها، وتُرسم كل كلمة وصورة وصيغة في وضعها الصحيح.

• التجليد. القيمة page.binding: 'auto' تعني الحافة اليمنى في المستند المكتوب من اليمين إلى اليسار. وتبقى الصفحة 1 فردية وتبقى وجه الورقة، فيحتفظ breakBefore.parity و:::pagebreak{parity="odd"} وعدد الصفحات بمعانيها؛ والصفحة الفردية هي اليسرى من الصفحتين المتقابلتين، والفصل الذي يبدأ في صفحة فردية يبدأ في صفحة يسرى. ومع margins.mirror يكون الهامش الداخلي للصفحات الفردية على يمينها. ويطلب PDF من برامج العرض صفحات متقابلة من اليمين إلى اليسار (/Direction /R2L، /PageLayout /TwoPageRight)، ويعرض Sandbox الصفحات المتقابلة 3 | 2، ويسير عارض HTML فيه بالصفحات من اليمين إلى اليسار. انظر التجليد.
• الأعمدة. في الصفحة ذات العمودين يكون العمود الأول هو الأيمن؛ ويتبعه الخط الفاصل بين العمودين والعمود الجانبي والفاصل بين الأعمدة. والعنصر العائم في أعلى الصفحة يمتد من اليمين، والحواشي تقع أسفل كل عمود وخطها الفاصل على اليمين.
• الترويسات وأرقام الصفحات تبقى مرتبطة بالورقة: خانات الترويسة والتذييل مادية، وleft وright فيها جهتا الورقة، كما في أي كتاب. عيّنها للتجليد على الحافة اليمنى: عنوان الفصل في الصفحة اليسرى (الفردية)، وعنوان الكتاب في الصفحة اليمنى (الزوجية)، ورقم الصفحة في الزاوية الخارجية (يسار الصفحات الفردية) أو في الوسط، كما تفعل أغلب الكتب العربية.

#معنى اليسار واليمين والبداية والنهاية

الإعداد الذي يسمّي جهة يقصد جهة من النص لا من الورقة، فيعمل التصميم المُعَدّ لكتاب إنجليزي دون تغيير حين يُحوَّل الكتاب إلى العربية. ويُقبل start وend في كل مكان اسمين صريحين لبداية النص ونهايته.

عناصر التصميم الموضوعة في المجرى، كشريط صفحة افتتاح الفصل أو تصميم العنوان، تُعكس معه: left وright فيها جهتا بدايته ونهايته، كما في نص المتن. ويأخذ عنصر النص direction: 'ltr' | 'rtl' | 'auto' (اتجاه المستند افتراضيًا؛ و'auto' يقرأ أول حرف قوي الاتجاه في نصه)، ويتبعه align: 'start' و'end' فيه. أما placement.rotate فيحتفظ بمعناه المادي: الشكل المُدار في اتجاه عقارب الساعة يُدار في اتجاهها على الورقة.

#أشكال الحروف والكلمة الكاملة

حروف الكلمة العربية موصولة، ويأخذ كل منها الشكل الذي يقتضيه جاراه: أول الكلمة أو وسطها أو آخرها أو منفردًا، مع حروف مركّبة كلام ألف. ويقيس Postext الكلمة ويرسمها سلسلة واحدة محدَّدة الأشكال، لا حرفًا حرفًا. يترك Canvas وHTML تحديد أشكال الحروف (shaping) للمتصفح؛ أما PDF فيحدد الأشكال بـ HarfBuzz، الذي لا يُحمَّل إلا حين يحوي المستند نصًا عربيًا أو نظام كتابة آخر يحتاج إليه، ويردّ كل شكل حرفي إلى محارفه، فيكون النص المنسوخ من PDF والذي يقرؤه قارئ الشاشة هو النص الذي كُتب. وإذا تعذّر تحميل HarfBuzz كُتب ملف PDF مع ذلك، وعلاماته في غير مواضعها، وأبلغ renderToPdf عن تحذير complexShapingUnavailable؛ ويشير خياره harfbuzzWasm إلى الملف حين يقدّمه المضيف من موضع خاص به.

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

• لا تقسيم بالواصلة. العربية لا تُقسَّم في أواخر الأسطر، وتقسيم الكلمات بالواصلة معطَّل في المستند المكتوب بالخط العربي. وتفعيله بلغة أنماط لاتينية (hyphenation: { enabled: true, locale: 'en-us' }) يقسم الكلمات اللاتينية في الكتاب ويترك العربية كاملة.
• لا مباعدة بين الحروف. المباعدة بين الحروف الموصولة تقطع وصلها. لذلك يتخطى letterSpacing في النمط وتتبّعُ ضبط الأسطر الكلماتِ العربية؛ ويبلغ البناء عن نمط متن أو عنوان يعيّن تباعد حروف على نص عربي (joiningScriptLetterSpacing).
• لا قطع. الكلمة الأعرض من السطر لا تُقطع أبدًا بين حروفها. بل تتجاوز عرض السطر، ويُعلَّم السطر (VDTLine.wordOverflow) ويبلغ البناء عنه (unbreakableWordOverflow). يحدث هذا في خلايا الجداول الضيقة والأعمدة الجانبية؛ فوسّعها أو أعد صياغة النص.

تغيير النمط داخل الكلمة، كحرف ملوّن أو حركة بالخط العريض (كتا**ب**)، لا يقسم الكلمة قسمين: تُقاس وتُشكَّل كاملة، ثم يُرسم الجزء المنسَّق فوقها. يلوّن PDF وHTML الحروف بدقة؛ أما Canvas فيقدّر موقع الحرف داخل الكلمة المشكَّلة، وقد يمتد اللون إلى الحرف المجاور بشعرة. ونص التصميم لا يقطع الكلمة العربية أبدًا عند الالتفاف أو الاقتطاع، ولا يُرسم الحرف الاستهلالي حين يتصل الحرف الأول بما بعده.

#ضبط الأسطر والكشيدة

الكتب العربية مضبوطة الأسطر. لا يُمدّ السطر بالمباعدة بين حروفه؛ بل يُمدّ عند المسافات بين كلماته وبالكشيدة، أي الوصلات المطوَّلة التي يرسمها الخطاط بين حرفين متصلين (كتاب ← كتـاب). ويُدرج Postext الكشائد تطويلات كاملة (U+0640، ـ)، يرسمها الخط خطًا واحدًا؛ ويحوّل Amiri سلسلة منها إلى وصلة منحنية.

قيمة bodyText.kashida هي 'auto' في المستند المكتوب بالخط العربي و'none' في غيره. يفتح كل سطر مضبوط، عدا السطر الأخير من الفقرة، مسافات كلماته أولًا حتى ربع عرضها، ثم يأخذ ما بقي من فراغه كشائد، تطويلًا واحدًا في كل مرة، في أفضل الوصلات أولًا؛ وما يتبقى، وهو أقل من تطويل، يعود إلى المسافات. وتحسب خوارزمية Knuth–Plass ما يمكن أن تطوله كل كلمة قابليةً للتمدد، فتختار مواضع كسر الأسطر وهي تعلم أن سطرًا من كلمات عربية يمكن أن يتسع هناك. ولا تأخذ الكلمات اللاتينية ولا الأرقام ولا العناوين ولا الأسطر غير المضبوطة ولا السطر الأخير من الفقرة كشيدة أبدًا.

ومواضع الكشيدة تتبع قواعد raqim-kashida: لا تكون إلا بين حرفين متصلين، ولا تكون أبدًا بعد حرف لا يتصل بما بعده (ا د ذ ر ز و ة)، ولا في آخر الكلمة، ولا داخل لام ألف. ويختار kashidaPatterns مجموعة القواعد: 'naskh' لقواعد النسخ التقليدية، و'simple' لأولويات الخطوط الحديثة البسيطة، و'nastaliq' للنستعليق، و'auto' يقرأ خط المتن (فلا كشيدة إطلاقًا في خط رقعة مثل Aref Ruqaa، لأن طرازه يمنعها). ويحدّ kashidaPerWord (1 افتراضيًا) وkashidaMaxLength (0.6 em) مقدار ما تتمدده الكلمة الواحدة؛ والكلمة التي فيها تطويل كتبه المؤلف تُطال في موضعه. تُرسم التطويلات المُدرجة لكنها تُستبعد من النص المجرد وخريطة المصدر والنص المنسوخ من PDF. وفي الكشيدة في النص العربي تفاصيل مجموعات القواعد.

bodyText: {
  textAlign: 'justify',
  kashida: 'auto',          // the default in an Arabic book
  kashidaPatterns: 'naskh', // 'auto' reads it from the face
}

#الحركات

الحركات (الفتحة والضمة والكسرة والسكون والشدة والتنوين والألف الخنجرية) وعلامات الضبط القرآني تتراكب فوق الحروف وتحتها، في المسافة بين الأسطر. النثر الحديث يضع شدة أو حركة هنا وهناك؛ والطبعة التراثية تشكّل شعرها تشكيلًا كاملًا ونثرها تشكيلًا خفيفًا؛ والقرآن مشكول دائمًا تشكيلًا تامًا. ولا يزيد تباعد الأسطر من تلقاء نفسه لأجل الحركات، فاختره على قدر أكثر نص مشكول في الكتاب:

كل سطر فيه حركات يسجّل إلى أي مدى يبلغ حبرها فوق خط الأساس وتحته (VDTLine.markInk)، ويشمل قصّ العمود في Canvas وفي PDF حركاتِ السطرين الأول والأخير من العمود. وحين تلتقي حركة فوق كلمة بالحروف أو الحركات النازلة تحت الكلمة التي فوقها، يبلغ البناء عن الفقرة (arabicMarksExceedLeading، في لوحة «الفحوص» في Sandbox) مع تباعد الأسطر الذي تحتاج إليه. ولا يُقارَن إلا بين كلمات يقع بعضها فوق بعض، فالكلمة المشكولة تحت كلمة قصيرة تمرّ. أعطِ المقاطع المشكولة، والشعر خاصة، نمط فقرة بتباعد أسطر أكبر.

يُخرج bodyText.tashkil الحركات من النص الذي ينضّده الإخراج، لطبعة غير مشكولة تُصنع من مصدر مشكول: 'strip' يحذف الحركات والتنوين والسكون والشدة والألف الخنجرية (تُنضَّد هٰذا هذا) وعلامات الضبط القرآني؛ و'strip-vowels' يُبقي الشدة، كما تطبعها أغلب الكتب الحديثة. وتبقى الهمزة والمدة: أ إ آ حروف. يحتفظ المصدر بحركاته؛ وتُنضَّد الفقرات والعناوين والمحتويات من دونها.

#التوكيد

الحرف العربي لا مائل له، والخط العربي المائل تشويه. في المستند المكتوب بالخط العربي يُنضَّد *…* بالخط العريض افتراضيًا (bodyText.emphasis: 'auto')؛ و'color' ينضّده قائمًا بلون italicColor، و'overline' يرسم خطًا فوق الكلمات، وهو الخط العلوي الذي عرفته الكتب العربية القديمة. وأيًّا كان الاختيار فالمحرّك لا يُميل الحروف العربية أبدًا: في مقطع منضَّد بالمائل تبقى الكلمات العربية قائمة وتحتفظ الكلمات اللاتينية بميلها، فيطبع *Kitāb al-ʿIbar كتاب العبر* النقحرة بالمائل والعنوان العربي قائمًا. والاقتباسات الكتلية قائمة افتراضيًا في الكتاب العربي؛ والنمط الذي خطه مائل أصلًا (blockquote.italic: true، أو مستوى عنوان منضَّد بالمائل) ينضّد كلماته العربية قائمة كذلك، بخطه من غير ميل، وكلماته اللاتينية بالمائل. وتحتفظ التعليقات وخلايا الجداول والمحتويات والفهرس بإعدادات الميل الخاصة بها.

bodyText: { emphasis: 'overline', italicColor: { hex: '#8a1c1c', model: 'hex' } }

#الأرقام وأنماط الترقيم

تُكتب العربية بثلاث مجموعات من الأرقام، تُختار حسب المنطقة:

يعيّن numerals في المستوى الأعلى أرقام كل عدد يكتبه المحرّك: أرقام الصفحات وأرقام الصفحات في المحتويات والفهرس، وأرقام القوائم والحواشي، وعدّادات العناوين والفصول، وأرقام الأشكال والإحالات إليها، و{totalPages}. والقيمة 'auto' تأخذ أرقام المنطقة من locale (ar بلا منطقة، وar-AE، مشرقيان، كما تطبعها الكتب العربية هناك)؛ ويمكن للوسم أن يسمّي أرقامه (ar-MA-u-nu-arab). أما الأعداد التي يكتبها المؤلف فلا تُغيَّر أبدًا، وتُقرأ بأي نظام: عنصر القائمة ٣. يبدأ من 3، و{startAt=٥} هو 5. انظر أرقام المستند.

والتنسيق المسمّى في الإعدادات يُطبع كما سُمّي، فيمكن للكتاب أن يمزج بين الأنظمة. أنماط الترقيم العربية:

يجمع حساب الجُمَّل قيم حروفه، الأعلى قيمة أولًا، كما تَعُدّ المخطوطات وأبيات التأريخ: 11 هي يا، و1446 غتمو، و2000 بغ، و1002 غب. ويرقّم نمطا الترقيم بالحروف عناصر القوائم وصفحات المقدمات حرفًا لكل عنصر؛ وكلاهما يكتب الحرف الأول بهمزته (أ) والهاء المنفردة هـ، فلا يُقرأ أي منهما رقمين ١ و٥. والطبعة التراثية ترقّم صفحات مقدماتها بالترتيب الأبجدي وتبدأ الأرقام مع النص:

:::numbering{format="abjad" startAt=1}
 
# المقدمة {style="front-matter"}
 
…
 
:::pagebreak{parity="odd"}
:::numbering{format="decimal" startAt=1}

وتتبع القوائم المرتبة الأسماء نفسها. والتسلسل العربي المعتاد هو ١- ، ثم أ- ، ثم (١):

orderedLists: {
  levels: [
    { level: 1, numberFormat: 'arabic', separator: '-' },
    { level: 2, numberFormat: 'abjad', separator: '-' },
    { level: 3, numberFormat: 'arabic', prefix: '(', separator: ')' },
  ],
},

arabic هو التنسيق العشري، مكتوبًا بأرقام المستند.

#الأعداد الترتيبية والأصلية بالحروف

يكتب {1:ordinal} في قالب العنوان العدد الترتيبي المعرَّف بالحروف العربية، ويكتب {1:words} العدد الأصلي. والأعداد الترتيبية العربية تطابق المعدود، فيأخذ القالب الجنس بعد شرطة: -feminine (أو -f) للمعدود المؤنث مثل الليلة، والمذكر افتراضيًا للفصل أو الباب. ويكتب -classical «مائة» بدل «مئة»، كما في مطبوعات بولاق. والليلة لا عنوان لها: يطبع numberPosition: 'replace' العدد عنوانًا كاملًا، فيُطبع # Night (أو أي عنوان مكتوب في المصدر) الليلة الثانية، وتقرأ المحتويات والترويسات وإشارات PDF المرجعية الشيء نفسه.

headings: {
  levels: [{ level: 1, numberingTemplate: 'الليلة {1:ordinal-feminine}', numberPosition: 'replace' }],
},

فيُطبع الليلة الأولى، والليلة الحادية عشرة، والليلة الخامسة والأربعون بعد الثلاثمئة، وعند 1001 الليلة الحادية بعد الألف؛ ويُطبع 'الفصل {1:ordinal}' الفصل الأول، الفصل الحادي عشر. تُكتب الأعداد الترتيبية حتى 9999 والأصلية حتى 99999؛ وما جاوزها يُطبع بالأرقام. ويعطي العنصران النائبان في التصميم {numberWords} و{numberOrdinalWords} صيغ المذكر. انظر الأعداد المكتوبة بالحروف.

#الحواشي السفلية

يعلّم الكتاب العربي حواشيه بالرقم بين قوسين، «(١)»، مرفوعًا في النص وعلى السطر في رأس الحاشية، وأغلب الطبعات التراثية تعيد ترقيمها في كل صفحة. ويقف الخط الفاصل وأرقام الحواشي في جهة البداية، أي اليمين، من تلقاء نفسها.

footnotes: {
  markerTemplate: '({n})',      // «(١)» in the text and in the note
  numbering: 'page',            // ١ again on every page
  noteNumberPosition: 'inline', // the note's own number on the line
}

يكتب markerTemplate العلامة في النص والرقم الذي تبدأ به الحاشية على السواء، بأرقام المستند. ورقم الحاشية يتوقف على الصفحة التي تقع فيها، فالكتاب المرقَّم حسب الصفحة يُخرَج، ثم يُرقَّم حيث وقعت حواشيه، ثم يُخرَج مرة أخرى. ضع العلامة قبل علامة الترقيم التالية لها، كما تفعل الكتب العربية: يأتي [^id] بعد الكلمة مباشرة، قبل الفاصلة أو النقطة. انظر الحواشي.

#الشعر العمودي

تُنضَّد القصيدة العربية العمودية (القصيدة أو المقطوعة) بيتًا في كل سطر، في شطرين: الشطر الأول، الصدر، على اليمين، والثاني، العجز، على اليسار، وبينهما فجوة. وتُجعل أشطر القصيدة كلها بعرض واحد، فيبدأ كل صدر على خط عمودي واحد وينتهي كل عجز على خط آخر، وتصطف حروف الروي على طول القصيدة.

اكتب القصيدة في كتلة :::verse، بيتًا في كل سطر، والشطران مفصولان بـ || (ويصلح أيضًا \\ بمسافة على كل جانب، كما في نصوص ويكي مصدر). والسطر الذي لا فاصل فيه شطر منفرد، يتوسط القصيدة.

فأنشد يقول:
 
:::verse{style="verse"}
يَا حُرْقَةَ الدَّهْرِ كُفِّي || إِنْ لَمْ تَكُفِّي فَعِفِّي
فَلَا بِحَظِّيَ أُعْطِي || وَلَا بِصَنْعَةِ كَفِّي
:::

• العرض المشترك هو عرض أعرض شطر، على ألا يزيد على نصف عرض السطر مطروحًا منه الفجوة؛ ويثبّته width. ويبلغ كل شطر هذا العرض بالكشيدة أولًا، والشعر يقبلها أكثر من النثر، ثم بالمسافات بين كلماته.
• الفجوة 2 em افتراضيًا (gap)؛ ويطبع ornament علامة في وسطها، مثل ٭.
• الشطر الأطول من اللازم يضيّق مسافاته أولًا؛ فإن بقي لا يتسع نُضِّد بيته مدرَّجًا: الصدر محاذى إلى اليمين في سطر وحده، والعجز محاذى إلى اليسار في السطر التالي.
• الإبقاء معًا. لا يُقسم البيت أبدًا بين عمودين أو صفحتين، وتتبع القصيدة قواعد الأسطر اليتيمة (orphans) والأرامل (widows) التي تتبعها الفقرات، ويبقى السطر الذي يقدّم لها («فأنشد يقول:») مع أبياتها الأولى.
• الحرف. تأخذ القصيدة خط المتن وحجمه؛ ويسمّي style نمط فقرة، وبه تنال القصيدة المشكولة تباعد الأسطر الذي تحتاج إليه حركاتها. والقصيدة المكتوبة بنقحرة لاتينية في كتاب إنجليزي تُنضَّد بالطريقة نفسها، وصدرها على اليسار.

يحتفظ النص المجرد بالقصيدة كما كُتبت، بيتًا في كل سطر، ويستبعد الكشائد والزخرفة. انظر :::verse في صيغة المستند.

#المحتويات والفهرس

المحتويات. كثير من الكتب العربية، والطبعات التراثية قبل غيرها، تطبع محتوياتها (فهرس أو فهرس المحتويات) في آخرها. ويطبع :::toc المحتويات حيثما وُضع، فضعه في الفصل الأخير تحت عنوان مستبعد منها:

# فهرس المحتويات {toc="false"}
 
:::toc

يُنضَّد سطر المحتويات من اليمين إلى اليسار: الرقم والعنوان على اليمين، ثم النقاط الموصلة، ثم رقم الصفحة على اليسار. والعنوان اللاتيني في كتاب عربي يبقى رقم صفحته على اليسار، وتُقرأ كلماته من اليسار إلى اليمين.

الفهرس. يرتّب الفهرس الأبجدي (index) في آخر الكتاب العربي مداخله ترتيبًا هجائيًا ويجمعها تحت حرفها الأول. ويهمل أداة التعريف: البصرة تُرتَّب تحت ب، بين بدر وبغداد، وتُطبع كما كُتبت (index.ignoreArticle، مفعَّل افتراضيًا حين تكون لغة الفهرس العربية؛ ويحتفظ لفظ الجلالة الله بأداته). ويهمل كذلك الحركات والتطويل، ويرتّب أ إ آ ٱ تحت ا، ويضع ة مع ه وى مع ي. وتُضمّ أرقام الصفحات بالفاصلة العربية (، )، وتقرأ الإحالة انظر أو انظر أيضًا. والمدخل الذي له مفتاح sort خاص به يحتفظ بأداة التعريف التي في ذلك المفتاح. انظر الفهرس الأبجدي.

الاستشهادات. تأخذ قائمة المراجع في الكتاب العربي المصطلحات العربية للغة أنماط الاستشهاد (CSL، الإعداد المحلي ar: ص للصفحة، ومج للمجلد، وو بين مؤلفين، ووآخرون لما بعد المؤلف الأول) وأرقام المستند في العلامات المرقّمة: [٢، ص ١٢]. وعنوان قائمة المراجع المراجع. أما الفواصل والفواصل المنقوطة المكتوبة في نمط CSL فتبقى كما هي في النمط. انظر الاستشهادات.

#الخطوط

ينضّد Postext كل نمط بعائلة خط واحدة ولا يلجأ إلى عائلة أخرى عند غياب محرف، فلا بد أن يحوي الخط كل حرف عربي وحركة ورقم يطبعه الكتاب. وهذه خطوط مجانية للكتب (كلها بترخيص SIL Open Font License):

ويصلح Markazi Text وNoto Kufi Arabic للكتب الحديثة (للنص والعناوين)، وEl Messiri لعناوين العرض الحديثة. وفي الحجم الاسمي نفسه يبدو خط النسخ أصغر من الخط اللاتيني: يُنضَّد نص الكتاب العربي عادة بحجم 13–15 pt حيث يكون النص اللاتيني 10–11 pt.

• في المتصفح وفي Sandbox يقدّم Google Fonts وFontsource كل عائلة ملفًا لكل مجموعة جزئية: latin وlatin-ext وarabic. ولا يحمّل المتصفح ملف arabic إلا حين يحتاج إليه محرف، والإخراج الذي يُقاس قبل وصوله يُقاس بخط بديل. ويحمّله Sandbox قبل الإخراج الأول؛ ويتحقق المضيف منه بعيّنة فيها حرف عربي (document.fonts.load('16px Amiri', 'ب')). ويجب أن يسلّم مزوّد خطوط PDF الدالةَ renderToPdf ملفَّ arabic للنص العربي؛ والمزوّد الموصوف في مزوّد الخطوط في المتصفح يختار الشريحة حسب نقطة الترميز.
• في الحزمة ضمّن الخطوط كاملة أو مقتطعة على محارف الكتاب، مع الإبقاء على جداول تخطيط OpenType (GSUB وGPOS): ففيها أشكال الوصل والحروف المركّبة ومواضع الحركات والأقواس المعكوسة. والخط المقتطع من دونها يطبع حروفًا منفصلة.
• الأشكال الحرفية الناقصة تُطبع مربعًا فارغًا من الخط؛ ويبلغ renderToPdf عنها لكل خط (missingGlyph)، ويسردها Sandbox في لوحة «الفحوص».
• الحروف اللاتينية داخل النص العربي تُنضَّد بالعائلة نفسها. يحمل Amiri حروفه اللاتينية؛ أما مع خط نسخ حروفه اللاتينية ضعيفة فانضد المقاطع اللاتينية الطويلة بنمط فقرة ذي خط لاتيني.

#في Sandbox

ضمن التصميم › نظام الكتابة تعرض قائمة «لغة المستند» العربية، والعربية (مصر)، والعربية (المغرب)، ويُظهر اتجاه النص والأرقام ما تؤول إليه القيمة تلقائي. ويسرد الإعدادات الافتراضية للعربية › مراجعة… ما يغيّره تهيئة الكتاب للعربية قبل تطبيقه، مع اختيار للخطوط (كلاسيكي: Amiri؛ حديث: Noto Naskh Arabic مع عناوين بخط Noto Kufi Arabic): إعادة الاتجاه والتجليد إلى تلقائي، والترويسات وأرقام الصفحات بخط فيه حروف عربية، وتباعد أسطر 1.75 em، ونص مضبوط، وأرقام المنطقة، وشكل وجدول مرقّمان حسب الفصل، والتعليقات بصيغة شكل ١-١: العنوان، والفصول مرقّمة الفصل الأول، والقوائم مرقّمة ١- أ- (١)، والحواشي مرقّمة في كل صفحة. وتسرد كل أداة لاختيار الخط العائلات العربية أولًا.

ويعطي المحرر كل سطر اتجاه حرفه الأول: سطر العربية يبدأ من اليمين، ويتبع المؤشر ومفاتيح الأسهم الترتيب المرئي، بينما يبقى الترميز داخله (سمات {…}، و[^id]، و:ref[…]، والرياضيات، ووجهات الروابط) من اليسار إلى اليمين. انظر Sandbox.

#إعدادان كاملان

#كتاب حديث بالعربية الفصحى المعاصرة

كتاب بمقاس 14 × 21 cm بخط Noto Naskh Arabic بحجم 13 pt، وعناوينه بخط Noto Kufi Arabic، وفصوله مرقّمة الفصل الأول، وحواشيه «(١)» مرقّمة في كل صفحة، ورقم الصفحة في وسط أسفلها. ويأتي الاتجاه والتجليد على اليمين والأرقام ٠–٩ والكشيدة والتوكيد بالخط العريض من locale: 'ar-EG':

import type { PostextConfig } from 'postext';
 
const pt = (value: number) => ({ value, unit: 'pt' as const });
const mm = (value: number) => ({ value, unit: 'mm' as const });
const em = (value: number) => ({ value, unit: 'em' as const });
const ink = { hex: '#1a1a1a', model: 'hex' as const };
 
const config: PostextConfig = {
  locale: 'ar-EG',
  page: {
    sizePreset: 'custom', width: mm(140), height: mm(210),
    margins: { top: mm(18), bottom: mm(22), left: mm(16), right: mm(20), mirror: true },
  },
  layout: { layoutType: 'single' },
  bodyText: {
    fontFamily: 'Noto Naskh Arabic', fontSize: pt(13), lineHeight: em(1.7),
    textAlign: 'justify', firstLineIndent: em(1.5),
    color: ink, boldColor: ink, italicColor: ink,
  },
  headings: {
    fontFamily: 'Noto Kufi Arabic', color: ink,
    levels: [
      { level: 1, fontSize: pt(20), numberingTemplate: 'الفصل {1:ordinal}', numberSeparator: ': ',
        breakBefore: { enabled: true, parity: 'odd' } },
      { level: 2, fontSize: pt(15) },
    ],
  },
  captionStyle: { labelSeparator: ': ' },
  orderedLists: {
    levels: [
      { level: 1, numberFormat: 'arabic', separator: '-' },
      { level: 2, numberFormat: 'abjad', separator: '-' },
    ],
  },
  footnotes: { markerTemplate: '({n})', numbering: 'page', noteNumberPosition: 'inline' },
  header: { elements: [] },
  footer: { elements: [
    { kind: 'text', id: 'folio', content: '{pageNumber}', fontFamily: 'Noto Naskh Arabic', fontSize: pt(11),
      overflow: 'clip', color: ink, placement: { anchor: { to: 'container', edge: 'center' } } },
  ] },
};

يفتح parity: 'odd' كل فصل في صفحة فردية، وهي في هذا الكتاب صفحة يسرى. وتفصل النقطتان الرأسيتان بين تسمية التعليق ونصه (شكل ١-٢: …)، لأن النقطة الافتراضية بعد الأرقام المشرقية تُقرأ فاصلة عشرية.

#طبعة تراثية مشكولة

طبعة لنص تراثي بمقاس 17 × 24 cm بخط Amiri بحجم 14 pt، لياليها مرقّمة بالحروف، وشعرها مشكول تشكيلًا تامًا، ورقم صفحتها في أعلى الصفحة بين شرطتين، وصفحات مقدماتها مرقّمة بالحروف الأبجدية، ومحتوياتها في آخرها:

const config: PostextConfig = {
  locale: 'ar',
  page: {
    sizePreset: 'custom', width: mm(170), height: mm(240),
    margins: { top: mm(24), bottom: mm(24), left: mm(18), right: mm(24), mirror: true },
  },
  layout: { layoutType: 'single' },
  bodyText: {
    fontFamily: 'Amiri', fontSize: pt(14), lineHeight: em(1.85),
    textAlign: 'justify', firstLineIndent: em(1.5),
    kashida: 'auto', kashidaPatterns: 'naskh',
    color: ink, boldColor: ink, italicColor: ink,
  },
  headings: {
    fontFamily: 'Amiri', color: ink, textAlign: 'center',
    levels: [
      { level: 1, fontSize: pt(18),
        numberingTemplate: 'الليلة {1:ordinal-feminine}', numberSeparator: '',
        breakBefore: { enabled: true, parity: 'any' } },
    ],
  },
  paragraphStyles: [
    { id: 'verse', lineHeight: em(2.1) },
  ],
  footnotes: { markerTemplate: '({n})', numbering: 'page', noteNumberPosition: 'inline' },
  header: { elements: [
    { kind: 'text', id: 'folio', content: '– {pageNumber} –', fontFamily: 'Amiri', fontSize: pt(12),
      overflow: 'clip', color: ink, placement: { anchor: { to: 'container', edge: 'center' } } },
  ] },
  footer: { elements: [] },
};

تبدأ الفصول بـ :::numbering{format="abjad" startAt=1} قبل المقدمة و:::numbering{format="decimal" startAt=1} قبل الليلة الأولى؛ والقصائد كتل :::verse{style="verse"}؛ والفصل الأخير # فهرس المحتويات {toc="false"} يليه :::toc. ولا يحتاج الفهرس إلى أي إعداد ليهمل أداة التعريف ال: فـ index.ignoreArticle مفعَّل في الفهرس العربي. ولطبعة قراءة غير مشكولة من المصدر نفسه، أضف tashkil: 'strip' إلى bodyText.

#حدود معروفة

• الفارسية والأردية والعبرية تنال الاتجاه والأرقام وقواعد الكلمة الكاملة والتجليد على اليمين، لكن بلا كلمات مدمجة خاصة بها (تُطبع الأشكال والجداول والفهرس بالإنجليزية) وبلا تنضيد للنستعليق: يُنضَّد خط النستعليق على خط أساس مستوٍ.
• اتجاه الكتلة يُعيَّن على العناوين والحاويات؛ والفقرة العادية تحتاج إلى :::paragraphs{dir=…} حولها، ولا يوجد {dir=auto}.
• الجزر المعاكسة الاتجاه. في الكتلة المعيَّن لها اتجاه مخالف لاتجاه الكتاب، تتبع التعليقاتُ وأسطرُ المحتويات والفهرس اتجاهَ المستند، وتبقى أيقونة الإطار وعمود علامته وعنوانه في جهة بداية المجرى.
• نص التصميم (الترويسات وصفحات الافتتاح وعناوين الإطارات) يحلّ الترتيب ثنائي الاتجاه سطرًا سطرًا، والنص الذي فيه حرف عربي يفقد تباعد حروفه كله، بما في ذلك كلماته اللاتينية.
• نص التصميم المائل. الترويسة أو نص صفحة الافتتاح المنضَّد بالمائل لا يزال يُميل الحروف العربية.
• الحركات قد تتجاوز حافة الإطار أو خلية الجدول، لأن قصّها لا يتسع لها؛ ولا يحذف tashkil حركات التعليقات وخلايا الجداول ونص التصميم.
• الأعداد. تُطبع أرقام الاستشهادات بالأرقام المغربية (الأوروبية)؛ وتُكتب الأعداد الترتيبية بالحروف في صيغة الرفع المعرَّفة التي تستعملها العناوين.
• الفهرس: تُرتَّب ة تحت ه، ولا تُرتَّب الأسماء بتخطّي ابن أو أبو؛ ولا توجد فهارس للقوافي أو للجذور.
• الشعر: لا شعر مدمج في سياق النثر، ولا أبيات مرقّمة، ولا أشكال مقطعية ذات لازمة متوسطة إلا أسطرًا مفردة متوسطة؛ والشطر الأعرض من السطر يلتف من جهة البداية، بلا مسافة بادئة معلَّقة.
• الكشيدة: النص المنسوخ من مُخرَج HTML لا يزال يحوي التطويلات المُدرجة، ولا يُمنع تراكب الكشائد في الأسطر المتجاورة بعضها فوق بعض.

#المصادر

• W3C، Arabic & Persian Layout Requirements (alreq)، وتحليل فجوات دعم الخط العربي.
• الملحق رقم 9 لمعيار Unicode، Unicode Bidirectional Algorithm؛ والتقرير التقني رقم 53 لـ Unicode، Unicode Arabic Mark Rendering.
• W3C، Ready-made Counter Styles، لأنماط arabic-indic وpersian وسلاسل حساب الجُمَّل.
• aliftype، raqim-kashida (MIT)، ومقدمته؛ وM. Benatia وM. Elyaakoubi وA. Lazrek، “Arabic text justification”، TUGboat 27(2)، 2006.
• Titus Nemeth، On Arabic justification، TypoArabic، جامعة ريدنغ؛ ومؤسسة الخط (Khatt Foundation)، The Big Kashida Secret.
• أحمد زكي باشا، الترقيم وعلاماته في اللغة العربية، 1912 (هنداوي)، في علامات الترقيم العربية.
• توثيق Amiri وScheherazade New، في الكشيدة وتراكب الحركات والمجموعات الأسلوبية.
• Unicode CLDR، للأرقام الافتراضية في كل منطقة.