Aller au contenu principal
Recette numéro 187

Recettes · Chapitre 5 · Structure du livre

Annexes sur deux colonnes en petit corps

Un manuel d’arboriculture à une colonne dont les annexes changent de maquette : une partie nomme un style de chapitre, une annexe le sien, la postface revient.

p. 6–7 sur 10

  • Exemple en anglais : pas encore d’édition française
  • Format 150 × 220 mm
  • 1 colonne
  • Source Serif 4 10,5/14
  • Source Sans 3
  • 10 pages
  • Niveau
  • Postext 1.79.0
  • Mis en page en 315 ms
  • 122 lignes de code

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

script.js · lignes 29–48dans le code complet
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

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

script.js · lignes 264–266dans le code complet
// 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:.

Annexe C : le style propre au chapitre, trois colonnes en linéale, à la place des deux de la partie.

#3 · Une page de partie, et une partie sans

script.js · lignes 52–66dans le code complet
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.

La page de partie de la partie II.

#4 · Une ouverture en deux tailles

script.js · lignes 70–75dans le code complet
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

script.js · lignes 79–91dans le code complet
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

Sandbox
// ═══ 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.pdf

Erreurs fréquentes

  • La ligne :::part doit ouvrir le chapitre, avant son titre. Une ligne de partie placée après le début du texte du chapitre déclenche partStyleMidChapter, et le style ne s’applique qu’à partir du chapitre suivant.
  • Un nom de style absent de chapterStyles déclenche chapterStyleUnknown, et ce chapitre est composé avec les réglages du livre.

Crédits

Texte
Texte original, CC BY 4.0
Polices
Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
Sandbox