الصفحات المركّبة: أشكال بتسميات

تتناول هذه الصفحة أشكال الصفحة المركّبة، أو النص الجاري، التي تضع كلمات على صورتها. أما كيف تُكتب الصفحة المركّبة ففي الصفحات المركّبة؛ وأنماط التسميات وحقول التسمية في المرساة في الإعداد › الصفحات المركّبة.

#أشكال بتسميات

:::figure{resource="mapa-europa" slot="mapa"}
::label[OCÉANO ATLÁNTICO]{at="atlantico" style="mar"}
::label[**Madrid**]{at="madrid"}
::label[Mar Negro]{at="62% 48%"}
:::

يضع :::figure{resource="…"} موردًا واحدًا، بتعليقه ورقمه، كما يفعل ::resource، ويسرد التسميات التي توضع على الصورة: سطر ::label[TEXT]{…} لكل تسمية، ويجوز أن تفصل بينها أسطر فارغة.

• تحدّد السمة at مرساةً من مراسي المورد (نقطة تُعرَّف مرة واحدة على الصورة وتشترك فيها كل اللغات)، أو تعطي نقطة بالنسب المئوية من الصورة، at="x% y%"، لتسمية لا مرساة لها.
• وتحدّد السمة style نمط التسمية، وتتقدّم على نمط المرساة.
• ترسم السمة leader خطًّا من التسمية إلى نقطة مرساتها، وتزيله leader="none" (انظر خطوط الإشارة ومفاتيح الخرائط والرموز).
• النص بين القوسين المعقوفين Markdown داخل السطر: عريض ومائل وشارات، ورموز تُكتب بـ:icon.

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

#كلمات الشكل الخاصة

في المورد صورة واحدة ومراسيها ومجموعة واحدة من الكلمات، لكن كل طبعة من الكتاب تحتاج إلى كلماتها. ويمكن للشكل أن يحدّد بنفسه alt وcaption وnote، في سطر فتحه أو في أسطر مستقلة، فتحلّ محلّ كلمات المورد في صفحات ذلك الملف:

:::figure{resource="relieve" alt="Mapa de relieve de Varenia"}
::caption[Relieve de **Varenia**, con sus tres cordilleras]
::note[Fuente: levantamiento de 1932]
::label[Mar de Sal]{at="mar"}
:::

• حين تُكتب alt وcaption وnote سماتٍ في سطر الفتح، تأخذ نصًّا قصيرًا بين علامتي اقتباس. وتأخذ الأسطر ::alt[…] و::caption[…] و::note[…] النص بين القوسين المعقوفين، وقد يتضمّن Markdown داخل السطر و\\ لكسر السطر، كتعليق المورد وملاحظته. ويتقدّم السطر على السمة التي لها الاسم نفسه؛ وتُكتب هذه الأسطر بين التسميات، ويجوز تركُ أسطر فارغة.
• ما لا يحدّده الشكل يبقى كما في المورد. والقيمة الفارغة تعني «لا شيء»: caption="" يحذف التعليق، وalt="" يجعل الصورة زخرفية.
• تحلّ الكلمات محلّ كلمات المورد في الفصل الذي كُتبت فيه: يستعملها التنضيد والنص البديل في كل المخرجات وPDF الموسوم، ويبقى المورد نفسه كما هو. وللمورد في الفصل الواحد مجموعة كلمات واحدة، هي كلمات أول شكل له: فإذا جاء بعده شكل للمورد نفسه بكلمات مختلفة، لم تُعرض كلماته، وظهر التحذير figureWordsShared. والنسخة المصغّرة التي تحتاج إلى تعليق خاص بها تستعمل موردًا ثانيًا يشير إلى ملف الصورة نفسه. وعلى خلاف التسمية، لا يُربط كل محرف من التعليق بموضعه في Markdown؛ ويجيب sourceAt عن النقر عليه كما يجيب عن تعليق المورد.

#كيف تُنضَّد التسمية

• الموضع. تقع التسمية عند نقطة مرساتها، وهي نسبة من الصورة كلها، فإذا قُصَّت الصورة إلى منطقتها الآمنة أو نُضِّدت أصغر تحرّكت التسمية مع الرسم. يحدد align في المرساة أيّ جانب من التسمية يقع عند النقطة، ويحدد verticalAlign أيّ حافة تقع على ارتفاعها. ويتبع start وend اتجاه التسمية نفسها: في التسمية العربية يكون start حافتها اليمنى. ويُدير rotate التسمية حول النقطة باتجاه عقارب الساعة وبأي زاوية: اسم نهر على امتداد مجراه، أو اسم تلال مائلًا.
• المظهر. تحدّد style في التسمية، وإلا فـstyle في مرساتها، نمطَ التسمية (انظر الإعدادات › الصفحات المركّبة)؛ وإن لم يكن لها نمط نُضِّدت بخط نص المتن. ترسم الهالة محيط الحروف تحت تعبئتها، وتملأ الخلفية (background) المستطيل المحيط بالنص، ويوسّعه padding.
• الملاءمة. إذا كان للمرساة width انكسرت التسمية بين الكلمات ضمن ذلك العرض، ولا تنكسر داخل الكلمة أبدًا. وإذا كانت كلمة أعرض من العرض صُغِّرت التسمية كلها حتى minScale نمطها؛ فإن بقيت أعرض رُسمت وقد قُطعت أعرض كلماتها. ومن دون width تبقى التسمية في سطر واحد، إلا حيث تنكسر بـ\\ كما في التعليق.
• النص. النص بين القوسين المعقوفين Markdown داخل السطر، ويُنضَّد كما يُنضَّد التعليق: عريض ومائل وشارات وعلامات تظليل وإحالات وصيغ داخل السطر. والاسم المؤلف من عدة كلمات تسمية واحدة، أيًّا كان ترتيب كلماته في كل لغة: ::label[المحيط الأطلسي] و::label[ATLANTIC OCEAN] تقعان عند المرساة نفسها. وتُنضَّد التسميات العربية من اليمين إلى اليسار، وتنكسر التسميات الصينية واليابانية بين الحروف.
• المخرجات. يرسم التسميات كلٌّ من Canvas وPDF وعارض HTML وEPUB ذو التخطيط الثابت وFolio. وفي صفحة من اليمين إلى اليسار تبقى التسمية حيث تُظهرها الصورة.
• العمودي. عند ضبط writingMode: 'vertical-rl' على المرساة (أو على نمط تسميتها) تُنضَّد التسمية كما تُنضَّد الصفحة العمودية: الحروف قائمة في خانات بعضها تحت بعض، والأعمدة من اليمين إلى اليسار، والكلمات اللاتينية والأرقام الطويلة مقلوبة على جنبها، والأرقام القصيرة في خانة واحدة. ويصبح width جزءًا من ارتفاع الصورة، أي طول العمود، وتنكسر التسمية الصينية أو اليابانية إلى أعمدة أكثر. ويمتد align على طول العمود (start طرفه الأعلى)، وverticalAlign عبر الأعمدة (top هو العمود الأول، الأيمن)، ويُدير rotate التسمية أكثر. وفي الصفحة المنعكسة من كتاب يُقرأ من اليمين إلى اليسار تُقرأ التسمية بالطريقة نفسها، نزولًا في أعمدتها وبحروف قائمة، في موضع الصورة نفسه (منذ postext 1.40).
• الفحوص. إذا بقيت التسمية أعرض من عرضها المحدد عند minScale نمطها، ظهر التحذير labelOverflow؛ وإذا التقى سطرا تسميتين، ظهر التحذير labelOverlap على اللاحقة منهما. ويُفحص الاثنان في كل طبعة، فتُظهر الترجمة ذات الكلمات الأطول أين تحتاج إلى مساحة. وتعيد لوحة ألوان الجزء (:::part{palette="…"}) تلوين تسميات صفحاته كما تفعل مع التعليقات. ويقيس فحص التباين التسمية على خلفيتها، وإلا على هالتها؛ أما التسمية المكتوبة مباشرة على الصورة فلا تُفحص، لأن أرضيتها هي الصورة نفسها. ويشمل الفحص قبل الطباعة التسميات أيضًا: صغر حروفها بألوان الطباعة الرباعية، وأحبارها، وبعدها عن حدّ القص.
• في صفحتين متقابلتين. الشكل الذي يعبر كعب صفحتين متقابلتين (إطار فيه crossGutter: true) يرسم نصفه على كل صفحة، فالتسمية التي تمتد إلى شريط الكعب يقطعها الطيّ ولا تُقرأ في أي من الصفحتين. لذلك تنزلق هذه التسمية جانبًا إلى حافة الشريط، من الجهة التي فيها نقطة مرساتها، وتحتفظ بارتفاعها؛ والنقطة التي تقع على الكعب تمامًا تبقى في الصفحة الأولى كالإطار. والمرساة التي فيها gutter: 'cross' تبقى في مكانها، لعنوان ممتد على الصفحتين. أما الحواف الخارجية للصفحتين معًا فلا تُمَسّ: والتسمية التي تتجاوز حدّ القص تُقطع كما تُقطع الصورة. منذ postext 1.43.

#خطوط الإشارة ومفاتيح الخرائط والرموز

منذ postext 1.48 تستطيع التسمية أن تقف بعيدًا عمّا تسمّيه، وأن تكون مفتاحًا للخريطة، وتستطيع التسمية والتعليق وخلية الجدول أن تحمل رموزًا.

خطوط الإشارة. يضع labelAt في المرساة تسميتها بعيدًا عن نقطتها (اسمًا في البحر، أو ملاحظة في هامش مخطط)، ويرسم خط الإشارة الخطَّ من التسمية عائدًا إلى النقطة. ومظهره هو leader في نمط التسمية (انظر الإعدادات › أنماط التسميات)؛ ولا يفعل Markdown إلا أن يشغّله أو يطفئه لتسمية واحدة:

:::figure{resource="relieve" slot="mapa"}
::label[Sierra Alta]{at="peaks" leader}
::label[Lago Verde]{at="lake" leader="none"}
:::

تشغّل leader الخطَّ بأي قيمة سوى none وfalse وoff؛ ودون السمة يحسم الأمرَ leader المرساة، فإن لم يكن أيٌّ منهما أخذت التسمية الموضوعة بعيدًا عن نقطتها خطًّا حين يكون في نمطها leader. وتستطيع ملاحظة في إطار أن تشير إلى مكان من الصورة أيضًا: موصل يذكر طرفُه مرساةً من مراسي الصورة (anchor: 'lake').

تسميات من عدة أسطر. يكتب :::label{at="…" style="…"} … :::، داخل :::figure، تسميةً سطرًا بعد سطر: كل سطر غير فارغ من المصدر سطرٌ من التسمية، فلا يحتاج المفتاح أو العنوان البريدي إلى \\ في آخر كل سطر. وأول ::: يُغلق التسمية، والذي يليه يُغلق الشكل. ويبقى ::label[…] تسميةً من سطر واحد، لا تنكسر إلا حيث يُكتب \\.

مفاتيح الخرائط. التسمية التي نمطها فيه kind: 'legend' مفتاحٌ للخريطة: كل سطر صفّ، والرمز الذي يفتتح الصفّ يقف في عمود بعرض أعرض رمز، فتبدأ كلمات الصفوف عند حافة واحدة. اكتب الرمز أولًا في كل سطر:

:::figure{resource="mapa-politico" slot="mapa"}
:::label{at="key" style="key"}
:icon[دولة]{glyph="■" color="country"} دولة
:icon[عاصمة]{glyph="⊙" font="Noto Sans Math"} عاصمة
:icon[بلدة]{resource="town-mark" size="0.55"} بلدة
:icon[حدود]{line="dashed" color="border"} حدود
:::
::label[:icon[عاصمة]{glyph="⊙" font="Noto Sans Math"} Varena]{at="capital"}
:::

الرموز. يضع :icon[alt]{…} رمزًا صغيرًا في السطر، قائمًا على خط الأساس:

أول ما يُكتب من resource وglyph وline يحدّد النوع؛ وإن لم يُكتب أيٌّ منها بقي التوجيه نصًّا. والنص بين القوسين المعقوفين هو النص البديل للرمز: تقرؤه قارئات الشاشة وPDF الموسوم والنص البديل للصورة مكانَ الرمز، والرمز ذو القوسين الفارغين زخرفة. وتُقرأ الرموز في تسميات الأشكال وفي كل مقطع من مقاطع المورد: التعليقات والملاحظات وخلايا الجداول. ولا تُقرأ في نص المتن ولا في العناوين ولا في نصوص التصميم في هذا الإصدار.

#labelAnchorUnknown

تحدّد السمة at في ‎::label‎ مرساةً ليست في مورد الشكل. فلا تُرسم التسمية؛ ومع ذلك يسردها EPUB القابل لإعادة التدفق، ويذكرها النص البديل للصورة. يتضمّن التحذير المورد، والمرساة، ومراسي المورد (known)، واللغة، والصفحة، ونطاق نص التسمية في المصدر. صحّح معرّف المرساة، أو أضف المرساة إلى المورد، أو ضع التسمية باستخدام at="x% y%".

في لوحة الفحوص في Sandbox يقود التحذير إلى التسمية في لوحة النص، ويفتح زر الدبوس فيه مراسي الصورة وقد جُهّز هذا الاسم للوضع: نقرة واحدة على الصورة تضيف المرساة.

#anchorUnlabelled

لمرساة في مورد الشكل نمط تسمية، لكن لا توجد عندها أي ‎::label‎ من الشكل بهذه اللغة: ففي الخريطة مكان لكلمة تُسقطها هذه الطبعة. هذه ملاحظة، ويسردها postext check بمستوى info. ولا يظهر هذا التحذير للمراسي التي لا نمط لها، مثل مرساة شخصية في قصة مصوّرة. يتضمّن التحذير المورد، والمرساة، ونمطها، واللغة، والصفحة، ونطاق الشكل في المصدر. اكتب التسمية في Markdown هذه اللغة، أو أزل النمط من المرساة.

وفي لوحة الفحوص يقود التحذير إلى الشكل في لوحة النص، ويفتح زر الدبوس فيه مراسي الصورة عند هذه المرساة.

#labelOverflow

تظل التسمية أعرض من width مرساتها عند أصغر مقياس يسمح به نمط التسمية (minScale): فتُرسم بهذا المقياس وتتجاوز عرضها. يتضمّن التحذير المورد ونص التسمية ومرساتها (لا مرساة لتسمية وُضعت بالنسب المئوية) والعرض الذي أُعطيته والمقياس الذي بلغته واللغة والصفحة ونطاق نص التسمية في المصدر. ويُفحص في كل طبعة، فقد تتجاوز اللغة ذات الكلمات الأطول العرض حيث لا تتجاوزه لغة أخرى. وسّع width المرساة، أو اختصر الكلمة في Markdown هذه الطبعة، أو اخفض minScale في نمط التسمية. أما التسمية الصينية أو اليابانية فتنكسر بين الحروف، فلا تتجاوز العرض بهذه الطريقة. منذ postext 1.39.

#labelOverlap

تتلامس تسميتان من الشكل نفسه؛ وإذا كانت للتسمية خلفية حُسبت الخلفية معها. ويظهر التحذير على اللاحقة من التسميتين بحسب ترتيب الكتابة، مع نص أول تسمية سابقة تلامسها وعدد كل التسميات السابقة التي تلامسها. ويستعمل الفحص مستطيل كل سطر على حدة، مُدارًا مع التسمية، فالسطر القصير بجانب سطر طويل يترك جانبه حرًّا، ويُسمح لسطرين بأن يتداخلا بمقدار ثُمن ارتفاع السطر. ويُفحص في كل طبعة. حرّك إحدى المرساتين، أو قلّل width تسمية لتنكسر، أو اختصر الكلمات في Markdown هذه الطبعة. وفي لوحة الفحوص في Sandbox يفتح زر الدبوس مراسي الصورة عند مرساة التسمية. منذ postext 1.39. وبكتابة overlap: 'allow' على المرساة أو في نمط تسميتها تخرج من الفحص التسمية التي يطبعها الأصل ملامسةً لجاراتها (خريطة كثيفة)، ولا يظهر التحذير لأي زوج تكون طرفًا فيه. منذ postext 1.42. وتمثّل مناطقُ avoid في الصورة رموزَ الخريطة: مستطيلات بكسور من الصورة تُرسم فوق نقاطها وأيقوناتها، في وضع مناطق التجنّب من علامات الصورة. والتسمية التي تمتد إلى إحداها يظهر لها التحذير بالطريقة نفسها، مع symbol 2 بدل اسم تسمية أخرى (withSymbol في البيانات)، ويُخرج overlap: 'allow' التسمية من الفحصين معًا. منذ postext 1.42.

#figureWordsShared

يحدّد :::figure كلماتٍ (alt أو caption أو note) لمورد سبق أن حدّد شكلٌ سابق في الفصل نفسه كلماته، والكلمات مختلفة. فتعرض الصفحات كلمات الشكل الأول وتُسقط هذه. يتضمّن التحذير المورد والكلمات المُسقطة ونطاق المصدر لأولها؛ أما الشكل اللاحق الذي لا يعطي كلمات خاصة به فلا مشكلة فيه. امنح الشكل موردًا خاصًا به: موردًا ثانيًا يشير إلى ملف الصورة نفسه، بتعليقه ورقمه ومراسيه. ويظهر التحذير في لوحة الفحوص في Sandbox ضمن الأشكال والجداول. منذ postext 1.42.