الإعدادات: رؤوس الصفحات وتذييلاتها

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

تتحكّم الخاصيتان 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 يتبع الموضع. في تصميم العنوان وصفحة الجزء يلتف العنوان الطويل على أسطر أكثر؛ وفي ترويسة الصفحة والترقيم وسطر الجزء في الفهرس يُقتطع النص الأعرض من مساحته إلى سطر واحد بـ…. اضبط overflow: 'wrap' على ترويسة قد تطول (عنوان بريدي، سطر مؤلف)، وراجع تنبيهات designTextTruncated للنصوص المقتطعة. فاصل الأسطر في المحتوى (سطر جديد، أو \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 عند الإدخال ويُعاد كتابته تموضعًا وقت حسم الإعدادات، فتظل الإعدادات القائمة تعمل دون تغيير.