# Arabischer Fachartikel mit Fußnoten, Zitaten und Register

> Ein Artikel einer arabischen Fachzeitschrift: Fußnoten „(١)“ seitenweise gezählt, CSL-Zitate darunter in arabischer Locale und ein Register ohne den Artikel ال.

- HTML-Fassung: https://postext.dev/de/cookbook/arabic-research-article
- Rezept Nº 107 · Buchaufbau · Stufe 3 (Fortgeschritten) · Ausgaben: Canvas, PDF
- Gattungen: Fachartikel und Wissenschaft
- Benötigt postext ≥ 1.26.0, postext-pdf ≥ 1.26.0 · getestet mit 1.31.0, postext-pdf 1.31.0 am 2026-10-13
- Seiten: [٨٧](https://postext.dev/cookbook/arabic-research-article/en/p01.webp?v=4fa99642), [٨٨](https://postext.dev/cookbook/arabic-research-article/en/p02.webp?v=4fa99642), [٨٩](https://postext.dev/cookbook/arabic-research-article/en/p03.webp?v=4fa99642), [٩٠](https://postext.dev/cookbook/arabic-research-article/en/p04.webp?v=4fa99642), [٩١](https://postext.dev/cookbook/arabic-research-article/en/p05.webp?v=4fa99642)
- PDF: https://postext.dev/cookbook/arabic-research-article/en/arabic-research-article.pdf?v=4fa99642
- In der Sandbox öffnen: https://postext.dev/de/sandbox#recipe=arabic-research-article&lang=en (.postext: https://postext.dev/cookbook/arabic-research-article/en/arabic-research-article.postext)
- Zuletzt aktualisiert: 2026-10-11
- Andere Sprachen: [en](https://postext.dev/en/cookbook/arabic-research-article.md), [es](https://postext.dev/es/cookbook/arabic-research-article.md), [ca](https://postext.dev/ca/cookbook/arabic-research-article.md), [fr](https://postext.dev/fr/cookbook/arabic-research-article.md), [it](https://postext.dev/it/cookbook/arabic-research-article.md), [pt](https://postext.dev/pt/cookbook/arabic-research-article.md), [zh](https://postext.dev/zh/cookbook/arabic-research-article.md), [ja](https://postext.dev/ja/cookbook/arabic-research-article.md), [ar](https://postext.dev/ar/cookbook/arabic-research-article.md)

## Kurz gesagt

Fünf Seiten einer arabischen Fachzeitschrift: der Artikel, seine Fußnoten, sein Literaturverzeichnis und ein Register. Das Register ordnet الكشيدة unter ك ein, wie es arabische Register tun, und nicht unter dem Artikel ال.

## Was Sie setzen

Fünf Seiten aus einem Heft einer erfundenen arabischen Fachzeitschrift, im Format 17 × 24 cm, beginnend mit Seite 87: ein Artikel über die Frage, ob Blocksatz mit Kaschida das Lesen verlangsamt, gesetzt in Amiri zu 12 pt mit Abschnittsüberschriften in Noto Kufi Arabic. Die Fußnoten stehen am Fuß jeder Seite und werden auf jeder Seite neu ab „(١)“, „(٢)“ gezählt, wie arabische Zeitschriften sie zählen; die Zitate, im Markdown als `[@ayalon2016]` geschrieben, sind ebenfalls Fußnoten und werden vom Chicago-Notenstil mit der arabischen CSL-Locale formatiert. Danach folgt ein Literaturverzeichnis, die arabischen Werke zuerst, und ein zweispaltiges Register schließt den Beitrag ab. Das Register ordnet الكشيدة unter ك und الصحف اليومية unter ص ein: Der Artikel ال zählt nicht. [Der historische Essay mit Chicago-Noten](https://postext.dev/de/cookbook/history-essay-chicago-notes.md) macht dasselbe auf Englisch.

**Dieses Rezept beantwortet:**

- Wie zitiere ich Quellen in einem arabischen Artikel, mit Fußnoten und Literaturverzeichnis?
- Wie zitiere ich Quellen in einem arabischen Artikel, mit Fußnoten und Literaturverzeichnis?

## Die kurze Antwort

```js
// script.js, Zeilen 35–58
// Citations are written [@ayalon2016, 45] in the text; a note style puts each one in a
// footnote, numbered with the author's own [^notes]. The CSL locale is Arabic: ص for a page.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
  bibliography: { fontSize: em(0.9), lineHeight: pt(17), hangingIndent: em(2),
    entrySpacing: pt(2) },
};
const footnotes = {
  markerTemplate: '({n})', // «(١)», in the document's digits
  numbering: 'page', // from (١) again on every page, as Arabic journals number them
  noteNumberPosition: 'inline', // the note opens with (١) on the line, not raised
  fontSize: pt(10), lineHeight: pt(18), spaceBetween: pt(2), // 1.8 ×: tanwīn clears the line
  textAlign: 'start', // ragged from the right: a Latin title would open wide gaps
  separator: { width: 0.3, lineWidth: pt(0.5), color: col('red') }, // on the start side
};
// The index sorts by the word after the article: الكشيدة files under ك, not under ا.
// ignoreArticle is already true for an Arabic index; it is written out to be seen.
const index = {
  ignoreArticle: true,
  fontFamily: TEXT, fontSize: pt(10.5), lineHeight: pt(16), indent: em(1.2),
  main: { bold: true }, // the page that defines the term
  groups: { fontFamily: LABEL, fontSize: pt(10), fontWeight: 700, color: col('red') },
};
```

## Zutaten

**Zeigt**

- [Arabisch als Dokumentsprache](https://postext.dev/de/docs/arabic-layout.md#ein-arabisches-buch-anlegen): locale 'ar' (mit beliebiger Region) liefert Bildunterschriften und Fortsetzungshinweise auf Arabisch (شكل، جدول، يتبع), auf Arabisch ausgeschriebene Datumsangaben, das arabische CSL-Locale für Zitate, arabische Sortierung im Register und keine Silbentrennung.
- [Register ohne Artikel sortiert](https://postext.dev/de/docs/configuration-notes-references.md#register): index.ignoreArticle (für Arabisch aktiv) sortiert und gruppiert Einträge, als stünde der Artikel ال nicht da: البصرة steht unter ب, zwischen بدر und بغداد, und wird wie geschrieben gedruckt; Formen mit Hamza und Alif werden zusammen sortiert.
- [Zitate in Fußnoten](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis): Ein Fußnotenstil (Chicago notes, OSCOLA, GB/T 7714 notes) setzt jedes Zitat als Fußnote, mit Kurzformen für spätere Zitate, oder als zweizeilige Anmerkung in einer chinesischen Zeile.

**Verwendet außerdem**

- [Fußnoten](https://postext.dev/de/docs/document-format.md#fußnoten)
- [Zitate in einem Zitierstil](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis)
- [Literaturverzeichnis aus den Quellen](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis)
- [Register](https://postext.dev/de/docs/document-format.md#register)
- [Text von rechts nach links](https://postext.dev/de/docs/arabic-layout.md#richtung-und-bidirektionaler-algorithmus)
- [Arabische Schriften](https://postext.dev/de/docs/arabic-layout.md#schriften)
- [Ziffern der erzeugten Zahlen](https://postext.dev/de/docs/configuration-text.md#dokumentsprache)
- [Nummerierte Überschriften](https://postext.dev/de/docs/configuration-text.md#überschreibungen-pro-ebene)
- [Überschriftenformate](https://postext.dev/de/docs/configuration-styles.md#überschriftenstile)
- [Gestaltete Auftakte](https://postext.dev/de/docs/configuration-text.md#seitenbreite-und-erweiterte-gestaltung)
- [Kolumnentitel und Seitenzahlen](https://postext.dev/de/docs/configuration-page-layout.md#kopf--und-fußzeilen)
- [Kästen](https://postext.dev/de/docs/configuration-styles.md#kastenstile)
- [PDF-Export](https://postext.dev/de/docs/configuration-programmatic-usage.md#pdfs-erzeugen)
- [Absätze in der anderen Richtung](https://postext.dev/de/docs/arabic-layout.md#richtung-von-dokument-block-und-textlauf)
- [Spaltenausgleich](https://postext.dev/de/docs/configuration-text.md#spaltenausgleich)
- [Überschriftenattribute](https://postext.dev/de/docs/document-format.md#attribute-von-überschriften)
- [Papierfarbe](https://postext.dev/de/docs/configuration-page-layout.md#seite)
- [Kopfzeilen nach Seitenrolle](https://postext.dev/de/docs/configuration-page-layout.md#textelemente)
- [Absatzformate](https://postext.dev/de/docs/configuration-styles.md#absatzformate)
- [Im PDF eingebettete Schriften](https://postext.dev/de/docs/configuration-programmatic-usage.md#warum-ein-font-provider)
- [Rechts gebundene Bücher](https://postext.dev/de/docs/configuration-page-layout.md#bindung)
- [Römisch paginierte Titelei](https://postext.dev/de/docs/document-format.md#numbering)
- [Abschnittsgeometrie](https://postext.dev/de/docs/configuration-styles.md#überschriftenstile)
- [Kapitel ohne Nummer](https://postext.dev/de/docs/configuration-styles.md#überschriftenstile)

**Die Konfiguration auf einen Blick**

- [`bodyText`](https://postext.dev/de/docs/configuration-text.md#fließtext), [`calloutStyles`](https://postext.dev/de/docs/configuration-styles.md#kastenstile), [`citations`](https://postext.dev/de/docs/configuration-notes-references.md#zitationen), [`colorPalette`](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#farbpalette), [`footer`](https://postext.dev/de/docs/configuration-page-layout.md#kopf--und-fußzeilen), `footnotes`, [`header`](https://postext.dev/de/docs/configuration-page-layout.md#kopf--und-fußzeilen), [`headingStyles`](https://postext.dev/de/docs/configuration-styles.md#überschriftenstile), [`headings`](https://postext.dev/de/docs/configuration-text.md#überschriften), [`index`](https://postext.dev/de/docs/configuration-notes-references.md#register), [`layout`](https://postext.dev/de/docs/configuration-page-layout.md#layout), [`locale`](https://postext.dev/de/docs/configuration-text.md#silbentrennung), [`page`](https://postext.dev/de/docs/configuration-page-layout.md#seite), [`paragraphStyles`](https://postext.dev/de/docs/configuration-styles.md#absatzformate)

**APIs**

- [`LOCALES`](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis), [`STYLES`](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis), [`buildDocument`](https://postext.dev/de/docs/configuration-programmatic-usage.md#ein-dokument-erzeugen), [`createCiteprocEngine`](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis), [`decompressWoff2`](https://postext.dev/de/docs/configuration-programmatic-usage.md#font-provider-im-browser-fontsource--woff2), [`registerCitationEngine`](https://postext.dev/de/docs/document-format.md#zitate-und-literaturverzeichnis), [`renderPageToCanvas`](https://postext.dev/de/docs/configuration-programmatic-usage.md#eine-seite-als-bitmap-rendern), [`renderToPdf`](https://postext.dev/de/docs/configuration-programmatic-usage.md#pdfs-erzeugen), [`withLoadedFonts`](https://postext.dev/de/docs/configuration-programmatic-usage.md#schriften-vor-dem-layout-laden)

**Schriften**

- Amiri (OFL-1.1), Noto Kufi Arabic (OFL-1.1)

## Zubereitung

### 1 · Fußnoten, Zitate und Register an einer Stelle

Den Code finden Sie oben unter [Die kurze Antwort](https://postext.dev/de/cookbook/arabic-research-article.md#die-kurze-antwort). Die Fußnoteneinstellungen sind die drei, die arabische Bücher verlangen: `markerTemplate: '({n})'` für die Klammern, `numbering: 'page'`, damit die Zählung auf jeder Seite neu beginnt, und `noteNumberPosition: 'inline'`, damit die Fußnote mit „(١)“ in ihrer Zeile beginnt; die Ziffern sind die des Dokuments, und der Fußnotenstrich steht rechts ([Fußnoten](https://postext.dev/de/docs/arabic-layout.md#fußnoten)). Die Zitate teilen sich die Zählung mit den Fußnoten. `citations.locale: 'ar'` liefert die CSL-Begriffe auf Arabisch, etwa عدد für eine Heftnummer. `index.ignoreArticle` sortiert jeden Eintrag nach dem Wort hinter ال und fasst die Formen der Hamza zusammen, sodass أميري und الأعمدة beide unter ا stehen ([Inhaltsverzeichnis und Register](https://postext.dev/de/docs/arabic-layout.md#inhaltsverzeichnis-und-register)); für ein arabisches Register ist die Option ohnehin eingeschaltet und steht hier nur, damit man sie sieht.

![Opening page ٩١: فهرس الأعلام والموضوعات.](https://postext.dev/cookbook/arabic-research-article/en/p05.webp?v=4fa99642)

*Das Register: zwei Spalten von rechts, Buchstaben in Rot, الكشيدة unter ك mit einem Siehe-auch-Verweis.*

### 2 · Ein Zeitschriftenkopf ohne Band

```js
// script.js, Zeilen 62–75
const centred = (y, extra = {}) => ({ anchor: { to: 'container', edge: 'top' },
  offset: { y: mm(y) }, size: { width: 'fill' }, ...extra });
const line = (id, content, family, size, colour, y, extra = {}) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(colour), align: 'center',
  overflow: 'wrap', placement: centred(y), ...extra });
const masthead = { enabled: true, minHeight: mm(70), slot: { elements: [
  line('journal', JOURNAL, LABEL, 9, 'red', 0, { fontWeight: 700 }),
  line('issue', '{attr.issue}', LABEL, 8, 'muted', 6),
  { kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
    placement: centred(13) },
  line('title', '{titleText}', TEXT, 22, 'ink', 18, { fontWeight: 700, lineHeight: 1.45 }),
  line('author', '{attr.author}', TEXT, 13, 'ink', 45),
  line('affiliation', '{attr.affiliation}', TEXT, 10, 'muted', 52),
] } };
```

Der Titel des Artikels ist die Überschrift der Ebene 1, gezeichnet von einem Design: Name und Heft der Zeitschrift, eine Haarlinie, der Titel in zwei zentrierten Zeilen und die Autorin. Die Heftzeile ist in arabisch-indischen Ziffern getippt, denn das Attribut eines Designs ist Text der Autorin, und die Engine schreibt ihn nicht um. Die Seitenzählung beginnt bei 87 (`page.pageNumbering.startAt`), sodass die Paginierung zeigt, wo der Artikel im Heft steht.

### 3 · Kolumnentitel von der äußeren Ecke aus

```js
// script.js, Zeilen 79–89
const head = (id, content, parity, edge, x) => ({ kind: 'text', id, content, parity,
  pages: 'body', fontFamily: LABEL, fontSize: pt(7.5), color: col('muted'), align: edge,
  placement: { anchor: { to: 'page', edge: `top-${edge}` }, offset: { x: mm(x), y: mm(13) } } });
const folio = (id, parity, edge, x) => ({ ...head(id, '{pageNumber}', parity, edge, x),
  fontWeight: 700, color: col('red') });
const header = { elements: [
  folio('r-folio', 'even', 'right', -SIDE.outer),
  head('r-head', JOURNAL, 'even', 'right', -(SIDE.outer + 9)),
  head('l-head', 'سلمى الخطيب: أثر الكشيدة في سرعة القراءة', 'odd', 'left', SIDE.outer + 9),
  folio('l-folio', 'odd', 'left', SIDE.outer),
] };
```

Die rechten Seiten tragen den Namen der Zeitschrift, die linken die Autorin und einen Kurztitel, jeweils mit der Pagina in der äußeren Ecke. Elemente der Kopfzeile behalten ihre physischen Seiten, daher wird die gerade Seite, die in dieser Bindung rechts liegt, an `top-right` verankert.

## Das ganze Rezept

Eine Datei, aus dem Ordner des Rezepts zusammengesetzt, mit dem Beispieltext und dem gemeinsamen Baukasten der Rezepte bereits eingebettet; sie baut ihre eigene Seite auf. Zum Ausführen setzen Sie sie in ein `<script type="module">` auf einer leeren Seite oder fügen sie in das JS-Feld eines neuen CodePen-Pens ein (als Modul). Sie importiert postext von esm.sh, es gibt also nichts zu installieren oder zu bauen.

- Quellordner: https://github.com/drnachio/postext/tree/main/cookbook/arabic-research-article

### script.js

```js
// ═══ Postext Cookbook · Nº 107 · An Arabic research article with notes, citations and an index ═══
// https://postext.dev/en/cookbook/arabic-research-article
// Code: MIT · Text: original Arabic prose (CC BY 4.0) · Pictures: none
// Fonts: Amiri, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.26.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'en'; // @lang: the language of the frame; the article is Arabic in both editions
const RECIPE = 'arabic-research-article';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a journal's dark red on a warm white
const palette = {
  ink: '#1d1a19', // text
  red: '#7d2028', // the accent: the journal's name, section numbers, the notes' rule
  rose: '#f1e4e1', // the abstract's ground
  rule: '#c8bcb5', // hairlines
  muted: '#655d58', // running heads, the colophon
  paper: '#fffdfa',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, LABEL] = ['Amiri', 'Noto Kufi Arabic'];
const [BODY, LEAD] = [12, 20]; // pt: Amiri, partly vocalised, at 1.67 × the size
const TRIM = { width: 170, height: 240 }; // mm: 17 × 24 cm, the Arab journal
const SIDE = { inner: 22, outer: 18 }; // mm
const JOURNAL = 'مجلة دراسات الكتاب والنشر';

// #region answer: notes «(١)» per page, the citations among them, an index without ال
// Citations are written [@ayalon2016, 45] in the text; a note style puts each one in a
// footnote, numbered with the author's own [^notes]. The CSL locale is Arabic: ص for a page.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
  bibliography: { fontSize: em(0.9), lineHeight: pt(17), hangingIndent: em(2),
    entrySpacing: pt(2) },
};
const footnotes = {
  markerTemplate: '({n})', // «(١)», in the document's digits
  numbering: 'page', // from (١) again on every page, as Arabic journals number them
  noteNumberPosition: 'inline', // the note opens with (١) on the line, not raised
  fontSize: pt(10), lineHeight: pt(18), spaceBetween: pt(2), // 1.8 ×: tanwīn clears the line
  textAlign: 'start', // ragged from the right: a Latin title would open wide gaps
  separator: { width: 0.3, lineWidth: pt(0.5), color: col('red') }, // on the start side
};
// The index sorts by the word after the article: الكشيدة files under ك, not under ا.
// ignoreArticle is already true for an Arabic index; it is written out to be seen.
const index = {
  ignoreArticle: true,
  fontFamily: TEXT, fontSize: pt(10.5), lineHeight: pt(16), indent: em(1.2),
  main: { bold: true }, // the page that defines the term
  groups: { fontFamily: LABEL, fontSize: pt(10), fontWeight: 700, color: col('red') },
};
// #endregion

// #region masthead: the journal's name, the article's title and its author, centred
const centred = (y, extra = {}) => ({ anchor: { to: 'container', edge: 'top' },
  offset: { y: mm(y) }, size: { width: 'fill' }, ...extra });
const line = (id, content, family, size, colour, y, extra = {}) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(colour), align: 'center',
  overflow: 'wrap', placement: centred(y), ...extra });
const masthead = { enabled: true, minHeight: mm(70), slot: { elements: [
  line('journal', JOURNAL, LABEL, 9, 'red', 0, { fontWeight: 700 }),
  line('issue', '{attr.issue}', LABEL, 8, 'muted', 6),
  { kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
    placement: centred(13) },
  line('title', '{titleText}', TEXT, 22, 'ink', 18, { fontWeight: 700, lineHeight: 1.45 }),
  line('author', '{attr.author}', TEXT, 13, 'ink', 45),
  line('affiliation', '{attr.affiliation}', TEXT, 10, 'muted', 52),
] } };
// #endregion

// #region heads: the journal on the right-hand page, the author and title on the left
const head = (id, content, parity, edge, x) => ({ kind: 'text', id, content, parity,
  pages: 'body', fontFamily: LABEL, fontSize: pt(7.5), color: col('muted'), align: edge,
  placement: { anchor: { to: 'page', edge: `top-${edge}` }, offset: { x: mm(x), y: mm(13) } } });
const folio = (id, parity, edge, x) => ({ ...head(id, '{pageNumber}', parity, edge, x),
  fontWeight: 700, color: col('red') });
const header = { elements: [
  folio('r-folio', 'even', 'right', -SIDE.outer),
  head('r-head', JOURNAL, 'even', 'right', -(SIDE.outer + 9)),
  head('l-head', 'سلمى الخطيب: أثر الكشيدة في سرعة القراءة', 'odd', 'left', SIDE.outer + 9),
  folio('l-folio', 'odd', 'left', SIDE.outer),
] };
// #endregion

const config = () => ({
  locale: 'ar', // written out, never LANG (gotcha: arabic-locale-tag)
  colorPalette, citations, footnotes, index,
  page: { width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
    backgroundColor: col('paper'), pageNumbering: { startAt: 87 },
    margins: { top: mm(24), bottom: mm(22), left: mm(SIDE.inner), right: mm(SIDE.outer),
      mirror: true } },
  layout: { layoutType: 'single' },
  bodyText: { fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
    boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
    textAlign: 'justify', firstLineIndent: em(1.5), indentAfterHeading: false,
    optimalLineBreaking: true, avoidWidows: true, avoidOrphans: true },
  headings: { fontFamily: LABEL, fontWeight: 700, color: col('ink'),
    // No space is added over the heads to fill a page, and no paragraph runs a line long:
    // what stays on is the level cut of a closing page, for the two columns of the index.
    balancing: { maxLinesPerHeading: 0, stretchAfterLists: false, stretchAfterFloats: false,
      looseParagraphs: false, closingBox: 'off' },
    levels: [
    // The article starts on the page it reaches, left or right, with no blank page before it.
    { level: 1, breakBefore: { enabled: true, parity: 'any' }, marginTop: pt(0),
      marginBottom: pt(0), advancedDesign: masthead },
    // ١- المقدمة: the section number in the document digits, a hyphen after it.
    { level: 2, fontSize: pt(12), lineHeight: pt(LEAD), numberingTemplate: '{2}-',
      numberSeparator: ' ', color: col('red'), marginTop: pt(LEAD), marginBottom: pt(4) },
  ] },
  headingStyles: [
    { id: 'unnumbered', numbered: false }, // the abstract, the references, the index
    // The index: a title across the page and two columns, the first on the right.
    { id: 'index', numbered: false, span: 'page', breakBefore: { enabled: true, parity: 'any' },
      advancedDesign: { enabled: false }, fontSize: pt(18), lineHeight: pt(30),
      marginBottom: pt(LEAD),
      layout: { layoutType: 'double', gutterWidth: mm(8) } },
  ],
  calloutStyles: [{ id: 'abstract', background: col('rose'),
    padding: { top: mm(3.5), right: mm(5), bottom: mm(3.5), left: mm(5) },
    marginTop: pt(0), marginBottom: pt(0),
    titleStyle: { fontFamily: LABEL, fontSize: pt(9), fontWeight: 700, color: col('red') },
    body: { fontSize: pt(10.5), lineHeight: pt(17), firstLineIndent: pt(0) } }],
  paragraphStyles: [{ id: 'colophon', fontFamily: TEXT, fontSize: pt(9), lineHeight: pt(13),
    color: col('muted'), textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) }],
  header, footer: { elements: [] },
});

// ─── 2 · Content ────────────────────────────────────────────────────────────
const markdown = String.raw`---
title: "أثر الكشيدة في سرعة قراءة النص العربي المطبوع"
---

# أثر الكشيدة في سرعة قراءة النص العربي المطبوع: تجربة على قرّاء جامعيين {issue="المجلد ١٤ · العدد ٣ · خريف ٢٠٢٦" author="سلمى الخطيب" affiliation="قسم علوم المعلومات والنشر، جامعة المثال"}

:::callout{type="abstract" title="ملخص"}
تبحث هذه الدراسة في أثر ضبط السطور بالكشيدة في سرعة قراءة النص العربي المطبوع وفي فهمه. قرأ ستون طالبًا جامعيًا نصوصًا مضبوطة بثلاث طرق: بالمسافات وحدها، وبالكشيدة وحدها، وبمزيج منهما. ولم تختلف سرعة القراءة اختلافًا ذا دلالة بين الطرق الثلاث، غير أن القرّاء فضّلوا الطريقة المختلطة، وكانت أخطاء الفهم في الكشيدة الكثيفة أعلى قليلًا.
:::

## المقدمة

يملأ :index[الطابع]{term="الطباعة العربية"} العربي السطر حتى نهايته بإحدى وسيلتين: أن يوسّع المسافات بين الكلمات، أو أن يمدّ بعض الحروف المتصلة بما يسمّى :index[الكشيدة]{main}:index{term="الكشيدة" seealso="المسافات بين الكلمات"} أو :index[التطويل]{see="الكشيدة"}. والوسيلة الثانية قديمة قِدم الخط نفسه، عرفها :index[النسّاخ] قبل المطبعة، ثم نقلها صانعو :index[الحروف المعدنية] إلى صناديقهم في صورة قطع خاصة تُدسّ بين أجزاء الكلمة.[@nemeth2017] وحين انتقلت الطباعة العربية إلى الحاسوب، صار المدّ عملية آلية يقوم بها البرنامج، وصار السؤال عن مقداره ومواضعه سؤالًا تقنيًا قبل أن يكون جماليًا.[^raqim]

[^raqim]: تُبنى قواعد المواضع الجائزة للمدّ في البرامج الحديثة على ما وصفه الخطاطون في خط :index[النسخ]، ولا سيما المنع بعد الكاف واللام، وقبل الحروف المستديرة في آخر الكلمة.

ولا يكاد يُختلف في أن الكشيدة جزء من :index[جماليات الصفحة العربية]، لكن أثرها في القراءة لم يُدرس إلا قليلًا. فالدراسات القليلة المتاحة اعتمدت على تقدير القرّاء للنص، لا على قياس قراءتهم له،[@hashimi2019, ٧٧; @attar2021] والمعايير الدولية تكتفي بوصف المواضع التي يجوز فيها المدّ دون أن تحدد مقداره.[@alreq] ويحاول هذا البحث أن يقيس الأثر قياسًا مباشرًا.

## الكشيدة في الطباعة العربية

حين أُنشئت :index[مطبعة بولاق]{term="بولاق، مطبعة"} في عشرينيات القرن التاسع عشر، سُبكت حروفها على نماذج من الخط الذي يكتبه النسّاخ، وصار الكتاب المطبوع بعد ذلك بعقود سلعة يقرؤها جمهور واسع.[@ayalon2016] وكان صفّاف الحروف يضبط السطر بقطع من المدّ يدسّها بين أجزاء الكلمة، إلى أن ظهرت آلات :index[الصف الآلي] في القرن العشرين فقلّصت عدد أشكال الحروف تقليصًا كبيرًا.[@nemeth2017]

وقد عادت الكشيدة في :index[الصحف اليومية] بعد انتشار :index[الصف الرقمي]، لأنها تسمح بضبط :index[الأعمدة الضيقة] دون أن تتسع المسافات اتساعًا ظاهرًا. غير أن بعض المصممين يرون أن الإكثار منها يجعل الصفحة مضطربة، وأن العين تتعثر بالكلمات الممدودة كما تتعثر بالفجوات الواسعة.[@attar2021, ٥٢]

## منهج التجربة

شارك في التجربة ستون طالبًا وطالبة من :index[جامعة المثال]، تتراوح أعمارهم بين ١٩ و٢٦ سنة، وكلهم يقرأ العربية لغةً أولى. وقرأ كل منهم تسعة نصوص قصيرة من المقالات الصحفية، طول كل منها نحو ٣٠٠ كلمة، على صفحات مطبوعة بخط :index[أميري]{term="أميري، خط"} بحجم ١٣ نقطة.[^font]

[^font]: اختير خط أميري لأنه يرسم الكشيدة منحنية، كما في الطباعة البولاقية، فيكون الفرق بين الطرق الثلاث أوضح مما هو في الخطوط التي ترسمها خطًا مستقيمًا.

وضُبطت النصوص بثلاث طرق: بالمسافات وحدها، وبالكشيدة وحدها مع مسافات ثابتة، وبمزيج يوسّع :index[المسافات بين الكلمات] بمقدار الربع أولًا ثم يمدّ الحروف. وقيس زمن القراءة بالثواني، ثم أجاب القارئ عن خمسة أسئلة في الفهم، وأخيرًا رتّب الطرق الثلاث بحسب تفضيله.:index{term="تفضيل القرّاء"}

## النتائج والمناقشة

لم تختلف :index[سرعة القراءة] اختلافًا ذا دلالة بين الطرق الثلاث: كان المتوسط ٢١٤ كلمة في الدقيقة للمسافات، و٢٠٩ للكشيدة، و٢١٧ للطريقة المختلطة. أما :index[أخطاء الفهم]{term="الفهم، أخطاء"} فكانت أعلى قليلًا في الكشيدة وحدها، ولا سيما في السطور التي مُدّت فيها ثلاث كلمات أو أكثر.

وفضّل ٣٨ مشاركًا الطريقة المختلطة، و١٤ المسافات وحدها، و٨ الكشيدة وحدها. وهذا يتفق مع ما يذهب إليه الطابعون من أن الكشيدة تحسن قليلًا ولا تحسن كثيرًا،[@hashimi2019, ٨١] ومع ما تقترحه الإرشادات الحديثة من توزيع الفراغ على المسافات والمدّ معًا.[@alreq]

ولهذه النتائج حدود واضحة: فالنصوص قصيرة، والقرّاء من فئة عمرية واحدة، والخط واحد. ويحتاج الأمر إلى تجارب على :index[خطوط أخرى]{term="الخطوط الطباعية"}، وعلى :index[القراءة على الشاشة]، حيث يتغير عرض السطر بتغير الجهاز.

## المراجع {style="unnumbered"}

:::bibliography{title=""}

:::paragraphs{style="colophon" dir=ltr}
A specimen article written in Arabic for the Postext Cookbook. The journal, its author, her experiment and the Arabic works by al-Hashimi and al-Attar are invented; the books by Ayalon and Nemeth and the W3C document are real.
:::

# فهرس الأعلام والموضوعات {style="index"}

:::index

:::references{format=csl-yaml}
- id: nemeth2017
  type: book
  language: en
  author: [{family: Nemeth, given: Titus}]
  title: "Arabic type-making in the machine age: the influence of technology on the form of Arabic type, 1908–1993"
  publisher: Brill
  publisher-place: Leiden
  issued: 2017
- id: ayalon2016
  type: book
  language: en
  author: [{family: Ayalon, given: Ami}]
  title: "The Arabic print revolution: cultural production and mass readership"
  publisher: Cambridge University Press
  publisher-place: Cambridge
  issued: 2016
- id: alreq
  type: webpage
  language: en
  author: [{literal: W3C}]
  title: "Arabic & Persian layout requirements"
  URL: https://www.w3.org/TR/alreq/
- id: hashimi2019
  type: book
  language: ar
  author: [{literal: منى الهاشمي}]
  title: "الحرف العربي على الشاشة: دراسة في المقروئية"
  publisher: دار المثال
  publisher-place: بيروت
  issued: {literal: "٢٠١٩"}
- id: attar2021
  type: article-journal
  language: ar
  author: [{literal: كريم العطار}]
  title: "التطويل في الصحف اليومية العربية"
  container-title: مجلة دراسات الكتاب والنشر
  volume: "٩"
  issue: "٢"
  page: "٤٥-٦٨"
  issued: {literal: "٢٠٢١"}
:::
`; // content.<lang>.md: the same Arabic article in both

// ─── 3 · Fonts ──────────────────────────────────────────────────────────────
const FONTS = { // every face the pages use, loaded before the build
  Amiri: ['400', '700'], // TEXT: the article, notes, references, index; bold emphasis
  'Noto Kufi Arabic': ['400', '700'], // LABEL: masthead, section heads, running heads
};

// ─── 4 · Build & show ───────────────────────────────────────────────────────
await loadFonts(FONTS, markdown);
// Each Arabic face's letters live in a file of their own (gotcha: arabic-fonts-subset).
await loadArabicFonts(FONTS, markdown);
const doc = await withLoadedFonts(() => buildDocument({ markdown }, config()),
  { ...kitFonts(FONTS), text: markdown });
showBook(doc, { title: t({ en: 'An Arabic research article',
  es: 'Un artículo académico árabe' }) });
offerPdf(() => renderToPdf(doc, { fontProvider: arabicPdfProvider }), `${RECIPE}.pdf`);

// ─── Kit ── helpers shared by every Cookbook recipe · postext.dev/cookbook ─────

// ─── Kit · core v1 ── the same in every recipe · postext.dev/cookbook
function mm(value) { return { value, unit: 'mm' }; }
function pt(value) { return { value, unit: 'pt' }; }
function em(value) { return { value, unit: 'em' }; }
/** The sample language's string: t({ en: 'Figure', es: 'Figura' }). */
function t(strings) { return strings[LANG] ?? Object.values(strings)[0]; }
/** A file in this recipe's assets folder, served from the Postext repo by jsDelivr. */
function asset(file) { return `https://cdn.jsdelivr.net/gh/drnachio/postext@main/cookbook/${RECIPE}/assets/${file}`; }

// ─── Kit · fonts v3 ── the same in every recipe · postext.dev/cookbook
// Postext loads the faces a config asks for before layout (prepareFonts,
// buildDocumentWithFonts) and asks the kit for the files: Fontsource's, the
// files the PDF embeds too.

/** The options of buildDocumentWithFonts / prepareFonts / withLoadedFonts:
 *  the Fontsource resolver, and the faces of FONTS loaded with the ones the
 *  config names. FONTS = { 'Family Name': ['400', '400i', '700'] }. */
function kitFonts(FONTS = {}) {
  const faces = Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) =>
    ({ family, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' })));
  return { resolve: fontsourceResolver, faces };
}

/** A face's Fontsource files, in a fixed order: latin, then latin-ext and greek
 *  when `text` needs them and the family ships them (kitSubsetsFor), each with
 *  its unicode-range. Null for a weight or slant Fontsource does not ship. */
async function fontsourceResolver(family, weight, style, { text = '' } = {}) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  if (meta && !(meta.weights.includes(weight) && meta.styles.includes(style))) return null;
  kitStatus('Loading fonts…');
  const at = await fontsourceAt(id);
  return ['latin', ...kitSubsetsFor(text, meta)].map((subset) => ({
    source: `${at}files/${id}-${subset}-${weight}-${style}.woff2`,
    unicodeRange: kitRanges()[subset],
  }));
}

/** The unicode-range of each Fontsource file the kit loads (a function: the
 *  kit is inlined after the pen's code, which runs before a const would be set). */
function kitRanges() {
  return {
    latin: 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,'
      + 'U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
    'latin-ext': 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,'
      + 'U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF',
    greek: 'U+0370-03FF',
  };
}

/** For the cjk, arabic and comics blocks, which add their own files: the
 *  faces of `faces` = { 'Family Name': ['400', '400i', '700'] }. `text` is the sample:
 *  č ł † α χ also load latin-ext and greek files (kitSubsetsFor). With
 *  `optional`, a face Fontsource does not ship is skipped instead of failing.
 *  The files are added once all have loaded, in the order asked (latin, then
 *  latin-ext, then greek), whatever order they arrive in: the last one added
 *  wins a character two files hold. Resolves to the number of faces added. */
async function loadFonts(faces, text = '', { optional = false } = {}) {
  kitStatus('Loading fonts…');
  const ranges = kitRanges();
  const jobs = [];
  for (const [family, specs] of Object.entries(faces)) {
    const id = fontsourceId(family);
    const todo = [...new Set(specs)].map((spec) => [parseInt(spec, 10), spec.endsWith('i') ? 'italic' : 'normal'])
      .filter(([weight, style]) => !hasFace(family, weight, style)); // before any await
    const at = fontsourceAt(id);
    const meta = optional || /[^\0-ÿ]/u.test(text) ? await fontsourceMeta(family) : null;
    const subsets = ['latin', ...kitSubsetsFor(text, meta)];
    for (const [weight, style] of todo) {
      if (optional && !(meta?.weights.includes(weight) && meta.styles.includes(style))) continue;
      for (const subset of subsets) {
        const url = `${await at}files/${id}-${subset}-${weight}-${style}.woff2`;
        const face = new FontFace(family, `url(${url}) format('woff2')`,
          { weight: String(weight), style, unicodeRange: ranges[subset] });
        jobs.push(face.load().catch(() => {
          if (subset === 'latin' && !optional) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        }));
      }
    }
  }
  const ready = await Promise.all(jobs).catch((error) => { kitFail(error); throw error; });
  return ready.filter((face) => face && document.fonts.add(face)).length;
}

/** A loaded FontFace covers this family, weight and style (fonts.check() would
 *  also say yes for families nobody declared). */
function hasFace(family, weight, style) {
  for (const face of document.fonts) {
    if (face.status !== 'loaded' || face.style !== style) continue;
    if (face.family.replace(/^["']|["']$/g, '') !== family) continue;
    const [low, high = low] = face.weight.split(' ').map(Number);
    if (weight >= low && weight <= high) return true;
  }
  return false;
}

/** The files beyond latin `text` needs that `meta`'s family ships. */
function kitSubsetsFor(text, meta) {
  return [[/[Ā-˿ᴀ-ᶿḀ-ỿ†ℓⱠ-Ɀ꜠-ꟿ]/u, 'latin-ext'], [/[Ͱ-Ͽ]/u, 'greek']]
    .filter(([re, x]) => re.test(text) && meta?.subsets?.includes(x)).map(([, x]) => x);
}

/** Fontsource's id for a family: 'Source Serif 4' → 'source-serif-4'. */
function fontsourceId(family) { return family.toLowerCase().replace(/\s+/g, '-'); }

/** A package's folder at the one version @5 names now (#766). */
function fontsourceAt(id, u = `https://cdn.jsdelivr.net/npm/@fontsource/${id}@`) {
  return (fontsourceAt.c ??= {})[id] ??= fetch(u + '5/package.json').then((r) => r.json())
    .then((p) => p.version || 5, () => 5).then((v) => `${u}${v}/`);
}

/** The family's Fontsource metadata (weights, styles, subsets), or null. */
function fontsourceMeta(family) {
  fontsourceMeta.cache ??= new Map();
  const id = fontsourceId(family);
  if (!fontsourceMeta.cache.has(id)) {
    fontsourceMeta.cache.set(id, fetch(`https://api.fontsource.org/v1/fonts/${id}`)
      .then((res) => (res.ok ? res.json() : null), () => null));
  }
  return fontsourceMeta.cache.get(id);
}

// ─── Kit · viewer v2 ── the same in every recipe · postext.dev/cookbook
/** The pages as spreads on a dark desk, page 1 alone, then verso | recto,
 *  each painted when it scrolls near. Other options go to renderPageToCanvas. */
function showPages(docs, { title, width = 460, ...render } = {}) {
  const root = viewer(title);
  const pages = [docs].flat().flatMap((doc) =>
    doc.pages.map((page) => ({ doc, page, n: (doc.pageIndexOffset ?? 0) + page.index })));
  const spreads = [];
  let verso = null;
  for (const p of pages) {
    if (p.n % 2 === 1) { if (verso) spreads.push([verso, null]); verso = p; }
    else { spreads.push([verso, p]); verso = null; }
  }
  if (verso) spreads.push([verso, null]);
  const density = Math.min(window.devicePixelRatio || 1, 2);
  showPages.painter?.disconnect();
  const painter = new IntersectionObserver((entries) => {
    for (const { isIntersecting, target } of entries) {
      if (!isIntersecting) continue;
      painter.unobserve(target);
      const { doc, page } = target.postext;
      renderPageToCanvas(page, doc, target, { ...render, scale: (width * density) / page.width });
    }
  }, { rootMargin: '800px' });
  showPages.painter = painter;
  root.replaceChildren(...spreads.map((pair) => {
    const spread = document.createElement('div');
    spread.className = 'pt-spread';
    for (const p of pair) {
      const figure = document.createElement('figure');
      if (p) {
        const label = p.page.pageLabel || String(p.n + 1);
        const canvas = document.createElement('canvas');
        canvas.postext = p;
        canvas.style.aspectRatio = `${p.page.width} / ${p.page.height}`;
        canvas.setAttribute('role', 'img');
        canvas.setAttribute('aria-label', `Page ${label}`);
        const folio = document.createElement('figcaption');
        folio.textContent = label;
        figure.append(canvas, folio);
        painter.observe(canvas);
      } else figure.className = 'pt-blank';
      spread.append(figure);
    }
    return spread;
  }));
  kitStatus(`${pages.length} ${pages.length === 1 ? 'page' : 'pages'}`);
  document.documentElement.dataset.postext = 'ready';
  return pages.length;
}

/** The desk, the bar and the error reporting, created once. */
function viewer(title) {
  if (!document.getElementById('pt-kit')) {
    document.head.insertAdjacentHTML('beforeend', `<style id="pt-kit">
      :root { color-scheme: dark; }
      body { margin: 0; background: #0e1014; color: #b9bcc4; font: 13px/1.45 system-ui, sans-serif; }
      #pt-bar { position: sticky; top: 0; z-index: 1; display: flex; flex-wrap: wrap; align-items: center;
        gap: 6px 16px; padding: 10px 16px; background: rgb(14 16 20 / .92); backdrop-filter: blur(6px);
        border-bottom: 1px solid #23262d; }
      #pt-bar strong { color: #f4f1ea; font-weight: 600; }
      #pt-actions { display: flex; gap: 12px; margin-left: auto; }
      #pt-actions a, #pt-actions button { color: #d8a21a; font: inherit; background: none; border: 0; padding: 0; cursor: pointer; }
      #pages { display: grid; justify-items: center; gap: 48px; padding: 32px 16px 72px; }
      .pt-spread { display: flex; }
      .pt-spread figure { margin: 0; width: min(460px, 44vw); }
      .pt-spread canvas { display: block; width: 100%; background: #fff;
        box-shadow: 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figure:first-child canvas { box-shadow: inset -14px 0 14px -14px rgb(0 0 0 / .18), 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figcaption { margin-top: 10px; text-align: center; font: 600 10px/1 system-ui, sans-serif;
        letter-spacing: .18em; text-transform: uppercase; color: #6c7079; }
      .pt-blank { visibility: hidden; }
      @media (max-width: 760px) {
        .pt-spread { flex-direction: column; gap: 32px; }
        .pt-spread figure { width: min(460px, 92vw); }
        .pt-blank { display: none; }
      }
    </style>`);
    document.body.insertAdjacentHTML('afterbegin',
      '<header id="pt-bar"><strong id="pt-title"></strong><span id="pt-status" role="status"></span><span id="pt-actions"></span></header>');
    document.getElementById('pt-title').textContent = document.title || 'Postext';
    addEventListener('error', (event) => kitFail(event.error ?? event.message));
    addEventListener('unhandledrejection', (event) => kitFail(event.reason));
  }
  if (title) document.getElementById('pt-title').textContent = title;
  return document.getElementById('pages')
    ?? document.body.appendChild(Object.assign(document.createElement('main'), { id: 'pages' }));
}

function kitStatus(text) {
  viewer();
  document.getElementById('pt-status').textContent = text;
}

function kitFail(error) {
  document.documentElement.dataset.postext = 'error';
  kitStatus(`Error: ${error?.message ?? error}`);
}

// ─── Kit · pdf v3 ── the same in every recipe that exports a PDF
/** The Fontsource files the screen used, as TrueType, with their range and
 *  place: the nearest weight the family ships, upright with no italic;
 *  latin, then what its letters need (kitSubsetsFor). */
async function fontsourceProvider(family, weight, style, request) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  const weights = meta?.weights?.length ? meta.weights : [400, 700];
  const w = weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a));
  const s = style === 'italic' && meta && !meta.styles.includes('italic') ? 'normal' : style;
  const text = String.fromCodePoint(...(request?.codePoints ?? []));
  const files = await Promise.all(['latin', ...kitSubsetsFor(text, meta)].map(async (subset, order) => {
    const res = await fetch(`${await fontsourceAt(id)}files/${id}-${subset}-${w}-${s}.woff2`);
    if (!res.ok) throw new Error(`Fontsource has no ${family} ${w} ${s} ${subset}`);
    return Object.assign(await decompressWoff2(new Uint8Array(await res.arrayBuffer())),
      { unicodeRange: kitRanges()[subset], order });
  }));
  return files.length === 1 ? files[0] : files;
}

/** A "Build the PDF" button; then "Open the PDF" (a new tab: CodePen's frame
 *  shows no PDFs) and a download link. */
function offerPdf(makePdf, filename) {
  viewer();
  const button = Object.assign(document.createElement('button'), { type: 'button', textContent: 'Build the PDF' });
  button.dataset.postextPdf = filename;
  button.addEventListener('click', async () => {
    button.disabled = true;
    button.textContent = 'Building the PDF…';
    try {
      const bytes = await makePdf();
      const url = URL.createObjectURL(new Blob([bytes], { type: 'application/pdf' }));
      const size = `${Math.max(1, Math.round(bytes.length / 1024))} KB`;
      button.replaceWith(
        Object.assign(document.createElement('a'), { href: url, target: '_blank', rel: 'noopener', textContent: 'Open the PDF ↗' }),
        Object.assign(document.createElement('a'), { href: url, download: filename, textContent: `Download ${filename} · ${size}` }));
    } catch (error) {
      button.disabled = false;
      button.textContent = 'Build the PDF';
      kitFail(error);
    }
  });
  document.getElementById('pt-actions').append(button);
}

// ─── Kit · arabic v2 ── Arabic-script faces · postext.dev/cookbook
// Fontsource ships an Arabic family as one file per subset and weight: the
// `arabic` file holds the letters, the harakat, the Arabic-Indic digits, the
// Arabic punctuation and the presentation forms; `latin` and `latin-ext`
// hold the rest. loadFonts loads the latin files; this block adds the arabic
// file of every Arabic family, for the canvas and for the PDF, which shapes
// the letters with HarfBuzz from the same bytes.

/** The code points of Fontsource's `arabic` subset, as its stylesheets
 *  declare them (the same unicode-range the browser picks the file by). A
 *  function, not a const: the kit is inlined after the recipe's top-level
 *  awaits, and a const read before its line throws, where a function
 *  declaration is hoisted. */
function arabicRange() {
  return 'U+0600-06FF,U+0750-077F,U+0870-088E,U+0890-0891,U+0897-08E1,U+08E3-08FF,'
    + 'U+200C-200E,U+2010-2011,U+204F,U+2E41,U+FB50-FDFF,U+FE70-FE74,U+FE76-FEFC,U+102E0-102FB,'
    + 'U+10E60-10E7E,U+10EC2-10EC4,U+10EFC-10EFF,U+1EE00-1EEFF';
}

/** Whether code point `cp` is in the arabic file. */
function inArabicRange(cp) {
  inArabicRange.ranges ??= arabicRange().split(',').map((part) => {
    const [lo, hi = lo] = part.slice(2).split('-');
    return [parseInt(lo, 16), parseInt(hi, 16)];
  });
  return inArabicRange.ranges.some(([lo, hi]) => cp >= lo && cp <= hi);
}

/** Whether Fontsource serves `family` with an `arabic` subset. Fails when
 *  the API does not answer: an Arabic face taken for a Latin one would set
 *  its letters in a system face. */
async function isArabicFamily(family) {
  const meta = await fontsourceMeta(family);
  if (!meta) throw new Error(`api.fontsource.org did not describe ${family}: reload to try again`);
  return !!meta.subsets?.includes('arabic');
}

/** The arabic file of a face. */
async function arabicFileUrl(family, weight, style) {
  const id = fontsourceId(family);
  return `${await fontsourceAt(id)}files/${id}-arabic-${weight}-${style}.woff2`;
}

/** faces = { Amiri: ['400', '700'] }, as for loadFonts, after it: the whole
 *  FONTS object may be passed, its families without an arabic subset are
 *  left alone. Adds the arabic file of every listed weight of each Arabic
 *  family (the latin files come from loadFonts) and loads it. `text` is
 *  the sample: fails when it holds an Arabic-script character the arabic
 *  file does not cover. List every weight the pages set in Arabic: a weight
 *  left to the engine's later round gets the latin file only, and its Arabic letters
 *  fall back to a system face. Resolves to the number of files loaded. */
async function loadArabicFonts(faces, text = '') {
  kitStatus('Loading fonts…');
  let loaded = 0;
  try {
    const outside = [...new Set(text)].filter((ch) => /\p{Script=Arabic}/u.test(ch) && !inArabicRange(ch.codePointAt(0)));
    if (outside.length) throw new Error(`Fontsource's arabic files have no ${outside.slice(0, 12).join(' ')}`);
    for (const [family, specs] of Object.entries(faces)) {
      if (!(await isArabicFamily(family))) continue;
      for (const spec of new Set(specs)) {
        const weight = parseInt(spec, 10);
        const style = spec.endsWith('i') ? 'italic' : 'normal';
        const face = new FontFace(family, `url(${await arabicFileUrl(family, weight, style)}) format('woff2')`,
          { weight: String(weight), style, unicodeRange: arabicRange() });
        document.fonts.add(await face.load().catch(() => {
          throw new Error(`Fontsource has no arabic file for ${family} ${weight} ${style}`);
        }));
        loaded++;
      }
    }
  } catch (error) {
    kitFail(error);
    throw error;
  }
  return loaded;
}

/** The PDF font provider for recipes with Arabic faces: a family with an
 *  arabic subset gets its arabic file when its pages set Arabic letters
 *  (`request.codePoints`), then its latin file, and its latin-ext file for
 *  the letters beyond latin (transliteration: ā ḥ ʿ), each marked with its
 *  unicode-range and its place in the order the screen added them (latin
 *  and latin-ext by loadFonts, then arabic): the arabic file also has a
 *  space and brackets, which the browser takes from latin, the file whose
 *  range holds them, and postext-pdf follows it. Any other family goes to
 *  fontsourceProvider (the "pdf" block). */
async function arabicPdfProvider(family, weight, style, request) {
  if (!(await isArabicFamily(family))) return fontsourceProvider(family, weight, style, request);
  const meta = await fontsourceMeta(family);
  const weights = meta.weights?.length ? meta.weights : [400, 700];
  const w = weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a));
  const s = style === 'italic' && !meta.styles.includes('italic') ? 'normal' : style;
  const wanted = [...(request?.codePoints ?? [])];
  const id = fontsourceId(family);
  const subsets = !wanted.length || wanted.some(inArabicRange) ? ['arabic', 'latin'] : ['latin'];
  if (meta.subsets.includes('latin-ext') && wanted.some((cp) => /[Ā-˿Ḁ-ỿ]/u.test(String.fromCodePoint(cp)))) {
    subsets.push('latin-ext');
  }
  const at = await fontsourceAt(id);
  return Promise.all(subsets.map(async (subset) => {
    const url = `${at}files/${id}-${subset}-${w}-${s}.woff2`;
    const res = await fetch(url);
    if (!res.ok) throw new Error(`Fontsource file ${url} (${res.status})`);
    const bytes = await decompressWoff2(new Uint8Array(await res.arrayBuffer()));
    return Object.assign(bytes, { unicodeRange: subset === 'arabic' ? arabicRange() : kitRanges()[subset],
      order: ['latin', 'latin-ext', 'greek', 'arabic'].indexOf(subset) });
  }));
}

// ─── Kit · book v1 ── books bound on either edge · postext.dev/cookbook
// A book bound on the right (Arabic, Hebrew or Persian text, vertical
// Chinese, or page.binding 'right') opens from what a Latin reader calls
// the back: page 1 lies alone on the left of the spine, then [3 | 2].

/** showPages for a book bound on either edge. A right-bound book (the
 *  document says so: doc.binding is 'right' for page.binding 'right', for
 *  text that runs right to left and for vertical text, when the binding is
 *  left to 'auto') lies on the desk as it opens: page 1 alone on the left
 *  of the spine, then [3 | 2], the spine shade on each page's inner edge.
 *  `binding` ('left' | 'right') overrides the document's. */
function showBook(docs, { binding, ...options } = {}) {
  const count = showPages(docs, options);
  const right = (binding ?? [docs].flat()[0]?.binding) === 'right';
  if (!document.getElementById('pt-kit-book')) {
    // The pages keep direction ltr, as in a left-bound book: a canvas takes
    // the direction its element inherits, and under the spread's rtl a run
    // painted for an ltr canvas would end where the engine starts it.
    document.head.insertAdjacentHTML('beforeend', `<style id="pt-kit-book">
      .pt-spread[dir="rtl"] canvas { direction: ltr; }
      .pt-spread[dir="rtl"] figure:first-child canvas { box-shadow: inset 14px 0 14px -14px rgb(0 0 0 / .18),
        0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
    </style>`);
  }
  // Each pair stays [verso, recto] in the page; right to left, the verso
  // sits on the right. Phones stack the pages in reading order either way.
  for (const spread of document.querySelectorAll('#pages > .pt-spread')) spread.dir = right ? 'rtl' : 'ltr';
  document.getElementById('pages').dataset.binding = right ? 'right' : 'left';
  return count;
}

// ─── /Kit ───────────────────────────────────────────────────────────────────────
```

## Varianten

### Fußnoten durch den ganzen Artikel zählen

Moderne arabische Zeitschriften zählen die Fußnoten oft pro Artikel statt pro Seite.

```diff
-  numbering: 'page', // from (١) again on every page, as Arabic journals number them
+  numbering: 'chapter',
```

### Nach Autor und Jahr zitieren

```diff
-  style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
+  style: 'apa', locale: 'ar',
```

## Häufige Fehler

- **Zeichnen Sie ein arabisches Buch mit 'ar' aus, nicht mit LANG.** Die Ausgaben eines Rezepts sind en und es, ein arabisches Beispiel ist aber in beiden Arabisch: `locale: LANG` würde es von links nach rechts setzen, links binden, seine Seiten 1 2 3 nummerieren und seine Abbildungen mit Figure oder Figura beschriften. Seit postext 1.30 ist die Auszeichnung auch die Sprache, in der der Text geformt wird (gemessen, gezeichnet und eingebettet). Unter einer englischen oder spanischen Auszeichnung zeichnet eine Schrift wie Markazi Text daher die arabischen Formen ihrer Guillemets und Satzzeichen nicht, und die Zeilen brechen an anderer Stelle um. Schreiben Sie die Auszeichnung selbst: 'ar' (arabisch-indische Ziffern, die Maschrek-Konvention), eine Region wie 'ar-EG' oder 'ar-SA', oder 'ar-MA', 'ar-DZ' bzw. 'ar-TN' für eine Maghreb-Ausgabe mit europäischen Ziffern. Eine lateinische Seite, die Arabisch nur zitiert, behält ihr eigenes Gebietsschema.
- **Arabische Schnitte brauchen ihre arabic-Datei, über den Block arabic.** Fontsource liefert Amiri, Noto Naskh Arabic oder Scheherazade New als eine Datei pro Teilmenge aus, und die arabischen Buchstaben stehen in der Datei arabic. loadFonts holt nur latin (und latin-ext), am Bildschirm stammt das Arabische also aus einer Systemschrift und wird falsch gemessen, und fontsourceProvider gibt dem PDF diese latin-Datei, die leere Kästchen druckt. Führen Sie den Kit-Block arabic auf, rufen Sie loadArabicFonts(FONTS, markdown) nach loadFonts auf, mit jeder Schriftstärke, die die Seiten auf Arabisch setzen, in FONTS aufgeführt, und geben Sie renderToPdf fontProvider: arabicPdfProvider.
- **Ein Überschriftenformat erbt den Seitenumbruch seiner Ebene.** Ein Eintrag in headingStyles übernimmt jedes Feld, das er auslässt, von seiner Überschriftenebene, breakBefore eingeschlossen. Ein Inhaltsverzeichnis oder Impressum, das nach einem :::pagebreak über eine H1 gestaltet wird, erbt die Parität 'odd' und landet hinter einer Vakatseite. Geben Sie einem solchen Format breakBefore: { enabled: false }.

- Die Interpunktion, die ein CSL-Stil schreibt, gehört dem Stil: Kommas, Semikolons und Anführungszeichen zwischen den Teilen einer Fußnote sind lateinisch, wie in الهاشمي, الحرف العربي. Daten und Zahlen kommen aus den Daten, daher tragen die arabischen Werke `issued: {literal: "٢٠١٩"}` und Fundstellen wie `[@hashimi2019, ٧٧]`; die lateinischen Werke behalten 0–9.
- Eine Fußnote oder ein Verweis auf ein lateinisches Werk bleibt ein Absatz der arabischen Seite, von rechts gesetzt, und liest sich in seinem Inneren von links nach rechts: Die Engine setzt den Verweis als isolierten Abschnitt, sodass seine URL, seine Anführungszeichen und sein Schlusspunkt dort bleiben, wo er endet.

## Nachweise

- Rezept: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Text: A research article written in Arabic for the recipe; its journal, author, experiment and Arabic sources are invented: Postext Cookbook, Original
- Schrift: Amiri (OFL-1.1), Noto Kufi Arabic (OFL-1.1)
- Code: MIT · Beispielinhalt: CC-BY-4.0

## Verwandte Rezepte

- [Nº 089 · Ein historischer Essay mit Chicago-Noten](https://postext.dev/de/cookbook/history-essay-chicago-notes.md): Ein vierseitiger historischer Essay, dessen Zitate [@key, 87] zu Chicago-Noten am Seitenfuß werden: beim ersten Mal vollständig, danach kurz, mit Bibliografie. · Stufe 2 (Mittel) · Fachartikel und Wissenschaft
- [Nº 072 · Ein Lehrbuchregister, das dem Text folgt](https://postext.dev/de/cookbook/back-of-book-index.md): Begriffe, markiert, wo der Text sie behandelt, von :::index zweispaltig gedruckt mit den Seiten, die buildBundle findet, mit Bereichen und Verweisen. · Stufe 3 (Fortgeschritten) · Lehrbücher
- [Nº 109 · Arabischer Text für den Maghreb mit europäischen Ziffern](https://postext.dev/de/cookbook/maghreb-edition-european-digits.md): Ein arabisches Kapitel für Marokko: Die Locale „ar-MA“ hält den Text rechts nach links und rechts gebunden und schreibt jede erzeugte Zahl als 1, 2, 3. · Stufe 1 (Einfach) · Handbücher und Nachschlagewerke