En pocas palabras
Las primeras páginas de una edición de bolsillo de Frankenstein. Enseña a numerar las páginas previas a la novela con i, ii, iii y a empezar de nuevo en la página 1 cuando arranca la historia.
Lo que vas a componer
Las primeras hojas de Frankenstein en una edición de bolsillo de 129 × 198 mm: una cubierta con un rayo sobre el Mont Blanc y el dorso en blanco, la anteportada, un frontispicio con el barco de Walton atrapado en el hielo frente a la portada, los créditos al pie de su reverso, la dedicatoria a Godwin sobre el epígrafe de Milton, el índice y el prólogo de 1818. Esas diez páginas se cuentan de la i a la x, aunque solo el índice y el prólogo llevan número. La novela empieza con la Carta I en página impar, bajo la aurora boreal, y su folio, 1, ocupa el sitio de la x de enfrente. La carta sigue hasta la firma de Walton. En el índice, la ix del prólogo y la 1 de la carta salen de las páginas compuestas, y un visor de PDF numera igual. La cubierta, el frontispicio y la aurora boreal son pinturas generadas con modelos de difusión y cargadas como mapas de bits JPEG; la marca editorial y el cristal de hielo están dibujados en código.
Esta receta responde a
- ¿Cómo numero los preliminares en romanos y vuelvo a empezar en 1 con el capítulo 1?
- ¿Cómo hago una cubierta, una portadilla, una portada y un colofón?
- ¿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 inserto páginas en blanco a propósito, o empiezo una sección en una doble página nueva?
- ¿Cómo compongo un epígrafe, una dedicatoria, una firma o una cita destacada con una comilla grande?
La respuesta corta
// The page counter starts in lower-case roman: the cover is page i. After the Preface, two
// directives in the Markdown count again from 1 on the next recto:
// :::pagebreak{parity="odd"}
// :::numbering{format="decimal" startAt=1}
// :::numbering takes effect on the next page that starts (gotcha: numbering-next-page). Level 1
// breaks to 'odd', so here the pagebreak changes nothing; it finds the recto when a level breaks
// with parity 'any' or not at all. Never with 'always-odd': the blank pages would stack up.
const pageNumbering = { format: 'lower-roman', startAt: 1 }; // startAt spelled out: cover = i
// One folio design, centred under the text block. {pageNumber} prints the page's own label,
// so the same design sets "x" in the front matter and "1" on the first page of the novel.
const folio = (pages) => text(`folio-${pages}`, '{pageNumber}', 'Playfair Display SC', 8.5,
at('top', 0, 9), { letterSpacing: pt(0.8), pages }); // lower case sets as small capitals
// The front matter is a heading style, unnumbered and left out of the contents (a heading
// can opt back in with {toc="true"}). It prints no running heads and puts a folio on every
// page of the section. Parity 'any', because the contents fall on a verso.
const front = {
id: 'front', numbered: false, toc: false, breakBefore: { enabled: true, parity: 'any' },
header: { elements: [] }, footer: { elements: [folio('all')] }, ...frontLook,
};
// The novel keeps the document's furniture: heads on its body pages, the folio on openers.
const footer = { elements: [folio('opener')] };
// Hook-up in config(): page: { pageNumbering }, headingStyles: [front] and footer at the top
// level. frontLook, set above, is the look of the prelims' openers.
Ingredientes
- Funciones
- Preliminares en romanosÍndice generalCabeceras por secciónCubiertas, portadas y colofonesSaltos de página y de columnaEstilos de títuloCapítulos sin númeroGeometría por secciónImágenes en los diseños de páginaCapítulos que abren en página imparEstilos de párrafoAperturas diseñadasAtributos de títuloMetadatos del documentoCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosExportación a PDFMarcadores del PDFFiguras y tablas como recursos
- Tipografía
- Fanwood Text, Playfair Display SC, Cinzel (SIL OFL 1.1)
- Recursos
band-1400.jpgcover-1000.jpgplate-1000.jpg- La cubierta: un rayo sobre el Mont Blanc y el lago de Ginebra (Generated With Diffusion Models, original)
- El frontispicio: un bergantín atrapado en el hielo y un trineo de perros a lo lejos (Generated With Diffusion Models, original)
- La apertura de la Carta I: aurora boreal sobre el Neva helado (Generated With Diffusion Models, original)
Elaboración
#1 · Cada hoja es un título con diseño
// Each leaf is a heading, so it opens its page, gets a PDF bookmark and takes a design. The
// leaves are unnumbered, left out of the contents and print no heads or folio (blind folios).
// Parity 'any', or each would inherit level 1's odd break (gotcha: style-inherits-break).
const blind = { numbered: false, toc: false, breakBefore: { enabled: true, parity: 'any' },
header: { elements: [] }, footer: { elements: [] } };
const PLATE_H = 126; // mm: the frontispiece, as wide as the text block; its caption hangs below
// mm from the trim: the imprint's eleven lines end on the text block's last baseline.
const IMPRINT_TOP = 126.4; // re-tune it whenever the imprint changes
const leaves = [
// i: bled to the trim. The painting is as tall as the page, so the cover takes it whole.
{ id: 'cover', ...blind, advancedDesign: design([
image('cover', at('top-left', 0, 0, { width: 'fill', to: 'bleed' })),
label('author', '{author}', 9, onPage(22), 'bone', 2.6),
text('title', '{title}', 'Fanwood Text', 56, onPage(31), { color: col('bone'), lineHeight: 1 }),
text('subtitle', '{subtitle}', 'Fanwood Text', 13, onPage(53), { ...on('ice'), italic: true }),
label('series', '{attr.publisher}', 7, onPage(168), 'ice', 2),
]) },
// iii: the half title waits for a recto, so the back of the cover, ii, is left blank.
{ id: 'half', ...blind, breakBefore: { enabled: true, parity: 'odd' }, advancedDesign: design([
text('title', '{title}', 'Playfair Display SC', 17, at('top', 0, 34), { letterSpacing: pt(3) }),
image('crystal', at('top', 0, 45, { width: 6 })),
]) },
{ id: 'plate', ...blind, advancedDesign: design([ // iv: faces the title page
image('plate', at('top-left', 0, 0, { width: 'fill' })),
text('caption', '{attr.caption}', 'Fanwood Text', 8.8,
at('top', 0, PLATE_H + 5, { width: 80 }), { italic: true, lineHeight: 1.3 }),
label('source', '{attr.source}', 7.5, at('top', 0, PLATE_H + 16), 'muted', 1.3),
]) },
{ id: 'title', ...blind, advancedDesign: design([ // v: four frontmatter fields, one attribute
label('edition', 'The text of {publishDate}', 7.5, at('top', 0, 22), 'accent', 1.8),
text('title', '{title}', 'Playfair Display SC', 33, at('top', 0, 30),
{ fontWeight: 700, letterSpacing: pt(0.4), lineHeight: 1 }),
text('subtitle', '{subtitle}', 'Fanwood Text', 14, at('top', 0, 44), { italic: true }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.8), color: col('accent'),
placement: at('top', 0, 60, { width: 14 }) },
label('author', '{author}', 10, at('top', 0, 66), 'ink', 2.4),
image('mark', at('top', 0, 126, { width: 11 })),
label('publisher', '{attr.publisher}', 7.5, at('top', 0, 140), 'muted', 1.5),
]) },
// vi: the section's margins set the small print low, in a 70 mm measure against the outer
// margin. hidden: the heading opens the page and names its bookmark, and prints nothing.
{ id: 'imprint', ...blind, hidden: true,
margins: { top: mm(IMPRINT_TOP), left: mm(TRIM_W - OUTER - 70) } },
// vii: dedication and epigraph, under a heading whose design is an ornament and no title.
{ id: 'quiet', ...blind,
advancedDesign: design([image('crystal', at('top', 0, 24, { width: 6 }))], 34) },
];
// :::paragraphs blocks set the small print, the dedication, the epigraph and Walton's close;
// the dedication and the verse take one paragraph per line, so no line of them can reflow.
const VERSE_IN = 22; // mm: the indent that centres the verse as a block
const SOURCE_IN = 55; // mm: 'Paradise Lost' ends under the end of the longest line of verse
const prelimStyles = [
{ id: 'small-print', fontSize: pt(7.6), lineHeight: pt(10.4), textAlign: 'left',
firstLineIndent: pt(0), spaceBetween: pt(5.2) },
// Small capitals, with the italic lines of the 1818 page, leaded as one inscription.
{ id: 'dedication', fontFamily: 'Playfair Display SC', fontSize: pt(10), lineHeight: pt(15),
textAlign: 'center', firstLineIndent: pt(0) },
{ id: 'verse', fontSize: pt(10), textAlign: 'left', firstLineIndent: mm(VERSE_IN),
marginTop: pt(LEAD * 4) }, // on the body's 14 pt leading, which a style inherits
{ id: 'source', fontFamily: 'Cinzel', fontSize: pt(7.5), textAlign: 'left',
firstLineIndent: mm(SOURCE_IN), marginTop: pt(4), color: col('muted') },
{ id: 'signature', textAlign: 'right', firstLineIndent: pt(0) }, // the letter's close
];
Un título abre página y sale como marcador en el PDF; el diseño de su estilo coloca los textos y las imágenes de la hoja. Con numbered: false y toc: false, las hojas no cuentan como capítulo ni salen en el índice. Como la cabecera y el pie están vacíos, esas páginas cuentan pero no se folian: la portada no lleva número y sigue siendo la página v, y por eso el prólogo puede ser la ix. Solo la anteportada conserva el salto a impar, y eso deja en blanco el dorso de la cubierta. Los créditos, la dedicatoria, el epígrafe y la despedida de Walton son bloques :::paragraphs con los estilos del final del fragmento.
#2 · El índice toma los números de la composición
// Entries take the body's face and ink, and start on the Preface's first baseline, facing it.
const contents = {
levels: [{ level: 1, fontSize: pt(12), lineHeight: pt(PREFACE.lead) }],
// The folio's face: "ix" in small capitals, then a plain 1. The leader takes it too.
pageNumber: { fontFamily: 'Playfair Display SC', fontSize: pt(10), color: col('accent'),
width: mm(8) },
leader: { char: '. ', gap: mm(2.5) },
// A second line from the heading's to="…" attribute: whom each letter is written to.
subtitle: { enabled: true, attr: 'to', fontSize: pt(9.5), color: col('muted') },
};
:::toc recoge cada título que su estilo deja pasar, con la etiqueta de la página donde cae (índice general). El índice y el prólogo comparten el estilo front, que fija toc: false, y el prólogo lo anula con {toc="true"}. Ni el prólogo ni la Carta I van numerados, así que sus entradas no llevan número de capítulo. La segunda línea de la entrada de la carta es su atributo to="…". Los números de página van en la letra de los folios. Las entradas arrancan a la altura de la primera línea del prólogo, de modo que las dos páginas enfrentadas casan.
#3 · La novela abre en página impar, bajo la aurora boreal
const BAND = 104; // mm from the trim to the foot of the drawing, which fades into the paper
// minHeight ends AIR mm below it and the first line takes the next grid line. to: 'bleed' is the
// trim until page.cutLines adds a bleed; 3 mm drop the foot 1.8 mm, still above that line.
const AIR = 2;
const opener = design([
image('band', at('top-left', 0, 0, { width: 'fill', to: 'bleed' })),
label('to', '{attr.to}', 7.5, onPage(19), 'ice', 2),
text('title', '{titleText}', 'Playfair Display SC', 46, onPage(25),
{ color: col('bone'), lineHeight: 1 }),
text('dateline', '{attr.dateline}', 'Fanwood Text', 10.5, onPage(44),
{ italic: true, color: col('bone') }),
// The drawing reserves down to its foot. minHeight, counted from the text block (TOP below
// the trim), is a floor AIR mm lower, which sends the first line one grid line further down.
], BAND - TOP + AIR);
// Walton's letters come before Chapter I: they take the novel's opener but no number.
const letter = { id: 'letter', numbered: false };
La pintura sale a sangre por la cabeza de la página y se funde con el papel al pie, donde empieza la carta. La apertura reserva la página hasta el pie de la pintura, a 104 mm del borde superior, y minHeight pone un suelo 2 mm más abajo, con lo que la carta empieza una línea de la rejilla después, libre del fundido (apertura a toda página y diseño avanzado). El antetítulo y la fecha salen de los atributos to y dateline del título. La Carta I añade {style="letter"}, un estilo que se limita a fijar numbered: false, porque las cartas de Walton van antes del capítulo I y no se numeran.
#4 · Las cabeceras vuelven con la novela
const HEAD_Y = 12.5; // mm from the trim to the heads' line
const HEAD_GAP = 8; // mm from the outer margin, where the folio hangs, to the words beside it
const head = (id, content, parity, edge, x, extra = {}) => ({ ...label(id, content, 7.5,
at(edge, x, HEAD_Y, { to: 'page' }), 'muted', 1.4), align: 'left', parity, pages: 'body',
...extra }); // pages: 'body' keeps them off the opener
const numeral = { fontFamily: 'Playfair Display SC', fontSize: pt(8.5), fontWeight: 400,
letterSpacing: pt(0.6), color: col('ink') }; // folios in the folio face, as on the openers
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, numeral),
head('verso-title', '{title}', 'even', 'top-left', OUTER + HEAD_GAP),
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(OUTER + HEAD_GAP)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, numeral),
] };
Una sección conserva la cabecera y el pie del documento salvo que su estilo los sustituya. Los preliminares sustituyen los dos y el estilo de las cartas no, así que desde la página 1 la novela lleva estas cabeceras en sus páginas corrientes y, en la apertura, el folio al pie que define la respuesta corta. {pageNumber} imprime la etiqueta de la página en la que está, y por eso el mismo diseño de folio, el de folio(), pone x a un lado del lomo y 1 al otro.
#5 · El PDF lleva la misma numeración
// :::toc lists each heading with the label of the page it lands on; buildDocument lays the
// document out again until those labels stop moving (ix for the Preface, 1 for Letter I).
const doc = await buildDocumentWithFonts({ markdown, resources }, config(), kitFonts(FONTS));
showPages(doc, { title: 'Frankenstein · the opening leaves' });
// The PDF gets /PageLabels from the same labels: a viewer numbers its pages i–x, then 1, 2.
offerPdf(() => renderToPdf(doc, { fontProvider: fontsourceProvider, resourceBytes: imageBytes }),
`${RECIPE}.pdf`);
buildDocument repite la composición hasta que las etiquetas del índice dejan de cambiar, así que basta con una llamada. renderToPdf lleva esas etiquetas al PDF: en un visor que lea las etiquetas de página, la numeración va de la i a la x y luego desde el 1, e «ir a la página 1» abre la Carta I. Cada título da un marcador con su propio texto, y por eso las hojas llevan nombres sencillos (en inglés, como la muestra): Cover, Half title, Frontispiece, Title page, Imprint, Dedication.
La receta completa
// ═══ Postext Cookbook · Nº 006 · Front matter: roman folios, then page 1 ═══════════
// https://postext.dev/en/cookbook/front-matter-roman-to-arabic
// Code: MIT · Text: M. & P. B. Shelley, 1818 (PD) · Pictures: diffusion models; marks drawn in code
// Fonts: Fanwood Text, Playfair Display SC, Cinzel (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'front-matter-roman-to-arabic';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
ink: '#1c1d21', // text: a cold near-black
accent: '#3d5a70', // steel blue, the one accent on paper: contents folios, the rule, the marks
muted: '#6a665f', // running heads, sources, the second lines of the contents
paper: '#fbf8f2', // the page
night: '#131a24', ice: '#a9c6d6', bone: '#efe9dc', // the drawings' inks, and the type on them
};
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' } },
];
const TRIM_W = 129, TRIM_H = 198; // mm: a pocket classic
const TOP = 21, BOTTOM = 23, INNER = 17, OUTER = 15; // margins, mm; heads align to OUTER
const MEASURE = TRIM_W - INNER - OUTER; // 97 mm: the text block, and the frontispiece's width
const LEAD = 14; // body leading in pt: 31 lines fill the text block
const PREFACE = { size: 9.8, lead: 13.3 }; // pt: the preface, a size under the novel's 10.5/14
// Design-slot shorthands. at(): a placement from an anchor's edge; edge 'top' centres it.
const wide = (width) => (width === 'fill' ? 'fill' : mm(width));
const at = (edge, x, y, { width, to = 'container' } = {}) => ({ anchor: { to, edge },
offset: { x: mm(x), y: mm(y) }, ...(width !== undefined && { size: { width: wide(width) } }) });
const onPage = (y) => at('top', 0, y, { to: 'page' }); // centred on the page, y mm from the trim
const on = (id) => ({ color: col(id) }); // a design text's ink
// overflow 'wrap' for the running heads too, where a text too wide would end in '…'.
const text = (id, content, font, size, placement, extra = {}) => ({ kind: 'text', id, content,
fontFamily: font, fontSize: pt(size), color: col('ink'), align: 'center', overflow: 'wrap',
placement, ...extra });
const label = (id, content, size, placement, ink, tracking) => text(id, content, 'Cinzel', size,
placement, { fontWeight: 600, letterSpacing: pt(tracking), textTransform: 'uppercase',
...on(ink) }); // the label voice: Cinzel capitals, tracked
const image = (id, placement) => ({ kind: 'image', id, resourceId: id, placement });
// A heading's design. minHeight (mm) where the text must start lower than the elements reach.
const design = (elements, minHeight) => ({ enabled: true, slot: { elements },
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
#Numera los preliminares en mayúsculas
Los romanos en mayúscula salen en versales de la letra de los folios, más altas que las versalitas de los romanos en minúscula.
-const pageNumbering = { format: 'lower-roman', startAt: 1 }; // startAt spelled out: cover = i
+const pageNumbering = { format: 'upper-roman', startAt: 1 }; // startAt spelled out: cover = I#Numera el libro de corrido
Quita startAt y la cuenta sigue en arábigos: la Carta I pasa a ser la página 11, como en los libros que cuentan los preliminares con el texto.
-:::numbering{format="decimal" startAt=1}
+:::numbering{format="decimal"}#Prescinde del frontispicio
Borra el encabezado # Frontispiece y manda la portada a página impar: la página iv queda en blanco, el prólogo sigue siendo la ix y la Carta I, la 1.
- { id: 'title', ...blind, advancedDesign: design([ // v: four frontmatter fields, one attribute
+ { id: 'title', ...blind, breakBefore: { enabled: true, parity: 'odd' },
+ advancedDesign: design([ // v: four frontmatter fields, one attribute#Añade sangre y marcas de corte para imprenta
Con cutLines, la cubierta y la apertura, ancladas al sangrado, rebasan el corte en 3 mm; los folios y el número de páginas no cambian (marcas de corte).
backgroundColor: col('paper'), pageNumbering,
+ cutLines: { enabled: true }, // a 3 mm bleed and crop marksErrores frecuentes
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 →
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 →
Error frecuente
Una página toma la cabecera de la última sección que empieza en ella
Cuando dos estilos de título empiezan en la misma página, esta toma la cabecera, el pie y la paleta del último. Una página en blanco de separación pertenece al capítulo anterior, y el relleno de paridad al siguiente. Cabeceras por sección →
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 →
Comprobación del Sandbox · numberingInvalidFormat
Formato de numeración no válido
Por qué. El formato de un :::numbering no es ninguno de decimal, lower-roman, upper-roman, lower-alpha o upper-alpha.
Solución. Usa uno de los cinco formatos de número de página; las listas y los recursos los escriben de otro modo. Documentación →
- Las hojas preliminares heredan el salto
'odd'del nivel 1. Si no lo tocas, cada una espera a una página impar. Los preliminares pasan entonces de diez páginas a catorce, con cuatro pares más en blanco, y el frontispicio queda frente a una página vacía en vez de frente a la portada. Pon en cada estilo su propio salto conparity: 'any', como hace esta receta, o quítalo conbreakBefore: { enabled: false }, porque un título conspan: 'page'abre página de todos modos. - Quita el
:::pagebreakde delante de:::numberingsi el nivel 1 salta con'always-odd', el valor por defecto del H1 en el motor. Si el texto anterior acaba en página impar, el salto de página rellena hasta la impar siguiente, y luego el título añade su página de separación y vuelve a rellenar, con lo que quedan tres páginas en blanco seguidas en lugar de una. Tras un salto'odd', como aquí, el:::pagebreakno cambia nada; tras'any', es lo que pone la página 1 en impar. - Si el prólogo crece una página, la Carta I se va dos páginas más allá, porque el salto a impar le añade delante una página par en blanco. Revisa el número de páginas cada vez que toques los preliminares.
- Los puntos guía del índice usan la letra y el color de los números de página, y
toc.leaderno tiene color propio, así que aquí salen en azul acero.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Frankenstein; or, The Modern Prometheus (1818): la dedicatoria, la Carta I, una frase de la Carta IV (el pie del frontispicio) y otra del volumen I, capítulo VI (citada en un comentario del código) · Mary Shelley · dominio público
- El prólogo sin firma de la edición de 1818 (según la atribución habitual) · Percy Bysshe Shelley · dominio público
- Paradise Lost (1667), libro X, versos 743–745: el epígrafe de las primeras hojas de 1818 · John Milton · dominio público
- Imágenes
- La cubierta: un rayo sobre el Mont Blanc y el lago de Ginebra · Generated With Diffusion Models · original
- El frontispicio: un bergantín atrapado en el hielo y un trineo de perros a lo lejos · Generated With Diffusion Models · original
- La apertura de la Carta I: aurora boreal sobre el Neva helado · Generated With Diffusion Models · original
- Fuentes
- Fanwood Text (SIL OFL 1.1) · Playfair Display SC (SIL OFL 1.1) · Cinzel (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)


