Saltar al contingut principal
Recepta número 187

Receptari · Capítol 5 · Estructura del llibre

Apèndixs a dues columnes en cos més petit

Un manual a una columna amb apèndixs d'un altre disseny: una part anomena un estil de capítol, un apèndix anomena el seu i l'epíleg torna al del llibre.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.79.0
Requereix ≥ 1.79.0
Llicència
Actualitzada el 12 de nov. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 150 × 220 mm
  • 1 columna
  • Source Serif 4 10,5/14
  • Source Sans 3
  • 10 pàgines
  • Nivell
  • Postext 1.79.0
  • Compost en 322 ms
  • 122 línies de codi

En poques paraules

Els capítols del llibre van a una columna ampla. A partir dels apèndixs, el text corre a dues columnes de lletra més petita, i un apèndix a tres. La mida de pàgina i l'idioma del llibre no canvien en cap moment.

Què compondràs

Un petit manual per a qui conrea pomeres en una vall freda, de 150 × 220 mm, escrit en sis documents Markdown i compost com un sol llibre. Els dos capítols de la part I van a una columna justificada de Source Serif 4. La part II, els apèndixs, canvia de disseny: una taula de portaempelts i un calendari mes a mes a dues columnes en bandera i cos més petit, matèria que es consulta al cobert amb el llibre obert sobre el banc de treball, i una llista de varietats a tres columnes de pal sec. L'epíleg torna al disseny propi del llibre sense portadella. El format, els marges, la divisió de paraules i l'idioma són els mateixos a totes les pàgines.

Aquesta recepta respon a

  • Com componc els apèndixs d’un llibre, o una de les seves parts, amb un altre disseny, per exemple a dues columnes i en un cos més petit?
  • Com divideixo un llibre en parts o seccions, cadascuna amb el seu color i la seva portadella?

La resposta curta

script.js · línies 29–48al codi 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.

Ingredients

Tipografia
Source Serif 4, Source Sans 3 (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Un estil només guarda el que canvia

El codi és la resposta curta de més amunt. Un estil de capítol té un id, un nom per al Sandbox i un config que es fusiona sobre els ajustos del llibre com ho fa la capa d'un idioma. Els objectes es fusionen clau per clau i les llistes entrada per entrada pel seu id o el seu level, de manera que smallOpener anomena un element de l'obertura, el títol, i li dona un cos més petit; el filet de sota i tota la resta es queden com els té el llibre. L'estil d'apèndix fixa dues columnes, un cos de text més petit, línies en bandera i espai entre entrades, i res més.

Alguns ajustos són del llibre sencer: el format, la resolució i l'enquadernació de page, l'idioma i la direcció d'escriptura, les xifres, les fonts, la impressió i el PDF. Un estil que en fixi algun s'ignora en aquest punt i dona un avís chapterStyleBookSetting, així que els apèndixs conserven el format de 150 mm i la divisió de paraules en castellà dels capítols.

#2 · La part anomena l'estil

script.js · línies 264–266al codi 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 }));

El tercer document comença amb :::part{number="II" title="Apéndices" style="appendix"}, i tots els capítols des d'aquest fins a la part següent es componen amb l'estil d'apèndix. El cinquè anomena el seu propi estil al front matter, chapterStyle: "reference", que passa per davant del de la part. En un llibre, només el front matter del primer document és del llibre; un de posterior només en conserva la línia chapterStyle:.

Apèndix C: l'estil propi del capítol, tres columnes de pal sec, per sobre de les dues de la part.

#3 · Una portadella, i una part sense

script.js · línies 52–66al codi 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) }),
  ] },
};

Cada :::part obre una portadella amb el número i el títol de la part sobre una banda verda. L'epíleg comença amb :::part{title="Epílogo" page=false}: no s'imprimeix cap portadella i, com que la part no anomena cap estil, el seu capítol es torna a compondre amb els ajustos del llibre. Una part amb page=false serveix per a les pàgines finals que segueixen els apèndixs sense tall.

La portadella de la part II.

#4 · Una obertura en dues mides

script.js · línies 70–75al codi 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'obertura ocupa tota l'amplada de la pàgina, així que als apèndixs passa per sobre de les dues columnes i el text comença a sota, a dues. Els estils d'apèndix i de llista de consulta redueixen el títol a 16 pt i l'enfonsament a 24 mm a través de l'id de l'element: la matèria del final del llibre ocupa menys, i els seus títols continuen clarament per sobre del text.

#5 · Titolets del llibre

script.js · línies 79–91al codi 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) })] };

El títol del llibre va a la pàgina parella i el del capítol a la senar. Cap estil no els canvia, així que els titolets són iguals a totes les parts del llibre.

La recepta 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 = 'es'; // @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.

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Demanar a un estil un ajust del llibre

Un estil que fixa el format o l'idioma s'ignora en aquestes claus. La composició dona un avís chapterStyleBookSetting per cadascuna, i els apèndixs conserven el format del llibre.

   { id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+    page: { width: mm(170) }, locale: 'fr',
     layout: { layoutType: 'double', gutterWidth: mm(6) },

#Fer servir el disseny en un altre llibre

L'eina de línia d'ordres escriu el disseny d'un llibre, amb els seus estils de capítol, en un fitxer de disseny, i compon un altre llibre amb aquest disseny mitjançant --design. Consulta l'ordre design.

postext design manzanos.postext -o manual.postext
postext pdf perales/ --design manual.postext -o perales.pdf

Errors freqüents

  • La línia :::part ha d'obrir el capítol, abans del seu títol. Una línia de part posada després que hagi començat el text del capítol dona l'avís partStyleMidChapter, i l'estil comença al capítol següent.
  • Un nom d'estil que no és a chapterStyles dona l'avís chapterStyleUnknown, i aquell capítol es compon amb els ajustos del llibre.

Crèdits

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