En bref
Les chapitres du livre sont composés sur une large colonne. À partir des annexes, le texte passe sur deux colonnes en plus petits caractères, et une annexe sur trois. Le format et la langue du livre ne changent jamais.
Ce que vous allez composer
Un petit manuel pour les arboriculteurs d’une vallée froide, au format 150 × 220 mm, écrit en six documents Markdown et mis en pages comme un seul livre. Les deux chapitres de la partie I sont composés sur une colonne justifiée en Source Serif 4. La partie II, les annexes, change de maquette : un tableau des porte-greffes et un calendrier mois par mois sur deux colonnes en drapeau et en petit corps, de quoi lire dans la remise, le livre ouvert sur l’établi, puis une liste des variétés sur trois colonnes en linéale. La postface revient à la maquette du livre sans page de partie. Le format, les marges, la césure et la langue sont les mêmes sur toutes les pages.
Cette recette répond à
- Comment composer les annexes d’un livre, ou l’une de ses parties, dans une autre maquette, par exemple sur deux colonnes en corps plus petit ?
- Comment diviser un livre en parties ou en sections, chacune avec sa couleur et sa page de partie ?
La réponse courte
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.
Ingrédients
- Fonctionnalités
- Styles de chapitrePages de partieLivres construits chapitre par chapitreUne ou deux colonnesTrois colonnes ou plusOuvertures composéesTitres courants et foliosTitres courants par sectionTitres courants selon le rôle de la pageMarges en miroirTexte, filets et boîtes dans les maquettes de pageVeuves, orphelines et fins de paragraphe trop courtesPalette de couleurs sémantique
- Typographie
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Ressources
- Aucune : chaque image est dessinée en code
Préparation
#1 · Un style ne contient que ce qui change
Le code est la réponse courte ci-dessus. Un style de chapitre a un identifiant, un nom pour le Sandbox et un config fusionné avec les réglages du livre, comme l’est une couche de langue. Les objets fusionnent clé par clé et les listes entrée par entrée, sur leur id ou leur level : smallOpener désigne donc un seul élément de l’ouverture, le titre, et lui donne un corps plus petit ; le filet qui le suit et tout le reste restent tels que le livre les définit. Le style d’annexe fixe deux colonnes, un corps de texte plus petit, des lignes en drapeau et un espace entre les entrées, rien de plus.
Certains réglages appartiennent au livre entier : le format, la résolution et la reliure de page, la langue et le sens d’écriture, les chiffres, les polices, l’impression et le PDF. Un style qui en fixe un est ignoré sur ce point et déclenche un avertissement chapterStyleBookSetting : les annexes gardent ainsi le format de 150 mm et la césure en anglais britannique des chapitres.
#2 · La partie nomme le style
// 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 }));
Le troisième document commence par :::part{number="II" title="Appendices" style="appendix"}, et chaque chapitre, de celui-ci jusqu’à la partie suivante, est composé dans le style d’annexe. Le cinquième nomme son propre style dans son front matter, chapterStyle: "reference", qui l’emporte sur celui de la partie. Dans un livre, seul le front matter du premier document vaut pour le livre ; un document suivant n’en garde que la ligne chapterStyle:.

#3 · Une page de partie, et une partie sans
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) }),
] },
};
Chaque :::part ouvre une page de partie qui porte le numéro et le titre de la partie sur une bande verte. La postface commence par :::part{title="Afterword" page=false} : aucune page de partie n’est imprimée et, comme la partie ne nomme aucun style, son chapitre est de nouveau composé avec les réglages du livre. Une partie page=false convient aux pages de fin qui suivent les annexes sans rupture.

#4 · Une ouverture en deux tailles
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’ouverture s’étend sur toute la largeur de la page : dans les annexes, elle passe au-dessus des deux colonnes et le texte commence dessous, sur deux. Les styles d’annexe et de référence ramènent le titre à 16 pt et l’abaissement à 24 mm par l’identifiant de l’élément : les pages de fin du livre prennent moins de place, et leurs titres restent nettement plus grands que leur texte.
#5 · Des titres courants venus du livre
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) })] };
Le titre du livre va sur le verso et celui du chapitre sur le recto. Aucun style ne les modifie : les titres courants sont les mêmes dans toutes les parties du livre.
La recette complète
// ═══ 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.
Le script.js composé s’exécute tel quel : collez-le dans le script de module de n’importe quelle page, ou ouvrez la recette sur CodePen. Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)
Variantes
#Demander à un style un réglage du livre
Un style qui fixe le format ou la langue est ignoré pour ces clés. La composition déclenche un avertissement chapterStyleBookSetting pour chacune, et les annexes gardent le format du livre.
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+ page: { width: mm(170) }, locale: 'fr',
layout: { layoutType: 'double', gutterWidth: mm(6) },#Réutiliser la maquette dans un autre livre
L’outil en ligne de commande écrit la maquette d’un livre, styles de chapitre compris, dans un fichier de maquette, puis compose un autre livre avec elle grâce à --design. Voir la commande design.
postext design apples.postext -o handbook.postext
postext pdf pears/ --design handbook.postext -o pears.pdfErreurs fréquentes
- La ligne
:::partdoit ouvrir le chapitre, avant son titre. Une ligne de partie placée après le début du texte du chapitre déclenchepartStyleMidChapter, et le style ne s’applique qu’à partir du chapitre suivant. - Un nom de style absent de
chapterStylesdéclenchechapterStyleUnknown, et ce chapitre est composé avec les réglages du livre.
Crédits
- Recette
- Ignacio Ferro
- Texte
- Texte original, CC BY 4.0
- Polices
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
Modifier ce texte ↗ (s’ouvre dans un nouvel onglet)Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)


