Saltar al contenido principal
Receta número 7

Recetario · Capítulo 5 · Estructura del libro

Un libro hecho de capítulos sueltos

buildBundle compone cinco archivos Markdown como un solo libro: cada capítulo abre en página impar y páginas, capítulos y figuras se numeran de corrido.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0

pp. 4–5 de 11

  • Formato 150 × 200 mm
  • 1 columna
  • Andada Pro 10,4/14,2
  • Figtree
  • Rozha One
  • 11 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 85 ms
  • 229 líneas de código

En pocas palabras

Un pequeño manual de apicultura escrito en archivos separados, uno por capítulo. Postext los une en un solo libro y los números de página, capítulo y figura siguen de un archivo al siguiente.

Lo que vas a componer

Un año de colmenar es un manual breve de cuatro capítulos, uno por estación. Arranca en otoño, cuando sale la última alza y empieza el año del apicultor. Cada capítulo es un archivo Markdown sin números de página, capítulo ni figura. buildBundle lleva la cuenta de un archivo a otro y compone los capítulos, más un quinto archivo con la cubierta y el índice, como un libro de once páginas. Cada capítulo abre en página impar, bajo una esquina de panal que lleva su número. El índice, en la página par frente a Otoño, repite esa apertura en espejo, con el título pegado al lomo, y da la página de cada capítulo. El mismo cuadro de cría, dibujado con código, sale en cada capítulo, de la figura 1.1 a la 4.1. La página 6 queda en blanco porque Invierno cabe en una página y Primavera tiene que abrir en impar.

Esta receta responde a

  • ¿Cómo compongo un libro de varios capítulos para que la numeración de páginas, figuras y capítulos continúe de uno a otro?
  • ¿Cómo añado un índice que se actualice solo (líneas de puntos, números de página, autores, filas de parte)?
  • ¿Cómo fuerzo un salto de página o de columna, y hago que cada capítulo empiece en página impar?
  • ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?

La respuesta corta

script.js · líneas 71–102en el código completo
// buildBundle lays the documents out in order with one config and carries state from each to
// the next: the pages already set (so parity goes on), the folio, the chapter and figure counts.
const book = () => buildBundle({ chapters, config: config(), resources });
const config = () => ({
  headings: { ...display, levels: [
    // Every chapter opens on a recto: after a chapter that ends on one, the next document
    // starts with a blank verso of its own.
    { level: 1, breakBefore: { enabled: true, parity: 'odd' },
      // '{1}' puts the number in the PDF bookmarks ('1 Autumn'); the contents and
      // {chapterNumber} count the chapters in order either way.
      numberingTemplate: '{1}', advancedDesign: opener,
      span: 'page' }, // in the column a design stops at the column's foot: the cover would too
    subhead,
  ] },
  // The cover and the contents are headings that take no number, no contents entry and no
  // running heads, so Autumn is still chapter 1. Both inherit span 'page', which starts
  // each on a page of its own, and parity 'odd', which the contents turn off: it would
  // leave page 2 blank (gotcha: style-inherits-break).
  headingStyles: [
    { id: 'cover', numbered: false, toc: false, advancedDesign: cover, ...bare },
    { id: 'contents', numbered: false, toc: false, breakBefore: { enabled: false },
      advancedDesign: contentsOpener, ...bare },
  ],
  // :::toc in the first document lists the whole book with the folio each chapter lands on:
  // buildBundle lays the book out again (three passes at most) until those folios settle.
  toc: contents,
  // The locale picks the hyphenation patterns and names the figures Figure or Figura. They
  // number {h1}.{n}, and the counters carry on from document to document (Winter's is 2.1).
  locale: t({ en: 'en-us', es: 'es' }),
  colorPalette, page, layout: { layoutType: 'single' }, bodyText, captionStyle, calloutStyles,
  header, footer, // the look: above, and in the regions below
});

Ingredientes

Tipografía
Andada Pro, Rozha One, Figtree (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Un archivo por capítulo

script.js · líneas 337–338en el código completo
// Nothing in a chapter says where it lands: buildBundle works that out from the order.
const chapters = [front, autumn, winter, spring, summer].map((markdown) => ({ markdown }));

Cada estación es un documento propio, así que puedes reescribir un capítulo sin abrir los demás. El primer documento lleva el frontmatter, la cubierta y el índice. Sus metadatos son los del libro: {title} y {author} los imprimen en todos los capítulos, y el PDF toma de él el título y la autora.

#2 · Reglas que pasan de un documento a otro

El código de este paso es la respuesta corta de arriba. buildBundle compone los documentos en orden con una sola configuración y le pasa a cada uno una continuation con lo que dejaron los anteriores: el número de páginas físicas ya compuestas, para que sigan la paridad, los márgenes en espejo y las cabeceras de pares e impares; el folio siguiente, y los contadores de capítulos y figuras. Con parity: 'odd', un capítulo que sigue a otro acabado en página impar empieza con una página par en blanco, y esa página pertenece a su propio documento (salto de página antes del encabezado). La cubierta y el índice son estilos de encabezado con numbered: false, por lo que Otoño sigue siendo el capítulo 1. Los dos heredan del nivel de capítulo span: 'page', que pone cada uno en su propia página sin necesidad de :::pagebreak. El estilo del índice desactiva la paridad heredada, que dejaría en blanco la página 2.

#3 · Un índice de todo el libro

script.js · líneas 215–228en el código completo
const contents = {
  levels: [
    { level: 1, fontFamily: 'Rozha One', fontSize: pt(16), lineHeight: pt(18),
      numberFontFamily: 'Figtree', numberFontSize: pt(11), numberFontWeight: 700,
      numberColor: col('accent'), numberWidth: mm(7), numberGap: mm(4), marginTop: pt(8) },
    // Sections: 9.3 pt in the muted colour, indented 11 mm (number 7 + gap 4) to the titles.
    { level: 2, fontSize: pt(9.3), lineHeight: pt(13.5), indent: mm(11), color: col('muted') },
  ],
  pageNumber: { fontFamily: 'Figtree', fontSize: pt(8.5), fontWeight: 600, width: mm(7) },
  leader: { char: '. ', gap: mm(2) },
  // A second line under each chapter, from its {months="…"} heading attribute.
  subtitle: { enabled: true, attr: 'months', fontFamily: 'Andada Pro', fontSize: pt(9),
    color: col('muted') }, // italic by default
};

:::toc está en el primer documento, pero recoge los capítulos y las secciones de todo el libro. buildBundle compone el libro, anota cada título con la página que le ha tocado y lo vuelve a componer con ese esquema hasta que los folios dejan de moverse, tres pasadas como mucho (índice general). Los meses bajo cada título salen de un atributo del encabezado, {months="…"}, que también imprime la apertura.

#4 · Una apertura, en espejo para el índice

script.js · líneas 184–211en el código completo
const corner = (id, edge) => ({ kind: 'image', id, resourceId: id,
  placement: { anchor: { to: 'bleed', edge }, size: { width: mm(CORNER.width) } } });
const months = { kind: 'text', id: 'months', content: '{attr.months}', ...label,
  color: col('accent'), placement: at('top-left', 0, 14, 'container') };
const title = { kind: 'text', id: 'title', content: '{titleText}', ...display, fontSize: pt(42),
  lineHeight: 1.05, align: 'left', overflow: 'wrap', placement: below('months', 1.5, 100) };
const opener = { enabled: true, minHeight: mm(52), slot: { elements: [
  corner('cells', 'top-right'),
  // The number's box is centred on its cell. Comb and number both hang from the bleed's top
  // right, so a bleed (page.cutLines) moves them together.
  { kind: 'text', id: 'number', content: '{chapterNumber}', ...display, fontSize: pt(40),
    lineHeight: 1, align: 'center', placement: { size: { width: mm(NUMBER.box) },
      ...at('top-right', NUMBER_CELL.x + NUMBER.box / 2 - CORNER.width,
        NUMBER_CELL.y - NUMBER.rise, 'bleed') } },
  months, title,
  { kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: 'Andada Pro', italic: true,
    fontSize: pt(11.5), lineHeight: 1.35, color: col('ink'), align: 'left', overflow: 'wrap',
    placement: below('title', 3, 88) },
] } };
// The contents mirror it on the verso: the comb in the outer corner, the book's subtitle and
// the title set flush right against the spine, on the same lines as Autumn's across the spread.
const flushRight = (element, placement) => ({ ...element, align: 'right',
  placement: { ...placement, size: { width: 'fill' } } });
const contentsOpener = { ...opener, minHeight: mm(40), slot: { elements: [
  corner('comb', 'top-left'),
  flushRight({ ...months, content: '{subtitle}' }, months.placement),
  flushRight(title, below('months', 1.5)),
] } };

{chapterNumber} sigue contando desde los documentos compuestos antes, así que la apertura de Primavera muestra un 3 aunque su archivo no lleva ningún número. La caja del número se calcula a partir del centro de su celda del panal, y número y panal cuelgan los dos de la esquina superior derecha del sangrado; si cambias el formato o añades sangrado para imprenta, se mueven juntos. En el índice, el antetítulo (que sale de {subtitle}) y el título van alineados a la derecha, contra el lomo, y el panal pasa a la esquina exterior de la página par; así su título cae a la misma altura que el de Otoño en la doble página.

#5 · Cabeceras en todos los documentos

script.js · líneas 232–248en el código completo
const head = (id, content, parity, placement, extra = {}) => ({
  kind: 'text', id, content, parity, pages: 'body', // never on openers or blank pages
  ...label, color: col('muted'), placement, ...extra,
});
const folio = { fontSize: pt(8.5), fontWeight: 700, color: col('accent') };
// Only the first document has frontmatter, and its {title} is the book's in every chapter.
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', at('top-left', MARGIN.outer, HEAD.y), folio),
  head('verso-title', '{title}', 'even', at('top-left', MARGIN.outer + HEAD.gap, HEAD.y)),
  // {chapterTitle} and {pageNumber} are worked out page by page, in every document.
  head('recto-title', '{chapterTitle}', 'odd',
    at('top-right', -(MARGIN.outer + HEAD.gap), HEAD.y)),
  head('recto-folio', '{pageNumber}', 'odd', at('top-right', -MARGIN.outer, HEAD.y), folio),
] };
// Openers carry a drop folio instead, 8 mm under the text block.
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all',
  at('top', 0, 8, 'container'), { pages: 'opener', fontWeight: 700 })] };

Solo el primer documento tiene frontmatter, y buildBundle se lo pasa a todos los capítulos, así que la cabecera de las páginas pares imprime el {title} del libro en los cinco documentos. {chapterTitle} y {pageNumber} se resuelven página a página y salen en todos los documentos; la página 11, la única impar de texto corrido, lleva VERANO junto al folio. pages: 'body' deja sin cabecera las aperturas y la página en blanco.

#6 · Pliegos en pantalla, un PDF para el libro

script.js · líneas 369–379en el código completo
const text = chapters.map((chapter) => chapter.markdown).join('\n');
await prepareFonts(text, config(), kitFonts(FONTS));
const art = { cover: coverArt(), cells: cornerArt(true), comb: cornerArt(false) };
for (const [season, plan] of Object.entries(SEASONS)) art[`${season}-frame`] = frameArt(plan);
for (const [id, markup] of Object.entries(art)) await loadSvg(`${id}.svg`, markup);
// One VDTDocument per Markdown document.
const docs = await withLoadedFonts(book, { ...kitFonts(FONTS), text });
showPages(docs, { title: t({ en: 'A Beekeeper’s Year', es: 'Un año de colmenar' }) });
// renderToPdf takes the array: one file for the book, with a bookmark per chapter.
offerPdf(() => renderToPdf(docs, { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),
  `${RECIPE}.pdf`);

buildBundle devuelve una lista de documentos, uno por archivo Markdown. showPages empareja las páginas por pageIndexOffset + page.index, así que la página 1 queda sola, como impar, y las demás quedan enfrentadas por pares: la 2 con la 3, la 4 con la 5, y así hasta el final. renderToPdf recibe la misma lista y escribe un único archivo con los folios del libro y un marcador por cada capítulo y sección.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 007 · One book from separate chapters ══════════════════════════
// https://postext.dev/en/cookbook/book-from-chapters
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Andada Pro, Rozha One, Figtree (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A handbook in four seasons written as five Markdown documents, laid out by buildBundle as
// one book: parity, folios, chapter and figure numbers and the contents run straight through.
import {
  buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'book-from-chapters';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these, so the book can be retinted
  ink: '#2a2218', // text and display type
  honey: '#d99a1e', // the drawings only: the cover and the comb cells
  accent: '#7a4e12', // the text accent (7:1 on paper): numbers, labels, subheads; main-color too
  pollen: '#c4692b', comb: '#f7e7c4', rule: '#d8c8a8', // figures: pollen, wax, wood and walls
  muted: '#6e634f', paper: '#fffdf7', // running heads, colophon, contents sections; the page
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color': point it at the accent, so nothing prints blue.
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// The geometry, in mm. The drawings, the opener and the running heads are derived from it.
const TRIM = { width: 150, height: 200 }; // a small handbook
const MARGIN = { top: 22, bottom: 22, inner: 19, outer: 15 }; // mirrored
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // the text width: 116 mm
const SQRT3 = Math.sqrt(3); // comb cells of radius r sit √3·r apart, their rows 1.5·r apart
const CORNER = { width: 84, height: 70, r: 9.5 }; // the openers' comb, and its cell radius
const NUMBER_CELL = { x: 4 * SQRT3 * CORNER.r, y: 2 * 1.5 * CORNER.r }; // row 2, cell 4
// The chapter number's box: 20 mm wide, its top 8 mm above the cell's centre, which is where
// a 40 pt Rozha One figure sits optically centred in the cell.
const NUMBER = { box: 20, rise: 8 };
const FRAME = { width: MEASURE, height: 50 }; // the brood frame figures, at the text width
const HEAD = { y: 12, gap: 8 }; // running heads 12 mm from the top edge, 8 mm folio to text
const LEAD = 14.2; // body leading in pt: the baseline grid
// The look: a small handbook, mirrored, justified Andada Pro on the grid; Rozha One titles.
const page = { // mirror: left is the inner margin, right the outer
  sizePreset: 'custom', width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
  backgroundColor: col('paper'), margins: { top: mm(MARGIN.top), bottom: mm(MARGIN.bottom),
    left: mm(MARGIN.inner), right: mm(MARGIN.outer), mirror: true },
};
const bodyText = { // justified, hyphenated, optimal line breaks and widow control: by default

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

#Imprime un capítulo con los folios del libro

Pasa un solo documento a renderToPdf para sacar una prueba de Primavera, numerada del 6 al 8 como en el libro. La página 6 en blanco va con ella, porque la página par en blanco que precede a una apertura pertenece al capítulo que abre después.

-offerPdf(() => renderToPdf(docs, { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),
+offerPdf(() => renderToPdf(docs[3], { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),

#Numera las figuras de corrido en todo el libro

Un contador de figuras que no se reinicia numera los cuatro cuadros del 1 al 4 en todo el libro, en vez de 1.1 a 4.1.

   buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas, registerResourceImage,
+  defaultResourceTypes,
@@
   locale: t({ en: 'en-us', es: 'es' }),
+  resourceTypes: defaultResourceTypes(LANG)
+    .map((type) => ({ ...type, numberingTemplate: '{n}', resetOn: 'never' })),

Errores frecuentes

Error frecuente

Un estilo de título hereda el salto de página de su nivel

Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →

Error frecuente

La página 1 es impar: planifica con números físicos

La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →

Comprobación del Sandbox · chapterFrontmatterIgnored

Frontmatter del capítulo ignorado

Por qué. Solo cuenta el frontmatter del primer capítulo; un capítulo posterior empieza con un bloque de frontmatter que se descarta.

Solución. Deja los metadatos del libro en el primer capítulo y usa atributos de encabezado para los valores de cada capítulo. Documentación →

  • En lo alto de una página, y bajo una figura que la encabeza, un título de sección pierde su marginTop. Si el aire del título sale del margen, en esos dos sitios queda a una línea de su texto y en el resto, a línea y media. Aquí el aire está en la propia línea del encabezado: lineHeight mide línea y media y el margen, una línea, así que todos los títulos de sección del libro quedan a la misma distancia de su texto.
  • Por defecto, una línea justificada puede estirar sus espacios hasta el doble de su ancho, y el algoritmo de corte lo prefiere a un guion. Compuesta así, la edición inglesa no partía ni una palabra y dejaba espacios casi del doble junto a líneas apretadas al 0,7. maxWordSpacing: 1.7 obliga al algoritmo a partir palabras. Después de cambiarlo, revisa la última línea de cada párrafo: un límite más estricto puede dejar ahí una palabra sola, y se arregla cambiando unas pocas palabras del párrafo.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Andada Pro (SIL OFL 1.1) · Rozha One (SIL OFL 1.1) · Figtree (SIL OFL 1.1)
SandboxPDF