توثيق Postext
المحتويات
ثلاثة أجزاء: ما هو Postext وكيف بُني، والحرفة الطباعية التي يؤتمتها، والأدوات التي تستخدمه بها.
الجزء I · الأسس
- 1مدخلمدة القراءة: 7 دقائقما Postext، ولماذا وُجد، وما المشكلة التي يحلّها
- 2البنيةمدة القراءة: 27 دقيقةالبنية التقنية لمحرّك الإخراج في Postext: مفاهيمه، وشجرة المستند، والإيقاع العمودي، والمُخرِجات، والأداء
- 2.1خط الإخراجمدة القراءة: 27 دقيقةتمريرة التوزيع وجولاتها: كيف يضع المحرّك الأسطر والعناصر العائمة والحواشي والأعمدة، ويعيد التمريرة حتى يستقر الإخراج
الجزء II · الحرفة
- 3الإعداداتمدة القراءة: 5 دقائقما هي إعدادات Postext، وفي أي صفحة من صفحات المرجع العشرين تُشرح كل مجموعة منها
- 3.1الصفحة والتخطيطمدة القراءة: 35 دقيقةمقاس الصفحة والهوامش وشبكة خطوط الأساس، وترقيم الصفحات، والأعمدة والفواصل بينها
- 3.2الترويسات والتذييلاتمدة القراءة: 30 دقيقةما يُطبع أعلى كل صفحة وأسفلها: نص فيه عناصر نائبة، وخطوط، وصناديق، وصور، ومسارات متجهية؛ وما يختلف بين الصفحات الفردية والزوجية؛ وموضع كل عنصر
- 3.3نص المتنمدة القراءة: 27 دقيقةتنضيد النص الجاري: الخط والحجم وتباعد الأسطر، والألوان، والإزاحات، والاقتباسات الكتلية، والشعر، ومواضع الجدولة، والحروف الاستهلالية
- 3.4تقسيم الكلمات واللغةمدة القراءة: 23 دقيقةأنماط تقسيم الكلمات بالواصلة واستثناءاتها، والنص غير المضبوط، ولغة المستند وأرقامها واتجاهها، وأنظمة الكتابة التي ينضّدها Postext
- 3.5العناوينمدة القراءة: 32 دقيقةالقيم الافتراضية للعناوين، والقيم الخاصة بكل مستوى، وبدء صفحة جديدة قبل العنوان، وصفحات افتتاح الفصول بعرض الصفحة كله، والأعداد المكتوبة بالحروف
- 3.6الأسطر الأرامل واليتيمة والموازنةمدة القراءة: 22 دقيقةالقواعد التي تُبقي الأسطر والكتل معًا عند فاصل العمود، والأدوات التي تجعل كل الأعمدة تنتهي عند المستوى نفسه
- 3.7القوائم والصيغ الرياضيةمدة القراءة: 18 دقيقةالقوائم المرقّمة وغير المرقّمة، وعلاماتها وإزاحاتها وتداخلها، وقوائم المهام، وحجم الصيغ الرياضية ولونها والمسافات حولها
- 3.8الحواشي والإحالاتمدة القراءة: 27 دقيقةالحواشي السفلية، وترقيم الأسطر، والإحالات والاستشهادات، وجدول المحتويات، والفهرس الأبجدي في آخر الكتاب
- 3.9تنضيد نصوص شرق آسيامدة القراءة: 35 دقيقةإعدادات cjk للنصوص الصينية واليابانية والكورية: مواضع كسر الأسطر، وعرض علامات الترقيم، والمسافات، وشبكة الحروف، وقراءات الروبي، والعلامات الخاصة بهذه النصوص
- 3.10الموارد والجداولمدة القراءة: 43 دقيقةأنواع الموارد وترقيمها، وأنماط الجداول والتعليقات، والمخططات بحبر واحد، والفيديو المطبوع
- 3.11الأنماط والأجزاءمدة القراءة: 45 دقيقةالأنماط المسمّاة للفقرات والشارات والتظليل وقوائم الشيفرة والعناوين، والصفحات التي تفتتح كل جزء
- 3.12الإطاراتمدة القراءة: 27 دقيقةأنماط مسمّاة لإطارات :::callout: الحدّ والخلفية والشريط والعنوان والأيقونة والعلامة الخارجية ولسان التسمية؛ وأشكال الإطار بنصف قطر لكل زاوية وحدّ لكل جانب وألسنة موصولة به؛ والعبارات المرقّمة كالمبرهنات؛ والتنسيق الطباعي داخل الإطار؛ والإطارات التي تنقسم بين الصفحات؛ والتصاميم المرسومة داخل الإطار
- 3.13إعدادات التمارينمدة القراءة: 12 دقيقةأنماط التمارين (exerciseStyles) وإعدادات التمارين في الكتاب (exercises): شارات الأرقام، وخط التعليمة، وتسميات الخيارات وعلامات التأشير، والفراغات، وإجابات صح أو خطأ، والتوصيل، وبنوك الكلمات، ومساحات الكتابة، والشبكات، والقسمة المطوّلة، وعلامات الصعوبة، والأيقونات، ولون الإجابات، وموضع طباعة الحلول، وطبعة المعلم، وطبعات الشاشة
- 3.14إعدادات القصص المصورةمدة القراءة: 8 دقائقإعدادات القصص المصورة: الإطار العام لصفحاتها والفواصل بين إطاراتها، وأنماط الإطارات، وكتابة الحوار، وأنماط الفقاعات، وقائمة الشخصيات
- 3.15إعدادات الصفحات المركّبةمدة القراءة: 10 دقائققوالب الصفحات المركّبة: الإطارات والمجموعات والشبكات التي تكرّر مجموعة إطارات والوحدات والزخرفة والموصلات والوراثة ونسختا الصفحة الفردية والزوجية؛ وأنماط التسميات التي تُكتب عند نقاط محددة من الصورة؛ والتحذيرات التي قد يصدرها القالب
- 3.16الخطوط والألوان والمخرجاتمدة القراءة: 40 دقيقةالوحدات والألوان ولوحة الألوان، والخطوط المخصّصة، وعارض HTML، وإنتاج PDF والإنتاج الطباعي، وعارض Folio، والتصحيح
- 3.17الاستخدام البرمجيمدة القراءة: 31 دقيقةاستعمال Postext من الشيفرة: buildDocument وتحذيراته، والقيم الافتراضية، والخطوط، والذاكرات المؤقتة، وWeb Worker
- 3.18ملفات PDFمدة القراءة: 29 دقيقةpostext-pdf من الشيفرة: التثبيت، والواجهة البرمجية، ومزوّدو الخطوط في المتصفح وفي Node، وخطوط CJK، وبايتات الموارد، والنص العمودي، والتشغيل في عامل، والملفات الجاهزة للطباعة
- 3.19HTML وFolio وEPUB وSCORMمدة القراءة: 17 دقيقةعرض الكتاب المُخرَج داخل صفحة ويب، وفي هيئة كتاب ثلاثي الأبعاد مع postext-folio، وفي ملف EPUB 3 ثابت التخطيط أو قابل لإعادة التدفق مع postext-epub، وفي حزمة SCORM لنظام إدارة التعلم مع postext-scorm
- 3.20حزم .postextمدة القراءة: 27 دقيقةفتح ملفات .postext وإخراجها ورسمها وإنشاؤها من الشيفرة، والحزم الثنائية اللغة، وملفات الإصدارات القديمة، والواجهة البرمجية منخفضة المستوى
- 4تقسيم الكلمات وضبط الأسطرمدة القراءة: 43 دقيقةكيف يقسّم Postext الأسطر ويضبط النص ويتحكم في التباعد بين الكلمات بخوارزمية Knuth-Plass
- 5صيغة المستندمدة القراءة: 15 دقيقةالجزء من Markdown الذي يقرؤه Postext: البيانات التمهيدية في أول الملف، والعناوين، والقوائم، وكتل الشيفرة؛ وما يتجاهله؛ وقواعد كتابة المستندات المصدرية
- 5.1التوجيهاتمدة القراءة: 35 دقيقةالتوجيهات (:::): الحاويات، والأعمدة، والورق، وفواصل الصفحات، والترقيم، والمسافات، والشعر، وجدول المحتويات والفهرس، وفواصل الأسطر، وترميز صفحات القصص المصورة
- 5.2التنسيق داخل السطر والصيغ الرياضيةمدة القراءة: 30 دقيقةالعلامات داخل السطر: التوكيد، والروابط، والشارات، والحروف الكبيرة المصغّرة، والجدولة، والنص العمودي، والعلامات الصينية واليابانية، واتجاه النص، وصيغ LaTeX
- 5.3الحواشي والإحالاتمدة القراءة: 14 دقيقةالحواشي السفلية، والإحالات والمراسي، والاستشهادات وقائمة المراجع، وعلامات الفهرس الأبجدي
- 5.4الصور والجداولمدة القراءة: 42 دقيقةالموارد في النص: الإحالة إليها وتضمينها، وترقيمها، وموضعها ومكان استقرار العنصر العائم، والتفاف النص حولها، ومقاس الصورة النقطية، والمناطق الآمنة، ونقاط الارتكاز في القصص المصورة، والرموز في التعليقات
- 5.5الفيديومدة القراءة: 9 دقائقموارد الفيديو: يوتيوب وفيميو وملفاتك الخاصة وبث HLS، وما يعرضه كل مُخرَج، وحقول الفيديو، وصورة الغلاف والعنوان، والمشغّلات، وشجرة VDT والحِزم، ومقاطع الفيديو التي تعمل على صفحات Folio
- 6الإخراج الصينيمدة القراءة: 33 دقيقةكيف ينضّد Postext النص الصيني أفقيًا وعموديًا: المناطق، وكسر الأسطر، وعروض علامات الترقيم، وضبط الأسطر بين المحارف، وشبكة المحارف، والكتب المجلّدة من اليمين، والأرقام القائمة، والعلامات، والروبي، والواريتشو، والأعداد الصينية، والخطوط
- 7الإخراج العربيمدة القراءة: 29 دقيقةكيف ينضّد Postext النص العربي: اتجاه النص وخوارزمية النص ثنائي الاتجاه، والكتب المجلّدة على اليمين، والكلمات الموصولة التي لا تُقطع ولا تُباعَد حروفها، وضبط الأسطر بالكشيدة، والحركات، والتوكيد، والأرقام وأنماط الترقيم، والأعداد الترتيبية بالحروف، والحواشي، والشعر العمودي، والمحتويات، والفهرس، والاستشهادات، والخطوط
- 8الإخراج اليابانيمدة القراءة: 36 دقيقةكيف ينضّد Postext النص الياباني عموديًا وأفقيًا: منطقة اليابان، وقواعد الكينسوكو، وبياض علامات الترقيم (الياكومونو)، والأقواس في بداية الفقرة، والصيغ العمودية، والفوريغانا، وعلامات التوكيد والخطوط الجانبية، والكانبون، والعدّادات، والعناوين بالأسطر المأخوذة (غيودوري)، والحواشي، والفهرس بترتيب غوجوون، والاستشهادات، والخطوط، ونصوص أوزورا بونكو
- 9القصص المصورةمدة القراءة: 38 دقيقةكيف ينضّد Postext القصص المصورة والمانغا من Markdown: صفحات تقطعها شجرة تقسيم، ورسوم إطارات تُقصّ حول منطقتها الآمنة، وحوار يُكتب آليًا من نص السيناريو (كلام وتفكير وهمس وصراخ ولاسلكي ومربعات سرد ومؤثرات صوتية)، وأنماط الفقاعات، ونقاط ارتكاز الشخصيات على الرسوم، والشرائط المصورة داخل النص، والصفحات الممتدة على صفحتين متقابلتين، والقراءة من اليمين إلى اليسار والكتابة العمودية، والترجمات، ومخرجات Canvas وPDF وHTML وEPUB
- 10التدوين الموسيقيمدة القراءة: 12 دقيقةكيف يصفّ Postext الموسيقى في الكتاب: تدوين مكتوب نصًّا بصيغ ABC أو MusicXML أو MEI أو Humdrum، يُنقش بعرض العمود ويُقسَّم إلى أسطر موسيقية تمتد عبر الأعمدة والصفحات، والأمثلة الموسيقية المرقّمة بوصفها موارد، ونمط المدوّنة، والمخرجات، وكيف تأتي دار نشر موسيقية بمدوّناتها
- 11التمارينمدة القراءة: 16 دقيقةكيف يصفّ Postext تمارين الكتاب المدرسي وكراسة التمارين: الحاوية :::exercise وأنواعها الاثنا عشر من الاختيار من متعدد إلى القسمة المطوّلة، والإجابات المكتوبة في Markdown، والترقيم، والحلول بعد التمرين أو مقلوبة أو في آخر الفصل أو آخر الكتاب، وطبعة المعلم، والفحوص، والتمارين التي يُجاب عنها على الشاشة في HTML وEPUB، وحدود الاختبار، والنتائج المرسلة إلى نظام إدارة التعلم في حزمة SCORM
- 12الصفحات المركّبةمدة القراءة: 40 دقيقةكيف تُكتب الصفحة المركّبة في Markdown: كتلة الصفحة التي تبدأ بأربع علامات «:» وتحدّد القالب؛ والإطارات والسمة slot التي توزّع المحتوى على إطارات القالب؛ والخانات المتكرّرة والوحدات؛ والتحذيرات التي تظهر حين لا يوافق المحتوى القالب أو حين يغطّي إطارًا آخر
- 12.1أشكال بتسمياتمدة القراءة: 8 دقائقأشكال تضع كلمات على صورة: تسميات عند مراسي المورد، ونص بديل وتعليق وملاحظة خاصة بالشكل، وكيف تُنضَّد التسمية، وتسميات بعيدة عن نقطتها بخطوط إشارة، ومفاتيح الخرائط والرموز داخل السطر، وتحذيرات التسميات
- 13الأحبار الخاصة والقص بالقالبمدة القراءة: 14 دقيقةالحبر الخامس، والأحبار المعدنية والفلورية، والرقائق بالختم الساخن، والأبيض المعتم والورنيش بوصفها ألوانًا خاصة لها تشطيب، والقص بالقالب: فتحات تخترق ورقة واحدة أو أكثر، وزوايا مستديرة وكتب بأشكال مقصوصة، وخط القص في ملف PDF، والفحص قبل الطباعة، وكيف يعرضها كل عارض
الجزء III · في التطبيق
- 14المساهمةمدة القراءة: 6 دقائقكيف تنضم إلى مجتمع Postext وتساهم في المشروع
- 15Sandboxمدة القراءة: 31 دقيقةواجهة Sandbox: شريط النشاط، ولوحات النص والكتب والفصول والموارد والخطوط، والتخطيط على الهواتف
- 15.1لوحتا التصميم والفحوصمدة القراءة: 40 دقيقةمجموعات لوحة التصميم وصفحاتها وبحثها وملخّصها، والتحذيرات الحيّة في لوحة الفحوص مجمّعة بحسب نوعها
- 15.2الصفحات المركّبةمدة القراءة: 21 دقيقةتحرير قوالب الصفحات وإطاراتها على الصفحة نفسها، والموصلات والأشكال، وخطوط الإشارة والمؤشرات والمفاتيح، والشبكات والوحدات ومكتبتها، وإعادة تشكيل الإطارات، وفحوص التداخل ورموز الألسنة، ومكتبة أنماط الإطارات، وفحص الصفحات المركّبة في كل طبعات الكتاب، ونقل نص الكتاب إلى Markdown، وإصلاح إطار بنقرة واحدة
- 15.3المعايناتمدة القراءة: 14 دقيقةتبويبات Canvas وPDF وFolio وHTML وEPUB 3 وSCORM في منطقة العرض الرئيسية: ما يعرضه كل منها وما يمكنه فعله
- 15.4الكتب وملفات Word والحفظمدة القراءة: 40 دقيقةالكتب والفصول، وتحرير صفحات القصص المصورة، واستيراد مستندات Word وتصديرها، وكيف يحفظ Sandbox عملك ويصدّره ويستورده
- 15.5الوكلاء والتضمين والإعدادات المسبقةمدة القراءة: 12 دقيقةأدوات WebMCP التي يستعملها وكلاء الذكاء الاصطناعي؛ وتضمين المكوّن PostextSandbox في تطبيقك، بخصائصه وما يحتاج إليه من CSS؛ وصيغة حزمة الإعداد المسبق
- 16كتب الصفحات المركّبةمدة القراءة: 22 دقيقةجولة في Sandbox على كتاب مدرسي من صفحات مركّبة: تصنع قالب صفحة وتملؤه من Markdown، وتكتب التسميات على خريطة، وتترجم الصفحة، وتعالج النص الذي لا يتّسع له إطاره، وتحدّد العناصر على الصفحة وفي النص، ثم ترسم شجرة بالموصلات، وملاحظات على خريطة بمؤشرات ومفتاح، وشبكة من بطاقات الصور، ومكتبة وحدات لسلسلة من الكتب
- 17النقل إلى صفحات مركّبةمدة القراءة: 13 دقيقةكيف تنقل كتابًا يحفظ نص صفحاته في أنماط العناوين إلى قوالب صفحات وMarkdown، إما بمساعد Sandbox «نقل النص إلى Markdown» وإما يدويًا، وما الذي تفحصه بعد ذلك، وكيف تستبدل بالخطوط المرسومة في صورة موصلات، وبالإطارات المرسومة واحدًا واحدًا شبكات ووحدات
- 18InDesignمدة القراءة: 9 دقائقالطريقتان لإدخال كتاب من InDesign إلى Postext، أي مستورد IDML الذي ينسخ ما يحمله المستند ومهارة الوكيل التي تستخلص قواعد إخراجه، ومتى تُستعمل كل منهما، وكيف يعيد مصدِّر IDML الكتاب إلى InDesign
- 19المهارةمدة القراءة: 10 دقائقثبّت مهارة postext-port في Claude Code أو Codex أو أي وكيل، ودعه يحوّل مصدرًا بصيغة PDF أو Word أو PowerPoint أو EPUB أو InDesign أو HTML إلى مشروع Postext يتبع إخراج الأصل
- 20سطر الأوامرمدة القراءة: 13 دقيقةملف تنفيذي واحد مكتفٍ بذاته لأنظمة macOS وLinux وWindows. يحوّل كتاب .postext أو مجلد كتاب أو ملفات Markdown منفردة إلى PDF وHTML وEPUB وصور للصفحات ومستند Word، وينشئ الحزم ويفحص الكتب، ويقدّم مخرجات JSON للبرامج النصية والوكلاء، مع حزمتين لـPython وRust تستخدمانه من الشيفرة
- 21WebMCPمدة القراءة: 12 دقيقةما يستطيع وكيل ذكاء اصطناعي في المتصفح أن يفعله في Sandbox بأدوات WebMCP، وعددها 64 أداة: أن ينظر إلى الصفحات، ويغيّر أي إعداد، ويحرّر النص، ويضيف الصور والجداول والخطوط، ويشغّل الفحوص، ويصدّر الكتاب، مع طريقة استدعاء كل أداة بوسائط وأجوبة حقيقية