En pocas palabras
Los dos primeros capítulos de una novela estadounidense en una edición en rústica. Cada capítulo empieza en una página de la derecha, más abajo, bajo un número grande.
Lo que vas a componer
Los dos primeros capítulos de The Awakening (1899), de Kate Chopin, ocupan ocho páginas de rústica de 140 × 216 mm. La cubierta, una pintura generada con modelos de difusión y cargada como JPEG, muestra el golfo desde Grand Isle: un lugre en el horizonte entre los robles y la sombrilla blanca que sube entre la manzanilla. El colofón va al pie de su dorso. Cada capítulo empieza en página impar, con el texto a 81 mm del borde superior, bajo un número romano en cursiva de 48 pt, un filete rojo óxido de 18 mm y la primera frase en versalitas, partida en dos líneas centradas. El capítulo I acaba en la 5 con un florón de manzanilla, así que la 6 queda en blanco, sin cabecera ni folio, y el II empieza en la 7. Las cabeceras llevan el nombre de la autora en las pares y el título en cursiva en las impares.
Esta receta responde a
- ¿Cómo fuerzo un salto de página o de columna, y hago que cada capítulo empiece en página impar?
- ¿Cómo añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?
- ¿Cómo inserto páginas en blanco a propósito, o empiezo una sección en una doble página nueva?
- ¿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?
- ¿Cómo hago una cubierta, una portadilla, una portada y un colofón?
- ¿Cómo añado espacio vertical entre dos bloques, si las líneas en blanco no hacen nada?
- ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
La respuesta corta
// # I {lead="A green and yellow parrot, … kept repeating over and over:"}
// The heading's text is the numeral, printed by {titleText}; the chapter's first sentence
// travels as the heading's lead attribute, printed by {attr.lead} in small capitals: a
// centred display, which a \n in the attribute breaks by sense.
const [LEAD_AT, BODY_AT] = [9, 12]; // grid lines: the lead's top; where the text starts
const NUMERAL = 48; // pt
const RULE_Y = (LEAD_AT - 1.5) * LEAD * MM_PER_PT; // mm: a line and a half above the lead
const NUMERAL_Y = RULE_Y - NUMERAL * MM_PER_PT - 3; // mm: the numeral's box ends 3 mm above it
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y } });
const opener = {
enabled: true,
// The two-line lead ends on line LEAD_AT + 2; minHeight leaves a blank line under it and
// starts the text on line BODY_AT (a one-line lead would leave two).
minHeight: line(BODY_AT),
slot: { elements: [
{ kind: 'text', id: 'numeral', content: '{titleText}', fontFamily: DISPLAY, italic: true,
fontWeight: 500, fontSize: pt(NUMERAL), lineHeight: 1, color: col('ink'),
align: 'center', placement: centred(mm(NUMERAL_Y)) },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.6),
color: col('rubric'), placement: { ...centred(mm(RULE_Y)), size: { width: mm(18) } } },
{ kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9.5), letterSpacing: pt(0.6), color: col('ink'), align: 'center',
lineHeight: LEAD / 9.5, // one grid line to each line of the lead
placement: { ...centred(line(LEAD_AT)), size: { width: mm(MEASURE) } } },
] },
};
// Every chapter opens on a recto: 'odd' adds a blank verso only after a chapter that ends on
// a recto, where the default 'always-odd' leaves a blank page after every chapter.
// marginBottom 0: the level's default 0.5 em would start the text a line lower.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
marginBottom: pt(0), italic: true, advancedDesign: opener };
Ingredientes
- Funciones
- Aperturas diseñadasCapítulos que abren en página imparCabeceras por secciónMárgenes simétricosEstilos de títuloCubiertas, portadas y colofonesAtributos de títuloTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaGeometría por secciónCabeceras según el tipo de páginaCabeceras y foliosMetadatos del documentoEstilos de párrafoEspacio vertical explícitoFiguras y tablas como recursosTipos de recurso propiosFiguras justo aquíColor del papelViudas, huérfanas y líneas cortas
- Tipografía
- Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- Recursos
cover-1190.jpgcover-it-1190.jpg- La vista del golfo de la cubierta, una pintura (Generated With Diffusion Models, original)
- La cubierta de la edición italiana: un detalle de Settignano (h. 1880), óleo sobre lienzo; escaneado de Wikimedia Commons, un recorte de 1744 × 1669 px reducido a 1190 px de ancho (Telemaco Signorini, dominio público)
- El florón de manzanilla, dibujado en código con la paleta de la página (Ignacio Ferro, MIT)
Elaboración
#1 · La apertura sale del título y de su atributo
El código es la respuesta corta de arriba. Los capítulos de Chopin solo llevan número, así que el título de cada uno en Markdown es ese número (# I), y {titleText} lo imprime. {attr.lead} imprime el atributo lead del título, que contiene la primera frase del capítulo; el párrafo de Markdown que va debajo empieza por la frase siguiente (atributos de encabezado). La primera frase va centrada, y el \n de cada atributo la corta por el sentido, tras cage y tras bright;. La frase empieza nueve líneas de la rejilla por debajo del borde superior de la caja de texto, y un minHeight de 12 líneas deja una línea en blanco debajo; sin minHeight, el texto arranca pegado a la frase (apertura a toda página y diseño avanzado). marginBottom: pt(0) sustituye el margen de medio cuerpo que el nivel trae por defecto y que bajaría el texto una línea.
breakBefore con paridad 'odd' lleva cada capítulo a una página impar, con una par en blanco solo tras un capítulo que acaba en impar (salto de página antes del encabezado). Para forzar una página impar donde no hay título, escribe :::pagebreak{parity="odd"} en el Markdown; en una maquetación de dos o más columnas, :::columnbreak pasa el texto a la columna siguiente (:::pagebreak).
#2 · Una página de rústica con líneas enteras
const TRIM = { width: 140, height: 216 }; // mm: 5½ × 8½ in
const [TOP, INNER, OUTER] = [22, 20, 15.5]; // mm; mirrored, so INNER is left on a recto
const LINES = 35; // every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 104.5 mm: about 69 characters of Crimson Pro
const MM_PER_PT = 25.4 / 72;
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 * MM_PER_PT),
left: mm(INNER), right: mm(OUTER), mirror: true },
};
El margen inferior es lo que queda de los 216 mm de alto tras el margen superior y 35 líneas de 14 pt, así que todas las páginas llenas acaban en la misma línea, como la 3 y la 4. Con mirror: true, el margen interior de 20 mm queda del lado del lomo tanto en las impares como en las pares (márgenes simétricos). La medida de 104,5 mm admite unos 69 caracteres de Crimson Pro de 10,5 pt. El texto base admite espacios entre palabras de 0,7 a 1,9 veces el normal; con el mínimo por defecto, 0,6, una línea de estas páginas se cierra hasta 0,62.
#3 · Cabeceras que se saltan las aperturas y las páginas en blanco
// {author} and {title} come from the frontmatter.
const HEAD_Y = 12; // mm from the top edge to the top of the running heads
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
const head = (id, content, parity, edge, x, style) => ({
kind: 'text', id, content, parity, pages: 'body', // never on openers or blank pages
fontSize: pt(9), color: col('muted'), ...style,
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD_Y) } },
});
const smallCaps = { fontFamily: LABEL, fontWeight: 600, letterSpacing: pt(1.2) };
const italic = { fontFamily: DISPLAY, italic: true, fontWeight: 500, fontSize: pt(9.75) };
const folio = { fontFamily: TEXT, color: col('ink') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-author', '{author}', 'even', 'top', -SHIFT, smallCaps),
head('recto-title', '{title}', 'odd', 'top', SHIFT, italic),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
// Openers carry a drop folio instead, centred under the text block.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
pages: 'opener', fontFamily: TEXT, fontSize: pt(9), color: col('muted'), align: 'center',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(7) } } }] };
parity: 'even' pone el nombre de la autora, en versalitas de Cormorant SC, en las páginas pares, y 'odd', el título en cursiva en las impares; los folios van en el borde exterior de la caja de texto. pages: 'body' aparta los cuatro elementos de las aperturas y de la página 6, la par en blanco que añade el salto con paridad. Con pages: 'all', esa página imprimiría 6 y Kate Chopin. Las aperturas llevan en su lugar un folio al pie, un elemento del footer que pages: 'opener' reserva para ellas (elementos de texto).
#4 · La cubierta es una sección sin cabeceras
// Page 1 is a recto (gotcha: parity-page1-recto): the cover, the colophon on its verso, and
// chapter I on page 3. # The Awakening {style="cover"} opens the section; chapter I closes it.
// The colophon: 2 + 2 + 1 lines of 11 pt and two gaps of 14.5 pt make 84 pt, six grid lines.
const COLOPHON_LINES = 6;
const COLOPHON_TOP = TOP + (LINES - COLOPHON_LINES) * LEAD * MM_PER_PT; // mm: the section's margin
const onPage = (y) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } }); // y mm down
const cover = {
id: 'cover',
header: { elements: [] }, footer: { elements: [] }, // no running heads on p. 1 or p. 2
margins: { top: mm(COLOPHON_TOP) },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'art', resourceId: 'cover',
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill' } } },
{ kind: 'text', id: 'title', content: '{title}', fontFamily: DISPLAY, italic: true,
fontWeight: 500, fontSize: pt(50), lineHeight: 1, color: col('ink'), align: 'center',
placement: onPage(155) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
color: col('rubric'), placement: { ...onPage(179), size: { width: mm(18) } } },
{ kind: 'text', id: 'author', content: '{author}', ...smallCaps, fontSize: pt(12),
letterSpacing: pt(2.4), color: col('rubric'), align: 'center', placement: onPage(184) },
] } },
};
const colophon = { id: 'colophon', fontSize: pt(8), lineHeight: pt(11), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), spaceBetween: pt(14.5) };
La cubierta es un título, # The Awakening {style="cover"}. Su estilo coloca la pintura en los 134 mm superiores, el título del frontmatter en 50 pt y el nombre de la autora en versalitas. El estilo rige además la sección que abre ese título, las páginas 1 y 2, hasta el capítulo I. Su header y su footer vacíos quitan el folio al pie de la cubierta y las cabeceras del colofón. Su margen superior coloca el colofón en las seis últimas líneas de la caja de texto, así que la última línea del colofón queda a la altura de la última de la página 3 (estilos de encabezado). La columna de la sección empieza a 165 mm, y el diseño, anclado a la página y al sangrado, se pinta igualmente por encima: a un diseño que se queda en la columna solo lo recorta el pie de esta.

#5 · Un florón cierra cada capítulo
// At a chapter's end: :::space, then ::resource{id="tailpiece-1"} (double quotes: gotcha
// resource-double-quotes). The space adds a line to the gap the embed keeps above it.
const ornament = { id: 'ornament', name: 'Ornament', shortLabel: '', captionPrefix: '',
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
defaultPlacement: { position: 'here', width: 0.17, align: 'center' } };
const svg = (id, fileId, width, height, altText) => ({ id, typeId: 'ornament', kind: 'svg',
svg: { fileId, width, height }, altText, createdAt: 0, updatedAt: 0 });
// The cover is a painting, a JPEG in assets/ cut to the art's 140 × 134 mm, declared at its pixels;
// the it edition's is a detail of Signorini's Settignano.
const painting = { id: 'cover', typeId: 'ornament', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: t({ en: 'cover-1190.jpg', it: 'cover-it-1190.jpg' }), format: 'jpeg',
width: 1190, height: 1139 },
altText: t({ en: 'The gulf seen between the trunks of water-oaks, a lugger on the horizon; a '
+ 'white sunshade comes up from the beach through the camomile.',
pt: 'O mar visto entre os troncos de duas árvores, um veleiro no horizonte; uma sombrinha '
+ 'branca sobe da praia por um caminho entre flores amarelas e brancas.',
fr: 'La mer vue entre les troncs de deux arbres, un voilier à l’horizon ; une ombrelle '
+ 'blanche monte de la plage par un chemin entre des fleurs jaunes et blanches.',
de: 'Das Meer zwischen den Stämmen zweier Bäume, ein Segelboot am Horizont; ein weißer '
+ 'Sonnenschirm kommt vom Strand einen Weg zwischen gelben und weißen Blumen herauf.',
it: 'Una strada di Settignano: la bottega del pane e del vino, una donna seduta sulla '
+ 'soglia, un gatto sul selciato al sole.' }) };
const resources = [
painting,
// ::resource places each ornament once, so each chapter end has its own id.
...t({ en: ['I', 'II'], pt: ['I', 'II', 'III'], fr: ['I', 'II'], de: ['I', 'II'], it: ['I', 'II'] })
.map((n, i) => svg(`tailpiece-${i + 1}`, 'fleuron.svg', 40, 12,
t({ en: `A camomile flower between two sprigs closes chapter ${n}.`,
pt: `Uma flor de camomila entre dois ramos fecha o capítulo ${n}.`,
fr: `Une fleur de camomille entre deux brins clôt le chapitre ${n}.`,
de: `Eine Kamillenblüte zwischen zwei Zweigen schließt das Kapitel ${n}.`,
it: `Un fiore di camomilla tra due rametti chiude il capitolo ${n}.` }))),
];
El tipo de adorno no tiene prefijo de pie, así que la flor de manzanilla se imprime sin rótulo, con un ancho del 17 % de la medida, en el lugar de ::resource{id="tailpiece-1"} (tipos de recurso). Una inserción en línea deja una línea de la rejilla por encima, y el :::space que la precede añade otra entre la última línea del capítulo y la flor (:::space). Los dos florones usan el mismo archivo, fleuron.svg, con dos identificadores distintos, porque cada recurso se coloca una sola vez.
La receta completa
// ═══ Postext Cookbook · Nº 038 · Trade paperback: sunk openers and recto chapters ═══
// https://postext.dev/en/cookbook/trade-paperback-novel
// Code: MIT · Text: Chopin, Machado, Goncourt, Collodi, Keyserling (PD) · Covers: diffusion models, Signorini
// Fonts: Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: 'en' Chopin|'pt' Machado|'fr' Goncourt|'de' Keyserling|'it' Collodi
const RECIPE = 'trade-paperback-novel';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
ink: '#231d18', // the text: a warm near-black
rubric: '#8e3b22', // the one accent: the opener's hairline, the author, the tailpiece
muted: '#6e655b', // running heads, folios on openers, the colophon
paper: '#fbf7ef', // a cream book 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 engine's defaults (headings, lists, callouts, captions) link to 'main-color', the rubric.
{ id: 'main-color', name: 'rubric (defaults)', value: { hex: palette.rubric, model: 'hex' } },
];
const TEXT = 'Crimson Pro'; // the text face
const DISPLAY = 'Cormorant Garamond'; // italic numerals and the cover's title
const LABEL = 'Cormorant SC'; // small capitals: the lead, the author's name
const [BODY, LEAD] = [10.5, 14]; // pt: the body size and its leading, the grid's pitch
const line = (n) => pt(n * LEAD); // n grid lines
// #region page: a 140 × 216 mm trade page whose text block holds 35 whole lines
const TRIM = { width: 140, height: 216 }; // mm: 5½ × 8½ in
const [TOP, INNER, OUTER] = [22, 20, 15.5]; // mm; mirrored, so INNER is left on a recto
const LINES = 35; // every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 104.5 mm: about 69 characters of Crimson Pro
const MM_PER_PT = 25.4 / 72;
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 * MM_PER_PT),
left: mm(INNER), right: mm(OUTER), mirror: true },
};
// #endregion
// #region answer: a sunk opener: the numeral, a hairline, and the first sentence in small caps
// # I {lead="A green and yellow parrot, … kept repeating over and over:"}
// The heading's text is the numeral, printed by {titleText}; the chapter's first sentence
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
#Deja que el capítulo II siga en la página siguiente
Con la paridad 'any', el capítulo II empieza en la página 6, que es par, y el libro termina en la 7; el folio al pie se centra en la caja de texto, no en la página, así que en esa par sigue quedando bajo el centro del texto.
-const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
+const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },#Marca un cambio de escena dentro de un capítulo
Entre dos líneas :::space, la misma flor marca un cambio de escena, y el párrafo siguiente empieza sin sangría porque indentAfterHeading está desactivado. Tras seemed long to him., la flor cae al pie de la página 4; el segundo espacio ya no cabe allí y desaparece. El cambio añade cuatro líneas, que empujan el florón del capítulo I, solo, a la página 6, bajo una cabecera, así que tendrás que volver a ajustar el capítulo cuando añadas uno.
const resources = [
+ svg('break-1', 'fleuron.svg', 40, 12, 'A scene break.'),That was why the morning seemed long to him.
:::space
::resource{id="break-1"}
:::space
“You are burnt beyond recognition,” he added, …Errores frecuentes
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 →
Error frecuente
::resource{id="…"} solo admite comillas dobles
Una inserción de bloque solo se reconoce como ::resource{id="…"} con comillas dobles; cualquier otra forma se queda en el texto como una línea visible. Figuras justo aquí →
Comprobación del Sandbox · parityCascade
Cascada de paridad
Por qué. Los saltos con paridad se acumulan y producen más de dos páginas en blanco seguidas.
Solución. Revisa los saltos always-odd y las paridades de breakBefore; en capítulos cortos, la paridad any suele evitar esas páginas en blanco. Documentación →
- Con
'always-odd', detrás de cada sección va una página separadora en blanco antes del relleno de paridad, así que el capítulo I pasaría a la página 5, tras dos páginas en blanco, y el libro llegaría a diez páginas. - Estas páginas están ajustadas a mano. Con un margen exterior de 16 mm en lugar de 15,5, la página 7 parte after-din-ner por un segundo guion y acaba una línea antes, la 8 cierra un párrafo con el fragmento spondent. y el segundo florón pasa a una novena página. Revisa el pie de todas las páginas cuando cambies la medida, el cuerpo o el hundimiento.
- Mr. y Mrs. van unidos al nombre con un espacio de no separación (U+00A0). El párrafo que acaba en seemed long to him. lleva un espacio corriente, porque unir ahí el nombre abre su primera línea hasta 2,2 veces el espacio normal entre palabras.
Créditos
- Receta
- Ignacio Ferro
- Texto
- The Awakening (El despertar, 1899), capítulos I y II · Kate Chopin · dominio público
- Quincas Borba (1891), capítulos I a III, el texto de la edición portuguesa, en ortografía actualizada · Machado de Assis · dominio público
- Madame Gervaisais (1869), capítulos I y II, el texto de la edición francesa, con la ortografía de la primera edición · Edmond et Jules de Goncourt · dominio público
- Beate und Mareile (Beate y Mareile, 1903), capítulos 1 y 2 (el segundo abreviado), el texto de la edición alemana, con la ortografía de la edición de S. Fischer · Eduard von Keyserling · dominio público
- Le avventure di Pinocchio (Las aventuras de Pinocho, Felice Paggi, Florencia, 1883), capítulos I y II, el texto de la edición italiana, con la ortografía de la primera edición, sin los sumarios de los capítulos · Carlo Collodi · dominio público
- El colofón · Postext Cookbook · original
- Imágenes
- La vista del golfo de la cubierta, una pintura · Generated With Diffusion Models · original
- La cubierta de la edición italiana: un detalle de Settignano (h. 1880), óleo sobre lienzo; escaneado de Wikimedia Commons, un recorte de 1744 × 1669 px reducido a 1190 px de ancho · Telemaco Signorini · dominio público
- El florón de manzanilla, dibujado en código con la paleta de la página · Ignacio Ferro · MIT
- Fuentes
- Crimson Pro (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant SC (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)


