# Konfiguration von Postext

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

- HTML-Fassung: https://postext.dev/de/docs/configuration
- Zuletzt aktualisiert: 2026-10-10
- Lesezeit: 2 min
- Andere Sprachen: [en](https://postext.dev/en/docs/configuration.md), [es](https://postext.dev/es/docs/configuration.md), [ca](https://postext.dev/ca/docs/configuration.md), [fr](https://postext.dev/fr/docs/configuration.md), [it](https://postext.dev/it/docs/configuration.md), [pt](https://postext.dev/pt/docs/configuration.md), [zh](https://postext.dev/zh/docs/configuration.md), [ja](https://postext.dev/ja/docs/configuration.md), [ar](https://postext.dev/ar/docs/configuration.md)

## 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.

```ts
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](https://postext.dev/de/docs/architecture.md).

## Ü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](https://postext.dev/de/docs/configuration-page-layout.md)**

- [Seite](https://postext.dev/de/docs/configuration-page-layout.md#seite) – Format, Ränder, Grundlinienraster, Schnittmarken, [Bindung](https://postext.dev/de/docs/configuration-page-layout.md#bindung).
- [Layout](https://postext.dev/de/docs/configuration-page-layout.md#layout) – Spaltenzahl, Spaltenabstände, Linien, [vertikale Schrift](https://postext.dev/de/docs/configuration-page-layout.md#vertikale-schrift).
- [Kopf- und Fußzeilen](https://postext.dev/de/docs/configuration-page-layout.md#kopf--und-fußzeilen) – Text- und Linienelemente je Seite mit Platzhaltern, Seitenparität und Ausrichtung.

**[Text und Überschriften](https://postext.dev/de/docs/configuration-text.md)**

- [Fließtext](https://postext.dev/de/docs/configuration-text.md#fließtext) – Typografie, Silbentrennung, Tabulatoren, Waisen und Witwen.
- [Dokumentsprache](https://postext.dev/de/docs/configuration-text.md#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](https://postext.dev/de/docs/configuration-text.md#ziffern-des-dokuments) (`numerals`) und die [Schreibrichtung](https://postext.dev/de/docs/configuration-text.md#schreibrichtung) (`direction`), die daraus folgen; und die [Sprachen und Schriftsysteme](https://postext.dev/de/docs/configuration-text.md#sprachen-und-schriftsysteme), die Postext setzt. Der Leitfaden für Bücher von rechts nach links ist [Arabischer Satz](https://postext.dev/de/docs/arabic-layout.md).
- [Überschriften](https://postext.dev/de/docs/configuration-text.md#überschriften) – gemeinsame Voreinstellungen und eigene Werte für H1–H6.
- [Aufzählungen](https://postext.dev/de/docs/configuration-text.md#aufzählungen) und [Nummerierte Listen](https://postext.dev/de/docs/configuration-text.md#nummerierte-listen) – Aufzählungszeichen, Nummerierung, Verschachtelung.
- [Mathematik](https://postext.dev/de/docs/configuration-text.md#mathematik) – LaTeX-Darstellung, Skalierung, Farbe, Ränder.

**[Anmerkungen und Verweise](https://postext.dev/de/docs/configuration-notes-references.md)**

- [Fußnoten](https://postext.dev/de/docs/configuration-notes-references.md#fußnoten) – `footnotes`: wohin die mit `[^id]` zitierten Anmerkungen kommen, wie sie nummeriert werden und wie sie aussehen.
- [Zeilennummern](https://postext.dev/de/docs/configuration-notes-references.md#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](https://postext.dev/de/docs/configuration-notes-references.md#querverweise) – `crossRefs`: die Wörter, die um die Nummer oder die Seite eines `:ref` gedruckt werden, und seine Standardgestaltung.
- [Zitationen](https://postext.dev/de/docs/configuration-notes-references.md#zitationen) – `citations`: der Zitierstil und das Aussehen der Zitate und des Literaturverzeichnisses.
- [Inhaltsverzeichnis](https://postext.dev/de/docs/configuration-notes-references.md#inhaltsverzeichnis) – was `:::toc` druckt: Typografie der Einträge, Füllzeichen, Seitenzahlen, Autorenzeilen, Zeilen für Teile.
- [Register](https://postext.dev/de/docs/configuration-notes-references.md#register) – was `:::index` druckt: Typografie der Einträge, Einzüge, Trennzeichen und Bereiche der Seitenzahlen, Buchstabengruppen, Sortiersprache.

**[Ostasiatische Typografie](https://postext.dev/de/docs/configuration-east-asian.md)**

- [Ostasiatische Typografie](https://postext.dev/de/docs/configuration-east-asian.md#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](https://postext.dev/de/docs/chinese-layout.md) und [Japanischer Satz](https://postext.dev/de/docs/japanese-layout.md).

**[Ressourcen und Tabellen](https://postext.dev/de/docs/configuration-resources.md)**

- [Ressourcentypen](https://postext.dev/de/docs/configuration-resources.md#ressourcentypen) – typisierte Nummerierung für Abbildungen, Tabellen und eigene Arten.
- [Tabellenstil](https://postext.dev/de/docs/configuration-resources.md#tabellenstil) (mit [benannten Tabellenstilen](https://postext.dev/de/docs/configuration-resources.md#benannte-tabellenstile)) und [Legendenstil](https://postext.dev/de/docs/configuration-resources.md#legendenstil) – Typografie und Ausstattung von Tabellenressourcen und ihren Legenden.
- [Diagrammstil](https://postext.dev/de/docs/configuration-resources.md#diagrammstil) – einfarbige Umfärbung eingebetteter SVG-Diagramme für den Druck mit Sonderfarben.
- [Videostil](https://postext.dev/de/docs/configuration-resources.md#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](https://postext.dev/de/docs/configuration-styles.md)**

- [Absatzformate](https://postext.dev/de/docs/configuration-styles.md#absatzformate) – benannte Formate für Container `:::paragraphs`: Literaturverzeichnisse, Glossare, Anmerkungen.
- [Chip-Stile](https://postext.dev/de/docs/configuration-styles.md#chip-stile) – `chipStyles`: benannte Formate für das Inline-Element `:chip[…]`: der Kasten einer Wortbank, eine Taste, ein Schlagwort.
- [Code-Listings](https://postext.dev/de/docs/configuration-styles.md#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](https://postext.dev/de/docs/configuration-styles.md#kastenstile) – umrahmte Hinweise, Tipps und Lernziele für Container `:::callout`.
- [Teile](https://postext.dev/de/docs/configuration-styles.md#teile) – Teiltitelseiten für Container `:::part`: Seitenparität, Textbereich, Gestaltung des Auftakts, Typografie des Texts.
- [Überschriftenstile](https://postext.dev/de/docs/configuration-styles.md#überschriftenstile) – benannte Formate für Überschriften mit `{style="…"}`: unnummerierte Kapitel, Titelei mit eigenen Kolumnentiteln, Geometrie und Farbpalette.

**[Comic-Einstellungen](https://postext.dev/de/docs/configuration-comics.md)**

- [Comics](https://postext.dev/de/docs/configuration-comics.md#comics) – `comics`: Rahmen und Zwischenräume von Comicseiten, Panelstile, Lettering, Sprechblasenstile und die Figuren. Der Leitfaden ist [Comics](https://postext.dev/de/docs/comics.md).

**[Schriften, Farben und Ausgabe](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md)**

- [Einheiten und Farben](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#einheiten-und-farben) + [Farbpalette](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#farbpalette) – `Dimension`, `ColorValue`, benannte Farben.
- [Eigene Schriften](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#eigene-schriften) – vom Benutzer hochgeladene Schriftfamilien neben Google Fonts deklarieren.
- [HTML-Betrachter](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#html-betrachter) – Zielbreite der Spalte und Zeilenumbruch für das HTML-Backend.
- [PDF-Erzeugung (Konfiguration)](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#pdf-erzeugung-konfiguration) – Lesezeichen, barrierefreie (getaggte) Ausgabe, erzwungener Farbraum für das PDF-Backend.
- [Druckvorstufe (Konfiguration)](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#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)](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#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)](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#folio-betrachter-konfiguration) – Papiersorte, Bindung, Oberfläche und Licht des 3D-Buchbetrachters.
- [Debug](https://postext.dev/de/docs/configuration-fonts-colors-viewers.md#debug) – visuelle Überlagerungen und Warnungen beim Schreiben für den Editor.

**[Programmatische Nutzung](https://postext.dev/de/docs/configuration-programmatic-usage.md)**

- [Programmatische Nutzung](https://postext.dev/de/docs/configuration-programmatic-usage.md#programmatische-nutzung) – `buildDocument`, die Warnungen, die es meldet, Resolver, Caches.
- [Layout in einem Web Worker ausführen](https://postext.dev/de/docs/configuration-programmatic-usage.md#layout-in-einem-web-worker-ausführen) – Builds außerhalb des Hauptthreads mit Abbruch.
- [Den HTML-Betrachter einbinden](https://postext.dev/de/docs/configuration-programmatic-usage.md#den-html-betrachter-einbinden) und [PDFs erzeugen](https://postext.dev/de/docs/configuration-programmatic-usage.md#pdfs-erzeugen) – Anleitungen von Anfang bis Ende.
- [Ein 3D-Buch (`postext-folio`)](https://postext.dev/de/docs/configuration-programmatic-usage.md#ein-3d-buch-postext-folio) – das gesetzte Dokument als gedrucktes Buch, das aufgeschlagen auf einem Tisch liegt, mit Blättern, die der Leser umblättert.
- [EPUB-Bücher](https://postext.dev/de/docs/configuration-programmatic-usage.md#epub-bücher-postext-epub) – EPUB-3-Dateien mit festem Layout und umfließend aus demselben Layout, und ihre Prüfung mit EPUBCheck.
- [Pakete (Dateien im Format `.postext`)](https://postext.dev/de/docs/configuration-programmatic-usage.md#pakete-dateien-im-format-postext) – ein ganzes Buch in einer Datei: `.postext`-Archive aus Code erstellen, öffnen und bauen.