# صيغة المستند: التنسيق المضمّن والصيغ الرياضية

> العلامات داخل السطر: التوكيد، والروابط، والشارات، والحروف الكبيرة المصغّرة، والجدولة، والنص العمودي، والعلامات الصينية واليابانية، واتجاه النص، وصيغ LaTeX

- نسخة HTML: https://postext.dev/ar/docs/document-format-inline
- آخر تحديث: 2026-10-16
- مدة القراءة: 26 دقيقة
- لغات أخرى: [en](https://postext.dev/en/docs/document-format-inline.md), [es](https://postext.dev/es/docs/document-format-inline.md), [ca](https://postext.dev/ca/docs/document-format-inline.md), [de](https://postext.dev/de/docs/document-format-inline.md), [fr](https://postext.dev/fr/docs/document-format-inline.md), [it](https://postext.dev/it/docs/document-format-inline.md), [pt](https://postext.dev/pt/docs/document-format-inline.md), [zh](https://postext.dev/zh/docs/document-format-inline.md), [ja](https://postext.dev/ja/docs/document-format-inline.md)

## باختصار

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

## التنسيق المضمّن

يُتعرَّف على الترميز المضمّن داخل أي كتلة نصية (العناوين والفقرات والاقتباسات الكتلية وعناصر القوائم). وفي العنوان يتبع الإعداد `headings.inlineMarks`، المفعّل افتراضيًا: يُطبع ما في العنوان من مائل وعريض وأحرف فوقية وسفلية وحروف كبيرة مصغّرة وروابط كما يُطبع في الفقرة، ويخرج المقطع المائل في عنوان مائل قائمًا. وإذا أُوقف الإعداد أُسقطت العلامات وطُبع العنوان بنمطه الخاص؛ وعلى هذا النحو تُقرأ الإعدادات التي حفظها postext 1.4 أو ما قبله إذا كانت عناوينها تحمل علامات (انظر [الإعدادات › العناوين](https://postext.dev/ar/docs/configuration-headings.md#العناوين)). أما تصميم العنوان فيطبع `{titleText}` نصًا عاديًا في الحالتين.

> **شكل: التنسيق المضمّن في لمحة**
> مقارنة بين Markdown والنتيجة المعروضة للعريض والمائل والعريض المائل والشيفرة المضمّنة والروابط.
>
> *Markdown على اليسار، والنتيجة المعروضة على اليمين.*

| الترميز | الصيغة | ملاحظات |
| --- | --- | --- |
| عريض | `**bold**` أو `__bold__` | يُرسم بالوزن `bodyText.boldFontWeight`. ويستبدل الإعداد الاختياري `bodyText.boldColor` لونَ المتن الافتراضي في المقاطع العريضة. |
| مائل | `*italic*` أو `_italic_` | يُرسم بالشكل المائل من عائلة الخط الحالية. ويستبدل الإعداد الاختياري `bodyText.italicColor` لونَ المتن الافتراضي في المقاطع المائلة. لا تدلّ الشرطة السفلية على التوكيد إلا عند حدّ كلمة، كما في CommonMark: الشرطة الواقعة بين حرفين أو رقمين — `snake_case_name`، أو `SR_AIR_EN.pdf` في عنوان URL — تبقى نصًا (وكذلك في `__bold__`)؛ وداخل الكلمة استعمل النجمات (`un*believ*able`). ولا تُحتسب هنا حروف الصينية واليابانية والكورية، لأن هذه الكتابات لا مسافات فيها: `中文_斜体_中文` و`中文__粗体__中文` مائل وعريض. والشرطتان `__` اللتان لا تصنعان عريضًا لا تصيران مائلًا أبدًا: تبقى `foo__bar__baz` نصًا. |
| عريض مائل | `***both***` أو `___both___` | تجتمع الخاصيتان. |
| حرف فوقي | `^text^` | يُنضَّد بنسبة 58% من حجم النص ويُرفع ثلث ذلك الحجم — أُسّ (`10^-8^`)، أو شحنة أيون (`Na^+^`). يبدأ النص المعلَّم وينتهي بحرف غير المسافة؛ وتبقى علامة الإقحام المنفردة في النثر حرفًا حرفيًا، وكذلك الوجهان `^_^` و`^o^` (أما `n.^o^` و`1^o^` فتبقيان حرفين فوقيين). |
| حرف سفلي | `~text~` | بالحجم نفسه، ويُخفض 0.15 من حجم النص فيبقى ضمن نطاق الأذيال السفلية — دليل كيميائي (`H~2~O`، `p<em>K</em>~a~`). والمدّة (~) التي على جانبيها رقمان مدى، فتبقى حرفًا حرفيًا: `3~5 days`، `需要3~5天`. وكذلك المدّة الواقعة بين كلمتين صينيتين، فلا تفتح حرفًا سفليًا: `周一~周五`، `北京~上海`؛ ومع ذلك يُغلق الحرف السفلي قبل حرف صيني (`F~合~等于`). يجتمع مع العريض والمائل (`**H~2~O**`). والحرف السفلي والحرف الفوقي المكتوبان معًا دون شيء بينهما يُكدَّسان كما في الصيغة: `*T*~0~^2^` تضع 2 فوق 0 أيهما جاء أولًا، ويُخفض الحرف السفلي 0.25 من حجم النص ليبتعد عن الفوقي، ويأخذ الزوج عرض الأعرض منهما. وإذا فصلت بينهما مسافة أو حرف نُضِّدا متتاليين؛ وكذلك يفعل رابط الكلمات (U+2060)، دون أن يظهر بينهما شيء. ولا ينفصل الزوج المكدَّس عند فاصل السطر أبدًا: الكلمة الأعرض من السطر تنكسر قبل الزوج. |
| حروف كبيرة مصغّرة | `:smallcaps[text]` | تُنضَّد الحروف الصغيرة حروفًا كبيرة بنسبة 70% من حجم النص — اسم شخصية في مسرحية، أو اختصار في النص الجاري. تقبل علامات أخرى داخلها وحولها؛ انظر [الحروف الكبيرة المصغّرة](https://postext.dev/ar/docs/document-format-inline.md#الحروف-الكبيرة-المصغّرة). |
| الاتجاه في النص العمودي | `:tcy[12]`، `:upright[GDP]`، `:sideways[12]` | في النص العمودي: خانة واحدة قائمة (tate-chu-yoko)، أو كل حرف قائم في خانة خاصة به، أو المقطع كله مُدار. لا أثر لها في النص الأفقي؛ انظر [الاتجاه في النص العمودي](https://postext.dev/ar/docs/document-format-inline.md#الاتجاه-في-النص-العمودي). |
| العلامات الصينية | `:dots[不可]`، `:name[賈寶玉]`، `:book[石頭記]` | نقاط التوكيد (着重号)، وخط أسماء الأعلام (专名号)، وعلامة عنوان الكتاب (书名号: 《》 أو خط متموّج، بحسب `cjk.bookTitleMark`). يبقى النص كما كُتب؛ انظر [العلامات الصينية والقراءات (ruby) والتعليقات السطرية (warichu)](https://postext.dev/ar/docs/document-format-inline.md#العلامات-الصينية-والقراءات-ruby-والتعليقات-السطرية-warichu). |
| القراءات (ruby) | `:ruby[紅樓]{rt="hóng lóu"}` أو `{紅樓\|hóng\|lóu}` | قراءات بالبينيين (pinyin) أو الجوين (zhuyin) فوق الحروف الأساسية (أو بجانبها). تحتاج الصيغة المختصرة إلى أساس من حروف الهان أو الكانا أو البوبوموفو، لذا تبقى `{x\|x>0}` نصًا. |
| التعليق السطري (warichu) | `:warichu[note]{open="〔" close="〕"}` | تعليق يُنضَّد في صفّين بنصف الحجم داخل السطر (双行夹注)، ويُقسَم عبر الأسطر والصفحات. |
| الشيفرة المضمّنة | `0` | تُحذف علامات الاقتباس المائلة؛ ويُرسم المقطع نصًا عاديًا كما كُتب بالضبط: ما بداخله من `:ref{…}` أو شارة أو صيغة رياضية أو رابط أو علامة توكيد يُطبع حرفيًا، وبهذا يعرض النص الصيغة. وتُنضَّد بخط النص، أو مع `codeStyle.inline` بخط الشيفرة وحدةً واحدة (انظر [الإعدادات › قوائم الشيفرة](https://postext.dev/ar/docs/configuration-styles.md#قوائم-الشيفرة)). أما قائمة الشيفرة فتوضع في [كتلة شيفرة](https://postext.dev/ar/docs/document-format.md#كتل-الشيفرة). |
| التهريب | `\*`، `\_`، `\^`، `\~`، ``\```، `\$` | تُنضّد الشرطة المائلة العكسية حرف العلامة نفسه — نجمة حاشية الجدول (`\* pOH = −log [OH^−^]`)، أو علامة إقحام حرفية، أو علامة دولار لا تفتح صيغة — بدل أن تفتح مقطعًا. تعمل في المتن وفي الشارات وفي التعليقات والخلايا والحواشي. (حتى postext 1.4 كانت التعليقات والخلايا والحواشي والشارات تطبع الشرطة المائلة العكسية في `\$`.) |
| مسافة غير فاصلة | الحرف نفسه: U+00A0 وU+202F وU+2007 | تلصق الكلمتين على جانبيها، فلا ينكسر السطر بينهما أبدًا: عدد ووحدته (37 °C)، أو إحالة إلى صفحة (ص. 12)، أو مجموعة آلاف (225 000). المسافة غير الفاصلة (U+00A0)، والمسافة الضيقة غير الفاصلة (U+202F)، ومسافة الرقم (U+2007) كلها تلصق — في المتن والتعليقات والخلايا والإطارات والترويسات — وتحتفظ كل منها بعرضها: ضبط الأسطر يمدّ المسافات بين الكلمات وحدها. كثير من الخطوط لا تملك رسمًا للمسافة الضيقة غير الفاصلة أو لمسافة الرقم؛ فتُنضَّدان حينئذ كما تنضّدهما المتصفحات، في Canvas وفي HTML وفي PDF على السواء: نصف مسافة كلمة، وعرض رقم. وتكاد كل الخطوط تملك U+00A0، فهي الخيار الآمن. والمجموعة الملتصقة على هذا النحو إذا كانت أعرض من السطر كله تنكسر عند آخر مسافة غير فاصلة فيها لا داخل كلمة. ويلصق رابط الكلمات (U+2060) دون أن يشغل حيزًا. اكتب الحرف نفسه: كيان HTML مثل ` ` يُطبع كما كُتب. انظر [حيث لا ينكسر السطر أبدًا](https://postext.dev/ar/docs/justification.md#حيث-لا-ينكسر-السطر-أبدًا). |
| واصلة لينة | الحرف نفسه: U+00AD | موضع يجوز أن تُقسم عنده الكلمة، وتُضاف واصلة إذا انتهى السطر عنده: بين حرفين أو رقمين لا غير. والكلمة التي فيها واصلة لينة لا تأخذ من القاموس أي موضع قسمة آخر، فتكون الواصلة اللينة موضع قسمتها الوحيد؛ وإذا كُتبت قبل الحرف الأول من الكلمة لم تقسم شيئًا وأبقت الكلمة كاملة في ذلك الموضع. وبجوار قوس أو علامة اقتباس أو علامة ترقيم لا تفعل شيئًا. انظر [حيث لا ينكسر السطر أبدًا](https://postext.dev/ar/docs/justification.md#حيث-لا-ينكسر-السطر-أبدًا). |
| رابط | `[text](https://…)` | يبقى النص الظاهر في التدفق، منضّدًا كما يُنضَّد بلا رابط تمامًا. ويجعل عنوان URL الكلماتِ رابطًا فعّالًا في مخرجات HTML وPDF؛ انظر [الروابط](https://postext.dev/ar/docs/document-format-inline.md#الروابط). |
| صورة | `![alt](src)` | **تُحذف** صيغة Markdown للصورة المضمّنة من النص. يجب التصريح بالصور في `PostextContent.resources` ليضعها محرّك الإخراج وفق قواعد `resourcePlacement`. |
| شارة | `:chip[text]` | مقطع نصي داخل إطار يلتف كوحدة واحدة — بنك كلمات، أو مفتاح، أو وسم. يُنسَّق بـ`chipStyles`؛ انظر [الشارات المضمّنة](https://postext.dev/ar/docs/document-format-inline.md#الشارات-المضمّنة). |
| جدولة | `:tab`، `:tab{at=120mm align=end leader="."}` | ترسل الكلمات التي تليها إلى موضع الجدولة التالي: أحد مواضع نمط الفقرة، أو الموضع الذي تحدّده سماتها. ومحرف الجدولة المكتوب في النص لا يكون جدولة إلا حيث يحدّد النمط مواضع. انظر [الجدولة ومواضع الجدولة](https://postext.dev/ar/docs/document-format-inline.md#الجدولة-ومواضع-الجدولة). |
| صيغة رياضية مضمّنة | `$…$` | صيغة LaTeX تجري مع النص المحيط بها، مثل `$e^{i\pi}+1=0$`. ينضّدها MathJax وتُرسم مسارات متجهية في كل المُخرِجات. استعمل `\\$` لعلامة دولار حرفية. أما التحجيم وصيغة العرض (`$$ … $$`) ومعالجة الأخطاء فمشروحة في [الصيغ الرياضية](https://postext.dev/ar/docs/document-format-inline.md#الصيغ-الرياضية). |

### الروابط

رابط Markdown، `[text](url)`، يُبقي نصه في التدفق كما كان سيُنضَّد بدونه تمامًا: لا يغيّر الرابط فواصل الأسطر ولا المسافات ولا اللون أبدًا. ويحتفظ بعنوان URL للمخرجات التي تستطيع اتباعه:

- **HTML** (`renderToHtml`): تُلفّ الكلمات المرتبطة في `<a href="…" rel="noopener noreferrer">`، الذي يأخذ لون النص بلا خط تحته. وثمة مرساة واحدة لكل سلسلة من الكلمات المرتبطة في السطر.
- **PDF** (`postext-pdf`): تصير كل سلسلة من الكلمات المرتبطة في السطر تعليقًا توضيحيًا لرابط URI قابلًا للنقر. وفي PDF الموسوم يكون عنصر `Link` نصُّه الكلمات المرتبطة.
- **Canvas**: يُرسم نصًا عاديًا، إذ لا سطح للنقر في Canvas.

```markdown
Read the [configuration guide](https://postext.dev/en/docs/configuration "Configuration")
or write to [the team](mailto:team@example.com).
```

- قد تحمل الوجهة عنوانًا، ويُتجاهل (`[text](https://example.com "Title")`). وقد تُلفّ أيضًا بين قوسين زاويين، وحينئذ تصير المسافات `%20` (`[text](<https://example.com/a b>)`).
- لا يُحتفظ إلا بالوجهات الآمنة: `http:` و`https:` و`mailto:` و`tel:` و`ftp:` وعناوين URL النسبية (`../guide`، `#top`). وأي مخطط آخر (`javascript:`، `data:`، `file:`…) يُنضّد النص بلا رابط. ولا يربط PDF إلا عناوين URL المطلقة.
- قد تحتوي الوجهة على أقواس ما دامت متوازنة، كما في CommonMark: `[photo](https://commons.wikimedia.org/wiki/File:Bike_(Unsplash).jpg)` يربط عنوان URL كاملًا. وتهرّب الشرطة المائلة العكسية حرفًا (`\(`، `\_`). فإن لم تتوازن الأقواس انتهت الوجهة عند أول `)` ونُضِّد النص بلا رابط؛ رمّز القوس المنفرد بـ`%28` أو `%29`. وتُنهي المسافة الوجهة أيضًا ما لم تكن ملفوفة بين قوسين زاويين.
- الكلمة الملتصقة بنص الرابط تشاركه الرابط. ففي `see [the site](https://example.com).` تدخل النقطة في المساحة القابلة للنقر.
- قد يحمل نص الرابط توكيدًا (`[**bold** words](…)`) وقد يقع داخله (`**[words](…)**`).
- تعمل الروابط في الفقرات وعناصر القوائم والاقتباسات الكتلية والإطارات والتعليقات والحواشي وخلايا الجداول، وفي العناوين ما دام `headings.inlineMarks` مفعّلًا (وهو الافتراضي). أما الترويسات والمخطط التفصيلي وصفوف المحتويات المأخوذة من عنوان فتحتفظ بالنص وحده، وكذلك نص `:chip[…]`.
- لا يُتعرَّف على الروابط المرجعية (`[text][id]`) ولا الروابط التلقائية (`<https://…>`) (انظر [ما لا يُدعَم](https://postext.dev/ar/docs/document-format.md#ما-لا-يدعمه-postext)).

في VDT تكون الوجهة على كل مقطع مرتبط، في `VDTLineSegment.href`. ويحتفظ المحلّل بروابط المقطع نطاقاتٍ من نصه، في `InlineSpan.links`، ولا يقسم مقطعًا من أجل رابط أبدًا، ولهذا لا يستطيع الرابط أن يغيّر الإخراج.

### الشارات المضمّنة

يُنضّد `:chip[text]` النصَّ `text` داخل إطار — «شارة» (chip) مستديرة الحواف ملوّنة بلون خفيف — يجري مع السطر: كلمات بنك الكلمات أو تمرين التصنيف، ومفاتيح لوحة المفاتيح، والوسوم. ويختار `:chip[text]{style="key"}` نمطًا مسمّى من `chipStyles` (انظر مرجع الإعدادات)؛ ومن دون `style`، أو بمعرّف لا يصرّح به أي نمط، تأخذ الشارة النمط الأول (نمط `chip` مدمجًا إن لم يكن في الإعدادات أي نمط؛ وتحذّر Sandbox من المعرّف غير المعروف).

```markdown
Classify: :chip[battery] :chip[cable] :chip[switch] :chip[bulb]

Press :chip[Ctrl]{style="key"} + :chip[C]{style="key"} to copy.
```

- **وحدة واحدة.** لا تُكسر الشارة ولا تُقسَم بالواصلة من داخلها أبدًا؛ ينكسر السطر بين الشارات، عند مسافات الكلمات المحيطة بها. والشارة الأعرض من السطر كله تفيض عنه بدل أن تنقسم.
- **العرض.** تقدّمها هو النص مضافًا إليه الحشو الأفقي والحدّ الخارجي على الجانبين. ويمدّ ضبط الأسطر المسافات بين الكلمات وحدها، لا داخل الشارة أبدًا. و`gap` في النمط هو أقل حيّز يُترك بين الإطار وكلمة أو شارة مجاورة عبر مسافة — وتُزاد المسافة الأضيق منه (لا عند طرف السطر، ولا إلى جوار علامة ترقيم ملتصقة مثل `:chip[a],`).
- **الارتفاع.** الإطار شريط حول خط الأساس، 0.8 em فوقه و0.25 em تحته بحجم الشارة، يزيده الحشو العمودي والحدّ الخارجي. ويُرسم الحشو العمودي خارج صندوق السطر ولا يغيّر ارتفاع السطر أبدًا، فتبقى شبكة خطوط الأساس ثابتة؛ والإطار الأطول من خطوة السطر قد يصطدم بشارة في السطر الأعلى أو الأسفل، وتنبّه Sandbox إلى شارتين في سطرين مختلفين تتداخلان («الشارات تلامس السطر التالي») ليُقلَّل الحشو أو الحدّ الخارجي أو الحجم.
- **النص.** يأخذ نص الشارة علاماته المضمّنة الخاصة (`:chip[**bold** word]`، `:chip[x^2^]`) والتوكيد المحيط به (`**:chip[a]**`)؛ وقد يحدّد النمط عائلة الخط والحجم واللون والعريض والمائل. اكتب `\]` لقوس معقوف حرفي داخلها. وتبقى الإحالات وعيّنات الألوان والصيغ الرياضية داخل الشارة حرفية، ويطبع `\$` علامة دولار (حتى postext 1.4 كان يطبع الشرطة المائلة العكسية أيضًا).
- **الفارغة.** الشارة المؤلفة من مسافات وحدها (`:chip[ ]`، بما فيها المسافات غير الفاصلة) إطار فارغ — خانة إجابة، أو علامة نهاية: عرضها بقدر الحشو الأفقي لنمطها وحدّه الخارجي، وارتفاعها كارتفاع شارة فيها كلمات. حدّد حجم الخانة بـ`paddingX` في النمط (`:chip[ ]{style="blank"}`). وإذا لم يكن بين القوسين شيء على الإطلاق بقيت `:chip[]` نصًا حرفيًا.
- **المواضع.** الفقرات وعناصر القوائم والاقتباسات الكتلية والإطارات وخلايا الجداول والتعليقات والحواشي. أما العناوين فتُبقي `:chip[…]` نصًا حرفيًا.
- **المخرجات.** ترسم Canvas وHTML وPDF الإطار وتنضّد الكلمات نصًا حقيقيًا: قابلًا للتحديد في HTML، وقابلًا للاستخراج وبترتيب القراءة في PDF (في PDF الموسوم يكون الإطار عنصرًا زخرفيًا من عناصر الإخراج، وتنتمي الكلمات إلى الفقرة).

### علامات التظليل

يضع `:mark[نص]` شريطًا ملوّنًا خلف `نص`، كما يظلّل الكتاب المدرسي كلماته المفتاحية. وعلى خلاف الشارة، تبقى الكلمات المعلَّمة نصًّا عاديًّا: تنكسر في آخر السطر وتُجزَّأ وتُضبط كما تُضبط الكلمات المحيطة بها، ويتبع الشريط كل قطعة من العبارة في سطرها. ويختار `:mark[نص]{style="key"}` نمطًا مسمًّى من `markStyles` (انظر مرجع الإعدادات)؛ وبلا `style`، أو بمعرّف لا يعلنه أي نمط، تأخذ العلامة النمط الأول (نمط `mark` مدمج بلون أصفر باهت حين لا تحوي الإعدادات أي نمط؛ وينبّه Sandbox إلى المعرّف غير المعروف).

```markdown
تدفئ الشمس البحر و:mark[يصعد الماء إلى الهواء بخارًا، فيبرد هناك ويكوّن السحب].

- :mark[التبخّر]{style="key"}: يتحوّل الماء إلى بخار.
```

- **انكسار الأسطر.** قد تضمّ العلامة عدة كلمات وتمتد عبر آخر السطر؛ ولكل سطر شريطه. ولا تُرسم الحشوة الأفقية والزوايا المستديرة إلا عند البداية والنهاية الحقيقيتين للعبارة: فحيث تنكسر العبارة ينتهي الشريط مستقيمًا عند آخر حرف في السطر ويبدأ مستقيمًا عند أول حرف في السطر التالي.
- **لا يشغل حيّزًا.** يُرسم الشريط تحت النص، من 0.8 em فوق خط الأساس إلى 0.25 em تحته، مضافًا إليه الحشوة العمودية، وتمتد حشوته الأفقية في المسافات المجاورة للعبارة. وتنكسر الأسطر تمامًا كما تنكسر بلا علامة، فلا يحرّك تعليم كتاب منضَّد أيًّا من صفحاته.
- **النص.** يقبل النص المعلَّم علاماته المضمّنة الخاصة (`:mark[الكلمة **المفتاحية**]`) والروابط والشارات والإحالات. وتتداخل الأقواس المربعة داخله (`:mark[انظر [الخريطة]]`)، ويكتب `\]` قوسًا حرفيًّا، ويجوز أن يعبر النص فاصل سطر ليّنًا في المصدر. وتبقى علامة الترقيم الملتصقة بالعبارة خارج القوسين (`:mark[الأرض].`) خارج الشريط؛ ويشمل لون النص في النمط الكلمة كلها التي تحملها. والعلامة داخل علامة أخرى تُنضَّد بنصها.
- **المواضع.** الفقرات والعناوين المنضَّدة في النص وعناصر القوائم والاقتباسات والإطارات والحواشي وخلايا الجداول والتعليقات التوضيحية والملاحظات، في النص من اليسار إلى اليمين ومن اليمين إلى اليسار وفي الصينية واليابانية. ويرسم الشريطَ كلٌّ من اللوحة وPDF وHTML؛ وهو في PDF الموسوم عنصر تخطيط، والكلمات تتبع فقرتها. أما العنوان الذي يرسمه تصميم (صفحة افتتاحية) فيطبع الكلمات بلا شريط، وكذلك عارض HTML في الصفحة العمودية.

### الحروف الكبيرة المصغّرة

يُنضّد `:smallcaps[text]` النصَّ `text` بالحروف الكبيرة المصغّرة (small capitals) — أسماء الشخصيات في مسرحية، أو اختصار في النص الجاري، أو الكلمات الأولى من فصل. تُنضَّد الحروف الصغيرة حروفًا كبيرة بنسبة 70% من حجم النص، بينما تحتفظ الحروف الكبيرة والأرقام وعلامات الترقيم بالحجم الكامل، فيطبع `:smallcaps[Hamlet]` حرف H بالحجم الكامل يليه AMLET بحروف كبيرة مصغّرة.

```markdown
Enter :smallcaps[Hamlet] and :smallcaps[Horatio], reading.

The :smallcaps[unesco] report and the :smallcaps[who] guidelines.
```

- **مُركَّبة.** تُرسم الحروف الكبيرة المصغّرة من الحروف الكبيرة في الخط نفسه، بالطريقة نفسها في Canvas وفي HTML وفي PDF، فيُقاس النص وينكسر على نحو متطابق في كل مكان. ولا تُستعمل الحروف الكبيرة المصغّرة الحقيقية في الخط (خاصية OpenType `smcp`)؛ فإن أردتها فنضّد النص بعائلة خط مخصصة لها (عائلة ينتهي اسمها بـ«SC»، مثلًا) من خلال نمط فقرة.
- **العلامات.** يأخذ النص علاماته المضمّنة الخاصة (`:smallcaps[**Ophelia**]`) والتوكيد المحيط به (`*:smallcaps[Act I]*`)؛ اكتب `\]` لقوس معقوف حرفي داخله. والإحالة أو الشارة داخله تُنضَّد بالحروف الكبيرة المصغّرة أيضًا، وتبقى الإحالة رابطًا واحدًا في HTML وفي PDF؛ أما الصيغة الرياضية فلا.
- **الانكسار.** تلتف الكلمات وتُقسَم بالواصلة كالمعتاد؛ ويقرأ تقسيم الكلمات بالواصلة كل كلمة بحالة حروفها الأصلية.
- **المواضع.** الفقرات وعناصر القوائم والاقتباسات الكتلية والإطارات وخلايا الجداول والتعليقات والحواشي، والعناوين ما دام `headings.inlineMarks` مفعّلًا (وهو الافتراضي)؛ فإذا أُوقف حُذف الترميز من العنوان وطُبع النص كما كُتب.
- **الفقرات الكاملة.** نمط الفقرة أو متن الإطار الذي فيه `smallCaps: true` يُنضّد نصه كله على هذا النحو (انظر [أنماط الفقرات](https://postext.dev/ar/docs/configuration-styles.md#أنماط-الفقرات)).
- **النص.** يحمل Canvas وHTML وPDF الحروف كما رُسمت: نسخ `:smallcaps[Hamlet]` يعطي «HAMLET».

### الجدولة ومواضع الجدولة

ترسل الجدولة (tab) الكلمات التي تليها إلى موضع على السطر: سعر الطبق ملاصقًا لنهاية عرض السطر وراء صفّ من النقاط، واسم الممثل بعد الدور في قائمة الشخصيات، ودرجات سؤال الامتحان عند الهامش. اكتب `:tab` حيث تقع الجدولة؛ والمسافات المحيطة بها تدخل فيها. وتُحدَّد المواضع في الإعدادات: `bodyText.tabStops` لكل فقرة وعنصر قائمة واقتباس، و`tabStops` في نمط الفقرة لفقرات مجموعة `:::paragraphs`، و`body.tabStops` في نمط الإطار داخل إطاراته (انظر [الإعدادات › مواضع الجدولة](https://postext.dev/ar/docs/configuration-text.md#مواضع-الجدولة)). قائمة طعام تنتهي أسعارها عند نهاية عرض السطر، وراء النقاط:

```ts
paragraphStyles: [
  { id: 'menu', firstLineIndent: { value: 0, unit: 'em' }, tabStops: [{ position: 'end', align: 'end', leader: '. ' }] },
],
```

```markdown
:::paragraphs{style="menu"}
شوربة العدس :tab 8.50

سمك مشوي بالشمر والليمون :tab 21.00
:::
```

يحدّد `:tab{…}` موضعًا لتلك الجدولة وحدها، بلا نمط: خانة نموذج تمتد إلى آخر السطر، أو مبلغ على فاصلته العشرية.

```markdown
الاسم واللقب :tab{at=end leader=rule}

المبلغ المستحق :tab{at=80% align=decimal} 1,234.50
```

| السمة | المعنى |
| --- | --- |
| `at` | أين يقع الموضع، من حافة البداية لعرض سطر الفقرة: طول (`120mm`، `4cm`، `2em`؛ والعدد المجرّد بالنقاط)، أو `end` لنهاية عرض السطر، أو نسبة منه (`60%`). ومن دون `at` يذهب `:tab{…}` إلى مواضع النمط كما يذهب `:tab` المجرّد. |
| `align` | `start` (الافتراضي): يبدأ النص الذي يلي الجدولة عند الموضع. `end`: ينتهي عنده (النص حتى الجدولة التالية أو نهاية الفقرة). `center`: يتوسّطه. `decimal`: تقع فاصلته العشرية عليه؛ والمقطع الذي لا فاصلة فيه ينتهي عنده. |
| `leader` | نص يتكرّر على المساحة التي قبل الموضع: `"."`، `". "`، `"·"`، `"_"`، `"-"` أو نص قصير آخر، بخط الفقرة ولونها. و`rule` يرسم خطًا تحت خط الأساس بقليل، خانةَ نموذج. الافتراضي لا شيء. |
| `gap` | المسافة المتروكة بين خط الإرشاد والنص على جانبيه. الافتراضي `0.5em` من حجم الفقرة؛ والعدد المجرّد بالنقاط. |
| `decimal` | الفاصلة التي يحاذيها الموضع `decimal`. الافتراضي فاصلة لغة المستند: `.` في الإنجليزية والصينية واليابانية والعربية، و`,` في الإسبانية والكتالونية والبرتغالية والفرنسية والألمانية وغيرها. |

- **أين تذهب الجدولة.** إلى أول موضع بعد النص الذي قبلها، من بين المواضع التي تلي الموضع الذي أخذته الجدولة السابقة في السطر، فتأخذ الجدولة الثانية في السطر الموضع الثاني في الغالب. وبعد آخر موضع يضع `tabInterval` مواضع أخرى كل مسافة منه بدءًا من بداية عرض السطر؛ ومن دونه تكون الجدولة مسافة بين كلمتين.
- **محارف الجدولة.** محرف الجدولة المكتوب في النص (U+0009) لا يكون جدولة إلا في فقرة يحدّد نمطها `tabStops` أو `tabInterval`. وفي غير ذلك هو المسافة بين كلمتين كما كان دائمًا، فالمستند المكتوب بمحارف جدولة مكان المسافات يحتفظ بإخراجه. ومحارف الجدولة المتتالية تمضي بعددها من المواضع. ومحرف الجدولة في أول سطر من النص يُحذف مع ما في أول السطر من فراغات: اكتب `:tab` ليبدأ السطر عند موضع.
- **ما يبقى نصًا.** `:tab` يليه حرف (`3:table`)، و`:tab` في الشيفرة المضمّنة، أو في صيغة، أو في عنوان رابط، أو في سمات توجيه.
- **المواضع.** الفقرات وعناصر القوائم والاقتباسات والإطارات ومجموعات `:::paragraphs`. أما العناوين والتعليقات وخلايا الجداول ونص التصاميم (صفحات الافتتاح والترويسات) فلا مواضع جدولة فيها.
- **النص الذي يتجاوز الموضع.** حين يكون النص الذي قبل الجدولة قد تجاوز كل موضع بقي في سطره، يأخذ الموضع `end` أو `center` أو `decimal` الكلمة الأخيرة قبل الجدولة إلى السطر التالي مع النص الذي عند الموضع، ويُنضَّد النص الذي قبلها أضيق، كما يلفّ سطر المحتويات عنوانه ليحتفظ برقم الصفحة. والموضع `start` يكسر السطر قبل الجدولة، فيبدأ النص الذي بعدها السطر التالي عند موضعه. والجدولة التي تفتح سطرها ولا تجد موضعًا مع ذلك لا تأخذ أي مساحة.
- **خطوط الإرشاد.** يملأ خط الإرشاد المساحة التي قبل موضعه وينتهي ملاصقًا لنهاية تلك المساحة، فتصطفّ نقاط الأسطر المتعددة أيًّا كان النص الذي قبلها. ويبعده `gap` عن النص على الجانبين؛ ولا فراغ قبله حين تفتح الجدولة السطر، ولا بعده حين لا يليه شيء. ويُصفّ خط الإرشاد بثلاثة تكرارات أو أكثر؛ والمساحة التي لا تتّسع إلا لتكرار أو اثنين تبقى فارغة، كما في جدول المحتويات.
- **كسر الأسطر.** الفقرة التي فيها جدولة تُنضَّد سطرًا سطرًا، ولا تأخذها Knuth-Plass أبدًا. وفي النص المضبوط لا تأخذ الفائض إلا مسافات الكلمات التي بعد آخر جدولة في السطر، ولا يُمدّ السطر الأخير من الفقرة (انظر [تقسيم الكلمات وضبط الأسطر › الأسطر ذات الجدولة](https://postext.dev/ar/docs/justification.md#الأسطر-ذات-الجدولة)). والفقرة الموسّطة أو المحاذاة إلى اليمين تنضّد أسطرها ذات الجدولة من جهة البداية، لأن المواضع مواقع على عرض السطر. ومن اليمين إلى اليسار تُقاس المواضع من اليمين ويقع الموضع `end` على اليسار (انظر [الإخراج العربي](https://postext.dev/ar/docs/arabic-layout.md#المحتويات-والفهرس)). وفي النص العمودي تكون الجدولة مسافة بين كلمتين، ويُطلق `:tab` هناك تحذير المحتوى `tabInVerticalText`.
- **النص والمخرجات.** في النص الخام محرف جدولة (`\t`) عند كل جدولة؛ وخطوط الإرشاد ليست نصًا، فيتخطّاها النسخ والبحث وخريطة المصدر. وترسمها Canvas وعارض HTML وEPUB ذو التخطيط الثابت (مخفيّة عن قارئات الشاشة في HTML)؛ ويوسمها PDF الموسوم عناصرَ زخرفية من عناصر الإخراج، فيُقرأ نصه `شوربة العدس 8.50`. ولا يستطيع EPUB المرن أن يحتفظ بالمواضع بدقة: يصير كل سطر من فقرة ذات جدولة صفًّا من الأجزاء التي بين جدولاته، يدفع فيه الموضعُ `end` أو `center` أو `decimal`، أو الموضع الذي له خط إرشاد، الجزءَ التالي إلى نهاية الصف (وخط إرشاده حدّ منقّط أو متصل)، ويُبقي الموضع `start` الجزءَ الذي قبله بعرضه المطبوع. ويكتب التصدير إلى Word `:tab` جدولةً في Word، ويقرأ الاستيراد من Word الجدولة في نص المتن `:tab` من جديد مع الموضع الذي حدّده Word لها (انظر [Sandbox › مستندات Word](https://postext.dev/ar/docs/sandbox-books-saving.md#مستندات-word)).

### الاتجاه في النص العمودي

في النص العمودي (`layout.writingMode: 'vertical-rl'`) تقف الحروف الصينية قائمة، وتُدار الكلمات اللاتينية والأعداد الطويلة على جانبها، ويقف العدد المؤلف من رقمين على الأكثر قائمًا في خانة واحدة، ما لم يقع في جملة لاتينية فيتبع كلماتها (انظر [الإعدادات › الأعداد في النص العمودي](https://postext.dev/ar/docs/configuration-east-asian.md#الأرقام-في-النص-العمودي)). وثلاث علامات تميّز مقطعًا باليد:

```markdown
第:tcy[120]回，:upright[GDP]增長:sideways[12]倍。
```

- `:tcy[…]` (tate-chu-yoko، 縱中橫) تُنضّد نصها متجاورًا في خانة قائمة واحدة عرضها em واحد، وتضغطه عرضًا إذا كان أعرض منها: `:tcy[120]`، `:tcy[3.0]`، `:tcy[A+]`. ويُقرأ جيدًا ما يصل إلى أربعة حروف تقريبًا.
- `:upright[…]` تُقيم كل حرف في خانة خاصة به، والحروف اللاتينية في وسطها: اختصار يُقرأ حرفًا حرفًا نزولًا في العمود. ولا ينكسر السطر داخلها أبدًا.
- `:sideways[…]` تُدير المقطع كله مع السطر، والحروف الصينية أيضًا: عدد من رقمين يريده المؤلف على جانبه.
- يبقى النص في النص العادي؛ وتأخذ العلامات داخلها علامات مضمّنة أخرى (`:tcy[**12**]`) ورابطًا (`:sideways[[iPhone](https://…)]`) وبعضها بعضًا، والغلبة للأعمق (`:tcy[:upright[AB]]` تُقيم A وB)، واكتب `\]` لقوس معقوف حرفي. ولا تغيّر شيئًا في النص الأفقي.
- الإحالة أو علامة الحاشية أو الصيغة الرياضية أو الشارة أو عيّنة اللون داخل علامة تحتفظ بتنضيدها الخاص: `:sideways[iPhone[^1]]` تُدير iPhone وتترك رقم الحاشية كما يُنضَّد كل رقم حاشية؛ ويقف رقم الإحالة في خانة واحدة وفق `cjk.uprightDigits` كأي عدد قصير.
- عنصر النص في التصميم الذي فيه `inlineMarks: true` يأخذها أيضًا حين يُنضَّد عموديًا (انظر [الإعدادات › عناصر النص العمودية](https://postext.dev/ar/docs/configuration-headers-footers.md#عناصر-النص-العمودي)).
- في الانكسار وضبط الأسطر تُحتسب خانة `:tcy` وكل حرف من `:upright` حروفًا صينية، ولا تُوضع بجوارها مسافة بين الهان واللاتينية.

### العلامات الصينية والقراءات (ruby) والتعليقات السطرية (warichu)

تعلّم الطبعات الصينية واليابانية النص بين الأسطر بدل المائل أو التسطير، وتشرح الحروف بقراءاتها، وتُنضّد الشروح داخل السطر. وسبعة توجيهات تفعل ذلك. ويشرح [الإخراج الصيني](https://postext.dev/ar/docs/chinese-layout.md) و[الإخراج الياباني](https://postext.dev/ar/docs/japanese-layout.md) الأعراف التي تقوم عليها. وتحتفظ هذه التوجيهات بنصها: تبقى الحروف بين القوسين في الفقرة (يقرؤها البحث والمحتويات ومراسي الفهرس والنص المنسوخ كما كُتبت)، وتأخذ التوجيهات العلامات المضمّنة الأخرى داخلها وحولها، المتداخلة منها أيضًا. اكتب `\]` لقوس معقوف حرفي.

```markdown
此事:dots[不可]輕忽。:name[賈寶玉]與:name[林黛玉]讀:book[西廂記]。

{滿紙|mǎn|zhǐ}荒唐言，:ruby[一把]{rt="yì bǎ"}辛酸淚！:ruby[都]{rt="ㄉㄡ"}云作者痴。

寶玉:warichu[甲戌側批：此是第一首標題詩。]{open="〔" close="〕"}道：……

{東京|とう|きょう}の:ruby[紫陽花]{rt="あじさい"}は*とんと*:sideline[見事]だ。:book[こころ]を読む。

:kunten[學]{okuri="ビテ"}而:kunten[時]{okuri="ニ"}:kunten[習]{kaeri="二" okuri="フ"}:kunten[之]{kaeri="一" okuri="ヲ"}。
```

- **`:dots[text]`** تضع نقطة توكيد (着重号) تحت كل حرف في النص الأفقي، وعلى يمينه في النص العمودي، ولا شيء على علامات الترقيم أو المسافات. `style="dot|circle|sesame"` (الافتراضي `dot`)، و`fill="open"` للمفرّغة، و`pos="over|under"` للجهة الأخرى. والتوكيد بصيغة Markdown `*…*` على حروف صينية أو يابانية يفعل الشيء نفسه مع `cjk.emphasis: 'dots'`، وهو الافتراضي في المستند الصيني أو الياباني؛ وتبقى الحروف اللاتينية في التوكيد نفسه مائلة. والسمات المتروكة تأخذ قيم `cjk.emphasisMark`: نقطة تحت النص في الصينية، وسمسمة فوقه (وعلى يمينه في النص العمودي) في اليابانية.
- **`:name[text]`** ترسم خط أسماء الأعلام (专名号) تحت النص (وعلى يساره في النص العمودي)، و**`:book[text]`** ترسم علامة عنوان الكتاب (书名号): 《》 حول العنوان (و〈〉 للعنوان داخل عنوان آخر)، أو الخط المتموّج في الطبعات الكلاسيكية والتايوانية، أو لا شيء، بحسب `cjk.bookTitleMark` (افتراضيًا الأقواس في البر الرئيسي وفي اليابان، والخط المتموّج في تايوان وهونغ كونغ). وفي المستند الياباني تكون الأقواس 『』، و「」 للعنوان داخل عنوان آخر (`cjk.bookTitleBrackets`). فمصدر واحد يخدم طبعة حديثة للبر الرئيسي وأخرى كلاسيكية. والاسمان أو العنوانان المتجاوران يبقى خطاهما منفصلين.
- **`:ruby[base]{rt="…"}`** تُنضّد القراءات فوق الأساس (بينيين)، أو على يمين كل حرف (جوين، الافتراضي لقراءات البوبوموفو). فإذا كانت القراءات بعدد الحروف، مفصولة بمسافات أو `|`، أخذ كل حرف قراءته وجاز أن ينكسر السطر بينها (mono ruby)؛ أما `group`، أو عدد لا يطابق، فيُنضّد قراءة واحدة في الوسط فوق الأساس كله، ولا تنكسر أبدًا. ويختار `pos="over|under|right"` الجهة. والصيغة المختصرة `{紅樓|hóng|lóu}` (قراءة لكل `|`) أو `{紅樓|hónglóu}` (قراءة واحدة للأساس كله) تُقرأ على النحو نفسه، ولكن فقط حين يحتوي الأساس حرفًا من الهان أو الكانا أو البوبوموفو، وخارج الصيغ الرياضية والشيفرة والسمات، لذا تبقى `{x|x>0}` في النثر اللاتيني نصًا. والشرطة المائلة العكسية قبل القوس المعقوف أو الخط العمودي تُبقي الصيني منهما نصًا: `{紅|hóng}` و`{紅\|hóng}` تطبعان `{紅|hóng}`. والأساس الذي يفتح سطرًا أو يغلقه يُحاذى إلى ذلك الطرف مع قراءته. ويختار `mode=mono|group|jukugo` طريقة توزيع القراءات على الأساس (`mode=group` هو نفسه `group`)، و`align=center|jis|start` طريقة توزيع القراءة الأقصر من أساسها. وفي المستند الياباني تكون صيغة القراءة لكل حرف في كلمة من حرفين أو أكثر (`{東京|とう|きょう}`، `rt="とう|きょう"`) روبي جوكوغو: يحتفظ كل حرف بقراءته، التي يجوز أن تمتد فوق الحرف التالي من الكلمة، ويجوز أن ينكسر السطر بينها، وتُوزَّع القراءات وتمتد فوق الكانا كما يقول `cjk.ruby.align` و`cjk.ruby.overhang`؛ والقراءة الواحدة للأساس كله (`{紫陽花|あじさい}`، أو `《》` في أوزورا) روبي مجموعة؛ ويُبقي `mode=mono` قراءة لكل حرف دون امتداد فوق ما يجاوره.
- **`:sideline[text]`** ترسم خطًا جانبيًا (傍線) بجانب النص، مارًّا بعلامات الترقيم والمسافات: تحته في النص الأفقي وعلى يمينه في النص العمودي. `style="solid|double|wavy|dotted"` (الافتراضي `solid`)، و`pos="over|under"` (في النص العمودي over هو اليمين وunder هو اليسار؛ وتعمل `position=` أيضًا). وتعمل في أي نظام كتابة، ومنه العبارة الإنجليزية المسطّرة.
- **`:warichu[note]`** تُنضّد تعليقًا (双行夹注) في صفّين بنصف حجم النص داخل السطر، ويُقرأ الصف الأعلى أولًا (الأيمن في النص العمودي). والتعليق الطويل يملأ ما بقي من السطر ويستمر في السطر أو العمود أو الصفحة التالية، مع حرفين من حروفه على الأقل على كل جانب من الكسر (`cjk.warichu.minChars`). ويلفّه `open` و`close` بقوسين بحجم النص؛ ويحدّد `cjk.warichu` الحجم واللون والقوسين الافتراضيين (（） في المستند الياباني). والتعليق المكتوب بالحروف اللاتينية ينكسر بين كلماته.
- **`:kunten[字]{kaeri="…" okuri="…" tate}`** تُنضّد علامات الكانبون لآخر حرف بين القوسين: `kaeri` علامة العودة (レ، و一 二 三، و上 中 下، و甲 乙 丙، و天 地 人، و一レ 上レ 甲レ 天レ؛ ونقاط الترميز ㆑ ㆒ … تُقرأ بالطريقة نفسها)، و`okuri` الأوكوريغانا (تُحذف أقواس أوزورا `（ヲ）`)، والعلَم `tate` خط التاتيسن الذي يصله بالحرف التالي. ولا يُعاد ترتيب النص: تُنضَّد العلامات بنصف الحجم بجانبه (`cjk.kunten`)، ويقرأ النص المنسوخ 學ビテ而時ニ習フ之ヲ، مع الأوكوريغانا ودون علامات العودة. والروبي داخلها يعمل مع الحروف التي تُقرأ مرتين: `:kunten[:ruby[未]{rt="ザル" pos=under}]{kaeri="レ" okuri="ダ"}`.

لا تتغير خطوة السطر أبدًا: تسكن العلامات والقراءات في تباعد الأسطر، ويحذّر البناء حين تكون الفجوة بين أسطر الفقرة أضيق من أن تتسع لها (`cjkMarksExceedLeading`، `rubyExceedsLeading`، `kuntenExceedsLeading`)، وحين لا تتسع العلامات تحت سطر والقراءات فوق السطر التالي في الفجوة التي يتقاسمانها، في فقرة واحدة أو عبر فقرتين. امنح الفقرات المشروحة نمط فقرة بتباعد أسطر أكبر. تُرسم العلامات والقراءات والتعليقات في الفقرات والعناوين وعناصر القوائم والاقتباسات الكتلية والإطارات، وكذلك في التعليقات وخلايا الجداول والحواشي، ويُفحص تباعد أسطرها بالطريقة نفسها؛ أما في الترويسات والتصاميم فيُطبع النص بدونها. ومع `cjk.bookTitleMark: 'brackets'` يكون قوسا العنوان 《》 من علامات ترقيم النص: تحتفظ بهما التعليقات والخلايا والحواشي وصفوف المحتويات والإشارات المرجعية ومداخل الفهرس. انظر [الإعدادات › العلامات والقراءات والتعليقات السطرية](https://postext.dev/ar/docs/configuration-east-asian.md#العلامات-والروبي-والواريتشو).

### اتجاه النص في الترميز

يجري المستند في الاتجاه الذي تقتضيه لغته `locale` (`direction` في الإعدادات: من اليمين إلى اليسار للعربية والفارسية والأردية والعبرية). وفي داخله يحدّد الترميز اتجاه الكتلة أو المقطع النصي، لاقتباس إنجليزي في كتاب عربي أو عربي في كتاب إنجليزي.

- **العنوان أو الحاوية**: `{dir=ltr}` أو `{dir=rtl}` في سماته، `# Introduction {dir=ltr}`، `:::paragraphs{dir=ltr}`، `:::callout{dir=rtl}`. تأخذ كل كتلة داخل الحاوية هذا الاتجاه، حتى حاوية متداخلة أو عنوان يحدّد اتجاهًا آخر. والفقرة العادية أو القائمة أو الاقتباس لا سمات لها: لفّها في `:::paragraphs{dir=…}`. وتُتجاهل القيم الأخرى. وسمة `lang` في الحاوية (`:::paragraphs{dir=ltr lang=en}`) تسمّي لغة الكتل التي بداخلها بالطريقة نفسها: تُرقَّم قوائمها المرتّبة بأرقام تلك اللغة.
- **المقطع النصي**: `:ltr[…]` و`:rtl[…]` تعزلان نصهما (LRI…PDI وRLI…PDI في خوارزمية Unicode ثنائية الاتجاه): يُرتَّب في داخله، وترى الفقرة المحيطة به حرفًا محايدًا واحدًا. ويوسم `{lang=…}` لغة المقطع في HTML وفي PDF. وعلامة الحاشية أو `:ref` أو الصيغة الرياضية داخله جزء من المقطع المعزول، والمقاطع المعزولة تتداخل.

```markdown
:::paragraphs{dir=ltr}
The opening of the *Nights* in Lane's translation.
:::

ترجمها :ltr[Edward William Lane]{lang=en} سنة ١٨٣٩.
```

الكتلة المنضّدة خلاف اتجاه المستند تحتفظ بجهة بدايتها: تنتقل إزاحتها وعلامات قوائمها والطرف الملاصق لسطرها الأخير إلى الجهة التي يبدأ منها نصها. استعمل العزل حين ينتهي عنوان لاتيني بحرف محايد (نقطة، قوس) كان سينضمّ لولا ذلك إلى العربية المحيطة به. وتُحترم محارف التحكم في Unicode نفسها أيضًا (U+2066–2069، U+202A–202E، U+200E، U+200F، U+061C). وفي محرّر Sandbox يجري كل سطر في اتجاه أول حرف فيه. انظر [الإخراج العربي](https://postext.dev/ar/docs/arabic-layout.md#الاتجاه-وخوارزمية-النص-ثنائي-الاتجاه).

## الصيغ الرياضية

دعم الرياضيات جزء أصيل من صيغة المستند. يحلّل Postext `$…$` للصيغ المضمّنة و`$$…$$` لصيغ العرض (الكتلية)، ويرسمها عبر [MathJax](https://www.mathjax.org/) في وضع SVG. والمسارات المتجهية نفسها تغذّي المُخرِجات الثلاثة، فتتطابق معاينة Canvas وتصدير HTML ومخرجات PDF بكسلًا ببكسل — ويبقى PDF متجهيًا بالكامل مهما كان مستوى التكبير.

- **المضمّنة:** `$…$`. يُتعرَّف عليها داخل أي كتلة نصية (فقرة، عنوان، اقتباس كتلي، عنصر قائمة). تُسهم في السطر بصندوق واحد ذرّي غير قابل للكسر؛ ويعاملها Knuth-Plass ككلمة لا يجوز تقسيمها. وإذا كان ارتفاع الصيغة الطبيعي سيكسر صندوق السطر صُغّرت بانتظام لتُحفظ شبكة خطوط الأساس — والتعابير الطويلة جدًا مكانها وضع العرض.
- **العرض:** `$$…$$`. إما في سطر مستقل (`$$\int_0^1 x^2\,dx$$`) وإما مسيّجة عبر عدة أسطر بعلامتي `$$` في سطرين مستقلين. تُرسم في وسط العمود وتُثبَّت على شبكة خطوط الأساس بهامشين علوي وسفلي قابلين للضبط (`math.marginTop`، `math.marginBottom`) — وهي آلية التصحيح نفسها تمامًا التي تستعملها العناوين، فتعود الفقرة التالية للصيغة إلى الشبكة.
- **النص المحيط بصيغة العرض:** صيغة العرض في سطر مستقل تقطع الفقرة ولو لم يكن فوقها سطر فارغ. والنص الذي قبلها فقرة تمهّد لها؛ والنص المكتوب مباشرة تحت `$$` الختامية، بلا سطر فارغ، يُكمل الفقرة المقطوعة ويُنضَّد بلا إزاحة للسطر الأول، كما ينضّد TeX عبارة «where …» بعد صيغة العرض. أما الصيغة المفصولة عن النص الذي فوقها بسطر فارغ (أو التالية لقائمة أو اقتباس أو عنوان) فلا تقطع شيئًا: النص بعدها فقرة جديدة، مُزاحة كالمعتاد، بسطر فارغ أو بدونه (ويجعلها `math.indentAfterDisplay: false` ملاصقة للحافة أيضًا). ولا يقطع الفقرةَ إلا عرضٌ كامل — صيغة واحدة في السطر، أو سياج `$$` يُغلق قبل السطر الفارغ التالي؛ أما سطر مثل `$$a$$ and $$b$$` فيبقى نصًا. ويُبقي `math.keepWithLeadIn` الصيغة في عمود السطر الذي يقدّم لها. (حتى postext 1.4 كان سطر `$$…$$` الذي ليس فوقه سطر فارغ يُقرأ جزءًا من الفقرة ويُطبع كما كُتب.)
- **أرقام المعادلات:** يرقّم `\label{eq:x}` صيغة العرض التي يقع فيها، بترتيب القراءة: (1)، (2)… والصيغة ذات الرقم تمتد على عرض العمود (أو العرض الداخلي للإطار)، والمعادلة في الوسط ورقمها ملاصق للحافة اليمنى في سطره. وفي `align` أو `gather` أو `alignat` أو `flalign` أو `eqnarray` يأخذ كل صف يحمل `\label` رقمه الخاص، ما لم يحمل الصف `\nonumber` أو `\notag`. والصيغة التي لا `\label` فيها لا تُرقَّم، كما لم تُرقَّم `$$…$$` قط. ويظل `\tag{…}` يرقّم الصيغة بالنص الذي تعطيه له (و`\tag*{…}` بلا أقواس) ولا يدخل في العدّ؛ و`\label` المجاور له يسمّي ذلك النص. ويُضبط التنسيق، وأرقام الفصل أو القسم (2.3)، وإعادة بدء العدّ في [`math.equationNumbering`](https://postext.dev/ar/docs/configuration-lists-math.md#الصيغ-الرياضية). ضع `\label` في المستوى الأعلى من الصيغة أو من صفّها: لا داخل `aligned` أو `split` أو `cases`.
- **الإحالة إلى المعادلات:** يطبع `\eqref{eq:x}` في النص الرقم كما تطبعه الصيغة، (3)، ويطبع `\ref{eq:x}` الرقم مجرّدًا، 3؛ وكلاهما رابط، ككل [إحالة](https://postext.dev/ar/docs/document-format-notes-references.md#الإحالات-والمراسي). ويحتفظ `Eq.~\eqref{eq:x}` بالعلامة `~` كما يفعل LaTeX: مسافة غير قابلة للكسر. ويطبع `:ref{id="eq:x"}` و`@eq:x` القيمة (3) أيضًا. وداخل الصيغة يطبع `\eqref` و`\ref` الرقم (لا رابطًا). والتسمية التي لا يضعها شيء تطبع *?* وتعرضها لوحة الفحوص.
- **التهريب:** `\$` علامة دولار حرفية. ومحدِّدات `$` أو `$$` غير المتطابقة تُنتج مدخل `unclosedMath` في لوحة الفحوص في Sandbox مع مرساة إلى المصدر تنقلك إليه بالنقر.
- **التعليقات والحواشي وخلايا الجداول** تنضّد الرياضيات المضمّنة أيضًا (منذ postext 1.19)، في السطر مع النص وبمحاذاة الخلية، وبحجم المقطع. وهناك لا تفتح `$` صيغةً إلا وفق قاعدة Pandoc: لا مسافة بعد `$` الافتتاحية، ولا مسافة قبل الختامية، ولا رقم بعدها مباشرةً، فتبقى أسعار مثل *$5 to $10* نصًا؛ ويطبع `\$` علامة دولار، فيُقرأ النص المهرَّب نفسه على النحو نفسه في المتن وفي الجدول. ولا تقبل تسمية الشارة رياضيات. وحتى postext 1.18 كانت `$` هناك تُطبع دائمًا كما هي.
- **الأخطاء:** مصدر TeX الذي يرفضه MathJax (وحدات ماكرو غير معرّفة، أخطاء صياغة) يظهر تحذيرًا من نوع `invalidMath`. وتُستبدل الصيغة بعنصر نائب أحمر صغير لتبقى هندسة الإخراج صالحة.
- **الإعدادات:** يعرض القسم `math` من الإعدادات `enabled`، و`fontSizeScale` (نسبةً إلى حجم النص المحيط: عند 1.0 يكون em الصيغة الواحد بذلك الحجم — حجم المتن لصيغ العرض وللرياضيات المضمّنة في نص المتن؛ منذ postext 1.5، الذي ينضّد الصيغ أصغر بنحو 13% مما كان 1.4 ينضّدها، بينما تحتفظ الحزم وكتب Sandbox التي حفظها 1.4 بحجمها — انظر [حجم الصيغة](https://postext.dev/ar/docs/configuration-lists-math.md#الصيغ-الرياضية))، و`color` (يرث لون المتن إذا لم يُحدَّد)، وهامشي العرض.
- **المحرّك:** يُحمَّل MathJax عند الطلب. تشغّله Sandbox وعامل الإخراج بنفسيهما؛ وفي شيفرتك أنت، نفّذ `await initMathEngine()` قبل `buildDocument`، وإلا أُخرجت كل صيغة صندوقًا نائبًا رماديًا (انظر [تشغيل محرّك الرياضيات](https://postext.dev/ar/docs/configuration-lists-math.md#تشغيل-محرّك-الرياضيات)).

```md
The Euler identity $e^{i\pi}+1=0$ links the five fundamental constants.

$$
\int_0^{\infty} e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}
$$
```

صيغة في وسط جملة، والجملة تستمر بعدها بلا إزاحة:

```md
For a pendulum of length $L$ the period is
$$T_0 = 2\pi\sqrt{L/g}$$
where $g$ is the acceleration of free fall.
```

المعادلات المرقّمة والإحالات إليها:

```md
The energy is conserved,
$$
\begin{align}
E &= T + V \label{eq:energy} \\
  &= \tfrac12 m v^2 + m g h \nonumber
\end{align}
$$
and Eq.~\eqref{eq:energy} holds at every instant.
```

**المبرهنات والتوطئات والبراهين.** نمط الإطار الذي فيه `numbering` يعدّ إطاراته، كما تعدّ الحزمة `amsthm` في LaTeX بيئات المبرهنات: يبدأ كل إطار بتسميته ورقمه بخط عريض، «**Theorem 2.**»، ويلي `title` السياج الرقمَ بين قوسين، «**Theorem 2** (Bradley–Terry)**.**»، والإحالة إلى `{#id}` الخاص به تطبع «Theorem 2» (و`\ref{thm:x}` أو `style=number` الرقم 2 وحده). والأنماط التي تسمّي عدّادًا واحدًا تتقاسمه، فالتوطئة التي تلي المبرهنة هي Lemma 3. ويختم `endMark` في نمط البرهان إطاراته بـ ∎ أو □، محاذاةً إلى اليمين في السطر الأخير. انظر [المبرهنات المرقّمة والبراهين](https://postext.dev/ar/docs/configuration-callouts.md#المبرهنات-المرقّمة-والبراهين) لإعداد الأنماط.

```md
:::callout{type="theorem" #thm:main title="Bradley–Terry"}
Every reward class holds one reparameterised reward.
:::

:::callout{type="proof"}
Apply the projection of \eqref{eq:projection} to any member of the class.
:::

By :ref{id="thm:main"}, the objective is unchanged.
```