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
// 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
- Funciones
- Libros construidos capítulo a capítuloÍndice generalCapítulos que abren en página imparPies numeradosCitas que colocan las figurasTítulos numeradosEstilos de títuloCapítulos sin númeroCabeceras por secciónCabeceras y foliosCabeceras según el tipo de páginaAperturas diseñadasAtributos de títuloImágenes en los diseños de páginaMárgenes simétricosRecuadros flotantesExportación a PDFMarcadores del PDFFigura y Tabla en tu idiomaCubiertas, portadas y colofones
- También usa
- RecuadrosBanda de capítulo a todo el anchoColor del papelFuentes incrustadas en el PDFFiguras y tablas como recursosSaltos de línea en los títulos
- 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
// 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
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
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
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
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
// ═══ 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:lineHeightmide 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.7obliga 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
- Receta
- Ignacio Ferro
- 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)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


