الفصل 3 · الجزء II · الحرفة
إعدادات Postext
ما هي إعدادات Postext، وفي أي صفحة من صفحات المرجع العشرين تُشرح كل مجموعة منها
باختصار
تفتح هذه الصفحة مرجع كل إعداد يتحكم في مظهر صفحاتك. تجمع مجموعة واحدة من الإعدادات كل الخيارات: مقاس الصفحة وعدد الأعمدة والخطوط وحجم النص والعناوين والإطارات والألوان وغير ذلك. لا تكتب إلا الإعدادات التي تريد تغييرها، لأن لكل إعداد قيمة افتراضية معقولة. المرجع موزّع على عشرين صفحة. وفي هذه الصفحة قائمة فيها رابط إلى كل قسم، فانتقل مباشرة إلى الجزء الذي تحتاجه.
كل قرار من قرارات الإخراج في Postext يصدر عن كائن إعدادات واحد.
يتحكم PostextConfig في أبعاد الصفحة وترتيب الأعمدة وتنضيد نص المتن وأنماط العناوين ولغة المستند (locale) وغير ذلك. كل خاصية فيه اختيارية: يأتي Postext بقيم افتراضية معقولة مستوحاة من تقاليد تنضيد الكتب. لا تحتاج إلى تحديد شيء إلا ما تريد تغييره.
import { buildDocument } from 'postext';
const document = buildDocument(content, {
page: { sizePreset: '21x28', dpi: 300 },
layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt overrides the 8 pt default
headings: { fontFamily: 'Open Sans' },
});للاطلاع على طريقة معالجة المحرّك لهذه الإعدادات، راجع صفحة البنية.
#فهرس المرجع
المرجع موزّع على عشرين صفحة. كل مجموعة في هذه القائمة صفحة، تليها الأقسام التي تضمّها.
- الصفحة — المقاس والهوامش وشبكة خطوط الأساس وخطوط القص وترقيم الصفحات والتجليد.
- التخطيط — عدد الأعمدة والفواصل بين الأعمدة والخطوط الفاصلة والكتابة العمودية.
- القص بالقالب —
dieCuts: فتحات تُقص في ورقة واحدة أو أكثر، وزوايا مستديرة وكتب بأشكال مقصوصة، مع إبعاد النص عن كل فتحة. والدليل هو الأحبار الخاصة والقص بالقالب، ويتناول أيضًا تشطيبات الأحبار الخاصة (finish) وخط القص (print.dieLine).
- الترويسات والتذييلات — عناصر النص والخطوط الفاصلة والصناديق والصور في كل صفحة: العناصر النائبة (placeholders)، واختلافها بين الصفحات الفردية والزوجية، وأدوار الصفحات، والتموضع.
- نص المتن — التنضيد والضبط وتقسيم الأسطر، والاقتباسات الكتلية، والشعر، ومواضع الجدولة، والحروف الاستهلالية.
- تقسيم الكلمات بالواصلة — أنماط تقسيم الكلمات، والكلمات التي لا تُقسَّم، والنص غير المضبوط.
- لغة المستند — الخاصية
localeفي المستوى الأعلى: اللغة الاحتياطية لتقسيم الكلمات، وأنواع الموارد المدمجة، وعبارات المتابعة في الجداول والإطارات المقسومة، واللغة الموسومة في ملف PDF الميسّر؛ والأرقام (numerals) واتجاه النص (direction) اللذان تقتضيهما؛ واللغات والأنظمة الكتابية التي ينضّدها Postext. ودليل الكتب المكتوبة من اليمين إلى اليسار هو الإخراج العربي. - اللغات وأنظمة الكتابة — أنظمة الكتابة التي ينضّدها Postext، والصفحات التي تشرح كلًّا منها.
- النص العربي — أشكال الحروف والكشيدة والحركات والأرقام في النص العربي.
- العناوين — القيم الافتراضية المشتركة، والقيم الخاصة بكل مستوى من H1 إلى H6.
الأسطر الأرامل واليتيمة والموازنة
- الأسطر اليتيمة والأرامل والكلمات المعزولة وقواعد الإبقاء معًا — خصائص
bodyTextالتي تُبقي الأسطر والكتل معًا حين ينتقل النص إلى عمود جديد. - موازنة الأعمدة — الأدوات التي تجعل كل الأعمدة تنتهي عند المستوى نفسه، بالترتيب الذي يلجأ إليه المحرّر.
- القوائم غير المرقّمة والقوائم المرقّمة — النقاط والترقيم والتداخل.
- الرياضيات — رسم LaTeX والمقياس واللون والهوامش.
- الحواشي السفلية —
footnotes: موضع الحواشي التي يُشار إليها بـ[^id]، وطريقة ترقيمها، ومظهرها. - ترقيم الأسطر —
lineNumbers: رقم كل سطر خامس من الأبيات أو من النص في الهامش؛ ما يُعدّ، وأين يبدأ العدّ من جديد، وفي أي جهة تقف الأرقام. - الإحالات —
crossRefs: الكلمات المطبوعة حول رقم:refأو صفحته، ونمطه الافتراضي. - الاستشهادات —
citations: نمط الاستشهاد ومظهر الاستشهادات وقائمة المراجع. - الروابط في النسخة المطبوعة —
links: ما تُظهره الصفحة المطبوعة من عنوان الرابط: لا شيء، أو العنوان بين قوسين، أو حاشية فيها العنوان ورمز QR. - جدول المحتويات — ما يطبعه
:::toc: تنضيد المداخل، والنقاط الموصِلة، وأرقام الصفحات، وأسطر المؤلفين، وصفوف الأجزاء. - الفهرس الأبجدي في آخر الكتاب — ما يطبعه
:::index: تنضيد المداخل، والإزاحات، وفواصل أرقام الصفحات ونطاقاتها، ومجموعات الحروف، ولغة الترتيب.
- تنضيد نصوص شرق آسيا —
cjk: الأعراف الإقليمية وقواعد كسر الأسطر في النصوص الصينية واليابانية والكورية، وطريقة توزيع المسافات في أسطرها المضبوطة، وعروض علامات الترقيم وتعليقها، والمسافة بين حروف الهان والحروف اللاتينية، وشبكة الحروف، والأرقام القائمة في النص العمودي، والعلامات وحروف الروبي (ruby) وحواشي الواريتشو (warichu) وعلامات الكانبون. ودليلا ذلك كله هما الإخراج الصيني والإخراج الياباني.
- أنواع الموارد — ترقيم مستقل لكل نوع: الأشكال، والجداول، والأنواع المخصّصة.
- نمط الجداول (مع أنماط الجداول المسمّاة) ونمط التعليقات — التنضيد والزخرفة لموارد الجداول وتعليقاتها.
- نمط المخططات — إعادة تلوين مخططات SVG المضمّنة بحبر واحد للطباعة بالألوان الخاصة (spot colours).
- نمط المدوّنة الموسيقية —
scoreStyleوscoreStyles: حجم المدرج والخط الموسيقي والتباعد وأرقام المازورات في كل المدوّنات. - نمط الفيديو —
videoStyle: علامة التشغيل ورمز QR فوق ملصق الفيديو، وما تتيحه مشغّلاته في عارض HTML وفي EPUB.
- أنماط الفقرات — أنماط مسمّاة لحاويات
:::paragraphs: قوائم المراجع والمسارد والملاحظات. - أنماط الشارات —
chipStyles: أنماط مسمّاة للشارة:chip[…]داخل السطر: إطار كلمة في بنك الكلمات، أو مفتاح من لوحة المفاتيح، أو وسم. - أنماط الحروف —
characterStyles: أنماط مسمّاة لمقطع من الكلمات يُكتب:span[…]{style="id"}: خط، وحجم، ولون، وتباعد حروف، وحروف كبيرة، ونمط تظليل يصاحبها. - أنماط التظليل —
markStyles: أنماط مسمّاة للتظليل:mark[…]داخل السطر: الشريط الملوّن خلف عبارة مظلَّلة قد تمتد على أكثر من سطر، وخط تحتها أو عبرها. - قوائم الشيفرة —
codeStyle: الخط والإطار وعرض الجدولة والأسطر الطويلة وأرقام الأسطر وألوان الرموز في قوائم```، وتلوين الصياغة ومنفذ الملوّن الخارجي، والشيفرة داخل السطر بخط الشيفرة. - الأجزاء — صفحات فواصل الأجزاء لحاويات
:::part: فردية الصفحة أو زوجيتها، ومساحة المتن وتصميم صفحة الافتتاح وتنضيد المتن. - أنماط العناوين — أنماط مسمّاة لعناوين
{style="…"}: فصول غير مرقّمة، وصفحات تمهيدية بترويساتها الخاصة، والهندسة ولوحة الألوان. - أنماط الفصول —
chapterStyles: تصميم كامل (الصفحة والطباعة والألوان والترويسات) يأخذه الفصل بذكر اسمه في مقدّمته (chapterStyle:)، أو يعطيه جزءٌ لكل فصوله (:::part{style="…"}).
- أنماط الإطارات — ملاحظات ونصائح وأهداف داخل إطارات، تكتبها في حاويات
:::callout.
- أنماط التمارين —
exerciseStyles: رقم التمرين وشكله، وخط التعليمة، وتسميات الخيارات، والفراغات، ومساحات الكتابة، والشبكات، والقسمة المطوّلة، ولون الإجابات في كتل:::exercise. إعدادات الكتاب —exercises: طبعة المعلم، وموضع طباعة الحلول، وبذرة الخلط، والطبعات على الشاشة. والدليل هو التمارين.
- القصص المصورة —
comics: الإطار العام لصفحات القصص المصورة وفواصلها، وأنماط الإطارات، وكتابة الحوار، وأنماط الفقاعات، وقائمة الشخصيات. والدليل هو القصص المصورة.
- قوالب الصفحات —
pageTemplates: إطارات الصفحة المركّبة ومجموعاتها وزخرفتها، والوراثة بين القوالب، ونسخة الصفحة الفردية ونسخة الصفحة الزوجية. أنماط التسميات —labelStyles: مظهر التسميات الموضوعة على مراسي الصورة. مظاهر الإطارات —frameLooks: مجموعات ألوان مسمّاة تأخذها قطعة من الصفحة المركّبة بـlook="…". وكل مشكلة قد تقع في قالب مذكورة في تحذيرات قوالب الصفحات.
- الوحدات والألوان + لوحة الألوان —
DimensionوColorValueوالألوان المسمّاة. - الخطوط المخصّصة — عرّف عائلات خطوط يرفعها المستخدم إلى جانب Google Fonts.
- أنماط الأرقام —
figureStyle: أرقام قديمة الطراز أو مصطفّة أو جدولية أو تناسبية لكل نمط نصّي، من ميزات OpenType في الخط. - عارض HTML — عرض العمود المستهدف وتقسيم الأسطر في مُخرِج HTML.
- عارض Canvas —
canvasViewer: المسافة بين الصفحتين المتقابلتين، والمسافة بين كل صف والصف الذي يليه، في عرض Canvas داخل Sandbox. - إنتاج PDF (الإعدادات) — المخطط التفصيلي (outlines)، والمخرجات الميسّرة (الموسومة)، وفرض فضاء ألوان على مُخرِج PDF.
- الإنتاج الطباعي (الإعدادات) —
print: معيارا PDF/X-1a وPDF/X-4، وملفات تعريف الإخراج ICC، والأسود (الرماديات بالأسود K وحده، والطباعة فوق الألوان، والأسود الغني)، والألوان المعرّفة بقيم CMYK، والفحص قبل الطباعة، ومعاينة الطباعة. - فحص التباين (الإعدادات) —
contrast: النص مقابل خلفيته بمستوى WCAG AA أو AAA، على الشاشة وعلى ورق ملف تعريف الإخراج، والنص المفرَّغ الأدقّ مما تحتمله الطباعة. - فحص المحتوى (الإعدادات) —
checks.contentInConfig: يكشف نصوص التصميم التي تتضمّن نص الكتاب نفسه بدل العناصر النائبة، مع قائمة بالعبارات المسموح بها، كالعنوان واسم الناشر. - عارض Folio (الإعدادات) — نوع الورق والتجليد والسطح والإضاءة في عارض الكتاب ثلاثي الأبعاد.
- التصحيح — طبقات بصرية وتحذيرات تأليف للمحرر.
- الاستخدام البرمجي —
buildDocumentوالتحذيرات التي يُصدرها، والمحلِّلات (resolvers) وذاكرات التخزين المؤقت. - تشغيل الإخراج في Web Worker — بناء خارج الخيط الرئيسي مع إمكانية الإلغاء.
- توليد ملفات PDF —
postext-pdf: مزوّدو الخطوط، وخطوط CJK، والتشغيل في Web Workers، والملفات الجاهزة للطباعة.
- دمج عارض HTML وإنتاج ملفات PDF — وصفات كاملة من البداية إلى النهاية.
- كتاب ثلاثي الأبعاد (
postext-folio) — المستند المُخرَج في هيئة كتاب مطبوع مفتوح على مكتب، يقلّب القارئ أوراقه. - كتب EPUB — ملفات EPUB 3 ثابتة التخطيط وأخرى قابلة لإعادة التدفق من الإخراج نفسه، وفحصها بأداة EPUBCheck.
- حزم SCORM — الفصول والأقسام وحداتِ SCO لنظام إدارة التعلم، بتمارين ترسل درجاتها.
- الحزم (ملفات
.postext) — كتاب كامل في ملف واحد: إنشاء أرشيفات.postextوفتحها وبناؤها من الشيفرة.