إعدادات Postext

كل قرار من قرارات الإخراج في Postext يصدر عن كائن إعدادات واحد.

يتحكم PostextConfig في أبعاد الصفحة وترتيب الأعمدة وتنضيد نص المتن وأنماط العناوين ولغة المستند (locale) وغير ذلك. كل خاصية فيه اختيارية: يأتي Postext بقيم افتراضية معقولة مستوحاة من تقاليد تنضيد الكتب. لا تحتاج إلى تحديد شيء إلا ما تريد تغييره.

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt overrides the 8 pt default
  headings: { fontFamily: 'Open Sans' },
});

للاطلاع على طريقة معالجة المحرّك لهذه الإعدادات، راجع صفحة البنية.

#فهرس المرجع

هذا المرجع طويل. هذه كتله الرئيسية:

• الصفحة — المقاس والهوامش وشبكة خطوط الأساس وخطوط القص والتجليد.
• التخطيط — عدد الأعمدة والفواصل بين الأعمدة والخطوط الفاصلة والكتابة العمودية.
• الترويسات والتذييلات — عناصر نصية وخطوط في كل صفحة، مع عناصر نائبة (placeholders) وزوجية الصفحة والمحاذاة.
• نص المتن — التنضيد وتقسيم الكلمات بالواصلة والأسطر اليتيمة (orphans) والأرامل (widows).
• لغة المستند — الخاصية locale في المستوى الأعلى: اللغة الاحتياطية لتقسيم الكلمات، وأنواع الموارد المدمجة، وعبارات المتابعة في الجداول والإطارات المقسومة، واللغة الموسومة في ملف PDF الميسّر؛ والأرقام (numerals) واتجاه النص (direction) اللذان تقتضيهما؛ واللغات والأنظمة الكتابية التي ينضّدها Postext. ودليل الكتب المكتوبة من اليمين إلى اليسار هو الإخراج العربي.
• تنضيد لغات شرق آسيا — cjk: الأعراف الإقليمية وقواعد كسر الأسطر في النصوص الصينية واليابانية والكورية، وطريقة توزيع المسافات في أسطرها المضبوطة، وعروض علامات الترقيم وتعليقها، والمسافة بين حروف الهان والحروف اللاتينية، وشبكة الحروف، والأرقام القائمة في النص العمودي، والعلامات وحروف الروبي (ruby) وحواشي الواريتشو (warichu). ودليل ذلك كله هو الإخراج الصيني.
• العناوين — القيم الافتراضية المشتركة وتجاوزات H1–H6.
• القوائم غير المرقّمة والقوائم المرقّمة — النقاط والترقيم والتداخل.
• الرياضيات — رسم LaTeX والمقياس واللون والهوامش.
• أنواع الموارد — ترقيم مصنّف للأشكال والجداول والأنواع المخصّصة.
• نمط الجداول (مع أنماط الجداول المسمّاة) ونمط التعليقات — التنضيد والزخرفة لموارد الجداول وتعليقاتها.
• نمط المخططات — إعادة تلوين مخططات SVG المضمّنة بحبر واحد للطباعة بالألوان الخاصة (spot colours).
• أنماط الفقرات — أنماط مسمّاة لحاويات :::paragraphs: قوائم المراجع والمسارد والملاحظات.
• أنماط الإطارات — ملاحظات ونصائح وأهداف داخل إطارات لحاويات :::callout.
• الأجزاء — صفحات فواصل الأجزاء لحاويات :::part: زوجية الصفحة ومساحة المتن وتصميم صفحة الافتتاح وتنضيد المتن.
• أنماط العناوين — أنماط مسمّاة لعناوين {style="…"}: فصول غير مرقّمة، وصفحات تمهيدية بترويساتها الخاصة، والهندسة ولوحة الألوان.
• جدول المحتويات — ما يطبعه :::toc: تنضيد المداخل، والنقاط الموصِلة، وأرقام الصفحات، وأسطر المؤلفين، وصفوف الأجزاء.
• الفهرس الأبجدي في آخر الكتاب — ما يطبعه :::index: تنضيد المداخل، والإزاحات، وفواصل أرقام الصفحات ونطاقاتها، ومجموعات الحروف، ولغة الترتيب.
• الوحدات والألوان + لوحة الألوان — Dimension وColorValue والألوان المسمّاة.
• الخطوط المخصّصة — عرّف عائلات خطوط يرفعها المستخدم إلى جانب Google Fonts.
• عارض HTML — عرض العمود المستهدف وكسر الأسطر في مُخرِج HTML.
• إنتاج PDF (الإعدادات) — المخطط التفصيلي (outlines)، والمخرجات الميسّرة (الموسومة)، وفرض فضاء ألوان على مُخرِج PDF.
• عارض Folio (الإعدادات) — نوع الورق والتجليد والسطح والإضاءة في عارض الكتاب ثلاثي الأبعاد.
• التصحيح — طبقات بصرية وتحذيرات تأليف للمحرر.
• الاستخدام البرمجي — buildDocument والتحذيرات التي يبلّغ عنها والمحلِّلات (resolvers) وذاكرات التخزين المؤقت.
• تشغيل الإخراج في Web Worker — بناء خارج الخيط الرئيسي مع إمكانية الإلغاء.
• دمج عارض HTML وإنتاج ملفات PDF — وصفات كاملة من البداية إلى النهاية.
• كتب EPUB — ملفات EPUB 3 ثابتة التخطيط وأخرى قابلة لإعادة التدفق من الإخراج نفسه، وفحصها بأداة EPUBCheck.

#الصفحة

تتحكم الخاصية page في الأبعاد المادية للصفحة وفي مظهرها.

#الهوامش المتناظرة

تُقرأ الكتب صفحتين متقابلتين، وعادةً ما يختلف الهامش الداخلي عن الخارجي. يحوّل margins.mirror الهوامش الأربعة إلى هوامش صفحات متقابلة:

{
  "page": {
    "margins": {
      "top": { "value": 2, "unit": "cm" },
      "bottom": { "value": 2.5, "unit": "cm" },
      "left": { "value": 2.2, "unit": "cm" },
      "right": { "value": 1.4, "unit": "cm" },
      "mirror": true
    }
  }
}

بهذه الإعدادات يكون لكل صفحة فردية هامش 2.2 cm على اليسار (الكعب) و1.4 cm على اليمين (الحافة الأمامية)؛ ولكل صفحة زوجية 1.4 cm على اليسار (الحافة الأمامية) و2.2 cm على اليمين (الكعب). تحمل كل صفحة مُخرَجة contentArea الخاصة بها في VDTPage، فكل ما يُشتق منها، أي الأعمدة وأشرطة العناصر العائمة بعرض الصفحة وحاويات الترويسة والتذييل وأشرطة صفحات الافتتاح ذات span: 'page'، يتبع الهندسة المتناظرة تلقائيًا. أما إطارا الصفحة والنزف اللذان تستخدمهما عناصر التصميم المثبّتة إلى 'page' / 'bleed' فلا يتأثران: إنهما يصفان الورقة المادية لا الهوامش.

#التجليد

«تُجلَّد المستندات الصينية المنضّدة عموديًا على الجانب الأيمن، وتُجلَّد المستندات المنضّدة أفقيًا على الجانب الأيسر» (clreq §7.1.1.1). يُخرج page.binding: 'right' الكتابَ للتجليد على الحافة اليمنى:

• تظل الصفحة 1 فردية وتظل وجهَ الورقة (recto)، فتحتفظ breakBefore.parity و:::pagebreak{parity} وعناصر التصميم ذات parity وكل عدّ للصفحات بمعانيها. ما يتغيّر هو الجانب الذي يقع عليه وجه الورقة: الصفحة اليسرى من الصفحتين المتقابلتين. والفصل الذي يُفتتح على وجه ورقة جديد يُفتتح على صفحة يسرى (clreq §7.1.3.3).
• مع margins.mirror يبقى left هو الهامش الداخلي، لكن الصفحات الفردية هي التي تبدّل: الهامش الداخلي للصفحة 1 على يمينها، وللصفحة 2 على يسارها. ويتبع القاعدة نفسها كلٌّ من العمود الجانبي في oneAndHalf عند 'outer' / 'inner'، والعنصر العائم المُدار الملاصق للكعب، وهوامش صفحات الأجزاء، وأيقونات زوايا الإطارات عند 'outer' / 'inner'.
• يصرّح المستند بذلك (VDTDocument.binding: 'right')، فلا يحتاج المضيف أبدًا إلى قراءة الإعدادات: يعرض Sandbox، بيئة التجربة في المتصفح، صفحاته المتقابلة على هيئة [3 | 2] والصفحة 1 وحدها على يسار الكعب، ويعرض عارض HTML فيه الصفحاتِ من اليمين إلى اليسار، فيُفتح عند الطرف الأيمن ويقود السهم الأيسر إلى الصفحة التالية. وفي وضع multi يرتّب renderToHtml الصف من اليمين إلى اليسار.
• يحمل ملف PDF /ViewerPreferences << /Direction /R2L >> و/PageLayout /TwoPageRight (الصفحة 1 وحدها ثم أزواج)، موسومًا كان أم غير موسوم. يتبعهما Acrobat وFoxit؛ ويتجاهلهما كليهما العارض المدمج في Chrome.

لا تتحرك أرقام الصفحات والترويسات من تلقاء نفسها: القالب الذي يطبع رقم الصفحة في الزاوية الخارجية يحتاج إلى ضبط عناصره الفردية والزوجية للحافة اليمنى (تقبل العناصر parity).

والكتاب المكتوب من اليمين إلى اليسار (العربية والفارسية والعبرية…) يُجلَّد على اليمين أيضًا: تعطي 'auto' الحافة اليمنى حين يُحسم direction الخاص بالمستند إلى 'rtl'. ويعكس مثل هذا الكتاب تدفقه كله كذلك، فيكون عموده الأول هو الأيمن، وتقع إزاحاته وعلامات قوائمه وعناصره العائمة وحواشيه على اليمين؛ أما خانات الترويسة والتذييل فتبقى في مواضعها المادية. انظر الإخراج العربي.

#مقاسات الصفحة المسبقة

#شبكة خطوط الأساس

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

page: {
  baselineGrid: { enabled: true, color: { hex: '#e0e0e0', model: 'hex' } }
}

#خطوط القص

عند التفعيل تتّسع اللوحة لتشمل مساحة نزف، ويرسم المحرّك علامات القص عند كل زاوية لأغراض الإنتاج الطباعي.

تكبر الورقة بمقدار bleed + markOffset + markLength من كل جانب، وتقع الصفحة المقصوصة في وسطها. تحصل كل زاوية من زوايا حدّ القص على علامتين طول كل منهما markLength، كل منهما على امتداد إحدى الحافتين اللتين تلتقيان عندها. تبدأ العلامة على مسافة markOffset خارج حدّ القص، أو عند حافة النزف حين يكون bleed هو الأعرض بينهما، فلا تقع أي علامة فوق رسم يمتد إلى النزف. مع القيم الافتراضية (3 mm من النزف وإزاحة 3 mm) تمتد العلامات من 3 إلى 8 mm خارج حدّ القص، ويدور حول الورقة خارجها شريط فارغ عرضه 3 mm. تعيد cropMarkSegments(page, doc.config.page, doc.trimOffset) علامات الصفحة الثماني ببكسلات الصفحة، وهي التي يرسمها مُخرِجا Canvas وPDF. الوسيط الثالث هو موضع حدّ القص داخل الورقة، وهو القيمة التي يُكتب منها TrimBox في ملف PDF؛ وإن أُغفل، يُحسب من cutLines بالطريقة نفسها.

لا يُطبع خارج النزف شيء سوى العلامات. كل ما ترسمه الصفحة، بما في ذلك عناصر التصميم المثبّتة إلى 'page' أو 'bleed'، يُقصّ عند صندوق النزف في Canvas وفي PDF وفي مخرجات HTML، كما يقصّه التصدير من برامج النشر المكتبي (DTP): الشريط أو الصورة الموضوعة عمدًا خارج النزف تُقطع عند حافة النزف، حيث كانت آلة القص ستزيلها على أي حال. وحتى الإصدار postext 1.4 كان مثل هذا العنصر يمتد فوق العلامات إلى حافة الورقة.

في PDF (postext-pdf) يكون MediaBox لكل صفحة هو الورقة كلها. وتحمل الصفحة أيضًا TrimBox، أي الصفحة المقصوصة، وBleedBox، أي حدّ القص مضافًا إليه النزف، وهما ما تقرؤه أدوات الترتيب الطباعي (imposition) والفحص قبل الطباعة (preflight). وحين يُكتب ملف PDF بنظام CMYK (colorSpace: 'cmyk'، أو pdfGeneration.forceColorSpace مع colorSpace: 'cmyk')، تُطلى العلامات بلون التسجيل، أي الفصل اللوني /All، فتُطبع على كل لوح. أما ملفات PDF بنظام RGB أو بالتدرّج الرمادي فتطليها باللون color.

#ترقيم الصفحات

يتحكم القسم page.pageNumbering في طريقة تنسيق تسميات الصفحات وفي القيمة التي يبدأ منها العدّاد. وهو لا يعرّف إلا القيمة الافتراضية على مستوى المستند كله؛ ولإعادة بدء الترقيم في منتصف المستند (مثل صفحات تمهيدية بأرقام رومانية تتحول إلى فصول بأرقام عشرية تبدأ من 1)، استخدم التوجيه :::numbering (انظر صيغة المستند › التوجيهات).

تُخزَّن التسمية المحسوبة في كل VDTPage باسم pageLabel، وهي ما يُحسم إليه العنصر النائب {pageNumber} في الترويسة والتذييل. وتُصدر ملفات PDF شجرة أرقام /PageLabels فيطابق مؤشر الصفحة في Preview / Acrobat والتنقل عبر «الانتقال إلى الصفحة» التسمياتِ المطبوعة تمامًا. والنمط الذي لا يملك له PDF رمزًا (الأرقام الصينية والأرقام داخل دوائر والأرقام كاملة العرض) يُكتب صفحةً صفحة، فيعرض القارئ 一، 二، 三 أيضًا.

صيغ كتابة أنماط الترقيم

ثلاثة إعدادات تختار تنسيقًا للترقيم، ولكل منها صيغة كتابة نشأت معه: تسميات الصفحات (page.pageNumbering.format و:::numbering{format=…}) تقول lower-roman، والقوائم المرقّمة (orderedLists.numberFormat) تقول arabic للعشري، وأنواع الموارد (counterFormat) تقول roman-lower. يقبل كل منها جميع الصيغ أدناه، فالتنسيق المنسوخ من إعداد يعمل في الإعدادين الآخرين. لا تميّز الأسماء بين الأحرف الكبيرة والصغيرة؛ أما الصيغ ذات الحرف الواحد فتميّز (i وI مختلفان).

تحتفظ أنماط شرق آسيا بأسمائها في CSS Counter Styles في الإعدادات الثلاثة كلها. تكتب الأعداد الصينية غير الرسمية 十 للأعداد من 10 إلى 19 دون 一 في أولها (十二، ولكن 一百一十)، و零 واحدة لكل سلسلة أصفار داخل العدد (一百零一، 一千零五十)، و万 أو 萬 للعشرة آلاف، و亿 أو 億 للمئة مليون (一万零一十). وحده cjk-decimal يستخدم 〇، خانةً خانة، على طريقة كتابة السنوات (二〇二六، GB/T 15835—2011). تتوقف السيقان عند 10، والفروع عند 12، والأرقام داخل الدوائر عند 50؛ وبعدها يُطبع العدد بالأرقام. ويتبع 一 و壹 نظامَ كتابة locale الخاص بالمستند: التقليدي لـ zh-Hant أو zh-TW أو zh-HK، والمبسّط في غير ذلك. بعض الطبعات القديمة تكتب 101 على هيئة 一百一 دون 零؛ ولا يطبع Postext هذه الصيغة.

تحتفظ الأنماط العربية بأسماء CSS حيث يوجد لها اسم في CSS (arabic-indic وpersian؛ ويُقرأ urdu وmaghrebi-abjad المأخوذان من مذكرة W3C Ready-made Counter Styles على أنهما persian وarabic-abjad-maghrebi). ويحتفظ arabic بمعناه القديم، أي الأرقام الأوروبية. يكتب arabic-abjad الأعداد الأبجدية الجمعية في العربية التراثية وفي ترقيم أوراق المخطوطات، بدءًا بالقيمة الأعلى: 11 هي يا، و1446 هي غتمو، وعدد الآلاف يأتي قبل غ (2000 بغ، 1002 غب)؛ وبعد 999 999 يُطبع العدد بالأرقام. تستخدم مذكرة W3C هذا الاسم لسلسلة من 28 حرفًا تكون فيها 11 هي ك؛ ويسمّي Postext تلك السلسلة abjad، أي ترقيم عناصر القوائم بالحروف بترتيب أبجد (أ، ب، ج، د، هـ)، ويسمّي hijai الترتيب الهجائي (أ، ب، ت، ث). كلاهما يكتب الحرف الأول بهمزته (أ)، والهاء التي تقف منفردة على هيئة هـ بالتطويل، فلا يُقرأ أي منهما على أنه الرقمان ١ و٥؛ وبعد 28 تتضاعف الحروف، كما في lower-alpha (أأ, أب). وتتبع القيم المغربية العبارة التذكيرية صعفض قرست ثخذ ظغش (ص 60، ض 90)؛ وتبدّل قائمة W3C بين ص وض. ولا يكفي حرف أ وحده للتمييز بين السلسلتين، فرمزاهما هما أحرفهما الأربعة الأولى: {1:أبجد} و{1:أبتث}. أما أرقام المستند نفسه فتُضبط بالإعداد numerals.

الصيغ الأخرى مخصّصة للإعدادات التي لا يتحقق أحد من أنواعها: الإعدادات المسبقة بصيغة JSON وJavaScript العادية. ما تزال أنواع TypeScript لا تسمّي إلا الصيغة الخاصة بكل إعداد، أي التي يكتبها Sandbox ويعيدها resolveAllConfig، بما فيها أسماء شرق آسيا، فيلتزم بها PostextConfig المحدّد النوع، وتحتاج أي صيغة أخرى إلى تحويل نوع (cast).

// JavaScript or a JSON preset (in TypeScript, each setting's own spelling)
orderedLists: { numberFormat: 'decimal' },          // same as 'arabic'
page: { pageNumbering: { format: 'roman-lower' } }, // same as 'lower-roman'
resourceTypes: [{ id: 'plate', counterFormat: 'upper-roman', … }], // same as 'roman-upper'

يحوّل resolveAllConfig تنسيقات القوائم والصفحات إلى صيغة الإعداد الخاص بكل منها، فتُحسم 'decimal' إلى 'arabic' في orderedLists، و'roman-lower' إلى 'lower-roman' في page.pageNumbering، ويُسقط stripConfigDefaults أي صيغة تساوي القيمة الافتراضية. تعرض لوحات Sandbox كل إعداد من الإعدادات الثلاثة بصيغته الخاصة، أيًا كانت الصيغة المستخدمة في الإعدادات. وأي قيمة أخرى، مثل roman أو 01 أو خطأ إملائي، ترقّم بالأرقام العشرية بدلًا من طباعة undefined، ويُبلَّغ عنها تحذيرًا في الإعدادات. وتقبل قوالب ترقيم العناوين الأسماء نفسها بعد النقطتين ({1:roman-upper} هو {1:I})، إلى جانب صيغتها الخاصة ذات الأصفار البادئة {1:01}.

#التخطيط

تتحكم الخاصية layout في ترتيب الأعمدة داخل مساحة المحتوى.

#الكتابة العمودية

مع writingMode: 'vertical-rl' تُخرَج الصفحة كأنها صفحة أفقية أُديرت ربع دورة باتجاه عقارب الساعة. يُنضَّد التدفق في إطار عرضه يساوي طول الورقة؛ وأسطره هي أعمدة النص العمودي، تُقرأ من اليمين، وكل ما يفعله المحرّك بالأسطر (الكسر وضبط الأسطر والعناصر العائمة والحواشي السفلية وقواعد إبقاء العناصر معًا) يعمل في ذلك الإطار. وعليه، على الورقة:

• عمود التخطيط هو طبقة (tier، 栏): يعطي layoutType: 'double' طبقتين مكدّستين من الأعلى إلى الأسفل، تُملآن بدءًا من أعلى اليمين؛ وgutterWidth هو الفجوة بينهما، والخط الفاصل بين الأعمدة خطٌّ أفقي بينهما. لا تُوازَن الطبقات في نهاية الفصل (clreq §7.1.3.4): موازنة الأعمدة معطّلة في المستند العمودي ما لم يُضبط headings.balancing.enabled.
• ما يسمّيه التدفق «الأعلى» هو الحافة اليمنى للورقة، حيث تبدأ القراءة: العنصر العائم في الأعلى يقع على يمين الصفحة، والعائم في الأسفل على يسارها، وشريط صفحة الافتتاح الممتد على الصفحة شريطٌ ينزل على الحافة اليمنى، والحواشي السفلية تقع عند الطرف الأيسر لكل طبقة. وعنصر التصميم المثبّت إلى أعلى الصفحة (تصميم عنوان، إطار ثابت) مثبّت إلى الحافة اليمنى. القيمة 'left' للإعداد sideColumnSide هي الطبقة العليا، و'right' الطبقة السفلى؛ وتُقرأ 'outer' و'inner' على أنهما 'right' و'left'.
• هوامش التدفق هي هوامش الورقة مُدارة: الهامش الأيمن هو أعلى التدفق، والهامش العلوي يساره. وتحتفظ page.margins بأسمائها على الورقة.
• تبقى الترويسات وأرقام الصفحات وعلامات القص وخلفية الصفحة على الورقة، منضّدة أفقيًا، كما تصف clreq للكتب العمودية.
• تقف الأشكال والجداول قائمة. يملأ الشكل ارتفاع طبقته بقدر ما يسمح تعليقه، على ألا يزيد عرضه على عرض الصفحة؛ والعرض الذي يأخذه هو المساحة التي يشغلها في التدفق. يُنضَّد تعليقه أفقيًا تحته، وكذلك خلايا الجدول: كلاهما يُقاس نصًا أفقيًا. يُنضَّد الجدول قائمًا عبر الصفحة، وتُقطع صفوفه على قدر الطبقة حين يكون أطول منها. يضع placement.align الشكل في أعلى طبقته ('left') أو وسطها أو أسفلها. لا يُطبَّق placement.rotate حيث يُشار إلى الشكل أول مرة في نص عمودي: يبلّغ البناء عن تحذير المحتوى rotateIgnoredVertical. أما القسم الأفقي من الكتاب (نمط عنوان يضبط layout فيه 'horizontal-tb') فيدير أشكاله كما طُلب.
• صورة التصميم (رسم صفحة افتتاح، أو رسم صفحة جزء) تقف قائمة أيضًا. يُحسب مقاس صندوقها في التدفق بعد تبديل عرض الصورة وارتفاعها، فيكون size.width هو المسافة التي تمتد فيها الصورة نزولًا في العمود، ويُستنتج عرضها على الورقة من تناسب أبعادها.
• الحروف: تقف حروف الهان والكانا والصيغ كاملة العرض قائمة، كلٌّ منها بعرض em واحد؛ وتُدار الكلمات اللاتينية والأرقام جانبيًا بعروضها الأفقية؛ وتأخذ علامات الترقيم الصيغةَ العمودية من الخط. لا تُدار علامات الوقف والتوقف أبدًا: يضع خط البر الرئيسي 、。，． في الزاوية العليا اليمنى من الخانة و！？：； في نصفها الأيمن، ويوسّطها خطُّ تايوان أو هونغ كونغ (cjk.region). تأخذ الأقواس صيغها العمودية، وتُقرأ “ ” ‘ ’ في نصوص البر الرئيسي على هيئة 『』「」. وتأخذ الشرطات وعلامات الحذف وشرطة الموجة الصيغةَ العمودية من الخط حيث يملكها (يربط Noto CJK صيغة — بـ vert مع fwid: خطٌّ ينزل في وسط الخانة)، وإلا فتُدار مع توسيط حبرها على محور العمود. والـ 破折号 (——) في النص الصيني خطٌّ واحد ينزل في العمود: صيغه العمودية تترك فراغًا عند طرفي كل خانة، فتُدار كل شرطة مع السطر وتُمدّ كما في النص الأفقي (انظر عروض علامات الترقيم). والعدد الذي لا يزيد على رقمين يقف في خانة قائمة واحدة، ما لم يقع في جملة لاتينية فيتبع كلماتها (انظر الأرقام في النص العمودي). وتأخذ النقطة الوسطى (·) نصف خانة في نصوص البر الرئيسي وخانة كاملة في نصوص تايوان وهونغ كونغ. والعلامات التي يجعلها Unicode قائمةً (× © ± § ℃ ① وما شابهها) تقف في خانة خاصة بها، حتى داخل عدد: 3×4 هو 3 و4 مُداران جانبيًا وبينهما × قائمة. والفاصلة العليا أو النقطة الوسطى بين حرفين من كلمة لاتينية (don’t، l·l) تبقى في الكلمة، مُدارة جانبيًا. وتتبع الفقرة اللاتينية في تدفق عمودي القواعد نفسها. أما الصيغ الرياضية المدرجة في السطر والشارات (chips) وعيّنات الألوان (swatches) فتُدار جانبيًا مع السطر.
• يُقاس كل حرف كما يُرسم: الخانة تتقدّم بمقدار خانتها على امتداد السطر، والمقطع المُدار جانبيًا بعرضه الأفقي. والنص الذي يبقى أفقيًا على الورقة (الترويسات وأرقام الصفحات والتعليقات وخلايا الجداول) يُقاس أفقيًا.
• تنطبق عروض علامات الترقيم وتعليق علامات الترقيم والمسافة بين حروف الهان والحروف اللاتينية على امتداد السطر نزولًا كما تنطبق عليه أفقيًا. الفراغ الذي يسبق الحرف يكون فوقه والفراغ الذي يليه تحته: تأخذ 、 بنمط Kaiming نصف خانة، وتنضغط 」「 إلى خانة ونصف، ويبدأ القوس الافتتاحي المقصوص في رأس السطر أعلى بنصف خانة، وتقع 。 المعلّقة تحت أسفل سطرها، والمسافة بين الهان واللاتينية ربع em من العمود فوق الكلمة المُدارة جانبيًا وتحتها. وتحتفظ ：；？！ بخانة كاملة في النص العمودي في كل المناطق.
• تَعُدّ شبكة الحروف الحروفَ نزولًا على السطر والأسطرَ عبر الصفحة: يحدّد charsPerLine طول الطبقة، وlinesPerPage عدد الأسطر التي تتسع لها الصفحة، ويعطي layoutType: 'double' طبقتين من حروف كاملة بينهما فاصل من وحدات em كاملة.

وللمضيفين الذين يقرؤون الإخراج: تحمل الصفحة العمودية VDTPage.flow. تكون contentArea والأعمدة والكتل والأسطر والعناصر العائمة ومساحات الحواشي وشريط صفحة الافتتاح وطبقات تصميم الكتل بإحداثيات التدفق؛ أما width وheight وheader وfooter فعلى الورقة. تحوّل flowToPage وpageToFlow وflowRectToPage وpageRectToFlow بين النظامين، وتخبر verticalOrientation(char, region) كيف يقف الحرف. يعطي flow.centralBaselines، لكل عائلة خط، المحور الذي وسّط عليه الإخراجُ الحروفَ القائمة: مركز حبر 中، الذي يمتد شُقّه الطويل على ارتفاع صندوق em كله (0.38 em فوق خط الأساس في Noto Serif وNoto Sans، بنسختيهما SC وTC على السواء)، والموجود في كل خط صيني وياباني وكوري. يُوسَّط كل سطر على ذلك المحور: يقع خط أساس السطر العمودي تحت أعلى صندوق سطره بمقدار نصف ارتفاع سطره مضافًا إليه خط الأساس المركزي للعائلة (أما خط أساس السطر الأفقي فيقع على 0.8 من ارتفاع سطره نزولًا)، فيقف عمود الحروف في منتصف خطوته (pitch)، ويقع الخط المرسوم بين عمودين على مسافة خطوة كاملة في منتصف المسافة بينهما. ويُنضَّد نص التصميم العمودي بالطريقة نفسها في أسطره الخاصة. يرسم Canvas الصفحة العمودية بنفسه؛ ولرسم علامات الترقيم بالصيغ العمودية للخط نفسه، يحمّل المضيف في المتصفح، مرة واحدة لكل عائلة، وجهًا توأمًا تكون فيه تلك الصيغ مفعّلة: loadVerticalAlternates(family, faces)، حيث faces هي مصادر العائلة (عناوين URL أو بايتات) وواصفاتها. ولا يُحتفظ بالتوأم إلا حيث يطبّق المتصفح الخاصية على نص Canvas (Chrome 140 وما بعده): يرسم 「（《 بالتوأم وبنسخة من الوجوه نفسها محمّلة دون الخاصية، بوزن الوجوه المعطاة وأسلوبها، ويحتفظ بالتوأم حين يختلف حبرهما. والاستدعاء اللاحق لوجوه أخرى من عائلة توأمها قيد الاستخدام (العريض بعد العادي) يضيفها إليه. يفعل Sandbox ذلك لكل عائلة في مستند عمودي. ودون توأم، تُدار الأقواس حول صندوق em الخاص بها، وتُنقل علامات الوقف والتوقف في نصوص البر الرئيسي داخل خانتها إلى حيث تضعها الصيغ العمودية للخط: 、。，． إلى الزاوية العليا اليمنى (في حدود 0.07 em من الصيغ العمودية في Noto Serif SC)، و！？：； نصف em إلى اليمين وقليلًا إلى الأعلى (في حدود 0.02 em). ويُنضّد PDF وHTML الصفحة نفسها: انظر النص العمودي في PDF والجدول في كيف يختلف إخراج HTML عن Canvas وPDF. وبالمقارنة خانةً خانة مع HarfBuzz (تخطيط عمودي مع vert) في Noto Serif TC وSC، يقف كل حرف من 「賈雨村」云云，宜乎？故曰！；：、。“引”‘單’…… في حدود 0.02 em منه في Canvas وفي PDF، وفي حدود 0.05 em في HTML (يوسّط Chrome الحرف المُدار على منتصف الصعود والنزول في الخط، وهو في Noto أعلى من مركز صندوق em بمقدار 0.05 em). يعطي flow.dashAdvances، لكل عائلة، التقدّم الأفقي بوحدات em لكل شرطة تمدّها الصفحة لتملأ خانتها (— – ― ⸺ ⸻ －)، للمُخرِج الذي لا يملك مقاييس خطوط خاصة به: يمدّ HTML الشرطة بها، كما يفعل Canvas وPDF من مقاييسهما. ويمكن تنضيد الترويسات وأرقام الصفحات عموديًا أيضًا: انظر عناصر النص العمودي.

#الخط الفاصل بين الأعمدة

يرسم خطًا عموديًا رفيعًا في الفاصل بين الأعمدة للفصل بينها بصريًا.

تحت عنوان ممتد على الصفحة (span: 'page') يبدأ الخط حيث يبدأ نص الأعمدة، تحت شريط العنوان، سواء رسم الشريطَ تصميمُ الافتتاح الافتراضي أم تصميمٌ خاص بالعنوان. وحتى postext 1.4 كان يمتد من أعلى كتلة النص، عبر الشريط.

يمكن لنمط العنوان أن يضبط خطًا فاصلًا خاصًا به في layout الخاص به (انظر أنماط العناوين)، فترسمه صفحات قسمه. والحقل الذي يتركه النمط دون ضبط يأخذ قيمة المستند، فالقسم الذي لا يغيّر إلا أعمدته يحتفظ بالخط الفاصل الخاص بالمستند. وحتى postext 1.4 لم يكن خط النمط يُرسم أبدًا: كانت كل صفحة ترسم خط المستند.

#أنواع التخطيط

• 'single' — عمود واحد يمتد على كامل عرض المحتوى. الأنسب للصفحات الضيقة أو للمحتوى الغالب عليه النص ذي الفقرات الطويلة.

• 'double' — عمودان متساويان في العرض. التخطيط التحريري الكلاسيكي، يُبقي طول السطر ضمن المدى الأمثل من 40 إلى 50 حرفًا لقراءة مريحة.

• 'oneAndHalf' — تخطيط غير متماثل فيه عمود رئيسي وعمود جانبي أضيق. العمود الجانبي (يتحكم فيه sideColumnPercent) مناسب لملاحظات الهامش والأشكال الصغيرة والمحتوى المساند. تعمل القيم بين 25 و40% جيدًا، ويأخذ مسارٌ ضيق لأرقام الأسطر أو العلامات الهامشية نحو 10–15%. يساوي العمود الجانبي sideColumnPercent % من عرض المحتوى، والعمود الرئيسي هو ما يتبقى بعد الفاصل، فعند 50% يكون العمود الجانبي أعرض من الرئيسي بمقدار فاصل واحد. تُخرَج أي قيمة كما كُتبت ما دام كل عمود يحتفظ بـ 1% على الأقل من عرض المحتوى؛ أما القيمة التي تترك أيًا منهما أضيق من ذلك، أي 0 أو أقل، أو قيمة كبيرة إلى حدّ أن يختفي العمود الرئيسي خلف الفاصل، فتُقيَّد إلى أقرب قيمة تحفظ العمودين، والقيمة التي ليست عددًا تأخذ القيمة الافتراضية، 33. وعندئذ تحمل configWarnings الخاصة بالمستند { kind: 'sideColumnPercentClamped', path: 'layout.sideColumnPercent', value, used }، ويسمّي مسارُ layout الخاص بنمط عنوان ذلك النمطَ، كما في headingStyles[2].layout.sideColumnPercent، ويُقاس على هوامش ذلك النمط، ويعرض Sandbox هذه التحذيرات في لوحة الفحوص (Checks)؛ وتعيد collectConfigWarnings(config) القائمة نفسها دون إخراج أي شيء. والتخطيط الذي ليس 'oneAndHalf' لا يقرأ القيمة أبدًا، ولا يبلّغ عنها أبدًا. مع sideColumnRole: 'floats' لا يدخل نص المتن العمود الجانبي أبدًا: يصبح مسارًا للأشكال والجداول والإطارات الموضوعة بـ span: 'side'. يتكدّس الشكل أو الجدول الجانبي بدءًا من رأس المسار في الصفحة التي تستشهد به أولًا، فالشكل الهامشي في الكتاب المدرسي يقع في أعلى صفحته حتى حين يستشهد به النص في موضع أدنى؛ والذي لا يتسع له باقي المسار ينتظر مسار الصفحة التالية. ويتكدّس الإطار الجانبي بجوار النص الذي يقطعه، وحين لا يتسع له باقي المسار هناك ينزلق إلى الأعلى إلى أدنى موضع ما يزال يتسع له (أسفله على أسفل المسار)، أو ينتظر الصفحة التالية. وحين يستمر النص الذي يلي علامة إغلاق الإطار (fence) في الصفحة التالية (العمود ممتلئ، أو قواعد الكسر تنقل ذلك النص)، يبقى الإطار عند علامة إغلاقه، بجوار النص الذي قبله؛ أما النمط الذي فيه sideAtColumnEnd: 'after' فيضعه بمحاذاة السطر الأول من النص الذي يلي علامة الإغلاق بدلًا من ذلك، في مسار الصفحة التالية، كما تحتاج أرقام الأسطر والعناوين الهامشية المكتوبة قبل سطرها. وعنصر تصميم العنوان الذي يقف في المسار، كرقم فصل مثبّت في الهامش الخارجي، يُبعَد عنه التكدّس أيضًا (انظر الارتفاع المحجوز). وما تزال العناصر العائمة والإطارات ذات span: 'page' تعبر العمودين، والعنصر العائم في العمود ذو placement.captionSide يضع تعليقه في المسار، بمحاذاة الشكل. ومع الهوامش المتناظرة وsideColumnSide: 'outer'، يقع المسار عند الحافة الخارجية لكل صفحة: العمود الهامشي في الكتاب المدرسي.

#رؤوس الصفحات وتذييلاتها

تتحكّم الخاصيتان header وfooter في خانتَي رأس الصفحة وتذييلها في كل صفحة. يُرسم رأس الصفحة وتذييلها داخل هوامش الصفحة القائمة: فلا يحجزان مساحة إضافية ولا يُقلّصان مساحة المحتوى.

إطار الحاوية. يوضع العنصر المثبّت إلى 'container' في شريط الهامش الواقع بين المتن وحدّ القص، ممتدًا بعرض مساحة المحتوى. تمتد حاوية رأس الصفحة من حدّ القص العلوي نزولًا إلى أعلى المتن، وحاوية التذييل من أسفل المتن نزولًا إلى حدّ القص السفلي. لذلك تُقاس مراسي top-* في رأس الصفحة ومراسي bottom-* في التذييل من حدّ القص، بينما تُقاس مراسي bottom-* في رأس الصفحة ومراسي top-* في التذييل من حافة المتن. لا تشمل الحاوية النزف ولا شريط علامات القص أبدًا، فيقع رأس الصفحة أو التذييل في الموضع نفسه من الصفحة المقصوصة سواء كان page.cutLines مفعّلًا أم معطّلًا. ثبّت العنصر إلى 'page' (صندوق القص) أو إلى 'bleed' ليتجاوز عرض مساحة المحتوى أو يبلغ النزف.

تستخدم الخانات نموذج خانة التصميم الموحّد: لكل عنصر placement فيه anchor (مرساة إلى الحاوية أو إلى عنصر آخر عبر #id)، وoffset اختياري، وsize اختياري. لا تزال الحقول المسطّحة القديمة align وmarginFromBody وmarginFromEdge وwidth: 'full' مقبولة في الإدخال، وتُرحَّل إلى الشكل الجديد تلقائيًا؛ والوصف المكافئ بالشكل الجديد موثّق أدناه.

تحمل كل خانة قائمة من عناصر النص والخط الفاصل والصندوق. ترتيب المصفوفة هو ترتيب الرسم (يُرسم العنصر الأول أولًا، ويُرسم الأخير فوق الجميع). ويصحّ هذا أيًّا كانت المراسي: قد يُثبَّت عنصر إلى عنصر يرد بعده في القائمة (anchor.to: '#ttl')، فيمكن أن يأتي صندوق الخلفية أولًا ويظل موضعه محسوبًا بالنسبة إلى النص الذي يقع خلفه.

القيم الافتراضية المدمجة. حين يكون header أو footer بقيمة undefined، يطبّق postext قيمة افتراضية مدمجة معقولة بدلًا من خانة فارغة:

• رأس الصفحة الافتراضي: {title} بمحاذاة اليمين في الصفحات الفردية، و{chapterTitle} بمحاذاة اليسار في الصفحات الزوجية، وخط فاصل بالعرض الكامل، وكلها باللون الرئيسي للوحة الألوان، بخط Open Sans 8pt/600، وmarginFromBody بقيمة 16pt (للنص) / 13pt (للخط الفاصل).
• التذييل الافتراضي: {pageNumber} في الوسط في كل صفحة باللون الرئيسي للوحة الألوان، بخط Open Sans 8pt/600، وmarginFromBody بقيمة 16pt.

للاستغناء عن القيم الافتراضية المدمجة، اضبط header: { elements: [] } (أو footer: { elements: [] }). تُحفظ المصفوفة elements الفارغة الصريحة على أنها «بلا عناصر»؛ ووحدها القيمة undefined تستدعي القيم الافتراضية.

#عناصر النص

ترسم عناصر النص سلسلة قالب بعد استبدال العناصر النائبة (placeholders) فيها. تُكتب العناصر النائبة بالصيغة {name}؛ ويُخرج {{ و}} قوسين معقوفين حرفيين.

القيم الافتراضية في الجدول أدناه هي قيم عنصر نص تضيفه بنفسك. أما رأس الصفحة والتذييل المدمجان الموصوفان تحت القيم الافتراضية المدمجة أعلاه فهما عنصران جاهزان لهما قيمهما الخاصة (Open Sans 8pt/600 باللون الرئيسي للوحة الألوان)، وليسا القيم الافتراضية للعنصر.

العناصر النائبة المتاحة:

• {pageNumber}: رقم الصفحة الحالية، بدءًا من 1.
• {totalPages}: العدد الإجمالي لصفحات المستند. في كتاب مُخرَج فصلًا فصلًا (Sandbox، وbuildBundle) يكون كل فصل مستندًا، فيكون هذا عدد صفحات الفصل نفسه.
• {bookTotalPages}: العدد الإجمالي لصفحات الكتاب كله: كل الفصول، بما فيها الصفحات الفارغة. وفي مستند مُخرَج وحده يساوي {totalPages}. انظر عدد صفحات الكتاب أدناه.
• {title}، {subtitle}، {author}، {publishDate}: قيم تُقرأ من content.metadata. البيانات الوصفية المجهولة أو الفارغة تُرسم سلسلةً فارغة (وتثير تحذيرًا في Sandbox).
• {chapterTitle}: نص آخر H1 في الصفحة الحالية أو قبلها. يُتخطّى H1 الذي يضبط نمط عنوانه runningChapter: false (لوحة مصوّرة، أو خريطة).
• {chapterTitleAtTop}، {chapterNumberAtTop}: عنوان الفصل الساري في أعلى الصفحة ورقمه، ويختلفان عن {chapterTitle} و{chapterNumber} في صفحة يبدأ فيها فصل جديد تحت نص آخر. انظر الفصل في أعلى الصفحة أدناه.
• {partTitle}، {partNumber}: عنوان الجزء الحالي ورقمه (آخر صفحة :::part في الصفحة الحالية أو قبلها؛ والصفحات الفارغة المضافة للزوجية قبل صفحة الجزء مباشرةً تنتمي إليه). فارغان قبل الجزء الأول.
• {firstMark.<key>}، {lastMark.<key>}: الكلمة الدليلية الأولى والأخيرة في الصفحة: عنوان من مستوى ما (h1–h6) أو مدخل من نمط فقرة. انظر الكلمات الدليلية أدناه.

عدد صفحات الكتاب

يطبع {bookTotalPages} عدد صفحات الكتاب كله، وهو العدد الذي يراه القارئ في «الصفحة 12 من 348». يعدّ الصفحات المادية، بما فيها الفارغة، مثل {totalPages}، لكن عبر كل الفصول:

• المستند المُخرَج وحده (buildDocument بلا continuation) هو الكتاب كله: {bookTotalPages} يساوي {totalPages}.
• buildBundle يُخرج الكتاب، ويجمع صفحات كل الفصول، ثم يُخرجه مرة أخرى بذلك المجموع، فيطبع كل فصل العدد نفسه. لا يحرّك العدد أي فاصل صفحة أبدًا، فتكفي جولة إضافية واحدة لاستقراره؛ والإعدادات التي لا تطبع {bookTotalPages} لا تكلّف شيئًا.
• Sandbox يسلّم كل فصل المجموعَ حالما تُعرف صفحات كل الفصول. وحتى ذلك الحين يطبع الفصل عدد الصفحات حتى نهايته هو. ويعدّ تصدير الكتاب كاملًا في تبويب PDF الصفحاتِ التي يُخرجها: فإذا طبع فصلٌ عددًا آخر، لأن صفحاته لم تكن معروفة بعد، أخرج الكتاب مرة أخرى بالعدد الذي بلغته الفصول.
• المضيف الذي يُخرج الفصول بنفسه يمرّر المجموع في continuation.bookPageCount (للفصل الأول أيضًا). ومن دونه يعدّ {bookTotalPages} الصفحات حتى نهاية المستند (continuation.pageIndexOffset مضافًا إليه صفحاته)، وهذا صحيح للفصل الأخير فقط.

footer: {
  elements: [{
    kind: 'text', id: 'folio', content: '{pageNumber} / {bookTotalPages}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: 'auto' } },
  }],
}

تخبر configUsesPlaceholder(config, 'bookTotalPages') المضيفَ هل يستحق العدد أن يُحسب.

الكلمات الدليلية: العلامة الأولى والأخيرة

يطبع القاموس في ترويسة كل صفحة أول مدخل فيها وآخر مدخل («Aback – Anchor»)؛ ويطبع الكتاب المرجعي أول قسم وآخره. يطبعهما {firstMark.<key>} و{lastMark.<key>}. ويحدّد المفتاح ما يُعلِّم الصفحة:

• من h1 إلى h6: عنوان من ذلك المستوى. العلامة نصّه، دون رقمه.
• معرّف نمط فقرة (entry): فقرة في حاوية :::paragraphs{style="entry"}. العلامة هي المقطع الغامق الذي تبدأ به الفقرة، أي المدخل، دون علامة الترقيم الختامية: **Aback.** Said of… تُعلِّم Aback. والفقرة التي لا تبدأ بنص غامق لا تضع علامة.

{firstMark.<key>} هي أول علامة تبدأ في الصفحة، و{lastMark.<key>} آخرها. الصفحة التي لا تبدأ فيها أي علامة (مدخل طويل مستمر) تطبع العلامة السارية، أي آخر علامة قبلها، في الحالتين. والصفحات التي تسبق أول علامة لا تطبع شيئًا؛ وفي كتاب مُخرَج فصلًا فصلًا يعني ذلك ما قبل أول علامة في الفصل، إذ لا تنتقل العلامات من فصل إلى الذي يليه. العنوان أو الفقرة المقسومة بين صفحات تُعلِّم الصفحة التي تبدأ فيها فقط. يُكتب المفتاح بعد النقطة من حروف وأرقام و_ و-، ويبدأ بحرف أو بـ_؛ والمفتاح المجهول لا يطبع شيئًا.

:::paragraphs{style="entry"}
**Aback.** Said of the sails when pressed back against the mast.
 
**Abaft.** Towards the stern, or behind a given point.
:::

header: {
  elements: [{
    kind: 'text', id: 'guide', content: '{firstMark.entry} – {lastMark.entry}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom' }, size: { width: 'auto', height: 'auto' } },
  }],
}

الكلمات الدليلية ترويسات: تُحسم في خانات رأس الصفحة والتذييل (بما فيها header وfooter لنمط العنوان) ولا تطبع شيئًا في تصاميم العناوين والأجزاء وجدول المحتويات؛ وفي تصاميم العناوين والأجزاء تشير إليها لوحة الفحوص بوصفها عناصر نائبة مجهولة. لإظهار أول مدخل في الصفحات الزوجية وآخر مدخل في الفردية، أعطِ عنصرين parity: 'even' وparity: 'odd'. وعنوان H1 الذي يضبط نمطُ عنوانه runningChapter: false لا يضع علامة h1.

الفصل في أعلى الصفحة

يسمّي {chapterTitle} و{chapterNumber} آخر فصل بدأ في الصفحة أو قبلها. وفي كتاب تتوالى فصوله دون فاصل صفحة بينها، تحمل الصفحة التي تُنهي فصلًا وتبدأ التالي قرب أسفلها عنوانَ الفصل الجديد فوق نص لا يزال ينتمي إلى القديم. أما {chapterTitleAtTop} و{chapterNumberAtTop} فيسمّيان الفصل الساري في أعلى الصفحة، كما تفعل الروايات ذات الفصول المتوالية وكثير من الكتب المرجعية:

• الصفحة التي أول كتلة فيها عنوان H1 لفصل تسمّي ذلك الفصل؛
• أي صفحة أخرى تسمّي الفصل الذي تستمر منه، حتى حين يبدأ فصل جديد في أسفلها؛
• الصفحة الفارغة المضافة للزوجية تتبع الصفحة التي بعدها، وفاصل أنماط always-* يتبع الصفحة التي قبله (انظر ملكية الصفحات الفارغة)؛ وحين تبدأ الصفحة التي تلي صفحة فارغة للزوجية بنهاية فصل، لا بعنوان H1 له، تحتفظ الصفحة الفارغة بذلك الفصل أيضًا؛
• يُتخطّى عنوان H1 الذي له runningChapter: false.

header: {
  elements: [{
    kind: 'text', id: 'chapter', content: '{chapterTitleAtTop}', parity: 'odd', pages: 'body',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom-right' }, size: { width: 'auto', height: 'auto' } },
  }],
}

وكالكلمات الدليلية، كلاهما ترويسة: يُحسمان في خانات رأس الصفحة والتذييل ولا يطبعان شيئًا في تصاميم العناوين والأجزاء وجدول المحتويات. أما {attr.<key>} فيقرأ دائمًا آخر فصل بدأ.

المحاذاة المستنتجة من الحافة

حين يشير placement.anchor.to لعنصر نص إلى عنصر آخر عبر #id، تستتبع حافة المرساة محاذاةً افتراضية للنص في الأسطر الملفوفة:

• right-of وalign-left تستتبعان محاذاة النص align: 'left': تتدفق الأسطر الملفوفة نحو اليمين بدءًا من المرساة.
• left-of وalign-right تستتبعان align: 'right': تلتصق الأسطر الملفوفة بالجانب الأقرب إلى العنصر المستهدف.

يطبّق محرّر العناوين في Sandbox هذه المحاذاة المستنتجة تلقائيًا حين تغيّر حافة المرساة أو هدفها. وهي تُبقي النص الملفوف على أسطر عدة مثبّتًا بصريًا إلى العنصر الذي يتصل به (فمثلًا يصطفّ حرف «P» من كلمة «Postext» الملفوفة عموديًا تحت حرف «I» من «Introduction»).

العلامات المضمّنة والخطوط المحيطية

يكتب عنصر النص نصّه بخط واحد افتراضيًا: تُطبع ** و^ وسائر علامات Markdown كما كُتبت. ومع inlineMarks: true يُقرأ النص المحسوم على أنه Markdown مضمّن، بالعلامات نفسها التي يقبلها نص المتن (انظر صيغة المستند › التنسيق المضمّن):

• يضبط **bold** الوزن 700 (أو fontWeight الخاص بالعنصر إذا كان أثقل)؛ ويعكس *italic* ميل العنصر، فيخرج التوكيد داخل عنصر مائل قائمًا؛ ويفعل ***both*** الأمرين. وتعمل صيغ الشرطة السفلية (__bold__، _italic_) أيضًا.
• يُكتب ^superscript^ و~subscript~ بنسبة 58% من الحجم، مع رفع النص العلوي بمقدار ثلثه وخفض النص السفلي بمقدار 0.15 منه؛ والنص السفلي والعلوي المتلاصقان (T~0~^2^) يُرصّان أحدهما فوق الآخر، كما في المتن.
• تكتب الشرطة المائلة العكسية محرف العلامة نفسه (\*، \_، \^، \~). يحتفظ الرابط بنصه؛ وتُحذف علامات الشيفرة (backticks).

تُقرأ العلامات بعد ملء العناصر النائبة، فيمكن أن تحملها القيمة نفسها: سطر المؤلفين في سمة عنوان يحصل على أرقام الانتساب بوصفها نصوصًا علوية. يعمل اللف والضبط وأنماط الحذف وdropCap وparagraphIndent كلها على النص المعلَّم؛ ويحتفظ كل مقطع بلون العنصر.

{ "kind": "text", "id": "authors", "content": "{attr.authors}", "inlineMarks": true, "overflow": "wrap",
  "fontSize": { "value": 11, "unit": "pt" },
  "placement": { "anchor": { "to": "#title", "edge": "below" }, "offset": { "y": { "value": 6, "unit": "pt" } } } }

# Snow cover and river flow {authors="Ana Ruiz^1^, Luis Gil^2^ and Marta Sanz^1,3^"}

يرسم stroke خطًا محيطيًا حول الحروف: width هو عرض الخط، متمركزًا على حواف الحروف (نصفه داخل الحروف ونصفه خارجها؛ ولا يتغير عرض النص المقيس)، وcolor قيمته الافتراضية لون النص، وhollow: true يترك الحروف بلا تعبئة فلا يظهر إلا الخط المحيطي: رقم عرض مفرّغ، أو عنوان يبرز فوق صورة فوتوغرافية. يُرسم الخط المحيطي فوق التعبئة، بالطريقة نفسها في Canvas، وفي HTML (-webkit-text-stroke)، وفي PDF (نمط رسم النص 2، أو 1 عند التفريغ).

{ "kind": "text", "id": "year", "content": "1863", "fontFamily": "Bitter", "fontSize": { "value": 120, "unit": "pt" }, "fontWeight": 700,
  "color": { "hex": "#1d3557", "model": "hex" },
  "stroke": { "width": { "value": 1.5, "unit": "pt" }, "hollow": true },
  "placement": { "anchor": { "to": "page", "edge": "bottom-right" }, "offset": { "x": { "value": -15, "unit": "mm" }, "y": { "value": -20, "unit": "mm" } } } }

في PDF، تُضمِّن مقاطعُ الغامق والمائل الخطوطَ المطابقة من عائلة خط العنصر، فيجب أن يوفّرها مزوّد الخطوط.

القيم الافتراضية للنص ومزالق التثبيت

يبدأ عنصر النص الذي تكتبه بنفسك من هذه القيم، وبعضها مفاجئ:

• overflow قيمته 'ellipsis-end'. النص الأعرض من مساحته يُقتطع إلى سطر واحد بـ…. اضبط overflow: 'wrap' لعنوان بريدي أو سطر مؤلف أو أي عنوان قد يطول. فاصل الأسطر في المحتوى (سطر جديد، أو \n في القالب أو في قيمة سمة) يبدأ سطرًا جديدًا في كل الأنماط؛ وتقتطع أنماط الحذف كل سطر على حدة.
• align قيمته 'center' وverticalAlign قيمته 'middle'. العنصر التلقائي العرض يأخذ عرض أطول أسطره، فتتوسط أسطره بعضها بالنسبة إلى بعض؛ اضبط align: 'left' لكتلة بمحاذاة اليسار (العنصر التلقائي العرض المثبّت إلى عنصر آخر يحاذي أسطره من جهة مرساته من تلقاء نفسه، انظر أعلاه).
• الخط EB Garamond بحجم 8 pt، أسود، وlineHeight قيمته 1.2، أيًّا كان ما يستخدمه نص المتن. وخلافًا لتباعدات الأسطر الأخرى في الإعدادات، يكون lineHeight لنص التصميم عادةً مضاعفًا بسيطًا (1.2)؛ ويعمل Dimension أيضًا (انظر أعلاه).

العنصر الذي ليس له placement.size.width (أو قيمته 'auto') يحدّد حجمه وفق نصه، لكن فقط ضمن المساحة الواقعة بين نقطة مرساته وحافة الحاوية التي ينمو نحوها، وهي في مرساة top أو bottom ضعف المسافة إلى الحافة الأقرب. ويُحتسب offset الخاص به. الإزاحة بعيدًا عن تلك الحافة لا تكلّف شيئًا: ترويسة مثبّتة عند top-left مع x سالبة (متدلّية في الهامش الأيسر) لا تخسر أي مساحة، لأنها تنمو نحو اليمين. أما الإزاحة نحو تلك الحافة فتقلّص المساحة بالمقدار نفسه (وبضعفه في مرساة top أو bottom)، والإزاحة التي تدفع المرساة إلى ما بعد الحافة لا تُبقي شيئًا: مرساة top-right تقل قيمة x فيها عن سالب عرض الحاوية، أو مرساة top أُزيحت جانبيًا بأكثر من نصف ذلك العرض. وحين لا تبقى مساحة، لا يطبع نمط الحذف شيئًا ويرصّ 'wrap' محرفًا واحدًا في كل سطر. ثلاثة مخارج:

• أعطِ العنصر size.width ثابتًا، فالعروض الثابتة لا تُقيَّد أبدًا؛
• ثبّته إلى 'page' أو 'bleed'، فتصير الصفحة (أو النزف) إطار مساحته؛
• ثبّته إلى الحافة المقابلة من الحاوية.

تمتد حاوية رأس الصفحة من حدّ القص العلوي نزولًا إلى المتن، وحاوية التذييل من المتن نزولًا إلى حدّ القص السفلي: في رأس الصفحة تُقاس مراسي top-* من حدّ القص ومراسي bottom-* من المتن، والعكس في التذييل (انظر إطار الحاوية أعلاه). لا يحرّك رأس الصفحة أو التذييل نص المتن أبدًا، ويُرسم فوقه، فالعنصر المدفوع إلى منطقة المتن يغطي النص. أما شريط صفحة الافتتاح فيُرسم على العكس تحت نص المتن؛ والمساحة التي يأخذها في التدفق موصوفة تحت الارتفاع المحجوز.

#عناصر النص العمودي

عنصر النص الذي له writingMode: 'vertical-rl' يُكتب عموديًا في خانة نصها أفقي: ترويسات أي كتاب وأرقام صفحاته، وهي تبقى على الورقة، وكل تصميم في صفحة أفقية. ويُخرَج نصًّا أفقيًا في إطاره الخاص المُدار ربع دورة باتجاه عقارب الساعة، ثم يُعاد تدويره إلى الصفحة:

• يبقى صندوقه حيث يضعه التموضع. ارتفاعه هو طول السطر: يضبطه size.height (أو 'auto'، أي طول النص؛ أو 'fill'، أي حتى حافة الحاوية)، ويضبط size.width عدد الأسطر التي تتسع عرضًا، ويحدّ size.maxWidth طول السطر.
• يضع align الأسطر على امتداد الصندوق ('left' في الأعلى)، وverticalAlign عبره ('top' في اليمين، حيث يقف السطر الأول)، وتبقى حشوة الصندوق في الجانب الذي كُتبت له.
• تُقاس المحارف وتُرسم كما في صفحة عمودية: محارف Han قائمة بعرض em واحد لكل منها، وعلامات الترقيم بصيغتها العمودية، والكلمات اللاتينية مُدارة جانبيًا، والأعداد القصيرة في خلية واحدة (cjk.uprightDigits). وتضعه Canvas وPDF وHTML في المستطيل نفسه.
• مع inlineMarks: true تميّز علامات الاتجاه مقطعًا كما في المتن: 第:tcy[3.0]回 يضع 3.0 في خلية واحدة، و:upright[GDP] يُقيم الحروف واحدًا تحت الآخر، و:sideways[…] يُدير مقطعًا؛ ولا ينكسر السطر داخل أيٍّ منها أبدًا. والعنصر الأفقي يتجاهلها.
• لا يُضبط حرف استهلالي في عنصر عمودي.
• في تدفق صفحة عمودية (صفحة افتتاح، أو صفحة جزء، أو عنوان إطار) يجري النص نزولًا أصلًا، ولا يغيّر writingMode شيئًا هناك.

تضع الكتب الصينية العمودية ترويساتها وأرقام صفحاتها في واحد من ثلاثة مواضع (clreq §7.2؛ وJLREQ §2.6 لليابانية):

ترويسات الحافة الأمامية كما يضيفها Sandbox (الترويسة › ترويسات الحافة الخارجية (عمودية))، هنا لمتن بحجم 10 pt (يضبطها Sandbox بنسبة 80 % من حجم المتن):

{
  "page": { "pageNumbering": { "format": "trad-chinese-informal" } },
  "header": { "elements": [
    { "kind": "text", "id": "head", "content": "{chapterTitle}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "top" }, "offset": { "y": { "value": 4, "unit": "em" } } } },
    { "kind": "text", "id": "folio", "content": "{pageNumber}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "bottom" }, "offset": { "y": { "value": -5, "unit": "em" } } } }
  ] }
}

anchor.to: 'outer' (انظر تموضع العناصر) هو الهامش الخارجي لكل صفحة، فيجري العنصران نزولًا على الحافة اليسرى للصفحة الفردية والحافة اليمنى للصفحة الزوجية في كتاب مجلّد من اليمين (page.binding). ويُطبع {pageNumber} بصيغة ترقيم الصفحات: trad-chinese-informal يعطي 一百零三 في الصفحة 103، وcjk-decimal يعطي 一〇三. وتظل قواعد كل خانة سارية: pages: 'body' يُبعد الترويسة عن صفحات افتتاح الفصول. والزخرفة القصيرة بين الترويسة ورقم الصفحة (ذيل سمكة ︻، أو خط فاصل) عنصر عادي مثبّت إلى الإطار نفسه.

في VDT تحمل الكتلة العمودية vertical (VDTDesignTextBlock.vertical: المنطقة، والأرقام القائمة، والمحور المركزي لكل عائلة خط)؛ وأسطرها في إطار الكتلة المُدار الخاص بها، xOffset نزولًا من أعلى الصندوق، وbaselineY نحو اليسار من حافته اليمنى. ويحمل مقطع السطر المعلَّم tcy أو orientation، كما يحملهما مقطع في المتن.

#عناصر الخط الفاصل

ترسم عناصر الخط الفاصل خطًا: أفقيًا عبر الخانة، أو عموديًا نزولًا فيها.

#عناصر الصندوق

ترسم عناصر الصندوق مستطيلًا مستدير الزوايا داخل الخانة، وهو مفيد خلفيةً للنص في صفحات افتتاح الفصول أو الأشرطة الجانبية أو التذييلات. تُموضَع عناصر الصندوق حصرًا عبر الحقل placement؛ وليس لها اختصار مسطّح قديم. وتقع التعبئة والحدّ ونصف قطر الزوايا في الكائن المتداخل style (ElementBoxStyle)، كما في مثال JSON تحت «تموضع العناصر».

#عناصر الصورة

يرسم عنصر image موردًا نقطيًا (bitmap) أو SVG من المستند: شعار ناشر في صفحة العنوان، أو علامة في ترويسة. يتحدد حجمه بـplacement.size: إذا تُرك أحد البعدين width / height بقيمة 'auto' (الافتراضية) تبع البعد الآخر نسبة أبعاد الصورة؛ وإذا ضُبط الاثنان، تُلاءم الصورة داخل الصندوق وتُوسَّط. والمورد الغائب أو الذي ليس صورة لا يرسم شيئًا.

{
  kind: 'image', id: 'logo', resourceId: 'logo-publisher',
  placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: { value: 64, unit: 'mm' }, y: { value: 233, unit: 'mm' } }, size: { width: { value: 83, unit: 'mm' }, height: 'auto' } },
}

يقبل resourceId العناصر النائبة التي يقبلها content لعنصر النص، فيرسم تصميم واحد صورة مختلفة لكل عنوان. مع resourceId: '{attr.vignette}' في نمط عنوان، يرسم # Chapter I {style="opener" vignette="log"} المورد log ويرسم # Chapter II {style="opener" vignette="wig"} المورد wig: فتتشارك الفصول النمط بدلًا من نسخة منه لكل صورة. يقرأ رأس الصفحة أو التذييل سمات فصل الصفحة، كما يفعل {attr.<key>} في الترويسة، وتعمل العناصر النائبة الأخرى أيضًا ('map-{chapterNumber}'). والمعرّف الذي يخرج فارغًا، كما في عنوان بلا السمة، لا يرسم شيئًا. متاح منذ postext 1.8.

يُضمّن مُخرِج PDF المورد كما يُضمّن الشكل (ويستخدم SVG الذي له نسخة طباعة رئيسية تلك النسخة)؛ ويحسمه عارض HTML عبر resourceImageUrl.

الصورة التي يرسمها تصميم تُعدّ محتوى حين يصفها موردها: يدخل altText المورد، وإلا فتعليقه نصًّا عاديًا (الشارة تُقرأ بتسميتها، و:ref بنصه text إن كان له)، إلى VDT (VDTDesignImageBlock.altText)، ويصير alt لعنصر <img> الخاص بها في HTML، وFigure مع /Alt في PDF موسوم، ويُقرأ مباشرةً بعد نص تصميمها (لوحة الفصل بعد عنوان الفصل). أما الصورة التي ليس لموردها أيٌّ منهما، والصورة المعلَّمة decorative، فزخرفة: alt="" مع role="presentation"، وعنصر زخرفي (artifact) في PDF. وصورة الترويسة أو التذييل تتكرر في كل صفحة، فهي من أثاث الصفحة أيًّا كان ما يقوله موردها: لا altText في VDT، وalt="" مع role="presentation" في HTML، وعنصر زخرفي للصفحة في PDF.

#تموضع العناصر

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

interface ElementPlacement {
  /** What this element anchors to and which edge of that target. */
  anchor: {
    to: 'container' | 'page' | 'bleed' | 'outer' | `#${string}`; // container = the slot; page = trim box; bleed = trim box + bleed; outer = the outer margin (header, footer); #id = another element
    edge: AnchorEdge;
  };
  /** Distance from the anchor point. */
  offset?: { x?: Dimension; y?: Dimension };
  /** Optional fixed width / height. Width also accepts 'fill' (span the slot).
   *  `maxWidth` caps an 'auto' width (text): the element still shrink-wraps its
   *  content, so elements anchored to it stay attached, but a long text wraps or
   *  ellipsizes there — a running head can reserve room for the label hanging
   *  off it instead of squeezing that label out. */
  size?: { width?: Dimension | 'fill' | 'auto'; height?: Dimension | 'fill' | 'auto'; maxWidth?: Dimension };
}

يقبل AnchorEdge:

• حواف الحاوية (حين يكون anchor.to بقيمة 'container' أو 'page' أو 'bleed'): top، top-left، top-right، bottom، bottom-left، bottom-right، left، right.
• الحواف النسبية إلى عنصر (حين يكون anchor.to === '#someId'): right-of، left-of، below، above، align-top، align-bottom، align-left، align-right.

تضع كل حافة نسبية زاويةً من زوايا العنصر على زاوية من زوايا العنصر الذي يُثبَّت إليه، ثم يحرّكه offset من هناك:

• right-of: زاويته العليا اليسرى على الزاوية العليا اليمنى للهدف (بجواره، وأعلاهما في مستوى واحد)؛ left-of: زاويته العليا اليمنى على الزاوية العليا اليسرى للهدف؛
• below: زاويته العليا اليسرى على الزاوية السفلى اليسرى للهدف (تحته، وحافتاهما اليسريان في مستوى واحد)؛ above: زاويته السفلى اليسرى على الزاوية العليا اليسرى للهدف؛
• align-top وalign-left: زاويته العليا اليسرى على الزاوية العليا اليسرى للهدف. يعطي الاسمان التموضع نفسه: تصطف الحافتان العليا واليسرى كلتاهما؛
• align-bottom: زاويته السفلى اليسرى على الزاوية السفلى اليسرى للهدف؛
• align-right: زاويته العليا اليمنى على الزاوية العليا اليمنى للهدف.

الحافة النسبية إلى عنصر المستخدمة مع 'container' أو 'page' أو 'bleed'، وحافة الحاوية المستخدمة مع '#id'، تُقرآن على أنهما الزاوية العليا اليسرى.

يثبّت anchor.to: 'page' العنصر إلى صندوق القص (الصفحة المادية بعد القص)، ويثبّته 'bleed' إلى صندوق القص موسّعًا بمقدار cutLines.bleed من كل جانب (وهو مطابق لصندوق القص ما دامت خطوط القص معطّلة). ويصير الإطاران أيضًا المرجع لـsize: 'fill' وللتقييد التلقائي للعرض، فيمكن أن يمتد شريط ملوّن من حافة إلى حافة بصرف النظر عن هوامش الصفحة:

{ "kind": "box", "id": "band", "placement": { "anchor": { "to": "bleed", "edge": "top-left" }, "size": { "width": "fill", "height": { "value": 6, "unit": "cm" } } }, "style": { "backgroundColor": { "hex": "#1d3557", "model": "hex" } } }

مع تفعيل خطوط القص، يُقص كل ما يرسمه عنصر خارج صندوق النزف (انظر خطوط القص).

يثبّت anchor.to: 'outer' (في خانتي رأس الصفحة والتذييل) العنصر إلى الهامش الخارجي للصفحة: من حافة منطقة النص إلى حدّ القص في الجهة البعيدة عن الكعب، ومن رأس منطقة النص إلى أسفلها. ويقع على يمين الصفحة الفردية ويسار الزوجية في كتاب مجلّد من اليسار، والعكس في كتاب مجلّد من اليمين (page.binding)، فيخدم عنصر واحد الصفحتين المتقابلتين كلتيهما: ترويسة تنزل على الحافة الأمامية (انظر عناصر النص العمودي). وفي أي خانة أخرى يُقرأ على أنه 'container'. ويمكن أن يُكتب offset لعنصر نص بوحدة em، أي بوحدات em من fontSize الخاص به: أربعة محارف تحت رأس منطقة النص هي { "y": { "value": 4, "unit": "em" } }.

داخل خانة التصميم المتقدم لعنوان، لا تزيد العناصر المثبّتة إلى الصفحة أو النزف الارتفاعَ المحجوز للعنوان إلا إذا امتدت تحت الحافة العليا للعنوان (الشريط الممتد عبر أعلى الصفحة يقع خلف صفحة الافتتاح؛ والشريط الذي يبلغ ما تحت العنوان يدفع نص المتن إلى الأسفل). استخدم advancedDesign.minHeight لحجز ارتفاع ثابت لصفحة الافتتاح في كل الأحوال، وreserve: false في العنصر الذي لا ينبغي أن يدفع النص أبدًا. القواعد الكاملة تحت الارتفاع المحجوز.

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

يُحلَّل الشكل القديم align + marginFromBody + marginFromEdge عند الإدخال ويُعاد كتابته تموضعًا وقت حسم الإعدادات، فتظل الإعدادات القائمة تعمل دون تغيير.

#نص المتن

تتحكم الخاصية bodyText في طباعة نص الفقرات كله.

#الاقتباسات الكتلية

يأخذ الاقتباس الكتلي (الأسطر التي تبدأ بـ >) عائلة خط المتن وحجمه وتباعد أسطره وأوزانه ومحاذاته وتقسيمه بالواصلة. ويضبط bodyText.blockquote الباقي؛ وإن لم يُضبط، يبدو الاقتباس الكتلي كما كان حتى postext 1.4: رماديًا مائلًا، بالمسافة البادئة للسطر الأول في المتن وبلا إزاحة جانبية.

bodyText: {
  firstLineIndent: { value: 1.5, unit: 'em' },
  // Upright verse in the body colour, set in by 2 em, no first-line indent.
  blockquote: { color: { hex: '#241f26', model: 'hex' }, italic: false, indent: { value: 2, unit: 'em' }, firstLineIndent: { value: 0, unit: 'em' } },
}

في Sandbox، هذه هي مجموعة الاقتباسات الكتلية في قسم نص المتن.

#عائلة واحدة لكل fontFamily

fontFamily — هنا وفي كل حقل آخر لعائلة الخط (headings.fontFamily، وtableStyle.bodyFontFamily، وseparatorFontFamily، وfontFamily لنمط شارة أو لعنصر تصميم…) — يسمّي عائلة واحدة. فمخرجات Canvas وHTML وPDF يجب أن تنضّد الوجه نفسه، وPDF يضمّن خطًا واحدًا لكل عائلة بلا سلسلة بدائل، فلا يوجد ما ترجع إليه سلسلة خطوط CSS. السلسلة تُنضَّد بعائلتها الأولى ويُبلَّغ عنها تحذيرَ إعدادات:

bodyText: { fontFamily: "'EB Garamond', Georgia, serif" } // set in EB Garamond

حمّل تلك العائلة قبل الإخراج (انظر الخطوط المخصّصة ومزوّد الخطوط في إنتاج ملفات PDF)؛ وإن كانت غائبة، يقيس المتصفح بخطه الافتراضي، أيًّا كان ما تقوله بقية السلسلة. الفاصلة داخل علامات التنصيص جزء من الاسم ('"Foo, Bar"' عائلة واحدة).

#تقسيم الكلمات بالواصلة

حين تُضبط محاذاة النص على 'justify'، يمنع التقسيم بالواصلة الإفراط في تباعد الكلمات بكسر الكلمات الطويلة عند حدود المقاطع. يستخدم المحرّك أنماط TeX/Liang لإيجاد نقاط الكسر الطبيعية عند حدود المقاطع. انظر تقسيم الكلمات وضبط الأسطر لشرح مفصّل. ولا يُقسَّم النص غير المضبوط إلا إذا طلبت ذلك: انظر النص غير المضبوط أدناه.

اللغات المدعومة: 'en-us' (الإنجليزية)، 'es' (الإسبانية)، 'fr' (الفرنسية)، 'de' (الألمانية)، 'it' (الإيطالية)، 'pt' (البرتغالية)، 'ca' (الكتالونية)، 'nl' (الهولندية).

تُتجاهَل الوسوم الفرعية للمنطقة ونظام الكتابة والمتغيّر عند اختيار الأنماط، وكذلك حالة الأحرف والفاصل _: فـ 'es-ES' و'es-MX' و'es_419' تُقسَّم بأنماط 'es'، و'pt-BR' بأنماط 'pt'، وكل وسم إنجليزي ('en'، 'en-GB') بأنماط 'en-us' — وهي الأنماط الإنجليزية الوحيدة المضمَّنة، فينال النص البريطاني نقاط كسر أمريكية. واللغة التي لا أنماط مضمَّنة لها ('sv'، 'pl'، 'fi'…) تُقسَّم بأنماط 'en-us'، وهذا يعطي نقاط كسر خاطئة لا انعدامها؛ ويبلّغ المحرّك عن ذلك مرة واحدة لكل وسم عبر console.warn، ويُدرجه Sandbox في لوحة «الفحوص». اضبط enabled: false لمثل هذا المستند؛ فذلك يُسكت التحذير أيضًا. أما الصينية واليابانية والكورية (zh، ja، ko، أيًّا كانت المنطقة أو نظام الكتابة) فلا تحتاج إلى أنماط ولا تطبع تحذيرًا: المستند المكتوب بإحداها يُنضَّد بلا تقسيم بالواصلة. ولتقسيم الكلمات اللاتينية المقتبسة فيه، اضبط enabled: true وسمِّ لغتها في locale ('en-us' للإنجليزية). أما enabled: true بلا locale، أو مع لغة صينية أو يابانية أو كورية، فيترك التقسيم معطّلًا ويقول ذلك مرة واحدة في وحدة التحكم (console). تعيد matchHyphenationLocale(tag) اللغة المضمَّنة التي يُطابقها الوسم (undefined حين لا توجد)، وتُدرج HYPHENATION_LOCALES اللغات المضمَّنة. وتسمّي الإعدادات المحلولة (doc.config.bodyText.hyphenation) الأنماط المستخدمة فعلًا في locale، وتحتفظ بالوسم الذي أعطيته في tag حين يختلف. ويعلن مُخرِج PDF لغة المستند من locale في المستوى الأعلى، ومن هذا الوسم فقط حين لا يكون locale مضبوطًا (انظر لغة المستند).

import { matchHyphenationLocale } from 'postext';
 
matchHyphenationLocale('es-MX'); // 'es'
matchHyphenationLocale('en-GB'); // 'en-us'
matchHyphenationLocale('sv');    // undefined: hyphenated with 'en-us', with a console warning

لا تُقسَّم أبدًا الكلمات الأقصر من 5 أحرف. ويشترط المحرّك حرفين على الأقل قبل نقطة الكسر و3 أحرف بعدها.

النص غير المضبوط

افتراضيًا لا يُقسَّم بالواصلة إلا النص المضبوط: مع textAlign: 'left'، وفي أنماط الفقرات المحاذاة إلى اليسار أو الوسط أو اليمين، تبقى كل كلمة كاملة مهما ازدادت الحافة تعرّجًا، إلا عند واصلة اختيارية (U+00AD) مكتوبة في النص. اضبط hyphenation.ragged: true لتقسيم النص غير المضبوط أيضًا.

لا يُمدَّد السطر غير المضبوط أبدًا، فتقسيم كل كلمة لا يتّسع لها السطر سيملأ الحافة بالواصلات. وتحدّ من ذلك منطقة التقسيم بالواصلة، كما يفعل مُنضِّد السطر الواحد في برامج النشر المكتبي. حين لا تتّسع كلمة في آخر السطر، ينظر المحرّك إلى الفراغ الذي سيتركه إرسالها كاملة إلى السطر التالي. فإن كان ذلك الفراغ أعرض من zone، تُقسَّم الكلمة عند آخر مقطع يتّسع؛ وإلا نزلت كاملة. المنطقة المقيسة بـ em نسبية إلى حجم خط النص نفسه. القيمة الافتراضية 3em لا تقسّم إلا الكلمات التي ستترك سطرًا قصيرًا على نحو ملحوظ. والمنطقة الأعرض تعطي واصلات أقل وحافة أكثر تعرّجًا؛ والقيمة 0 تقسّم كل كلمة لا تتّسع. وفي التنضيد سطرًا سطرًا، لا ينتهي أكثر من سطرين متتاليين بمقطع. أما الواصلات الصلبة (enseñanza-aprendizaje) ومفاصل عناوين URL والواصلات الاختيارية المكتوبة في النص والكلمات الأعرض من السطر كله فتنكسر كما تفعل دائمًا: المنطقة وحدّ السطرين لا يحكمان إلا مقاطع القاموس.

الإعداد على مستوى المستند كله. ينطبق على نص المتن والاقتباسات الكتلية حين تكون غير مضبوطة، وعلى كل نمط فقرة غير مضبوط ومتن إطار يكون hyphenation الخاص به مفعّلًا (وقيمته الافتراضية هي hyphenation.enabled الخاصة بالمتن)، فالقيمة hyphenation: false تُبقي كلمات نمطٍ واحد كاملة. لا تُقسَّم العناوين وتعليقات الأشكال والملاحظات وخلايا الجداول وجدول المحتويات؛ وهناك، كما في كل موضع، لا تُقسَّم إلا الكلمة الأعرض من عرض السطر كله. أما نص التصميم — الترويسات وصفحات الافتتاح وصفحات الأجزاء — فيتبع علامة hyphenate الخاصة بكل عنصر نصي، التي تضبطها صفحات الافتتاح الكاملة وصفحات الأجزاء المضمَّنة، ويستخدم قاموس المستند أيضًا. ويتجاهل النص المضبوط ragged وzone.

const config: PostextConfig = {
  locale: 'es',
  bodyText: {
    textAlign: 'left',
    // A little more hyphenation than the 3 em default.
    hyphenation: { ragged: true, zone: { value: 2, unit: 'em' } },
  },
};

مع optimalRagged (القيمة الافتراضية) يُكسر النص الجاري غير المضبوط بخوارزمية Knuth-Plass، وتحتفظ المنطقة بمعناها هناك: لا تُقسَّم الكلمة إلا حين لا يتّسع لها باقي السطر ويترك إنزالها كاملة أكثر من المنطقة فارغًا. ولا يُرفض مقطعان متتاليان، لكنهما يكلّفان ما تكلّفه واصلتان متتاليتان في النص المضبوط، فيندر الثالث. ومع optimalRagged: false، أو optimalLineBreaking: false، يُملأ كل سطر قبل الذي يليه، كما حتى postext 1.4.

يُخرج التقسيمُ بالواصلة للنص غير المضبوط الفقراتِ بكاسر الأسطر الذي تستخدمه دائمًا الفقرات ذات التنسيق المضمَّن (العريض والمائل والروابط والرياضيات)، فتفعيله قد يحرّك بضع نقاط كسر غير الواصلات. في السطر غير المضبوط، وإلى جانب المسافات ومقاطع القاموس، يكسر ذلك الكاسر بعد واصلة صلبة أو شرطة بين كلمتين (largas—separadas؛ ومع breakAfterDashes، بعد أي شرطة منضَّدة ملتصقة بين كلمتين، وriddles.—I وriddles—*and* أيضًا)، وعند مفاصل عناوين URL وبين الرموز الإيديوغرافية، ويُبقي معًا الكلمة المنضَّدة في عدة مقاطع (**Nota**:، (*véase*). ومن دون التقسيم بالواصلة للنص غير المضبوط، تكسر Knuth-Plass الفقرة غير المضبوطة الخالية من التنسيق حين يكون optimalRagged مفعّلًا (القيمة الافتراضية): عند المسافات بين الكلمات، وبعد واصلة صلبة بين حرفين (meta- · analyses)، كما يفعل الكاسر الآخر، ومع breakAfterDashes، بعد الشرطات الملتصقة. وفي التنضيد سطرًا سطرًا، تمرّ الفقرة عبر كاسر pretext، الذي يختلف في ثلاثة أمور: قد يكسر أيضًا قبل شرطة تُغلق جملة اعتراضية أو بعد شرطة تفتحها (él · — y)، وبعد الشرطة المائلة عند التقسيم بالواصلة (km/ · h)، ويقطع الكلمة الأعرض من السطر عند أي حرف بلا واصلة، حيث يقسّمها الكاسر الآخر عند مقطع أولًا.

في Sandbox، المفتاح هو قسّم النص غير المضبوط بالواصلة، تحت محاذاة الفقرة في قسم نص المتن، والمنطقة تحته. وتحت متنٍ مضبوط يقع المفتاح نفسه مع إعدادات ضبط الأسطر، لأنماط الفقرات والأطر غير المضبوطة.

#لغة المستند

locale في المستوى الأعلى هو لغة المستند ككل. يأخذ القيم نفسها التي يأخذها hyphenation.locale، وهو البديل حين لا يكون ذلك الحقل مضبوطًا، فلا يحتاج كتاب إسباني إلا إلى locale: 'es' ليُقسَّم بالواصلة بالإسبانية. ويختار أيضًا لغة عبارات الاستمرار المضمَّنة في الجداول والأطر المقسومة ((cont.) / Continued مقابل Continúa، انظر الجداول الأطول من الصفحة والعلامات على الإطار المقسوم) ولغة أرقام العناوين المكتوبة بالحروف (Chapter One مقابل Capítulo uno، انظر الأرقام المكتوبة بالحروف)، وهو اللغة التي يُوسَم بها ملف PDF الميسَّر الوصول. إن لم يُضبط، يفترض المحرّك 'en-us'؛ ويرجع Sandbox إلى لغة الواجهة ويضبط الحقل تحت التصميم › نظام الكتابة.

ويختار أنواع الموارد المضمَّنة أيضًا. حين لا يكون resourceTypes مضبوطًا، يرقّم buildDocument ويكتب التعليقات باستخدام defaultResourceTypes(locale)، فيعطي locale: 'de' وحده Abbildung 1.1 وTabelle 1.1. وحين لا يكون locale مضبوطًا، تحلّ محلّه لغة التقسيم بالواصلة، لأنواع الموارد ولعبارات الجداول على السواء. وقائمة resourceTypes الصريحة تغلب دائمًا. كانت الإصدارات السابقة تستخدم الأنواع الإنجليزية أيًّا كان locale ما لم تمرّر defaultResourceTypes(locale) بنفسك؛ والمستند الذي يضبط locale ويريد الاحتفاظ بالتسميات الإنجليزية يمرّر resourceTypes: defaultResourceTypes('en'). كتب Sandbox والحزم تحمل قائمتها الخاصة، فلا تتأثر.

أي وسم BCP 47 يصلح هنا كما في hyphenation.locale: فـ 'de-AT' ينال العبارات الألمانية. العبارات المضمَّنة موجودة باللغات الثماني التي يدعمها التقسيم بالواصلة وبالصينية، بالحروف المبسّطة والتقليدية؛ وأي لغة أخرى تنال العبارات الإنجليزية.

تقبل الصينية zh وzh-Hans وzh-Hant وzh-CN وzh-SG وzh-TW وzh-HK وzh-MO والصيغ الطويلة (zh-Hant-TW)، بأي حالة أحرف ومع - أو _. تتبع العبارات نظامَ الكتابة، مقروءًا بـ Intl.Locale(tag).maximize(): zh وzh-CN وzh-SG مبسّطة، وzh-TW وzh-HK وzh-MO تقليدية. أما الإعدادات الطباعية الافتراضية التي تعتمد على اللغة فتتبع المنطقة بدلًا من ذلك، كما يوصي clreq §1.2: تُعدّ CN و SG و MY البرَّ الرئيسي، و TW تايوان، و HK و MO هونغ كونغ، والوسم الذي لا منطقة فيه يُؤخذ بنظام كتابته (zh-Hant تايوان، وzh وzh-Hans البر الرئيسي). تعطي localeScript(tag) وcjkRegionOf(tag) وstringsKeyOf(tag) وsameContentLocale(a, b) هذه القراءات، وتُدرج DOCUMENT_LANGUAGES اللغات ذات العبارات المضمَّنة، كلٌّ منها باسمها في لغتها، كما تعرضها قائمة «لغة المستند» في Sandbox.

بادئة التعليق هي اسم النوع (Figure 1.1.). ترقّم الأنواع الصينية داخل الفصل بواصلة، {h1}-{n} (图 1-1)؛ ومع إعدادَي التعليق labelNumberGap: '' وlabelSeparator: '　' يصبح التعليق 图1-1　标题 (انظر نمط التعليق). ويتبع الفهرس الأبجدي في آخر الكتاب اللغةَ أيضًا: 见 و另见 قبل الإحالة، و符号 و数字 فوق الرموز والأرقام في المبسّطة؛ و見 و另見 و符號 و數字 في التقليدية. وترقّم العربية أنواعها بالطريقة نفسها، {h1}-{n} (شكل 2-3)، وتكتب الإحالات على هيئة «الفصل 3» و«القسم 2-1» و«ص 12»، وتعنون قائمة المراجع بـ «المراجع»، ويطبع فهرسها «انظر» / «انظر أيضًا» و«رموز» و«أرقام»، بالفاصلة والفاصلة المنقوطة العربيتين (، ؛).

يعلن المستند الصيني أو الياباني أو الكوري لغته في مخرجات HTML (lang على الجذر .pt-doc، مع الإبقاء على zh-Hant-TW كاملًا) وعلى اللوحة التي يرسمها (ctx.lang، في Chrome 136 وما بعده)، فيرسم المتصفح أشكال الحروف الخاصة بالمنطقة: يوحّد Unicode محارف الهان، ونقطة الترميز الواحدة تبدو مختلفة في خط تايواني وفي خط ياباني. ولا تحمل المستندات الأخرى lang، كما كان من قبل. ويعلن ملف PDF القيمة /Lang من locale لكل مستند، موسومًا كان أو غير موسوم، مع نظام كتابته ومنطقته. والمستند المكتوب بلغة تُكتب من اليمين إلى اليسار (العربية والفارسية والأردية والعبرية…) يعلن لغته أيضًا: أشكال الحروف الخاصة باللغة في الخط (locl) والخط البديل يتبعانها.

const config: PostextConfig = {
  locale: 'es',
  bodyText: { textAlign: 'justify', hyphenation: { enabled: true } }, // hyphenates in Spanish
};

أرقام المستند

يضبط numerals في المستوى الأعلى أرقامَ كل عدد يكتبه المحرّك: أرقام الصفحات وتسميات الصفحات في جدول المحتويات والفهرس الأبجدي والإحالات إلى الصفحات؛ وأرقام القوائم المرقّمة والحواشي السفلية؛ وعدّادات العناوين والفصول، و{chapterNumber}؛ و{h1} و{n} في رقم الشكل وفي الإحالة إليه؛ و{totalPages} و{bookTotalPages} و{numberDecimal}. القيمة 'latn' تكتب 0–9، و'arab' الأرقام الهندية العربية ٠–٩، و'arabext' الأرقام الفارسية ۰–۹. لا يتغيّر إلا التنسيق العشري — decimal، أو arabic في القوائم، أو إعداد متروك على قيمته الافتراضية — فالتنسيق الذي يسمّيه المؤلف يُطبع كما سُمّي: lower-roman يبقى i, ii, iii، وarabic-indic في مستند لاتيني يظل يكتب ١, ٢, ٣. ولا يُعاد أبدًا كتابة نص المستند.

القيمة الافتراضية، 'auto'، تأخذ أرقام locale (defaultNumeralsFor(tag)): 'arab' للعربية بلا منطقة أو مع أي منطقة خارج المغرب العربي (ar، ar-EG، ar-SA، ar-AE…)، و'latn' لـ ar-MA وar-DZ وar-TN وar-LY وar-MR وar-EH، و'arabext' للفارسية (fa) والبشتوية (ps) وأردية الهند (ur-IN)، و'latn' لكل ما سوى ذلك، ومنه أردية باكستان. تعطي CLDR القيمة latn للوسم ar المجرّد وللوسم ar-AE؛ لكن الكتب العربية في المشرق والخليج تطبع ٠–٩، وهذا ما يتبعه Postext. والوسم الذي يسمّي أرقامه يحتفظ بها: ar-MA-u-nu-arab. والصفحة المرقّمة بأرقام المستند تسجّل arabic-indic أو persian في pageNumberFormat الخاص بها، فتعرض تسميات صفحات PDF الأرقام نفسها. والقيمة غير المعروفة تتبع اللغة ويُبلَّغ عنها بـ unknownNumerals.

الأعداد التي يكتبها المؤلف تُقرأ بأي من الأنظمة الثلاثة: بند القائمة ٣. يبدأ من 3، و{startAt=٥} و:::numbering{startAt=٥} و:::space{lines=٢} و:::part{number="٣"} (من أجل {numberDecimal}) تقرأ القيمة.

const config: PostextConfig = { locale: 'ar' };                     // ١، ٢، ٣
const maghreb: PostextConfig = { locale: 'ar-MA' };                 // 1, 2, 3
const forced: PostextConfig = { locale: 'ar', numerals: 'latn' };   // 1, 2, 3

اتجاه النص

يضبط direction في المستوى الأعلى الاتجاه الأساسي للمستند: 'ltr' أو 'rtl' أو 'auto' (القيمة الافتراضية)، وهي 'rtl' حين يكون نظام الكتابة في locale مكتوبًا من اليمين إلى اليسار (العربية والفارسية والأردية والعبرية والسريانية والثانا وإنكو وأدلام…، ويقرؤه directionOf(tag))، و'ltr' في غير ذلك. يُخرَج المستند المكتوب من اليمين إلى اليسار في إطار معكوس: تبدأ أسطره من اليمين، وعموده الأول هو الأيمن، وتقف مسافاته البادئة وعلامات قوائمه وعناصره العائمة وحواشيه السفلية وأطره على اليمين، وpage.binding: 'auto' يجلّده من اليمين. ولا تحمل الإعدادات المحلولة direction: 'rtl' إلا لمثل هذا المستند، فيُحَلّ المستند المكتوب من اليسار إلى اليمين كما كان من قبل. والقيمة غير المعروفة تُقرأ 'auto' ويُبلَّغ عنها بـ unknownConfigValue. وترتّب خوارزمية Unicode ثنائية الاتجاه (UAX #9) مقاطع كل سطر في أي من الاتجاهين: فالاقتباس العربي في كتاب إنجليزي يُقرأ من اليمين إلى اليسار في موضعه.

داخل المستند، يأخذ العنوان أو الحاوية ::: القيمة {dir=ltr} أو {dir=rtl}، ويعزل :ltr[…] و:rtl[…] المضمَّنان مقطعًا من النص (انظر اتجاه النص في الترميز)؛ ويأخذ مورد الجدول table.direction. والكتلة المضبوطة بعكس اتجاه المستند تحتفظ بجانب بدايتها الخاص: تنتقل مسافتها البادئة وعلامات قوائمها والطرف المحاذى لسطرها الأخير إلى الجانب الذي يبدأ منه نصها.

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

يحتفظ placement.rotate بمعناه المادي في الصفحة المعكوسة: الشكل المُدار باتجاه عقارب الساعة يُدار باتجاه عقارب الساعة على الورقة. والمضيف الذي يقرأ الإخراج يجد الإطار المعكوس في كل صفحة (VDTPage.flow مع direction: 'rtl'، وpageIsMirrored(page)) والترتيب البصري لمقاطع كل سطر في VDTLine.order؛ وتحوّل flowToPage وpageToFlow بين التدفّق والورقة. انظر الإخراج العربي.

const arabic: PostextConfig = { locale: 'ar' };                        // right to left, bound on the right
const english: PostextConfig = { locale: 'en', direction: 'rtl' };     // forced; rarely what you want

#اللغات وأنظمة الكتابة

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

• الصينية يُنضّدها مُنضِّد CJK حين تحوي الفقرة محارف CJK أكثر من المسافات بين الكلمات: تنكسر أسطرها بين المحارف وفق قواعد بداية السطر ونهايته في cjk.lineBreak (لا سطر يبدأ بـ 。、」 أو ー، ولا سطر ينتهي بـ 「 أو （)، وتُبقي —— و…… والعدد مع علاماته والكلمة اللاتينية كاملةً، والسطر المضبوط تُوزَّع مسافاته بين محارفه حتى يبلغ عرض السطر. وتتبع عروضُ علامات الترقيم، وعلامات الترقيم المعلّقة، والمسافة بين الهان واللاتينية، وشبكة المحارف، ونقاط التوكيد، وعلامات أسماء الأعلام وعناوين الكتب، وحواشي الروبي (ruby) والواريتشو (warichu) منطقةَ locale، أفقيًا أو عموديًا (layout.writingMode: 'vertical-rl'). والفقرة اللاتينية التي تقتبس بضع كلمات CJK تحتفظ بكسر الأسطر الأمثل وقد تنكسر بجوارها؛ أما قوس CJK أو النقطة الوسطى أو العلامة كاملة العرض المقتبسة في نص لاتيني (〈h〉، ％) فلا تغيّر شيئًا.
• اليابانية والكورية تمرّان عبر المُنضِّد نفسه وتُنضَّدان بلا تقسيم بالواصلة، لكن بالإعدادات الافتراضية لصينية البر الرئيسي: قواعدهما الخاصة (JLREQ و KLREQ) غير مطبّقة. والنص الكوري ينكسر بين المقاطع كما ينكسر عند مسافاته.
• العربية وأنظمة الكتابة الأخرى من اليمين إلى اليسار (الفارسية والأردية والعبرية…) تُنضَّد من اليمين إلى اليسار: يشرح الإخراج العربي الكيفية. يأتي direction الخاص بالمستند من نظام الكتابة في locale، وترتّب خوارزمية Unicode ثنائية الاتجاه الكلماتِ اللاتينية والأعداد داخل كل سطر، ويُجلَّد الكتاب من اليمين وعموده الأول هو الأيمن، وكل عدد يكتبه المحرّك يأخذ أرقام المنطقة. والكلمة التي تحوي حرفًا من الحرف العربي لا تُقسَّم بالواصلة ولا تُباعَد حروفها ولا تُقطع أبدًا، والسطر العربي المضبوط يُمدَّد عند مسافاته وبالكشيدات. علامات التشكيل والتوكيد والحواشي السفلية وعبارات العربية مشروحة تحت النص العربي. وتنال الفارسية والأردية والعبرية الاتجاه والأرقام وقواعد الكلمة الكاملة، لكن بلا عبارات مضمَّنة خاصة بها.

تُشحن أنماط التقسيم بالواصلة لثماني لغات (en-us، es، fr، de، it، pt، ca، nl)؛ وأنواع الموارد وعبارات الاستمرار المضمَّنة موجودة بهذه الثماني وبالصينية والعربية. تُنضَّد الصينية واليابانية والكورية واللغات المكتوبة من اليمين إلى اليسار بلا تقسيم بالواصلة. وأي لغة أخرى تُقسَّم بأنماط الإنجليزية الأمريكية، مع تحذير في وحدة التحكم، وتنال العبارات الإنجليزية. لمثل هذا المستند، اضبط hyphenation.enabled: false ومرّر resourceTypes وعبارات الاستمرار في tableStyle بلغته.

#النص العربي

تخدم هذه الإعدادات النص المكتوب بالحرف العربي؛ ولا يغيّر أيٌّ منها مستندًا مكتوبًا بنظام كتابة آخر. يشرحها الإخراج العربي مع سائر ما في الكتاب العربي: الاتجاه والتجليد والأرقام والشعر وجدول المحتويات والفهرس.

• علامات التشكيل وتباعد الأسطر. علامات التشكيل في النص المشكول (الفتحة والكسرة والشدة والتنوين والألف الخنجرية والعلامات القرآنية) تتراكب فوق الحروف وتحتها، داخل تباعد الأسطر، الذي لا يزداد من أجلها أبدًا. كل سطر يحوي علامات يسجّل مدى وصول حبرها (VDTLine.markInk)، ويشمل قصّ العمود في المُخرِجات علاماتِ السطرين الأول والأخير من العمود. وحين تلتقي علامة فوق كلمة بالحروف أو العلامات المتدلّية تحت الكلمة التي فوقها، يبلّغ البناء عن الفقرة (arabicMarksExceedLeading، في لوحة «الفحوص» في Sandbox). ولا تُقارَن إلا الكلمات الواقعة بعضها فوق بعض. يحتاج النص المشكول جزئيًا إلى نحو 1.7–1.85 em من lineHeight، والشعر المشكول كاملًا إلى 1.9–2.1 em.
• التوكيد. لا مائل في الحرف العربي، ففي المستند الذي تُكتب لغته locale بالحرف العربي يُنضَّد *…* بالعريض افتراضيًا (bodyText.emphasis: 'auto'). القيمة 'color' تنضّده قائمًا بلون italicColor، و'overline' ترسم خطًا فوق الكلمات، وهو الخط الفوقي في الكتب العربية. يصل الإعداد إلى كل نص منضَّد بوجوه خط المتن: الفقرات والقوائم والاقتباسات الكتلية وأنماط الفقرات ومتون الأطر والملاحظات والعناوين. أما تعليقات الأشكال وخلايا الجداول وجدول المحتويات والفهرس فتحتفظ بإعدادات المائل الخاصة بها. ومهما كان الاختيار، لا يُميل المحرّك الحروف العربية أبدًا: الكلمات العربية في مقطع منضَّد بالمائل تقف قائمة، وكلماته اللاتينية تحتفظ بميلها. والاقتباس الكتلي قائم افتراضيًا في مثل هذا المستند.
• التشكيل. bodyText.tashkil: 'strip' يحذف علامات التشكيل والعلامات القرآنية من النص الذي ينضّده الإخراج، لإصدار غير مشكول يُصنع من مصدر مشكول: الفتحة والضمة والكسرة وتنوينها، والسكون، والشدة، والألف الخنجرية (هٰذا تصبح هذا) والعلامات U+0656–U+065F و U+06D6–U+06ED. والقيمة 'strip-vowels' تُبقي الشدة، كما تطبعها معظم الكتب الحديثة. وتبقى الهمزة والمدّة (أ إ آ حروف، حتى حين تُكتب بعلامات مركّبة). يحتفظ المصدر بعلاماته؛ وتُنضَّد الأسطر والعناوين وجدول المحتويات بدونها، ويظل كل محرف منضَّد مرتبطًا بموضعه في المصدر.
• الحواشي السفلية. footnotes.markerTemplate: '({n})' يكتب العلامات «(١)» بأرقام المستند، وnumbering: 'page' يعيد ترقيمها في كل صفحة، وnoteNumberPosition: 'inline' ينضّد رقم الحاشية نفسها على السطر. ويقف خط الفصل وأرقام الحواشي في بداية العمود، على اليمين في الكتاب المكتوب من اليمين إلى اليسار.
• الكلمات الكاملة. الكلمة التي تحوي حرفًا من الحرف العربي لا تُقسَّم بالواصلة ولا تُقطع ولا تُباعَد حروفها أبدًا، في كتاب عربي أو مقتبسةً في كتاب آخر. والنمط الذي يضبط letterSpacing على نص عربي يُبلَّغ عنه (joiningScriptLetterSpacing)، والكلمة الأعرض من سطرها تفيض عنه ويُبلَّغ عنها (unbreakableWordOverflow). انظر الإخراج العربي.
• الكشيدة والشعر. يُمدَّد السطر العربي المضبوط بالكشيدات كما يُمدَّد عند مسافاته (bodyText.kashida، انظر الكشيدة في النص العربي)، وتُنضَّد القصيدة العمودية بيتًا في كل سطر، في شطرين متساويين في العرض، مع :::verse (انظر :::verse).
• الفهرس. الفهرس بالعربية يُرتَّب ترتيبًا ألفبائيًا ويتجاهل أداة التعريف «ال» (index.ignoreArticle) وعلامات التشكيل وكراسي الهمزة؛ انظر الفهرس الأبجدي في آخر الكتاب.

#الأسطر اليتيمة والأرامل والكلمات المعزولة وقواعد الإبقاء معًا

انظر تقسيم الكلمات وضبط الأسطر لآلية نقاط الجزاء هذه. وهذا القسم هو المرجع لمفاتيح bodyText التي تتحكم فيها.

وإلى جانب حدود التقسيم بالواصلة والتباعد، تتيح إعدادات نص المتن القواعدَ المرنة التي تمنع الانكسارات المحرجة بنيويًا في الفقرات. وكلها تُغذّى في خوارزمية Knuth-Plass لكسر الأسطر على هيئة نقاط جزاء (demerits) — تميل بالإخراج نحو الانكسارات النظيفة دون أن تفرض قاعدة صارمة أبدًا. اضبط قيم *Penalty على 0 لتعطيل أيٍّ منها فعليًا.

عن الكلمات المعزولة. الكلمة المعزولة فقرةٌ سطرها الأخير أقصر من أن يبدو سطرًا حقيقيًا من النص — عادةً كلمة أو كلمتان قصيرتان منقطعتان في آخر الفقرة. ولأن الفحص يقوم على طول السطر بالبكسل نسبةً إلى عرض المسافة العادية، يتكيّف runtMinCharacters تلقائيًا مع حجم الخط الحالي. الكلمة القصيرة التي تكون بصريًا أعرض من runtMinCharacters × spaceWidth لا بأس بها؛ أما الكلمة الأضيق من ذلك (أو المنفردة فعلًا) فتستجلب جزاء الكلمة المعزولة. تحسب العتبة المسافات بين الكلمات، وعرضها نحو نصف عرض الحروف: فالقيمة الافتراضية 20 تعني سطرًا أخيرًا من نحو 8 إلى 12 حرفًا. كل كلمة معزولة تكلّف الجزاء كله، فبين نهايتين تحت العتبة يُبقي الكاسر الأسطر الأضيق في الأعلى؛ أما gradedRuntPenalty فيسعّر كلًّا منهما بمقدار قصورها، فتفوز النهاية الأطول. ولمن يهمّه الحساب: عند القيمة الافتراضية 1000 لـ runtPenalty، يغلب تجنّبُ الكلمة المعزولة أيَّ مجموعة نقاط كسر بديلة تتطلب تمدّدًا في تباعد الكلمات حتى نحو r≈2.15.

مرنة لا صارمة. لا تستطيع أيٌّ من هذه القواعد أن تمنع كسرًا — فالمحرّك سينتج إخراجًا دائمًا. إنها نقاط جزاء: تُوازن الخوارزمية بين الرداءة وكلفة التقسيم بالواصلة وسلاسة فئات الملاءمة وهذه الجزاءات البنيوية في عملية تحسين شاملة واحدة، وتختار مجموعة نقاط الكسر ذات الكلفة الإجمالية الأدنى. إن احتجت ضمانًا أشدّ، فارفع الجزاء؛ وإن كان مستند ما يُقرأ أفضل مع جزاء مخفّف، فاخفضه.

#العناوين

تتحكم الخاصية headings في طباعة كل مستويات العناوين (H1–H6). يمكنك ضبط قيم افتراضية عامة تسري على كل المستويات، ثم تجاوز خصائص بعينها لكل مستوى.

#القيم الافتراضية العامة

عناوين في الوسط لقصائد أو لفصول مسرحية، بلا خانة تصميم:

headings: {
  textAlign: 'center',
  levels: [{ level: 2, textTransform: 'uppercase' }],
}

تمرير كائن headings يحتفظ بكل قيمة افتراضية لمستوى لا تعيد ذكرها، بما في ذلك فاصل الصفحة قبل H1 (انظر تجاوزات كل مستوى).

#موازنة الأعمدة

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

1. إطار يختم العمود — الإطار الذي ينهي عمودًا قصيرًا يُدفع إلى الأسفل بمقدار المتسع الذي تحت قاعدته بالضبط، فتقع حافته السفلى على آخر خانة في شبكة الصفحة، بمحاذاة آخر سطر في العمود المجاور. ويأخذ ذلك المتسع حتى لو كان أقل من سطر، ما دام لا ينتقل شيء إلى عمود آخر. افتراضيًا يعمل قبل كل الأدوات الأخرى ويأخذ الفجوة كلها، فقد ينتهي الإطار الذي يعلّق على الفقرة التي فوقه على بعد عدة أسطر منها؛ والقيمة closingBox: 'last' تترك للعناوين ونهايات القوائم وأدوات المسافات الأخرى أن تأخذ الأسطر الكاملة أولًا، ولا يأخذ الإطار إلا ما تتركه، والقيمة closingBox: 'off' لا تحرّكه أبدًا.
2. العناوين — تُضاف أسطر كاملة من الشبكة إلى الهامش العلوي للعناوين داخل العمود القصير. وإذا احتيج إلى عدة أسطر وكان في العمود عدة عناوين، وُزّعت الأسطر عليها، مع إعطاء الحصة الكبرى دائمًا للعنوان الأهم (يتلقى h2 أكثر مما يتلقى h3). العناوين الواقعة في أعلى العمود تمامًا لا تتلقى مسافة إضافية أبدًا، فتظل الأعمدة تبدأ عند أعلى الصفحة — إلا العنوان الواقع مباشرة تحت شكل أو جدول يتصدّر عموده في صفحة يستمر تدفقها إلى التالية: هنا يذهب المتسع فوق ذلك العنوان، تحت الشكل.
3. نهايات القوائم — حين لا تستطيع العناوين استيعاب الفجوة كلها، يُضاف سطر من الشبكة حيث تنتهي قائمة أو تعداد (المسافة بعد القائمة تبدو طبيعية للقارئ)، مع حد أقصى لكل نهاية قائمة.
4. الفقرات المرخاة — في آخر المطاف، يُعاد تقسيم فقرة واحدة من العمود إلى أسطر بحيث تزيد سطرًا واحدًا (\looseness=+1 في TeX)، ويُختار أطول فقرة كي تتوزع المسافة الإضافية بين الكلمات دون أن تُلحظ. لا يُقبل الحل المرخى إلا إذا بقي كل سطر دون bodyText.maxWordSpacing — فلا تتجاوز كثافة الطباعة (type colour) الحد الذي ضبطته أصلًا. يتطلب bodyText.optimalLineBreaking.

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

أيّ أداة عملت

يسجّل الإخراج كل أداة طبّقها، على الكتلة التي طبّقها عليها: block.balancing في VDT الذي تعيده buildDocument. يمكن لبروفة أو اختبار أو تقرير أن يبيّن لماذا ينتهي عمود محاذيًا للأسفل — وأي الأعمدة لم تستطع أي أداة إغلاقها. الكتل التي تركتها الموازنة على حالها لا تحمل balancing، والمستند المبني مع enabled: false لا يحمل شيئًا منها.

interface VDTBalancing {
  levers: BalanceLever[]; // usually one: a paragraph after a list can take the list-end line and run a line long too
  spaceAbove: number;     // px the spacing levers added above the block (0 when only looseParagraph fired)
  extraLines?: number;    // looseParagraph: lines the paragraph gained
  tracking?: number;      // looseParagraph: the tracking that gained them, in thousandths of an em (0 = word spacing alone)
}
type BalanceLever = 'trailingCallout' | 'heading' | 'listEnd' | 'afterDisplay' | 'afterFloat' | 'looseParagraph';

تُسجَّل القطوع المتساوية على الأعمدة التي قطعتها: قيمة column.bandCapped هي true على كل عمود قُطع قطعًا متساويًا (الشريط الذي يتركه إطار يمتد بعرض الصفحة، أو شريط ختامي)، وcolumn.trailingCap تعلّم أيضًا الشريط الختامي لفصل أو للمستند (trailing).

import { buildDocument } from 'postext';
 
const doc = buildDocument(content, config);
for (const page of doc.pages) {
  page.columns.forEach((column, i) => {
    const levers: string[] = column.blocks.flatMap((block) => block.balancing?.levers ?? []);
    if (column.trailingCap) levers.push('closing band cut level');
    else if (column.bandCapped) levers.push('band cut level');
    if (levers.length > 0) console.log(`page ${page.index + 1}, column ${i + 1}: ${levers.join(', ')}`);
  });
}
// page 3, column 1: heading, heading
// page 3, column 2: listEnd, looseParagraph

#تجاوزات كل مستوى

يمكن لكل مستوى عناوين أن يتجاوز القيم الافتراضية العامة عبر المصفوفة levels. لا يختلف افتراضيًا إلا fontSize (إضافة إلى breakBefore في H1، المذكور أدناه) — وكل الخصائص الأخرى تُورث من إعدادات العناوين العامة.

القيمة الافتراضية في H1 تحاكي إخراج الفصول في الكتب: كل عنوان من المستوى الأعلى يُفتتح في صفحة فردية جديدة (اليمنى في كتاب يُقرأ من اليسار إلى اليمين)، مع صفحة فاصلة فارغة إلزامية بعد الفصل السابق. تجاوزها في levels[0].breakBefore إذا كانت بنية مستندك أبسط من بنية الكتاب.

يُدمج breakBefore الخاص بمستوى حقلًا بحقل فوق تلك القيمة الافتراضية، وكائن headings الذي لا يذكره يحتفظ بها. القيمة { parity: 'odd' } في H1 تُبقي الفاصل وتغيّر الزوجية وحدها؛ والقيمة { enabled: false } تجعل الفصول تتوالى دون فاصل:

headings: {
  fontFamily: 'Merriweather',                               // H1 still breaks to a fresh recto (always-odd)
  levels: [{ level: 1, breakBefore: { parity: 'odd' } }],    // …or: a recto, with no mandatory blank
}
 
headings: { levels: [{ level: 1, breakBefore: { enabled: false } }] } // chapters run on

تغيّر في postext 1.5. حتى postext 1.4 كان أي كائن headings يعطّل فاصل H1 ما لم يُعَد ذكر levels[0].breakBefore، وكان breakBefore الجزئي يملأ حقله الناقص من القيمة الافتراضية التي لا فاصل فيها. لذلك فإن إعدادًا مكتوبًا في الشيفرة للإصدار 1.4 فيه كائن headings وليس فيه فاصل قبل H1 يفتتح الآن كل فصل في صفحة فردية جديدة، مع صفحات زوجية فارغة حيث يلزم. لإبقاء الفصول متوالية، أعطِ مدخل H1 في levels حقلًا واحدًا:

headings: { fontFamily: 'Merriweather', levels: [{ level: 1, breakBefore: { enabled: false } }] } // as 1.4 laid it out

حين يكون الإعداد مخزّنًا، يستطيع المحرّك أن يعرف ذلك فيقوم بالعمل عنك: Sandbox للكتب والإعدادات التي حفظها آنذاك (انظر Sandbox › حفظ العمل)، وopenBundle / readBundle لحزمة .postext مكتوبة بالإصدار postext 1.4 أو أقدم (انظر الحزم المكتوبة بالإصدار postext 1.4 أو أقدم). أما الإعداد الذي خزّنته بنفسك فيمكن تمريره عبر migrateConfig(config) من postext/bundle، التي تكتب صراحةً الفواصل التي أخرجها الإصدار 1.4 (pinLegacyHeadingBreaks): enabled: false على H1 لم يكن له فاصل، وparity: 'any' بجانب enabled: true لم يذكر زوجية، في H1 وفي أنماط العناوين. وتثبّت أيضًا حجم الرياضيات، والمسافة حول الأشكال المضمّنة (في الإطارات أيضًا)، والعلامات المضمّنة في العناوين، وأحجام الحروف الاستهلالية، والمتسع تحت سطر النقطتين الذي يقدّم قائمة، والأسطر التي يتركها قطع الإطار من فقرة أو بند قائمة، وفواصل الأسطر عند الشرطات، والتقسيم سطرًا بسطر للنص غير المضبوط، وتقسيم الفقرة تحت العنوان، وفواصل الأسطر عند واصلة الكلمة المركبة، والمسافة تحت حاويات :::paragraphs، كما ضبطها الإصدار 1.4. مرّر نص Markdown للكتاب وسيطًا ثالثًا، { content }، فتُسقط تثبيت الرياضيات إذا لم يكن في النص $، وتثبيتات الفجوات إذا لم يضمّن أي سطر موردًا (وتثبيت فجوة الإطار إذا لم يفعل ذلك أي سطر داخل إطار)، وتثبيت علامات العناوين إذا لم يحمل أي عنوان علامة، وتثبيت سطر النقطتين إذا لم تلِ أي قائمة سطرًا ينتهي بنقطتين، وتثبيت قطع الإطار إذا لم يفتح النص أي :::callout، وتثبيت الشرطة إذا لم توضع أي شرطة ملاصقة بين كلمتين، وتثبيت تقسيم العنوان إذا لم يكن في النص عنوان، وتثبيت الحاوية إذا لم يفتح النص أي حاوية :::paragraphs، وتثبيت الكلمات المركبة إذا لم تقع أي واصلة بين حرفين؛ ولا يذهب تثبيت التقسيم غير المضبوط إلا إلى إعداد يجعل بعض النص الجاري غير مضبوط، ولا تثبيت الحاوية إلا إلى إعداد يعرّف نمط فقرة (انظر الحزم المكتوبة بالإصدار postext 1.4 أو أقدم). وللفواصل وحدها، استدعِ pinLegacyHeadingBreaks(config).

تدعم تجاوزات المستوى الخصائص نفسها التي تدعمها القيم الافتراضية العامة — fontSize وlineHeight وfontFamily وcolor وfontWeight وmarginTop وmarginBottom وsnapToGrid — إضافة إلى هذه الحقول الخاصة بالمستوى:

headings: {
  fontFamily: 'Merriweather',
  levels: [
    // Canonical book preset: chapters on a right-hand (odd) page.
    { level: 1, fontSize: { value: 24, unit: 'pt' }, breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontSize: { value: 18, unit: 'pt' }, italic: true },
  ]
}

يعمل snapToGrid لكل مستوى أيضًا. إن لم يُضبط، يتبع المستوى headings.snapToGrid؛ وإن ضُبط، تجاوزه — فيمكن لمستند واحد أن يضع عناوين H2 فيه على بعد سطر ونصف فوق نصها، خارج الشبكة حتى نقطة الالتقاط التالية، بينما تقرّب عناوين H3 المسافة تحتها صعودًا إلى أسطر شبكة كاملة. ويمكن لنمط العنوان أن يضبطه كذلك، للعناوين التي تستخدمه.

headings: {
  marginBottom: { value: 1.5, unit: 'em' },
  levels: [
    { level: 2, snapToGrid: false }, // exactly 1.5 em under every H2
    { level: 3 },                    // inherits headings.snapToGrid: true
  ],
}

#الفاصل قبل العنوان

breakBefore مستقل عن عناصر التحكم في الترقيم: تفعيله يفرض فاصل صفحة، لكن العدّاد الرقمي لا يُعاد ضبطه إلا حين تُدرج صراحةً توجيه :::numbering. تُحتسب صفحات الزوجية الفارغة صفحاتٍ حقيقية في التسلسل، وتتلقى الترويسات والتذييلات وفق قواعدها المعتادة للصفحات الفردية والزوجية.

التوجيه :::pagebreak الواقع مباشرة قبل مثل هذا العنوان لا يحل محل فاصله: يظل العنوان يطبّق زوجيته بعد الصفحة التي فتحها التوجيه، وقد يضيف ذلك صفحة فارغة. انظر أنماط العناوين لعنوان ينبغي أن يبدأ مباشرة بعد فاصل يدوي.

قيم الزوجية

تبعية الصفحات الفارغة

تحمل الصفحات الفارغة التي يدرجها breakBefore ترويسات بعنوان الفصل بحسب سبب إدراجها:

• الصفحات المدرجة لتلبية قيد الزوجية ('odd' أو 'even' أو ذيل الزوجية في 'always-*') تنتمي إلى الفصل القادم. يُحلّ العنصر النائب {chapterTitle} في ترويستها إلى عنوان الفصل الجديد — لأن الصفحة الفارغة لا توجد إلا لدفع الفصل الجديد إلى الزوجية الصحيحة.
• الصفحة الفاصلة الإلزامية في البداية التي يدرجها 'always-odd' / 'always-even' تنتمي إلى الفصل السابق. إنها استراحة مقصودة في نهاية الفصل، لذا تظل ترويسة {chapterTitle} تُظهر عنوان الفصل القديم.

تتبع ترويسات القسم المنمَّط ولوحة ألوانه (انظر أنماط العناوين) القاعدتين نفسيهما في الصفحات الفارغة.

استثناء بداية المستند

حين تكون أول كتلة في المستند عنوانًا مفعَّلًا فيه breakBefore — أو حين يبدأ المصدر بالتوجيه :::pagebreak — يُتخطى فرض الزوجية ما دامت الصفحة الأولى فارغة. يقع العنوان في الصفحة 1 كما كُتب، بصرف النظر عن الزوجية المضبوطة، فلا يرث مستند يبدأ بالعنوان # Chapter 1 المضبوط على parity: 'odd' صفحة فارغة زائفة في بدايته. وبمجرد وضع أي محتوى، يعمل فرض الزوجية كالمعتاد.

#الامتداد والتصميم المتقدم

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

افتتاحية بطول الصفحة. حين يمتد الارتفاع المحجوز إلى ما بعد قاعدة العمود — غلاف قيمة minHeight فيه تساوي ارتفاع الصفحة، أو صورة أو صندوق مثبت إلى الصفحة أو النزف ويمتد حتى حدّ القص — تستحوذ الافتتاحية على بقية الصفحة: يبدأ النص الذي يليها في الصفحة التالية، في كل عمود من تخطيط بعمودين أو بعمود ونصف على السواء. لذلك لا يحتاج الغلاف إلى :::pagebreak بعده (ولا ضرر من وجوده: لا يضيف صفحة فارغة). العنوان داخل العمود (span: 'column') الذي يكون تصميمه أطول من عموده يستحوذ على ذلك العمود، ويبدأ النص عند رأس العمود التالي. عندئذ تمتد كتلة العنوان حتى قاعدة العمود الذي تستحوذ عليه، ويُخرج تصميمها مقابل ذلك الشريط: العناصر المثبتة إلى الأعلى تبقى حيث ثُبتت، والعناصر التي تتبع الشريط — المثبتة إلى وسطه أو قاعدته، أو التي ارتفاعها 'fill' — تلتزم بالمتسع الذي يستحوذ عليه العنوان، كما تلتزم بالارتفاع المحجوز حين يتسع له العمود (حتى postext 1.4 كانت الكتلة تحتفظ بارتفاع نصها، فكانت تلك العناصر تُخرج مقابل شريط بارتفاع عنوان واحد، ويستمر النص الذي بعده تحت التصميم). عناصر الصفحة الثابتة التي لا ينبغي أن تستحوذ على الصفحة — شريط على الحافة الخارجية (fore-edge) بطول الصفحة كلها، أو زخرفة في أسفل الصفحة — مكانها تصميم الترويسة أو التذييل: إذا ثُبتت إلى 'page' أو 'bleed' وعُرضت مع pages: 'opener'، فإنها تُرسم في صفحة الافتتاح ولا تحجز أي مساحة من المتن.

مثال: افتتاحية فصل بسيطة تُظهر «Chapter N» فوق العنوان:

{
  "headings": {
    "levels": [
      {
        "level": 1,
        "span": "page",
        "breakBefore": { "enabled": true, "parity": "always-odd" },
        "advancedDesign": {
          "enabled": true,
          "slot": {
            "elements": [
              {
                "kind": "text",
                "id": "chapterLabel",
                "placement": {
                  "anchor": { "to": "container", "edge": "top" },
                  "offset": { "y": { "value": 48, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "Chapter {numberRoman}",
                "fontSize": { "value": 10, "unit": "pt" },
                "align": "center",
                "overflow": "ellipsis-end"
              },
              {
                "kind": "text",
                "id": "chapterTitle",
                "placement": {
                  "anchor": { "to": "#chapterLabel", "edge": "below" },
                  "offset": { "y": { "value": 12, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "{titleText}",
                "fontSize": { "value": 24, "unit": "pt" },
                "fontWeight": 700,
                "align": "center",
                "overflow": "wrap",
                "hyphenate": true
              }
            ]
          }
        }
      }
    ]
  }
}

العناصر النائبة الخاصة بالعناوين المتاحة داخل خانة تصميم المستوى:

• {titleText} — النص العادي للعنوان (بلا بادئة الترقيم). الفاصل القسري في العنوان (\\) يكون فاصل سطر هنا، في شريط الافتتاح وفي التصميم داخل العمود على السواء (حتى postext 1.4 كان التصميم داخل العمود يطبع مسافة مكانه، بينما يُقاس ارتفاعه مع الفاصل). الأسطر التي يلتف إليها العنوان المخفي في عموده تُضمّ مجددًا في العنوان كما كُتب: الكلمة المقسومة بعد واصلتها الأصلية تحتفظ بالواصلة بلا مسافة بعدها، والكلمة التي قسمها العمود تعود كاملة بلا الواصلة التي أضافها الفصل، والمجموعة الملتحمة بمسافة غير قابلة للفصل التي كانت أعرض من العمود فقُسمت عند تلك المسافة تستعيد مسافتها غير القابلة للفصل (Capítulo XVIII لا CapítuloXVIII)، وكل فاصل آخر يعيد مسافته الواحدة. حتى postext 1.4 كان كل فاصل سطر يصبح مسافة، فكان العنوان الملتف عند واصلة يطبع Word- Book، وكان الفاصل القسري في مثل هذا العنوان يُحذف.
• {number} — الرقم المنسَّق وفق numberingTemplate الخاص بالمستوى.
• {numberDecimal}, {numberRoman}, {numberRomanLower}, {numberAlpha}, {numberAlphaLower} — عدّاد العنوان (العدّ الجاري لمستواه، أيًا كان ما يطبعه القالب) بصيغ أعداد أخرى: الفصل الثالث يعطي 3 وIII وiii وC وc، مع numberingTemplate أو بدونه. العنوان غير المرقّم (نمط فيه numbered: false) يتركها فارغة.
• {numberWords}, {numberWordsLower}, {numberOrdinalWords}, {numberOrdinalWordsLower} — العدّاد نفسه مكتوبًا بالحروف، بحرف أول كبير أو بأحرف صغيرة: Three / three، Third / third (انظر الأعداد المكتوبة بالحروف).
• {numberHan} — العدّاد نفسه بالأرقام الصينية، بنظام الكتابة الذي يحدده locale الخاص بالمستند: الافتتاحية المضبوطة بالقالب 第{numberHan}回 تطبع 第十二回 للفصل الثاني عشر بينما يُدرج جدول المحتويات 12.
• {chapterNumber}, {chapterTitle}, {pageNumber}, {totalPages}, {bookTotalPages}, {title}, {subtitle}, {author}, {publishDate} — عناصر نائبة مشتركة للبيانات الوصفية.
• {attr.<key>} — سمة مكتوبة على سطر العنوان نفسه (# Title {author="I. Zango Martín"})، وإلا فسمة H1 للفصل الحالي. السمات المفقودة تُحلّ إلى سلسلة فارغة دون تحذير.

يطبع {chapterNumber} ما تطبعه الترويسات للفصل: رقم H1 حين يكون لمستواه (أو لنمطه) numberingTemplate، وإلا فترتيب الفصل — 1، 2… مستمرًا بعد الفصول التي أُخرجت قبل هذا الفصل — ولا شيء لفصل غير مرقّم أو لنمط قالبه ''. يقرأ تصميم العنوان الفصل الذي ينتمي إليه عنوانه: عنوان المستوى 1 يقرأ فصله، والعنوان الأدنى يقرأ آخر عنوان من المستوى 1 قبله. ويصح ذلك أيضًا حيث يلتقي فصلان في صفحة واحدة، بينما تطبع ترويسات تلك الصفحة الفصل اللاحق. ويُقاس الارتفاع الذي تحجزه الافتتاحية بالقيمة نفسها. حتى postext 1.4 كان يُقاس ببادئة رقم العنوان (الفارغة دون قالب)، فقد يُرسم التصميم الذي يعتمد ارتفاعه على {chapterNumber} أطول من المتسع الذي أخذه؛ وكان التصميم يطبع فصل الصفحة، فكان أول فصلين يتشاركان صفحة يُظهر رقم الثاني.

تتبع العناصر النائبة للعدّاد الكتابَ عبر الفصول التي تُخرج واحدًا تلو الآخر (العدّادات التي تمررها continuationAfter())، وتعيد السمة startAt في العنوان بدء عدّها (انظر صيغة المستند › سمات العناوين). افتتاحية تقول Chapter III فوق عنوان مرقّم 3. في التدفق وفي جدول المحتويات:

{
  level: 1,
  span: 'page',
  numberingTemplate: '{1}.',
  advancedDesign: {
    enabled: true,
    slot: { elements: [
      { kind: 'text', id: 'label', content: 'Chapter {numberRoman}', fontSize: { value: 10, unit: 'pt' }, overflow: 'ellipsis-end',
        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill', height: 'auto' } } },
      { kind: 'text', id: 'title', content: '{titleText}', fontSize: { value: 24, unit: 'pt' }, overflow: 'wrap',
        placement: { anchor: { to: '#label', edge: 'below' }, size: { width: 'fill', height: 'auto' } } },
    ] },
  },
}

الارتفاع المحجوز

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

1. نص العنوان نفسه، مضبوطًا بطباعة المستوى (يكون مخفيًا تحت التصميم، لكنه يحتفظ بأسطره)؛
2. أسفل محتوى التصميم — أدنى حافة سفلية بين العناصر المحتسبة (أدناه)؛
3. advancedDesign.minHeight.

يُضاف marginBottom الخاص بالعنوان بعده (من نمط عنوانه أو مستواه أو headings.marginBottom؛ 0.5 em افتراضيًا)، ويُلتقط الناتج صعودًا إلى شبكة خطوط الأساس حين تلتقط العناوين الشبكة. في الافتتاحية (span: 'page') يُترك الشريط نفسه خاليًا في كل عمود من الصفحة. وفي العنوان داخل العمود الذي يتسع له عموده، يُخرج التصميم في صندوق العنوان، الذي يكون بهذا الارتفاع بالضبط.

أي العناصر تُحتسب. كل عنصر في التصميم يُحتسب — النصوص والخطوط والصناديق والصور على السواء (حتى postext 1.4 لم يكن عنصر image يُحتسب أبدًا، فكان النص قد يبدأ فوق صورة الشريط ما لم يُبعده minHeight) — باستثناء:

• العناصر التي فيها reserve: false — زخرفة يجوز أن تقع تحت النص؛
• العناصر التي تتبع الشريط نفسه — المثبتة إلى الصف الأوسط من الحاوية (left، center، right) أو صفها السفلي (bottom-left، bottom، bottom-right)، والتي ارتفاعها 'fill' مقابل الحاوية (الصندوق أو الخط العمودي الذي لا ارتفاع له يملؤها افتراضيًا)، وأي عنصر مثبت إلى أحدها. الحاوية هي الشريط المحجوز، فهذه العناصر تستقر على قاعدته أو تمتد عبره: خط تحت الشريط، أو لوحة ملوّنة خلف العنوان. إنها تتبع الارتفاع ولا تحدده أبدًا. والنص بينها الذي يحتفظ بارتفاعه الخاص ما زال يحتاج إلى متسع: نص العنوان المثبت إلى قاعدة الشريط يجعل الشريط بطول ذلك النص على الأقل، فلا يبدأ أبدًا فوق أعلى العنوان. مع minHeight: 36mm ونص العنوان مثبت bottom-left، يكون صندوق العنوان 36 مم مضافًا إليها marginBottom الخاص به، مقرَّبًا صعودًا إلى الشبكة، ويقع نص العنوان عند قاعدة ذلك الصندوق، فوق النص التالي مباشرة؛ ومن دون minHeight، فإن نص العنوان الذي يأخذ أسطرًا أكثر من نص العنوان المخفي يجعل الشريط بعمق ذلك النص. حتى postext 1.4 كان مثل هذا النص يُرسم صاعدًا فوق النص الذي يسبق العنوان. الصناديق والخطوط والصور التي تتبع الشريط لا تضع حدًا أدنى كهذا، فاللوحة المثبتة إلى القاعدة يمكن أن تمتد فوق العنوان.

العناصر المثبتة إلى الصفحة أو النزف تُحتسب بقدر امتدادها تحت أعلى العنوان. الشريط الممتد عبر أعلى الصفحة الذي ينتهي فوق العنوان لا يُحتسب منه شيء؛ والصورة الممتدة إلى النزف الكامل التي تتجاوزه تدفع النص إلى أسفل حتى حافتها السفلى. وكذلك أي شيء يقع منخفضًا في الصفحة: الختم على بعد 25 مم فوق أسفل الصفحة، أو الشريط الجانبي بطول الصفحة، أو الإطار، يحجز الصفحة حتى حافته السفلى، وعادة يبدأ النص في الصفحة التالية. علّم مثل هذه الزخرفة بالقيمة reserve: false — فهي تظل تُرسم ويمكن للعناصر أن تُثبت إليها — وأعطِ العنوان المتسع الذي يحتاجه بعناصره النصية أو بالقيمة minHeight:

{
  "kind": "image", "id": "seal", "resourceId": "seal", "reserve": false,
  "placement": {
    "anchor": { "to": "page", "edge": "bottom-right" },
    "offset": { "x": { "value": -25, "unit": "mm" }, "y": { "value": -25, "unit": "mm" } },
    "size": { "width": { "value": 30, "unit": "mm" } }
  }
}

العنصر المثبت إلى عنصر لا يحجز مكانًا يظل يُحتسب ما لم يُعلَّم هو أيضًا (التعليق المثبت إلى الختم يحتاج إلى reserve: false خاص به).

أين يُرسم. يُرسم تصميم الافتتاحية (span: 'page') قبل المتن، فالزخرفة التي لا تحجز شيئًا تقع تحت النص. أما تصميم العنوان داخل العمود فيُرسم مع كتلة العنوان — فوق الكتل التي تسبقه في العمود، وتحت الكتل التي تليه — حيثما وُضع فوق قاعدة عموده: في الهوامش الجانبية، والهامش العلوي، والنزف، والأعمدة المجاورة أيضًا. تقصّه قاعدة العمود، في Canvas وفي PDF، لأن التدفق ينتهي هناك (انظر أطول من العمود أدناه). حتى postext 1.4 كانت Canvas وPDF تقصّانه أيضًا عند أعلى عموده، فكان الشريط المثبت إلى أعلى الصفحة أو النزف يمتد إلى الهوامش الجانبية لكنه يتوقف عند الهامش العلوي. الزخرفة المثبتة إلى أسفل الصفحة مكانها الافتتاحية، أو تصميم التذييل مع pages: 'opener'.

أطول من العمود. حين يمتد المتسع إلى ما بعد قاعدة العمود — minHeight بطول الصفحة، أو صورة أو إطار يمتد حتى حدّ القص — يستحوذ العنوان على بقية صفحته (الافتتاحية، في كل عمود) أو عموده (العنوان داخل العمود)، ويبدأ النص الذي بعده في الصفحة أو العمود التالي. عندئذ تمتد كتلته حتى قاعدة العمود، ولا تُقصّ أبدًا إلى ارتفاع نصها، فيكون الشريط الذي يُخرج تصميمه مقابله هو المتسع الذي يستحوذ عليه (بما في ذلك minHeight، حتى القاعدة). التصميم الأطول من الصفحة نفسها — نص تمهيدي طويل في صفحة شاشة صغيرة — يظل يُقصّ عند أسفل الصفحة (والتصميم داخل العمود عند أسفل عموده): يُدرجه Sandbox في لوحة الفحوص باسم تصميم العنوان مقطوع. لا يصدر الإخراج تحذيرًا بشأنه — فالغلاف الذي يستحوذ على صفحته حالة معتادة ولا يفقد شيئًا — لكن أي مضيف يمكنه إجراء الفحص نفسه على الإخراج النهائي: تعيد collectHeadingDesignCuts(doc) كائنًا { kind: 'headingDesignCut', pageIndex, level, where, overflowPx, sourceStart, sourceEnd } لكل عنوان يقع نص تصميمه بعد أسفل حدّ قص الصفحة (where: 'page'، افتتاحية) أو بعد أسفل عموده (where: 'column')، وتصف formatWarning كلًا منها. انظر افتتاحية بطول الصفحة ضمن الامتداد والتصميم المتقدم.

العمود الجانبي. في تخطيط العمود ونصف الذي يحمل عموده الجانبي العناصر العائمة (sideColumnRole: 'floats')، فإن عنصر تصميم عنوان داخل العمود الذي يقف في العمود الجانبي — رقم فصل مثبت إلى الصفحة في عمود الهامش الخارجي لافتتاحية كتاب مدرسي — يُبعد عنه مكدّس العناصر الجانبية. كل شكل أو جدول أو إطار span: 'side' تضعه الصفحة بعد العنوان يترك فجوة عنصر عائم واحدة بينه وبين كل عنصر من هذا النوع: يبقى حيث يضعه المكدّس حين يتسع فوق العنصر، وإلا ذهب تحته — أو انتظر الصفحة التالية حين لا تتسع له بقية العمود الجانبي هناك. وهكذا فإن رقمًا عند رأس الهامش يُبقي المكدّس كله تحته، بينما رقم قسم معلّق في الهامش بجانب عنوان أدنى في الصفحة يترك رأس الهامش للأشكال التي تحيل إليها الصفحة (يبقى الشكل الهامشي في أعلى صفحته). ما يحمله العمود الجانبي بالفعل عند وضع العنوان لا يُحرّك: الشكل المكدّس سابقًا في الصفحة والذي يمتد حتى عنصر العنوان يبقى حيث هو، تحت العنصر، لذا فإن التصميم الذي يقف عنصره في العمود الجانبي في منتصف الصفحة يحتاج إلى أن تأتي الإحالة إلى أشكاله بعد العنوان. العناصر التي فيها reserve: false تترك العمود الجانبي حرًا، كما تترك النص. الافتتاحية (span: 'page') لا تحتاج إلى شيء من هذا: شريطها محجوز في كل عمود، بما فيه العمود الجانبي. حتى postext 1.4 كان الشكل الجانبي المحال إليه في مثل هذه الافتتاحية يوضع عند رأس العمود الجانبي، فوق الرقم.

الأغلفة. عنوان الغلاف الذي يملأ صفحته — minHeight بطول الصفحة، أو صورة بحجم الصفحة الكاملة في تصميمه — يرسل إذن النص الذي بعده إلى الصفحة التالية بنفسه، في التخطيطات ذات العمود الواحد والأعمدة المتعددة على السواء. والتوجيه :::pagebreak بعده مباشرة اختياري ولا ضرر منه: فاصل الصفحة في صفحة ما زالت فارغة لا يفعل شيئًا، فلا يضيف صفحة فارغة أبدًا. لا يُحتاج إليه إلا حين يتوقف تصميم الغلاف قبل أسفل الصفحة ويُراد مع ذلك أن يبدأ النص في صفحة جديدة.

# Annual report 2026 {style="cover"}
 
:::pagebreak
 
# Letter from the chair

#الأعداد المكتوبة بالحروف

لاحقتان من لواحق قالب الترقيم تكتبان العدّاد بالكلمات، بلغة المستند (locale في المستوى الأعلى، وإلا فلغة تقسيم الكلمات — انظر لغة المستند): words للعدد الأصلي وordinal للعدد الترتيبي. حالة أحرف اللاحقة تحدد حالة أحرف الكلمات، كما تفعل A / a للحروف:

تُكتب الأعداد بالكلمات في الإنجليزية والإسبانية والصينية والعربية؛ وأي لغة أخرى تأخذ الكلمات الإنجليزية، كما تفعل نصوص استمرار الجداول المدمجة. تكتب الصينية الأرقام غير الرسمية في simp-chinese-informal أو trad-chinese-informal، بحسب نظام الكتابة في locale (一万 / 一萬)، مع 第 قبل العدد الترتيبي؛ ولا حالة أحرف للحروف الصينية، فتطبع الكتابات الثلاث للاحقة النتيجة نفسها. تتبع الإنجليزية الاستعمال الأمريكي (one hundred five، بلا and). وتستخدم الإسبانية صيغ المذكر، كما يُرقَّم capítulo أو libro (capítulo primero، tercero، veintiuno)، وتكتب الأعداد الترتيبية من 13 إلى 29 كلمة واحدة، كما تفضّل الأكاديمية الملكية الإسبانية (RAE) (decimotercero، vigesimoprimero). تُكتب الأعداد الأصلية بالحروف حتى 999 999 والترتيبية الإسبانية حتى 999؛ وتُطبع الأعداد الأكبر بالأرقام.

تتطابق الأعداد العربية في التذكير والتأنيث مع المعدود، لذا تأخذ اللاحقة مُعدِّلًا: -feminine (أو -f) للمعدود المؤنث، و-masculine (-m، الافتراضي) للمذكر؛ و-classical تكتب المئات بصيغة مائة، كما تفعل طبعات بولاق ومعظم الطبعات المصرية، بدل صيغة مئة الحديثة. يكتب {1:ordinal} العدد الترتيبي المعرّف المرفوع الذي يستخدمه العنوان: الفصل {1:ordinal} يعطي الفصل الأول، الفصل الحادي عشر، الفصل الحادي والعشرون؛ والليلة {1:ordinal-feminine} يعطي الليلة الأولى، الليلة الحادية عشرة، الليلة الحادية والعشرون، الليلة المئتان، وفوق المئة صيغة «بعد» الكلاسيكية: الليلة الخامسة والأربعون بعد الثلاثمئة، الليلة الحادية بعد الألف. ويكتب {1:words} العدد الأصلي (واحد وعشرون؛ والمؤنث إحدى عشرة، واحدة وعشرون). تُكتب الأعداد الترتيبية حتى 9 999 والأصلية حتى 99 999؛ ويمكن الجمع بين المعدّلات ({1:ordinal-f-classical})، وتتجاهلها اللغات الأخرى. لا أحرف كبيرة في العربية، فلا تغيّر حالة أحرف اللاحقة شيئًا. العنصران النائبان للتصميم {numberWords} و{numberOrdinalWords} يكتبان صيغ المذكر؛ ولافتتاحية بصيغة المؤنث، ضع العدد الترتيبي في قالب المستوى واطبعه بالعنصر {number}.

في تصميم العنوان، يكتب {numberWords} / {numberWordsLower} و{numberOrdinalWords} / {numberOrdinalWordsLower} عدّاد العنوان بالطريقة نفسها، فيمكن أن تقول الافتتاحية Chapter One بينما يُدرج جدول المحتويات 1. وتعطي textTransform: 'uppercase' في العنصر النصي الأحرف الكبيرة:

// Spanish novel: "CAPÍTULO PRIMERO" above the title, "1." in the contents.
{ level: 1, numberingTemplate: '{1}.', span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'n', content: 'Capítulo {numberOrdinalWordsLower}', textTransform: 'uppercase', /* … */ },
    { kind: 'text', id: 't', content: '{titleText}', /* … */ },
  ] } } }

#القوائم غير المرقّمة

تتحكم الخاصية unorderedLists في طريقة إخراج القوائم النقطية (-، *، +) وقوائم المهام بصيغة GFM (- [ ]، - [x]). يمكن أن تتداخل القوائم حتى خمسة مستويات.

#القيم الافتراضية للقوائم غير المرقّمة

#امتدادات قوائم المهام

تُخرَج بنود المهام بصيغة GFM (- [ ] …، - [x] …) بنودًا غير مرقّمة يحل فيها رمز مربع اختيار محل النقطة. الحقول الآتية لا تنطبق إلا على بنود المهام:

#تجاوزات كل مستوى في القوائم غير المرقّمة

كل مُدخل في levels يستهدف عمقًا واحدًا (1–5) ويمكنه أن يتجاوز أيًّا مما يلي:

تسلسل الإزاحة. يبدأ المستوى 1 دائمًا عند قيمة indent العامة (وهي افتراضيًا 0 em، أي أن النقاط مثبّتة عند حافة العمود). في المستويات 2–5، إذا تركت indent دون تعريف وضع المحرّك النقطة عند موضع بداية نص المستوى السابق (إزاحة الأب + عرض النقطة + gap). عيّن indent صريحة لمستوى ما لتقطع التسلسل وتثبّت ذلك العمق حيث تشاء.

unorderedLists: {
  bulletChar: '—',
  gap: { value: 0.4, unit: 'em' },
  hangingIndent: true,
  levels: [
    { level: 2, bulletChar: '·' },
    { level: 3, bulletChar: '◦', color: { hex: '#666666', model: 'hex' } },
  ],
}

#القوائم المرقّمة

تتحكم الخاصية orderedLists في القوائم المرقّمة (1.، 2)، إلخ). يمكن أن تتداخل القوائم حتى خمسة مستويات، ويمكن لكل عمق أن يستخدم تنسيق ترقيم مختلفًا.

#القيم الافتراضية للقوائم المرقّمة

#تجاوزات كل مستوى في القوائم المرقّمة

يمكن لكل مُدخل في levels أن يتجاوز numberFormat وprefix وseparator وfontFamily وfontSize وcolor وfontWeight وitalic وindent وverticalOffset ونمط الفاصل (separatorFontFamily، separatorFontWeight، separatorItalic، separatorColor، separatorGap)، وتنطبق قاعدة تسلسل الإزاحة نفسها المطبقة على القوائم غير المرقّمة. يرث نمط الفاصل في مستوى ما نمط الرقم في المستوى نفسه، ما لم يُعطَ إعداد الفاصل على مستوى القائمة كلها.

المحاذاة إلى اليمين. يقيس المسار أعرض رقم منسَّق داخل السلسلة ويزيح كل بنود تلك السلسلة كي تصطف علامات الأرقام على حافتها اليمنى. في قائمة من عشرة بنود تُخرج من 1. إلى 10.، تُحشى الأرقام ذات الخانة الواحدة من جهة اليمين كي يبقى الفاصل في العمود نفسه.

orderedLists: {
  numberFormat: 'arabic',
  separator: '.',
  levels: [
    { level: 2, numberFormat: 'lower-alpha' },
    { level: 3, numberFormat: 'lower-roman', separator: ')' },
  ],
}

ينتج عن ذلك المزيج المتداخل المألوف:

1. First item
   a. Sub-item
      i) Deep note
   b. Sub-item
2. Second item

تراتبية المستندات الصينية (GB/T 15834—2011، الملحق B.3) تتألف من خمسة مستويات: 一、 ثم （一） ثم 1. ثم （1） ثم ①:

orderedLists: {
  levels: [
    { level: 1, numberFormat: 'simp-chinese-informal', separator: '、' },
    { level: 2, numberFormat: 'simp-chinese-informal', prefix: '（', separator: '）' },
    { level: 3, numberFormat: 'arabic', separator: '.' },
    { level: 4, numberFormat: 'arabic', prefix: '（', separator: '）' },
    { level: 5, numberFormat: 'circled-decimal', separator: '' },
  ],
}

#الصيغ الرياضية

تتحكم الخاصية math في طريقة تحليل صيغ LaTeX وإخراجها، سواء داخل المحدِّدين $...$ (ضمن السطر) أو $$...$$ (صيغة منفصلة، display). المحرّك الذي تقوم عليه هو MathJax (الحزمة mathjax-full) في وضع الإخراج SVG، ويُحوَّل إلى صورة نقطية في Canvas ويُضمَّن في PDF رموزًا قابلة للتحجيم.

interface MathConfig {
  enabled?: boolean;        // Render LaTeX. When false, spans pass through as literal TeX.
  fontSizeScale?: number;   // × the surrounding text's size (the body size for display maths).
  color?: ColorValue;       // Formula colour; inherits body colour if omitted.
  marginTop?: Dimension;    // Space above display math blocks.
  marginBottom?: Dimension; // Minimum space below; baseline grid snap may enlarge it.
  indentAfterDisplay?: boolean; // Indent a paragraph that follows a display formula.
  keepWithLeadIn?: boolean; // Keep a display formula with the line that leads into it.
}

math: {
  enabled: true,
  fontSizeScale: 1.0,
  color: { hex: '#295AA3', model: 'hex' },
  marginTop: { value: 1, unit: 'em' },
  marginBottom: { value: 1, unit: 'em' },
}

حجم الصيغ، تغيّر في postext 1.5. يعطي MathJax صندوق الصيغة بوحدة ex، والـ ex الواحد من خط TeX فيها يساوي 0.442 em. حتى postext 1.4 كان المحرّك يعدّه نصف em، فكانت كل صيغة تُنضَّد أكبر بنحو 13% من bodyText.fontSize × fontSizeScale. صارت الصيغ الآن تخرج بالحجم الموثَّق، فيُعاد تدفق الأسطر والصفحات التي فيها رياضيات. والإعدادات المكتوبة برمجيًا للإصدار 1.4 تحتفظ بحجم صيغ 1.4 إذا مُرّرت عبر pinLegacyMathSize من postext/bundle، مرة واحدة، كما كُتبت:

import { pinLegacyMathSize } from 'postext/bundle';
 
config = pinLegacyMathSize(config); // formulas, and the space around display formulas, as 1.4 set them

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

import { migrateConfig } from 'postext/bundle';
 
config = migrateConfig(config, undefined, { content: markdown }); // heading breaks, formulas, inline gaps, heading marks, drop caps, colon lines, box cuts, dash breaks, compound breaks, ragged breaking, splits under a heading and container space as 1.4 set them

يمنع ذلك ما كانت تغييرات القواعد هذه ستحرّكه، لكنه لا يحفظ كل صفحة من صفحات 1.4. فالإصدار 1.5 يصلح أيضًا أخطاء في الإخراج، والإصلاح لا يُثبَّت: يحصل عليه الإعداد القديم كما يحصل عليه الجديد، فقد تتحرك صفحة يمسّها. ومن هذه الإصلاحات: العنوان الممتد عبر الصفحة بلا تصميم خاص به يُقاس على عرض الصفحة ويُنضَّد بتباعد أسطر مستواه؛ لا يُحجز شيء تحت خط أساس الحرف الاستهلالي في تصميم العنوان؛ يأخذ الحرف الاستهلالي لون لوحة القسم، ويُنضَّد حتى في نص التصميم الذي ليست قيمة overflow فيه 'wrap'، فيلتف النص حينئذ؛ الفقرة داخل الإطار تُرسم بالتتبّع الذي قيست به؛ الإطار المقسوم يحتفظ بعمود أيقونته في كل جزء منه؛ سطر الإطار الذي كانت مسافاته ستتمدد إلى أكثر من 3× يُنضَّد غير مضبوط، كما في النص الجاري؛ أداة الفقرة المرخاة لا تجعل أبدًا سطرًا مضبوطًا أعرض مما تسمح به maxWordSpacing؛ الإطار العائم يحتفظ بقيمة marginBottom (في الشريط العلوي) أو marginTop (في الشريط السفلي) إذا كانت أعرض من فجوة العناصر العائمة؛ نص التصميم المتوسّط أو المحاذى إلى اليمين الذي فيه تتبّع (كالترويسة أو عنوان صفحة الافتتاح) يوضع بحسب حروفه، دون التتبّع الذي بعد الحرف الأخير؛ تحت عنوان افتتاح ممتد عبر الصفحة، يبدأ النص الذي يفتتح العمود الثاني حيث كان سيبدأ النص الواقع مباشرة تحت عنوان الافتتاح، حتى حين يلي عنوانٌ عنوانَ الافتتاح؛ تتوقف نقاط جدول المحتويات قبل رقم الصفحة في الخط الذي يباعد بتقنين الأزواج (kerning) بين النقاط المتتالية؛ تقرأ الترويسة العنوان كما كُتب، بلا مسافة حيث ينتهي أحد أسطره بعد واصلة أو شَرطة أو داخل كلمة قُطعت لضيق العرض (MEDIOAMBIENTALES لا MEDIOAMBIENTALE S)، ويقرؤه {titleText} في تصميم العنوان بالطريقة نفسها (thousand-colour لا thousand- colour)؛ النص المثبَّت في أسفل شريط تصميم العنوان أو وسطه يُبقي الشريط طويلًا بما يكفي لاحتوائه، فلم يعد يرتفع فوق النص الذي يعلو العنوان؛ الكلمة الأعرض من سطرها، إذا قُطعت بجوار واصلة تحملها، تُقطع بعد تلك الواصلة ولا تُضاف إليها واصلة ثانية؛ البند التالي لقائمة متداخلة في أخرى يأخذ itemSpacing قائمته هو، لا قيمة القائمة المتداخلة؛ وبقية الكلمة المقطوعة لأنها أعرض من سطرها تحتفظ بمواضع القطع الخاصة بها، فيظل عنوان الويب ينقطع عند مفاصله والكلمة المركّبة عند واصلاتها، بدلًا من مقاطع القاموس.

تضرب pinLegacyMathSize المقياس في 1.1312 (0.5 ÷ 0.442) وتقسم هوامش الصيغ المنفصلة المعبَّر عنها بوحدة em على المعامل نفسه. المقياس وحده لا يكفي لكتاب فيه صيغ منفصلة: فهوامشها أطوال بمقياس حجم الصيغة نفسها، فكانت ستكبر بنسبة الـ 13% نفسها وتدفع النص الذي تحتها إلى الأسفل. وهذه هي القيم الثلاث مكتوبةً للهوامش الافتراضية:

math: {
  fontSizeScale: 1.131,
  marginTop: { value: 0.7072, unit: 'em' },
  marginBottom: { value: 0.7072, unit: 'em' },
} // formulas as large as 1.4 set them, with the space 1.4 left around them

حيث يكون الإعداد مخزَّنًا، يستطيع المحرّك أن يتعرّف على ذلك ويقوم به عنك: openBundle / readBundle لحزمة .postext كُتبت قبل 1.5 (انظر الحزم التي كتبها postext 1.4 أو ما قبله)، وSandbox للكتب ونسخة العمل وملفات postext-config.json المحفوظة آنذاك (انظر Sandbox › حفظ العمل). تُقرأ هذه عبر migrateConfig، التي تثبّت الحجم (pinLegacyMathSize): تصبح fontSizeScale مساويةً للمقياس المخزَّن (1 إن لم يُعيَّن) × 1.1312، ويُقسَم هامش الصيغة المنفصلة المعبَّر عنه بوحدة em أو rem، وهو طول بمقياس حجم الصيغة نفسها، على المعامل نفسه، فتبقى المسافة حول الصيغة المنفصلة كما تركها 1.4 (تصبح القيمة الافتراضية 0.8 em هي 0.7072 em). أما الهامش بوحدة من وحدات الصفحة (pt، mm…) فيُترك كما هو، وكذلك الإعداد الذي فيه enabled: false أو الذي ليس في كتابه أي $. عندئذ يُخرَج الكتاب القديم كما أخرجه 1.4، ويُظهر قسم math فيه الحجم الذي يُنضَّد به. ولتنضيد هذا الكتاب بحجم اليوم بدلًا من ذلك، أعد تعيين تلك القيم: الصيغ الرياضية › معامل الحجم والهامش العلوي للصيغة المعروضة والهامش السفلي للصيغة المعروضة في Sandbox، أو برمجيًا:

math: { ...config.math, fontSizeScale: 1, marginTop: undefined, marginBottom: undefined } // today's size and margins

المعادلات المرقّمة. الصيغة المنفصلة التي فيها \tag{…} تمتد على عرض قياسها (العمود، أو العرض الداخلي للإطار الذي تقع فيه): تُوسَّط المعادلة ويُصفّ رقمها محاذىً إلى اليمين على سطر المعادلة، في كل صف موسوم من بيئة align. أما \tag*{…} فيطبع التسمية كما كُتبت، بلا أقواس. لا يُطبع رقم إلا للوسوم الصريحة؛ فالبيئات مثل equation لا تُرقَّم من تلقاء نفسها. والمعادلة المرقّمة الأعرض من قياسها تفيض إلى اليمين، كأي صيغة منفصلة. (حتى postext 1.4 لم تكن الصيغة التي فيها \tag تُرسم أصلًا.)

دالتا الحل والتجريد مماثلتان لنظيراتهما في الأقسام الأخرى:

import {
  DEFAULT_MATH_CONFIG,
  resolveMathConfig,
  stripMathDefaults,
} from 'postext';
 
const resolved = resolveMathConfig(config.math);
const minimal  = stripMathDefaults(config.math);

#تشغيل محرّك الرياضيات

يُحمَّل MathJax عند الطلب، لا مع بقية المحرّك. حين تُجري الإخراج على الخيط الرئيسي، شغّله قبل بناء مستند فيه صيغ:

import { buildDocument, initMathEngine, renderPage } from 'postext';
 
await initMathEngine(); // loads MathJax once; later calls resolve at once
const doc = buildDocument({ markdown: 'Euler: $e^{i\\pi}+1=0$.' }, config);
document.body.append(renderPage(doc.pages[0], doc));

• إلى أن يعمل المحرّك، تكون الصيغ عناصر نائبة. تُخرَج كل صيغة صندوقًا رماديًا بحجم تقديري. وإذا أُخرج مستند فيه رياضيات قبل أن تُستدعى initMathEngine() ولو مرة، أظهرت وحدة التحكم تحذيرًا واحدًا بذلك.
• عامل الإخراج (worker) يشغّله عنك. البناء في postext/worker يستدعي initMathEngine() بنفسه حين يحتوي نص Markdown على $.
• أخرج الآن، ثم أعد الإخراج حين يجهز. تخبرك isMathReady() هل المحرّك يعمل. وتستدعي onMathReady(fn) الدالة fn حين يجهز (فورًا إن كان جاهزًا) وتعيد دالة تلغي الاستدعاء. يستطيع المحرّر أن يعرض العناصر النائبة فورًا ثم يعيد الإخراج حين يصل MathJax؛ ولا يُطبع أي تحذير ما دامت initMathEngine() قيد التنفيذ.
• الإخفاق. ترفض initMathEngine() (reject) حين يتعذر تحميل MathJax، والاستدعاء اللاحق يحاول من جديد.
• أي مُجمِّع (bundler)، أو Node، أو CDN. يأتي MathJax داخل الحزمة وحدةً واحدة مجمَّعة مسبقًا (نحو 1.8 MB قبل الضغط، ولا تجلبها إلا initMathEngine). يعمل الاستيراد البسيط import { initMathEngine } from 'https://esm.sh/postext'؛ ولا حاجة إلى ?bundle. الحزمة mathjax-full لا تلزم إلا لبناء postext، فتثبيت postext لا يثبّتها. MathJax ومحلّل mhchem المضمَّن فيه مرخّصان بترخيص Apache-2.0: تأتي إشعاراتهما ونص الترخيص بجوار الوحدة، في dist/math/THIRD_PARTY_LICENSES.txt.
• محرّك واحد لكل صفحة. يتشارك المحرّك وذاكرته المؤقتة للصيغ المُخرجة كلُّ ما يستورد postext في نطاق JavaScript نفسه (انظر الحالة العامة المشتركة في صفحة واحدة).

لقواعد الكتابة في جانب المستند ($...$، $$...$$، تهريب علامة الدولار الحرفية)، انظر صيغة المستند.

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

تحدد الخاصية footnotes أين تذهب الحواشي المستشهد بها عبر [^id]، وكيف تُرقَّم وكيف تبدو. الترميز موصوف في صيغة المستند.

interface FootnotesConfig {
  placement?: 'column' | 'chapterEnd'; // Foot of the citing column, or after the chapter.
  numbering?: 'chapter' | 'document' | 'page' | 'column'; // Start again at each chapter, run on, or start again on each page / column.
  numberFormat?: string;      // decimal, lower-roman, circled-decimal (①)…
  markerPosition?: 'auto' | 'superscript' | 'inline'; // Raised, or on the baseline.
  markerSize?: Dimension;     // Inline marker size; em is the text around it.
  chapterEndAlign?: 'foot' | 'text';   // chapterEnd: notes at the column foot, or under the text.
  fontSize?: Dimension;       // Note size; em is the body size.
  lineHeight?: Dimension;     // Note leading; em is the note size.
  color?: ColorValue;         // Note colour; the body colour when unset.
  textAlign?: TextAlign;      // The body alignment when unset.
  hangingIndent?: Dimension;  // Indent of a note's turnover lines.
  spaceBetween?: Dimension;   // Space between two notes.
  spaceAbove?: Dimension;     // Space between the text and the rule; em is the body size.
  spaceBelowRule?: Dimension; // Space between the rule and the first note.
  separator?: {
    enabled?: boolean;        // Draw the rule.
    width?: number;           // Rule length, a fraction of the column width.
    lineWidth?: Dimension;    // Rule thickness.
    color?: ColorValue;       // The note colour when unset.
  };
}

footnotes: {
  fontSize: { value: 7.5, unit: 'pt' },
  lineHeight: { value: 9.5, unit: 'pt' },
  hangingIndent: { value: 0.8, unit: 'em' },
  separator: { width: 0.25, lineWidth: { value: 0.4, unit: 'pt' } },
}

كيف تُخرَج الحواشي في أسفل العمود:

• الحاشية والاستشهاد يتشاركان العمود. قبل أن يضع الإخراج سطرًا، يضيف ارتفاع الحواشي التي يستشهد بها ذلك السطر لأول مرة (والخط الفاصل، مع أول حاشية في العمود). والسطر الذي لا تتسع حواشيه تحته ينتقل إلى العمود التالي مع بقية فقرته، وفق قاعدتي الأسطر اليتيمة والأرامل. تتقلص مساحة النص في العمود بمقدار ارتفاع الحواشي، فلا تحسب موازنةُ الأعمدة والشريطُ الختامي للفصل إلا النص.
• عدة حواشي في عمود واحد تتراكم بترتيب الاستشهاد تحت خط فاصل واحد. والحاشية التي يُستشهد بها مرة أخرى لاحقًا تحتفظ برقمها ولا تُنضَّد ثانيةً.
• العناصر العائمة السفلية. الشكل الذي يشغل أسفل عمود بعد وضع حواشيه يوضع فوقها؛ والحواشي التي توضع بعد الشكل تأتي فوقه.
• الإطارات. الحاشية المستشهد بها داخل إطار (ضمن السطر أو عائم أو ثابت) تذهب إلى أسفل العمود الذي يستمر فيه النص بعد الإطار، وهو عادةً العمود نفسه. والإطار الذي يختم المستند يترك حواشيه في أسفل العمود الذي انتهى فيه النص.
• الحدود. لا تُقسَم الحاشية أبدًا: الحاشية الأطول من العمود تفيض منه. والعلامات في التعليقات وخلايا الجداول والعناوين لا تُقرأ (تُطبع كما كُتبت).
• المُخرجات. ترسم Canvas وHTML وPDF الحواشي والعلامات (رقمًا مرفوعًا) والخط الفاصل. في PDF ترتبط كل علامة بحاشيتها، وPDF الموسوم يجعل كل حاشية عنصر Note بمعرّف /ID فريد مُدرج في /IDTree من شجرة البنية (PDF/UA-1). الحواشي كتل VDTBlock عُيّنت فيها footnoteNote، في page.floats؛ والخطوط الفاصلة في page.footnoteAreas.
• التحذيرات. undefinedFootnote (علامة بلا تعريف: يُطبع الرقم فوق حاشية فارغة) وunusedFootnote (تعريف لا تستشهد به أي علامة: لا يُنضَّد).

دالتا الحل والتجريد مماثلتان لنظيراتهما في الأقسام الأخرى:

import { DEFAULT_FOOTNOTES_CONFIG, resolveFootnotesConfig, stripFootnotesDefaults } from 'postext';

#الإحالات المرجعية

تحدد الخاصية crossRefs الكلمات التي تطبعها الإحالة المرجعية حول رقم أو صفحة، والنمطَ الذي تأخذه :ref حين لا تحدد نمطًا. يحمل كل قالب {n} حيث يوضع الرقم؛ والقالب الذي يخلو منه يأتي الرقم بعده مسبوقًا بمسافة غير قابلة للكسر ("§" يطبع § 3.2). والقالب غير المعيَّن يتبع لغة المستند: chapter / section / p. بالإنجليزية، وcapítulo / sección / pág. بالإسبانية، و第{n}章 / 第{n}节 / 第{n}页 بالصينية، وهكذا للفرنسية والألمانية والإيطالية والبرتغالية والكتالونية والهولندية.

interface CrossRefsConfig {
  chapter?: string;  // Words around a level-1 heading's number: "chapter {n}".
  section?: string;  // Around any other heading's number: "section {n}".
  page?: string;     // Around a page number: "p. {n}".
  defaultStyle?: 'default' | 'number' | 'title' | 'page'; // A :ref without style=.
}

تأخذ الإحالات لون كل إحالة ووزن خطها وميلها (bodyText.referenceColor، referenceBold، referenceItalic).

#الاستشهادات

تختار الخاصية citations نمط الاستشهاد وطريقة ظهور الاستشهادات وقائمة المراجع. الترميز موصوف في الاستشهادات والمراجع؛ ويطبّق النمطَ الحزمةُ postext-citeproc.

interface CitationsConfig {
  style?: string;          // 'apa', 'ieee', 'chicago-notes-bibliography'… or 'custom'
  customStyle?: string;    // a whole CSL style (.csl XML), used with style: 'custom'
  locale?: string;         // CSL locale; the document language when unset
  link?: boolean;          // citations link to their entries
  marker?: 'style' | 'brackets' | 'parentheses' | 'superscript' | 'corner';
  collapseRanges?: boolean;
  notes?: 'footnote' | 'warichu';
  bibliography?: {
    title?: string;        // unset: the document language's word; '' or ' ': none
    scope?: 'book' | 'chapter';
    auto?: boolean;
    fontSize?: Dimension;
    lineHeight?: Dimension;
    hangingIndent?: Dimension;
    entrySpacing?: Dimension;
    labelWidth?: Dimension;
    labelAlign?: 'left' | 'right';
    doi?: 'link' | 'text' | 'hide';
    includeUncited?: boolean;
    groupByLanguage?: boolean;
  };
}