الإعدادات: الأنماط والأجزاء

#أنماط الفقرات

تعلن الخاصية paragraphStyles أنماطًا مسمّاة يطبّقها المستند على مجموعة من الفقرات بحاوية :::paragraphs{style="…"}: المراجع، ومسارد المصطلحات، والملاحظات، وأي كتلة من المدخلات تحتاج إلى خطها ووزنها وميلها وحجمها وتباعد أسطرها وحروفها الكبيرة أو حروفها الكبيرة المصغّرة (small caps) أو إزاحتها المعلّقة (hanging indent) الخاصة. وكل حقل طباعي اختياري ويرث نص المتن حين لا يُحدَّد، فلا يذكر النمط إلا ما يختلف عن النص الجاري.

const config: PostextConfig = {
  paragraphStyles: [
    {
      id: 'bibliography',
      name: 'Bibliography',
      fontSize: { value: 7, unit: 'pt' },
      lineHeight: { value: 1.2, unit: 'em' },
      hangingIndent: { value: 2, unit: 'em' },
      spaceBetween: { value: 0.25, unit: 'em' },
      marginTop: { value: 1, unit: 'em' },
      marginBottom: { value: 1, unit: 'em' },
    },
  ],
};

## References
 
:::paragraphs{style="bibliography"}
Knuth, D. E. (1984). *The TeXbook*. Addison-Wesley.
 
Bringhurst, R. (2004). *The Elements of Typographic Style*. Hartley & Marks.
:::

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

paragraphStyles: [
  { id: 'direction', italic: true, fontSize: { value: 9, unit: 'pt' } },
  { id: 'cast', smallCaps: true, textAlign: 'center', fontWeight: 600 },
],

:::paragraphs{style="direction"}
Elsinore. A platform before the castle. *Francisco* at his post.
:::

تُطبع الإرشادات بخط مائل والاسم الذي داخلها قائمًا؛ وتسري الأوزان وitalic وsmallCaps الخاصة بالنمط داخل الإطارات أيضًا.

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

paragraphStyles: [
  { id: 'verse', textAlign: 'left', firstLineIndent: { value: 0, unit: 'em' }, hangingIndent: { value: 4, unit: 'em' } },
  { id: 'verse-indented', textAlign: 'left', indent: { value: 1.5, unit: 'em' }, hangingIndent: { value: 2.5, unit: 'em' } },
],

يبدأ السطر في verse-indented عند 1.5 em وسطره المرحَّل عند 4 em، على مستوى الأسطر المرحَّلة في verse. ومن دون indent يستطيع النمط أن يُزيح السطر الأول أو أن يعلّق الأسطر الأخرى، لا الاثنين معًا: تُتجاهل firstLineIndent متى حُدّدت hangingIndent.

تضع قائمة الطعام كل سعر ملاصقًا لنهاية عرض السطر، وراء خط إرشاد من النقاط:

paragraphStyles: [
  {
    id: 'menu',
    textAlign: 'left',
    firstLineIndent: { value: 0, unit: 'em' },
    tabStops: [{ position: 'end', align: 'end', leader: '. ' }],
  },
],

:::paragraphs{style="menu"}
شوربة البصل :tab 8.50
 
دنيس مشوي بالشمر والليمون :tab 21.00
:::

تنتهي نقاط كل سطر قبل السعر بنصف em (leaderGap). والطبق الذي يطول عن سطره يلتفّ، ويحتفظ سطره الأخير بخط الإرشاد والسعر؛ وحين لا يتّسع السعر بجانب الكلمة الأخيرة تنزل تلك الكلمة معه.

#الحاوية :::paragraphs

يفتح السطر :::paragraphs{style="<id>"} الحاوية ويغلقها سطر ::: وحده؛ وكل فقرة بينهما تأخذ النمط المسمّى، بينما تحتفظ العناوين والقوائم والكتل الأخرى داخلها بتنسيقها المعتاد. ويمكن أن تتداخل الحاويات داخل حاويات مسوّرة أخرى. ومعرّف style المجهول ليس خطأً: تُرسم الفقرات نصَّ متنٍ عاديًا.

ويقبل السور أيضًا align (start، end، left، right، center، justify) وindent وendIndent (والأعداد المجرّدة بوحدة em)، مع نمط أو دونه: مع النمط تتجاوزه، ودونه تُطبَّق فوق نمط الحاوية المحيطة، أو فوق نمط النص حيث يقع السور (المتن، أو الجزء، أو القسم ذو النمط، أو الإطار). ويضع :::paragraphs{align=end} كتلة ملاصقة لنهاية السطر (地付き)، و:::paragraphs{align=end endIndent=1} كتلة مرفوعة عنها حرفًا واحدًا. منذ postext 1.16.

داخل الحاوية يغادر التدفق شبكة خطوط الأساس، فالمدخل بحجم 7pt وتباعد أسطر 1.2em لا يمكن أن يستقر على شبكة 8pt/1.5em، ثم تعيد الفقرة الأخيرة التدفق إليها (الشبكة هي الغالبة؛ والمسافة تحتها حدٌّ أدنى، وهو العرف الذي تتبعه العناوين). وتنقسم المدخلات عبر الأعمدة والصفحات كفقرات المتن، مع الحماية نفسها من الأسطر اليتيمة (orphans) والأرامل (widows)؛ والعنوان الذي يسبق الحاوية مباشرة يبقى مع فقرتها الأولى.

المسافة تحت الحاوية هي الأكبر بين spaceBetween وmarginBottom الخاصتين بالنمط وتباعد الفقرات في النص المحيط (سطر واحد حين يكون bodyText.paragraphSpacing مفعّلًا)، وتندمج مع المسافة التي تحتفظ بها الكتلة التالية فوقها، كما تفعل المسافة بين فقرتين من المتن: فالعنوان بعد قائمة المراجع يقع تحت المدخل الأخير بمقدار marginTop الخاص به (أو بمسافة النمط حين تكون أكبر)، والفقرة بعد مجموعة من المدخلات الأضيق تحتفظ بتباعد فقرات النص. يعود التدفق إلى الشبكة تحت النص أولًا، وما لم تغطّه المحاذاة يُنقل في أسطر شبكة كاملة، فيقع النص بعد الحاوية على الشبكة. وحتى postext 1.4 كانت مسافة النمط توضع تحت السطر الأخير قبل المحاذاة، وتُضاف تحتها مسافة الكتلة التالية العليا، ويُهمَل تباعد الفقرات؛ والقيمة bodyText.paragraphContainerSpacing: 'add' تحتفظ بتلك القاعدة، والإعدادات المحفوظة قبلها تُقرأ بها. والنمط ذو snapToGrid: false لا يعود إلى الشبكة: يقع النص بعد الحاوية تحتها بالمسافة الدقيقة، خارج الشبكة حتى الكتلة التالية التي تُحاذى عليها. والحاوية التي تنتهي بقائمة تُنضَّد كما في 1.4 في كلتا القاعدتين: تحتفظ القائمة بمسافتها تحتها، وتتبع marginBottom تلك المسافة، مندمجةً مع مسافة الكتلة التالية.

داخل :::callout تأخذ الحاوية هوامش نمطها على النحو نفسه: تندمج marginTop وmarginBottom مع تباعد الكتل المحيطة بها (والقيمة السالبة تقرّبها)، والحاوية التي يبدأ بها الإطار لا تأخذ هامشًا علويًا، كما في رأس العمود. ولا شبكة خطوط أساس في الإطار يُعاد إليها، فالمسافة تحت الفقرة الأخيرة هي الأكبر بين marginBottom وspaceBetween وتباعد الفقرات الخاص بالإطار (body.paragraphSpacing الخاص به، أي سطر من نصه؛ ويُهمَل مع paragraphContainerSpacing: 'add')، أو الهامش العلوي للكتلة التالية حين يكون أكبر منها كلها؛ والقيمة السالبة لـ marginBottom ترفع الكتلة التالية بدلًا من ذلك. (حتى postext 1.4 كانت الحاوية داخل الإطار تتجاهل الهامشين.)

const resolved = resolveParagraphStylesConfig(config.paragraphStyles, resolvedBodyText);
// => every unset field filled from the resolved body text
 
const minimal  = stripParagraphStylesDefaults(config.paragraphStyles);
// => undefined when the list is empty; zero margins and `name === id` dropped

#أنماط الشارات

تعلن الخاصية chipStyles الأنماط المسمّاة للشارة (chip) المضمّنة :chip[text]{style="…"}، أي المربعات الملوّنة المستديرة الزوايا لبنك كلمات أو مفتاح لوحة مفاتيح أو وسم (الصيغة وقواعد كسر الأسطر الخاصة بها في مرجع صيغة المستند). يأتي نمط واحد، chip، افتراضيًا (تعبئة زرقاء شاحبة مع خط شعري باللون الرئيسي، زوايا مستديرة قليلًا، والنص كالكلمات المحيطة به)، فتعمل :chip[…] دون أي إعداد؛ وإعلان chipStyles يستبدل تلك القائمة الافتراضية. والشارة التي بلا style، أو بمعرّف لا يعلنه أي نمط، تأخذ النمط الأول.

const config: PostextConfig = {
  chipStyles: [
    { id: 'chip', name: 'Word bank' },
    {
      id: 'key',
      name: 'Keyboard key',
      background: { hex: '#fff4d6', model: 'hex' },
      borderColor: { hex: '#8a6d1f', model: 'hex' },
      borderRadius: { value: 2, unit: 'pt' },
      bold: true,
    },
  ],
};

Classify: :chip[battery] :chip[cable] :chip[switch]
 
Press :chip[Ctrl]{style="key"} + :chip[C]{style="key"}.

أطوال المربع بوحدة em (paddingX، paddingY، borderRadius، borderWidth، gap) نسبية إلى حجم خط الشارة نفسها. المربع شريط يمتد 0.8 em فوق خط الأساس و0.25 em تحته، يكبر بمقدار paddingY والخط المحيط؛ ويُرسم خارج مربع السطر ولا يغيّر تباعد الأسطر أبدًا، فتبقى شبكة خطوط الأساس سليمة. وحين يصير المربع أطول من خطوة السطر، يمكن أن تصطدم الشارة بشارة في السطر الذي فوقها أو تحتها، فيُدرج Sandbox تحذير «الشارات تلامس السطر التالي» حين تتداخل شارتان في سطرين مختلفين، مع مقدار التداخل بالنقاط، لكي تُقلَّص paddingY أو الخط المحيط أو fontSize. ولا يُبلَّغ عن شارة طويلة ليس فوقها ولا تحتها شارة.

في الـ VDT الشارة مقطع سطر من kind: 'chip' يحمل حقله chip مقاطع النص (لكل منها سلسلة الخط وعرضها)، وهندسة المربع (boxWidth، ascent، descent، paddingX، borderWidth، borderRadius، وهوامش المسافة) وألوانه؛ وtext الخاص بالمقطع عنصر نائب من حرف واحد، فتعدّ إزاحات النص العادي وخرائط المصدر الشارةَ حرفًا واحدًا.

const resolved = resolveChipStylesConfig(config.chipStyles);
// => the built-in `chip` style when unset; every field filled
 
const minimal  = stripChipStylesDefaults(config.chipStyles);
// => undefined for the built-in default; static defaults dropped
 
const style = pickChipStyle(resolved, 'key');
// => the `key` style, else the first one

#قوائم الشيفرة

تضبط الخاصية codeStyle مظهر قوائم الشيفرة: أسوار ``` و~~~ في النص (انظر صيغة المستند › كتل الشيفرة)، والشيفرة المضمّنة حين يُطلب لها خط شيفرة. تُنضَّد القائمة سطرًا سطرًا كما كُتبت، بخط ثابت العرض، داخل إطار: لا يُقسَّم أي سطر بالواصلة ولا يُضبط، وتحتفظ كل مسافة بعرضها، وتتقدّم الجدولة إلى موضع الجدولة التالي. ويأتي الإطار من الآلية نفسها التي تُخرج :::callout، فتنقسم القائمة بين أسطرها عبر الأعمدة والصفحات، ولكل جزء إطاره، والسور داخل إطار هو إطار متداخل فيه. كل الخصائص اختيارية. منذ postext 1.23.

const config: PostextConfig = {
  codeStyle: {
    fontFamily: 'JetBrains Mono',
    fontSize: { value: 0.8, unit: 'em' },
    background: { hex: '#0e1116', model: 'hex' },
    color: { hex: '#d3d9df', model: 'hex' },
    padding: { top: { value: 4, unit: 'mm' }, right: { value: 5, unit: 'mm' }, bottom: { value: 4, unit: 'mm' }, left: { value: 5, unit: 'mm' } },
    borderRadius: { value: 2, unit: 'pt' },
    lineNumbers: true,
    tokens: {
      keyword: { color: { hex: '#f2b134', model: 'hex' }, bold: true },
      string: { color: { hex: '#3ddc84', model: 'hex' } },
      comment: { color: { hex: '#8a939d', model: 'hex' }, italic: true },
    },
    inline: { background: { hex: '#eef1f4', model: 'hex' } },
  },
};

#تلوين الصياغة

يسمّي مُقطِّع صغير مدمج في المحرّك رموزَ js وts (javascript وjsx وtypescript وtsx) وjson وpython وbash (sh وzsh وshell) وconsole (جلسة طرفية) وcss وhtml وxml (svg) وmarkdown وsql؛ أما القائمة بأي لغة أخرى، أو بلا لغة، فتُنضَّد بلون color. وهو يقرأ القائمة كلها، فالتعليق أو السلسلة النصية الممتدة على عدة أسطر تبقى رمزًا واحدًا. وفي قائمة console، السطر الذي يبدأ بموجّه أوامر ($ أو % أو # أو > أو >>> أو PS …> ) هو ما كتبه المستخدم (prompt)، وكل سطر آخر هو ما طبعته البرامج (output).

يستطيع التطبيق المضيف أن يركّب ملوّنه الخاص (Shiki أو Prism أو highlight.js) عبر registerCodeHighlighter. والإعدادات بيانات قابلة للتسلسل، فتُسجَّل الدالة لدى المحرّك ولا تُكتب في codeStyle:

import { registerCodeHighlighter } from 'postext';
 
// fn(code, lang) returns the listing's lines, each as runs whose texts join into the line.
registerCodeHighlighter('rust', (code) => code.split('\n').map((line) => [
  { text: line, token: line.trimStart().startsWith('//') ? 'comment' : undefined },
]));
registerCodeHighlighter('*', null); // remove the one registered for every language

الملوّن المسجَّل للغة ما يتقدّم على المسجَّل لـ'*'، وهذا يتقدّم على المُقطِّع المدمج. ويسمّي كل مقطع (run) نوعَ رمز في token (يلوّنه tokens) أو لونًا خاصًا به في color (قيمة CSS سداسية عشرية). ويُتجاوز الملوّن الذي يعيد undefined، أو يرمي استثناءً، أو يعيد أسطرًا لا تُكوِّن بضمّها أسطر القائمة نفسها. ويقرأ الإخراجُ السجلَّ حين ينضّد القائمة: سجّل الملوّن قبل البناء، وفي Web Worker (وSandbox يُخرج في واحد منها) سجّله داخل العامل نفسه.

#الشيفرة المضمّنة

يضبط codeStyle.inline النص الواقع بين علامتي الاقتباس المائلة بخط الشيفرة: وحدةً واحدة، كما الشارة، لا ينكسر السطر داخلها. وإن لم يُضبط احتفظت الشيفرة المضمّنة بخط النص.

#طريقة تنضيد القائمة

• سطر لكل سطر في المصدر. تُبنى الأسطر من مسافات التقدّم (advances) في خط الشيفرة نفسه، لا بمقسِّم أسطر الفقرة: تحتفظ المسافات بعرضها، وتُحفظ سلسلة المسافات كما هي، وتُزيح المسافات البادئة السطر. والقائمة في كتاب من اليمين إلى اليسار تُقرأ من اليسار إلى اليمين، وتُنضَّد أسطرها من الجهة البعيدة للإطار كما يُنضَّد اقتباس مكتوب من اليسار إلى اليمين، وأرقامها في الهامش على يسارها. وفي الكتاب العمودي تتبع القائمة التدفق العمودي (وتُدار حروفها اللاتينية على جنبها، كما يُنضّدها النص العمودي) ولا تأخذ أرقام أسطر.
• التقسيم. القائمة الأطول من المساحة المتبقية تنقسم بين أسطرها عبر الأعمدة والصفحات، ولكل جزء إطاره الخاص، ولا تترك أبدًا أقل من splitMinLines سطرًا على أي جانب؛ وتبقى بقية السطر المكسور معه ما دام قطع آخر يتسع.
• المخرجات. ترسم اللوحة (canvas) وعارض HTML وملف PDF الأسطر والإطار كما أُخرجت. ويحتفظ عارض HTML بالمسافات (white-space: pre)، فينسخ التحديد القائمة بإزاحتها وبفاصل سطر بعد كل سطر من المصدر، بلا أرقام ولا علامات تتمة. وينضّد ملف PDF الموسوم كل قائمة فقرةً تضم عنصر Code، بمحارف مسافة حقيقية، وأرقامها وعلامات تتمتها عناصر زخرفية. ويكتب EPUB القابل لإعادة التدفق <pre><code class="language-…"> بألوان الرموز وبورقة أنماط مأخوذة من codeStyle؛ أما EPUB ثابت التخطيط فهو نسخة الطباعة.
• الخطوط. يحمّل Sandbox وconfigFontFamilies خط الشيفرة حين يحتوي النص سورًا (أو حين يكون في الإعدادات قسم codeStyle)، بوزنيه العادي والعريض، قائمًا ومائلًا؛ ويضمّن ملف PDF الخطوط التي تستعملها الأسطر.

#أنماط الإطارات

تُعرِّف الخاصية calloutStyles أنماط الإطارات (callouts) المسمّاة التي يطبّقها المستند بالحاوية :::callout{type="…"}: الملاحظات والنصائح والتحذيرات وأهداف التعلّم، وكل محتوى يُفصل عن النص الجاري في إطار ملوّن الخلفية أو محاط بحدّ. يأتي افتراضيًا نمط محايد واحد هو note (خلفية رمادية فاتحة، بلا حدّ ولا شريط جانبي (stripe) ولا أيقونة ولا عنوان)، فتعمل :::callout دون أي إعداد؛ وتعريف calloutStyles يستبدل هذه القائمة الافتراضية.

const config: PostextConfig = {
  calloutStyles: [
    { id: 'note', name: 'Note' },
    {
      id: 'objectives',
      name: 'Learning objectives',
      title: 'Objectives',
      stripe: { enabled: true, side: 'left' },
      icon: { kind: 'glyph', glyph: '✓' },
      titleStyle: { textTransform: 'uppercase' },
      lists: { bulletChar: '–' },
    },
    {
      id: 'warning',
      title: 'Warning',
      backgroundEnabled: false,
      border: { enabled: true, color: { hex: '#AA0000', model: 'hex' }, width: { value: 1, unit: 'pt' } },
      borderRadius: { value: 1, unit: 'mm' },
      titleStyle: { color: { hex: '#AA0000', model: 'hex' } },
    },
  ],
};

:::callout{type="objectives"}
- Describe the parts of the lantern.
- Trim the wick at dusk.
:::
 
:::callout{type="warning" title="Do not touch the lens"}
The glass stays hot for an hour after the flame is out.
:::

#الحاوية :::callout

يفتح السطرُ :::callout{type="<id>"} الإطار، ويغلقه سطر فيه ::: وحدها. يقبل السياج خمس سمات: type (معرّف النمط)، وtitle (يتجاوز عنوان النمط)، وspan وplacement وcolumns (تتجاوز قيم النمط)؛ ويُخرَج المحتوى الواقع بينهما داخل الإطار: عنوان اختياري، ثم الفقرات أو القوائم أو الاقتباسات الكتلية أو الصيغ أو الموارد المضمّنة، وكلٌّ منها يُنضَّد بتنسيق body / lists من النمط (وتحتفظ العناوين بأنماطها المعتادة). تندمج الهوامش بين العناصر الأبناء كما في النص الجاري؛ ويخرج داخل الإطار عن شبكة خطوط الأساس، ثم يعود التدفق إليها بعد الإطار بمسافة لا تقل عن marginBottom تحته (الأولوية للشبكة، والهامش حدّ أدنى، وهو العرف نفسه الذي تتبعه الموارد). أما النمط ذو snapToGrid: false فيحتفظ بقيمة marginBottom الدقيقة بدلًا من ذلك، ويبقى النص الذي يلي الإطار خارج الشبكة حتى العنوان التالي أو نهاية القائمة. والعنوان الذي يسبق الإطار مباشرةً يبقى معه.

حدود هذا الإصدار:

• يُبقى الإطار كاملًا ما لم يحدّد نمطه keepTogether: false. فإن لم تتسع له المساحة المتبقية في العمود انتقل كاملًا إلى العمود أو الصفحة التالية، وكذلك يخرج من عمود فارغ قصّرته نطاقات العناصر العائمة أو حدّ أقصى للنطاق (band cap)، ما دام عمود كامل يتسع له. أما الإطار الأطول من عمود كامل فيُقسم بدلًا من ذلك، كالإطار القابل للتقسيم؛ ولا يوضع رغم ذلك ويفيض إلا الإطار الذي لا يقسمه أي قطع (شكل أو جدول أو مجموعة :::columns أطول من العمود، أو splitMinLines لا يحقّقه أي قطع)؛ وعندئذ يسجّل الإخراج تحذير calloutOverflow (VDTDocument.warnings) يعرضه Sandbox. والإطار القابل للتقسيم يترك الجزء الذي يتسع (عناصر أبناء كاملة، أو أسطر فقرة بما لا يقل عن splitMinLines على كل جانب، ويكفي الشكل أو الجدول أو الصيغة المنفصلة وحده لجانب) ثم يستمر في إطار بلا أيقونة في العمود أو الصفحة التالية، بلا عنوان ما لم يكرّره النمط، ومع علامة اختيارية تحت الجزء الذي يتركه (انظر علامات الإطار المقسوم).
• تُفسح العناصر العائمة المجال للإطار غير القابل للتقسيم. فحين تكون الكتلة التي تلي الإشارة إلى شكل مباشرةً إطارًا keepTogether، لا تُؤخذ الخانة التي لا تترك للإطار عمودًا من النطاق الحالي يستقر فيه (العمود الذي يحوي الإشارة أو عمود فارغ بعده، وكان يتسع له قبل العنصر العائم): ينتقل الشكل إلى خانته التالية، وهي عادةً الصفحة التالية، ويبقى الإطار في التدفق، كما يضعه المنضِّد، بدلًا من دفع الإطار خارج الصفحة وترك العمود للشكل وحده.
• في التخطيط متعدد الأعمدة يجعل span: 'page' الإطارَ كتلة ممتدة (span block): يُخرَج بكامل عرض المحتوى ويقسم الصفحة إلى نطاقات أعمدة، فتُغلق أعمدة النص فوقه عند خط القطع، ويأخذ الإطار عمودًا خاصًا به بكامل العرض، ويُفتح تحته نطاق جديد من أعمدة النص، فيستمر التدفق تحت الإطار في كل الأعمدة. وحيث تكون الأعمدة مستوية (في أعلى الصفحة، أو مباشرةً تحت عنوان افتتاحي span: 'page'، أو مباشرةً تحت كتلة ممتدة أخرى، أو مباشرةً تحت نطاق عائم علوي) يقطع الإطار هناك ببساطة. أما إذا ورد في منتصف الصفحة والأعمدة غير متساوية، فيُوضع كما يضعه المنضِّد: يُقطع النص فوقه قطعًا مستويًا عبر كل الأعمدة (يعيد المحرّك تنفيذ التوزيع وقد قُصّرت أعمدة النطاق إلى العدد نفسه من أسطر الشبكة، فيفيض النص من عمود إلى عمود على نحو طبيعي وتظل كل قواعد الأسطر اليتيمة والأرامل والإبقاء مع التالي سارية)، ويمتد الإطار على الصفحة، وتُستأنف الأعمدة تحته. ويتطلب القطع جولتين إضافيتين من التوزيع؛ وحين لا يترك خط القطع متسعًا للإطار مع الحدّ الأدنى لأسطر الأرملة من النص تحته، أو لا يتسع أي ترتيب بعد بضع محاولات، ينتقل الإطار إلى أعلى الصفحة التالية. ويلتزم النص فوقه بالقطع: الفقرة التي لا يمكن أن تبدأ في الأسطر القليلة التي يحتفظ بها عمود تحت شكل فوق القطع تنتقل إلى العمود التالي (فيقف الشكل وحده في عموده)، وحين تظل كتلة ما تتجاوز القطع، يُؤخذ القطع أدنى بسطر بدلًا من موضع انتهاء تلك الكتلة. والإطار المقسوم الذي يفتح النطاق يُقطع هناك أيضًا، فلا تتجاوز بقيته القطع أبدًا. ومع headings.balancing.beforeSpan (القيمة الافتراضية) يُقطع النطاق الذي يتركه خلفه قطعًا مستويًا، كالنطاق الذي يختم الفصل، وحين يسمح النمط بالتقسيم (keepTogether: false) يختم جزءُ الإطار الذي يتسع تحت الأعمدة المسوّاة الصفحةَ ويفتح الباقي الصفحة التالية؛ ومع beforeSpan: false تُوازن الصفحة التي يتركها كالمعتاد، دون فرض فاصل صفحة. والعنوان الذي يسبق الكتلة الممتدة مباشرةً لا ينتقل معها. وفي التخطيطات أحادية العمود يكون span: 'page' ببساطة داخل التدفق.
• placement: 'fixed' يُخرج الإطار من التدفق: يُخرَج الإطار (width: 'auto' يضيق على قدر العنوان، و'fill' يأخذ عرض عمود النص تحت نقطة الإرساء) ويُثبَّت في الصفحة التي يرد فيها ضمن التدفق، في الموضع الذي يصفه fixed.anchor / fixed.offset، وهو افتراضيًا الزاوية السفلية اليسرى من منطقة المحتوى. وتتخلى أعمدة النص التي يغطيها عن تلك المنطقة (تُقطع من الأسفل، أو من الأعلى إن كان العمود لا يزال فارغًا)، تمامًا كنطاق العناصر العائمة؛ وحين تكون المنطقة مشغولة بنص أو عنصر عائم أو كتلة ممتدة، ينتقل الإطار إلى الصفحة التالية. والإطار الثابت الذي يختم الفصل (أي تكون الكتلة التالية صفحة افتتاح فصل، أو :::part، أو إطارًا حاجزًا للعناصر العائمة، أو نهاية المستند) يسوّي أولًا الأعمدة فوقه (headings.balancing.trailing)، فتنتهي الصفحة الختامية القصيرة مستويةً مع الشارة تحتها. ويقع الإطار وأبناؤه في page.floats ويُرسمون خارج قصّ الأعمدة في كل مُخرِج.
• placement: 'top' | 'bottom' يعوّم الإطار كما يُعوَّم المورد: يغادر التدفق حيث يرد ويأخذ أول نطاق حرّ بعد تلك النقطة (قدم الصفحة الحالية مع 'bottom'، أو رأس الصفحة التالية التي يفتحها التدفق أو قدمها) بعرض العمود (span: 'column') أو بكامل عرض المحتوى (span: 'page')؛ ويملأ النص الذي يليه الصفحة التي غادرها. ويذهب إطاره وأبناؤه إلى page.floats، كما في الإطار الثابت. والإطار العائم الذي يتصدّر صفحة جديدة يوضع قبل الأشكال المنتظرة لتلك الصفحة، والشكل المذكور في صفحة سابقة الذي يتسع بعدئذ تحته يأخذ بقية تلك الصفحة حتى لو بقي أقل من ثلاثة أسطر نص (صفحة معرض: إطار وشكل، بلا نص بينهما). والإطار span: 'side' لا يطفو أبدًا: يتراصّ بجانب النص أيًّا كان موضعه. ومع columns أكبر من 1 (في النمط أو سمةً في السياج، منذ postext 1.18) يشغل الإطار span: 'column' هذا العدد من الأعمدة المتجاورة: رأس سلسلة من الأعمدة الفارغة التي تبدأ على مستوى واحد، أو أسفل العمود الحالي والأعمدة الفارغة التي تليه، كما في :::callout{placement="top" columns="2"}.
• width: 'auto' يضيق على قدر العنوان فقط، ويتجاهل العناصر الأبناء.
• :::callout المتداخل داخل إطار آخر إطار مستقل: يُخرَج بنمطه الخاص (الخلفية، والحدّ، ونصف قطر الزوايا، والحشوة، والشريط الجانبي، والعنوان، والأيقونة، والعلامة، واللسان، والتنسيق الطباعي) بكامل العرض الداخلي لأبيه ويتراصّ عنصرًا ابنًا واحدًا فيه، وتندمج marginTop / marginBottom الخاصة به مع جيرانه. ويُتجاهل span وplacement الخاصان به (من السياج أو من النمط)، فالإطار المتداخل يجري دائمًا داخل أبيه، ويُتجاهل كذلك floatBarrier وsnapToGrid. وتتداخل الإطارات إلى أي عمق، ويمكن أن تقع داخل مجموعة :::columns (كلٌّ منها كاملًا في عمود واحد). وحين ينقسم الأب، يقع القطع قبل الإطار المتداخل أو بعده، أو داخله إن سمح النمط المتداخل بالتقسيم؛ ويعيد كل جزء رسم الإطارات التي يقطعها، والإطار المتداخل المستمر من الجزء السابق يُسقط عنوانه وأيقونته، كتتمة الإطار في المستوى الأعلى.
• مجموعة :::columns{count=N} … ::: بين العناصر الأبناء تُخرج تلك العناصر في N أعمدة متساوية العرض، يفصل بينها columnGap، داخل الإطار: تُقطع السلسلة عند حدود الكتل أو الأسطر التي تسوّي الأعمدة على أفضل وجه (الفقرة أو عنصر القائمة المقطوع في منتصفه يستمر في رأس العمود التالي بلا نقطة تعداده)، ويبدأ كل عمود من أعلى المجموعة ويكون ارتفاع المجموعة بارتفاع أطول أعمدتها؛ وتعود العناصر التي تليها إلى كامل العرض. والإطار الذي ينقسم (keepTogether: false، أو الأطول من عمود) يقطع داخل المجموعة أيضًا، بين أعمدتها: فالمجموعة المتعرّجة (snake) تملأ أعمدتها واحدًا بعد آخر وتستمر في الجزء التالي، والمتوازية (breaks) تستمر تيارًا تيارًا (منذ postext 1.25؛ انظر صيغة المستند › :::columns). وتحلّ gap في السياج محلّ columnGap لتلك المجموعة، وترسم rule خطًا على طول كل فاصل بين الأعمدة. استخدمها لملخّص من عمودين للنقاط الرئيسية، أو لوضع جداول إطار عريض جنبًا إلى جنب.
• السمة السادسة للسياج، label، تُطبع على لسان التسمية في النمط (انظر label أعلاه): :::callout{type="box" label="BOX 1-1" title="The octet rule"}؛ ومن دون label في النمط تُتجاهل السمة.

في VDT يكون الإطار كتلة إطار type: 'callout' تقع زخرفته (الخلفية، والشريط الجانبي، والأيقونة، والعنوان) في designOverlay، تليها كتلها الأبناء في العمود نفسه؛ ويحمل الإطار وكل ابن containerId الخاص بالسياج. والإطار المتداخل كتلة إطار type: 'callout' مستقلة بين الأبناء، تليها كتلها؛ وهي تحتفظ بـcontainerId الخاص بسياج المستوى الأعلى (فيظل التوزيع والموازنة يريان وحدة واحدة) وتضيف calloutPath، أي معرّفات حاويات الأسيجة المتداخلة المحيطة بها، من الخارج إلى الداخل (ومعرّف الإطار المتداخل نفسه هو آخر مدخل). ويعطي ملف PDF الموسوم كل إطار متداخل عنصر Div داخل عنصر أبيه. وتُحلّ صور الأيقونات كما تُحلّ صور الموارد: سجل الصور في canvas، والخيار resourceImageUrl في HTML، ومزوّد resourceBytes في PDF.

const resolved = resolveCalloutStylesConfig(config.calloutStyles, resolvedBodyText, resolvedHeadings, resolvedUnorderedLists, config.locale);
// => every inherited field filled from the resolved sections; the optional
//    locale picks the language of the continuation strings
 
const minimal  = stripCalloutStylesDefaults(config.calloutStyles);
// => undefined for the built-in `note` default; static defaults dropped

#المبرهنات المرقّمة والبراهين

النمط الذي فيه numbering يعدّ إطاراته، كما تعدّ الحزمة amsthm في LaTeX بيئات المبرهنات (منذ postext 1.19). يطبع كل إطار تسميته ورقمه، «Theorem 2.» في أول فقرته الأولى، ويلي title السياج الرقمَ بين قوسين: يبدأ :::callout{type="theorem" title="Bradley–Terry"} بـ«Theorem 2 (Bradley–Terry).». والإطار الذي يُفتح بمعرّف ({#thm:main}) هدفٌ للإحالات، فتطبع «Theorem 2» (:ref{id="thm:main"})، ويطبع \ref{thm:main} أو style=number الرقم 2.

البرهان نمطٌ تسميته بلا رقم وله علامة ختام:

calloutStyles: [
  { id: 'theorem', numbering: { label: 'Theorem' }, body: { italic: true } },
  { id: 'lemma', numbering: { label: 'Lemma', counter: 'theorem' }, body: { italic: true } },
  { id: 'definition', numbering: { label: 'Definition' } },
  { id: 'proof', backgroundEnabled: false, endMark: '□',
    numbering: { label: 'Proof', counter: false, bold: false, italic: true } },
]

وفي كتاب يُخرَج فصلًا فصلًا تستمر العدّادات من الفصل السابق (LayoutContinuation.statementCounters، التي تملؤها continuationAfter)، ويعطي مخطّط الكتاب مرساة كل إطار مرقّم تسميتها (OutlineEntry.numberLabel)، فتطبعها الإحالة من فصل آخر.

#التنسيق الطباعي داخل الإطار

ينضّد الإطار محتواه بتنسيق body وlists الخاص به؛ وكل ما عدا ذلك يحتفظ بأنماط المستند:

• الفقرات تأخذ body الخاص بالإطار: الخط، والحجم، وتباعد الأسطر، واللون، وألوان التوكيد، والأوزان، وitalic، وsmallCaps، والمحاذاة، وتقسيم الكلمات بالواصلة، والإزاحة البادئة، والتباعد بين الفقرات. والحقل غير المُعيَّن يرث bodyText. ولون التوكيد الموروث يحتفظ بارتباطه بلوحة الألوان، فيتغيّر النص العريض والمائل وتسميات :ref داخل الإطار مع colorPalette كما تتغيّر خارجه. (حتى postext 1.4 كان النص العريض في الإطار يبقى #295AA3 أيًّا كان اللون الرئيسي.)
• القوائم النقطية تأخذ lists الخاص بالإطار (رمز التعداد، واللون، وحجم الرمز ووزنه، والإزاحة، والفاصل، والتباعد بين العناصر) فوق unorderedLists، ونصّها هو نص الإطار. وlists.bulletChar أو lists.color المختلف عن قيمة المستند (unorderedLists) يستبدل رمز التعداد أو اللون في كل المستويات؛ أما المكرِّر لقيمة المستند أو غير المُعيَّن فيترك لكل مستوى قيمته (unorderedLists.levels)، فتبقى الشرطات المتداخلة في الإطار.
• القوائم المرقّمة تأخذ lists.indent وgap وitemSpacing، وتأخذ lists.color متى حدّده النمط، حتى لو كان لون رموز التعداد في المستند؛ والنمط الذي لا يحدّده يُبقي الأرقام بلون orderedLists.color. (حتى postext 1.4 لم يكن اللون يصل إلى الأرقام إلا إذا اختلف عن unorderedLists.color، فلم يكن لتعيينه على ذلك اللون نفسه أي أثر.) أما الرقم نفسه (خطه وحجمه وفاصله) فيأتي من orderedLists العام، لأن lists لا يضم إلا حقول رموز التعداد: نسّق أرقام الإطار هناك.
• :::paragraphs داخل الإطار تستخدم نمط الفقرة الخاص بها، وكذلك في الإطارات المتداخلة. والحقول التي لا يحدّدها النمط ترث bodyText الخاص بالمستند، لا body الخاص بالإطار (ولا ميله ولا أحرفه الكبيرة الصغيرة).
• مجموعات :::columns لا نمط خاصًا بها: تتشارك الأعمدة كلها تنسيق نص الإطار وقوائمه، ويحدّد columnGap الفاصل بينها.
• الاقتباسات الكتلية تأخذ خط نص الإطار وحجمه وأوزانه (مائلة ورمادية، كما في النص الجاري)، وأحرفه الكبيرة الصغيرة. والعناوين تحتفظ بأنماط العناوين؛ والصيغ المنفصلة بإعدادات الرياضيات.
• الأشكال والجداول تحتفظ بأنماط التعليقات والجداول في المستند، بالعرض الداخلي للإطار؛ ويتبع وزناها العادي والعريض أوزانَ body في الإطار.
• الشارات (chips) تحتفظ بنمط الشارة الخاص بها؛ ويُقرأ حجم em نسبةً إلى حجم نص الإطار.
• :::space يُقاس بأسطر نص الإطار (انظر :::space لمعرفة المواضع التي يُسقط فيها).
• الإطار المتداخل يأخذ نمطه الخاص كاملًا؛ ويُتجاهل span وplacement وfloatBarrier وsnapToGrid الخاصة به.

#علامات الإطار المقسوم

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

• repeatTitle: true يكرّر العنوان في رأس كل تتمة، متبوعًا بـcontinuedSuffix، فيكون افتراضيًا «Key points (cont.)». ويأخذ العنوان المكرَّر نمط العنوان، فمع textTransform: 'uppercase' يعطي «HAMLET (CONT'D)» كما في السيناريو. وتبقى الأيقونة ولسان التسمية في الجزء الأول.
• continuesMarkerEnabled: true يضع continuesMarker («Continued»، أو «Continúa» في مستند إسباني) تحت السطر الأخير من كل جزء له تتمة، داخل الإطار، بخط نص الإطار وحجمه: مائلًا ما لم يكن continuesMarkerItalic مساويًا false، ومحاذيًا لليمين ما لم يحدّد continuesMarkerAlign القيمة 'left' أو 'center'. وتأخذ العلامة مساحة في الجزء الذي تختمه، ويُختار القطع بحيث تتسع لها.

calloutStyles: [{
  id: 'speech',
  keepTogether: false,
  titleStyle: { textTransform: 'uppercase' },
  repeatTitle: true,
  continuedSuffix: "(CONT'D)",
  continuesMarkerEnabled: true,
  continuesMarker: '(MORE)',
  continuesMarkerAlign: 'center',
  continuesMarkerItalic: false,
}],

:::callout{type="speech" title="Hamlet"}
A speech long enough to run over the foot of the page…
:::

ينتهي الجزء الذي يختم الصفحة بـ«(MORE)»، وتبدأ الصفحة التالية بـ«HAMLET (CONT'D)». وكلاهما من لوازم ترقيم الصفحات: في ملف PDF الميسَّر هما عنصران زخرفيان (artifacts)، وفي HTML يُخفيان عن التقنيات المساعدة، فيُقرأ العنوان مرة واحدة. وفي VDT هما كتلتا نص في designOverlay تحملان العلامة artifact: true.

#الأجزاء

تضبط الخاصية parts صفحات فواصل الأجزاء التي يفتحها المستند بالحاوية :::part{number="…" title="…"}، أي صفحة «الجزء الأول: الأسس» التي تجمع سلسلة من الفصول. ويشغل الجزء دائمًا صفحة خاصة به: تنتقل الحاوية إلى صفحة جديدة بالزوجية المضبوطة، وتحوّلها إلى صفحة أحادية العمود تأتي منطقة متنها من parts.margins، وتضع تصميم الافتتاح على الصفحة كلها، ثم تنتقل مجددًا بعد السياج الختامي فيبدأ الفصل التالي (بـbreakBefore.parity الخاص به) من صفحة نظيفة؛ ومع إعدادات H1 الافتراضية ينتج ذلك الترتيب التقليدي: صفحة الجزء فردية، تليها صفحة زوجية فارغة، ثم الفصل في الصفحة الفردية التالية.

const config: PostextConfig = {
  parts: {
    breakBefore: { parity: 'odd' },
    breakAfter: { enabled: true, parity: 'any' },
    margins: { top: { value: 9, unit: 'cm' }, left: { value: 3, unit: 'cm' }, right: { value: 3, unit: 'cm' } },
    design: {
      elements: [
        {
          kind: 'text', id: 'number', content: 'Part {numberRoman}',
          fontSize: { value: 12, unit: 'pt' }, fontWeight: 600, align: 'left',
          placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: { value: 3, unit: 'cm' }, y: { value: 5, unit: 'cm' } }, size: { width: 'auto', height: 'auto' } },
        },
        {
          kind: 'text', id: 'title', content: '{titleText}',
          fontSize: { value: 28, unit: 'pt' }, fontWeight: 700, align: 'left', overflow: 'wrap',
          placement: { anchor: { to: '#number', edge: 'below' }, size: { width: { value: 15, unit: 'cm' }, height: 'auto' } },
        },
      ],
    },
    bodyStyle: { fontSize: { value: 11, unit: 'pt' }, numberColor: { hex: '#AA0000', model: 'hex' } },
  },
};

:::part{number="I" title="Foundations"}
1. The lantern and its parts
2. Trimming the wick
3. Reading the weather
:::
 
# The lantern and its parts

#العناصر النائبة في تصميم الجزء

تحلّ خانة التصميم مجموعة العناصر النائبة (placeholders) الخاصة بالعناوين بقيم الجزء نفسه: {titleText} هو title السياج؛ و{number} هو number كما كُتب تمامًا؛ و{numberDecimal} و{numberRoman} و{numberRomanLower} و{numberAlpha} و{numberAlphaLower} تعيد تنسيقه: يُحلَّل الرقم على أنه عدد عشري أو رقم روماني أو أرقام صينية، مع الكلمات التي تحيط بها أو دونها ("IV" و"iv" و"4" و"４" و"四" و"卷四" و"第四卷" كلها تعطي {numberDecimal} = 4)، وتُحَلّ إلى '' في أي حالة أخرى. وتتوفّر أيضًا {partTitle} / {partNumber}، و{chapterTitle} / {chapterNumber} (الفصل الذي يسبق الجزء)، و{pageNumber}، و{totalPages}، و{bookTotalPages}، والعناصر النائبة للبيانات الوصفية. و{attr.<key>} يقرأ سمات H1 للفصل الحالي.

#تصميم الصفحة الزوجية

يزيّن versoDesign الصفحة التي تلي صفحة الجزء مباشرةً حين لا تحمل محتوى: ظهر الورقة الفاصلة. والجزء نفسه لا يترك تلك الصفحة فارغة أبدًا. فالقيمة الافتراضية لـbreakAfter.parity هي 'any'، لذا يبدأ المحتوى الذي يلي السياج في الصفحة التالية مباشرةً ما لم يطلب شيء زوجية محددة:

• عنوان الفصل التالي. قيمة breakBefore الافتراضية لـH1 هي 'always-odd'، و'odd' تفعل الشيء نفسه بعد صفحة جزء فردية: ينتقل الفصل إلى الصفحة الفردية التالية وتبقى الزوجية فارغة. فيُرسم تصميم الصفحة الزوجية.
• parts.breakAfter: { enabled: true, parity: 'odd' }. يطلب الجزء بنفسه الصفحة الفردية التالية، أيًّا كان ما يفعله العنوان التالي. استخدمه حين يمكن أن تبدأ الفصول في أي من الجانبين (breakBefore.parity: 'any'، أو breakBefore.enabled: false).

ومن دون أيٍّ منهما يبدأ الفصل في الصفحة الزوجية ولا يُرسم تصميمها. ومع breakAfter.enabled: false يستمر المحتوى في صفحة الجزء نفسها. وتأخذ الصفحة الزوجية لوحة ألوان الجزء، فالسمة palette="band=#…" في السياج تعيد تلوينها أيضًا.

parts: {
  breakBefore: { parity: 'odd' },
  breakAfter: { enabled: true, parity: 'odd' },   // always a blank verso to paint
  versoDesign: {
    elements: [{
      kind: 'box', id: 'field',
      style: { backgroundColor: { hex: '#b07d2b', model: 'hex', paletteId: 'band' } },
      placement: { anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: 'fill' } },
    }],
  },
}

جزء يختم فصله. في كتاب يُخرَج فصلًا فصلًا (Sandbox، وbuildBundle) يمكن أن يكون السياج :::part فصلًا قائمًا بذاته، أو نهاية فصل. فتكون صفحة الجزء عندئذ آخر صفحات الفصل، ويتولى الفصل التالي ما بقي على الجزء: يطبّق breakAfter قبل كتلته الأولى ويرسم versoDesign في صفحته الأولى حين تبقى فارغة. فتخرج الصفحات كما لو كان الكتاب كله في مستند واحد. ولا يجوز أن يلي السياج إلا التوجيهات التي لا تضع شيئًا (:::numbering، :::space)؛ وكل ما عداها محتوى من الفصل، فيأخذ الفاصل بنفسه. والفصل الفارغ الذي يلي الجزء مباشرةً صفحة قائمة بذاتها: وتلك الصفحة هي الزوجية. والمضيف الذي يُخرج الفصول بنفسه يحصل على ذلك من continuationAfter()، التي تُبلغ afterPartPage: true للفصل الذي ينتهي بجزء؛ مرّرها في continuation الخاص بالفصل التالي.

#الحاوية :::part

يفتح السطر :::part{number="…" title="…"} الجزء، ويغلقه ::: وحدها؛ والسمتان اختياريتان (قيمتهما الافتراضية ''). تجري الكتل الواقعة بينهما (قائمة الفصول عادةً) في العمود الوحيد لصفحة الجزء بتنسيق bodyStyle، بدءًا من margins.top؛ والمتن الأطول من الصفحة يستمر في صفحات عادية. وتُصنَّف الصفحة role: 'part' (ويحمل VDTPage.partInfo الرقم والعنوان)، فيمكن لعناصر الترويسة والتذييل أن تستهدفها أو تتخطاها بـpages: 'part' / pages: 'body'؛ ويضيف مُخرِج PDF الجزء إلى المخطط (outline) فوق فصوله. والمتن الفارغ (:::part{…} يليه ::: مباشرةً) هو الحالة الشائعة، وهو ينتج الصفحة مع ذلك، فالأجزاء المتتالية لا تتشارك صفحة أبدًا. و:::part المتداخل في جزء آخر يُدمج في الجزء الخارجي.

وتعطي سمة ثالثة، palette="<id>=<hex>[, <id>=<hex>…]"، الجزءَ ألوانه الخاصة: في صفحة الجزء وفي كل صفحة تليها حتى الجزء التالي، يأخذ كل لون تصميم (الترويسة، والتذييل، ونطاق الافتتاح، وتصميما الجزء والصفحة الزوجية) مرتبط بأحد معرّفات لوحة الألوان هذه قيمةَ الجزء بدلًا من قيمة لوحة ألوان المستند. بهذا تعيد أقسام الكتاب تلوين لسان الزاوية ونقطة الترويسة ونطاق صفحة افتتاح الفصل دون تصميم ثانٍ: :::part{number="II" title="…" palette="band=#f6c297"}. ويتبعها تدفق النص أيضًا: في الصفحات نفسها، كل لون في التدفق يساوي القيمة الأساسية لمدخل متجاوَز في لوحة الألوان يأخذ قيمة الجزء، وذلك في ألوان العناوين والنص العريض والمائل والإحالات، ورموز التعداد وأرقام القوائم، وتسميات التعليقات وأشرطتها، ونص الجداول وخطوطها وتعبئاتها (الرأس، والمتن، والصفوف المتناوبة، وتعبئة الخلية الخاصة)، وإطارات callout (الخلفية، والحدّ، والشريط الجانبي، والعنوان)، والشارات (التعبئة، والحدّ الخارجي، والنص)؛ فالخاصية headings.levels[1].color المرتبطة بـband تجعل عناوين كل قسم بلونه الخاص. وتحتفظ عيّنات الألوان المضمّنة باللون المكتوب فيها. وتُفصل الأزواج بفواصل أو فواصل منقوطة أو مسافات، ويربط = أو : بين المعرّف واللون، و# اختيارية. ويظل الجزء ساريًا بعد إغلاق سياجه: يتبع {partTitle} و{partNumber} ولوحة الألوان التدفقَ إلى الفصول التي تليه، ومن خلال continuation.part الذي تُبلغ عنه continuationAfter() إلى الفصول التي تُخرَج منفردة، فيُظهر الفصل الثاني من القسم القسمَ في ترويساته تمامًا كما يفعل الأول.

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

• ألوان نص الكتلة: لون النص، وألوان النص العريض والمائل والإحالات، وعلامة القائمة (رمز تعداد أو رقم) والفاصل الذي يلي الرقم. فإذا كان bodyText.color مرتبطًا بـink وbodyText.boldColor مرتبطًا بـaccent، وكلاهما #1a1a1a، فإن الجزء ذا palette="accent=#b8413d" يعيد تلوين المقاطع العريضة ويترك النص؛ وإذا كان unorderedLists.color هو المرتبط بـaccent، فإنه يعيد تلوين رموز التعداد ويترك نص العناصر؛
• كل مستوى من مستويات العناوين، وكل نمط عنوان يحدّد لونًا؛
• نص صف المحتويات، ورقمه، ورقم صفحته وعنوانه الفرعي؛
• في كل نمط إطار: التعبئات (الخلفية، والشريط الجانبي، ولسان التسمية)، والحدّ، والخطوط (خط العلامة وخط التسمية)، والنص (العنوان، والأيقونة، ورمز العلامة، والتسمية)؛
• كل لون في كل نمط جدول وشارة وتعليق. ونمط الجدول المسمّى منفصل عن tableStyle، ونمط تعليق نوع المورد منفصل عن captionStyle. وتعبئة الخلية الخاصة تتبع ارتباطها الخاص.

تبقى حالة واحدة تُحسم بالقيمة: إعدادات في أماكن مختلفة تحدّد اللون نفسه لكتلة ما. فـbodyText.color وbodyText.blockquote.color وcolor في نمط الفقرة وbody.color في نمط الإطار كلها تحدّد لون نص الكتلة، مثلًا. وحين يرتبط اثنان منها بمدخلين يتشاركان قيمة أساسية ويفرّق الجزء بينهما، يأخذ اللون القيمة المتجاوِزة (وآخرهما كتابةً إن تُجووز كلاهما). أعطِ هذه المدخلات قيمًا أساسية خاصة بها.

const resolved = resolvePartsConfig(config.parts, resolvedPage, resolvedBodyText, resolvedUnorderedLists, resolvedOrderedLists);
// => margins filled from the page, bodyStyle from the body / list configs
 
const minimal = stripPartsDefaults(config.parts);
// => undefined when only static defaults remain

#أنماط العناوين

تُعرِّف الخاصية headingStyles أنماطًا مسمّاة يطبّقها المستند على عنوان بالصيغة # Title {style="<id>"}. ويفعل النمط أمرين. فهو يتجاوز تنسيق مستوى العنوان وتصميمه وترقيمه، أي كل حقل من مدخل المستوى ما عدا level (الخط، والحجم، واللون، وbreakBefore، وspan، وadvancedDesign، وtextTransform، وhidden، وnumberingTemplate…)، ويحكم القسم الذي يفتحه العنوان: تأخذ صفحاته، حتى العنوان التالي من المستوى نفسه أو مستوى أعلى، ترويسات النمط وهندسة صفحاته وتنسيق متنه ولوحة ألوانه. بهذا تقع الصفحات التمهيدية للكتاب (تمهيد في عمود عريض واحد بأرقام صفحات رومانية ونطاقات زرقاء) في دليل من عمودين مرقّم بأرقام عشرية، دون إعداد ثانٍ.

const config: PostextConfig = {
  headingStyles: [
    {
      id: 'front-matter',
      numbered: false,
      breakBefore: { enabled: true, parity: 'odd' },
      span: 'page',
      advancedDesign: { enabled: true, minHeight: { value: 52, unit: 'mm' }, slot: { elements: [/* bands, `{titleText}` */] } },
      header: { elements: [/* folio | rule | `{title}. {subtitle}` */] },
      margins: { left: { value: 50, unit: 'mm' }, right: { value: 17, unit: 'mm' } },
      layout: { layoutType: 'single' },
      bodyStyle: { fontSize: { value: 10.5, unit: 'pt' }, textAlign: 'justify' },
      palette: { band: '#547396' },
    },
  ],
};

# Preface {style="front-matter"}

يُغلق القسم عند العنوان التالي من المستوى نفسه أو مستوى أعلى: العنوان # غير المنسَّق بعد عنوان منسَّق يعيد ترويسات المستند وهندسته؛ والعنوان المنسَّق يفتح قسمه الخاص. والصفحات التي تركها القسم فارغة لأجل الزوجية تتبعه، كما تتبع عناوينَ الفصول.

فاصل الصفحة لا يحلّ محلّ فاصل العنوان نفسه. يرث النمط breakBefore الخاص بمستواه (القيمة الافتراضية للمستوى الأول { enabled: true, parity: 'always-odd' })، ويطبّقه العنوان أينما وقع، حتى بعد :::pagebreak مباشرةً. يفتح فاصل الصفحة صفحة جديدة، ثم يظل العنوان يطلب جهته من الصفحتين المتقابلتين. مع parity: 'odd'، الفاصل الذي يقع على صفحة زوجية تليه صفحة فارغة، فيبدأ العنوان في الصفحة الفردية التالية. ومع 'always-odd' تأتي الصفحة الفارغة الفاصلة أيضًا، ولا يغيّر فاصل الصفحة شيئًا، لأن العنوان كان سيفتح تلك الصفحة على أي حال. والنمط الذي يُراد أن يبدأ في الصفحة التي يفتحها فاصل يدوي، كصفحة المحتويات بعد صفحة العنوان، يعطّل فاصله الخاص:

headingStyles: [
  // Starts where the text puts it: on the page the `:::pagebreak` before it opened.
  { id: 'contents', numbered: false, toc: false, breakBefore: { enabled: false } },
],

ولإبقاء صفحة خاصة به دون اختيار جهة، اضبط breakBefore: { parity: 'any' } بدلًا من ذلك واحذف :::pagebreak.

إلى أي قسم تنتمي الصفحة. تُختار الترويسات ولوحة الألوان لكل صفحة، لا لكل عنوان. وتأخذ الصفحة القسم الساري بعد آخر تغيير للقسم فيها: حيث ينتهي قسم ويبدأ آخر في الصفحة نفسها (حرفان قصيران من معجم، مثلًا) تحمل الصفحة ترويسات الثاني ولوحة ألوانه؛ وحيث ينتهي قسم منسَّق في منتصف الصفحة عند عنوان غير منسَّق، تعود الصفحة إلى قيم المستند. و{chapterTitle} يتبع القاعدة نفسها: الصفحة التي يلتقي فيها فصلان تُظهر عنوان الأخير منهما. والصفحات الفارغة تتبع قاعدة عناوين الفصول: الصفحة الفارغة لأجل الزوجية (blankForParity) تتبع القسم الذي يُفتح بعدها، والصفحة الفاصلة التي يضيفها فاصل 'always-odd' / 'always-even' (blankForForce) تتبع القسم الذي قبلها. وفاصل الجزء يُغلق القسم المفتوح.

# A {style="letter"}
 
Aardvark, abacus.
 
# B {style="letter"}
 
Babble, badger… (runs on to the next page)

يبدأ الحرفان كلاهما في الصفحة 1، فتأخذ الصفحة 1 ترويسات القسم B: لسان الإبهام (thumb tab) المضبوط في ترويسة النمط يقرأ «B» هناك، ولا تحمل أي صفحة لسان «A». أعطِ كل قسم صفحة خاصة به (breakBefore) حين يحتاج كلٌّ منها إلى لسانه. ملاحق مرقّمة بالحروف بعد فصول مرقّمة بالأرقام، وصفحة إهداء تُدرجها المحتويات والعلامات المرجعية في PDF لكن الصفحة نفسها لا تحمل عنوانها:

headingStyles: [
  { id: 'appendix', numberingTemplate: 'Appendix {1:A}' },
  { id: 'silent', hidden: true, numbered: false },
],

# Dedication {style="silent"}
 
For M., who read every draft.
 
# Method
 
…
 
# Survey instrument {style="appendix" startAt=1}
 
# Raw data {style="appendix"}

مع numberingTemplate: '{1}.' في المستوى الأول تطبع الفصول 1. و2.…، والملاحق Appendix A وAppendix B. ويفتح الإهداء صفحته (بـbreakBefore الخاص بمستواه)، ولا يطبع إلا فقرته، ويظهر مع ذلك باسم Dedication في :::toc وفي ترويسات {chapterTitle} وفي مخطط PDF؛ أضف toc: false إلى النمط لإخراجه من المحتويات. واللوحة المصوّرة أو الخريطة المنضَّدة كعنوان H1 في منتصف فصل تحتاج عكس ما يحتاجه الإهداء: النمط ذو runningChapter: false (عادةً مع numbered: false وtoc: false) يُبقي الترويسات على الفصل الذي تقطعه.

const resolved = resolveHeadingStylesConfig(config.headingStyles, resolvedPage, resolvedBodyText, resolvedUnorderedLists, resolvedOrderedLists);
// => level overrides normalised, margins filled from the page, bodyStyle from the body
 
const minimal = stripHeadingStylesDefaults(config.headingStyles);
// => undefined when no style remains