محرّك إخراج مفتوح المصدر · v1.91.1

المنضّد القابل للبرمجة للويب

يأخذ Postext نص Markdown دلاليًا ويطبّق عليه قواعد تحريرية عمرها قرون، من ضبط الأسطر بخوارزمية Knuth-Plass إلى الأعمدة المتوازنة والعناصر العائمة التي تعرف مكانها، لينتج صفحات بجودة النشر في HTML أو Canvas أو في ملف PDF جاهز للطباعة.

كل صفحة تُحسب في متصفحك

Postext

باختصار

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

النص المكتوب

كل ما يقوله الراوي، مع وصف لما يظهر على الشاشة.

  1. 0:00

    على الشاشةبطاقة داكنة كُتب عليها «ماينتس · 1455» فوق خط ذهبي رفيع. خلف العنوان «على مدى خمسة قرون، تعلّمت الطباعة كيف تنضّد الصفحة.» تتصاعد السنة من 1455 إلى 2026 بأرقام مفرّغة ضخمة، وتحطّ حولها مصطلحات الطباعة بالعربية: الضبط، ضبط الأزواج، الأرامل، اليتامى، أعمدة متوازنة، تباعد الأسطر، شبكة خطوط الأساس، الكشـــيدة (مكتوبة بتطويل ظاهر)، عرض السطر، العناصر العائمة، الترويسات، الأنهار. تغوص الكاميرا في النقطة الأخيرة، فتغمر الشاشة باللون الذهبي.

    السردعلى مدى خمسة قرون، تعلّمت الطباعة كيف تُنضِّد الصفحة.

  2. 0:07

    على الشاشةالعنوان: «تعلّم الويب إخراج الواجهات. أما الصفحة، فلم يتعلّم تنضيدها قط.» نافذة متصفح على example.com/longform/article فيها مقال عربي مضبوط على ثلاثة أعمدة تُقرأ من اليمين إلى اليسار، عنوانه «لماذا يعجز الويب عن تنضيد الصفحة»؛ وتشير وسوم حمراء إلى «أنهار» من البياض، و«أرملة»، و«يتيمة»، و«تصادم» صورة تقع فوق النص، و«اختلال» العمود الأخير. بجانبها شريحة شيفرة نصها «column-count: 3;» ثم «…وقليل غير ذلك.» وقائمة مشطوبة بالعيوب نفسها: أنهار من الفراغ، الأرامل، اليتامى، التصادمات، أعمدة غير متوازنة. ثم تضطرب النافذة وتنهار.

    السردوتعلّم الويب إخراج الواجهات. أما الصفحات، فلا. فما زال النص الطويل ينكسر: أنهار، وأرامل، ويتامى، وتصادمات.

  3. 0:20

    على الشاشةبعد وميض أبيض ومرور خطوط زرقاء وذهبية وحمراء، يرتفع شعار Postext واسمه اللاتيني، مكتوبًا من اليسار إلى اليمين، مع العبارة «المنضّد القابل للبرمجة للويب». وتحتها: مفتوح المصدر · رخصة MIT · v1.15.0 · يعمل في متصفحك.

    السردإليكم Postext: المنضِّد القابل للبرمجة للويب.

  4. 0:26

    على الشاشةالقسم 01 من 07، «المحتوى يدخل»: «Markdown يقول ما هو كل عنصر.» ملف Markdown اسمه 03-why-postext.md يكتب نفسه بالعربية: موجّه :::part{number="I" title="الأسس"}، والعنوان «# لماذا Postext» مع {lead="الطباعة…"}، وفقرة «Postext **محرّك إخراج مفتوح المصدر** ينقل حرفة الطباعة التقليدية إلى الويب، كما يبيّن :ref{id="fig-flow"}.»، وسطر ::resource{id="fig-flow"}، وكتلة :::callout{type="try"} فيها «غيّر كلمة: تُنضَّد الصفحة من جديد.». بجانبه ملف config.ts يستدعي buildDocument بالقيمة layoutType: "double" ومتن textAlign: "justify" وhyphenation مفعّل مع locale: "ar"، تحت السطر «والإعدادات تقرّر كيف يبدو.» و«لا شيء من الإخراج يعيش في النص.»

    السردتكتب نص Markdown دلاليًا، يقول ما هو كل عنصر. والإعدادات تقرّر كيف يبدو.

  5. 0:35

    على الشاشةالقسم 02، «Pretext يقيس»: «يُقاس النص دون لمس DOM.» العنوان «لماذا Postext» وفقرته وإطار «غيّر كلمة: تُنضَّد الصفحة من جديد.» تُمسح واحدًا بعد آخر، وتعطي خطوط الأبعاد ارتفاعاتها بالنقاط؛ ولوحة شيفرة تعرض prepare(text, '25px Lora') وlayout(prepared, width, 38) يعيدان ارتفاعًا وعدد أسطر. شريطان يتسابقان عبر 10,000 فقرة: «إعادة التدفق في المتصفح · DOM» بالكاد يتحرك، و«PRETEXT · مقاييس CANVAS + حساب» يمتلئ في الحال، وعدّاد يصعد إلى 600× فوق «أسرع من DOM في قياس النص» و«فيُعاد إخراج كتاب كامل وأنت تكتب.» و«مدعوم بـ @chenglou/pretext».

    السردكل فقرة تُقاس دون لمس DOM، أسرع بما يصل إلى ستمئة مرة، بفضل Pretext، المكتبة التي جعلت ذلك ممكنًا.

  6. 0:46

    على الشاشةالقسم 03، «Postext يقرّر»: «كل سطر في موضعه قبل رسم أي بكسل.» حلقة من سبعة أجزاء تضيء تباعًا تحت «جولة 1 / 7»: البنية، القياس، الوضع، التعويم، التنقيح، الموازنة، الإيقاع، مع وصف من سطر واحد لكل منها، مثل «تحليل Markdown إلى كتل ذات أنواع» و«Knuth–Plass. لا أرامل ولا يتامى». بجانبها تتجمّع صفحة من عمودين من الطبعة العربية لدليل Postext: كتل موسومة تطير إلى أعمدتها، ويستقر «شكل 2.1» في مكانه تحت الملاحظة «:ref{id="fig-flow"} → أسفل العمود»، وينزل شريط الافتتاح، وتظهر الأسطر، وتتساوى الأعمدة تحت وسم «أعمدة متساوية»، وتمسح شبكة خطوط الأساس الصفحة نزولًا. تدور الحلقة في «حلقة التقارب» من «تكرار 1» إلى «تكرار 3» («5 على الأكثر، حتى لا يتحرّك شيء») وتعرض «استقرّ بعد 3 تكرارات» و«تقارب» مع علامة صح؛ ويعرض إطار مربع إحاطة سطر واحد (bbox) وخط أساسه.

    السردثم يقرّر Postext. سبع جولات تضع كل سطر، وتُنزل كل شكل في موضعه، وتوازن كل عمود، وتتكرّر حتى لا يتحرّك شيء.

  7. 1:00

    على الشاشةالقسم 04، «المستند الافتراضي»: «غيّر كلمة. لا يُعاد تنضيد إلا ما تغيّر.»، مع الملاحظة «مثل virtual DOM في React، لكن للصفحات: VDT، شجرة مستند افتراضية.» سبع صفحات من الدليل العربي، من p. 7 إلى p. 13، مصفوفة في صف يبدأ من اليمين؛ مؤشر كتابة يعلّم «تعديل» في p. 11، فيتحوّل باقي ذلك العمود إلى الذهبي بوسم «مُعلَّم»، وينسكب جزء يسير إلى p. 12 التي تنال علامة صح ووسم «مستقر»، بينما تحمل الصفحات السابقة وسم «متجاوَز» واللاحقة وسم «لم يُمَسّ». ثلاث نقاط تعرض القاعدة، ولوحة عنوانها renderToHtmlIndexed() و«لا يحدّث من DOM إلا ما تغيّر» تعلّم العقد المتغيّرة في شجرة المستند بوسم «حُدِّث».

    السردكل ذلك يعيش في مستند افتراضي، مثل virtual DOM في React. غيّر كلمة واحدة، فلا يُعاد تنضيد إلا ما تغيّر.

  8. 1:11

    على الشاشة«مستند طويل؟ لا يُرسم إلا ما يظهر على الشاشة.» عمود من صفحات الدليل العربي يمرّ عبر إطار ذهبي اسمه VIEWPORT، مع هامش +200 px فوقه وتحته: الصفحات داخله مرسومة كاملة، والصفحات خارجه حدود متقطعة. عدّاد كبير يعرض عدد الصفحات المرسومة في تلك اللحظة من أصل 61 تحت «صفحات مرسومة الآن» (IntersectionObserver · +200 px)، بجانب «الهندسة: كل الصفحات.» و«البكسلات: ما تراه فقط.» و«تُرسم الصفحات حين تدخل مجال الرؤية وتُحرَّر حين تغادره.»

    السردوفي الكتاب الطويل، لا تُرسم إلا الصفحات الظاهرة على الشاشة.

  9. 1:18

    على الشاشةالقسم 05، «ضبط الأسطر بخوارزمية Knuth–Plass»: «كل طرق تقسيم الفقرة. دفعة واحدة.» على اليمين فقرة عربية عن تقسيم الأسطر منضّدة بطريقة «التقسيم الجشع · المتصفح»، وتتحوّل أرخى أسطرها إلى الأحمر. وتحتها تصير كل كلمة نقطة على خط: أقواس حمراء تعلّم «قطع جشع»، وأقواس زرقاء باهتة تجرّب «كل نقاط القطع الممكنة»، ومسار ذهبي يختار أفضل مجموعة. وعلى اليسار نسخة «KNUTH–PLASS · POSTEXT» متساوية التباعد، مع «نقاط الجزاء لكل سطر»، والصيغة «(1 + الرداءة + الجزاء)²»، ومجموع «Σ نقاط الجزاء» أدنى.

    السردالمتصفح يقسّم الأسطر بجشع، سطرًا تلو الآخر. أما Postext فيستخدم Knuth-Plass، خوارزمية TeX. تزن كل طرق تقسيم الفقرة كاملة، وتختار أكثرها تناسقًا.

  10. 1:35

    على الشاشةالقسم 06، «إخراج واحد، خمسة مُخرَجات»: «ما تراه هو ما يُطبع.» تحت سطر الشيفرة const vdt = buildDocument(content, config); تنقسم صفحة واحدة من الدليل العربي إلى خمس، مصفوفة من اليمين إلى اليسار. Canvas (renderToCanvas()، «صور نقطية دقيقة حتى البكسل») تمرّ فوق شبكة بكسلاتها عدسة مكبّرة؛ وHTML (renderToHtml()، «قابل للتحديد ويتكيّف مع الحجم») تُحاط كل كتلة فيه بإطار وتُوسم <h1> و<p> و<figure> وغيرها؛ وPDF (renderToPdf()، «جاهز للطباعة · PDF/UA · CMYK») تنزلق فيه أربعة ألواح ألوان حتى تتطابق، ثم تظهر علامات القص وشريط الألوان؛ وEPUB 3 (renderToEpub()، «كتاب إلكتروني · ثابت أو متدفّق») قارئ إلكتروني يحمل الصفحة تحت وسم «تخطيط ثابت»، ثم يضيق إلى عرض هاتف ويتدفّق النص فيه تحت وسم «قابل لإعادة التدفق»؛ وFolio (postext-folio، «كتاب ثلاثي الأبعاد تُقلَّب صفحاته») تنفتح فيه الصفحة إلى صفحتين متقابلتين وتنقلب ورقة فوق الكعب من اليسار إلى اليمين، كما يُقلَّب كتاب عربي.

    السردإخراج واحد، وخمسة مُخرَجات: canvas، و HTML، و PDF للطباعة، و EPUB 3 ثابت أو متدفّق، وكتاب ثلاثي الأبعاد. ما تراه هو ما يُطبع.

  11. 1:52

    على الشاشةالقسم 07، «لماذا معيار مفتوح»: «LaTeX وضع معيار الورق.» و«لكن النشر اليوم يعيش على كل شاشة أيضًا.» بطاقتان: على اليمين LaTeX، 1984، مع علامات خطأ أمام «صُمّم للصفحة المطبوعة» و«بناء مرتبط بخطوط جهاز واحد وحزمه» و«تصريف، فانتظار، فتكرار» و«لا إخراج تحريري على الويب المتجاوب»؛ وعلى اليسار Postext، 2026، مع علامات صح أمام «الويب وPDF للطباعة وEPUB 3 من إخراج واحد» و«ملف .postext واحد قابل للنقل يحمل كل شيء» و«يُعاد الإخراج مباشرة وأنت تكتب» و«في أي متصفح · بلا خوادم · MIT». ثم تخفت بطاقة LaTeX وتضيء بطاقة Postext.

    السردوضع LaTeX معيار الورق. لكن النشر اليوم يعيش على كل شاشة.

  12. 1:59

    على الشاشةالعنوان التمهيدي «07 · ملف واحد، الكتاب كله»، والعنوان «معيار مفتوح للنشر، يبلغ ما لم يبلغه LaTeX.» تنفجر أيقونة ملف .postext إلى خمسة أجزاء: preset.json (الإعدادات والتصميم)، وchapters/*.md (ملف Markdown لكل فصل)، وfonts/*.woff2 (الخطوط نفسها)، وimages/ · SVG (كل صورة، مضمَّنة)، وresources (الجداول والأشكال والتعليقات). والتعليق: «ملف ZIP عادي: مفتوح وموثَّق وبرخصة MIT. تستطيع أي أداة أن تقرأه وتكتبه.»

    السردو Postext معيار مفتوح: ملف واحد قابل للنقل، موثَّق وبرخصة MIT، تستطيع أي أداة أن تقرأه وتكتبه.

  13. 2:13

    على الشاشة«المعرض · من تنضيد المحرّك الحقيقي»: على اليسار جدار من صفحات الطبعة العربية لدليل Postext يبتعد في منظور، وعلى اليمين عدّاد يبلغ 61 صفحة. النص: «12 فصلًا، و3 أجزاء، وغلاف، أُخرجت في نحو نصف ثانية.» و«كل صفحة من دليل Postext، محسوبة في متصفح بواسطة postext v1.15.0 لهذا الفيلم. لا شيء وُضع يدويًا.» ثم وسوم: كتب مدرسية، مجلات، طبعات أدبية، كتالوجات.

    السردولهذا يستطيع أن يُخرج كتبًا من مئات الصفحات في أعشار من الثانية.

  14. 2:21

    على الشاشةبطاقة الختام: شعار Postext واسمه اللاتيني مع العبارة «المنضّد القابل للبرمجة للويب»، والعنوان postext.dev، وسطر طرفية يكتب من اليسار إلى اليمين «$ pnpm add postext»، والتذييل «مفتوح المصدر · MIT · GITHUB.COM/DRNACHIO/POSTEXT».

    السردPostext. مفتوح المصدر، على postext.dev.

الفصل 1 · لماذا Postext

إخراج تحريري يُحسب للويب

قضى فن الطباعة خمسة قرون يتعلّم كيف تُنضَّد الصفحة، وتعلّمت المتصفحات كيف تُرتَّب الواجهة. ينقل Postext الأول إلى الثانية.

تمنحك CSS تخطيطًا متجاوبًا: flexbox وgrid والأعمدة. لكنها لا تستطيع موازنة الأعمدة، ولا إبقاء العنوان مع فقرته، ولا منع الأسطر الأرامل واليتيمة، ولا جعل شكلٍ يطفو إلى رأس العمود التالي. هذه قرارات تحريرية صُقلت عبر قرون من الطباعة.

يسدّ Postext هذه الفجوة. تعطيه نص Markdown دلاليًا وكائن إعدادات، فيقيس النص أسرع من DOM بما بين 300 و600 مرة باستخدام @chenglou/pretext (يفتح في تبويب جديد)، ثم يحسب هندسة الصفحة كاملة، كل سطر وكل عنصر عائم وكل تعليق، ويرسمها مُخرِج HTML أو Canvas أو PDF الجاهز للطباعة.

Markdown يدخل

:::part{number="I" title="الأسس"
  palette="band=#2b4acb"}
:::

# لماذا Postext {lead="أمضت الطباعة
خمسة قرون…"}

Postext **محرّك إخراج مفتوح
المصدر** ينقل صنعة الطباعة
إلى الويب، كما يبيّن
:ref{id="fig-flow"}.

:::callout{type="try"}
غيّر كلمة واحدة: تُنضَّد
الصفحة من جديد.
:::

صفحات تخرج

الشكل 1.1 نص Markdown نفسه قبل المحرّك وبعده: صفحة افتتاح فصل، وعمودان متوازنان، وشكل يطفو إلى رأس عمود.

بالأرقام

أسرع من DOM في قياس النص، فيُعاد إخراج كتاب كامل وأنت تكتب
300–600×أسرع من DOM في قياس النص، فيُعاد إخراج كتاب كامل وأنت تكتب
مخرجات من إخراج واحد: HTML وCanvas وPDF الجاهز للطباعة وEPUB 3
4مخرجات من إخراج واحد: HTML وCanvas وPDF الجاهز للطباعة وEPUB 3
مُخرَج PDF موسوم وقابل للوصول، مع إشارات مرجعية وألوان CMYK
PDF/UAمُخرَج PDF موسوم وقابل للوصول، مع إشارات مرجعية وألوان CMYK
خوادم: يعمل المحرّك كاملًا في المتصفح، بترخيص MIT
0خوادم: يعمل المحرّك كاملًا في المتصفح، بترخيص MIT

الفصل 2 · القدرات

ما عرفه المنضّدون في الطباعة منذ البداية

ستة أمور تحتاج إليها الصفحة ولم تُصمَّم CSS قط لتقرّرها، يحسبها المحرّك بالطريقة نفسها في كل مرة.

  1. 2.1

    ضبط الأسطر بخوارزمية Knuth-Plass

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

    اقرأ في التوثيق
  2. 2.2

    الموارد والإحالات

    تطفو الأشكال ومخططات SVG والجداول إلى أعلى الأعمدة والصفحات أو أسفلها، كما تطفو العناصر في الطباعة، مع ترقيم حسب النوع وإحالات ⁦:ref⁩ تبقى متزامنة دائمًا.

    اقرأ في التوثيق
  3. 2.3

    الجداول والتعليقات

    جداول تُنضَّد بخطوط مستقلة للمتن والرأس، وتنقسم عبر الصفحات مع تكرار رؤوسها، وتعليقات تتبع إعداداتك: مرقّمة وموضوعة بجانب المورد الذي تصفه.

    اقرأ في التوثيق
  4. 2.4

    مخططات بحبر واحد

    أعد تلوين مخططات SVG بدرجات حبر واحد حسب الإضاءة، فتتسق كل الرسوم مع تصميمك، جاهزة للطباعة بالألوان الخاصة (spot colour).

    اقرأ في التوثيق
  5. 2.5

    رياضيات LaTeX

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

    اقرأ في التوثيق
  6. 2.6

    الويب وPDF الجاهز للطباعة وEPUB

    محرّك إخراج واحد وأربعة مخرجات. تُرسم الصفحات المحسوبة نفسها في HTML أو Canvas أو تصير ملف PDF جاهزًا للطباعة، مع إشارات مرجعية وألوان CMYK ومخرجات PDF/UA موسومة وقابلة للوصول، وتصدر كتابًا إلكترونيًا بصيغة EPUB 3، صفحة بصفحة أو قابلًا لإعادة التدفق.

    اقرأ في التوثيق
كل صفحة في دليل Postext، من الغلاف والمحتويات إلى فواصل الأجزاء وغيرها، ينضّدها Postext في متصفحك وأنت تقرؤها.
— بيانات الطبع في الدليل المدمج

معرض الأعمال

كتب حقيقية تُنضَّد في متصفحك

كتاب مدرسي، ومجلة، وملحمة شعرية مشروحة، وفهرس معرض، ورواية صينية كلاسيكية في 120 فصلًا، وألف ليلة وليلة بالعربية، ورواية يابانية منضّدة عموديًا، وقصة مصورة بعشر لغات. افتح أيًّا منها في Sandbox، وغيّر قاعدة، وشاهد كل صفحة يُعاد إخراجها.

الفصل 3 · سير العمل

ثلاث خطوات إلى إخراج بجودة النشر

المحتوى في Markdown، والتصميم في كائن إعدادات، والصفحات من استدعاء دالة واحدة.

  1. 3.1

    اكتب Markdown دلاليًا

    اكتب محتواك بـ Markdown مُعزَّز: عناوين وقوائم وجداول ورياضيات وإطارات وإحالات ⁦:ref⁩ إلى أشكالك. لا شأن لك بالإخراج، المحتوى فقط.

  2. 3.2

    اضبط قواعد الإخراج

    حدّد مقاس الصفحة والأعمدة والخطوط وتصاميم العناوين والترويسات ومواضع العناصر العائمة في كائن PostextConfig، أو صمّمها بصريًا في Sandbox.

  3. 3.3

    ارسم الصفحات في HTML أو Canvas أو PDF

    استدعِ buildDocument لتتلقى هندسة الإخراج كاملة، ثم ارسمها بمُخرِج HTML أو Canvas أو PDF الجاهز للطباعة.

API

دالة واحدة وتحكم كامل

استدعِ buildDocument بمحتواك وكائن إعدادات، فتحصل على هندسة الصفحات كاملة: ارسم أي صفحة صورةً بـ renderPage، أو نضّد الكتاب كله ملف PDF جاهزًا للطباعة بـ renderToPdf.

book.ts
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";

const doc = buildDocument(
  { markdown },
  {
    page: { sizePreset: "21x28" },
    layout: { layoutType: "double" },
    bodyText: {
      fontSize: { value: 12, unit: "pt" },
      textAlign: "justify",
      hyphenation: { enabled: true, locale: "en-us" },
    },
  }
);

// كل صفحة صورةً…
const cover = renderPage(doc.pages[0], doc);
cover.toBlob((png) => save(png, "cover.png"));

// …أو الكتاب كله ملف PDF جاهزًا للطباعة
// fontProvider: بايتات TTF لكل عائلة خط ووزن (انظر التوثيق)
const pdf = await renderToPdf(doc, { fontProvider });

الفصل 4 · صيغة مفتوحة

ملف واحد، الكتاب كله

يضمّ ملف ⁦.postext⁩ كل ما يحتاج إليه المستند ليُنضَّد من جديد على أي جهاز: صيغة مفتوحة قابلة للتحرير يستطيع أي أحد اعتمادها.

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

ملف ⁦.postext⁩ أرشيف ZIP عادي يستطيع أي أحد فتحه وقراءته وتحريره: بيان JSON، وملف Markdown لكل فصل، وملفات الخطوط والصور نفسها. يصدّره Sandbox، وتكتبه مهارة الوكيل postext-port، وتفتحه postext/bundle في أي برنامج لتنضيد الصفحات نفسها من جديد. الصيغة موثّقة ومرخّصة بـMIT، وجاهزة لتقرأها أي أداة وتكتبها.

داخل postext-guide.postext
  1. 4.1preset.json

    الإعدادات. الصفحة والشبكة والخطوط وأنماط العناوين والفقرات والألوان والترويسات، بصيغة JSON مقروءة.

  2. 4.2chapters/<lang>/*.md

    الفصول. ملف Markdown لكل فصل: 22 من الفصول بـ 2 من اللغات هنا.

  3. 4.3fonts/*.woff2

    الخطوط. ملفات الخطوط نفسها لا أسماؤها فقط: 23 من الملفات لعائلات Lora وFraunces وGeist وBricolage Grotesque وGeist Mono.

  4. 4.4preset.json › resources

    الموارد. التعليقات والترقيم والمواضع ومحتوى الجداول للأشكال والجداول التي يحيل إليها النص، وعددها 31.

  5. 4.5resources/*.svg

    الصور. الرسوم نفسها، SVG أو نقطية، مع نسخة كل لغة: 43 من الملفات.

الشكل 4.1 ملف ⁦.postext⁩ الخاص بالدليل نفسه، 1387 KB: كل ما يحتاج إليه الكتاب، ولا شيء عليه أن يجلبه.

جرّبه

افتح الدليل واحصل على صفحاته

أول أمثلة Sandbox، دليل Postext، ملف ⁦.postext⁩ واحد. افتحه في المتصفح وحوّل كل صفحة إلى صورة: خطوطه وأشكاله وجداوله تأتي من الملف نفسه.

نزّل الدليلpostext-guide.postext · 1387 KB
open-guide.js
import { openBundle, loadBundleFonts, registerBundleImages,
  buildBundle, renderPageToCanvas } from "postext";

// دليل Sandbox: الإعدادات والفصول والخطوط والصور
const file = await fetch("postext-guide.postext").then((r) => r.blob());
const book = await openBundle(file, { locale: "en" });

await loadBundleFonts(book);      // خطوطه الخاصة
await registerBundleImages(book); // أشكاله الخاصة

// كل صفحة من كل فصل، صورةً
for (const doc of buildBundle(book))
  for (const page of doc.pages) {
    const canvas = document.createElement("canvas");
    renderPageToCanvas(page, doc, canvas, { scale: 0.5 });
    document.body.append(canvas);
  }

التثبيت

ابدأ في أقل من دقيقة

حزمة واحدة، بلا خادم، وبلا اعتماديات أصلية. أضف postext-pdf حين تحتاج إلى الطباعة.

quick-start.ts
// بداية سريعة
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";

const doc = buildDocument({
  markdown: "# Hello World\n\nYour content here.",
});

// الصفحة الأولى مرسومة في عنصر canvas
document.body.append(renderPage(doc.pages[0], doc));

// المستند كله ملف PDF
const pdf = await renderToPdf(doc, { fontProvider });