الفصل 5.4 · الجزء II · الحرفة
صيغة المستند: الصور والجداول
الموارد في النص: الإحالة إليها وتضمينها، وترقيمها، وموضعها ومكان استقرار العنصر العائم، والتفاف النص حولها، ومقاس الصورة النقطية، والمناطق الآمنة، ونقاط الارتكاز في القصص المصورة، والرموز في التعليقات
باختصار
تتناول هذه الصفحة صور الكتاب وجداوله. تضيفها مرة واحدة وتذكرها في النص، فيضع Postext كلًّا منها قرب الموضع الذي ذُكر فيه أول مرة. ويمكنك أن تختار مكانها: أعلى الصفحة، أو بعرض كل الأعمدة، أو في الموضع الذي كُتبت فيه بالضبط. ويمكن أن يلتف النص حول الصورة. ويمكن أن تحدد في الصورة الجزء الذي يجب أن يظهر دائمًا حين تُقصّ لتناسب مكانها. وتوضع مقاطع الفيديو بالطريقة نفسها، وتتناولها الصفحة التالية.
#الموارد
لا تُكتب الصور ورسوم SVG والجداول ومقاطع الفيديو داخل النص. تُعرَّف مرة واحدة بوصفها موارد (تديرها لوحة الموارد في Sandbox، وفيها رفع الصور وملفات SVG، ومحرّر جداول تفاعلي، ومقاطع يوتيوب وفيميو والفيديو المرفوع، وتحرير التعليقات والمواضع)، ثم تُربط بنصّك عبر معرّفها. تكفي الإحالة إلى المورد لإدراجه: تذكره مرة واحدة بإحالة داخل السطر :ref{id="…"}، فيجعل المحرّك الشكل أو الجدول يطفو إلى أول موضع شاغر بعد تلك الإحالة، كأسفل العمود الذي ذكرته فيه، أو أعلى العمود التالي، أو شريط في الصفحة التالية، كما يفعل المنضّد في المطبعة. ولا تضعه مرة ثانية.
الصيغتان أدناه صياغة جديدة كليًا لا تتعارض مع CommonMark، فيبقى المستند الذي يستعملهما مقروءًا نصًا عاديًا في أي عارض Markdown آخر.
#الإحالة داخل السطر (الصيغة الأساسية)
أحِل إلى مورد من داخل النص بالصيغة :ref{id="…"}. الإحالة الأولى تُدرج المورد (فيوضع في الصفحة) وتعرض رقمه المحسوب في آن واحد، مسبوقًا افتراضيًا بالتسمية المختصرة لنوعه:
As shown in :ref{id="lighthouse-diagram"}, the lantern room sits above the gallery.وتظهر هكذا: As shown in Fig. 1.7, the lantern room sits above the gallery. ويطفو الرسم نفسه إلى أقرب موضع شاغر بعد الجملة (أسفل هذا العمود، أو أعلى العمود التالي، أو شريط في الصفحة التالية)، بينما تتدفق هذه الجملة والنص الذي يليها دون انقطاع.
لا ينقطع النص الجاري أبدًا عند نقطة الإحالة. أما المكان الذي يستقر فيه المورد (أول موضع شاغر، أو موضع علوي أو سفلي فقط؛ داخل عمود واحد أو بعرض الصفحة كله) فيحكمه موضعه (انظر الموضع أدناه)، ويحكمه كذلك المكان الذي تذكره فيه: يبدأ البحث مباشرة بعد الإحالة.
#التضمين في كتلة (اختياري، لوضع صريح داخل التدفق)
قد تريد أحيانًا أن يقع المورد في نقطة محددة من التدفق بدل أن يطفو. ألغِ طفوه بإعطاء المورد placement.position: "here" وتضمينه بالصيغة ::resource{id="…"} في سطر مستقل:
Here is the floor plan we discussed.
::resource{id="lighthouse-diagram"}
The keeper's quarters occupy the eastern wing.لا حاجة إلى التوجيه ::resource مع مورد عائم، فقد وضعته :ref من قبل، ويُعامل ::resource الزائد للمعرّف نفسه إحالةً أخرى ببساطة، لا نسخة ثانية. ولا يعرض ::resource المورد داخل التدفق إلا إذا كان موضعه النهائي "here". ويحتفظ المورد المضمّن بمسافة سطر فوقه (فجوة العنصر العائم) كما يفعل العنصر العائم، ما لم تطلب الكتلة التي قبله أكثر من ذلك. وفي النص الجاري يحتفظ بالمسافة نفسها تحته؛ ثم يعود النص الذي يليه إلى شبكة خطوط الأساس، وقد يضيف ذلك ما يصل إلى سطر آخر. وإذا تلاه مباشرة عنوان أو قائمة أو إطار أو مورد مضمّن آخر، تقاسمت تلك المسافة مع المسافة التي فوقه: يُطبَّق الأكبر منهما، لا كلاهما. (حتى postext 1.4 لم تكن المسافة تحته سوى ما يتركه الالتصاق بالشبكة، من لا شيء إلى سطر كامل؛ ويحافظ layout.inlineResourceGap: 'above' على تلك القاعدة، وتُقرأ بها الكتب المحفوظة قبل 1.5.) وداخل الإطار (:::callout) يحتفظ المورد بالمسافة نفسها، أي سطر من نص الإطار نفسه فوقه، وتحته أيضًا مع 'around'؛ وفي أعلى الإطار أو أسفله تفصله الحشوة بدلًا من ذلك. (حتى postext 1.4 كان يلتصق بنص الإطار مباشرة؛ ويحافظ layout.inlineResourceGapInBoxes: false على ذلك، وتُقرأ به الكتب المحفوظة قبل 1.5 التي تضمّن إطاراتها موردًا.) المورد "here" الذي يستشهد به النص بـ:ref ولا يضمّنه أي ::resource ليس في أي صفحة: ينبّه الإخراج إليه (hereNotEmbedded) عند أول إحالة إليه.
وفي التخطيط متعدد الأعمدة، يمتد المورد المضمّن الذي يذكر موضعه أيضًا span: 'page' (placement: { position: 'here', span: 'page' }) على عرض الصفحة عند موضع توجيهه، كما يفعل الإطار الممتد على الصفحة: تُغلق الأعمدة التي فوقه على ارتفاع واحد (بموازنتها، أو ينتقل المورد إلى رأس الصفحة التالية إن تعذّر ذلك)، ويُنضَّد بعرض منطقة المحتوى كله مع المسافة نفسها فوقه وتحته، ويستمر النص في كل الأعمدة تحته. وفي صفحة ذات عمود واحد يُنضَّد كما كان من قبل، بعرض السطر كاملًا. أما المورد ذو span: 'column' مع columns فيبقى في عموده حين يُضمَّن في التدفق: فالأعمدة لا تُحتسب إلا للعناصر العائمة. منذ postext 1.19.
يجب أن يطابق id موردًا معرّفًا في لوحة الموارد. يرسم المحرّك المورد (صورة نقطية أو SVG أو جدول) وتعليقه تحته ذيلًا للشكل أو الجدول. ويتألف نص التعليق من captionPrefix لنوع المورد، والرقم المحسوب، والتعليق الخاص بالمورد، مثل Figure 1.7. The original lighthouse plan. وتحكم تنسيقه الإعدادات › نمط التعليق: تتشارك التسمية والوصف خطًا واحدًا وحجمًا واحدًا، بينما تحتفظ التسمية بإعدادات مستقلة للعريض والمائل واللون؛ والفجوة فوق التعليق 0.75em افتراضيًا، والمحاذاة إلى اليسار. ويمكن أن يقع التعليق فوق المورد بدلًا من ذلك (captionStyle.position: 'above'، على مستوى المستند أو لكل نوع مورد)، على شريط ملوّن إن شئت. ويمكن أن تكون للمورد أيضًا ملاحظة (note)، وهي سطر قصير للمصدر أو الحقوق، بالتنسيق داخل السطر نفسه وعلامات :ref نفسها التي في التعليق، يُنضَّد بحجم أصغر تحت المورد (تحت التعليق حين يكون التعليق أسفله، وتحت جسم المورد حين يكون التعليق أعلاه) وينسَّق عبر captionStyle.note.
فواصل الأسطر في التعليقات والملاحظات. التعليق أو الملاحظة فقرة واحدة تُنضَّد بعرض موضعها، والسطر الجديد المكتوب فيها مسافة. لبدء سطر جديد، اكتب \\، وهو الفاصل الإجباري في العناوين، أو أنهِ السطر بشرطة مائلة عكسية، وهي الفاصل الصلب في Markdown: ¹ Measured at 20 °C. \\ ² Mean of three runs. تضع كل حاشية من حواشي جدول عريض في سطر مستقل. يحتفظ السطر الذي يسبق الفاصل بعرضه الطبيعي ولا يُمدَّد إلى عرض السطر، ولا يُنتج فاصلان متتاليان سطرًا فارغًا (أما مسافة غير فاصلة بينهما فتُنتجه). وفي خلية الجدول يفعل \\ ما يفعله السطر الجديد: يفتح فقرة جديدة؛ وتُحفظ إزاحة السطر الذي يليه، فتظل مسافتان في أوله تُدرجان بند القائمة في مستوى أعمق. وفي النص نفسه تكون الشرطتان المائلتان العكسيتان فاصلًا دائمًا، ولا سبيل إلى تهريبهما: لطباعتهما، ضعهما في شيفرة داخل السطر، حيث تُطبع الشرطات المائلة العكسية كما كُتبت. وفي وجهة الرابط تبقيان جزءًا من عنوان URL، وفي سمات التوجيه (text في :ref) جزءًا من القيمة؛ وداخل الشارة (chip)، التي تُنضَّد في سطر واحد، يكون الفاصل مسافة. (حتى postext 1.4 كانت الشرطتان تُطبعان، ولم يكن التعليق أو الملاحظة ينكسر إلا حيث ينتهي عرض السطر.)
ترسم موارد الجداول شبكتها الخاصة، وتُنسَّق عبر الإعدادات › نمط الجدول: لخلايا المتن وخلايا الترويسة تنسيق مستقل تمامًا، وخلفية الترويسة #f0f0f0 افتراضيًا، والحدود 0.75pt، وcellPadding قيمته 0.375em؛ وكل حقل لم يُضبط يرث من نص المتن. عروض الأعمدة جزء من الجدول نفسه: في TableModel.columnWidths وزن نسبي واحد لكل عمود ([2, 1, 1] يمنح العمود الأول نصف العرض)؛ وإذا لم يُضبط، تقاسمت الأعمدة العرض بالتساوي. ويمكن أيضًا تنضيد الجدول بنمط مسمّى: يختار table.styleId واحدًا من tableStyles في المستند (انظر الإعدادات › أنماط الجداول المسمّاة)، وترث حقوله غير المضبوطة من tableStyle؛ والمعرّف المجهول أو الغائب يُبقي على tableStyle.
تضع الخلية محتواها بالخاصية TableCell.align (left، center، right؛ وتبقى بنود القوائم محاذية لليسار) والخاصية TableCell.verticalAlign (top، وهي الافتراضية، أو middle أو bottom). تنقل المحاذاة العمودية محتوى الخلية كله، أي الصورة والنص الذي تحتها بوصفهما وحدة واحدة، داخل خلية أطول منه: صف مدّته خلية مجاورة أطول، أو الصفوف التي يغطيها rowSpan. وتسري في كل المخرجات (Canvas وHTML وPDF)، وفي الجداول المدوّرة، وفي كل شريحة من جدول مقسوم على عدة صفحات. ويُضبط كلاهما لكل خلية من أزرار المحاذاة في شريط أدوات محرّر الجداول في Sandbox.
ويمكن أن تحتوي خلية الجدول صورة أيضًا. يحدّد TableCell.image موردًا من نوع صورة نقطية أو SVG بمعرّفه ({ "resourceId": "fig-arm", "width": 0.7 }): تُرسم الصورة داخل الخلية، دون ترقيم أو طفو أو تعليق، بحيث تلائم العرض الداخلي للخلية (أو الكسر منه الذي يحدده width، وقيمته الافتراضية 1) مع الحفاظ على نسبة أبعادها، وتُحاذى كما يُحاذى نص الخلية، ويجري أي نص في الخلية تحتها. ويزداد ارتفاع الصف ليتسع لها. وفي محرّر الجداول في Sandbox يختار زر الصورة في شريط الأدوات المورد للخلية النشطة، ويضبط حقل العرض الكسر. والمعرّف الذي لا يطابق أي مورد صورة يترك الخلية نصية فقط.
ويمكن أن تكون للخلية تعبئتها الخاصة. TableCell.background قيمة لون ({ "hex": "#c1dfd6", "model": "hex" }، ويمكن ربطها بمدخل في لوحة ألوان المستند عبر paletteId) تُطلى بدل خلفية الترويسة أو المتن في النمط؛ وبهذه الطريقة تظلّل مصفوفة التوافق خلاياها بالأخضر والأحمر والأصفر. ويضبطها محرّر الجداول في Sandbox من أداة التعبئة في شريط الأدوات. ولشرح دلالة هذه التعبئات، يقبل التعليق والملاحظة وأي كتلة نصية عيّنة لون داخل السطر: :swatch{color="#c1dfd6"} (قيمة hex، أو معرّف مدخل في لوحة الألوان، مثل :swatch{color="table-compatible"}) تضع مربعًا صغيرًا على خط الأساس، بثلاثة أرباع حجم الخط، مملوءًا باللون ومحاطًا بحدّ بلون النص، فيمكن أن تقرأ الملاحظة :swatch{color="ok"}: compatible; :swatch{color="no"}: incompatible. واللون الذي لا يُعرف يرسم مربعًا فارغًا بحدّه وحده. ويمكن أن تتضمّن قيمة hex قناة شفافية (#rrggbbaa، #rgba)، وتعمل ألوان rgb() / rgba() أيضًا، فيكون لتعبئة الخلية الشفافة مفتاح شفاف مطابق (انظر الإعدادات › الشفافية).
تضع مفاتيح الخريطة مربّعاتها بحجم خاص بها، بإطار وزوايا مستديرة، مع فسحة قبل التسمية: :swatch{color="farmland" size=10pt border="0.75pt ink" radius=2pt gap=3pt}Farmland. size ضلع المربّع (الافتراضي 0.75 em)؛ وborder إما none وإما عرض ولون بأي ترتيب (1pt #333، ink 0.5pt)، ويضبط borderWidth وborderColor كلًّا منهما وحده ويتقدّمان على border (الافتراضي إطار بعرض 6% من الضلع بلون النص)؛ وradius يدوّر الزوايا حتى الدائرة؛ وgap يضيف فسحة بعد المربّع تُحسب منه، فتأتي التسمية بعده بلا مسافة (وتكون الفسحة على يساره في النص من اليمين إلى اليسار). تقبل الأطوال pt وpx وmm وcm وin وem وrem (والرقم وحده بالنقاط؛ وem حجم النص المحيط)، ولون الإطار رمز سداسي عشري أو معرّف في لوحة الألوان مثل color. لا يتغيّر ارتفاع السطر. ترسم اللوحة وعارض HTML وPDF وEPUB المربّع نفسه (منذ postext 1.52).
ويمكن كذلك إعادة تلوين موارد SVG للطباعة بلون موضعي واحد عبر diagramStyle.singleInk (القيمة الافتراضية false). عند تفعيله، يُعاد تعيين كل لون في رسم SVG إلى درجة من diagramStyle.inkColor بحسب نصوعه (وقيمته الافتراضية لون لوحة الألوان الرئيسي، #295AA3)، فيصير الأبيض لون الورق والأسود الحبر كاملًا، فتُطبع الأشكال بأمانة حين يُطبع المستند بلون موضعي واحد. انظر الإعدادات › نمط الرسوم التخطيطية.
التضمين المعيب (id مفقود أو فارغ، أو id غير محاط بعلامتي تنصيص أو محاط بعلامتي تنصيص مفردتين، أو سمات زائدة غير slot الخاصة بالصفحة المركّبة) لا يُرقّى إلى كتلة مورد؛ بل يُحلَّل فقرةً عادية ويبقى ظاهرًا في المخرجات. وكذلك سطر التضمين السليم الملتصق تحت سطر فقرة دون سطر فارغ بينهما: يُقرأ جزءًا من تلك الفقرة. ويظهر في الحالتين التحذير malformedEmbed، وهو المدخل تضمين نُضِّد نصًا في لوحة الفحوص في Sandbox.
تُتعرَّف الإحالات داخل السطر في أي كتلة نصية، أي الفقرات والعناوين والاقتباسات الكتلية وبنود القوائم، ويمكن أن تجاور العريض والمائل والشيفرة داخل السطر والرياضيات داخل السطر.
خيارات الإحالة
يقبل التوجيه :ref ثلاث سمات اختيارية، بأي ترتيب. تختار style طريقة عرض التسمية المحسوبة: style="number" يطبع الرقم مجردًا (1.7)، وstyle="full" يطبع الاسم الكامل للنوع مع الرقم (Figure 1.7)، وإذا لم تُضبط style استُعملت shortLabel للنوع مع الرقم (Fig. 1.7). وتغيّر case حالة الحروف في جزء التسمية وحده، lower أو upper أو capitalize، ولا تمسّ الرقم. أما text فتجاوزٌ حرفي يحل محل أي تسمية محسوبة وله الأسبقية على style وcase كلتيهما. خيارات العرض جنبًا إلى جنب:
| الصياغة | الناتج | ملاحظات |
|---|---|---|
:ref{id="…"} | Fig. 1.7 | النمط الافتراضي: shortLabel للنوع يليها الرقم، تصل بينهما مسافة غير فاصلة (أو labelNumberGap في نمط التعليق) فلا ينفصلان أبدًا عند انكسار السطر. |
:ref{id="…" style="number"} | 1.7 | الرقم المحسوب مجردًا، دون تسمية. |
:ref{id="…" style="full"} | Figure 1.7 | الاسم الكامل للنوع name يليه الرقم. استعمله في بداية الجملة أو حيث يبدو الاختصار ركيكًا. |
:ref{id="…" case="lower"} | fig. 1.7 | يغيّر حالة حروف التسمية وحدها: lower (fig. 1.7)، أو upper (FIG. 1.7)، أو capitalize (الحرف الأول كبير). ويجتمع مع style="full" (figure 1.7)؛ ولا يُمسّ الرقم أبدًا، وتُتجاهل القيمة غير المعروفة. |
:ref{id="…" text="see the plan"} | see the plan | تجاوز صريح. يُستعمل النص المعطى حرفيًا بدل أي تسمية محسوبة، وهو مفيد للروابط داخل النص مثل «كما رأينا سابقًا». وعند وجود text تكون له الأسبقية على style وcase. |
إذا ذكرت :ref (أو ::resource) معرّفًا لا يطابقه أي مورد، تعود التسمية إلى ? (وتُطبع تسمية text= بدلًا منها، دون رقم أو رابط أيضًا) ويُصدر Sandbox التحذير مورد غير معروف. ويسجّله المحرّك مدخلًا من نوع unknownResourceId في contentWarnings الخاصة بالمستند، مع نطاق الإحالة في المصدر وصفحتها، وكذلك لإحالة :ref داخل تعليق أو ملاحظة أو خلية جدول لمورد يستعمله النص.
#الترقيم بحسب الإحالة الأولى
يُسند رقم المورد أول مرة يُذكر فيها بترتيب القراءة، سواء أكان هذا الذكر الأول تضمينًا في كتلة ::resource أم إحالة داخل السطر :ref. ومن ثَمّ تطبع كل إحالة إلى المعرّف نفسه الرقم نفسه.
أي أن الأرقام تتبع ترتيب لقاء القارئ بالموارد، لا ترتيب إنشائها في اللوحة:
- إذا أحلت إلى شكل بـ
:refفي المقدمة ولم تضمّنه (::resource) إلا بعد صفحتين، أخذ مع ذلك رقم المقدمة، لأن الإحالة جاءت أولًا. - إدراج إحالة جديدة في موضع أسبق من المستند يعيد ترقيم كل ما بعدها تلقائيًا. فلا ترقيم يدوي تحتاج إلى مزامنته.
الترقيم خاص بكل نوع مورد، ويراعي نطاق إعادة الضبط وصيغة العدّاد لكل نوع؛ انظر الإعدادات › أنواع الموارد لرموز القالب ({h1}، {n})، وresetOn، وcounterFormat.
لا يُعدّ إلا ما يحيل إليه النص: المورد الذي لا يرسمه إلا التصميم (عنصر صورة في صفحة افتتاح الفصل مثلًا) لا يأخذ رقمًا ويترك العدّاد على حاله. ويعدّ {h1} كل عنوان من المستوى 1 لا يكون نمطه numbered: false، حتى لو كان numberingTemplate فيه فارغًا، فالمقالة التي عنوانها هو عنوانها الوحيد من المستوى الأول ترقّم أشكالها 1.1، 1.2… افتراضيًا. وفي الإعدادات › ما الذي يُرقَّم القاعدتان كلتاهما والإعدادات اللازمة لـFigure 1، 2….
#الموضع
لكل مورد موضع (placement) يحدد أين يستقر عنصره العائم، ويُحدَّد لكل مورد على حدة (من placement الخاص به)، ثم من defaultPlacement لنوعه، ثم من القيمة الافتراضية المدمجة auto / column:
| الحقل | القيم | المعنى |
|---|---|---|
position | "auto" · "top" · "bottom" · "here" · "paragraph" | "auto" (القيمة الافتراضية) يأخذ أول موضع شاغر بعد الإحالة، علويًا كان أو سفليًا؛ و"top" / "bottom" لا يقبلان إلا مواضع من ذلك النوع؛ و"here" يلغي الطفو ويضمّن المورد داخل التدفق عند التوجيه ::resource (والجدول الموضوع هناك يُقطع بين الصفوف حين لا يتسع له ما بقي من عموده، انظر الجداول الأطول من الصفحة). "paragraph" يُدرج المورد في النص أيضًا، دون سطر ::resource، مباشرة بعد الفقرة التي تحيل إليه أول مرة بـ :ref. فإن وقعت الإحالة في أي موضع داخل إطار (:::callout) أو مجموعة :::paragraphs / :::columns، وُضع المورد بعد أبعد تلك الحاويات إلى الخارج، عائدًا إلى التدفق الرئيسي (وفي إطار داخل إطار، بعد الإطار الخارجي)؛ وإن وقعت في عنوان، فبعد الفقرة التي يفتتحها ذلك العنوان (لا بين عنوان ونصه أبدًا: بعد القائمة التي تليه إن وُجدت، متجاوزًا العناوين الفرعية التي تليه مباشرة)؛ وإن وقعت في بند قائمة، فبعد نهاية القائمة؛ وإن استمرت الفقرة بعد معادلة منفصلة، فبعد ذلك الاستمرار. والموردان اللذان تحيل إليهما فقرة واحدة يأتيان كلاهما بعدها، بترتيب الإحالة. ولا تُحتسب الإحالة الواردة في حاشية (ولا في تعليقات نهاية الفصل)، لأن الحاشية تُصفّ بمعزل عن التدفق: فالمورد الذي لا تحيل إليه إلا الحواشي، ولا يضعه أي سطر ::resource، ولم يضعه فصل سابق، ليس في أي صفحة، ويُبلّغ عنه الإخراج (paragraphCitedInNote) عند أول إحالة إليه في حاشية. والمورد الذي تكون أول إحالة إليه سطرَ ::resource الخاص به يُصفّ هناك كما يفعل "here"؛ وأسطر ::resource اللاحقة له مجرد إحالات. وفيما عدا ذلك يُصفّ تمامًا كما يُصفّ "here" موضوعًا بعد تلك الفقرة، بما في ذلك التفاف النص، والتعليق في العمود الجانبي، والتعليق داخل خانته، وقطع span: 'page' للشريط. ولا يُدار أبدًا، ولا يكون لوحة (plate) أبدًا، ولا يُصغَّر ليتسع في موضع أبدًا. |
width, align | 0 < width < 1; "left" · "center" · "right"; طول بالملّيمتر أو السنتيمتر أو البوصة أو النقطة | مورد أضيق من موضعه: width هو الكسر الذي يشغله من عرض العمود (أو الصفحة)، وalign مكانه داخل الموضع (جدول صغير في وسط عموده؛ شريط بعرض الصفحة تمتد صورته على عمود واحد). والصورة الأضيق من موضعها، كصورة نقطية أصغر من العمود أو صورة صغّرها layout.fitFiguresToPage، تقع هناك أيضًا بحسب align، تحت تعليق يحتفظ بعرض الموضع. يسري ذلك على العناصر العائمة وعلى تضمينات ::resource داخل التدفق على السواء. وطولٌ بدل الكسر ({ "value": 80, "unit": "mm" }، أو بـcm أو in أو pt) يجعل عرضه بهذا القدر، مقيسًا على الحيّز الذي يوضع فيه: العمود للمُدرَج، والأعمدة والفواصل التي يشغلها العائم العمودي، وعرض منطقة النص للعائم الممتد على الصفحة، والعمود الجانبي للعائم الجانبي، وأعمدة القسم ذي النمط أو الصندوق حين يقع فيهما. والطول المساوي للحيّز أو الأعرض منه يشغل الحيّز كلّه، والعائم المُدار يُصفّ بهذا العرض على الأكثر قبل تدويره. ولا تُقرأ الوحدات الأخرى (px، em) طولًا: يشغل المورد حيّزه كلّه. |
plate | true · false · "content" · "trim" · "bleed" | لوحة بصفحة كاملة: توضع الصورة (نقطية أو SVG أو ملصق فيديو) وحدها على صفحة جديدة بعد الإحالة إليها، مكبّرة أو مصغّرة إلى أكبر حجم تتّسع له منطقة النص مع تعليقها وملاحظتها، في الوسط ما لم يقل align غير ذلك؛ ويستمر النص قبلها وبعدها. وتنتظر صفحة تشغلها كلّها: تُتخطّى الصفحة التي فيها افتتاحية أو عائم آخر أو نص جارٍ، ثلاث صفحات على الأكثر، ثم تؤخذ التالية كما هي. ولا تُقرأ position وspan وwidth وshrink وrotate وcaptionSide وwrap وcitingPage، والصورة الموضوعة في النص ("here") ليست لوحة. وfalse على مورد يُلغي اللوحة التي يضعها نوعه. وينبّه الفحص قبل الطباعة إلى الصورة النقطية المكبّرة دون أدنى دقة للصورة (lowImageResolution)، مع احتساب القصّ. و"trim" أو "bleed" تضعانها على الصفحة كلّها، حتى حدّ القصّ أو إلى النزف (مع خطوط القصّ؛ ومن دونها يكون النزف هو حدّ القصّ): تُكبَّر حتى تغطّيها وتُقصّ حول مركزها، ويبقى تعليقها وملاحظتها أسفل منطقة النص على شريط بلون الورق. وتأخذ تلك الصفحة الدور 'plate': لا تُطبع عليها الترويسات ولا رقم الصفحة ولا عناصر التصميم إلا ما يسمّي هذا الدور في pages. ويثبّتها تصدير IDML في النص بحجم منطقة النص، ويضعها تصدير Word على صفحة خاصة بها. |
captionSide | true · false | في تخطيط العمود ونصف الذي يُخصَّص فيه العمود الجانبي للعناصر العائمة (layout.)، يُبقي العنصر العائم من نوع "column" ذو captionSide جسمه في العمود الرئيسي، ويُنضّد تعليقه (وملاحظته) في العمود الجانبي، محاذيًا لأعلى الشكل، أو لأسفله في العنصر العائم السفلي؛ ويتنازل العمود الجانبي عن ذلك الشريط. والصفحة التي ليس فيها هذا العمود تُبقي التعليق تحت الشكل. ومنذ postext 1.28 يأخذه أيضًا المورد الموضوع في النص ("here") بعرض عمود واحد: يُنضّد تعليقه وملاحظته في العمود الجانبي، بمحاذاة أعلى جسمه، ويكون ارتفاع الكتلة في النص ارتفاع الجسم وحده، وتتجنب الأشكال والإطارات الجانبية الموضوعة بعده هذا التعليق. وحيث يكون العمود الجانبي مشغولًا بجوار المورد يبقى التعليق تحت الجسم؛ والمورد الذي ينتقل إلى العمود التالي أو الصفحة التالية يُقرَّر أمره هناك من جديد. ولا يسري داخل إطار، ولا في صفحة عمودية، ولا على صورة يلتف النص حولها. وlayout. يقصر التعليقات الجانبية على العناصر العائمة بعرض العمود. |
span | "column" · "page" | يشغل عمودًا واحدًا، أو يقطع تدفق الأعمدة ويمتد بعرض المحتوى كاملًا عبر كل الأعمدة. وفي التخطيط ذي العمود الواحد تتطابق القيمتان. |
columns | عدد صحيح، الافتراضي 1 | في صفحة ذات أعمدة عدة، يمدّ العنصر العائم "column" على هذا العدد من الأعمدة المتجاورة، مع الفواصل بينها: صورة تمتد على عمودين من أعمدة الجريدة الخمسة. ويأخذ رأس سلسلة من الأعمدة الفارغة التي تبدأ على مستوى واحد، أو أسفل العمود الذي يشير إليه والأعمدة الفارغة التي تليه. وإذا بلغ عدد الأعمدة عدد أعمدة الصفحة أو زاد عليه صار عنصرًا عائمًا بعرض الصفحة. ويُتجاهل مع span بالقيمتين "page" و"side"، ومع المورد المدوَّر، ومع التضمين داخل التدفق ("here")؛ ولا يسري captionSide إلا على عنصر عائم بعرض عمود واحد. منذ postext 1.18. |
rotate | "ccw" · "cw" | يُنضّد المورد مُدارًا ربع دورة، كجدول أفقي في كتاب عمودي. "ccw" يديره عكس عقارب الساعة، فيواجه أعلاه الحافة اليسرى للصفحة (ويدير القارئ الكتاب مع عقارب الساعة)، وهو العُرف المعتاد؛ و"cw" في الاتجاه الآخر. المورد المُدار عنصر عائم بعرض الصفحة دائمًا في صفحة مستقلة: يُخرَج على امتداد ارتفاع منطقة المحتوى، مقرَّبًا إلى الأدنى إلى أسطر كاملة من شبكة خطوط الأساس وناقصًا سطرًا واحدًا من المتن، وهو فجوة العنصر العائم التي يحتفظ بها كل شريط عائم (منطقة نص ارتفاعها 237 mm على شبكة 14 pt تسع 47 سطرًا، أي 232.1 mm، فيأخذ المورد 46 منها، أي 227.2 mm)، ويلتصق بالكعب حين تكون الهوامش متناظرة (وبالحافة اليسرى في غير ذلك)، والجدول الأعرض من صفحة واحدة يُقطع بين الصفوف ويُستأنف، مُدارًا، في الصفحات التالية مع تكرار ترويسته، تمامًا كالجدول القائم الأطول من صفحة. ويُصغَّر الشكل المُدار ليلائم الصفحة. ويُتجاهل هذا الحقل في التضمين داخل التدفق ("here"). |
shrink، minScale | "never" · "page" · "slot"؛ 0 < minScale ≤ 1، الافتراضي 0.7 | يصغّر صورة عائمة (صورة نقطية، SVG، ملصق فيديو)، مع حفظ نِسَبها، إلى الحيّز المتاح في موضع بدل نقلها إلى ما بعده. "never" (الافتراضي) ينضّدها بحجمها. "page" يصغّرها فقط حين تكون أطول من شريط صفحة جديدة: مساحة المحتوى ناقص ما يشغل تلك الصفحة أصلًا (افتتاحية، أشكال عائمة أخرى، حواشٍ) وفسحة العنصر العائم، كلوحة في فهرس معرض تُقاس على صفحتها. "slot" يصغّرها كذلك لتدخل موضعًا في الصفحة التي تحيل إليها، أو الحيّز الباقي بجانب شريط آخر، إن اتسعت هناك بمقياس minScale أو أكثر؛ وإلا انتقلت إلى ما بعده كما من قبل. وتُجرَّب المواضع بترتيبها المعتاد، ويبقى الشريط منتهيًا على شبكة خطوط الأساس. وتُقصّ الصورة ذات المنطقة الآمنة داخلها قبل تصغيرها (انظر المنطقة الآمنة). وفي صفحة جديدة، حيث لا مكان آخر تذهب إليه، تُنضَّد الصورة التي لا تتسع حتى بمقياس minScale بهذا المقياس وتتجاوز الشريط. ويُصدر التخطيط التحذير floatShrunk لكل عنصر عائم مصغَّر. ولا تُصغَّر أبدًا الجداول (فهي تُقسَّم)، ولا الإطارات العائمة، ولا شرائط القصص المصورة، ولا الموارد المدوَّرة، ولا التضمينات داخل التدفق. والقيمة الافتراضية للمستند هي layout.floatShrink. منذ postext 1.24. |
captionMeasure | "slot" · "body" | عرض أسطر التعليق والملاحظة لصورة أضيق من موضعها (مصغَّرة، أو صورة نقطية أصغر من العمود): "slot" (الافتراضي) يُبقي عرض الموضع؛ "body" ينضّدهما بعرض الصورة، تحتها بحسب align، فيقع تعليق اللوحة المتوسطة متوسطًا تحتها. للعناصر العائمة والتضمينات داخل التدفق على السواء. منذ postext 1.24. |
wrap, wrapGap | "none" · "left" · "right" · "start" · "end"; طول | يجري النص بجانب المورد: يوضع المورد في ذلك الجانب من عموده، وتُنضَّد الأسطر المجاورة له بالعرض المتبقي، على بُعد wrapGap من مستطيله (مع تعليقه)، ثم تعود إلى العرض الكامل تحته. ينطبق على الإدراج داخل النص ("here") وعلى عنصر عائم بعرض عمود واحد في أعلى عمود أو أسفله؛ أما العناصر العائمة بعرض الصفحة أو عبر عدة أعمدة أو في العمود الجانبي أو المُدارة فتحتفظ بشريطها. يأخذ المورد width من العمود، أو layout.wrap.defaultWidth (0.45). القيمة الافتراضية لـwrapGap هي layout.wrap.gap، وإلا فسطر واحد من المتن. أما "contour" فيجعل النص يلتف حول شكل الصورة نفسه بدل مستطيلها، والصورة في الجانب الذي تحدّده align (انظر الالتفاف حول المحيط). انظر التفاف النص. منذ postext 1.24. |
citingPage | true · false، والافتراضي false | يتيح للشكل العائم "top" أو "auto" أن يحتل رأس الصفحة (شكل عائم بعرض الصفحة) أو رأس العمود (شكل عائم بعرض العمود، ومنه ما يمتد عبر columns) حيث يقع السطر الذي يشير إليه أول مرة، كما يفعل الموضع t في LaTeX، بدلًا من أول موضع شاغر بعد ذلك السطر. وينزل النص الذي فوق الإحالة تحت الشكل. ولا يكون ذلك إلا إذا اتسع له المكان في حدود layout.maxTopFraction من العمود (0.7 افتراضيًا)، وكانت الأشكال السابقة من تسلسل ترقيمه قد وُضعت، ولم تبدأ الصفحة بفاصل صريح (الصفحة الأولى من فصل، أو جزء، أو :::pagebreak) ولم يكن فوق سطر الإحالة شيء بعرض الصفحة، وإذا بقي سطر الإحالة بعد هذا الوضع في تلك الصفحة (في عمود يتصدره الشكل)؛ وإلا أخذ الشكل موضعه المعتاد. ولا تنتقل بهذه الطريقة أبدًا الأشكال المدوّرة ولا أشكال العمود الجانبي ولا بقية جدول مقسوم بين الصفحات. الافتراضي: defaultPlacement للنوع، ثم layout.. منذ postext 1.25. |
pin | { page, column?, slot } | غير مستحسن (انظر وضع العناصر العائمة يدويا غير مستحسن). عنصر عائم وُضع يدويًا، في لوحة الموارد أو بتحريكه في لوحة Sandbox: يعدّ page الصفحات بدءًا من أول صفحة تحيل إليه (0 هي تلك الصفحة، و3 على الأكثر)، وcolumn عمود النص بدءًا من 0 بترتيب القراءة (أي عمود إن لم يُحدَّد؛ ويتجاهله العنصر الممتد بعرض الصفحة)، وslot هو "top" أو "bottom". التثبيت تفضيل لا أمر. ينتظر العنصر تلك الصفحة ويُعرض عليه ذلك الموضع أولًا؛ فإن لم يتسع له الموضع (أطول من المساحة الباقية، أو يشغله عنصر عائم آخر، أو يقع فوق الإحالة إليه) أخذ المواضع المعتادة في تلك الصفحة، ثم يمضي كأي عنصر عائم. ويُسقَط التثبيت الذي يشير إلى صفحة بعد نهاية الفصل عند تلك النهاية، فيُوضع العنصر والعناصر التي تليه في تسلسل ترقيمه قبل أن ينتهي الفصل. وتتجاهله عناصر العمود الجانبي العائمة والعناصر المُدارة واللوحات الكاملة والموارد الموضوعة في النص. ويُبلَّغ عن كل تثبيت لا يتبعه التنضيد بـfloatPinMissed مع سببه. في المخرجات المقسّمة إلى صفحات فقط. |
يذهب العنصر العائم إلى أول موضع شاغر بعد إحالته الأولى، بترتيب القراءة: أسفل العمود الذي تقع فيه الإحالة، ثم أعلى العمود الفارغ التالي في الصفحة نفسها وأسفله، ثم أشرطة الصفحة التالية التي يفتحها التدفق (العنصر العائم بعرض الصفحة يأخذ أسفل الصفحة حين يبقى في كل عمود متسع له، وإلا فشريطًا في الصفحة التالية). والصفحة التي يفتحها شكل أو جدول مضمّن داخل التدفق تُحتسب أيضًا: العنصر العائم الذي ينتظر تلك الصفحة يأخذ رأسها، فوق الشكل أو الجدول، حين يتسع لهما معًا؛ وإن لم يتسع، احتفظ الشكل أو الجدول بالصفحة وانتظر العنصر العائم الصفحة التالية. وحتى postext 1.4 كانت هذه الصفحة تُتخطّى، فينتظر العنصر العائم الصفحة التي بعدها حتى لو اتسعت لهما. ويُنضَّد العنصر العائم بحجمه ما لم يسمح له shrink بالتصغير إلى حيّز موضع (انظر الجدول أعلاه)، ولا يستقر أبدًا قبل إحالته. وتظهر العناصر العائمة من سلسلة ترقيم واحدة بترتيب إحالاتها: الشكل الذي لا يجد مكانًا في صفحة يؤخّر الأشكال التي خلفه (والجدول المنتظر لا يؤخّر شكلًا، ولا العكس)، فلا يظهر الشكل 12 أبدًا قبل الشكل 11. أما الجدول الذي كان سينتظر فيُقطع بدلًا من ذلك: إذا عُرض عليه رأس عمود فارغ، أخذ الصفوف التي تتسع واستُؤنف في الموضع التالي، العمود المجاور أو الصفحة التالية، مع تكرار صفوف ترويسته (انظر tableStyle.overflow). ويمكن للشكل العائم top أو auto الذي فُعّل فيه citingPage أن يتصدر بدلًا من ذلك الصفحة (أو العمود) حيث يقع سطر الإحالة، فينزل النص الذي فوق الإحالة تحته: يُرسم حينئذ فوق إحالته في الصفحة نفسها، ولا يكون أبدًا في صفحة سابقة، ويُقرأ بعدها في ملف PDF الموسوم وفي HTML. يحسم المحرك ذلك في بضع تمريرات إضافية، ولا يبقيه إلا ما دام سطر الإحالة في تلك الصفحة.
لا تخرج العناصر العائمة أبدًا من فصلها: عند صفحة افتتاح فصل (مستوى عنوان فيه breakBefore أو span: 'page')، وعند :::part، وعند نمط إطار فيه floatBarrier: true (إطار «النقاط الرئيسية» الذي يختم الفصل)، وفي نهاية المستند، يوضع أولًا كل عنصر عائم لا يزال معلّقًا، في المواضع الشاغرة من الصفحة أو في صفحات تُفتح قبل الحدّ. والعنصر العائم الذي يحيل إليه الافتتاح نفسه أولًا (عنوان فصل يذكر شكله)، أو الكتلة الأولى بعد :::part، ينتمي إلى الفصل الجديد: يستقر بعد ذلك السطر كأي عنصر آخر. وقد يأخذ عندئذ الشكل أو الجدول الذي طلب رأس صفحة أسفلَ الصفحة الختامية للفصل، تحت أعمدتها المتوازنة، بدل صفحة مستقلة. أما :::pagebreak فيرسل العناصر العائمة المعلّقة إلى الصفحة التي تليه ببساطة.
تحت افتتاح بعرض الصفحة مضبوط فوق عمودين من النص أو أكثر، يُعدّ عمود الافتتاح نفسه فارغًا عند رأسه ما دام لا شيء يتبع الافتتاح فيه: الإطار العائم الموضوع بعد الافتتاح مباشرة، أو المورد المضمَّن هناك بـ::resource، يأخذ رأس العمود الأول، تحت الافتتاح وعلى مستوى رؤوس الأعمدة الأخرى (وعلى عدة أعمدة ابتداءً منه مع columns)، ويبدأ نص العمود تحته. أما العنصر العائم المُحال إليه في النص فيبقى بعد السطر الذي يشير إليه. حتى postext 1.24 لم يكن العمود الأول يتيح هذا الموضع فكان العنصر العائم يقع ابتداءً من العمود الثاني؛ وlayout.floatsUnderOpener: false تُبقي على ذلك (انظر الإعدادات › التخطيط).
والإطارات الجانبية (span="side") لا تخرج من فصلها كذلك. الإطار الذي لا يتسع له العمود الجانبي لصفحته يأخذ العمود الجانبي للصفحة التالية؛ وإذا انتهى الفصل، أو المستند، قبل ذلك، وُضع كل إطار ما زال ينتظر في العمود الجانبي لصفحة تُفتح بعد النص، بترتيب ورودها في النص، ووقف خلفها الشكل الجانبي المُحال إليه بعدها. هذه الصفحة لا نص فيها، فيذكر البناء كل إطار وشكل فيها (afterText). والإطار الأطول من عمود جانبي فارغ يوضع على أي حال ويذكره البناء (calloutOverflow)، وما لا يجد صفحة بعد ذلك يذكره أيضًا (unplaced) بدل أن يسقط. حتى postext 1.24 لم تكن تُفتح إلا أولى هذه الصفحات، وتضيع الإطارات الباقية بلا تحذير.
تُصحَّح أشرطة العناصر العائمة وفق شبكة خطوط الأساس كي يحافظ النص المحيط على الإيقاع الرأسي على امتداد الصفحة. فالشريط العلوي يزيد هامشه السفلي حتى خط الشبكة التالي، فيبقى النص تحت العنصر العائم محاذيًا للأعمدة المجاورة وللصفحة المقابلة. والعنصر العائم السفلي يُثبَّت بحيث يشترك السطر الأخير من تعليقه في خط أساس واحد مع آخر سطر نص في الأعمدة الأخرى (والمحتوى الذي لا تعليق له يحاذي حافته السفلى مع آخر موضع في الشبكة)، فتنتهي الصفحات الممتلئة عند الارتفاع نفسه عبر الأعمدة وعبر الصفحتين المتقابلتين.
في الصفحة الختامية للفصل، وللمستند، لا يلي الأشكالَ والجداول بعرض الصفحة المنضّدة تحت آخر شريط نص شيءٌ، فترتفع لتقع على بُعد فجوة عنصر عائم واحدة تحته، متراصّة بترتيبها، بدل أن تترك بياضًا بين النص وشكل في أسفل الصفحة. ويسري ذلك على العنصر العائم ذي position: 'bottom' أيضًا. لإبقائها في أسفل الصفحة، كما في كل صفحة أخرى، اضبط layout.hugClosingFloats: false (انظر الإعدادات › التخطيط). ولا تحرّكها أبدًا الصفحات التي فيها عمود جانبي.
ترسم المُخرِجات الثلاثة كلها الموارد: معاينة Canvas، وعارض HTML، ومخرجات PDF. وفي مُخرِج HTML تقيم بيانات الصور خارج المستند، فيوفّرها المضيف عبر خيار المُحلِّل resourceImageUrl(fileId)؛ وحين يغيب المُحلِّل (أو لا يعيد شيئًا لملف ما)، يُعرض المورد مستطيلًا محايدًا بديلًا كي يبقى التخطيط ثابتًا. ويأتي ملف الفيديو نفسه عبر resourceVideoUrl(fileId) بالطريقة نفسها (انظر مقاطع الفيديو).
أين يمكن أن يستقر العنصر العائم
تُحسب قاعدة «أبدًا قبل إحالته» من السطر الذي يحيل إلى العنصر العائم: ينتظر العنصر العائم حتى يُنضَّد ذلك السطر، ويأخذ أول موضع شاغر بعده بترتيب القراءة، ورأس الصفحة التي يُنضَّد فيها السطر يقع قبله. والاستثناء هو العنصر العائم الجانبي (span: 'side'، في العمود الجانبي المخصص للعناصر العائمة في تخطيط العمود ونصف): يتراصّ في العمود الجانبي بجانب النص الذي يحيل إليه، وقد يقع أعلى في الصفحة من سطر الإحالة. لشكل يُحال إليه في الصفحة 5:
| الموضع | في الصفحة 5 | وإلا |
|---|---|---|
top، span: 'page' | أبدًا: الشريط الذي في رأس الصفحة يقع فوق سطر الإحالة. | الشريط العلوي في الصفحة 6. |
top، span: 'column' | رأس عمود لاحق لا يزال فارغًا؛ فإذا أُحيل إليه في الأول من عمودين، أمكنه أن يفتتح الثاني. | رأس عمود في الصفحة 6. |
auto أو bottom، span: 'page' | الشريط السفلي في الصفحة 5، حين يبقى في كل عمود متسع له. | شريط في الصفحة 6. |
auto أو bottom، span: 'column' | أسفل عمود الإحالة؛ ثم أسفل (كلاهما) أو رأس (auto فقط) عمود فارغ لاحق. | الصفحة 6. |
- تتبع صفحة افتتاح الفصل القواعد نفسها: العنصر العائم بعرض الصفحة من نوع
autoأوbottomالذي يُحال إليه في الفقرة الأولى من الافتتاح يمكنه أن يأخذ الشريط السفلي لتلك الصفحة، تحت نصها؛ أما عنصرtopفيفتتح الصفحة التالية. ولكي تكون الصورة في الصفحة التي تحيل إليها، استعملautoأوbottom، أو ارسمها عنصر صورة في تصميم الافتتاح. - عنصران عائمان بعرض عمود يُحال إليهما في الفقرة نفسها يأخذان الموضعين التاليين: عادةً يأخذ الأول أسفل عمود الإحالة، والثاني رأس العمود الفارغ التالي، فيتجاوران في الصفحة.
- في التخطيط ذي العمود الواحد يكون العنصر العائم بعرض الصفحة عنصرًا عائمًا بعرض عمود، وتسري القواعد نفسها: عنصر
topيُحال إليه في صفحة يستقر في رأس الصفحة التالية. - الفقرة التي تمتد من صفحة إلى التالية تُحسب كذلك من سطر الإحالة فيها. حين تبدأ الفقرة في أسفل الصفحة 5 وتقع الإحالة في الصفحة 6، أو تنتقل الفقرة كلها إلى الصفحة 6 لأن ما يتسع من أسطرها في أسفل الصفحة 5 لا يكفي، تكون الإحالة في الصفحة 6: عنصر
topيفتتح الصفحة 7، وعنصرautoيأخذ أسفل الصفحة 6 حين يتسع له. ويسري الأمر نفسه بين أعمدة الصفحة الواحدة، وعلى الإطار المقسوم على عدة صفحات: الشكل الذي يحيل إليه جزؤه الثاني ينتظر ذلك الجزء. - تغيّر في postext 1.5. حتى postext 1.4 كان العنصر العائم يُدرج في قائمة الانتظار حين يصل التخطيط إلى الفقرة التي تحيل إليه، فكانت الصفحة التي تمتد إليها هذه الفقرة (أو تنتقل إليها) قد تُفتتح بالعنصر العائم، فوق السطر الذي فيه الإحالة. أما الآن فيستقر هذا الشكل بعد صفحة، أو في أسفل الصفحة حين يطلب
auto؛ وقد يترتب على ذلك تغيّر في عدد الصفحات.
وضع العناصر العائمة يدويا غير مستحسن
ينضّد Postext الكتاب بالقواعد: يأخذ كل عنصر عائم أول موضع فارغ بعد الإحالة إليه، ضمن الحدود التي يضعها إعداد موضعه، ويُعاد تنضيد الكتاب كله حين يتغير النص أو مقاس الصفحة أو عدد الأعمدة أو لغة الطبعة. أما التثبيت فمربوط بهندسة تنضيد واحد. فهو يسمّي صفحة معدودة من الإحالة وعمودًا برقمه، ولا يبقى لأيّ منهما المعنى نفسه حين يتحرك النص. أضف فقرة فتنتقل الإحالة إلى صفحة أخرى، وترجم الكتاب فتتغير مواضع انكسار الأسطر، واجعل طبعة بعمود واحد فلا يبقى عمود 1. عندها يفشل التثبيت ويبلّغ التنضيد عن ذلك، أو يضع العنصر في مكان لم يعد يخدم الصفحة. ويُحفظ التثبيت في المورد، فتشترك فيه كل طبعات الكتاب ولغاته.
هذه القواعد تُبقي الشكل قرب نصه في كل طبعة:
position: "top"أو"bottom"(على المورد أو على نوعه) يحصر مواضع العنصر العائم في رؤوس الأعمدة أو أذيالها.citingPage: true، أوlayout.floatsAtCitingPageللكتاب كله، يتيح لعنصر في الأعلى أو تلقائي أن يتصدّر الصفحة أو العمود الذي يقع فيه سطر الإحالة.- الإطار ذو
keepTogetherيُبقي ما فيه معًا، ومن ذلك صورة مُدرجة فيه بـ::resource؛ وfloatBarrierفي نمط الإطار يُبقي العناصر العائمة المحال إليها قبله في جهته. shrink: "slot"(أو"page") يتيح تصغير الصورة إلى مساحة موضعها، والمنطقة الآمنة تتيح للمحرّك أن يقصّها لتتسع قبل أن يصغّرها.
وإن ظلت صفحة تحتاج إلى نقل شكل، فثبّته خطوةً أخيرة في طبعة منتهية بلغة واحدة، وراجع floatPinMissed في لوحة الفحوص كلما تغيّر النص أو التصميم.
#التفاف النص
يمكن لصورة أو جدول أو إطار أضيق من عموده أن يقف في أحد جانبيه والنص يجري بجانبه، كما في المجلات والنشرات. أعطِ موضعه جانبًا في wrap، وإن شئت width:
{ "id": "bed", "typeId": "figure", "kind": "svg", "caption": "حوض الزراعة الجديد.",
"placement": { "position": "here", "wrap": "right", "width": 0.4 } }- داخل النص (
"here"). يوضع المورد في جانبه من العمود، وأعلاه بمحاذاة أعلى السطر التالي لسطر::resource، وتجري الفقرات والاقتباسات وعناصر القوائم التي تليه بجانبه بالعرض المتبقي، ثم تحته بالعرض الكامل. الفقرة التي تبدأ بجانبه وتنتهي تحته تبقى فقرة واحدة: لا انقطاع فيها ولا مسافة زائدة عند أسفل الصورة. تبقى كل الأسطر على شبكة خطوط الأساس؛ والمسافة تحت الصورة هي مسافة الالتفاف مقرّبة إلى أعلى إلى أسطر كاملة من الشبكة. - عنصر عائم في عمود. العنصر العائم
span: "column"بعرض عمود واحد، في أعلى عمود ("top"، أو"auto"في أعلى عمود) أو أسفله ("bottom"،"auto")، يوضع في شريطه كأي عنصر عائم، ثم تجري أسطر العمود الأولى أو الأخيرة بجانبه. في صفحة من عمودين ينتمي العنصر العائم إلى عموده، ويجري العمود الآخر بعرضه الكامل. - إطار. يقبل
:::calloutالإعدادات نفسها سماتٍ::::callout{wrap="right" width=0.4}يضع اقتباسًا بارزًا أو إطارًا جانبيًا حيث يرد، والنص الذي يليه بجانبه، وplacement="top"أو"bottom"معwrapيجعله يطفو إلى أعلى العمود أو أسفله. ويُنضَّد الإطار الذي يلتف حوله النص كاملًا ولا يُقسَم أبدًا. - ما ينزل تحته. العنوان والصيغة المستقلة والشكل أو الجدول والإطار والقصيدة لا تُنضَّد بجانب عنصر يلتف حوله النص: تنزل تحته، ويبقى البياض بجانبه فوقها فارغًا. مغادرة العمود (أسفله، أو
:::columnbreak، أو فاصل صفحة) تُنهي الالتفاف هناك: العنصر ينتمي إلى عموده. وحين لا يمكن للكتلة التي تلي المورد داخل النص مباشرةً أن تُنضَّد بجانبه، يأخذ المورد شريطه كما بلاwrap. - المسافة والحدود.
wrapGap(وإلاlayout.wrap.gap، وإلا سطر واحد من المتن) تفصل العنصر، مع تعليقه، عن النص المجاور وعن النص تحته. إذا كان النص المجاور سيصبح أضيق منlayout.wrap.minTextWidth(12 em من المتن)، أو كان العنصر أقصر منlayout.wrap.minLinesBesideسطرًا (2)، يأخذ الشريط كله ويظهر التحذيرtextWrap. والعنصر داخل النص الأطول من المساحة المتبقية في عموده ينتقل إلى العمود التالي مع مرساته، بالتحذير نفسه. - الجانبان.
leftوrightجانبا تدفق النص، كما فيalign: في كتاب من اليمين إلى اليسارleftهو يمين الورقة. وstartوendتشيران إلى الجانبين نفسيهما. - المخرجات. تنضّد Canvas وعارض HTML وملف PDF وEPUB ذو التخطيط الثابت الأسطر كما أُخرجت؛ ويقرأ PDF الموسوم الصورة أو الإطار قبل الفقرة المجاورة. أما EPUB القابل لإعادة التدفق فيجعله يطفو إلى جانبه بـCSS، بالحصة نفسها من عرض النص.
- ليس بعد. النص على جانبي الصورة، والالتفاف داخل محتوى إطار، والالتفاف في الكتابة العمودية (يحتفظ العنصر بشريطه مع تحذير). الأعمدة التي فيها عنصر ملتف تُستثنى من موازنة الأعمدة.
الالتفاف حول المحيط
الرسم المقصوص (شخص على خلفية شفافة، أو شيء مرسوم، أو خريطة جزيرة) يبدو أحسن حين يتبع النص محيطه منه حين يقف النص عند حافة مستطيلها. وهذا ما يفعله "wrap": "contour": يُنضَّد كل سطر بجانب الصورة أقصر بقدر عرض شكلها عند ارتفاع ذلك السطر، مضافًا إليه هامش، والسطر الذي يمرّ بعيدًا عن الشكل يأخذ العرض كله.
{ "id": "pear", "typeId": "figure", "kind": "bitmap",
"bitmap": { "fileId": "pear.png", "format": "png", "width": 600, "height": 800 },
"placement": { "position": "here", "wrap": "contour", "align": "right", "width": 0.42 },
"contour": { "threshold": 0.5, "margin": { "value": 2, "unit": "mm" } } }- مصدر الشكل. شكل الصورة النقطية هو قناة ألفا فيها: البكسلات التي لا تقلّ عتامتها عن
contour.threshold(من 0 إلى 1، والافتراضي 0.5). والمضلّع فيcontour.points، وهو ثلاث نقاط على الأقل بكسور من الصورة كاملة تُقاس من زاويتها العليا اليسرى ({ "x": 0.5, "y": 0 }منتصف حافتها العليا)، يتقدّم على قناة ألفا، وهو السبيل إلى إعطاء SVG شكلًا. ويُهمل"alpha": falseقناة ألفا. وليس في JPEG شفافية، فمن غير مضلّع يلتف النص حول مستطيلها. - الهامش. يحدّد
contour.marginالمسافة المتروكة بين الشكل والنص، على الجانبين وفوقه وتحته. وإن لم يُضبط فهو مسافة الالتفاف (placement.wrapGap، وإلاlayout.wrap.gap، وإلا سطر واحد من المتن). - الجانب. تقف الصورة في الجانب الذي تحدّده
align("right"أو"end"؛ وأي قيمة أخرى تعني اليسار)، وتجري الأسطر في الجانب الآخر. وكل ما عدا ذلك كما في الالتفاف الجانبي: إدراج داخل النص أو عنصر عائم بعرض عمود واحد، والحدود نفسها وتحذيراتtextWrapنفسها. - القصّ والتحجيم. يتبع الشكل الصورة كما نُضِّدت: يكبر ويصغر معها، ويُقطع حيث تقصّها المنطقة الآمنة. ويحتفظ التعليق أو الملاحظة تحت الصورة بمستطيله.
- من اليمين إلى اليسار وCJK. في صفحة من اليمين إلى اليسار ينقلب الشكل مع الصفحة، إذ تُرسم الصورة غير مقلوبة في موضعها المعكوس. وتحت شبكة الحروف في نصوص CJK يكون مقدار ما يُقتطع من كل سطر عددًا صحيحًا من الحروف، فتبقى الأسطر على الشبكة.
- تتبّع المحيط. يقرأ التخطيط الصور بمقاساتها لا ببكسلاتها، فتنتقل قناة ألفا مع المورد: الحقل
contour.traced، أي الشكل مسجّلًا صفًّا صفًّا، يصنعه المضيف من الملف بـtraceResourceContour(resource, bytes, mime)(يقرأ المحرّك PNG بنفسه، في المتصفح وفي Node؛ وتمرّ الصيغ الأخرى بمفكّك الترميز في المتصفح). وقراءة حزمة تتتبّع كل صورة تطلب ذلك، ويتتبّع Sandbox الصورة حين يتغيّر التفافها أو ملفها أو عتبتها. ولا تخزّن الحزمة نتيجة التتبّع أبدًا. والصورة التي لا يُعرف شكلها (SVG بلا مضلّع، أو صورة نقطية بلا شفافية، أو صورة لم تُتتبّع) يلتف النص حول مستطيلها، مع التحذيرtextWrapوسببهnoContour: أعطها مضلّعًا، أو استعمل PNG فيه شفافية، أو اقرأها عبرreadBundleأو Sandbox لكي تُتتبّع. - إطارات الصفحات المركّبة. الإطار في صفحة مركّبة الذي يزيح النص (
exclude: "push") يقبل"wrap": "contour"أيضًا: انظر الصفحات المركّبة › إطارات تزيح النص. - ليس بعد. النص على جانبي شكل يقف في وسط عرض السطر (يأخذ النص الجانب الأعرض)، وتحرير المضلّع في Sandbox.
#مقاس الصورة النقطية
تصرّح الصورة النقطية ببكسلاتها: bitmap.width وbitmap.height عددا بكسلات الملف، لا مقاس طباعة. وعدد ما يدخل منها في البوصة هو ما يقرّر المقاس الذي تُنضَّد به الصورة قبل أن تحدّها خانتها. وثمة ثلاث طرق لتحديد مقاسها:
- بكسلاتها بدقة الصفحة (الافتراضي). من غير دقة، كل بكسل من الصورة بكسلٌ من الإخراج (
page.dpi، وهي 300 ما لم تُضبط): فالصورة الفوتوغرافية ذات 2400 px عرضها 8 بوصات (203.2 mm) في صفحة بدقة 300 dpi، وضعف ذلك في صفحة بدقة 150. - دقة.
bitmap.resolutionهي دقة الصورة بوحدة ppi بمقاس طباعتها الطبيعي، فعرضها الطبيعيwidth × page.dpi / resolutionفي صفحة بأي دقة: 2400 px معresolution: 300عرضها 203.2 mm في صفحة مُخرَجة بدقة 150 dpi أو 300. ويعطيlayout.bitmapResolutionدقةً لكل صورة نقطية ليست لها دقة خاصة بها: رقمًا (300)، أو'file'، أي الدقة التي يذكرها ملفها (bitmap.fileResolution: الحقلpHYsفي PNG، وكثافة JFIF أو EXIF في JPEG، وEXIF في WebP؛ وفي الصورة المستوردة من Word، المقاس الذي كان Word يطبعها به). وكثيرًا ما تذكر الكاميرات ولقطات الشاشة وملفات التصدير للويب دقة 72 أو 96 ppi وهي لا تعرف شيئًا عن مقاس الطباعة، لذا تُعدّ هاتان القيمتان تحت'file'غير محددتين، وتبقى الصورة ببكسلاتها بدقة الصفحة؛ أما 72 المصرَّح بها في المورد نفسه فتؤخذ كما كُتبت. و'document'، الافتراضي، هي الطريقة الأولى. - حصة من العمود. يضيّق
placement.widthالعنصر العائم أو التضمين داخل التدفق إلى كسر من عموده (أو صفحته)، والصورة الأكبر من تلك الحصة تُصغَّر إليها أيًّا كانت بكسلاتها (انظر الموضع).
وفي كل الحالات تحدّ الخانةُ الصورةَ مع الحفاظ على تناسبها، ولا تُكبَّر الصورة الأصغر أبدًا. والمقاس الطبيعي نفسه ينطبق على الصورة في خلية جدول وعلى عنصر image في التصميم بمقاس 'auto'. ويضمّن PDF الملف كما هو بالمقاس الذي وُضع به. ويتحقق الفحص قبل الطباعة من الدقة التي تُطبع بها كل صورة، وتعرضها لوحة الموارد في Sandbox لكل صورة. منذ postext 1.24.
موضع الصورة في المتن (position: 'here'، أو عنصر عائم في عمود) هو عمودها، وللصفحة الافتراضية عمودان (layout.layoutType: 'double'): فالصورة المعدّة لملء الصفحة تخرج هناك بنحو نصف مقاس طباعتها. نضّد هذه الصفحة في عمود واحد (layout.layoutType: 'single')، أو اجعل الصورة تطفو على عرض الصفحة (placement: { position: 'top', span: 'page' })، أو ضعها في خانة صفحة مركّبة. وحين يُبقي عمودٌ أضيق من الصفحة صورةً نقطية لها مقاس طباعة (دقّتها resolution، أو رقم في layout.bitmapResolution) دون نصفه، يظهر التحذير pictureBelowPrintSize. منذ postext 1.37.
{ "id": "harbour", "typeId": "figure", "kind": "bitmap", "caption": "The harbour at dawn.",
"bitmap": { "fileId": "harbour.jpg", "format": "jpeg", "width": 2400, "height": 1600, "resolution": 300 } }يقرأ bitmapInfo(bytes) (من postext وpostext/bundle) بكسلات الملف والدقة التي يذكرها، { width, height, resolution?: { x, y, source } }؛ والحزمة التي تُفتح تحت 'file' تملأ fileResolution بهذه الدقة، ويحتفظ بها Sandbox لكل صورة تُرفع إليه.
#المنطقة الآمنة
يمكن لمورد من نوع bitmap أو SVG أن يحدّد منطقة آمنة: المستطيل من الصورة الذي فيه ما يهمّ (شخص وشريط من المنظر من حوله، الجزء المرسوم من مخطط بياني) ويظهر دائمًا. وهي الحقل safeArea في المورد، أربعة كسور (من 0 إلى 1) من الحجم الأصلي للصورة تُقاس من زاويتها العليا اليسرى: x وwidth كسران من عرضها، وy وheight كسران من ارتفاعها. فالاسم يدل على ما يجب أن يبقى، أما مستطيل القصّ فيدل على موضع القطع.
const harbour: Resource = {
id: 'harbour', typeId: 'figure', kind: 'bitmap', caption: 'الميناء عند الفجر.',
createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'harbour.jpg', format: 'jpeg', width: 2400, height: 1600 },
// the boats and the quay: 18–68 % of the width, 25–85 % of the height
safeArea: { x: 0.18, y: 0.25, width: 0.5, height: 0.6 },
};لا تُقصّ إلا الصورة التي لها منطقة آمنة. وعندئذ يجوز للمحرّك أن يعرضها بأي نسبة أبعاد بين الصورة كاملة والمنطقة الآمنة: أطول من نسبتها الأصلية بقصّ جانبيها، إلى عرض المنطقة الآمنة على الأكثر، أو أقصر بقصّ أعلاها وأسفلها، إلى ارتفاع المنطقة الآمنة على الأكثر. ولا يتغيّر عرض الشكل أبدًا، بل ارتفاعه وحده. وما يقع خارج المنطقة الآمنة يُقصّ من كل جانب بنسبة الهامش الذي فيه، فيبقى الموضوع الواقع يسار المركز يسار المركز. إذا نُضّدت صورة الميناء أعلاه بعرض 60 مم كان ارتفاعها كاملة 40 مم، ويمكن عرضها بأي ارتفاع بين 24 مم (بقصّ الأعلى والأسفل حتى 60% من الارتفاع) و80 مم (بقصّ الجانبين حتى نصف العرض). والقيم التي تتجاوز حواف الصورة تُردّ إليها؛ أما المنطقة التي فيها قيمة ليست عددًا، أو ضلع أقل من 2% من الصورة، أو التي تغطي الصورة كلها، فتُهمَل، وكذلك يُهمَل الحقل في الجدول. ومن دون منطقة آمنة تُعرض الصورة كاملة دائمًا، كما كانت من قبل.
يستعمل المحرّك هذا الهامش في أربعة مواضع:
- المتسع الباقي في العمود. الصورة المضمّنة داخل التدفق (
position: 'here') التي تزيد قليلًا على المتسع الباقي في عمودها، ومنها الصورة التي سيتجاوز تعليقها أسفل الصفحة، تُقصّ داخل منطقتها الآمنة لتبقى في مكانها، بدل أن تنتقل إلى العمود أو الصفحة التالية وتترك هذا العمود قصيرًا. وكذلك التضمين الممتد بعرض الصفحة (span: 'page') الذي يزيد قليلًا على الشريط الباقي تحت افتتاحية فصل، مع إبقاء الحد الأدنى من أسطر النص تحته تفاديًا للأرامل. - صفحات أقصر من الشكل. مع
layout.fitFiguresToPageتُقصّ الصورة الأطول من الصفحة أولًا داخل منطقتها الآمنة، مع الحفاظ على عرضها، ولا تُصغَّر إلا إذا بقيت أطول مما ينبغي (انظر الإعدادات › التخطيط). - أشرطة أقصر من الشكل. العنصر العائم الذي يصغّره
placement.shrinkإلى حيّز موضعه يُقصّ أولًا داخل منطقته الآمنة، محتفظًا بعرضه، ثم يُصغَّر بعد ذلك فقط؛ ولا تُطيله رافعةflexFigureأدناه أبدًا إلى ما بعد ذلك الحيّز. - موازنة الأعمدة. الصورة ذات المنطقة الآمنة المضمّنة في عمود قصير، أو العائمة في رأس ذلك العمود أو أسفله وفوقه وحده، تطول بأسطر كاملة من شبكة خطوط الأساس حتى تملأ الأسطر الفارغة في العمود. والصورة الأطول لا تترك فجوة ظاهرة، ولذلك تُجرَّب هذه الأداة،
flexFigure، بعد الإطار الذي يختم العمود مباشرة وقبل إضافة أي مسافة فوق العناوين أو بعد القوائم. أما العنصر العائم في رأس عمود من الصفحة الختامية لفصل، أو من شريط ختامي، فلا يطول، لأن رؤوس الأعمدة هناك تبقى متساوية (انظر الإعدادات › موازنة الأعمدة).
تسجّل شجرة VDT القصّ على كتلة المورد: bodySource هو الجزء الظاهر من الصورة داخل bodyRect، بالكسور نفسها (ويغيب حين تظهر الصورة كاملة)، وbodyFlex يعطي عدد px التي لا يزال جسم الصورة يستطيع أن يقصر أو يطول بها، وعدد px التي غيّرته بها الأدوات ({ shrink, grow, delta }). معاينة Canvas وملف PDF يقصّان الرسم إلى جسم الصورة ويرسمان الصورة كاملة بحجمها غير المقصوص؛ وعارض HTML وEPUB ذو التخطيط الثابت يضعان الصورة بـobject-fit: cover مع object-position المطابق؛ أما EPUB القابل لإعادة التدفق، الذي لا صفحة فيه تُملأ، فيعرض الصورة كاملة. والمضيف الذي يرسم الصور بنفسه يجد الدوال التي يصدّرها postext: resourceSafeArea وnormalizeSafeArea (المنطقة كما يقرؤها المحرّك، أو undefined)، وsafeAreaHeightRange (أقصر جسم وأطوله عند عرض معيّن)، وsafeAreaSource (الجزء الظاهر عند ارتفاع معيّن)، وuncroppedPictureBox (أين تُرسم الصورة كاملة قبل القصّ)، مع النوع ResourceSafeArea. وفي Sandbox اسم الحقل المنطقة الآمنة، في صورة من لوحة الموارد.
تنضّد الوصفة رقم 116 في دليل الوصفات، صور تطول لتملأ العمود القصير، تحقيقَ مجلة بعمودين مرتين، بلا مناطق آمنة ومعها، لتقارن الصفحات جنبًا إلى جنب.
#القص اليدوي
يمكن أيضًا قصّ صورة نقطية أو SVG أو ملصق فيديو يدويًا: crop، بالكسور نفسها التي للمنطقة الآمنة، هو جزء الصورة الذي يُظهره الشكل دائمًا أيًّا كانت الصفحة. ويأخذ الشكل نسبة أبعاد القصّ. وتُقرأ المنطقة الآمنة، إن وُجدت، داخل القصّ: قد يقطع المحرّك أكثر حيث تحتاج الصفحة، ولا يخرج أبدًا عن القصّ، وbodySource هو تركيب الاثنين. حدّد المنطقة الآمنة داخل القصّ؛ فما يقع منها خارجه لا يظهر أبدًا. وإن لم يُحدَّد، فالصورة كاملة. ويصل القصّ إلى كل المخرجات: اللوحة وPDF وعارض HTML وكلا نوعي EPUB (يضع الكتاب المتدفق الصورة، أو ملصق الفيديو والفيلم في إطاره، في صندوق بنسبة أبعاد القصّ)، وIDML وتصدير Word المنسّق، والصورة في خلية جدول، ورسم لقطة القصة المصوّرة (تُختار نافذة اللقطة داخل القصّ)، وصورة التصميم التي تعرض موردًا. أما تصدير Word الدلالي فيُدرج الصورة كاملة، كما يفعل مع المنطقة الآمنة، ويحتفظ بالقصّ في الكتاب. ولا تُفحص نقاط ارتكاز القصص المصوّرة إلا قياسًا إلى المنطقة الآمنة (comicAnchorOutsideSafeArea): أبقِ كل متحدث داخل القصّ أيضًا. وفي Sandbox يفتح القصّ، بجوار المنطقة الآمنة، إطارًا يُسحب ويُضبط بالأسهم ويُعاين؛ ويضبطه الوكيل عبر sandbox_save_resource (marks.crop).
const portrait: Resource = {
/* … */
bitmap: { fileId: 'portrait.jpg', format: 'jpeg', width: 3000, height: 2000 },
// النصف الأوسط، من الأعلى إلى الأسفل
crop: { x: 0.25, y: 0, width: 0.5, height: 1 },
};#نقاط ارتكاز الشخصيات ومناطق التجنب
يمكن للصورة التي تكون رسمًا لإطار في قصة مصورة أن تحدد أيضًا مواضع أشخاصها، لتستعملها كتابة الحوار (انظر القصص المصورة). يسرد anchors نقطة لكل شخصية، ويسرد avoid المناطق التي لا تغطيها أي فقاعة، وكلاهما بكسور من الصورة كالمنطقة الآمنة:
const radio: Resource = {
id: 'lh-radio', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'lh-radio.jpg', format: 'jpeg', width: 1000, height: 1000 },
safeArea: { x: 0, y: 0.36, width: 0.62, height: 0.56 },
anchors: [
// حارس المنارة: الفم، والرأس (لفقاعات التفكير)، والوجه
{ id: 'tomas', x: 0.345, y: 0.52, head: { x: 0.38, y: 0.44 }, face: { x: 0.29, y: 0.4, width: 0.16, height: 0.18 } },
],
avoid: [{ x: 0, y: 0.44, width: 0.22, height: 0.26 }], // المذياع
};id في نقطة الارتكاز هو مفتاح الشخصية في السيناريو (tomas: …)، أو sfx للنقطة التي تجتمع عندها المؤثرات الصوتية في الإطار؛ وx وy هما الفم الذي يتجه إليه ذيل فقاعة الكلام، وhead النقطة التي تتجه إليها الفقاعات الصغيرة في ذيل فقاعة التفكير (الفم إن لم تُحدَّد)، وface مستطيل لا تغطيه أي فقاعة. ويحوّل المحرّك كل نقطة عبر قصّ الإطار وانعكاسه، فيبقى الذيل على شخصيته أيًا كان الشكل الذي يأخذه الإطار؛ ونقطة الارتكاز الواقعة خارج المنطقة الآمنة يظهر لها التحذير comicAnchorOutsideSafeArea، لأن القصّ قد يُخرجها. وهناك قائمة ثالثة، faces، تحفظ وجوه من لا يتكلمون، مستطيلات مثل مستطيلات avoid: لا تغطيها أي فقاعة، أما منطقة التجنّب فتتنازل حين لا يبقى في الإطار مكان آخر. ونقاط الارتكاز جزء من الصورة، وتخدم كل ترجمات القصة. تقرؤها إطارات القصص المصورة لكتابة الحوار. وتستعمل تسميات الشكل نقاط الارتكاز كذلك، ومنذ postext 1.42 تحدّد مناطق avoid في خريطة أو مخطط رموزها: فالتسمية التي تمتد إلى إحداها يظهر لها التحذير labelOverlap (انظر الصفحات المركّبة). وفي Sandbox تُعلَّم في نافذة المنطقة الآمنة وكتابة الحوار في لوحة الموارد.
ونقطة الارتكاز التي تستعملها تسمية شكل تستطيع أيضًا أن تضع التسمية بعيدًا عن نقطتها، labelAt: { x, y } بكسور من الصورة، وأن ترسم خطًّا عائدًا إليها، leader: true أو مظهرًا لخط الإشارة؛ ويستطيع موصل في صفحة مركّبة أن ينتهي عند نقطة الارتكاز نفسها بـanchor: '<id>'. انظر الإعدادات › حقول التسمية في المرساة. منذ postext 1.48.
#الرموز في التعليقات والملاحظات والخلايا
يستطيع التعليق أو الملاحظة أو خلية الجدول أن يحمل رمزًا صغيرًا في سطره: يضع :icon[alt]{glyph="⊙"} محرفًا (بالخط الذي يذكره font="…"، وإلا فبخط النص)، و:icon[alt]{resource="town-mark"} مورد صورة نقطية أو SVG، و:icon[alt]{line="dashed"} عيّنة من خط، لجدول يشرح خطوط خريطة. ويلوّنه color="…" بلون سداسي عشري أو بمدخل من لوحة الألوان، ويحدّد size="…" ارتفاعه بوحدات em (الافتراضي 0.75، ارتفاع الحرف الكبير). والنص بين القوسين المعقوفين هو ما تقرؤه قارئات الشاشة وPDF الموسوم مكانه؛ والقوسان الفارغان يجعلانه زخرفة.
{ id: 'mapa-politico', typeId: 'figure', kind: 'bitmap',
caption: 'Capitals :icon[capital]{glyph="⊙" font="Noto Sans Math"} and towns :icon[town]{resource="town-mark"} of Varenia' }تُقرأ الرموز في التعليقات والملاحظات وخلايا الجداول وتسميات الأشكال (انظر الصفحات المركّبة › خطوط الإشارة ومفاتيح الخرائط والرموز)؛ أما في نص المتن والعناوين فيبقى التوجيه نصًّا في هذا الإصدار. منذ postext 1.48.
