# صيغة المستند: الحواشي والإحالات

> الحواشي السفلية، والإحالات والمراسي، والاستشهادات وقائمة المراجع، وعلامات الفهرس الأبجدي

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

## باختصار

تتناول هذه الصفحة العلامات التي تشير إلى موضع آخر في الكتاب أو خارجه. ترسل علامة الحاشية القارئ إلى ملاحظة في أسفل الصفحة. وتذكر الإحالة شكلًا أو قسمًا أو صفحة برقمه. ويذكر الاستشهاد كتابًا أو مقالة تقتبس منها، وتسرد قائمة المراجع ذلك كله. وتختار علامات الفهرس الكلمات التي يسردها الفهرس في آخر الكتاب مع صفحاتها.

## الحواشي السفلية

للحاشية السفلية جزآن: العلامة `[^id]` حيث يُحال إلى الحاشية، والتعريف، وهو فقرة مستقلة تبدأ بـ`[^id]:` في أي موضع من الفصل.

```md
The keeper climbed the tower every evening.[^steps] The wind put out his candle,
so he learned to count the steps in the dark.

[^steps]: The cast-iron staircase has 112 steps; the tower was built in 1861.
```

- **العلامة.** يطبع `[^id]` رقم الحاشية حرفًا فوقيًا ملتصقًا بالكلمة التي قبله (اكتبه بعد علامة الترقيم، كما في المثال). ويقبل المعرّف الحروف والأرقام و`-` و`_` و`.` و`:`. وتعمل العلامة في الفقرات وعناصر القوائم والاقتباسات الكتلية والإطارات؛ أما في العناوين والتعليقات وخلايا الجداول فتُطبع كما كُتبت.
- **التعريف.** فقرة تبدأ بـ`[^id]:`؛ يمتد نصها حتى السطر الفارغ التالي ويأخذ العلامات المضمّنة المعتادة (العريض، والمائل، والروابط، و`:ref`، والصيغ الرياضية، والشارات). وتغادر التعريفات التدفق أينما كُتبت، فيمكن أن تقع تحت الفقرة التي تحيل إليها أو أن تُجمع كلها في آخر الفصل. والغلبة لأول تعريف للمعرّف.
- **الأرقام.** تُرقَّم الحواشي بترتيب أول إحالة إليها، ويبدأ الترقيم من جديد في كل فصل (عنوان من المستوى 1، وكل مستند في الكتاب)؛ والحاشية المحال إليها مرتين تحتفظ برقمها الأول وتُنضَّد مرة واحدة. ويجعل `footnotes.numbering: 'document'` الترقيم متصلًا عبر الكتاب، و`'page'` يبدؤه من جديد في كل صفحة، كما تفعل الكتب الصينية؛ ويكتب `footnotes.numberFormat: 'circled-decimal'` ① ② ③ على خط الأساس. ويُعلِّمها `footnotes.numberFormat: 'symbols'` بالرموز `*` و`†` و`‡` و`§` و`‖` و`¶`، ثم مضاعفةً، ويبدأ من جديد في كل صفحة، كما تفعل المجلات العلمية.
- **النص الياباني.** اكتب العلامة قبل 。 التي تختم الجملة (`先生[^1]。`): فهي تبقى مع الحرف الذي قبلها، و。 لا تفتتح سطرًا أبدًا. والكتاب الياباني العمودي يضع علاماته （1） على يمين السطر وحواشيه بعد الفصل افتراضيًا؛ ويضع `footnotes.markerPosition: 'side'` علامة صغيرة بجانب الكلمة لا تأخذ حيّزًا في السطر، ويضع `footnotes.placement: 'spread'` الحواشي بجانب نص كل صفحتين متقابلتين (انظر [الإعدادات › الحواشي السفلية](https://postext.dev/ar/docs/configuration-notes-references.md#الحواشي-السفلية)).
- **موضع الحاشية.** افتراضيًا في أسفل العمود الذي يحوي السطر المحيل إليها، تحت خط قصير: يتقاسم السطر وحاشيته العمود دائمًا، والسطر الذي لا تتسع حاشيته ينتقل معها. وفي الإخراج ذي العمود الواحد يكون ذلك أسفل الصفحة. ويُنضّد `footnotes.placement: 'chapterEnd'` حواشي الفصل كلها بعد آخر كتلة فيه بدلًا من ذلك، افتراضيًا في أسفل العمود الذي تُختم به. انظر [الحواشي السفلية](https://postext.dev/ar/docs/configuration-notes-references.md#الحواشي-السفلية) في مرجع الإعدادات للأحجام والخط والمسافات.
- **الفحوص.** العلامة التي لا تعريف لها (`undefinedFootnote`) تطبع رقمها فوق حاشية فارغة؛ والتعريف الذي لا تحيل إليه أي علامة (`unusedFootnote`) لا يُنضَّد. وتعرض Sandbox الحالتين في لوحة الفحوص.

## الإحالات والمراسي

تسمّي الإحالة (cross-reference) موضعًا في الكتاب وتطبع رقمه أو عنوانه أو صفحته: *انظر القسم 3.2*، *كما يشرح الفصل 4*، *في ص. 112*. وتتبع الكلماتُ والأرقام النصَّ، فنقل قسم أو إعادة ترقيم الفصول أو إعادة تدفق الكتاب يحدّث كل إحالة. وفي PDF وHTML ومعاينات Sandbox تكون كل إحالة رابطًا: نقرة تأخذ القارئ إلى هدفها، ولو في فصل آخر.

**المراسي.** تحتاج الإحالة إلى شيء تشير إليه:

- **عنوان** له معرّف: `## Method {#sec-method}` (صيغة Pandoc؛ ويعمل `id="sec-method"` أيضًا).
- **إطار أو حاوية أخرى** تُفتح بمعرّف: `:::callout{#box-safety title="Safety"}`. ويُحال إلى إطار من نمط مرقّم (مبرهنة) بتسميته ورقمه: *Theorem 2*.
- **صيغة منفصلة** فيها `\label{eq:x}` (انظر [الصيغ الرياضية](https://postext.dev/ar/docs/document-format-inline.md#الصيغ-الرياضية)): تطبع الإحالة رقمها كما تطبعه الصيغة، *(3)*.
- **نقطة في النص**: يضع `:anchor{#key-idea}` مرساة (anchor) غير مرئية؛ ويحتفظ `[the key idea]{#key-idea}` بكلماته ويسمّيها.

يقبل المعرّف الحروف والأرقام و`-` و`_` و`.` و`:`. ويجب أن يكون فريدًا في الكتاب: تعرض لوحة الفحوص المعرّف الموضوع مرتين (`duplicateAnchor`)، وتصل الإحالات إلى أول موضع له.

**الإحالات.** يسمّي `:ref{id="…"}` المرساة كما يسمّي شكلًا أو جدولًا:

```md
## Method {#sec-method}

The results of :ref{id="sec-method"} hold on :ref{id="sec-method" style=page}.
```

| `style` | ما يطبعه |
| --- | --- |
| *(لا شيء)* | العنوان المرقّم بكلمته ورقمه (*القسم 3.2*، *الفصل 4*)، والعنوان غير المرقّم بعنوانه، والمرساة بنصها، والمعادلة برقمها كما يُطبع (*(3)*)، والإطار المرقّم بتسميته ورقمه (*Theorem 2*) |
| `number` | الرقم وحده (*3.2*، *3*، *2*) |
| `title` | عنوان العنوان، أو نص المرساة، أو `title` الإطار |
| `page` | الصفحة التي وقع فيها (*ص. 112*) |
| `pageNumber` | رقم الصفحة وحده (*112*) |

ويعمل `\eqref{x}` و`\ref{x}` من LaTeX في النص أيضًا: `\eqref` إحالةً بلا `style`، و`\ref` مثل `style=number`، فيطبع `\ref{thm:main}` *2* ويطبع `\ref{fig:map}` رقم الشكل. والعلامة `~` التي تسبق أحدهما مباشرةً مسافة غير قابلة للكسر (`Theorem~\ref{thm:main}`). أما داخل `$…$` فهما جزء من الصيغة.

يطبع `text="…"` كلماتك أنت ويبقى رابطًا؛ ويبدأ `case=capitalize` التسمية بحرف كبير (*Section 3.2* في أول الجملة). وتتبع الكلمات لغة المستند (*sección 3.2*، *第3.2节*، *S. 112*) ويمكن تغييرها في [الإحالات](https://postext.dev/ar/docs/configuration-notes-references.md#الإحالات-المرجعية) في الإعدادات؛ ورقم العنوان الذي يكتبه قالبه بالحروف أصلًا (*Chapter 4*، *第四章*) يُطبع كما هو.

**كسر الأسطر.** الإحالة التي تطبع كلمات تنكسر عند مسافاتها مثل النص المحيط بها: نص المرساة (`[close the lever so that it points backwards]{#step}`)، أو عنوان، أو `text="…"` الذي تكتبه أنت. ومسافاتها مسافات من السطر، فتتمدد في السطر المضبوط مع سائر المسافات، وتبقى الإحالة رابطًا واحدًا، في قطعتين حين تمتد على سطرين. ولا تُقسم كلماتها بواصلة أبدًا. وفي تسمية كهذه يبقى الرقم أو الرقم الروماني أو الحرف المفرد مع الكلمة التي قبله، فلا تنفصل `text="Fig. 1a"` ولا `text="plate IV"` على سطرين. والتسمية التي تحمل رقمًا أو صفحة (*القسم 3.2*، *ص. 112*، *Fig. 1.7*، *Theorem 2*) لا تنكسر أبدًا، أيًّا كانت المسافة في قالبها، والمسافة غير القابلة للكسر داخل التسمية تلصق كما تلصق في أي موضع آخر. ويُبقي `crossRefs.breakLabels: false` كل تسمية كاملة، كما كان الحال حتى postext 1.27، حين كانت التسمية كلمة واحدة لا تستطيع الصعود إلى السطر الذي قبلها؛ انظر [الإحالات](https://postext.dev/ar/docs/configuration-notes-references.md#الإحالات-المرجعية).

**الإحالات إلى الصفحات** لا تُعرف إلا بعد إخراج الكتاب. فيعيد المحرّك إخراج المستند بصفحات المرور السابق حتى تثبت، كما يفعل مع المحتويات؛ وإلى ذلك الحين تطبع الصفحة *?*.

**pandoc-crossref.** النص المكتوب لـpandoc-crossref يُقرأ على النحو نفسه: `@sec:method`، و`[@fig:map]`، و`[-@tbl:data]` للرقم وحده. وقد تكون البادئة (`sec`، `fig`، `tbl`، `eq`، `lst`) جزءًا من المعرّف (`{#sec:method}`) أو محذوفة منه (`{#method}`). وتبقى `@` الملتصقة بكلمة، كما في عنوان البريد الإلكتروني، نصًا.

الإحالة إلى معرّف لا يضعه شيء تطبع *?* وتعرضها لوحة الفحوص (`unknownResourceId`). وفي محرّر Sandbox يعرض `@` أشكال الكتاب وجداوله وعناوينه ذات المعرّفات ومراسيه.

## الاستشهادات وقائمة المراجع

اكتب الاستشهادات كما يقرؤها Pandoc، واحفظ المراجع في المستند، واختر نمط الاستشهاد في الإعدادات: الانتقال من APA إلى IEEE، أو إلى حواشي Chicago، يغيّر إعداد النمط لا النص. ويرتبط كل استشهاد بمدخله في قائمة المراجع.

### الاستشهاد

```md
As [@garcia2020, p. 33] shows, reading on paper is faster [see @lopez2019, chap. 2; @bringhurst2004].
@garcia2020 [p. 4] says it plainly; the 2020 study [-@garcia2020] agrees.
```

- **`[@key]`** يستشهد بين قوسين؛ وتوضع الأعمال المتعددة في زوج واحد من الأقواس المربعة، مفصولة بـ`;`.
- **محدِّد الموضع:** بعد فاصلة، `p. 33`، `pp. 4–6`، `chap. 2`، `sec. IV`، `fig. 3`، `vol. 2`، `n. 12`، `l. 4`، `§ 4.2`؛ والعدد المجرد صفحة. وتعمل الكلمات الإسبانية (`pág.`، `cap.`) والصينية (`页`، `章`) أيضًا. ويُكتب النطاق بشرطة متوسطة أو بشرطتَي TeX: تُطبع `pp. 4--6` هكذا: *4–6*.
- **البادئة واللاحقة:** نص قبل `@` (`see`) وبعد المفتاح أو محدِّد الموضع (`, emphasis added`). تحتفظ اللاحقة بالفاصلة المكتوبة قبلها، بمحدِّد موضع أو بدونه: `[@brown2020, inter alia]` تُطبع *(Brown et al., 2020, inter alia)* كما يفعل Pandoc، وإذا كُتبت بلا فاصلة (`[@brown2020 inter alia]`) فلا فاصلة. والتوكيد في البادئة أو اللاحقة يُنضَّد توكيدًا في كل الأنماط: `[*e.g.*, @brown2020, *inter alia*]`.
- **`[-@key]`** يُسقط المؤلف، للجملة التي تسمّي المؤلف أصلًا.
- **`@key`** يستشهد داخل الجملة (*García (2020)*)؛ ويضيف `@key [p. 4]` محدِّد موضع.
- **في التعليقات:** يستشهد تعليق الشكل أو الجدول، وملاحظته، كما يستشهد النص (`أفضل نتيجة سابقة [@cobbe2021].`). تدخل أعمالهما في قائمة المراجع دون `nocite`، ويرقّمها النمط الرقمي حيث يوضع المورد: بعد استشهادات الفقرة التي تشير إليه أول مرة (كتلة `::resource` أو أول `:ref`). أما الاستشهاد في خلية جدول فيبقى نصًا.
- تبقى نصًا كلٌّ من `@` الملتصقة بحرف أو رقم (عنوان بريد إلكتروني)، و`@` في الشيفرة المضمّنة، و`\@`. والاستشهاد الذي لا مرجع له في الكتاب يُطبع كما كُتب، فيُقرأ المستند الخالي من المراجع كما كان. وفي الاستشهاد بعدة أعمال، يُطبع المفتاح الذي لا يعرّفه أي مرجع بالعريض بعد الأخرى (`(Glen, 1955) **@nye1953**`)، فيظهر العمل المفقود على الصفحة كما يظهر بين التحذيرات. والنقطتان بعد الاستشهاد نص: `[@french2018]: the land…`.
- في النص الصيني والياباني والكوري يتبع الاستشهادُ الحرفَ الأخير بلا مسافة (`周明远@zhou2019认为`)، ويأخذ استشهاد المؤلف والتاريخ علامات الترقيم كاملة العرض من النص المحيط به: `（施雅风等，1988；刘时银等，2015）`.

### المراجع

تُكتب المراجع في المستند، بصيغة CSL (نموذج البيانات في Zotero وPandoc):

```md
---
references:
  - id: garcia2020
    type: book
    author: [{family: García, given: Ana}]
    title: Tipografía y lectura
    issued: 2020
    publisher: Trea
nocite: "@lopez2019"
---
```

أو في كتلة `:::references`، بصيغة BibTeX (تصدير من Zotero أو JabRef أو Google Scholar) أو CSL-JSON أو CSL-YAML:

```md
:::references{format=bibtex}
@article{lopez2019, author = {López, Luis and Ruiz, Eva}, title = {Leer en pantalla},
  journal = {Revista de Letras}, year = 2019, volume = 12, pages = {45--67}, doi = {10.1000/xyz}}
:::
```

لا تطبع الكتلة شيئًا. ويسرد `nocite` أعمالًا دون الاستشهاد بها (`@*`: كلها). وفي الكتاب، تُحتسب المراجع المكتوبة في أي فصل للكتاب كله.

في قائمة أسماء BibTeX، تمثّل `and others` الأسماء المحذوفة (`author = {Tan, Wei and others}`): فتطبع كل الأنماط مكانها *et al.* أو «وآخرون». وفي YAML، اكتب `others` اسمًا أخيرًا في القائمة.

### قائمة المراجع

يُنضّد `:::bibliography` قائمة الأعمال المستشهد بها في موضعه؛ ومن دونه تأتي القائمة بعد الفصل الأخير، بعنوان بلغة المستند (*References*، *Referencias*، *参考文献*). ويغيّر `:::bibliography{title="Works cited"}` العنوان، ويحذفه `title=""`؛ ويسرد `scope=chapter` الأعمال التي يستشهد بها الفصل (لكتاب جماعي محرَّر). وكل مدخل مرساة (`ref-<key>`)، فيصل إليه رابط Markdown إلى `#ref-garcia2020`، ويسمه PDF بالوسم `BibEntry`.

ويسرد `scope=new` الأعمال المستشهد بها حتى ذلك الموضع من المستند ولم تطبعها قائمة سابقة، بترتيب النمط وبأرقامه: فوضع `:::bibliography{scope=new}` بعد النص الرئيسي وآخر بعد قسم الطرائق يعطي قائمتَي بحث في Nature، والثانية مرقّمة تكملةً للأولى. ويعدّ النمط الرقمي استشهاداته عبر الكتاب كله؛ ومع `citations.numbering: 'chapter'` يرقّم كل فصل (كل مستند، وكل عنوان من المستوى 1 بعد استشهاد) استشهاداته من 1، وتأخذ قائمة الفصل هذه الأرقام، كما في تقارير النشرة أو أبحاث أعمال المؤتمرات.

### الأنماط

يقرّر النمط ما يقوله الاستشهاد والمدخل. الأنماط المضمّنة مسرودة أدناه؛ ويمكن تحميل أي نمط CSL آخر (يضم مستودع أنماط Zotero أكثر من عشرة آلاف) من ملف `.csl` الخاص به في **الإعدادات › الاستشهادات**.

| `citations.style` | الاسم | النظام |
| --- | --- | --- |
| `apa` | APA 7 | المؤلف والتاريخ |
| `chicago-author-date` | Chicago (المؤلف والتاريخ) | المؤلف والتاريخ |
| `harvard-cite-them-right` | Harvard | المؤلف والتاريخ |
| `iso690-author-date-en`، `iso690-author-date-es` | ISO 690 | المؤلف والتاريخ |
| `china-national-standard-gb-t-7714-2025-author-date` | GB/T 7714—2025 著者-出版年 | المؤلف والتاريخ |
| `china-national-standard-gb-t-7714-2015-author-date` | GB/T 7714—2015 著者-出版年 | المؤلف والتاريخ |
| `modern-language-association` | MLA 9 | المؤلف والصفحة |
| `ieee` | IEEE | مرقّم |
| `elsevier-vancouver` | Vancouver | مرقّم |
| `american-medical-association` | AMA | مرقّم |
| `nature` | Nature | مرقّم |
| `iso690-numeric-en` | ISO 690 | مرقّم |
| `china-national-standard-gb-t-7714-2025-numeric` | GB/T 7714—2025 顺序编码 | مرقّم |
| `china-national-standard-gb-t-7714-2015-numeric` | GB/T 7714—2015 顺序编码 | مرقّم |
| `sist02` | SIST 02 参照文献の書き方 | مرقّم |
| `chicago-notes-bibliography` | Chicago (الحواشي) | الحواشي |
| `oscola` | OSCOLA | الحواشي |
| `china-national-standard-gb-t-7714-2025-note` | GB/T 7714—2025 注释 | الحواشي |
| `china-national-standard-gb-t-7714-2015-note` | GB/T 7714—2015 注释 | الحواشي |

مع **نمط الحواشي** يصير كل استشهاد حاشية سفلية، توضع وتُرقَّم كما تقول إعدادات الحواشي السفلية؛ وتأخذ الاستشهادات اللاحقة بالعمل نفسه صيغة مختصرة. وفي النص الصيني يُنضّد `citations.notes: 'warichu'` هذه الحواشي تعليقات من صفّين داخل السطر (夹注)؛ والحاشية التي تليها علامة صينية (`，`، `。`) تُسقط نقطتها الخاصة.

**الصينية.** تكتب أنماط GB/T 7714-2015 رموز نوع الوثيقة (`[M]`، `[J]`، `[D]`، `[EB/OL]`)، وتُبقي الأسماء الصينية كاملة، وتكتب `等` بعد ثلاثة مؤلفين لعمل صيني و`et al.` بعد مؤلفي عمل غربي، وتختار بحسب `language` كل عمل. وفي النص العمودي يقف الرقم الفوقي على يمين حرفه؛ ويكتب `citations.marker: 'corner'` الصيغة `〔1〕`، التي تبقى قائمة.

**المحرّك.** تُنسَّق الاستشهادات بالحزمة `postext-citeproc` (citeproc-js وأنماط CSL). تحمّلها Sandbox للمستندات التي فيها استشهادات؛ وفي شيفرتك أنت، سجّلها قبل الإخراج:

```ts
import 'postext-citeproc/register';
```

تعرض لوحة الفحوص المفتاح الذي لا يعرّفه أي مرجع (`unknownCitationKey`) وكتلة المراجع التي تتعذّر قراءتها (`referencesUnreadable`).

## الفهرس الأبجدي

يسرد الفهرس الأبجدي (back-of-book index) مصطلحات الكتاب مع الصفحات التي تظهر فيها. علّم كل مصطلح حيث يناقشه النص، واطبع الفهرس بـ`:::index` في موضعه، وهو عادةً فصل مستقل في النهاية. ويجد المحرّك صفحة كل علامة بعد الإخراج، فتتبع الأرقامُ النصَّ: أضف فقرة، أو انقل فصلًا، أو غيّر حدّ القص، فيطبع الفهرس الصفحات الجديدة.

```md
Iron-deficiency :index[anaemia] is the most common kind.
The pulse is taken at the wrist.:index{term="Pulse!radial" main}

# Index {style="index"}

:::index
```

### علامات الفهرس

- **`:index[text]`** تطبع `text` وتُدرجه تحت كلماته نفسها. والعلامات المضمّنة داخلها تُطبع وتُسقط من المدخل. والسمات بعد القوس تُدرجه في موضع آخر: `:index[iron deficiency]{term="Anaemia!iron-deficiency"}`.
- **`:index{term="…"}`** لا تطبع شيئًا. تأخذ العلامة صفحة الكلمة المكتوبة قبلها مباشرة في سطرها، أو صفحة الكلمة التي بعدها إذا افتتحت سطرًا. ويُحذف السطر الذي لا يحوي إلا علامات، فلا تقسم العلامة الواقعة في سطر مستقل فقرةً ولا تضيف مسافة أبدًا.
- **المواضع.** الفقرات والعناوين وعناصر القوائم والاقتباسات الكتلية والإطارات وتعريفات الحواشي السفلية. أما في التعليقات وخلايا الجداول وعناصر التصميم فتُطبع العلامة كما كُتبت. وداخل الشيفرة المضمّنة، وبعد الشرطة المائلة العكسية (`\:index`)، تكون نصًا.

| السمة | الأثر |
| --- | --- |
| `term` | المدخل، ومستوياته مفصولة بـ`!`: يُدرج `term="Heart!valves!mitral"` الصفحة تحت *mitral*، وهو مدخل فرعي من *valves* تحت *Heart*. وقد يحمل المستوى علامات مضمّنة (`term="*Escherichia coli*"`)؛ ويُرتَّب من دونها. ومن دون `term` تستعمل `:index[text]` نصها. |
| `sub` | مستوى يُضاف بعد `term`: `term="Heart" sub="valves"` هو `term="Heart!valves"`. |
| `sort` | مفتاح ترتيب المستوى الأخير حين ينبغي أن يُرتَّب بحروف أخرى: `:index[St Kilda]{sort="Saint Kilda"}`، `term="20th century" sort="twentieth century"`. والفهرس الصيني يُرتّب ويُجمّع بحسب القراءة التي يعطيها المرتِّب (collator) للحرف. وللحرف متعدد القراءات المقروء على الوجه الآخر، اكتب المفتاح بحروف ليس لها إلا القراءة التي تريدها: `:index[重阳]{sort="崇阳"}` يُدرج 重阳 تحت C، بين 程 و崔، لا تحت Z. ومفتاح البينيين (`sort="chong yang"`) يصل إلى C أيضًا، لكنه يُرتَّب بعد كل مداخلها الصينية، لأن المرتِّب يضع الحروف اللاتينية بعد الحروف الصينية (انظر [الإعدادات › الفهرس الأبجدي](https://postext.dev/ar/docs/configuration-notes-references.md#الفهرس-الأبجدي)، `groupBy`). |
| `yomi`، `reading` | قراءة المستوى الأخير بالكانا، التي يُرتَّب بها في الفهرس الياباني ويُجمَّع: `:index[夏目漱石]{yomi="なつめそうせき"}` يُدرج تحت な، في صف な行. ودونها تُقرأ العلامة التي يحمل نصها فوريغانا بالكانا عبر تلك الفوريغانا (`:index[{東京\|とう\|きょう}]` يُرتَّب على أنه とうきょう)، ثم `sort`، ثم النص؛ والمدخل الذي ما زال يبدأ بكانجي يُبلَّغ عنه بالتحذير `indexReadingMissing`. وفي فهرس بلغة أخرى تعمل `yomi` عمل `sort`. اكتب الفوريغانا داخل العلامة بالصيغة المختصرة: فـ `:ruby[…]` ستحتاج إلى تهريب أقواسها. منذ postext 1.16. |
| `main` | علَم: الموضع الرئيسي لمناقشة المصطلح. يُنضَّد رقم صفحته بالعريض (`index.main`). والصفحة المعلَّمة على الوجهين تكون عريضة. |
| `range` | `range="start"` و`range="end"`، بالمصطلح نفسه، تحدّان مناقشة تمتد على عدة صفحات: يطبع المدخل `34–37`. والبداية بلا نهاية، أو النهاية بلا بداية، تطبع صفحتها الوحيدة وتُطلق `indexRangeUnclosed`. |
| `see` | إحالة بدل رقم الصفحة: `:index{term="Cardiac insufficiency" see="Heart failure"}` تطبع *Cardiac insufficiency. See Heart failure*. ومستويات الهدف مفصولة بـ`!` وتُطبع بنقطتين (*See Heart: valves*). والهدف الذي ليس مدخلًا في الفهرس يُطلق `indexSeeUnknown`. |
| `seealso` | إحالة بعد أرقام صفحات المدخل: *Heart, 12, 40. See also Circulation*. وتُحتسب صفحة العلامة نفسها كصفحة أي علامة أخرى، فتستطيع علامة واحدة أن تفهرس مقطعًا وتشير إلى مدخل ذي صلة؛ أما علامة `see` فلا تضيف صفحة. |
| `index` | اسم فهرس مستقل: `index="names"` يُدرج العلامة في الفهرس الذي تطبعه `:::index{index="names"}`، لا في الفهرس الرئيسي. |

العلامة التي لا مصطلح لها (`:index{}` أو `:index{see="…"}` وحدها) لا تفهرس شيئًا وتُطلق `indexMarkInvalid`.

### طباعة الفهرس

يطبع `:::index` الفهرس الرئيسي في موضعه، و`:::index{index="names"}` فهرسًا مسمّى. ويتمدّد التوجيه إلى كتل عادية، كتلة لكل مدخل، تجري عبر الأعمدة والصفحات كالنص: تحت عنوان يحدّد [نمطُ عنوانه](https://postext.dev/ar/docs/configuration-styles.md#أنماط-العناوين) `layout` من عمودين، يعطي الفهرس المعتاد ذا العمودين. والنقر على مدخل ينقلك إلى سطر التوجيه.

```md
# Index of names {style="index"}

:::index{index="names"}

# Index of subjects {style="index"}

:::index
```

- **الترتيب.** تُرتَّب المداخل بالترتيب الأبجدي للغة المستند (`locale`، أو `index.locale`): الحرف المشكول بعلامة يُدرج مع حرفه الأساسي (*Árbol* تحت A)، وفي الإسبانية يأتي *ñ* بعد *n*، تحت رأس خاص به. وتأتي أولًا المداخل التي تبدأ برمز، ثم التي تبدأ برقم، ثم الحروف. وتُرتَّب المداخل الفرعية بالطريقة نفسها تحت مدخلها، مزاحةً خطوة لكل مستوى. والفهرس الياباني يُرتَّب بحسب القراءة بترتيب JIS X 4061 ويُجمَّع بصفوف غوجوون (あ行، か行…)، ومداخله اللاتينية قبل الكانا (انظر [الإخراج الياباني › الفهرس بترتيب غوجوون](https://postext.dev/ar/docs/japanese-layout.md#الفهرس-بترتيب-غوجوون)).
- **المجموعات.** كل حرف أول جديد يفتح مجموعة: رأس حرف (`index.groups`) وسطر من المسافة فوقه (لا شيء فوق المجموعة الأولى). ويُنضَّد الرأس في كتلة واحدة مع أول مدخل في المجموعة، فلا يختم عمودًا وحده أبدًا؛ والمدخل الذي لا صفحة له (الذي لا يفعل إلا أن يترأس مداخله الفرعية) يُنضَّد مع أول مدخل فرعي له للسبب نفسه.
- **أرقام الصفحات.** التسميات التي تطبعها الصفحات، بما فيها الرومانية في الصفحات التمهيدية. تُرتَّب صفحات المدخل وتُسرد كل منها مرة واحدة؛ وتنضمّ الصفحات المتتالية في مدى (`12–14`، `index.mergeRanges`)، والصفحة الواقعة داخل مدى للمدخل نفسه تُطوى فيه (والصفحة الرئيسية هناك تجعل المدى عريضًا)، ويختصر `index.rangeFormat: 'chicago'` الرقم الثاني (`234–37`). وتبقى الصفحات العريضة (الرئيسية) منفصلة. وفي PDF يرتبط كل رقم بصفحته.
- **الإحالات** تختم المدخل: *Term. See Target* حين لا تكون للمدخل صفحات، و*Term, 12. See also Target* حين تكون له. وتتبع التسميات لغة المستند (*See*، *Véase*…) ويمكن ضبطها في `index.see`.
- **الكتب.** في الكتاب المُخرَج فصلًا فصلًا (Sandbox، `buildBundle`) يتلقى الفصل الذي يطبع الفهرس علامات كل الفصول مع صفحاتها، ولا يُعاد إخراجه إلا حين تتحرك إحداها. والمستند الذي يحوي علاماته وفهرسه معًا يُعاد إخراجه حتى تثبت الأرقام، كما مع `:::toc`.

انظر [الفهرس الأبجدي](https://postext.dev/ar/docs/configuration-notes-references.md#الفهرس-الأبجدي) في مرجع الإعدادات للتنسيق الطباعي والإزاحات والفواصل.