Konfiguration: Text und Überschriften

#Fließtext

Die Eigenschaft bodyText steuert die Typografie aller Absätze.

#Zitate

Ein Zitat (Zeilen, die mit > beginnen) übernimmt Familie, Größe, Zeilenabstand, Schriftstärken, Ausrichtung und Silbentrennung des Fließtexts. bodyText.blockquote legt den Rest fest; ohne Wert sieht ein Zitat aus wie bis postext 1.4: grau, kursiv, mit dem Erstzeileneinzug des Fließtexts und ohne seitlichen Einzug.

bodyText: {
  firstLineIndent: { value: 1.5, unit: 'em' },
  // Upright verse in the body colour, set in by 2 em, no first-line indent.
  blockquote: { color: { hex: '#241f26', model: 'hex' }, italic: false, indent: { value: 2, unit: 'em' }, firstLineIndent: { value: 0, unit: 'em' } },
}

In der Sandbox ist das die Gruppe Blockzitate des Abschnitts „Grundtext“.

#Vers

Ein Gedicht :::verse, dessen Zeilen keinen Halbverstrenner tragen, wird Zeile für Zeile gesetzt (siehe Dokumentformat › :::verse). bodyText.verse liefert die Standardwerte solcher Gedichte; ein gleichnamiges Attribut am Direktivenblock eines Gedichts setzt den Wert für dieses Gedicht.

bodyText: {
  // Turnovers flush right behind a bracket; tankas kept whole.
  verse: { turnover: 'right', keepStanzas: 5 },
}

Eine vor diesen Einstellungen gespeicherte Konfiguration (configVersion 8 oder älter), die ein Gedicht ohne Trenner setzt, wird mit layout: 'bayt' gelesen, sodass das Gedicht die zentrierten Zeilen behält, die postext 1.22 ihm gab. Eine von postext 1.23 gespeicherte (configVersion 9), die ein Gedicht Zeile für Zeile setzt, wird mit tighten: false gelesen, sodass ihre Zeilen dort umbrechen, wo 1.23 sie umbrach.

In der Sandbox ist das die Gruppe Verse des Abschnitts „Grundtext“.

#Tabulatoren

bodyText.tabStops listet die Tabstopps auf, zu denen ein Tabulator springt: :tab oder ein Tabulatorzeichen in einem Absatz mit Tabstopps (siehe Dokumentformat › Tabulatoren und Tabstopps für die Auszeichnung und dafür, wie eine Zeile gesetzt wird). Die tabStops eines Absatzformats ersetzen sie für dessen Absätze und body.tabStops eines Kastenformats in dessen Kästen; eine leere Liste setzt keine. Jeder Tabstopp ist ein TabStop:

bodyText: {
  tabStops: [
    { position: { value: 30, unit: 'mm' } },
    { position: 'end', align: 'end', leader: '.', leaderGap: { value: 2, unit: 'pt' } },
  ],
  tabInterval: { value: 10, unit: 'mm' },
}

tabInterval fügt jenseits des letzten Tabstopps der Liste Tabstopps in diesem Abstand vom Anfang der Satzbreite hinzu; ohne die Option ist ein Tabulator nach dem letzten Tabstopp ein Wortzwischenraum. Ein im Text getipptes Tabulatorzeichen ist nur in einem Absatz ein Tabulator, dessen Format Tabstopps oder einen Abstand hat, eigene oder die des Fließtexts; überall sonst bleibt es der Wortzwischenraum, der es immer war, sodass ein gespeichertes Dokument wie bisher gesetzt wird und keine Fixierung braucht.

Die Tabstopps werden mit dem Rest der Konfiguration geprüft (siehe Konfigurationswarnungen): Ein unbekannter Schlüssel in einem Tabstopp (leaders) wird als unknownConfigKey mit dem nächstliegenden Schlüssel gemeldet; ein align, das keiner der vier Werte ist, als unknownConfigValue, und der Tabstopp wird als 'start' gesetzt; eine position, die weder Länge noch 'end' noch Prozentwert ist, als unknownConfigValue mit used: 'none', und der Tabstopp entfällt.

Farbe und Schrift der Füllzeichen sind die des Absatzes; eine eigene Einstellung dafür gibt es noch nicht.

#Initialen

Ein Absatz des Fließtexts kann mit einer Initiale beginnen: Sein erster Buchstabe wird groß neben seine ersten Zeilen gesetzt, die um die Breite des Buchstabens und einen Abstand verkürzt und wie alle anderen Zeilen gesetzt werden (nach Knuth-Plass umbrochen, im Blocksatz, mit Silbentrennung). Ein Absatzformat gibt dem ersten Absatz jeder Gruppe :::paragraphs des Formats eine (mit each: true jedem Absatz, etwa für einen Katalog von Einträgen); eine Überschriftenebene oder ein Überschriftenformat gibt dem ersten Absatz des Fließtexts nach der Überschrift eine (siehe das Feld dropCap unter Überschreibungen pro Ebene, Absatzformate und Überschriftenstile). Der Absatz nach der Überschrift wird über Direktivenblöcke von Containern, Direktiven, Kästen, die den Textfluss verlassen haben, und gleitende Abbildungen hinweg gefunden, so wie indentAfterHeading ihn findet; ein Absatz in einem Kasten, einem Listenpunkt, einem Zitat, einem Gedicht oder einer Anmerkung erhält nie eine. Im Text schalten {dropcap}, {dropcap=false} und {dropcap=N} auf einer Überschriftenzeile oder einem Direktivenblock :::paragraphs sie für dieses Kapitel oder diese Gruppe ein oder aus oder setzen ihre Zeilenzahl (siehe Dokumentformat › Initialen). Seit postext 1.23.

headings: {
  levels: [
    { level: 1, dropCap: { lines: 3, fontFamily: 'Libre Bodoni', fontWeight: 700, color: { hex: '#8b2e2a', model: 'hex', paletteId: 'accent' }, leadIn: { words: 3 } } },
  ],
},

Wie der Buchstabe gesetzt wird:

• Größe. Beide Versalhöhen, die des Texts und die der Initiale, werden an ihren Schriften gemessen (an der Farbe eines H; im chinesischen oder japanischen Text an der Initiale selbst), und eine Schrift ohne Angaben zur Farbe zählt ihre Versalien als 0,72 ihrer Größe. Die Standardgröße passt zu jedem Schriftpaar, eine Korrektur pro Schrift ist also nicht nötig. Das dropCap eines Gestaltungstexts behält seine festen 0,72 (siehe Textelemente).
• Der Buchstabe und sein Wort. Die Initiale nimmt ganze Graphem-Cluster. Der Rest des ersten Worts folgt ohne Zwischenraum; ein Wort aus einem Buchstaben (A, Y) behält seinen Wortzwischenraum am Anfang der ersten Zeile. Der eigene Erstzeileneinzug des Absatzes entfällt. Kopieren, Suche, die Source-Map und die Einfügemarke der Sandbox lesen den Absatz wie geschrieben: Der reine Text des Blocks enthält den Buchstaben, plainStart der ersten Zeile zählt über ihn hinaus, und VDTBlock.dropCap hält seinen Bereich und seine Geometrie auf dem Fragment mit der ersten Zeile.
• Eine erhabene Initiale (lines: 1 mit einer größeren fontSize oder sink unter lines) ragt über die erste Zeile hinaus, und der Absatz hält über sich diesen Überstand in ganzen Rasterzeilen frei, sodass sie den Text darüber nicht überdruckt.
• Umbruch. Der Absatz bricht nie vor der Zeile sink um: Er rückt stattdessen ganz in die nächste Spalte oder auf die nächste Seite, es sei denn, er steht allein in einer leeren Spalte, die diese Zeilen nicht fassen kann; dann bricht er trotzdem um und löst eine Warnung dropCap aus. Eine Überschrift, die mit ihrem Text zusammengehalten wird, behält diese Zeilen unter sich. Der Teil, der in der nächsten Spalte weitergeht, trägt keine Initiale und hat Zeilen in voller Breite; wird er für eine Spalte anderer Breite erneut umbrochen, behalten die ersten Zeilen ihren Einzug. Der Spaltenausgleich darf den Absatz wie jeden anderen lockerer oder enger setzen und fügt nie Abstand zwischen den verkürzten Zeilen ein.
• Schriftsysteme. Die Zeilen werden auf der Anfangsseite verkürzt: links in lateinischem Text, rechts im Arabischen und Hebräischen. Ein Buchstabe, der mit dem nächsten verbunden wird (Arabisch, Syrisch, N’Ko), wird nicht abgesetzt, und der Absatz löst eine Warnung dropCap aus; horizontales Chinesisch und Japanisch nehmen eine Initiale aus einem Zeichen (首字下沉). Vertikaler Text nimmt keine (Warnung). Ein Absatz, der ohne Buchstaben oder Ziffer beginnt (ein Verweis, eine Formel, ein Anmerkungszeichen), nimmt ebenfalls keine (Warnung).
• Ausgaben. Canvas, HTML-Betrachter und EPUB mit festem Layout malen die Initiale neben die Zeilen; das HTML schreibt sie unmittelbar vor den Text der ersten Zeile, ohne etwas dazwischen, sodass ein Screenreader das Wort ganz liest. In einem getaggten PDF ist die Initiale Teil des P des Absatzes und bildet mit dem Rest ihres Worts einen Span, dessen /ActualText das Wort ist: Die Textextraktion liest Long before, nie L ong before. Ein umfließendes EPUB setzt sie als CSS-initial-letter (lines, sink), gleitend, wo das Lesesystem das nicht unterstützt.

Die Einstellungen werden mit dem Rest der Konfiguration geprüft (siehe Konfigurationswarnungen): Ein unbekannter Schlüssel in einer Initiale oder ihrem Auftakt wird als unknownConfigKey gemeldet, eine punctuation oder ein shortParagraph, das keines seiner Wörter ist, oder ein lines, sink oder characters, das keine ganze Zahl ab 1 ist, als unknownConfigValue, und der Standardwert wird verwendet. Initialen sind standardmäßig aus, daher ändert sich kein gespeichertes Dokument.

#Eine Familie pro fontFamily

fontFamily – hier und in jedem anderen Feld für Schriftfamilien (headings.fontFamily, tableStyle.bodyFontFamily, separatorFontFamily, fontFamily eines Chip-Formats oder eines Gestaltungselements …) – nennt eine Familie. Canvas, HTML-Ausgabe und PDF müssen dieselbe Schrift setzen, und das PDF bettet eine Schrift pro Familie ohne Ersatzkette ein, sodass ein CSS-Font-Stack nichts hätte, worauf er zurückfallen könnte. Ein Stack wird in seiner ersten Familie gesetzt und als Konfigurationswarnung gemeldet:

bodyText: { fontFamily: "'EB Garamond', Georgia, serif" } // set in EB Garamond

Laden Sie diese Familie vor dem Setzen (siehe Eigene Schriften und den Schrift-Provider unter PDFs erzeugen); fehlt sie, misst der Browser mit seiner Standardschrift, gleich was der Rest des Stacks sagt. Ein Komma in Anführungszeichen ist Teil eines Namens ('"Foo, Bar"' ist eine Familie).

#Silbentrennung

Ist die Textausrichtung auf 'justify' gesetzt, verhindert die Silbentrennung übermäßige Wortabstände, indem sie lange Wörter an Silbengrenzen trennt. Die Engine findet natürliche Trennstellen an Silbengrenzen mit Mustern nach TeX/Liang. Eine ausführliche Erklärung finden Sie unter Silbentrennung und Blocksatz. Flattersatz wird nur getrennt, wenn Sie es verlangen: siehe Flattersatz weiter unten.

Unterstützte Sprachen: 'en-us' (Englisch), 'es' (Spanisch), 'fr' (Französisch), 'de' (Deutsch), 'it' (Italienisch), 'pt' (Portugiesisch), 'ca' (Katalanisch), 'nl' (Niederländisch).

Region-, Schrift- und Varianten-Subtags werden bei der Wahl der Muster ignoriert, ebenso Groß- und Kleinschreibung und Trenner _: 'es-ES', 'es-MX' und 'es_419' trennen mit 'es', 'pt-BR' mit 'pt' und jedes englische Tag ('en', 'en-GB') mit 'en-us' – den einzigen mitgelieferten englischen Mustern, britischer Text erhält also amerikanische Trennungen. Eine Sprache ohne mitgelieferte Muster ('sv', 'pl', 'fi' …) wird mit den Mustern von 'en-us' getrennt, was falsche Trennungen statt gar keiner ergibt; die Engine meldet das einmal pro Tag mit einem console.warn, und die Sandbox führt es in ihrem Bedienfeld „Prüfungen“ auf. Setzen Sie für ein solches Dokument enabled: false; das bringt auch die Warnung zum Schweigen. Chinesisch, Japanisch und Koreanisch (zh, ja, ko, gleich mit welcher Region oder Schrift) brauchen keine Muster und geben keine Warnung aus: Ein Dokument in einer dieser Sprachen wird ohne Silbentrennung gesetzt. Um die darin zitierten lateinischen Wörter zu trennen, setzen Sie enabled: true und nennen deren Sprache in locale ('en-us' für Englisch). enabled: true ohne locale oder mit einer chinesischen, japanischen oder koreanischen lässt die Silbentrennung aus und meldet das einmal auf der Konsole. matchHyphenationLocale(tag) gibt die mitgelieferte Sprache zurück, der ein Tag zugeordnet wird (undefined, wenn es keine gibt), und HYPHENATION_LOCALES listet die mitgelieferten auf. Die aufgelöste Konfiguration (doc.config.bodyText.hyphenation) nennt in locale die tatsächlich verwendeten Muster und behält in tag das von Ihnen angegebene Tag, wenn es abweicht. Das PDF-Backend deklariert die Dokumentsprache aus dem locale der obersten Ebene und nur dann aus diesem Tag, wenn locale nicht gesetzt ist (siehe Dokumentsprache).

import { matchHyphenationLocale } from 'postext';
 
matchHyphenationLocale('es-MX'); // 'es'
matchHyphenationLocale('en-GB'); // 'en-us'
matchHyphenationLocale('sv');    // undefined: hyphenated with 'en-us', with a console warning

Wörter mit weniger als 5 Zeichen werden nie getrennt. Die Engine verlangt mindestens 2 Zeichen vor und 3 Zeichen nach einer Trennstelle.

Ungetrennte Wörter

Ein Wörterbuch trennt einen Namen wie jedes andere Wort: Al-ice, Áms-ter-dam, You-Tu-be. Drei Einstellungen halten Wörter ganz, und alle drei folgen standardmäßig dem Wörterbuch.

hyphenation.exceptions ist eine Liste von Wörtern wie \hyphenation{…} in TeX. Ein ohne Bindestrich geschriebener Eintrag wird nie getrennt; ein mit Bindestrichen geschriebener wird nur dort getrennt, sodass 'You-Tube' You- · Tube ergibt und sonst nichts. Ein Eintrag passt auf eine Folge von Buchstaben, gleich was darum steht: 'Alice' deckt (Alice, und Alice’s ab, und ein Kompositum wird Teil für Teil abgeglichen (Blender-based passt auf 'Blender'). Eine flektierte Form ist ein anderes Wort und braucht einen eigenen Eintrag. Ein kleingeschriebener Eintrag passt auf das Wort in jeder Schreibung ('blender' deckt Blender und BLENDER ab); ein Eintrag mit großem Anfangsbuchstaben passt nur auf die Vorkommen, die mit einem Großbuchstaben beginnen, sodass 'Rose' den Namen ganz hält und rose dem Wörterbuch überlässt. Einträge enthalten nur Buchstaben und Bindestriche; alles andere wird verworfen.

hyphenation.capitalized: false hält jedes Wort ganz, das mit einem Großbuchstaben beginnt: Namen, Akronyme und auch das erste Wort jedes Satzes. Es entspricht dem ausgeschalteten Schalter „Großgeschriebene Wörter trennen“ von InDesign und \uchyph=0 in TeX. Ein Eintrag in exceptions mit Bindestrichen trennt sein Wort weiterhin dort. Im Deutschen wird jedes Substantiv großgeschrieben, sodass der Schalter einem deutschen Text kaum ein trennbares Wort ließe: Nennen Sie dort die Wörter in exceptions oder verwenden Sie citations.hyphenateNames.

citations.hyphenateNames: false hält die Familiennamen der vom Dokument zitierten Autorinnen und Autoren ganz, wo immer sie stehen: in einem Zitat, im laufenden Text und im Literaturverzeichnis. Siehe Zitationen.

const config: PostextConfig = {
  locale: 'es',
  bodyText: {
    hyphenation: { exceptions: ['Ámsterdam', 'Blender', 'You-Tube'] },
  },
};

Die drei erreichen jeden Text, den das Wörterbuch trennt: Fließtext, Überschriften, Listen, Kästen, Legenden, Tabellenzellen, Anmerkungen, lebende Kolumnentitel und die übrigen Gestaltungstexte. Das ist mehr als bei compounds, das Legenden, Anmerkungen, Zellen und Inhaltsverzeichnis ignorieren. Zwei Dinge bleiben, wie sie sind. Ein in einem Vorkommen eines Worts getipptes weiches Trennzeichen entscheidet weiterhin über dieses Vorkommen, und ein weiches Trennzeichen vor dem ersten Buchstaben hält ein Vorkommen ohne Liste ganz (siehe Wo eine Zeile nie umbricht). Und ein Wort, das breiter als seine ganze Satzbreite ist, wird weiterhin getrennt: an den Stellen seines Eintrags, wenn es welche hat, sonst an den Silben des Wörterbuchs. Weniger getrennte Wörter lassen einer schmalen Blocksatzspalte weniger Möglichkeiten, ihre Zeilen zu füllen; prüfen Sie daher die Wortabstände, nachdem Sie capitalized auf einer dreispaltigen Seite ausgeschaltet haben. Das umfließende EPUB überlässt die Silbentrennung dem Lesesystem, das von diesen Regeln nichts weiß.

Flattersatz

Standardmäßig wird nur Blocksatz getrennt: Mit textAlign: 'left' und in links, zentriert oder rechts gesetzten Absatzformaten bleibt jedes Wort ganz, wie stark die Kante auch flattert, außer an einem im Text getippten weichen Trennzeichen (U+00AD). Setzen Sie hyphenation.ragged: true, um auch Flattersatz zu trennen.

Eine Flattersatzzeile wird nie gedehnt, deshalb würde das Trennen jedes Worts, das nicht passt, die Kante mit Trennstrichen säumen. Die Trennzone begrenzt das, so wie es der Einzeilen-Setzer eines DTP-Programms tut. Passt ein Wort am Ende einer Zeile nicht, betrachtet die Engine die Lücke, die das ganze Wort auf der nächsten Zeile hinterließe. Ist diese Lücke breiter als zone, wird das Wort an der letzten passenden Silbe getrennt; sonst rückt es ganz hinunter. Eine Zone in em bezieht sich auf die eigene Schriftgröße des Texts. Der Standard 3em trennt nur die Wörter, die eine merklich kurze Zeile hinterließen. Eine breitere Zone ergibt weniger Trennstriche und eine stärker flatternde Kante; 0 trennt jedes Wort, das nicht passt. Beim zeilenweisen Setzen enden höchstens zwei Zeilen in Folge auf einer Silbe. Harte Bindestriche (enseñanza-aprendizaje), URL-Fugen, im Text getippte weiche Trennzeichen und Wörter, die breiter als die ganze Zeile sind, brechen wie immer um: Die Zone und die Grenze von zwei Zeilen gelten nur für die Silben des Wörterbuchs.

Die Einstellung gilt für das ganze Dokument. Sie wirkt auf Fließtext und Zitate, wenn sie im Flattersatz stehen, und auf jedes Absatzformat im Flattersatz und jeden Kastentext, deren eigenes hyphenation an ist (Standard ist hyphenation.enabled des Fließtexts); hyphenation: false hält also die Wörter eines Formats ganz. Überschriften, Legenden, Anmerkungen, Tabellenzellen und das Inhaltsverzeichnis werden nicht getrennt; dort wird, wie überall, nur ein Wort getrennt, das breiter als die ganze Satzbreite ist. Gestaltungstexte – lebende Kolumnentitel, Kapitelauftakte, Teiltitelseiten – folgen dem eigenen Schalter hyphenate jedes Textelements, den die eingebauten ganzseitigen Kapitelauftakte und Teiltitelseiten setzen, und verwenden ebenfalls das Wörterbuch des Dokuments. Blocksatz ignoriert ragged und zone.

const config: PostextConfig = {
  locale: 'es',
  bodyText: {
    textAlign: 'left',
    // A little more hyphenation than the 3 em default.
    hyphenation: { ragged: true, zone: { value: 2, unit: 'em' } },
  },
};

Mit optimalRagged (Standard) wird laufender Text im Flattersatz mit Knuth-Plass umbrochen, und die Zone behält dort ihre Bedeutung: Ein Wort wird nur getrennt, wenn es nicht in den Rest der Zeile passt und es ganz hinunterzuschicken mehr als die Zone leer ließe. Zwei Silben in Folge werden nicht verweigert, kosten aber so viel wie zwei Trennstriche in Folge im Blocksatz, sodass eine dritte selten ist. Mit optimalRagged: false oder optimalLineBreaking: false wird jede Zeile gefüllt, bevor die nächste beginnt, wie bis postext 1.4.

Die Silbentrennung im Flattersatz setzt Absätze mit dem Umbruchverfahren, das Absätze mit Inline-Formatierung (fett, kursiv, Links, Mathematik) immer verwenden; sie einzuschalten kann daher auch einige Umbrüche verschieben, die keine Trennungen sind. In einer Flattersatzzeile bricht dieses Verfahren neben Leerzeichen und den Silben des Wörterbuchs nach einem harten Bindestrich oder einem Strich zwischen zwei Wörtern um (largas—separadas; mit breakAfterDashes nach jedem Strich, der ohne Abstand zwischen Wörtern steht, auch riddles.—I und riddles—*and*), an URL-Fugen und zwischen Ideogrammen, und es hält ein in mehreren Abschnitten gesetztes Wort zusammen (**Nota**:, (*véase*). Ohne Silbentrennung im Flattersatz wird ein Flattersatzabsatz ohne Formatierung mit Knuth-Plass umbrochen, wenn optimalRagged an ist (Standard): an Wortzwischenräumen, nach einem harten Bindestrich zwischen zwei Buchstaben (meta- · analyses), wie es das andere Verfahren tut, und mit breakAfterDashes nach Strichen ohne Abstand. Zeile für Zeile gesetzt, durchläuft er das Umbruchverfahren von Pretext, das sich in drei Punkten unterscheidet: Es darf auch vor einem Strich umbrechen, der einen Einschub schließt, oder nach einem, der ihn eröffnet (él · — y), beim Trennen nach einem Schrägstrich (km/ · h), und es schneidet ein Wort, das breiter als die Zeile ist, an einem beliebigen Zeichen ohne Trennstrich, wo das andere Verfahren es zuerst an einer Silbe trennt.

In der Sandbox heißt der Schalter Flattersatz trennen; er steht unter der Absatzausrichtung im Abschnitt „Grundtext“, mit der Zone darunter. Bei Fließtext im Blocksatz steht derselbe Schalter bei den Blocksatzeinstellungen, für die Absatzformate und Kästen im Flattersatz.

#Dokumentsprache

Das locale der obersten Ebene ist die Sprache des Dokuments als Ganzes. Es nimmt dieselben Werte wie hyphenation.locale an und dient als Ersatz, wenn dieses Feld nicht gesetzt ist; ein spanisches Buch braucht also nur locale: 'es', um spanisch zu trennen. Es wählt auch die Sprache der eingebauten Fortsetzungstexte von Tabellen und geteilten Kästen ((cont.) / Continued gegenüber Continúa, siehe Tabellen, die höher als die Seite sind und Hinweise an einem geteilten Kasten) und der ausgeschriebenen Überschriftennummern (Chapter One gegenüber Capítulo uno, siehe Ausgeschriebene Zahlen) und ist die Sprache, die in ein barrierefreies PDF getaggt wird. Ohne Wert nimmt die Engine 'en-us' an; die Sandbox fällt auf die Sprache der Oberfläche zurück und setzt das Feld unter Gestaltung › Schriftsystem.

Es wählt auch die eingebauten Ressourcentypen. Ist resourceTypes nicht gesetzt, nummeriert und beschriftet buildDocument mit defaultResourceTypes(locale), sodass locale: 'de' allein Abbildung 1.1 und Tabelle 1.1 ergibt. Ist locale nicht gesetzt, vertritt es die Sprache der Silbentrennung, für die Ressourcentypen wie für die Tabellentexte. Eine ausdrückliche Liste resourceTypes hat immer Vorrang. Frühere Versionen verwendeten die englischen Typen, gleich welches locale galt, es sei denn, Sie übergaben selbst defaultResourceTypes(locale); ein Dokument, das locale setzt und die englischen Bezeichnungen behalten will, übergibt resourceTypes: defaultResourceTypes('en'). Bücher und Pakete der Sandbox bringen ihre eigene Liste mit und sind daher nicht betroffen.

Jedes BCP-47-Tag funktioniert hier wie in hyphenation.locale: 'de-AT' erhält die deutschen Texte. Die eingebauten Texte gibt es in den acht Sprachen, die die Silbentrennung unterstützt, in Chinesisch (in vereinfachten und in traditionellen Schriftzeichen), in Japanisch und in Arabisch; jede andere Sprache erhält die englischen.

Chinesisch nimmt zh, zh-Hans, zh-Hant, zh-CN, zh-SG, zh-TW, zh-HK, zh-MO und die langen Formen (zh-Hant-TW) an, in jeder Schreibung und mit - oder _. Die Texte folgen der Schrift, gelesen mit Intl.Locale(tag).maximize(): zh, zh-CN und zh-SG sind vereinfacht, zh-TW, zh-HK und zh-MO traditionell. Die typografischen Standardwerte, die von der Sprache abhängen, folgen dagegen der Region, wie es clreq §1.2 empfiehlt: CN, SG und MY zählen als Festland, TW als Taiwan, HK und MO als Hongkong, und ein Tag ohne Region richtet sich nach seiner Schrift (zh-Hant ist Taiwan, zh und zh-Hans das Festland). Japanisch nimmt ja, ja-JP, ja-Jpan und jedes andere Tag ja an (isJapaneseLanguage(tag)); seit postext 1.16 hat es eigene Texte und eine eigene Region, japan, deren typografische Standardwerte JLReq folgen (siehe Japanischer Satz). Eine Tabelle von Texten ohne japanischen Eintrag liefert Englisch, nie Chinesisch. localeScript(tag), cjkRegionOf(tag), stringsKeyOf(tag) und sameContentLocale(a, b) liefern diese Lesarten, und DOCUMENT_LANGUAGES listet die Sprachen mit eingebauten Texten, jede in ihrer eigenen Sprache benannt (日本語 zwischen den chinesischen Einträgen und العربية), so wie die Auswahl „Dokumentsprache“ der Sandbox sie zeigt.

Das Präfix der Legende ist der Name des Typs (Abbildung 1.1.). Die chinesischen Typen nummerieren innerhalb des Kapitels mit einem Bindestrich, {h1}-{n} (图 1-1); mit den Legendeneinstellungen labelNumberGap: '' und labelSeparator: '　' lautet die Legende 图1-1　标题 (siehe Legendenstil). Auch das Register folgt der Sprache: 见 und 另见 vor einem Querverweis, 符号 und 数字 über den Symbolen und den Zahlen in vereinfachten Schriftzeichen; 見, 另見, 符號 und 數字 in traditionellen. Japanisch nummeriert seine Typen ebenso und setzt seine Legenden ohne die beiden Einstellungen als 図1-1　題, schreibt Querverweise als 第3章, 2.3節 und 12ページ, betitelt das Literaturverzeichnis mit 参考文献, und sein Register druckt 記号 und 数字 über Symbole und Zahlen und schreibt seine Querverweise mit einem Pfeil, →夏目漱石 für siehe und →夏目漱石、森鷗外も見よ nach den Seitenzahlen für siehe auch, die Bezeichnungen aufrecht. Arabisch nummeriert seine Typen ebenso, {h1}-{n} (شكل 2-3), schreibt Querverweise als الفصل 3, القسم 2-1 und ص 12, betitelt das Literaturverzeichnis mit المراجع, und sein Register druckt انظر / انظر أيضًا, رموز und أرقام, mit dem arabischen Komma und Semikolon (، ؛).

Ein chinesisches, japanisches oder koreanisches Dokument deklariert seine Sprache in der HTML-Ausgabe (lang auf der Wurzel .pt-doc, zh-Hant-TW ungekürzt) und auf dem Canvas, den es malt (ctx.lang, in Chrome 136 und neuer), sodass der Browser die Glyphenformen der Region zeichnet: Unicode vereinheitlicht die Han-Zeichen, und ein Codepoint sieht in einer taiwanischen und in einer japanischen Schrift verschieden aus. Seit postext 1.30 tut das auch jedes andere Dokument, in der Sprache, in der sein Text geformt wird (bodyText.shapingLanguage: 'document', der Standard); mit 'host' tragen die übrigen Dokumente kein lang, und jeder Canvas malt in der Sprache der Seite, die ihn einbettet. Das PDF deklariert für jedes Dokument, getaggt oder nicht, /Lang aus locale, mit Schrift und Region. Ein Dokument in einer Sprache, die von rechts nach links geschrieben wird (Arabisch, Persisch, Urdu, Hebräisch …), deklariert seine Sprache ebenfalls: Die Sprachformen der Schrift (locl) und die Ersatzschrift folgen ihr.

const config: PostextConfig = {
  locale: 'es',
  bodyText: { textAlign: 'justify', hyphenation: { enabled: true } }, // hyphenates in Spanish
};

Ziffern des Dokuments

numerals auf oberster Ebene legt die Ziffern jeder Zahl fest, die die Engine schreibt: Seitenzahlen und die Seitenangaben von Inhaltsverzeichnis, Register und Seitenverweisen; Nummern geordneter Listen und Fußnoten; Zähler von Überschriften und Kapiteln, {chapterNumber}; {h1} und {n} einer Abbildungsnummer und eines Verweises darauf; {totalPages}, {bookTotalPages} und {numberDecimal}. 'latn' schreibt 0–9, 'arab' die arabisch-indischen Ziffern ٠–٩ und 'arabext' die persischen Ziffern ۰–۹. Nur das Dezimalformat ändert sich – decimal, arabic der Listen oder eine auf dem Standard belassene Einstellung –, sodass ein vom Autor genanntes Format wie genannt gedruckt wird: lower-roman bleibt i, ii, iii, und arabic-indic schreibt auch in einem lateinischen Dokument ١, ٢, ٣. Der Text des Dokuments wird nie umgeschrieben.

Der Standard 'auto' nimmt die Ziffern von locale (defaultNumeralsFor(tag)): 'arab' für Arabisch ohne Region oder mit einer Region außerhalb des Maghreb (ar, ar-EG, ar-SA, ar-AE …), 'latn' für ar-MA, ar-DZ, ar-TN, ar-LY, ar-MR und ar-EH, 'arabext' für Persisch (fa), Paschtu (ps) und das Urdu Indiens (ur-IN) und 'latn' für alles andere, das Urdu Pakistans eingeschlossen. CLDR gibt latn für ein bloßes ar und für ar-AE an; arabische Bücher des Maschrek und der Golfstaaten drucken ٠–٩, und dem folgt Postext. Ein Tag, das seine Ziffern nennt, behält sie: ar-MA-u-nu-arab. Eine in den Ziffern des Dokuments nummerierte Seite speichert arabic-indic oder persian als ihr pageNumberFormat, sodass die Seitenbezeichnungen des PDFs dieselben Ziffern zeigen. Ein unbekannter Wert folgt der Sprache und wird als unknownNumerals gemeldet.

Zahlen, die der Autor tippt, werden in jedem der drei Systeme gelesen: Ein Listenpunkt ٣. beginnt bei 3, und {startAt=٥}, :::numbering{startAt=٥}, :::space{lines=٢} und :::part{number="٣"} (für {numberDecimal}) lesen den Wert.

const config: PostextConfig = { locale: 'ar' };                     // ١، ٢، ٣
const maghreb: PostextConfig = { locale: 'ar-MA' };                 // 1, 2, 3
const forced: PostextConfig = { locale: 'ar', numerals: 'latn' };   // 1, 2, 3

Schreibrichtung

direction auf oberster Ebene legt die Grundrichtung des Dokuments fest: 'ltr', 'rtl' oder 'auto' (Standard), das 'rtl' ist, wenn die Schrift von locale von rechts nach links geschrieben wird (Arabisch, Persisch, Urdu, Hebräisch, Syrisch, Thaana, N’Ko, Adlam …, gelesen mit directionOf(tag)), und sonst 'ltr'. Ein Dokument von rechts nach links wird in einem gespiegelten Rahmen gesetzt: Seine Zeilen beginnen rechts, seine erste Spalte ist die rechte, seine Einzüge, Listenmarken, Gleitobjekte, Fußnoten und Kästen stehen rechts, und page.binding: 'auto' bindet es rechts. Die aufgelöste Konfiguration trägt direction: 'rtl' nur für ein solches Dokument, sodass ein Dokument von links nach rechts wie bisher aufgelöst wird. Ein unbekannter Wert wird als 'auto' gelesen und als unknownConfigValue gemeldet. Der Unicode-Bidi-Algorithmus (UAX #9) ordnet die Abschnitte jeder Zeile in beiden Richtungen: Ein arabisches Zitat in einem englischen Buch liest sich an Ort und Stelle von rechts nach links.

Innerhalb des Dokuments nimmt eine Überschrift oder ein Container ::: {dir=ltr} oder {dir=rtl} an, und die Inline-Auszeichnungen :ltr[…] und :rtl[…] isolieren einen Textabschnitt (siehe Schreibrichtung in der Auszeichnung); eine Tabellenressource nimmt table.direction an. Ein Block, der gegen die Richtung des Dokuments gesetzt ist, behält seine eigene Anfangsseite: Sein Einzug, seine Listenmarken und das bündige Ende seiner letzten Zeile wechseln auf die Seite, an der sein Text beginnt.

Eine Einstellung, die eine Seite nennt, meint eine Seite des Texts oder des Textflusses, nie des Bogens, sodass eine für ein englisches Buch gemachte Gestaltung funktioniert, wenn das Buch auf Arabisch umgestellt wird. 'start' und 'end' werden als ausdrückliche Namen angenommen:

placement.rotate behält auf einer gespiegelten Seite seine physische Bedeutung: Eine im Uhrzeigersinn gedrehte Abbildung ist auf dem Bogen im Uhrzeigersinn gedreht. Ein Host, der das Layout liest, findet auf jeder Seite den gespiegelten Rahmen (VDTPage.flow mit direction: 'rtl', pageIsMirrored(page)) und die visuelle Reihenfolge der Segmente jeder Zeile in VDTLine.order; flowToPage und pageToFlow rechnen zwischen Textfluss und Bogen um. Siehe Arabischer Satz.

const arabic: PostextConfig = { locale: 'ar' };                        // right to left, bound on the right
const english: PostextConfig = { locale: 'en', direction: 'rtl' };     // forced; rarely what you want

#Sprachen und Schriftsysteme

Postext setzt alphabetische Schriften, die von links nach rechts geschrieben werden, sowie Chinesisch und Japanisch quer über die Seite und von oben nach unten. Chinesischer Satz und Japanischer Satz erklären, wie sie gesetzt werden und welche Einstellungen sie steuern; die Schlüssel stehen unter Ostasiatische Typografie, Vertikale Schrift und Bindung. Was jedes Schriftsystem erhält:

• Chinesisch wird vom CJK-Setzer gesetzt, wenn ein Absatz mehr CJK-Zeichen als Wortzwischenräume enthält: Seine Zeilen brechen zwischen Zeichen um, nach den Regeln für Zeilenanfang und -ende von cjk.lineBreak (keine Zeile beginnt mit 。、」 oder ー, keine endet mit 「 oder （), halten —— und …… sowie eine Zahl mit ihren Zeichen und ein lateinisches Wort ganz, und eine Blocksatzzeile wird zwischen ihren Zeichen auf die Satzbreite verteilt. Breiten der Satzzeichen, hängende Satzzeichen, der Abstand zwischen Han und Latein, das Zeichenraster, Betonungspunkte, die Markierungen für Eigennamen und Buchtitel, Ruby und Warichu-Anmerkungen folgen der Region von locale, quer über die Zeile oder an ihr hinab (layout.writingMode: 'vertical-rl'). Ein lateinischer Absatz, der ein paar CJK-Wörter zitiert, behält den optimalen Zeilenumbruch und darf neben ihnen umbrechen; eine CJK-Klammer, der Mittelpunkt oder ein Vollbreitenzeichen in lateinischem Text (〈h〉, ％) ändert nichts.
• Japanisch durchläuft seit postext 1.16 denselben Setzer mit eigenen Regeln, denen der W3C-Requirements for Japanese Text Layout (JLReq) und von JIS X 4051: Ein ja-Locale ergibt die Region japan, deren automatische Werte die Kinsoku-Stufen von JLReq setzen (kleine Kana und ー eröffnen nie eine Zeile), Satzzeichen in voller Breite mit Paarstauchung, ein Geviert nach ？！, die Klammer, die einen Absatz eröffnet, in der zweiten Hälfte des Einzugs, Sesam-Betonungszeichen über dem Text, Buchtitel in 『』, Furigana im Verhältnis 1:2:1, japanische Zählwörter, Anmerkungen und ein nach Lesung sortiertes Register. Frühere Versionen setzten Japanisch mit den Standardwerten für das chinesische Festland.
• Koreanisch durchläuft denselben Setzer und wird ohne Silbentrennung gesetzt, aber mit den Standardwerten für das chinesische Festland: Seine eigenen Regeln (KLREQ) sind nicht umgesetzt. Koreanischer Text bricht zwischen Silben wie auch an seinen Leerzeichen um.
• Arabisch und andere Schriften von rechts nach links (Persisch, Urdu, Hebräisch …) werden von rechts nach links gesetzt: Arabischer Satz erklärt, wie. Die direction des Dokuments ergibt sich aus der Schrift von locale, der Unicode-Bidi-Algorithmus ordnet die lateinischen Wörter und Zahlen in jeder Zeile, das Buch wird rechts gebunden, mit seiner ersten Spalte rechts, und jede Zahl, die die Engine schreibt, nimmt die Ziffern der Region an. Ein Wort mit einem Buchstaben in arabischer Schrift wird nie getrennt, gesperrt oder geschnitten, und eine arabische Blocksatzzeile wird an ihren Leerzeichen und mit Kaschidas gedehnt. Vokalzeichen, Hervorhebung, Fußnoten und die Texte des Arabischen stehen unter Arabischer Text. Persisch, Urdu und Hebräisch erhalten die Richtung, die Ziffern und die Regeln für ganze Wörter, aber keine eigenen eingebauten Texte.

Trennmuster werden für acht Sprachen mitgeliefert (en-us, es, fr, de, it, pt, ca, nl); die eingebauten Ressourcentypen und Fortsetzungstexte gibt es in diesen acht, in Chinesisch, in Japanisch und in Arabisch. Chinesisch, Japanisch, Koreanisch und die Sprachen, die von rechts nach links geschrieben werden, werden ohne Silbentrennung gesetzt. Jede andere Sprache wird mit den Mustern für US-Englisch getrennt, mit einer Warnung auf der Konsole, und erhält die englischen Texte. Setzen Sie für ein solches Dokument hyphenation.enabled: false und übergeben Sie resourceTypes und die Fortsetzungstexte von tableStyle in seiner Sprache.

#Arabischer Text

Diese Einstellungen dienen Text in arabischer Schrift; keine ändert ein Dokument in einer anderen Schrift. Arabischer Satz erklärt sie zusammen mit dem Rest eines arabischen Buchs: Richtung, Bindung, Ziffern, Vers, Inhaltsverzeichnis und Register.

• Vokalzeichen und Zeilenabstand. Die Vokalzeichen eines vokalisierten Texts (Fatha, Kasra, Schadda, Tanwīn, das hochgestellte Alif, die koranischen Zeichen) stapeln sich über und unter den Buchstaben, im Zeilenabstand, der für sie nie wächst. Jede Zeile mit Zeichen speichert, wie weit deren Farbe reicht (VDTLine.markInk), und der Spaltenzuschnitt der Renderer schließt die Zeichen der ersten und letzten Zeile einer Spalte ein. Trifft ein Zeichen über einem Wort auf die Buchstaben oder Zeichen, die unter dem Wort darüber hängen, meldet der Build den Absatz (arabicMarksExceedLeading, im Bedienfeld „Prüfungen“ der Sandbox). Nur übereinanderstehende Wörter werden verglichen. Teilweise vokalisierter Text braucht etwa 1,7–1,85 em lineHeight, voll vokalisierte Verse 1,9–2,1 em.
• Hervorhebung. Arabische Schrift kennt keine Kursive, daher wird *…* in einem Dokument, dessen locale in arabischer Schrift geschrieben wird, standardmäßig fett gesetzt (bodyText.emphasis: 'auto'). 'color' setzt es aufrecht in italicColor, und 'overline' zieht eine Linie über die Wörter, das khaṭṭ fawqī arabischer Bücher. Die Einstellung erreicht jeden Text, der in den Schriften des Fließtexts gesetzt wird: Absätze, Listen, Zitate, Absatzformate, Kastentexte, Anmerkungen und Überschriften. Legenden, Tabellenzellen, Inhaltsverzeichnis und Register behalten ihre eigenen Kursiveinstellungen. Was auch gewählt ist, die Engine neigt nie arabische Buchstaben: Die arabischen Wörter eines kursiv gesetzten Abschnitts stehen aufrecht, seine lateinischen Wörter behalten ihre Kursive. Ein Zitat ist in einem solchen Dokument standardmäßig aufrecht.
• Taschkīl. bodyText.tashkil: 'strip' entfernt die Vokal- und koranischen Zeichen aus dem Text, den das Layout setzt, für eine unvokalisierte Ausgabe aus einer vokalisierten Quelle: Fatha, Damma, Kasra und ihr Tanwīn, Sukūn, Schadda, das hochgestellte Alif (هٰذا wird zu هذا) und die Zeichen U+0656–U+065F und U+06D6–U+06ED. 'strip-vowels' behält die Schadda, wie die meisten modernen Bücher sie drucken. Hamza und Madda bleiben (أ إ آ sind Buchstaben, auch wenn sie mit kombinierenden Zeichen getippt werden). Die Quelle behält ihre Zeichen; die Zeilen, die Überschriften und das Inhaltsverzeichnis werden ohne sie gesetzt, und jedes gesetzte Zeichen verweist weiterhin auf seine Stelle in der Quelle.
• Fußnoten. footnotes.markerTemplate: '({n})' schreibt die Marken «(١)» in den Ziffern des Dokuments, numbering: 'page' beginnt sie auf jeder Seite neu, und noteNumberPosition: 'inline' setzt die eigene Nummer der Anmerkung auf die Zeile. Die Trennlinie und die Anmerkungsnummern stehen am Anfang der Spalte, in einem Buch von rechts nach links also rechts.
• Ganze Wörter. Ein Wort mit einem Buchstaben in arabischer Schrift wird nie getrennt, geschnitten oder gesperrt, weder in einem arabischen Buch noch als Zitat in einem anderen. Ein Format, das letterSpacing auf arabischen Text setzt, wird gemeldet (joiningScriptLetterSpacing), und ein Wort, das breiter als seine Zeile ist, läuft über sie hinaus und wird gemeldet (unbreakableWordOverflow). Siehe Arabischer Satz.
• Kaschida und Vers. Eine arabische Blocksatzzeile wird mit Kaschidas wie auch an ihren Leerzeichen gedehnt (bodyText.kashida, siehe Kaschida in arabischem Text), und ein klassisches Gedicht wird mit :::verse ein Bayt pro Zeile in zwei gleich breiten Halbversen gesetzt (siehe :::verse).
• Register. Ein Register auf Arabisch sortiert alphabetisch und ignoriert den Artikel ال (index.ignoreArticle), die Vokalzeichen und die Träger der Hamza; siehe Register.

#Waisen, Witwen, zu kurze Ausgangszeilen und Regeln zum Zusammenhalten

Die Mechanik hinter diesen Strafpunkten erklärt Silbentrennung und Blocksatz. Dieser Abschnitt ist die Referenz der Schlüssel von bodyText, die sie steuern.

Über Silbentrennung und Abstandsgrenzen hinaus stellt die Konfiguration des Fließtexts die weichen Regeln bereit, die strukturell ungeschickte Absatzumbrüche verhindern. Sie alle gehen als Strafpunkte in den Zeilenumbruch-Algorithmus von Knuth-Plass ein – sie lenken das Layout zu sauberen Umbrüchen, ohne je eine harte Regel zu erzwingen. Setzen Sie die Werte *Penalty auf 0, um eine von ihnen praktisch abzuschalten.

Zu kurze Ausgangszeilen. Eine zu kurze Ausgangszeile hat ein Absatz, dessen letzte Zeile zu kurz ist, um als richtige Textzeile zu wirken – typischerweise ein oder zwei kurze Wörter, die am Ende eines Absatzes gestrandet sind. Da die Prüfung auf der Länge der Zeile in Pixeln relativ zur normalen Leerzeichenbreite beruht, passt sich runtMinCharacters automatisch der aktuellen Schriftgröße an. Ein kurzes Wort, das optisch breiter als runtMinCharacters × spaceWidth ist, ist in Ordnung; ein Wort, das schmaler ist (oder wirklich allein steht), zieht die Strafe auf sich. Die Schwelle zählt Wortzwischenräume, die etwa halb so breit wie Buchstaben sind: Der Standard 20 entspricht einer letzten Zeile von grob 8 bis 12 Buchstaben. Jede zu kurze Ausgangszeile kostet die ganze Strafe, sodass der Umbruch von zwei Ausgängen unter der Schwelle die engeren Zeilen darüber behält; gradedRuntPenalty bewertet jeden stattdessen nach seinem Fehlbetrag, und der längere Ausgang gewinnt. Für mathematisch Interessierte: Beim Standardwert 1000 für runtPenalty überwiegt das Vermeiden einer zu kurzen Ausgangszeile jede andere Wahl der Umbrüche, die eine Dehnung des Wortabstands bis etwa r≈2,15 erfordert.

Weich, nicht hart. Keine dieser Regeln kann einen Umbruch verhindern – die Engine liefert immer ein Layout. Es sind Strafpunkte: Der Algorithmus wägt Schlechtigkeit, Trennkosten, Gleichmäßigkeit der Fitness-Klassen und diese strukturellen Strafen in einer einzigen globalen Optimierung gegeneinander ab und wählt die Umbrüche mit den geringsten Gesamtkosten. Brauchen Sie eine härtere Garantie, erhöhen Sie die Strafe; liest sich ein bestimmtes Dokument mit einer gelockerten Strafe besser, senken Sie sie.

#Überschriften

Die Eigenschaft headings steuert die Typografie aller Überschriftenebenen (H1–H6). Sie können allgemeine Standardwerte setzen, die für alle Ebenen gelten, und dann einzelne Eigenschaften pro Ebene überschreiben.

#Allgemeine Standardwerte

Zentrierte Überschriften für Gedichte oder die Akte eines Theaterstücks, ohne Gestaltungsfeld:

headings: {
  textAlign: 'center',
  levels: [{ level: 2, textTransform: 'uppercase' }],
}

Übergeben Sie ein Objekt headings, bleibt jeder Standardwert einer Ebene erhalten, den Sie nicht erneut angeben, der Seitenumbruch vor der H1 eingeschlossen (siehe Überschreibungen pro Ebene).

#Spaltenausgleich

Verlage erwarten, dass jede Spalte oben auf der Seite beginnt und bündig mit ihrem Fuß endet. Umbruchregeln (Schutz vor Waisen und Witwen, mit ihrem Text zusammengehaltene Überschriften, unteilbare Abbildungen) hinterlassen naturgemäß kurze Spalten – eine oder mehrere leere Zeilen des Grundlinienrasters am Fuß. Ist der Ausgleich aktiviert, tut die Engine, was ein Setzer täte, und setzt ihre Hebel in redaktioneller Rangfolge ein:

1. Ein Kasten, der die Spalte schließt – ein Kasten am Ende einer kurzen Spalte wird um genau den Raum unter seinem Fuß nach unten geschoben, sodass seine Unterkante auf dem letzten Rasterplatz der Seite landet, auf gleicher Höhe mit der letzten Zeile der Spalte daneben. Er nimmt diesen Raum auch dann, wenn er kleiner als eine Zeile ist, solange nichts in eine andere Spalte rückt. Standardmäßig läuft er vor jedem anderen Hebel und nimmt die ganze Lücke, sodass ein Kasten, der den Absatz darüber kommentiert, mehrere Zeilen unter ihm landen kann; closingBox: 'last' lässt die Überschriften, die Listenenden und die übrigen Abstandshebel zuerst die ganzen Zeilen nehmen und dem Kasten nur, was sie übrig lassen, und closingBox: 'off' bewegt ihn nie.
2. Bilder mit Sicherheitsbereich – ein Bild mit Sicherheitsbereich (Resource.safeArea, siehe Dokumentformat › Sicherheitsbereich), das inline in der kurzen Spalte steht oder an ihrem Kopf oder Fuß allein über dieser Spalte gleitet, wächst um ganze Rasterzeilen, beschnitten innerhalb seines Sicherheitsbereichs, bis die Spalte voll ist oder der Beschnitt den Sicherheitsbereich erreicht. Ein höheres Bild hinterlässt kein Loch auf der Seite, daher läuft dieser Hebel, bevor Abstand hinzugefügt wird; ein Gleitobjekt am Kopf einer Spalte auf einer Seite oder in einem Band, dessen Spaltenköpfe auf gleicher Höhe bleiben (siehe unten), wächst nicht. Gespeichert als flexFigure. Er hat keine eigene Einstellung: Nur ein Bild, dessen Ressource einen Sicherheitsbereich markiert, kann wachsen.
3. Überschriften – ganze Rasterzeilen werden dem oberen Rand der Überschriften in der kurzen Spalte hinzugefügt. Werden mehrere Zeilen gebraucht und enthält die Spalte mehrere Überschriften, werden die Zeilen auf sie verteilt, wobei die wichtigste Überschrift stets den größten Anteil erhält (eine h2 erhält mehr als eine h3). Überschriften ganz oben in einer Spalte erhalten nie zusätzlichen Abstand, damit Spalten weiter am Seitenkopf beginnen – außer einer Überschrift direkt unter einer Abbildung oder Tabelle, die ihre Spalte auf einer weiterlaufenden Seite anführt: Der Raum kommt über diese Überschrift, unter die Abbildung. Eine Überschrift nimmt auf diese Weise höchstens maxLinesBeforeLoose Zeilen (standardmäßig zwei), bevor die Hebel weiter unten probiert werden, und ihre weiteren Zeilen bis maxLinesPerHeading nur, wenn jene nichts mehr zu geben haben.
4. Listenenden – können die Überschriften nicht die ganze Lücke aufnehmen, wird dort eine Rasterzeile eingefügt, wo eine Liste oder Aufzählung endet (Abstand nach einer Liste wirkt natürlich), begrenzt pro Listenende.
5. Unter Formeln, Kästen und Abbildungen – dann kommt eine Rasterzeile unter eine abgesetzte Formel oder einen Kasten, nach dem der Text weiterläuft (stretchAfterDisplays; sie wirkt wie der eigene Rand des Elements), und unter eine Abbildung oder Tabelle, die die Spalte anführt (stretchAfterFloats, begrenzt durch maxLinesAfterFloat).
6. Lockere Absätze – als letztes Mittel wird ein Absatz der Spalte eine Zeile länger neu umbrochen (\looseness=+1 in TeX), wobei der längste Absatz gewählt wird, damit sich der zusätzliche Wortabstand unsichtbar verteilt. Die lockere Lösung wird nur angenommen, wenn jede Zeile unter bodyText.maxWordSpacing bleibt – der Grauwert überschreitet nie die Grenze, die Sie bereits eingestellt haben. Erfordert bodyText.optimalLineBreaking.

Auf einem Zeichenraster (cjk.grid, siehe Chinesischer Satz › Das Zeichenraster) steht jedes Zeichen in einer Zelle von einem Geviert Breite und jede Zeile im Zeilenschritt des Rasters, der auch das Grundlinienraster ist. Der Ausgleich ist dort standardmäßig aus, wie im vertikalen Text: Eine Seite, die Zeile für Zeile auf einem Raster gesetzt ist, so wie GB/T 9704 22 Zeilen zu 28 Zeichen zählt, lässt eine kurze Spalte kurz. Eine Konfiguration mit enabled: true erhält Hebel, die das Raster einhalten: Überschriften, Listenenden, abgesetzte Elemente und Abbildungen nehmen ganze Rasterzeilen, sodass sich der Text darunter um ganze Zeilen verschiebt, und gridLines: 'off' hält diese für einen Standard heraus, der keine leere Zeile herzugeben hat. Ein chinesischer oder japanischer Absatz läuft nur dann eine Zeile länger, wenn sich keine Lücke zwischen zwei seiner Zeichen über maxTracking hinaus dehnt, und nimmt keine Laufweite auf seine Buchstaben: Eine Zeile, der ein Zeichen fehlt, verteilt ein Geviert auf ihre Lücken, weit über den Standard von 0,01 em hinaus, sodass der Hebel für lockere Absätze auf einem Raster aus ganzen Zellen meist nichts findet. Der Kasten, der eine Spalte schließt, und die Bilder mit Sicherheitsbereich liegen bewusst außerhalb des Rasters und funktionieren wie überall.

Die letzte Spalte einer Seite wird nur ausgeglichen, wenn die Seite natürlich in die nächste weiterläuft – die Schlussseite eines Kapitels endet zu Recht kurz. Eine solche Seite und ein von trailing auf gleicher Höhe abgeschnittenes Schlussband halten auch ihre Spaltenköpfe auf gleicher Höhe: Unter einer Abbildung oder Tabelle, die eine ihrer Spalten anführt, wird keine Zeile hinzugefügt (der Hebel nach Gleitobjekten), und eine Überschrift oder ein Kasten, der unter einer solchen Abbildung eine Spalte eröffnet, bleibt an ihrem Kopf, was auch immer stretchAfterFloats sagt, ebenso wie die Überschrift direkt unter einem Auftakt mit span: 'page' in dessen eigener Spalte, sodass eine Spalte nie tiefer beginnt als die daneben, nur damit die Füße fluchten.

Welcher Hebel gegriffen hat

Das Layout speichert jeden angewandten Hebel an dem Block, auf den er angewandt wurde: block.balancing im VDT, den buildDocument zurückgibt. Ein Korrekturbogen, ein Test oder ein Bericht kann so sagen, warum eine Spalte bündig endet – und welche Spalten kein Hebel schließen konnte. Blöcke, die der Ausgleich unberührt ließ, tragen kein balancing, und ein mit enabled: false gebautes Dokument hat keines.

Auf einem Zeichenraster sagt das Dokument, warum eine Spalte kurz enden darf: doc.gridBalancing ist { off: true }, wenn der Ausgleich aus ist, weil die Seite auf einem Raster steht und die Konfiguration ihn nicht einschaltet, und { gridLines: 'off' }, wenn er ohne die Hebel für ganze Zeilen läuft; eine noch kurze Spalte trägt column.gridRefused, die Hebel, die das Raster ihr vorenthielt ('looseParagraph', wenn ein Absatz seine Zeile nur gewinnen könnte, indem er seine Zeichen aus ihren Zellen schiebt, die Hebel für ganze Zeilen unter gridLines: 'off'). Beide fehlen außerhalb des Rasters.

interface VDTBalancing {
  levers: BalanceLever[]; // usually one: a paragraph after a list can take the list-end line and run a line long too
  spaceAbove: number;     // px the spacing levers added above the block (0 when only looseParagraph or flexFigure fired)
  bodyGrowth?: number;    // flexFigure: px the picture grew, cropped within its safe area
  extraLines?: number;    // looseParagraph: lines the paragraph gained
  tracking?: number;      // looseParagraph: the tracking that gained them, in thousandths of an em (0 = word spacing alone)
}
type BalanceLever = 'trailingCallout' | 'flexFigure' | 'heading' | 'listEnd' | 'afterDisplay' | 'afterFloat' | 'looseParagraph';

Die Ausgleichsschnitte werden an den Spalten gespeichert, die sie schneiden: column.bandCapped ist an jeder auf gleicher Höhe geschnittenen Spalte true (das Band, das ein Kasten über die ganze Seitenbreite hinter sich lässt, ein Schlussband), und column.trailingCap markiert zusätzlich das Schlussband eines Kapitels oder des Dokuments (trailing).

import { buildDocument } from 'postext';
 
const doc = buildDocument(content, config);
for (const page of doc.pages) {
  page.columns.forEach((column, i) => {
    const levers: string[] = column.blocks.flatMap((block) => block.balancing?.levers ?? []);
    if (column.trailingCap) levers.push('closing band cut level');
    else if (column.bandCapped) levers.push('band cut level');
    if (levers.length > 0) console.log(`page ${page.index + 1}, column ${i + 1}: ${levers.join(', ')}`);
  });
}
// page 3, column 1: heading, heading
// page 3, column 2: listEnd, looseParagraph

#Überschreibungen pro Ebene

Jede Überschriftenebene kann die allgemeinen Standardwerte über das Array levels überschreiben. Standardmäßig unterscheidet sich nur fontSize (dazu breakBefore der H1, siehe unten) – alle anderen Eigenschaften werden von den allgemeinen Überschrifteneinstellungen geerbt.

Der Standard der H1 bildet den Kapitelaufbau eines Buchs nach: Jede Überschrift der obersten Ebene beginnt auf einer neuen rechten (ungeraden) Seite, mit einer zwingenden leeren Trennseite nach dem vorigen Kapitel. Überschreiben Sie ihn über levels[0].breakBefore, wenn Ihr Dokument flacher gegliedert ist als ein Buch.

Das breakBefore einer Ebene wird Feld für Feld über diesen Standard gelegt, und ein Objekt headings, das es nicht erwähnt, behält ihn. { parity: 'odd' } auf der H1 behält den Umbruch und ändert nur die Parität; { enabled: false } lässt die Kapitel fortlaufend weiterlaufen:

headings: {
  fontFamily: 'Merriweather',                               // H1 still breaks to a fresh recto (always-odd)
  levels: [{ level: 1, breakBefore: { parity: 'odd' } }],    // …or: a recto, with no mandatory blank
}
 
headings: { levels: [{ level: 1, breakBefore: { enabled: false } }] } // chapters run on

Geändert in postext 1.5. Bis postext 1.4 schaltete jedes Objekt headings den Umbruch der H1 aus, sofern levels[0].breakBefore nicht erneut angegeben wurde, und ein unvollständiges breakBefore füllte sein fehlendes Feld aus dem Standard ohne Umbruch. Eine für 1.4 im Code geschriebene Konfiguration mit einem Objekt headings und ohne Umbruch der H1 eröffnet daher jetzt jedes Kapitel auf einer neuen rechten Seite, mit leeren linken Seiten, wo nötig. Damit die Kapitel fortlaufend weiterlaufen, geben Sie dem Eintrag der H1 in levels ein Feld:

headings: { fontFamily: 'Merriweather', levels: [{ level: 1, breakBefore: { enabled: false } }] } // as 1.4 laid it out

Wo die Konfiguration gespeichert wurde, erkennt die Engine das und erledigt es für Sie: die Sandbox für die Bücher und Konfigurationen, die sie damals gespeichert hat (siehe Sandbox → Persistenz), und openBundle / readBundle für ein .postext-Paket, das postext 1.4 oder älter geschrieben hat (siehe Pakete, die postext 1.4 oder früher geschrieben hat). Eine Konfiguration, die Sie selbst gespeichert haben, können Sie durch migrateConfig(config) aus postext/bundle schicken, das die Umbrüche ausschreibt, die 1.4 gesetzt hat (pinLegacyHeadingBreaks): enabled: false auf einer H1, die keinen Umbruch hatte, und parity: 'any' neben einem enabled: true ohne Parität, auf der H1 und auf Überschriftenformaten. Es fixiert außerdem, wie 1.4 sie setzte, die Größe der Mathematik, den Abstand um Inline-Abbildungen (auch in Kästen), die Inline-Auszeichnungen der Überschriften, die Größen der Initialen, den Raum unter einer Doppelpunktzeile, die eine Liste einleitet, die Zeilen, die ein Kastenschnitt von einem Absatz oder Listenpunkt übrig lässt, die Zeilenumbrüche an Strichen, den zeilenweisen Umbruch von Flattersatz, die Teilung eines Absatzes unter einer Überschrift, die Zeilenumbrüche am Bindestrich eines Kompositums und den Abstand unter Containern :::paragraphs. Übergeben Sie das Markdown des Buchs als drittes Argument, { content }, dann lässt es die Mathematik-Fixierung weg, wenn der Text kein $ enthält, die Abstandsfixierungen, wenn keine Zeile eine Ressource einbettet (die Fixierung des Kastenabstands, wenn keine es in einem Kasten tut), die Fixierung der Überschriftenauszeichnungen, wenn keine Überschrift eine Auszeichnung trägt, die Fixierung der Doppelpunktzeile, wenn keine Liste auf eine Zeile mit Doppelpunkt am Ende folgt, die Fixierung des Kastenschnitts, wenn der Text kein :::callout öffnet, die Strich-Fixierung, wenn kein Strich ohne Abstand zwischen Wörtern steht, die Fixierung der Teilung unter Überschriften, wenn der Text keine Überschrift hat, die Container-Fixierung, wenn der Text keinen Container :::paragraphs öffnet, und die Kompositum-Fixierung, wenn kein Bindestrich zwischen zwei Buchstaben steht; die Fixierung des Flattersatzumbruchs erhält nur eine Konfiguration, die laufenden Text im Flattersatz setzt, und die Container-Fixierung nur eine, die ein Absatzformat deklariert (siehe Pakete, die postext 1.4 oder früher geschrieben hat). Nur für die Umbrüche rufen Sie pinLegacyHeadingBreaks(config) auf.

Überschreibungen pro Ebene unterstützen dieselben Eigenschaften wie die allgemeinen Standardwerte – fontSize, lineHeight, fontFamily, color, fontWeight, marginTop, marginBottom, snapToGrid – sowie diese nur für Ebenen vorhandenen Felder (ein Überschriftenstil nimmt sie ebenfalls an):

headings: {
  fontFamily: 'Merriweather',
  levels: [
    // Canonical book preset: chapters on a right-hand (odd) page.
    { level: 1, fontSize: { value: 24, unit: 'pt' }, breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontSize: { value: 18, unit: 'pt' }, italic: true },
  ]
}

snapToGrid funktioniert auch pro Ebene. Ohne Wert folgt eine Ebene headings.snapToGrid; mit Wert überschreibt sie es – so kann ein Dokument seine H2 anderthalb Zeilen über ihren Text setzen, bis zum nächsten Einrastpunkt neben dem Raster, während seine H3 den Abstand unter sich auf ganze Rasterzeilen aufrunden. Ein Überschriftenformat kann es ebenfalls setzen, für die Überschriften, die es verwenden.

headings: {
  marginBottom: { value: 1.5, unit: 'em' },
  levels: [
    { level: 2, snapToGrid: false }, // exactly 1.5 em under every H2
    { level: 3 },                    // inherits headings.snapToGrid: true
  ],
}

#Umbruch davor

breakBefore ist unabhängig von den Nummerierungseinstellungen: Ist es eingeschaltet, erzwingt es einen Seitenumbruch, aber der Zähler wird nur zurückgesetzt, wenn Sie ausdrücklich eine Direktive :::numbering einfügen. Leere Paritätsseiten zählen als echte Seiten der Folge und erhalten Kopf- und Fußzeilen nach ihren normalen Regeln für ungerade und gerade Seiten.

Ein :::pagebreak direkt vor einer solchen Überschrift ersetzt ihren Umbruch nicht: Die Überschrift wendet ihre Parität nach der Seite an, die die Direktive eröffnet hat, was eine leere Seite hinzufügen kann. Siehe Überschriftenstile für eine Überschrift, die direkt nach einem manuellen Umbruch beginnen soll.

Paritätswerte

Zugehörigkeit leerer Seiten

Leere Seiten, die breakBefore einfügt, tragen Kopfzeilen mit Kapiteltitel danach, warum sie eingefügt wurden:

• Seiten, die eingefügt werden, um eine Paritätsbedingung zu erfüllen ('odd', 'even' oder das Paritätsende von 'always-*'), gehören zum kommenden Kapitel. Ihr Platzhalter {chapterTitle} in der Kopfzeile wird zum Titel des neuen Kapitels aufgelöst – denn die leere Seite existiert nur, um das neue Kapitel auf die richtige Parität zu schieben.
• Die zwingende vorangehende Trennseite, die 'always-odd' / 'always-even' einfügen, gehört zum vorigen Kapitel. Sie ist ein bewusstes Atemholen am Kapitelende, daher zeigt die Kopfzeile mit {chapterTitle} weiterhin den Titel des alten Kapitels.

Lebende Kolumnentitel und Palette eines gestalteten Abschnitts (siehe Überschriftenstile) folgen auf leeren Seiten denselben beiden Regeln.

Ausnahme am Dokumentanfang

Ist der allererste Block des Dokuments eine Überschrift mit eingeschaltetem breakBefore – oder beginnt die Quelle mit :::pagebreak –, wird die Parität nicht erzwungen, solange die erste Seite noch leer ist. Die Überschrift landet wie geschrieben auf Seite 1, unabhängig von der eingestellten Parität, sodass ein Dokument, das mit einem auf parity: 'odd' eingestellten # Chapter 1 beginnt, keine unnötige leere Seite am Anfang erbt. Sobald Inhalt platziert wurde, verhält sich die Parität normal.

#Seitenbreite und erweiterte Gestaltung

Jede Überschriftenebene nimmt zwei weitere Felder an, die steuern, wie die Überschrift als Kapitelauftakt über die ganze Seitenbreite dargestellt wird.

Ein Auftakt so hoch wie die Seite. Reicht die reservierte Höhe über den Fuß der Spalte hinaus – ein Umschlag, dessen minHeight die Seitenhöhe ist, ein Bild oder ein Kasten, der an der Seite oder am Anschnitt verankert ist und bis zum Beschnitt hinabreicht –, beansprucht der Auftakt den Rest der Seite: Der Text danach beginnt auf der nächsten Seite, in jeder Spalte eines zweispaltigen wie eines Anderthalb-Spalten-Layouts. Ein Umschlag braucht daher kein :::pagebreak danach (eines schadet nicht: Es fügt keine leere Seite hinzu). Eine Überschrift in der Spalte (span: 'column'), deren Gestaltung höher als ihre Spalte ist, beansprucht diese Spalte, und der Text beginnt am Kopf der nächsten. Der Block der Überschrift reicht dann bis zum Fuß der beanspruchten Spalte, und ihre Gestaltung wird an diesem Band ausgelegt: Oben verankerte Elemente bleiben, wo sie verankert sind, und die, die dem Band folgen – an seiner Mitte oder seinem Fuß verankert oder mit Höhe 'fill' –, halten sich an den Raum, den die Überschrift beansprucht, wie sie sich an die reservierte Höhe halten, wenn sie passt (bis postext 1.4 behielt der Block die Höhe seines Texts, sodass diese Elemente an einem Band von einer Titelhöhe ausgelegt wurden und der Text danach unter der Gestaltung weiterlief). Seitenausstattung, die die Seite nicht beanspruchen soll – ein Streifen am Vorderschnitt über die ganze Seite, ein Ornament am Seitenfuß –, gehört stattdessen in die Gestaltung von Kopf- oder Fußzeile: An 'page' oder 'bleed' verankert und mit pages: 'opener' angezeigt, wird sie auf der Auftaktseite gemalt und reserviert keinen Raum im Fließtext.

Beispiel – ein minimalistischer Kapitelauftakt, der „Chapter N“ über dem Titel zeigt:

{
  "headings": {
    "levels": [
      {
        "level": 1,
        "span": "page",
        "breakBefore": { "enabled": true, "parity": "always-odd" },
        "advancedDesign": {
          "enabled": true,
          "slot": {
            "elements": [
              {
                "kind": "text",
                "id": "chapterLabel",
                "placement": {
                  "anchor": { "to": "container", "edge": "top" },
                  "offset": { "y": { "value": 48, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "Chapter {numberRoman}",
                "fontSize": { "value": 10, "unit": "pt" },
                "align": "center",
                "overflow": "ellipsis-end"
              },
              {
                "kind": "text",
                "id": "chapterTitle",
                "placement": {
                  "anchor": { "to": "#chapterLabel", "edge": "below" },
                  "offset": { "y": { "value": 12, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "{titleText}",
                "fontSize": { "value": 24, "unit": "pt" },
                "fontWeight": 700,
                "align": "center",
                "overflow": "wrap",
                "hyphenate": true
              }
            ]
          }
        }
      }
    ]
  }
}

Platzhalter für Überschriften im Gestaltungsfeld einer Ebene:

• {titleText} – der reine Text der Überschrift (ohne Nummernpräfix). Ein erzwungener Umbruch im Titel (\\) ist hier ein Zeilenumbruch, in einem Auftaktband wie in einer Gestaltung in der Spalte (bis postext 1.4 druckte eine Gestaltung in der Spalte dort ein Leerzeichen, während ihre Höhe mit dem Umbruch gemessen wurde). Die Zeilen, auf die die verborgene Überschrift in ihrer Spalte umbricht, werden wieder zum Titel wie geschrieben verbunden: Ein nach seinem eigenen Bindestrich umbrochenes Wort behält den Bindestrich ohne Leerzeichen danach, ein Wort, das die Spalte getrennt hat, ist wieder ganz, ohne den Trennstrich, den der Umbruch hinzufügte, eine durch ein geschütztes Leerzeichen verbundene Gruppe, die breiter als die Spalte war und an diesem Leerzeichen geteilt wurde, erhält ihr geschütztes Leerzeichen zurück (Capítulo XVIII, nicht CapítuloXVIII), und jeder andere Umbruch gibt sein eines Leerzeichen zurück. Bis postext 1.4 wurde jeder Zeilenumbruch zu einem Leerzeichen, sodass ein Titel, der an einem Bindestrich umbrach, Word- Book druckte, und ein erzwungener Umbruch in einem solchen Titel entfiel.
• {number} – die formatierte Nummer nach dem numberingTemplate der Ebene.
• {numberDecimal}, {numberRoman}, {numberRomanLower}, {numberAlpha}, {numberAlphaLower} – der Zähler der Überschrift (die laufende Zählung ihrer Ebene, gleich was die Vorlage druckt) in anderen Zahlformaten: Das dritte Kapitel ergibt 3, III, iii, C, c, mit oder ohne numberingTemplate. Eine nicht nummerierte Überschrift (ein Format mit numbered: false) lässt sie leer.
• {numberWords}, {numberWordsLower}, {numberOrdinalWords}, {numberOrdinalWordsLower} – derselbe Zähler ausgeschrieben, mit großem Anfangsbuchstaben oder klein: Three / three, Third / third (siehe Ausgeschriebene Zahlen).
• {numberHan} – derselbe Zähler in chinesischen Zahlzeichen, in der Schrift des locale des Dokuments: Ein mit 第{numberHan}回 gesetzter Auftakt druckt für das zwölfte Kapitel 第十二回, während das Inhaltsverzeichnis 12 aufführt.
• {chapterNumber}, {chapterTitle}, {pageNumber}, {totalPages}, {bookTotalPages}, {title}, {subtitle}, {author}, {publishDate} – gemeinsame Metadaten-Platzhalter.
• {attr.<key>} – ein Attribut, das auf der Überschriftenzeile selbst steht (# Title {author="I. Zango Martín"}), ersatzweise das Attribut der H1 des aktuellen Kapitels. Fehlende Attribute werden ohne Warnung zu einer leeren Zeichenkette aufgelöst.

{chapterNumber} druckt, was die lebenden Kolumnentitel für das Kapitel drucken: die Nummer der H1, wenn ihre Ebene (oder ihr Format) ein numberingTemplate hat, sonst die Ordnungszahl des Kapitels – 1, 2 …, fortgesetzt über die vor diesem gesetzten Kapitel hinaus – und nichts für ein nicht nummeriertes Kapitel oder ein Format, dessen Vorlage '' ist. Eine Überschriftengestaltung liest das Kapitel, zu dem ihre Überschrift gehört: eine Überschrift der Ebene 1 ihr eigenes, eine tiefere Überschrift die letzte Überschrift der Ebene 1 vor ihr. Das gilt auch, wo zwei Kapitel auf einer Seite aufeinandertreffen, während die lebenden Kolumnentitel dieser Seite das spätere Kapitel drucken. Die Höhe, die ein Auftakt reserviert, wird mit demselben Wert gemessen. Bis postext 1.4 wurde sie mit dem Nummernpräfix der Überschrift gemessen (ohne Vorlage leer), sodass eine Gestaltung, deren Höhe von {chapterNumber} abhängt, höher malen konnte als der Raum, den sie nahm; und die Gestaltung druckte das Kapitel der Seite, sodass das erste von zwei Kapiteln, die sich eine Seite teilen, die Nummer des zweiten zeigte.

Die Zähler-Platzhalter folgen dem Buch über Kapitel hinweg, die einzeln gesetzt werden (die Zähler, die continuationAfter() weitergibt), und das Attribut startAt einer Überschrift setzt sie neu (siehe Dokumentformat → Attribute von Überschriften). Ein Auftakt, der Chapter III über einem Titel sagt, der im Textfluss und im Inhaltsverzeichnis mit 3. nummeriert ist:

{
  level: 1,
  span: 'page',
  numberingTemplate: '{1}.',
  advancedDesign: {
    enabled: true,
    slot: { elements: [
      { kind: 'text', id: 'label', content: 'Chapter {numberRoman}', fontSize: { value: 10, unit: 'pt' }, overflow: 'ellipsis-end',
        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill', height: 'auto' } } },
      { kind: 'text', id: 'title', content: '{titleText}', fontSize: { value: 24, unit: 'pt' }, overflow: 'wrap',
        placement: { anchor: { to: '#label', edge: 'below' }, size: { width: 'fill', height: 'auto' } } },
    ] },
  },
}

Reservierte Höhe

Eine Überschrift mit erweiterter Gestaltung nimmt in der Spalte Raum ein wie jeder Block: Der Fließtext danach beginnt unter diesem Raum. Der Raum ist die größte von drei Höhen, alle von der Oberkante der Überschrift abwärts gemessen (bei einem Auftakt, der seine Seite beginnt, von der Oberkante des Inhaltsbereichs):

1. der eigene Text der Überschrift, in der Typografie der Ebene gesetzt (er ist unter der Gestaltung verborgen, behält aber seine Zeilen);
2. die Unterkante des Gestaltungsinhalts – die tiefste Unterkante unter den Elementen, die zählen (siehe unten);
3. advancedDesign.minHeight.

Danach kommt das marginBottom der Überschrift hinzu (aus ihrem Überschriftenformat, ihrer Ebene oder headings.marginBottom; standardmäßig 0,5 em), und das Ergebnis wird auf das Grundlinienraster aufgerundet, wenn Überschriften einrasten. Bei einem Auftakt (span: 'page') wird dasselbe Band in jeder Spalte der Seite freigehalten. Bei einer Überschrift in der Spalte, die in ihre Spalte passt, wird die Gestaltung im Rahmen der Überschrift ausgelegt, der genau so hoch ist.

Welche Elemente zählen. Jedes Element der Gestaltung zählt – Text, Linien, Kästen und Bilder gleichermaßen (bis postext 1.4 zählte ein Element image nie, sodass der Text über einem Bild im Band beginnen konnte, wenn minHeight ihn nicht fernhielt) –, außer:

• Elementen mit reserve: false – Dekoration, die unter dem Text liegen darf;
• Elementen, die dem Band selbst folgen – an der mittleren Reihe (left, center, right) oder der unteren Reihe (bottom-left, bottom, bottom-right) des Containers verankert, mit einer Höhe 'fill' gegenüber dem Container (ein Kasten oder eine senkrechte Linie ohne Höhe füllt ihn standardmäßig), und jedem Element, das an einem davon verankert ist. Der Container ist das reservierte Band, daher sitzen diese auf seinem Fuß oder überspannen es: eine Linie unter dem Band, eine getönte Fläche hinter dem Titel. Sie folgen der Höhe; sie legen sie nie fest. Ein Text darunter, der seine eigene Höhe behält, braucht dennoch Platz: Ein am Fuß des Bands verankerter Titel macht das Band mindestens so hoch wie den Titel, sodass der Titel nie über der Oberkante der Überschrift beginnt. Mit minHeight: 36mm und dem Titel an bottom-left verankert ist der Rahmen der Überschrift 36 mm plus ihr marginBottom hoch, auf das Raster aufgerundet, und der Titel sitzt am Fuß dieses Rahmens, direkt über dem folgenden Text; ohne minHeight macht ein Titel, der mehr Zeilen braucht als der eigene Text der Überschrift, das Band so tief wie den Titel. Bis postext 1.4 wurde ein solcher Titel nach oben über den Text über der Überschrift gemalt. Kästen, Linien und Bilder, die dem Band folgen, setzen keine solche Untergrenze, sodass eine am Fuß verankerte Fläche über die Überschrift hinausreichen kann.

An Seite und Anschnitt verankerte Elemente zählen danach, wie weit sie unter die Oberkante der Überschrift reichen. Ein Band oben über die Seite, das über der Überschrift endet, zählt nichts; ein randabfallendes Bild, das darüber hinausläuft, schiebt den Text bis zu seiner Unterkante hinunter. Ebenso alles, was tief auf der Seite steht: Ein Siegel 25 mm über dem Seitenfuß, ein Seitenband in voller Höhe oder ein Rahmen reserviert die Seite bis zu seiner Unterkante, und der Text beginnt meist auf der nächsten Seite. Kennzeichnen Sie solche Dekoration mit reserve: false – sie wird weiterhin gemalt, und Elemente können weiterhin an ihr verankert werden – und geben Sie der Überschrift den nötigen Raum mit ihren Textelementen oder minHeight:

{
  "kind": "image", "id": "seal", "resourceId": "seal", "reserve": false,
  "placement": {
    "anchor": { "to": "page", "edge": "bottom-right" },
    "offset": { "x": { "value": -25, "unit": "mm" }, "y": { "value": -25, "unit": "mm" } },
    "size": { "width": { "value": 30, "unit": "mm" } }
  }
}

Ein Element, das an einem nicht reservierenden verankert ist, zählt weiterhin, sofern es nicht ebenfalls gekennzeichnet ist (eine auf das Siegel gesetzte Legende braucht ihr eigenes reserve: false).

Wo sie malt. Die Gestaltung eines Auftakts (span: 'page') wird vor dem Fließtext gezeichnet, sodass Dekoration, die nichts reserviert, unter dem Text liegt. Die Gestaltung einer Überschrift in der Spalte wird mit dem Block der Überschrift gezeichnet – über den Blöcken darüber in der Spalte, unter denen danach –, wo immer sie oberhalb des Fußes ihrer Spalte platziert ist: auch in den Seitenrändern, im Kopfsteg, im Anschnitt und in den benachbarten Spalten. Der Fuß der Spalte schneidet sie ab, auf dem Canvas und im PDF, da der Textfluss dort endet (siehe Höher als die Spalte unten). Bis postext 1.4 schnitten Canvas und PDF sie auch am Kopf ihrer Spalte ab, sodass ein oben an Seite oder Anschnitt verankertes Band in die Seitenränder lief, aber am Kopfsteg aufhörte. Dekoration, die am Seitenfuß verankert ist, gehört in einen Auftakt oder in die Gestaltung der Fußzeile mit pages: 'opener'.

Höher als die Spalte. Reicht der Raum über den Fuß der Spalte hinaus – ein minHeight so hoch wie die Seite, ein Bild oder Rahmen, das bzw. der bis zum Beschnitt hinabreicht –, beansprucht die Überschrift den Rest ihrer Seite (ein Auftakt, in jeder Spalte) oder ihrer Spalte (eine Überschrift in der Spalte), und der Text danach beginnt auf der nächsten Seite oder in der nächsten Spalte. Ihr Block reicht dann bis zum Fuß der Spalte und wird nie auf die Höhe ihres Texts zurückgeschnitten, sodass das Band, an dem ihre Gestaltung ausgelegt wird, der beanspruchte Raum ist (minHeight eingeschlossen, bis zum Fuß). Eine Gestaltung, die höher als die Seite selbst ist – ein langer Vorspann auf einer kleinen Bildschirmseite –, wird weiterhin am Seitenfuß abgeschnitten (eine Gestaltung in der Spalte am Fuß ihrer Spalte): Die Sandbox führt das im Bedienfeld Prüfungen als Überschriftengestaltung abgeschnitten auf. Das Layout gibt dafür keine Warnung aus – ein Umschlag, der seine Seite beansprucht, ist der übliche Fall und verliert nichts –, aber jeder Host kann dieselbe Prüfung am fertigen Layout ausführen: collectHeadingDesignCuts(doc) liefert ein { kind: 'headingDesignCut', pageIndex, level, where, overflowPx, sourceStart, sourceEnd } für jede Überschrift, deren Gestaltungstext über den Fuß des Seitenbeschnitts (where: 'page', ein Auftakt) oder ihrer Spalte (where: 'column') hinausreicht, und formatWarning beschreibt jede. Siehe Ein Auftakt so hoch wie die Seite unter Seitenbreite und erweiterte Gestaltung.

Die Seitenspalte. In einem Anderthalb-Spalten-Layout, dessen Seitenspalte Gleitobjekte aufnimmt (sideColumnRole: 'floats'), hält ein Element der Gestaltung einer Überschrift in der Spalte, das in der Seitenspalte steht – eine an der Seite verankerte Kapitelziffer in der äußeren Randspalte eines Lehrbuchauftakts –, den Stapel der Seitenspalte von sich fern. Jede Abbildung, Tabelle oder jeder Kasten mit span: 'side', den die Seite nach der Überschrift setzt, hält einen Gleitobjektabstand zu jedem solchen Element frei: Er bleibt, wo der Stapel ihn hinsetzt, wenn er über dem Element passt, und geht sonst darunter – oder wartet auf die nächste Seite, wenn der Rest der Seitenspalte ihn dort nicht fassen kann. Eine Ziffer am Kopf des Kanals hält also den ganzen Stapel unter sich, während eine Abschnittsnummer, die neben einer weiter unten stehenden Überschrift im Rand hängt, den Kopf des Kanals den Abbildungen überlässt, die die Seite zitiert (die Randabbildung sitzt weiterhin oben auf ihrer Seite). Was die Seitenspalte schon enthält, wenn die Überschrift platziert wird, wird nicht bewegt: Eine früher auf der Seite gestapelte Abbildung, die bis zum Element der Überschrift hinabreicht, bleibt, wo sie ist, unter dem Element; eine Gestaltung, deren Element mitten auf der Seite in der Seitenspalte steht, braucht ihre Abbildungen also nach der Überschrift zitiert. Elemente mit reserve: false lassen die Seitenspalte frei, wie sie den Text freilassen. Ein Auftakt (span: 'page') braucht nichts dergleichen: Sein Band ist in jeder Spalte reserviert, die Seitenspalte eingeschlossen. Bis postext 1.4 wurde eine auf einem solchen Auftakt zitierte Seitenabbildung am Kopf der Seitenspalte über die Ziffer gesetzt.

Umschläge. Eine Umschlagüberschrift, die ihre Seite füllt – minHeight so hoch wie die Seite oder ein ganzseitiges Bild in ihrer Gestaltung –, schickt den Text danach daher von selbst auf die nächste Seite, in ein- wie mehrspaltigen Layouts. Ein :::pagebreak direkt danach ist optional und schadet nicht: Ein Seitenumbruch auf einer noch leeren Seite bewirkt nichts und fügt daher nie eine leere Seite hinzu. Er wird nur gebraucht, wenn die Gestaltung des Umschlags vor dem Seitenfuß aufhört und der Text dennoch auf einer neuen Seite beginnen soll.

# Annual report 2026 {style="cover"}
 
:::pagebreak
 
# Letter from the chair

#Ausgeschriebene Zahlen

Zwei Suffixe der Nummerierungsvorlage schreiben einen Zähler in Worten, in der Dokumentsprache (dem locale der obersten Ebene, sonst der Sprache der Silbentrennung – siehe Dokumentsprache): words für die Grundzahl und ordinal für die Ordnungszahl. Die Schreibung des Suffixes legt die Schreibung der Wörter fest, wie A / a es für Buchstaben tut:

Englisch, Spanisch, Chinesisch und Arabisch werden ausgeschrieben; jede andere Sprache erhält die englischen Wörter, wie bei den eingebauten Fortsetzungstexten von Tabellen. Chinesisch schreibt die informellen Zahlzeichen von simp-chinese-informal oder trad-chinese-informal, je nach Schrift von locale (一万 / 一萬), mit 第 vor einer Ordnungszahl; Han-Zeichen kennen keine Groß- und Kleinschreibung, daher drucken die drei Schreibungen eines Suffixes gleich. Englisch folgt dem amerikanischen Gebrauch (one hundred five, ohne and). Spanisch verwendet männliche Formen, wie ein capítulo oder ein libro nummeriert wird (capítulo primero, tercero, veintiuno), und schreibt die Ordnungszahlen von 13 bis 29 in einem Wort, wie es die RAE bevorzugt (decimotercero, vigesimoprimero). Grundzahlen werden bis 999 999 ausgeschrieben und spanische Ordnungszahlen bis 999; größere Zahlen erscheinen in Ziffern.

Arabische Zahlen richten sich im Genus nach dem gezählten Substantiv, daher nimmt das Suffix einen Modifikator an: -feminine (oder -f) für ein weibliches Substantiv, -masculine (-m, der Standard) für ein männliches; -classical schreibt die Hunderter مائة, wie es Bulaq und die meisten ägyptischen Drucke tun, statt des modernen مئة. {1:ordinal} schreibt die bestimmte Ordnungszahl im Nominativ, die eine Überschrift verwendet: الفصل {1:ordinal} ergibt الفصل الأول, الفصل الحادي عشر, الفصل الحادي والعشرون; الليلة {1:ordinal-feminine} ergibt الليلة الأولى, الليلة الحادية عشرة, الليلة الحادية والعشرون, الليلة المئتان und über hundert die klassische „Nach“-Formel: الليلة الخامسة والأربعون بعد الثلاثمئة, الليلة الحادية بعد الألف. {1:words} schreibt die Grundzahl (واحد وعشرون; weiblich إحدى عشرة, واحدة وعشرون). Ordnungszahlen werden bis 9 999 und Grundzahlen bis 99 999 ausgeschrieben; die Modifikatoren lassen sich kombinieren ({1:ordinal-f-classical}), und andere Sprachen ignorieren sie. Arabisch kennt keine Großbuchstaben, daher ändert die Schreibung des Suffixes nichts. Die Gestaltungsplatzhalter {numberWords} und {numberOrdinalWords} schreiben die männlichen Formen; für einen weiblichen Auftakt setzen Sie die Ordnungszahl in die Vorlage der Ebene und drucken sie mit {number}.

In einer Überschriftengestaltung schreiben {numberWords} / {numberWordsLower} und {numberOrdinalWords} / {numberOrdinalWordsLower} den Zähler der Überschrift auf dieselbe Weise aus, sodass der Auftakt Chapter One sagen kann, während das Inhaltsverzeichnis 1 aufführt. textTransform: 'uppercase' eines Textelements liefert die Versalien:

// Spanish novel: "CAPÍTULO PRIMERO" above the title, "1." in the contents.
{ level: 1, numberingTemplate: '{1}.', span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'n', content: 'Capítulo {numberOrdinalWordsLower}', textTransform: 'uppercase', /* … */ },
    { kind: 'text', id: 't', content: '{titleText}', /* … */ },
  ] } } }

#Aufzählungen

Die Eigenschaft unorderedLists steuert, wie Aufzählungen (-, *, +) und GFM-Aufgabenlisten (- [ ], - [x]) dargestellt werden. Bis zu fünf Verschachtelungsebenen werden unterstützt.

#Standardwerte für Aufzählungen

#Erweiterungen für Aufgabenlisten

GFM-Aufgabenpunkte (- [ ] …, - [x] …) werden als Punkte einer Aufzählung mit einem Kontrollkästchen anstelle des Aufzählungszeichens dargestellt. Die Engine zeichnet das Kästchen selbst, einen quadratischen Umriss mit einem Häkchen, wenn der Punkt erledigt ist: Dafür wird keine Schrift angefordert, es sieht also auf jedem Rechner gleich aus, auf dem Canvas, im PDF, im HTML und im EPUB, und assistive Technologien lesen ☐ oder ☑. Seine Seitenlänge beträgt 0,6 em der Größe des Zeichens (bulletFontSize oder fontSize der Ebene), und das ist der Raum, den es vor dem gap einnimmt; in Textgröße steht es auf der Grundlinie der ersten Zeile des Punkts. Seine Strichstärke folgt dem fontWeight des Zeichens und seine Farbe dessen color. Die folgenden Felder gelten nur für Aufgabenpunkte:

#Überschreibungen pro Ebene für Aufzählungen

Jeder Eintrag in levels gilt für eine Tiefe (1–5) und kann jede der folgenden Eigenschaften überschreiben:

Kaskade der Einzüge. Ebene 1 beginnt immer beim allgemeinen Wert indent (standardmäßig 0 em – die Aufzählungszeichen stehen an der Spaltenkante). Lassen Sie indent für die Ebenen 2–5 undefiniert, setzt die Engine das Aufzählungszeichen an den Textanfang der vorigen Ebene (Einzug der übergeordneten Ebene + Breite des Aufzählungszeichens + gap). Setzen Sie auf einer Ebene ein ausdrückliches indent, um die Kaskade zu unterbrechen und diese Tiefe an beliebiger Stelle festzulegen.

unorderedLists: {
  bulletChar: '—',
  gap: { value: 0.4, unit: 'em' },
  hangingIndent: true,
  levels: [
    { level: 2, bulletChar: '·' },
    { level: 3, bulletChar: '◦', color: { hex: '#666666', model: 'hex' } },
  ],
}

#Nummerierte Listen

Die Eigenschaft orderedLists steuert nummerierte Listen (1., 2) usw.). Bis zu fünf Verschachtelungsebenen werden unterstützt, und jede Tiefe kann ein anderes Zahlenformat verwenden.

#Standardwerte für nummerierte Listen

#Überschreibungen pro Ebene für nummerierte Listen

Jeder Eintrag in levels kann numberFormat, prefix, separator, fontFamily, fontSize, color, fontWeight, italic, indent, verticalOffset und den Stil des Trenners (separatorFontFamily, separatorFontWeight, separatorItalic, separatorColor, separatorGap) überschreiben – es gilt dieselbe Kaskade der Einzüge wie bei Aufzählungen. Der Trennerstil einer Ebene erbt den eigenen Nummernstil der Ebene, sofern keine listenweite Einstellung für den Trenner angegeben ist.

Rechtsbündige Ausrichtung. Die Pipeline misst die breiteste formatierte Nummer innerhalb einer Folge und rückt alle Punkte dieser Folge so ein, dass die Nummern an ihrer rechten Kante fluchten. In einer Liste mit zehn Punkten, gesetzt als 1. – 10., werden die einstelligen Nummern rechts aufgefüllt, sodass der Trenner in derselben Spalte bleibt.

orderedLists: {
  numberFormat: 'arabic',
  separator: '.',
  levels: [
    { level: 2, numberFormat: 'lower-alpha' },
    { level: 3, numberFormat: 'lower-roman', separator: ')' },
  ],
}

Das ergibt die klassische verschachtelte Mischung:

1. First item
   a. Sub-item
      i) Deep note
   b. Sub-item
2. Second item

Die Gliederung chinesischer Dokumente (GB/T 15834—2011, Anhang B.3) hat fünf Ebenen, 一、, dann （一）, dann 1., dann （1）, dann ①:

orderedLists: {
  levels: [
    { level: 1, numberFormat: 'simp-chinese-informal', separator: '、' },
    { level: 2, numberFormat: 'simp-chinese-informal', prefix: '（', separator: '）' },
    { level: 3, numberFormat: 'arabic', separator: '.' },
    { level: 4, numberFormat: 'arabic', prefix: '（', separator: '）' },
    { level: 5, numberFormat: 'circled-decimal', separator: '' },
  ],
}

#Mathematik

Die Eigenschaft math steuert, wie LaTeX-Formeln zwischen den Begrenzern $...$ (inline) und $$...$$ (abgesetzt) geparst und dargestellt werden. Die zugrunde liegende Engine ist MathJax (das Paket mathjax-full) im SVG-Ausgabemodus, auf dem Canvas gerastert und im PDF als skalierbare Glyphen eingebettet.

interface MathConfig {
  enabled?: boolean;        // Render LaTeX. When false, spans pass through as literal TeX.
  fontSizeScale?: number;   // × the surrounding text's size (the body size for display maths).
  color?: ColorValue;       // Formula colour; inherits body colour if omitted.
  marginTop?: Dimension;    // Space above display math blocks.
  marginBottom?: Dimension; // Minimum space below; baseline grid snap may enlarge it.
  indentAfterDisplay?: boolean; // Indent a paragraph that follows a display formula.
  keepWithLeadIn?: boolean; // Keep a display formula with the line that leads into it.
  equationNumbering?: {      // Number the display formulas that carry a \label.
    enabled?: boolean;           // default true
    numberingTemplate?: string;  // '{n}'; '{h1}.{n}' numbers by chapter
    resetOn?: ResourceCounterReset; // 'never' | 'h1' … 'h6'
    counterFormat?: ResourceCounterFormat; // 'decimal'
    format?: string;             // '({n})': what the formula and \eqref print
  };
}

math: {
  enabled: true,
  fontSizeScale: 1.0,
  color: { hex: '#295AA3', model: 'hex' },
  marginTop: { value: 1, unit: 'em' },
  marginBottom: { value: 1, unit: 'em' },
}

Formelgröße, geändert in postext 1.5. MathJax gibt den Rahmen einer Formel in ex an, und ein ex seiner TeX-Schrift misst 0,442 em. Bis postext 1.4 nahm die Engine ein halbes Geviert dafür an, sodass jede Formel etwa 13 % größer als bodyText.fontSize × fontSizeScale gesetzt wurde. Formeln erscheinen jetzt in der dokumentierten Größe, und Zeilen und Seiten mit Mathematik werden neu umbrochen. Eine für 1.4 im Code geschriebene Konfiguration behält die Formelgröße von 1.4, indem sie einmal, wie geschrieben, durch pinLegacyMathSize aus postext/bundle geschickt wird:

import { pinLegacyMathSize } from 'postext/bundle';
 
config = pinLegacyMathSize(config); // formulas, and the space around display formulas, as 1.4 set them

Auch andere Regeländerungen in 1.5 können ihre Seiten verschieben: die Umbrüche vor Überschriften, der Abstand um eine Inline-Abbildung (im laufenden Text und in Kästen), die Inline-Auszeichnungen ihrer Überschriften, die Größe ihrer Initialen, der Raum unter einer Doppelpunktzeile für die Liste, die sie einleitet, die Zeilen, die ein Kastenschnitt von einem Absatz oder Listenpunkt übrig lässt, die Zeilenumbrüche nach einem Strich, der Umbruch von Flattersatz, die Teilung eines Absatzes unter einer Überschrift, die Zeilenumbrüche nach dem Bindestrich eines Kompositums und der Abstand unter einem Container :::paragraphs. migrateConfig, einmal mit dem Markdown ausgeführt, das die Konfiguration setzt, fixiert diejenigen, die dieser Text braucht, die Formelgröße eingeschlossen (siehe Pakete, die postext 1.4 oder früher geschrieben hat):

import { migrateConfig } from 'postext/bundle';
 
config = migrateConfig(config, undefined, { content: markdown }); // heading breaks, formulas, inline gaps, heading marks, drop caps, colon lines, box cuts, dash breaks, compound breaks, ragged breaking, splits under a heading and container space as 1.4 set them

Das hält zurück, was diese Regeländerungen verschieben würden, bewahrt aber nicht jede Seite von 1.4. Version 1.5 behebt auch Layoutfehler, und eine Korrektur hat keine Fixierung: Eine alte Konfiguration erhält sie wie eine neue, sodass sich eine davon betroffene Seite dennoch verschieben kann. Darunter: Eine Überschrift über die ganze Seitenbreite ohne eigene Gestaltung wird über die Seite gemessen und im Zeilenabstand ihrer Ebene gesetzt; unter der Grundlinie einer Initiale in einer Überschriftengestaltung wird nichts reserviert; eine Initiale nimmt die Palettenfarbe des Abschnitts an und wird auch in einem Gestaltungstext gesetzt, dessen overflow nicht 'wrap' ist, der dann umbricht; ein Absatz in einem Kasten malt die Laufweite, mit der er gemessen wurde; ein geteilter Kasten behält seine Symbolspalte auf jedem Fragment; eine Kastenzeile, die ihre Leerzeichen über das 3-Fache dehnen würde, wird wie im laufenden Text im Flattersatz gesetzt; der Hebel für lockere Absätze setzt nie eine Blocksatzzeile breiter, als maxWordSpacing zulässt; ein gleitender Kasten behält ein marginBottom (in einem oberen Band) oder marginTop (in einem unteren Band), das breiter als der Gleitobjektabstand ist; ein zentrierter oder rechtsbündiger Gestaltungstext mit Laufweite (ein lebender Kolumnentitel, ein Auftakttitel) wird nach seinen Buchstaben platziert, ohne die Laufweite nach dem letzten; unter einem Auftakt über die ganze Seitenbreite beginnt der Text, der die zweite Spalte eröffnet, dort, wo Text direkt unter dem Auftakt beginnen würde, auch wenn eine Überschrift auf den Auftakt folgt; die Punkte des Inhaltsverzeichnisses enden vor der Seitenzahl in einer Schrift, die eine Folge von Punkten auseinanderkernt; ein lebender Kolumnentitel liest eine Überschrift wie geschrieben, ohne Leerzeichen, wo eine ihrer Zeilen nach einem Bindestrich oder einem Strich oder innerhalb eines aus Breitengründen geschnittenen Worts endet (MEDIOAMBIENTALES, nicht MEDIOAMBIENTALE S), und das {titleText} einer Überschriftengestaltung liest sie ebenso (thousand-colour, nicht thousand- colour); ein am Fuß oder an der Mitte des Bands einer Überschriftengestaltung verankerter Text hält das Band hoch genug, um ihn zu fassen, sodass er nicht mehr über den Text über der Überschrift steigt; ein Wort, das breiter als seine Zeile ist und neben einem eigenen Bindestrich geschnitten wird, wird nach diesem Bindestrich geschnitten und erhält keinen zweiten; der Punkt nach einer in einer anderen verschachtelten Liste nimmt das itemSpacing seiner eigenen Liste an, nicht das der verschachtelten; und der Rest eines Worts, das wegen Überbreite geschnitten wurde, behält seine eigenen Umbruchstellen, sodass eine Webadresse weiter an ihren Fugen umbricht und ein Kompositum an seinen Bindestrichen statt an den Silben des Wörterbuchs.

pinLegacyMathSize multipliziert den Faktor mit 1,1312 (0,5 ÷ 0,442) und teilt die Abstände abgesetzter Formeln in em durch denselben Faktor. Der Faktor allein reicht für ein Buch mit abgesetzten Formeln nicht: Ihre Abstände sind Längen in der eigenen Größe der Formel, sie würden also um dieselben 13 % wachsen und den Text darunter nach unten schieben. Für die Standardabstände ausgeschrieben, lauten die drei Werte:

math: {
  fontSizeScale: 1.131,
  marginTop: { value: 0.7072, unit: 'em' },
  marginBottom: { value: 0.7072, unit: 'em' },
} // formulas as large as 1.4 set them, with the space 1.4 left around them

Wo die Konfiguration gespeichert wurde, erkennt die Engine das und erledigt es für Sie: openBundle / readBundle für ein .postext-Paket, das vor 1.5 geschrieben wurde (siehe Pakete, die postext 1.4 oder früher geschrieben hat), und die Sandbox für die Bücher, die Arbeitskopie und die Dateien postext-config.json, die damals gespeichert wurden (siehe Sandbox → Persistenz). Sie werden durch migrateConfig gelesen, das die Größe fixiert (pinLegacyMathSize): fontSizeScale wird zum gespeicherten Faktor (1, wenn nicht gesetzt) × 1,1312, und ein Abstand abgesetzter Formeln in em oder rem – eine Länge in der eigenen Größe der Formel – wird durch denselben Faktor geteilt, sodass der Abstand um eine abgesetzte Formel bleibt, wie 1.4 ihn ließ (aus dem Standard 0,8 em werden 0,7072 em). Ein Abstand in einer Seiteneinheit (pt, mm …) bleibt, wie er ist, ebenso eine Konfiguration mit enabled: false oder eine, deren Buch kein $ enthält. Das alte Buch wird dann so gesetzt, wie 1.4 es setzte, und sein Abschnitt math zeigt die Größe, in der es gesetzt wird. Um ein solches Buch stattdessen in der heutigen Größe zu setzen, setzen Sie diese Werte zurück – Formeln → Größenfaktor, Abstand oben (abgesetzt) und Abstand unten (abgesetzt) in der Sandbox, oder im Code:

math: { ...config.math, fontSizeScale: 1, marginTop: undefined, marginBottom: undefined } // today's size and margins

Nummerierte Gleichungen. Eine abgesetzte Formel mit Nummer überspannt ihre Satzbreite (die Spalte oder die Innenbreite des Kastens, in dem sie steht): Die Gleichung wird zentriert und ihre Nummer rechtsbündig auf die Zeile der Gleichung gesetzt, auf jede nummerierte Zeile eines align. Eine Nummer kommt von einem \label{eq:x} (seit postext 1.19): Die beschrifteten Formeln und die beschrifteten Zeilen eines align, gather, alignat, flalign oder eqnarray werden in Lesereihenfolge mit equationNumbering nummeriert, sofern eine Zeile nicht \nonumber oder \notag sagt. Umgebungen wie equation werden nicht von selbst nummeriert: Eine Formel ohne Label hat keine Nummer. \tag{…} druckt die angegebene Bezeichnung in Klammern und \tag*{…} wie geschrieben; keine von beiden wird gezählt, und ein \label daneben benennt sie. Eine nummerierte Gleichung, die breiter als ihre Satzbreite ist, läuft wie jede abgesetzte Formel nach rechts über. (Bis postext 1.4 wurde eine Formel mit \tag gar nicht gezeichnet; bis 1.18 nummerierte nur \tag eine.)

\eqref{eq:x} im Text druckt die Nummer in ihrem format, (3), und \ref{eq:x} die bloße Nummer; ebenso :ref{id="eq:x"} und @eq:x (siehe Querverweise), und innerhalb einer Formel druckt \eqref sie als Text. In einem Kapitel für Kapitel gesetzten Buch läuft der Zähler ab dem vorigen Kapitel weiter: continuationAfter trägt ihn in LayoutContinuation.statementCounters (equation), und die Gliederung des Buchs gibt jedem Label seine Nummer (OutlineEntry.numberLabel), sodass ein Verweis auf eine Gleichung eines anderen Kapitels sie druckt.

math: {
  equationNumbering: { numberingTemplate: '{h1}.{n}', resetOn: 'h1' }, // (1.1), (1.2)… (2.1)
}

Resolver und Stripper entsprechen denen der anderen Abschnitte:

import {
  DEFAULT_MATH_CONFIG,
  resolveMathConfig,
  stripMathDefaults,
} from 'postext';
 
const resolved = resolveMathConfig(config.math);
const minimal  = stripMathDefaults(config.math);

#Die Mathematik-Engine starten

MathJax wird bei Bedarf geladen, nicht mit dem Rest der Engine. Setzen Sie im Hauptthread, starten Sie es, bevor Sie ein Dokument mit Formeln bauen:

import { buildDocument, initMathEngine, renderPage } from 'postext';
 
await initMathEngine(); // loads MathJax once; later calls resolve at once
const doc = buildDocument({ markdown: 'Euler: $e^{i\\pi}+1=0$.' }, config);
document.body.append(renderPage(doc.pages[0], doc));

• Bis die Engine läuft, sind Formeln Platzhalter. Jede wird als grauer Kasten in geschätzter Größe gesetzt. Wird ein Dokument mit Mathematik gesetzt, bevor initMathEngine() je aufgerufen wurde, zeigt die Konsole eine Warnung dazu.
• Der Layout-Worker startet sie für Sie. Ein Build in postext/worker ruft initMathEngine() selbst auf, wenn das Markdown ein $ enthält.
• Jetzt setzen, erneut, wenn sie bereit ist. isMathReady() sagt, ob die Engine läuft. onMathReady(fn) ruft fn auf, sobald sie es tut (sofort, wenn sie es schon tut), und gibt eine Funktion zurück, die den Aufruf abbricht. Ein Editor kann sofort Platzhalter zeigen und erneut setzen, wenn MathJax eintrifft; solange initMathEngine() läuft, wird keine Warnung ausgegeben.
• Fehlschlag. initMathEngine() wird abgelehnt, wenn MathJax nicht geladen werden kann, und ein späterer Aufruf versucht es erneut.
• Jeder Bundler, Node oder ein CDN. MathJax liegt dem Paket als ein vorgebündeltes Modul bei (etwa 1,8 MB vor der Kompression, nur von initMathEngine abgerufen). Das einfache import { initMathEngine } from 'https://esm.sh/postext' funktioniert; kein ?bundle nötig. Das Paket mathjax-full wird nur zum Bauen von postext gebraucht, die Installation von postext installiert es also nicht. MathJax und der mitgebündelte mhchem-Parser stehen unter der Apache-2.0-Lizenz: Ihre Hinweise und der Lizenztext liegen neben dem Modul, als dist/math/THIRD_PARTY_LICENSES.txt.
• Eine Engine pro Seite. Die Engine und ihr Cache gesetzter Formeln werden von allem geteilt, was postext im selben JavaScript-Realm importiert (siehe Globaler Zustand innerhalb einer Seite).

Die Grammatik auf der Dokumentseite ($...$, $$...$$, ein wörtliches Dollarzeichen maskieren) finden Sie unter Dokumentformat.