En pocas palabras
Cinco páginas de una novela clásica brasileña en formato de bolsillo. Cada capítulo corto empieza justo después del anterior, y ninguna página empieza ni acaba con una línea suelta.
Lo que vas a componer
Cinco páginas del final de Dom Casmurro (Machado de Assis, 1899), en el portugués original, compuestas como libro de bolsillo de 110 × 178 mm para una colección inventada, la Coleção Casuarina. Las preceden una cubierta en bandas ciruela, crema y ciruela, con el título en Abril Fatface y el sello azafrán de la colección, y una lámina pintada del mar revuelto de Flamengo, generada con modelos de difusión, frente a la 213. El texto va del final del CXVIII al del CXXIII, y ningún capítulo abre página. Cada uno empieza dos líneas por debajo del final del anterior (tres en el CXIX, para llenar la 213), con un numeral romano en ciruela, el título en versales espaciadas y un filete corto azafrán. En la 214 empiezan dos; en la 215 y la 216, uno. Todas las páginas de texto menos la última acaban en su línea 33, y ninguna empieza con una línea sola.
Esta receta responde a
- ¿Cómo evito viudas, huérfanas y últimas líneas de una sola palabra, y mantengo cada título con su texto?
- ¿Cómo consigo columnas a ras del pie y una última página equilibrada (justificación vertical)?
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
- ¿Cómo pongo cabeceras: el título del libro en la página izquierda, el del capítulo en la derecha y el folio por fuera?
La respuesta corta
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
{ kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
lineHeight: 1, color: col('plum'), align: 'center',
placement: { ...at('container', 'top'), size: { width: 'fill' } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
align: 'center', overflow: 'wrap', // a long title takes a second line
placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
size: { width: 'fill' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('saffron'),
placement: { ...at('container', 'top', 0, RULE_Y), size: { width: mm(8) } } },
] } }; // 11.7 mm deep: the head takes three lines, and the text under it stays on the grid
const chapters = { level: 1, numberingTemplate: '{1:I}', // {number} prints CXIX, CXX…
fontSize: pt(TITLE), // the hidden heading line, measured in the headings' face
breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
// The keep rules are on by default. avoidWidows keeps widowMinLines (2) lines of a paragraph
// at the foot of a page, and headings.keepWithNext takes the head along when the paragraph
// moves on; avoidOrphans keeps two lines at the head of the next page; avoidRunts weighs a
// last line shorter than about 20 characters as a fault. Column balancing adds lines above
// a head so that the page ends on line 33.
Ingredientes
- Funciones
- Viudas, huérfanas y líneas cortasAperturas diseñadasCapítulos que abren en página imparTítulos numeradosEquilibrado de columnasSeparación silábica e idioma del documentoSangrías, alineación y separación de párrafosCabeceras y foliosCabeceras según el tipo de páginaEstilos de títuloCapítulos sin númeroCubiertas, portadas y colofonesSaltos de página y de columnaImágenes en los diseños de páginaTextos, filetes y cajas en los diseños de páginaAtributos de títuloMárgenes simétricosRecuadros flotantesMetadatos del documento
- También usa
- Iconos y distintivos de esquinaRecuadrosColor del papelFiguras y tablas como recursosPreliminares en romanosSaltos de línea en los títulos
- Tipografía
- Tinos (Apache 2.0) · Abril Fatface, League Spartan (SIL OFL 1.1)
- Recursos
plate-1100.jpg- La lámina del mar de Flamengo bajo el Pan de Azúcar, una pintura (Generated With Diffusion Models, original)
- El sello de la casuarina, dibujado en código con la paleta del libro (Ignacio Ferro, MIT)
Elaboración
#1 · Encadena los capítulos, cada título con su texto
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
{ kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
lineHeight: 1, color: col('plum'), align: 'center',
placement: { ...at('container', 'top'), size: { width: 'fill' } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
align: 'center', overflow: 'wrap', // a long title takes a second line
placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
size: { width: 'fill' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('saffron'),
placement: { ...at('container', 'top', 0, RULE_Y), size: { width: mm(8) } } },
] } }; // 11.7 mm deep: the head takes three lines, and the text under it stays on the grid
const chapters = { level: 1, numberingTemplate: '{1:I}', // {number} prints CXIX, CXX…
fontSize: pt(TITLE), // the hidden heading line, measured in the headings' face
breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
// The keep rules are on by default. avoidWidows keeps widowMinLines (2) lines of a paragraph
// at the foot of a page, and headings.keepWithNext takes the head along when the paragraph
// moves on; avoidOrphans keeps two lines at the head of the next page; avoidRunts weighs a
// last line shorter than about 20 characters as a fault. Column balancing adds lines above
// a head so that the page ends on line 33.
El nivel de capítulo lleva el salto desactivado, y marginTop coloca cada título dos líneas por debajo de la última del capítulo anterior. Su diseño no lleva span, así que el título se dibuja dentro de la columna, en un bloque de tres líneas de alto, y el texto que va debajo cae en la rejilla base (salto de página antes del encabezado, apertura a toda página y diseño avanzado). Las reglas de cohesión conservan sus valores por defecto. Los párrafos de cuatro líneas que siguen al CXIX y al CXXI dejan dos líneas al pie de su página y pasan dos a la siguiente; con avoidOrphans: false se partirían en tres y una, y las páginas 214 y 215 empezarían con una línea sola (huérfanas, viudas y líneas cortas). El equilibrado de columnas añade sobre el CXIX una tercera línea de blanco, y con ella la página 213 acaba en la línea 33 (equilibrado de columnas).

#2 · Compón una página de 33 líneas, con separación silábica portuguesa
const bodyText = { fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD),
color: col('ink'), referenceColor: col('ink'), // a :ref added later prints in ink
firstLineIndent: mm(5) }; // every paragraph indented, the first after a head too
const page = { sizePreset: 'custom', width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LEAD * PT), // 16.3 mm
left: mm(INNER), right: mm(OUTER), mirror: true } };
const LOCALE = 'pt'; // the Portuguese hyphenation patterns
El margen inferior mide 16,3 mm, lo que queda de los 178 mm de alto tras el margen superior de 15 mm y 33 líneas de 12,6 pt, así que todas las páginas llenas acaban en la misma línea. Tinos, que tiene los mismos anchos que la Times New Roman, compone unos 59 caracteres por línea en la medida de 84 mm a 9,5 pt. locale: 'pt' divide las palabras con los patrones portugueses: at-tracção, af-fluencia, genealogica-mente (idiomas admitidos). Todos los párrafos llevan sangría, también el primero después de un título, como es costumbre en las ediciones portuguesas y brasileñas, y para eso basta el valor por defecto de indentAfterHeading.
#3 · Pon el título del libro en la página par y el capítulo en la impar
const SHIFT = (INNER - OUTER) / 2; // mm: the text block sits off the page's centre
const [HEAD_Y, FOLIO_Y] = [8.5, 167]; // mm below the top edge
const head = (id, content, parity, x) => ({ kind: 'text', id, content, parity,
pages: 'body', // never on the cover or the plate, which are opener pages
...caps(7.5, TRACK), color: col('muted'), align: 'center',
placement: at('page', 'top', x, HEAD_Y) });
const folio = (id, parity, edge, x) => ({ kind: 'text', id, content: '{pageNumber}', parity,
pages: 'body', ...caps(7.5, 0), color: col('ink'), placement: at('page', edge, x, FOLIO_Y) });
const header = { elements: [
head('verso-title', '{title}', 'even', -SHIFT), // the title in the frontmatter
head('recto-chapter', '{chapterTitle}', 'odd', SHIFT), // last chapter begun on or before it
] };
const footer = { elements: [folio('verso-folio', 'even', 'top-left', OUTER),
{ ...folio('recto-folio', 'odd', 'top-right', -OUTER), align: 'right' }] };
{title} imprime el título de los metadatos del documento, y {chapterTitle}, el del último capítulo que empieza en la página o antes, así que la 217 muestra el CXXIII, que empezó en la 216 (elementos de texto). La 213 muestra el CXIX, que empieza al pie, aunque sus primeras 25 líneas cierran el CXVIII. {chapterTitleAtTop} muestra en su lugar el capítulo con el que abre la página, pero este extracto no trae el título del CXVIII. SHIFT lleva las cabeceras al centro de la caja de texto, a 1 mm del centro de la página, porque el margen interior mide 2 mm más que el exterior.
#4 · Dibuja la cubierta y la lámina como títulos
// span: 'page', in one column too, makes each an opener page: its art runs past the foot of
// the text column, and no running head or folio prints on it. Each design reaches the foot of
// the page, so the heading reserves the whole page and the text starts on the next one.
const onPage = (y, size) => ({ ...at('page', 'top', 0, y), ...(size && { size }) });
const cover = { id: 'cover', numbered: false, span: 'page',
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'box', id: 'top-band', style: { backgroundColor: col('plum') },
placement: { ...at('page', 'top-left'), size: { width: 'fill', height: mm(62) } } },
{ kind: 'text', id: 'author', content: '{author}', ...caps(10, 2.4), color: col('paper'),
align: 'center', placement: at('page', 'top', 0, 44) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(44),
lineHeight: 1, color: col('plum'), align: 'center', overflow: 'wrap',
placement: onPage(72, { width: 'fill' }) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5),
color: col('saffron'), placement: onPage(111, { width: mm(12) }) },
{ kind: 'box', id: 'foot-band', style: { backgroundColor: col('plum') },
placement: { ...at('page', 'top-left', 0, 124), size: { width: 'fill', height: mm(54) } } },
{ kind: 'image', id: 'roundel', resourceId: 'roundel',
placement: onPage(133, { width: mm(20) }) },
{ kind: 'text', id: 'series', content: 'Coleção Casuarina', ...caps(7.5, 1.8),
color: col('saffron'), align: 'center', placement: at('page', 'top', 0, 159) },
] } } };
// The plate faces the first page of text: the morning sea off Flamengo, captioned with the
// line of chapter CXXIII it illustrates, which the heading carries in its quote attribute.
const plate = { id: 'plate', numbered: false, span: 'page',
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'sea', resourceId: 'sea',
placement: { ...at('page', 'top-left'), size: { width: 'fill', height: 'fill' } } },
{ kind: 'text', id: 'label', content: '{titleText}', ...caps(7.5, 1.6), color: col('saffron'),
align: 'center', placement: at('page', 'top', 0, 146) },
{ kind: 'text', id: 'quote', content: '{attr.quote}', fontFamily: TEXT, italic: true,
fontSize: pt(8.6), lineHeight: 1.35, color: col('paper'), align: 'center', overflow: 'wrap',
placement: onPage(152, { width: mm(78) }) },
] } } };
const resources = [
{ id: 'roundel', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
svg: { fileId: 'roundel.svg', width: 60, height: 60 },
altText: 'The series mark: a casuarina tree in a ring.' },
// The plate is a painting, a JPEG in assets/ cut to the trim, declared at its pixels.
{ id: 'sea', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'plate-1100.jpg', format: 'jpeg', width: 1100, height: 1780 },
altText: 'A heavy morning sea under the Sugarloaf, a low sun, and a lone swimmer among '
+ 'the breakers.' },
];
Las dos son estilos de encabezado con numbered: false, así que el primer capítulo numerado sigue siendo el CXIX. span: 'page' las convierte en páginas de apertura. Sin él, la banda del pie de la cubierta y la imagen de la lámina se cortan en el borde inferior de la caja de texto, y la cabecera y el folio se imprimen sobre las dos páginas. El pie de la lámina sale de su título: CAPÍTULO CXXIII es el texto del título, y la cita en cursiva, su atributo quote (atributos de encabezado). Cada diseño llega al pie de su página, así que el título reserva la página entera y el texto empieza en la siguiente sin ningún :::pagebreak.
#5 · Di al fragmento en qué punto del libro está
const continuation = { headings: { h1: 118, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } };
continuation.headings da los contadores de títulos con los que empieza el fragmento. Con h1: 118, el primer título numerado es el capítulo CXIX; sin él, los cinco capítulos salen numerados del I al V. numberingTemplate: '{1:I}', en el nivel de capítulo, pone esos números en romanos, y el diseño los imprime con {number}. :::numbering{startAt=212}, tras la cubierta, numera la lámina como 212 y las páginas de texto de la 213 a la 217 (:::numbering).
La receta completa
// ═══ Postext Cookbook · Nº 065 · Pocket classic: short chapters that run on ═══════════
// https://postext.dev/en/cookbook/short-chapters-run-on
// Code: MIT · Text: Machado de Assis, Dom Casmurro, 1899 (PD, Gutenberg #55752) · Plate: painted
// Fonts: Tinos (Apache 2.0), Abril Fatface, League Spartan (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the viewer's title; the sample is Portuguese
const RECIPE = 'short-chapters-run-on';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#24202a', // the text: a violet near-black
paper: '#f6f1e6', // the pocket book's paper
plum: '#4f2a49', // the series colour: cover bands, the chapter numerals
saffron: '#d9a03c', // the second ink: rules and drawings, never text on paper (2.1:1)
muted: '#6b616e', // the running heads and the colophon (5.2:1 on paper)
};
// Each colour names its palette entry and carries its hex.
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 default bold and italic colours link to main-color, set here to the ink, not blue.
{ id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Tinos', 'Abril Fatface', 'League Spartan'];
const TRIM = { width: 110, height: 178 }; // mm: a pocket book
const [TOP, INNER, OUTER] = [15, 14, 12]; // mm; mirrored, so the inner margin is at the spine
const [BODY, LEAD, LINES] = [9.5, 12.6, 33]; // pt, pt, and the lines of a full page
const PT = 25.4 / 72; // mm per point
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const caps = (size, track) => ({ fontFamily: LABEL, fontWeight: 600, fontSize: pt(size),
letterSpacing: pt(track), textTransform: 'uppercase' });
// #region answer: chapters that run on, each under a centred head drawn in the column
// Machado's chapters run a page or two, so none opens a page. The level's break is off (the
// H1 default would open each chapter on a recto) and a chapter starts two lines under the last.
const [NUMERAL, TITLE, TRACK, GAP] = [14, 7.5, 1.3, 1.6]; // pt, pt, pt, mm
const RULE_Y = NUMERAL * PT + GAP + TITLE * 1.2 * PT + GAP; // mm: under the title's line
const chapterHead = { enabled: true, slot: { elements: [ // no span: the head stays in the text
{ kind: 'text', id: 'numeral', content: '{number}', fontFamily: DISPLAY, fontSize: pt(NUMERAL),
lineHeight: 1, color: col('plum'), align: 'center',
placement: { ...at('container', 'top'), size: { width: 'fill' } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...caps(TITLE, TRACK), color: col('ink'),
align: 'center', overflow: 'wrap', // a long title takes a second line
placement: { anchor: { to: '#numeral', edge: 'below' }, offset: { y: mm(GAP) },
size: { width: 'fill' } } },
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
#Abre cada capítulo en una página nueva
Con un salto antes de cada capítulo, las cinco páginas de texto pasan a ser siete: la 214 lleva solo el CXIX, su título y cuatro líneas, y la 213, donde no empieza ningún capítulo, toma como cabecera el título de la lámina, CAPÍTULO CXXIII.
- breakBefore: { enabled: false }, marginTop: pt(2 * LEAD), advancedDesign: chapterHead };
+ breakBefore: { enabled: true, parity: 'any' }, marginTop: pt(2 * LEAD),
+ advancedDesign: chapterHead };#Pon el número del capítulo en la página impar
{chapterNumber} imprime el numeral del mismo capítulo del que sale el título: CXIX · NÃO FAÇA ISSO, QUERIDA.
- head('recto-chapter', '{chapterTitle}', 'odd', SHIFT),
+ head('recto-chapter', '{chapterNumber} · {chapterTitle}', 'odd', SHIFT),Errores frecuentes
Error frecuente
avoidWidows vigila el pie de la columna, y avoidOrphans, su cabeza
Postext da nombre propio a las dos líneas solas: avoidWidows (widowMinLines, widowPenalty) evita que la primera línea de un párrafo quede sola al pie de una columna, y avoidOrphans (orphanMinLines, orphanPenalty), que la última quede sola en la cabeza de la siguiente. Muchos manuales de estilo usan los dos nombres al revés, así que elige el ajuste por el lugar donde actúa. Los dos vienen activados, salvo en una retícula de caracteres (cjk.grid): ahí avoidWidows viene desactivado, y avoidOrphans también en la región de Japón, para que la página contenga las líneas que su retícula cuenta (desde postext 1.28). Funcionan como penalizaciones: la composición compara cada una con las líneas vacías que dejaría respetarla. Viudas, huérfanas y líneas cortas →
Error frecuente
:::numbering se aplica en la página siguiente
:::numbering cambia la cuenta a partir de la siguiente página que empieza, no de la actual. Colócalo justo después de un :::pagebreak (con paridad odd antes del primer capítulo) para que la numeración nueva empiece donde quieres. Preliminares en romanos →
- Si subes
widowMinLinesa 3, el párrafo de cuatro líneas que sigue al CXIX no tiene por dónde partirse: tres líneas y una abrirían la página 214 con una línea sola. El título pasa a la página siguiente con su texto y la 213 acaba seis líneas antes. - Si el CXVIII crece unas líneas, al CXIX solo le queda sitio para una línea bajo su título.
keepWithNextlleva entonces el título a la página 214, y la 213 acaba cuatro o cinco líneas antes del pie; conkeepWithNext: false, el título cierra la 213 sin texto debajo. - La lámina es un H1, así que
{chapterTitle}recurre a ella: una página de texto en la que no ha empezado ningún capítulo desde la lámina, como la 213 cuando el CXIX pasa a la siguiente, lleva como cabecera CAPÍTULO CXXIII. ConrunningChapter: falseen el estilo de la lámina, las cabeceras la pasan por alto. - Con
avoidRuntsdesactivado, la última línea del libro lleva manhã. sola en lugar de nadador da manhã. - Estos saltos de página valen solo para este texto a 9,5 sobre 12,6 pt en una medida de 84 mm. Si cambias el texto, el cuerpo o la medida, vuelve a mirar el pie de cada página y el blanco sobre cada título.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Dom Casmurro (1899), del final del capítulo CXVIII al final del CXXIII, con la ortografía de la edición Garnier y una errata de la transcripción corregida (homens, capítulo CXXIII) · Machado de Assis · dominio público
- El colofón y el nombre de la colección, Coleção Casuarina (inventado para esta receta) · Postext Cookbook · original
- Imágenes
- La lámina del mar de Flamengo bajo el Pan de Azúcar, una pintura · Generated With Diffusion Models · original
- El sello de la casuarina, dibujado en código con la paleta del libro · Ignacio Ferro · MIT
- Fuentes
- Tinos (Apache 2.0) · Abril Fatface (SIL OFL 1.1) · League Spartan (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)


