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
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
- Funciones
- Estilos de capítuloPortadillas de parteLibros construidos capítulo a capítuloUna o dos columnasTres o más columnasAperturas diseñadasCabeceras y foliosCabeceras por secciónCabeceras según el tipo de páginaMárgenes simétricosTextos, filetes y cajas en los diseños de páginaViudas, huérfanas y líneas cortasPaleta de color semántica
- 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
// 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:.

#3 · Una portadilla, y una parte sin ella
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.

#4 · Una apertura en dos tamaños
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
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
// ═══ 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.pdfErrores frecuentes
- La línea
:::parttiene 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 avisopartStyleMidChapter, y el estilo empieza en el capítulo siguiente. - Un nombre de estilo que no está en
chapterStylesda el avisochapterStyleUnknown, y ese capítulo se compone con los ajustes del libro.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (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)


