In breve
I capitoli del libro sono composti su una colonna larga. Dalle appendici in poi il testo scorre su due colonne di carattere più piccolo, e un’appendice su tre. Il formato della pagina e la lingua del libro non cambiano mai.
Che cosa comporrai
Un piccolo manuale per chi coltiva meli in una valle fredda, di 150 × 220 mm, scritto in sei documenti Markdown e impaginato come un solo libro. I due capitoli della parte I sono composti su una colonna giustificata in Source Serif 4. La parte II, le appendici, cambia progetto grafico: una tabella dei portinnesti e un calendario mese per mese su due colonne in bandiera e in corpo minore, materia che si legge nel capanno con il libro aperto sul banco da lavoro, e un elenco di varietà su tre colonne in un carattere senza grazie. La postfazione torna al progetto del libro senza pagina di parte. Formato, margini, sillabazione e lingua sono gli stessi in ogni pagina.
Questa ricetta risponde a
- Come compongo le appendici di un libro, o una delle sue parti, con un’altra impaginazione, per esempio su due colonne in corpo minore?
- Come divido un libro in parti o sezioni, ognuna con il suo colore e la sua pagina di parte?
La risposta breve
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.
Ingredienti
- Funzionalità
- Stili dei capitoliPagine di parteLibri costruiti capitolo per capitoloUna o due colonneTre o più colonneAperture progettateTestatine e folioTestatine per sezioneTestatine secondo il ruolo della paginaMargini speculariTesto, filetti e riquadri nei progetti di paginaVedove, orfane e righe corteTavolozza di colori semantica
- Tipo
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Risorse
- Nessuna: ogni immagine è disegnata nel codice
Preparazione
#1 · Uno stile contiene solo ciò che cambia
Il codice è la risposta breve qui sopra. Uno stile di capitolo ha un id, un nome per il Sandbox e un config che si fonde con le impostazioni del libro come fa il livello di una lingua. Gli oggetti si fondono chiave per chiave e le liste voce per voce, in base al loro id o level: così smallOpener nomina un solo elemento dell’apertura, il titolo, e gli dà un corpo più piccolo; il filetto sotto e tutto il resto restano come li ha il libro. Lo stile di appendice fissa due colonne, un corpo del testo più piccolo, righe in bandiera e spazio tra le voci, e nient’altro.
Alcune impostazioni appartengono al libro intero: formato, risoluzione e legatura di page, lingua e direzione di scrittura, cifre, font, stampa e PDF. Uno stile che ne fissa una viene ignorato su quel punto e solleva un avviso chapterStyleBookSetting: le appendici mantengono così il formato di 150 mm e la sillabazione in inglese britannico dei capitoli.
#2 · La parte nomina lo stile
// 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 }));
Il terzo documento si apre con :::part{number="II" title="Appendices" style="appendix"}, e ogni capitolo da lì fino alla parte successiva è composto nello stile di appendice. Il quinto nomina un proprio stile nel suo front matter, chapterStyle: "reference", che prevale su quello della parte. In un libro solo il front matter del primo documento vale per il libro; uno successivo conserva soltanto la riga chapterStyle:.

#3 · Una pagina di parte, e una parte senza
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) }),
] },
};
Ogni :::part apre una pagina di parte con il numero e il titolo della parte su una banda verde. La postfazione si apre con :::part{title="Afterword" page=false}: non viene stampata nessuna pagina di parte e, poiché la parte non nomina uno stile, il suo capitolo torna a essere composto con le impostazioni del libro. Una parte con page=false si presta alle pagine finali che seguono le appendici senza stacco.

#4 · Un’apertura in due misure
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) } } },
] } };
L’apertura occupa tutta la larghezza della pagina, quindi nelle appendici passa sopra le due colonne e il testo comincia sotto, su due. Gli stili di appendice e di consultazione riducono il titolo a 16 pt e l’abbassamento a 24 mm tramite l’id dell’elemento: la materia in fondo al libro occupa meno spazio, e i suoi titoli restano ben più grandi del testo.
#5 · Testatine dal libro
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) })] };
Il titolo del libro va sul verso e quello del capitolo sul recto. Nessuno stile le cambia, quindi le testatine sono uguali in ogni parte del libro.
La ricetta completa
// ═══ 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.
Lo script.js composto funziona così com’è: incollalo nello script modulo di qualsiasi pagina, oppure apri la ricetta su CodePen. Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)
Varianti
#Chiedere a uno stile un’impostazione del libro
Uno stile che fissa il formato o la lingua viene ignorato per quelle chiavi. La composizione solleva un avviso chapterStyleBookSetting per ciascuna, e le appendici mantengono il formato del libro.
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+ page: { width: mm(170) }, locale: 'fr',
layout: { layoutType: 'double', gutterWidth: mm(6) },#Riusare il progetto grafico in un altro libro
Lo strumento a riga di comando scrive il progetto grafico di un libro, stili di capitolo compresi, in un file di progetto, e con --design compone un altro libro secondo quel progetto. Vedi il comando design.
postext design apples.postext -o handbook.postext
postext pdf pears/ --design handbook.postext -o pears.pdfErrori frequenti
- La riga
:::partdeve aprire il capitolo, prima del suo titolo. Una riga di parte messa dopo l’inizio del testo del capitolo sollevapartStyleMidChapter, e lo stile parte dal capitolo successivo. - Un nome di stile che
chapterStylesnon contiene sollevachapterStyleUnknown, e quel capitolo è composto con le impostazioni del libro.
Crediti
- Ricetta
- Ignacio Ferro
- Testo
- Testo originale, CC BY 4.0
- Font
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
- Codice
- MIT, come Postext
Modifica questo testo ↗ (si apre in una nuova scheda)Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)


