Saltar al contenido principal
Receta número 187

Recetario · Capítulo 5 · Estructura del libro

Apéndices a dos columnas en cuerpo menor

Un manual a una columna cuyos apéndices cambian de diseño: una parte nombra un estilo de capítulo, un apéndice nombra el suyo y el epílogo vuelve.

En esta página

pp. 6–7 de 10

  • Formato 150 × 220 mm
  • 1 columna
  • Source Serif 4 10,5/14
  • Source Sans 3
  • 10 páginas
  • Nivel
  • Postext 1.79.0
  • Compuesto en 322 ms
  • 122 líneas de código

En pocas palabras

Los capítulos del libro van a una columna ancha. Desde los apéndices, el texto corre a dos columnas de letra más pequeña, y un apéndice a tres. El tamaño de página y el idioma del libro no cambian en ningún momento.

Lo que vas a componer

Un pequeño manual para quien cultiva manzanos en un valle frío, de 150 × 220 mm, escrito en seis documentos Markdown y compuesto como un solo libro. Los dos capítulos de la parte I van a una columna justificada de Source Serif 4. La parte II, los apéndices, cambia de diseño: una tabla de patrones y un calendario mes a mes a dos columnas en bandera y cuerpo menor, materia que se consulta en el cobertizo con el libro abierto sobre el banco, y una lista de variedades a tres columnas de palo seco. El epílogo vuelve al diseño propio del libro sin portadilla. El formato, los márgenes, la división de palabras y el idioma son los mismos en todas las páginas.

Esta receta responde a

  • ¿Cómo compongo los apéndices de un libro, o una de sus partes, con otro diseño, por ejemplo a dos columnas y en un cuerpo menor?
  • ¿Cómo divido un libro en partes o secciones, cada una con su color y su portadilla?

La respuesta corta

script.js · líneas 29–48en el código 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.

Ingredientes

Tipografía
Source Serif 4, Source Sans 3 (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Un estilo guarda solo lo que cambia

El código está en la respuesta corta. Un estilo de capítulo tiene un id, un nombre para el Sandbox y un config que se fusiona sobre los ajustes del libro como lo hace la capa de un idioma. Los objetos se fusionan clave a clave y las listas entrada a entrada por su id o su level, de modo que smallOpener nombra un elemento de la apertura, el título, y le da un cuerpo menor; el filete de debajo y todo lo demás se quedan como los tiene el libro. El estilo de apéndice fija dos columnas, un cuerpo de texto menor, líneas en bandera y espacio entre entradas, y nada más.

Algunos ajustes son del libro entero: el formato, la resolución y la encuadernación de page, el idioma y la dirección de escritura, las cifras, las fuentes, la impresión y el PDF. Un estilo que fije alguno se ignora en ese punto y da un aviso chapterStyleBookSetting, así que los apéndices conservan el formato de 150 mm y la división de palabras en español de los capítulos.

#2 · La parte nombra el estilo

script.js · líneas 264–266en el código 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 }));

El tercer documento empieza con :::part{number="II" title="Apéndices" style="appendix"}, y todos los capítulos desde ese hasta la parte siguiente se componen con el estilo de apéndice. El quinto nombra su propio estilo en su front matter, chapterStyle: "reference", que pesa más que el de la parte. En un libro, solo el front matter del primer documento es del libro; uno posterior conserva únicamente su línea chapterStyle:.

Apéndice C: el estilo propio del capítulo, tres columnas de palo seco, sobre las dos de la parte.

#3 · Una portadilla, y una parte sin ella

script.js · líneas 52–66en el código 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) }),
  ] },
};

Cada :::part abre una portadilla con el número y el título de la parte sobre una banda verde. El epílogo empieza con :::part{title="Epílogo" page=false}: no se imprime portadilla y, como la parte no nombra estilo, su capítulo se compone otra vez con los ajustes del libro. Una parte con page=false sirve para las páginas finales que siguen a los apéndices sin corte.

La portadilla de la parte II.

#4 · Una apertura en dos tamaños

script.js · líneas 70–75en el código 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) } } },
] } };

La apertura ocupa todo el ancho de la página, así que en los apéndices pasa por encima de las dos columnas y el texto empieza debajo, a dos. Los estilos de apéndice y de lista de consulta reducen el título a 16 pt y el hundido a 24 mm a través del id del elemento: la materia del final del libro ocupa menos, y sus títulos siguen claramente por encima del texto.

#5 · Titulillos del libro

script.js · líneas 79–91en el código 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) })] };

El título del libro va en la página par y el del capítulo en la impar. Ningún estilo los cambia, así que los titulillos son iguales en todas las partes del libro.

La receta 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.

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Pedir a un estilo un ajuste del libro

Un estilo que fija el formato o el idioma se ignora en esas claves. La composición da un aviso chapterStyleBookSetting por cada una, y los apéndices conservan el 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) },

#Usar el diseño en otro libro

La herramienta de línea de órdenes escribe el diseño de un libro, con sus estilos de capítulo, en un paquete de diseño, y compone otro libro con él mediante --design. Consulta la orden design.

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

Errores frecuentes

  • La línea :::part tiene que abrir el capítulo, antes de su título. Una línea de parte puesta después de que haya empezado el texto del capítulo da el aviso partStyleMidChapter, y el estilo empieza en el capítulo siguiente.
  • Un nombre de estilo que no está en chapterStyles da el aviso chapterStyleUnknown, y ese capítulo se compone con los ajustes del libro.

Créditos

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