Kurz gesagt
Die Kapitel des Buchs stehen in einer breiten Spalte. Ab den Anhängen läuft der Text in zwei Spalten kleinerer Schrift, ein Anhang in drei. Seitenformat und Sprache des Buchs bleiben überall gleich.
Was Sie setzen
Ein kleines Handbuch für Apfelbauern in einem kalten Tal, im Format 150 × 220 mm, geschrieben als sechs Markdown-Dokumente und als ein Buch gesetzt. Die beiden Kapitel von Teil I stehen in einer Spalte im Blocksatz aus der Source Serif 4. Teil II, die Anhänge, wechselt die Gestaltung: eine Tabelle der Unterlagen und ein Kalender Monat für Monat in zwei Spalten im Flattersatz und kleinerem Schriftgrad, Stoff, den man im Schuppen liest, das Buch aufgeschlagen auf der Werkbank, und eine Sortenliste in drei Spalten einer serifenlosen Schrift. Das Nachwort kehrt ohne Teiltitelseite zur Gestaltung des Buchs zurück. Format, Ränder, Silbentrennung und Sprache sind auf jeder Seite dieselben.
Dieses Rezept beantwortet
- Wie setze ich den Anhang eines Buches oder einen seiner Teile anders, etwa zweispaltig in kleinerer Schrift?
- Wie gliedere ich ein Buch in Teile oder Abschnitte, jeweils mit eigener Farbe und Teiltitelseite?
Die kurze Antwort
const smallOpener = { minHeight: mm(24), slot: { elements: [{ id: 'title', fontSize: pt(16) }] } };
// In the Markdown: :::part{number="II" title="Appendices" style="appendix"} sets every
// chapter from there to the next part; a chapter's own chapterStyle: reference wins.
const chapterStyles = [
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
layout: { layoutType: 'double', gutterWidth: mm(6) },
bodyText: { fontSize: pt(8.8), lineHeight: pt(11.6), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(4) },
// Lists merge entry by entry on their id or level: only what is named here changes.
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
{ id: 'reference', name: t({ en: 'Reference list', es: 'Lista de consulta' }), config: {
layout: { layoutType: 'multiple', columnCount: 3, gutterWidth: mm(4.5) },
bodyText: { fontFamily: SANS, fontSize: pt(7.8), lineHeight: pt(10.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(3.5), boldColor: col('accent') },
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
];
// The trim, the language and the fonts stay the book's: a style that sets page.width or
// locale is ignored there, with a chapterStyleBookSetting warning.
Zutaten
- Funktionen
- KapitelstileTeiltitelseitenKapitel für Kapitel gebaute BücherEine oder zwei SpaltenDrei oder mehr SpaltenGestaltete AuftakteKolumnentitel und SeitenzahlenKolumnentitel je AbschnittKopfzeilen nach SeitenrolleGespiegelte RänderText, Linien und Kästen in SeitengestaltungenWitwen, Waisen und kurze AusgangszeilenSemantische Farbpalette
- Schrift
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Dateien
- Keine: Jedes Bild wird im Code gezeichnet
Zubereitung
#1 · Ein Stil enthält nur, was sich ändert
Der Code steht oben in der kurzen Antwort. Ein Kapitelstil hat eine id, einen Namen für die Sandbox und eine config, die wie eine Sprachebene über die Einstellungen des Buchs gelegt wird. Objekte werden Schlüssel für Schlüssel zusammengeführt, Listen Eintrag für Eintrag über ihre id oder ihr level. So benennt smallOpener ein einzelnes Element des Kapitelauftakts, den Titel, und gibt ihm einen kleineren Grad; die Linie darunter und alles andere bleiben, wie das Buch sie festlegt. Der Anhangstil legt zwei Spalten fest, einen kleineren Grundschriftgrad, Flattersatz und Abstand zwischen den Einträgen, sonst nichts.
Manche Einstellungen gelten für das ganze Buch: Format, Auflösung und Bindung unter page, Sprache und Schreibrichtung, Ziffern, Schriften, Druck- und PDF-Ausgabe. Setzt ein Stil eine davon, wird sie dort ignoriert und löst eine Warnung chapterStyleBookSetting aus. Die Anhänge behalten daher das Format von 150 mm und die britisch-englische Silbentrennung der Kapitel.
#2 · Der Teil nennt den Stil
// Only the first document's front matter is the book's; a later one keeps its chapterStyle.
const chapters = [front, rootstocks, appendices, calendar, varieties, afterword]
.map((markdown) => ({ markdown }));
Das dritte Dokument beginnt mit :::part{number="II" title="Appendices" style="appendix"}, und jedes Kapitel von dort bis zum nächsten Teil wird im Anhangstil gesetzt. Das fünfte nennt in seinem Front Matter einen eigenen Stil, chapterStyle: "reference", der Vorrang vor dem des Teils hat. In einem Buch gehört nur das Front Matter des ersten Dokuments zum Buch; ein späteres behält nur seine Zeile chapterStyle:.

#3 · Eine Teiltitelseite, und ein Teil ohne
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(width && { size: { width: mm(width), height: 'auto' } }) });
const parts = {
breakBefore: { parity: 'any' }, // the book is short: a part opens on the next page
design: { elements: [ // the container is the trim: the margins are measured from its edges
{ kind: 'box', id: 'band', style: { backgroundColor: col('leaf') },
placement: { ...at('page', 'top-left', 0, 0), size: { width: 'fill', height: mm(96) } } },
text('number', '{number}', SERIF, 40, { fontWeight: 600, color: col('paper'),
placement: at('page', 'top-left', MARGIN.inner, 46, MEASURE) }),
text('title', '{titleText}', SERIF, 24, { fontWeight: 600, color: col('paper'),
placement: at('#number', 'below', 0, 2, MEASURE) }),
] },
};
Jeder :::part öffnet eine Teiltitelseite mit Nummer und Titel des Teils auf einem grünen Band. Das Nachwort beginnt mit :::part{title="Afterword" page=false}: Es wird keine Teiltitelseite gedruckt, und da der Teil keinen Stil nennt, wird sein Kapitel wieder mit den Einstellungen des Buchs gesetzt. Ein Teil mit page=false eignet sich für Schlussteile, die ohne Einschnitt auf die Anhänge folgen.

#4 · Ein Kapitelauftakt in zwei Größen
const opener = { enabled: true, minHeight: mm(40), slot: { elements: [
text('title', '{titleText}', SERIF, 22, { fontWeight: 600, lineHeight: 1.12,
placement: at('container', 'top-left', 0, 8, MEASURE - 10) }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5), color: col('accent'),
placement: { ...at('#title', 'below', 0, 4), size: { width: mm(14) } } },
] } };
Der Auftakt reicht über die ganze Seitenbreite. In den Anhängen läuft er deshalb über beide Spalten, und der Text beginnt darunter zweispaltig. Der Anhang- und der Referenzstil verkleinern über die id des Elements den Titel auf 16 pt und die Absenkung auf 24 mm: Der Stoff am Ende des Buchs braucht weniger Platz, und seine Titel bleiben deutlich größer als der Text.
#5 · Kolumnentitel aus dem Buch
const head = (id, content, parity, edge, x, extra = {}) => text(id, content, SANS, 7.5, {
parity, pages: 'body', fontWeight: 600, letterSpacing: pt(1.2), textTransform: 'uppercase',
color: col('muted'), overflow: 'clip', placement: at('page', edge, x, 12, 90), ...extra });
const folio = { fontWeight: 700, color: col('ink') };
const right = { align: 'right' };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', MARGIN.outer, folio),
head('verso-title', '{title}', 'even', 'top-left', MARGIN.outer + 9), // the book's title
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(MARGIN.outer + 9), right),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -MARGIN.outer, { ...folio, ...right }),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom', 0, {
...folio, align: 'center', pages: 'opener', placement: at('page', 'bottom', 0, -14, 20) })] };
Der Buchtitel steht auf der linken Seite, der Kapiteltitel auf der rechten. Kein Stil ändert sie, also sehen die Kolumnentitel in allen Teilen des Buchs gleich aus.
Das ganze Rezept
// ═══ Postext Cookbook · Nº 187 · Appendices in two columns ═══════════════════════════════
// https://postext.dev/en/cookbook/appendices-in-two-columns
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Source Sans 3 (SIL OFL 1.1) · Needs postext ≥ 1.79.0
// A growers' handbook in six Markdown documents: the chapters in one column, the appendices
// in two columns of smaller type, one appendix in three, and an afterword back in one.
import {
buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'appendices-in-two-columns';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: russet for the accent, leaf green for the part pages
const palette = { ink: '#211f1b', accent: '#8e3b24', leaf: '#46603a', muted: '#6c665c',
rule: '#cfc6b6', paper: '#fffdf8' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS] = ['Source Serif 4', 'Source Sans 3'];
const TRIM = { width: 150, height: 220 }; // mm, a handbook for the shed shelf
const MARGIN = { top: 22, bottom: 24, inner: 19, outer: 15 }; // mirrored
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 116 mm
const LEAD = 14; // pt, the book's leading
// #region answer: two chapter styles; a part names one, a chapter names the other
const smallOpener = { minHeight: mm(24), slot: { elements: [{ id: 'title', fontSize: pt(16) }] } };
// In the Markdown: :::part{number="II" title="Appendices" style="appendix"} sets every
// chapter from there to the next part; a chapter's own chapterStyle: reference wins.
const chapterStyles = [
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
layout: { layoutType: 'double', gutterWidth: mm(6) },
bodyText: { fontSize: pt(8.8), lineHeight: pt(11.6), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(4) },
// Lists merge entry by entry on their id or level: only what is named here changes.
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
{ id: 'reference', name: t({ en: 'Reference list', es: 'Lista de consulta' }), config: {
layout: { layoutType: 'multiple', columnCount: 3, gutterWidth: mm(4.5) },
bodyText: { fontFamily: SANS, fontSize: pt(7.8), lineHeight: pt(10.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(3.5), boldColor: col('accent') },
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
];
// The trim, the language and the fonts stay the book's: a style that sets page.width or
// locale is ignored there, with a chapterStyleBookSetting warning.
Das zusammengesetzte script.js läuft unverändert: Fügen Sie es in das Modulskript einer beliebigen Seite ein, oder öffnen Sie das Rezept auf CodePen. Ordner des Rezepts auf GitHub ↗ (öffnet sich in einem neuen Tab)
Varianten
#Einen Stil nach einer Einstellung des ganzen Buchs fragen
Ein Stil, der Format oder Sprache festlegt, wird für diese Schlüssel ignoriert. Der Satz meldet für jeden eine Warnung chapterStyleBookSetting, und die Anhänge behalten das Format des Buchs.
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+ page: { width: mm(170) }, locale: 'fr',
layout: { layoutType: 'double', gutterWidth: mm(6) },#Die Gestaltung in einem anderen Buch verwenden
Das Kommandozeilenwerkzeug schreibt die Gestaltung eines Buchs samt Kapitelstilen in eine Gestaltungsdatei und setzt mit --design ein anderes Buch darin. Siehe den Befehl design.
postext design apples.postext -o handbook.postext
postext pdf pears/ --design handbook.postext -o pears.pdfHäufige Fehler
- Die Zeile
:::partmuss das Kapitel eröffnen, vor seiner Überschrift. Eine Teilzeile, die nach dem Beginn des Kapiteltexts steht, löstpartStyleMidChapteraus, und der Stil gilt erst ab dem nächsten Kapitel. - Ein Stilname, den
chapterStylesnicht enthält, löstchapterStyleUnknownaus, und dieses Kapitel wird mit den Einstellungen des Buchs gesetzt.
Nachweise
- Rezept
- Ignacio Ferro
- Text
- Eigener Text, CC BY 4.0
- Schriften
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
- Code
- MIT, wie Postext
Diesen Text bearbeiten ↗ (öffnet sich in einem neuen Tab)Ordner des Rezepts auf GitHub ↗ (öffnet sich in einem neuen Tab)


