Kapitel 3 · Teil II · Das Handwerk

Konfiguration von Postext

Was eine Postext-Konfiguration ist und auf welcher der neun Seiten der Referenz jede Gruppe von Einstellungen erklärt wird

Aktualisiert 2026-10-102 minenescadefritptzhjaar

Kurz gesagt

Diese Seite eröffnet die Referenz aller Einstellungen, die das Aussehen Ihrer Seiten bestimmen. Eine einzige Gruppe von Einstellungen enthält alle Entscheidungen: Seitenformat, Spaltenzahl, Schriften, Schriftgröße, Überschriften, Kästen, Farben und mehr. Sie schreiben nur die Einstellungen auf, die Sie ändern wollen, denn jede beginnt mit einem sinnvollen Wert. Die Referenz ist auf neun Seiten verteilt. Die Liste auf dieser Seite verlinkt jeden Abschnitt, springen Sie also direkt zu dem Teil, den Sie brauchen.

Jede Layout-Entscheidung in Postext wird von einem einzigen Konfigurationsobjekt gesteuert.

PostextConfig legt die Seitenmaße, den Spaltenaufbau, die Typografie des Fließtexts, die Gestaltung der Überschriften, die Sprache des Dokuments (locale) und mehr fest. Jede Eigenschaft ist optional – Postext bringt sinnvolle Voreinstellungen mit, die sich an der klassischen Buchtypografie orientieren. Sie geben nur an, was Sie ändern wollen.

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt overrides the 8 pt default
  headings: { fontFamily: 'Open Sans' },
});

Einen Überblick darüber, wie die Engine diese Konfiguration verarbeitet, gibt die Seite Architektur.

#Übersicht

Die Referenz ist auf neun Seiten verteilt. Jede Gruppe unten ist eine Seite, gefolgt von den Abschnitten, die sie enthält.

Seite und Layout

Text und Überschriften

  • Fließtext – Typografie, Silbentrennung, Tabulatoren, Waisen und Witwen.
  • Dokumentsprache – das oberste locale: Rückfall für die Silbentrennung, eingebaute Ressourcentypen und die Fortsetzungstexte von Tabellen und geteilten Kästen, die Sprache, die in ein barrierefreies PDF eingetragen wird; die Ziffern (numerals) und die Schreibrichtung (direction), die daraus folgen; und die Sprachen und Schriftsysteme, die Postext setzt. Der Leitfaden für Bücher von rechts nach links ist Arabischer Satz.
  • Überschriften – gemeinsame Voreinstellungen und eigene Werte für H1–H6.
  • Aufzählungen und Nummerierte Listen – Aufzählungszeichen, Nummerierung, Verschachtelung.
  • Mathematik – LaTeX-Darstellung, Skalierung, Farbe, Ränder.

Anmerkungen und Verweise

  • Fußnoten – footnotes: wohin die mit [^id] zitierten Anmerkungen kommen, wie sie nummeriert werden und wie sie aussehen.
  • Zeilennummern – lineNumbers: die Nummer jeder fünften Vers- oder Textzeile im Rand; was gezählt wird, wo die Zählung neu beginnt, auf welcher Seite die Nummern stehen.
  • Querverweise – crossRefs: die Wörter, die um die Nummer oder die Seite eines :ref gedruckt werden, und seine Standardgestaltung.
  • Zitationen – citations: der Zitierstil und das Aussehen der Zitate und des Literaturverzeichnisses.
  • Inhaltsverzeichnis – was :::toc druckt: Typografie der Einträge, Füllzeichen, Seitenzahlen, Autorenzeilen, Zeilen für Teile.
  • Register – was :::index druckt: Typografie der Einträge, Einzüge, Trennzeichen und Bereiche der Seitenzahlen, Buchstabengruppen, Sortiersprache.

Ostasiatische Typografie

  • Ostasiatische Typografie – cjk: die regionalen Konventionen und der Zeilenumbruch von chinesischem, japanischem und koreanischem Text, wie ihre Zeilen im Blocksatz ausgetrieben werden, Breite und Überhang der Satzzeichen, der Abstand zwischen Han- und lateinischen Zeichen, das Zeichenraster, aufrechte Zahlen im vertikalen Text sowie Betonungszeichen, Ruby, Warichu-Anmerkungen und Kanbun-Zeichen. Die Leitfäden dazu sind Chinesischer Satz und Japanischer Satz.

Ressourcen und Tabellen

  • Ressourcentypen – typisierte Nummerierung für Abbildungen, Tabellen und eigene Arten.
  • Tabellenstil (mit benannten Tabellenstilen) und Legendenstil – Typografie und Ausstattung von Tabellenressourcen und ihren Legenden.
  • Diagrammstil – einfarbige Umfärbung eingebetteter SVG-Diagramme für den Druck mit Sonderfarben.
  • Videostil – videoStyle: das Abspielzeichen und der QR-Code, die über das Vorschaubild eines Videos gedruckt werden, und was seine Player im HTML-Betrachter und im EPUB bieten.

Stile und Teile

  • Absatzformate – benannte Formate für Container :::paragraphs: Literaturverzeichnisse, Glossare, Anmerkungen.
  • Chip-Stile – chipStyles: benannte Formate für das Inline-Element :chip[…]: der Kasten einer Wortbank, eine Taste, ein Schlagwort.
  • Code-Listings – codeStyle: Schrift, Kasten, Tabulatorbreite, lange Zeilen, Zeilennummern und Token-Farben von Listings mit ```, die Syntaxhervorhebung mit ihrem Highlighter-Hook und Inline-Code in einer Codeschrift.
  • Kastenstile – umrahmte Hinweise, Tipps und Lernziele für Container :::callout.
  • Teile – Teiltitelseiten für Container :::part: Seitenparität, Textbereich, Gestaltung des Auftakts, Typografie des Texts.
  • Überschriftenstile – benannte Formate für Überschriften mit {style="…"}: unnummerierte Kapitel, Titelei mit eigenen Kolumnentiteln, Geometrie und Farbpalette.

Comic-Einstellungen

  • Comics – comics: Rahmen und Zwischenräume von Comicseiten, Panelstile, Lettering, Sprechblasenstile und die Figuren. Der Leitfaden ist Comics.

Schriften, Farben und Ausgabe

  • Einheiten und Farben + Farbpalette – Dimension, ColorValue, benannte Farben.
  • Eigene Schriften – vom Benutzer hochgeladene Schriftfamilien neben Google Fonts deklarieren.
  • HTML-Betrachter – Zielbreite der Spalte und Zeilenumbruch für das HTML-Backend.
  • PDF-Erzeugung (Konfiguration) – Lesezeichen, barrierefreie (getaggte) Ausgabe, erzwungener Farbraum für das PDF-Backend.
  • Druckvorstufe (Konfiguration) – print: PDF/X-1a und PDF/X-4, die ICC-Ausgabeprofile, Schwarz (Grautöne nur in K, Überdrucken, Tiefschwarz), in CMYK angelegte Farben, der Preflight und die Druckvorschau.
  • Kontrastprüfung (Konfiguration) – contrast: Text gegen seinen Untergrund nach WCAG AA oder AAA, am Bildschirm und auf dem Papier des Ausgabeprofils, sowie negativer Text, der für die Druckmaschine zu fein ist.
  • Folio-Betrachter (Konfiguration) – Papiersorte, Bindung, Oberfläche und Licht des 3D-Buchbetrachters.
  • Debug – visuelle Überlagerungen und Warnungen beim Schreiben für den Editor.

Programmatische Nutzung