Vai al contenuto principale
Ricetta numero 187

Ricettario · Capitolo 5 · Struttura del libro

Appendici su due colonne in corpo minore

Un manuale di frutticoltura a una colonna con appendici di altro progetto: una parte nomina uno stile di capitolo, un’appendice il suo, la postfazione torna.

In questa pagina

pp. 6–7 di 10

  • Esempio in inglese: non c’è ancora un’edizione italiana
  • Formato 150 × 220 mm
  • 1 colonna
  • Source Serif 4 10,5/14
  • Source Sans 3
  • 10 pagine
  • Livello
  • Postext 1.79.0
  • Impaginato in 315 ms
  • 122 righe di codice

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

script.js · righe 29–48nel codice completo
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

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

script.js · righe 264–266nel codice completo
// 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:.

Appendice C: lo stile proprio del capitolo, tre colonne senza grazie, al posto delle due della parte.

#3 · Una pagina di parte, e una parte senza

script.js · righe 52–66nel codice completo
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.

La pagina di parte della parte II.

#4 · Un’apertura in due misure

script.js · righe 70–75nel codice completo
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

script.js · righe 79–91nel codice completo
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

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.

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

Errori frequenti

  • La riga :::part deve aprire il capitolo, prima del suo titolo. Una riga di parte messa dopo l’inizio del testo del capitolo solleva partStyleMidChapter, e lo stile parte dal capitolo successivo.
  • Un nome di stile che chapterStyles non contiene solleva chapterStyleUnknown, e quel capitolo è composto con le impostazioni del libro.

Crediti

Testo
Testo originale, CC BY 4.0
Font
Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
Sandbox