انتقل إلى المحتوى الرئيسي

الفصل 3 · الجزء II · الحرفة

إعدادات Postext

ما هي إعدادات Postext، وفي أي صفحة من صفحات المرجع العشرين تُشرح كل مجموعة منها

آخر تحديث 2026-11-105 دقائقenescadefritptzhjaar

باختصار

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

كل قرار من قرارات الإخراج في 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' },
});

للاطلاع على طريقة معالجة المحرّك لهذه الإعدادات، راجع صفحة البنية.

#فهرس المرجع

المرجع موزّع على عشرين صفحة. كل مجموعة في هذه القائمة صفحة، تليها الأقسام التي تضمّها.

الصفحة والتخطيط

الترويسات والتذييلات

  • الترويسات والتذييلات — عناصر النص والخطوط الفاصلة والصناديق والصور في كل صفحة: العناصر النائبة (placeholders)، واختلافها بين الصفحات الفردية والزوجية، وأدوار الصفحات، والتموضع.

نص المتن

تقسيم الكلمات واللغة

العناوين

  • العناوين — القيم الافتراضية المشتركة، والقيم الخاصة بكل مستوى من H1 إلى H6.

الأسطر الأرامل واليتيمة والموازنة

القوائم والصيغ الرياضية

الحواشي والإحالات

  • الحواشي السفلية — footnotes: موضع الحواشي التي يُشار إليها بـ[^id]، وطريقة ترقيمها، ومظهرها.
  • ترقيم الأسطر — lineNumbers: رقم كل سطر خامس من الأبيات أو من النص في الهامش؛ ما يُعدّ، وأين يبدأ العدّ من جديد، وفي أي جهة تقف الأرقام.
  • الإحالات — crossRefs: الكلمات المطبوعة حول رقم :ref أو صفحته، ونمطه الافتراضي.
  • الاستشهادات — citations: نمط الاستشهاد ومظهر الاستشهادات وقائمة المراجع.
  • الروابط في النسخة المطبوعة — links: ما تُظهره الصفحة المطبوعة من عنوان الرابط: لا شيء، أو العنوان بين قوسين، أو حاشية فيها العنوان ورمز QR.
  • جدول المحتويات — ما يطبعه :::toc: تنضيد المداخل، والنقاط الموصِلة، وأرقام الصفحات، وأسطر المؤلفين، وصفوف الأجزاء.
  • الفهرس الأبجدي في آخر الكتاب — ما يطبعه :::index: تنضيد المداخل، والإزاحات، وفواصل أرقام الصفحات ونطاقاتها، ومجموعات الحروف، ولغة الترتيب.

تنضيد نصوص شرق آسيا

  • تنضيد نصوص شرق آسيا — cjk: الأعراف الإقليمية وقواعد كسر الأسطر في النصوص الصينية واليابانية والكورية، وطريقة توزيع المسافات في أسطرها المضبوطة، وعروض علامات الترقيم وتعليقها، والمسافة بين حروف الهان والحروف اللاتينية، وشبكة الحروف، والأرقام القائمة في النص العمودي، والعلامات وحروف الروبي (ruby) وحواشي الواريتشو (warichu) وعلامات الكانبون. ودليلا ذلك كله هما الإخراج الصيني والإخراج الياباني.

الموارد والجداول

الأنماط والأجزاء

  • أنماط الفقرات — أنماط مسمّاة لحاويات :::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 (الإعدادات) — نوع الورق والتجليد والسطح والإضاءة في عارض الكتاب ثلاثي الأبعاد.
  • التصحيح — طبقات بصرية وتحذيرات تأليف للمحرر.

الاستخدام البرمجي

ملفات PDF

  • توليد ملفات PDF — postext-pdf: مزوّدو الخطوط، وخطوط CJK، والتشغيل في Web Workers، والملفات الجاهزة للطباعة.

HTML وFolio وEPUB وSCORM

  • دمج عارض HTML وإنتاج ملفات PDF — وصفات كاملة من البداية إلى النهاية.
  • كتاب ثلاثي الأبعاد (postext-folio) — المستند المُخرَج في هيئة كتاب مطبوع مفتوح على مكتب، يقلّب القارئ أوراقه.
  • كتب EPUB — ملفات EPUB 3 ثابتة التخطيط وأخرى قابلة لإعادة التدفق من الإخراج نفسه، وفحصها بأداة EPUBCheck.
  • حزم SCORM — الفصول والأقسام وحداتِ SCO لنظام إدارة التعلم، بتمارين ترسل درجاتها.

حزم .postext

  • الحزم (ملفات .postext) — كتاب كامل في ملف واحد: إنشاء أرشيفات .postext وفتحها وبناؤها من الشيفرة.