En pocas palabras
Una edición crítica de un poema de Milton. Cada cinco versos aparece un número en el margen, y las notas tras el poema remiten por número a los versos que explican.
Lo que vas a componer
Lycidas, la elegía de Milton a la muerte de Edward King, en una edición crítica de 138 × 216 mm que sigue el texto y la ortografía de los Poems de 1645. La primera página se abre bajo una rama de laurel, con el título en versales altas de Imbue sobre la nota preliminar que Milton añadió en 1645. Siguen los 193 versos, con una línea en blanco entre estrofas y los versos cortos sangrados. La numeración va de cinco en cinco, en verde laurel, en una columna de 6 mm del lado exterior: a la derecha del poema en las páginas impares y a la izquierda en las pares. El poema no lleva llamadas de nota. Las notas ocupan las dos páginas siguientes, y cada una empieza por el número de su verso, en la misma Libre Franklin verde de la numeración.
Esta receta responde a
- ¿Cómo numero en el margen cada quinto verso de un poema y remito mis notas a esos números de verso?
- ¿Cómo compongo poesía: un verso por línea, espacio entre estrofas, sangría francesa en los versos que no caben y sin separación silábica?
- ¿Cómo hago notas al pie?
- ¿Cómo compongo en columna y media, con una columna de texto ancha y una lateral estrecha?
- ¿Cómo añado espacio vertical entre dos bloques, si las líneas en blanco no hacen nada?
La respuesta corta
// The poem is one :::verse block, written as 1645 prints it: a line of verse a line, a blank
// line between verse paragraphs and two spaces before a short line. lineNumbers counts its
// lines of verse (a line that turned over would still count once) and prints the multiples
// of five beside their lines, on their baselines. position 'side' puts them in the side
// column of the one-and-a-half layout, flush with its edge next to the verse.
const lineNumbers = {
enabled: true,
count: 'verse', // the lines of :::verse poems; the notes are prose and not counted
interval: 5,
restart: 'document', // one count through the poem
position: 'side',
fontFamily: LABEL, fontSize: pt(7.5), color: col('laurel'),
};
// Hook-up: lineNumbers in the config; the Markdown goes to buildDocument as it is written.
Ingredientes
- Funciones
- Numeración de líneasVerso línea a líneaColumna al margen para flotantesColumna y mediaEstilos de párrafoChips en líneaMárgenes simétricosAperturas diseñadasTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaAtributos de títuloEstilos de títuloMetadatos del documentoCabeceras y foliosCabeceras según el tipo de páginaPaleta de color semántica
- Tipografía
- Linden Hill, Imbue, Libre Franklin (SIL OFL 1.1)
- Recursos
laurel-1040.jpg- La rama de laurel de la primera página, una acuarela (Generated With Diffusion Models, original)
Elaboración
#1 · Cuenta los versos
El código de este paso es la respuesta corta, más arriba. lineNumbers cuenta los versos del poema e imprime el número de cada quinto a su lado, sobre su línea base, en Libre Franklin de 7,5 pt y verde laurel (numeración de líneas). count: 'verse' cuenta solo los versos de los poemas :::verse, así que la nota sobre el texto y las notas tras el poema no llevan número, y un verso demasiado largo para la medida contaría una sola vez: lo que pasa a la línea siguiente no lleva número. restart: 'document' mantiene una sola cuenta en todo el poema. Los números se pintan junto a versos que la composición ya ha colocado, así que nunca mueven ninguno.
#2 · Una columna de seis milímetros
const PT = 25.4 / 72; // mm in a point
const [TRIM_W, TRIM_H] = [138, 216]; // mm
const [TOP, INNER] = [21, 20]; // mm
const LINES = 34; // lines of verse to a page
const BOTTOM = TRIM_H - TOP - LINES * LEAD * PT; // 21.08 mm
const [MEASURE, GUTTER, CHANNEL] = [80, 4, 6]; // mm: the longest line of Lycidas is 78.1 mm
const OUTER = TRIM_W - INNER - MEASURE - GUTTER - CHANNEL; // 28 mm beyond the numbers
const layout = {
layoutType: 'oneAndHalf',
sideColumnRole: 'floats', // the side column takes the numbers, never text
sideColumnSide: 'outer', // right of the verse on a recto, left of it on a verso
// 6 of 90 mm. The zero is Libre Franklin's widest figure, so '100' (4.9 mm) is the widest number.
sideColumnPercent: (CHANNEL / (MEASURE + GUTTER + CHANNEL)) * 100,
gutterWidth: mm(GUTTER),
};
const page = { sizePreset: 'custom', width: mm(TRIM_W), height: mm(TRIM_H), dpi: 150,
margins: { top: mm(TOP), bottom: mm(BOTTOM), left: mm(INNER), right: mm(OUTER), mirror: true } };
Con sideColumnRole: 'floats', la columna estrecha de una disposición oneAndHalf nunca recibe texto (tipos de disposición), y position: 'side' compone en ella los números, contra su borde del lado del verso; el medianil de 4 mm es la distancia entre un verso y su número. sideColumnPercent es un porcentaje de la caja de texto, y el código lo calcula a partir de milímetros: 6 de 90 mm, suficientes para el número más ancho. Las cifras de Libre Franklin son proporcionales, y a 7,5 pt el cero es la más ancha (1,8 mm, frente a 1,2 mm del uno), así que el número más ancho del poema es el 100, con 4,9 mm; el 180 y el 190 miden 4,8 mm. 'outer' sigue a los márgenes simétricos, de modo que los números quedan a la derecha del verso en las páginas impares, alineados a la izquierda, y a su izquierda en las pares, alineados a la derecha: en unas y otras empiezan o acaban a la misma distancia del verso. La columna del verso mide 80 mm, 1,9 mm más que el verso 31, el más largo, así que ningún verso pasa a la línea siguiente.
#3 · El poema es un solo bloque :::verse
// A blank line between verse paragraphs leaves one line of the grid (stanzaSpace, 1). Two
// leading spaces set a short line in 2 em (indentStep, 1 em a space here, against the default
// half em). The verse is ragged, like all the text here; a line too long for the measure would
// turn over and hang 2 em past its own start, but none does at 80 mm.
const verse = { indentStep: em(1) };
const verseStyles = [{ id: 'verse', hangingIndent: em(2) }];
Un bloque :::verse conserva el poema tal como se escribe: cada línea de Markdown es un verso, una línea en blanco separa las estrofas y los espacios delante de un verso son su sangría (:::verse). La línea de apertura indica el estilo del verso y align=start, que alinea el poema con el margen en lugar de centrarlo sobre su verso más largo. Entre dos estrofas queda una línea en blanco de la rejilla (stanzaSpace, una línea). Los catorce versos cortos de Milton, el 4 entre ellos, empiezan con dos espacios, e indentStep: em(1) los convierte en 2 em. El espacio entre estrofas se descarta al principio de una página, así que la página 2 empieza con el verso 15 en lo alto de la caja de texto y el cambio de estrofa entre los versos 14 y 15 no se ve (mira «Errores frecuentes»).
#4 · El laurel, el título y la nota preliminar
const OPENER_LINES = 20; // of the page's 34: the first verse paragraph, 14 lines, takes the rest
const at = (id, edge, y) => ({ anchor: { to: id, edge }, offset: { x: mm(0), y: mm(y) } });
const title = (size, tracking, placement) => ({ kind: 'text', id: 'title', content: '{titleText}',
fontFamily: DISPLAY, fontWeight: 300, fontSize: pt(size), lineHeight: 1,
letterSpacing: pt(tracking), textTransform: 'uppercase', color: col('ink'), placement });
const opener = { enabled: true, minHeight: pt(OPENER_LINES * LEAD), slot: { elements: [
// The laurel ends above the kicker, so the depth comes from the texts: kicker, title and
// headnote reach down 20 lines. minHeight is a floor at the same depth, so a shorter
// headnote leaves the verse on line 21.
{ kind: 'image', id: 'laurel', resourceId: 'laurel',
placement: { anchor: { to: 'page', edge: 'top-right' }, size: { width: mm(104) } } },
{ kind: 'text', id: 'kicker', content: '{author}', fontFamily: LABEL, fontWeight: 500,
fontSize: pt(8), letterSpacing: pt(1.6), textTransform: 'uppercase', color: col('laurel'),
placement: at('container', 'top-left', 50) },
title(66, 2, at('#kicker', 'below', 1)),
// # Lycidas {headnote="In this Monody …"}: the whole headnote in italic, ragged; at
// 64 mm no word stands alone.
{ kind: 'text', id: 'headnote', content: '{attr.headnote}', fontFamily: TEXT, italic: true,
fontSize: pt(9.5), lineHeight: 13 / 9.5, color: col('ink'), align: 'left',
placement: { ...at('#title', 'below', 3), size: { width: mm(64) } } },
] } };
// The poem opens on a recto. Its design stays in the column, and the laurel, anchored to the
// page's corner, is painted above the text block all the same. With the default
// marginBottom the verse would start on line 22 and send line 14 to page 2.
const poem = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
advancedDesign: opener, marginBottom: pt(0) };
El encabezado de primer nivel imprime un diseño en lugar de su propio texto (apertura a toda página y diseño avanzado). {author} sale del frontmatter, y la nota preliminar, de un atributo en la línea del encabezado, # Lycidas {headnote="In this Monody …"} (atributos de encabezado). El laurel acaba por encima del antetítulo, así que la altura de la apertura la dan los textos que tiene debajo: el antetítulo, a 50 mm de lo alto de la caja de texto, el título y las cuatro líneas de la nota preliminar llegan hasta la línea 20 de las 34 de la página, y la primera estrofa, de 14 versos, ocupa el resto. minHeight fija un mínimo a esa misma profundidad: si recortas la nota preliminar a tres líneas, el poema sigue empezando en la línea 21, mientras que sin ese mínimo sube a la 20. marginBottom: pt(0) deja fuera del hueco el margen que el título lleva por defecto; con ese margen, el poema empezaría en la línea 22 y el verso 14 pasaría a la página 2. El diseño se queda en la columna, y el laurel, anclado a la esquina superior derecha de la página, se pinta igualmente desde el corte: a un diseño que se queda en la columna solo lo recorta el pie de esta.
#5 · Notas remitidas al número de verso
const NOTE = 8.6; // pt: the notes, and the note on the text
const noteStyles = [
{ id: 'textnote', fontSize: pt(NOTE), lineHeight: pt(NOTE * 1.33) },
// The note on the text ends on the grid, 2.4 mm below its last line; half a line more
// leaves one blank line before the first note.
{ id: 'note', fontSize: pt(NOTE), lineHeight: pt(NOTE * 1.33), hangingIndent: em(1.6),
marginTop: pt(LEAD / 2) },
{ id: 'colophon', fontFamily: LABEL, fontSize: pt(7), lineHeight: pt(9.5), color: col('muted'),
marginTop: pt(LEAD) },
];
// :chip[8]{style="line"}: Linden Hill has no bold, so the number changes face and colour.
// The chip has no fill, outline or side padding, so nothing is drawn around the number.
const chipStyles = [{ id: 'line', backgroundEnabled: false, borderWidth: pt(0), paddingX: pt(0),
fontFamily: LABEL, fontSize: em(0.9), color: col('laurel') }];
// # Notes {style="notes"} opens the next page under the title's capitals, smaller. A heading
// style keeps the level's break unless it sets its own (gotcha: style-inherits-break). Its
// design stays in the column too, so the title lines up with the notes on either page.
const notesHead = { id: 'notes', breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true,
slot: { elements: [title(30, 1, at('container', 'top-left', 0))] } } };
Las notas remiten a los números de verso, de modo que el poema no lleva llamadas, y van detrás de él, como un comentario, sin quitar líneas a ninguna página del poema. Cada nota empieza por el número del verso que comenta, escrito :chip[8]{style="line"}, seguido del lema en cursiva (las palabras comentadas) y de un corchete de cierre. El chip no tiene fondo, contorno ni relleno lateral, así que solo cambian la letra y el color: Libre Franklin de 7,7 pt en verde laurel (estilos de chip). Linden Hill no tiene negrita, y por eso los números se distinguen por el cambio de letra. El estilo de nota sangra 1,6 em todas las líneas menos la primera, con lo que los números sobresalen a la izquierda, y las notas van en bandera, igual que el verso. # Notes {style="notes"} salta a la página 8 y compone su título con las versales de la apertura, a 30 pt.

#6 · Cabeceras según la paridad
const HEAD = 13; // mm from the trim to the running heads' baseline
// A design text's first baseline sits 0.8 of a line below the top of its box: 0.96 em at the
// default lineHeight of 1.2, which the running heads keep.
const BASE = 1.2 * 0.8;
const head = (id, parity, content, x, size = 7.5, extra = {}) => ({ kind: 'text', id, parity,
content, pages: 'body', fontFamily: LABEL, fontWeight: 500, fontSize: pt(size),
letterSpacing: pt(1.3), textTransform: 'uppercase', color: col('muted'), ...extra,
placement: { anchor: { to: 'page', edge: parity === 'even' ? 'top-left' : 'top-right' },
offset: { x: mm(x), y: mm(HEAD - BASE * size * PT) } } });
const folio = { fontFamily: TEXT, fontWeight: 400, letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
head('verso-folio', 'even', '{pageNumber}', OUTER, 10, folio),
head('verso-head', 'even', '{author}', OUTER + 9),
head('recto-head', 'odd', '{chapterTitle}', -(OUTER + 9)), // LYCIDAS, then NOTES
head('recto-folio', 'odd', '{pageNumber}', -OUTER, 10, folio),
] };
// The two openers carry their folio at the foot instead, at the outer edge of the text block.
const drop = (parity, edge, x) => ({ ...head(`drop-${parity}`, parity, '{pageNumber}', 0, 10,
folio), pages: 'opener', placement: { anchor: { to: 'page', edge },
offset: { x: mm(x), y: mm(-12) } } });
const footer = { elements: [drop('odd', 'bottom-right', -OUTER),
drop('even', 'bottom-left', OUTER)] };
Cada elemento se ancla a la página y se filtra con parity y pages: 'body' (elementos de texto). La página par lleva el autor, y la impar, {chapterTitle}, que dice LYCIDAS sobre el poema y NOTES sobre las notas, porque las notas se abren con un título propio. El folio va en el borde exterior de la caja de texto; las dos páginas de apertura, la 1 y la 8, lo llevan al pie.
La receta completa
// ═══ Postext Cookbook · Nº 044 · Critical edition: line numbers and line-keyed notes ═══
// https://postext.dev/en/cookbook/critical-edition-line-numbers
// Code: MIT · Text: Milton, Poems (1645) (PD) · Notes: CC BY 4.0 · Laurel: diffusion models
// Fonts: Linden Hill, Imbue, Libre Franklin (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Lycidas in the spelling of 1645, with a number beside every fifth line and two pages of
// notes keyed to those numbers, so the verse carries no note markers.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en')
const RECIPE = 'critical-edition-line-numbers';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black text on white, and one laurel green for the apparatus.
const palette = {
ink: '#1b1b1b', // the text
laurel: '#3c5a3e', // line numbers, note numbers, the kicker
muted: '#6a706a', // running heads, the colophon
paper: '#ffffff',
};
// col(id) carries the hex beside the id of its palette entry.
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' } }));
const [TEXT, DISPLAY, LABEL] = ['Linden Hill', 'Imbue', 'Libre Franklin'];
const LEAD = 14.5; // pt: the leading of the verse, and the grid every page keeps
// #region answer: count the lines, and set every fifth number in the margin
// The poem is one :::verse block, written as 1645 prints it: a line of verse a line, a blank
// line between verse paragraphs and two spaces before a short line. lineNumbers counts its
// lines of verse (a line that turned over would still count once) and prints the multiples
// of five beside their lines, on their baselines. position 'side' puts them in the side
// column of the one-and-a-half layout, flush with its edge next to the verse.
const lineNumbers = {
enabled: true,
count: 'verse', // the lines of :::verse poems; the notes are prose and not counted
interval: 5,
restart: 'document', // one count through the poem
position: 'side',
fontFamily: LABEL, fontSize: pt(7.5), color: col('laurel'),
};
// Hook-up: lineNumbers in the config; the Markdown goes to buildDocument as it is written.
// #endregion
// #region page: a poetry trim, and a channel for the numbers at the fore-edge
const PT = 25.4 / 72; // mm in a point
const [TRIM_W, TRIM_H] = [138, 216]; // mm
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 versos de diez en diez
Los poemas largos suelen numerarse de diez en diez; la columna de 6 mm se queda como está.
- interval: 5,
+ interval: 10,#Deja todos los números a la derecha del verso
Con la columna lateral fija a la derecha, los números quedan a la derecha del verso en todas las páginas, y en las pares, junto al lomo.
- sideColumnSide: 'outer', // right of the verse on a recto, left of it on a verso
+ sideColumnSide: 'right', // right of the verse on every pageErrores frecuentes
Error frecuente
Valores de atributo: sin { ni }; comillas simples si llevan "
Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →
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 →
- El espacio entre estrofas se descarta al principio de una página, así que el cambio de estrofa entre los versos 14 y 15, que coincide con el paso de la página 1 a la 2, no se ve. Si tu edición tiene que marcar todos los cambios de estrofa, sangra el primer verso de cada una en lugar de dejar una línea en blanco, como hace la edición de 1645: dos espacios delante de ese verso.
- Los números comparten la columna lateral con cualquier recuadro o pie lateral que añadas. Un número que cae sobre uno de ellos se imprime igualmente, y el Sandbox lo avisa (
lineNumberOverlap); mueve el recuadro o lleva los números al margen exterior conposition: 'outer'. - Las notas siguen escribiendo a mano sus números de verso (
:chip[8]{style="line"}): una nota todavía no puede apuntar a un verso e imprimir su número. Si cambias el texto, coteja los números de las notas con los del margen.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Lycidas, con su nota preliminar, en el texto de Poems of Mr. John Milton (1645), páginas 57–65, según la transcripción revisada de Wikisource del facsímil de 1927; cotejado con el texto de Oxford de H. C. Beeching (Project Gutenberg, libro electrónico 1745) · John Milton · dominio público
- La nota sobre el texto, las notas y el colofón · Ignacio Ferro · CC BY 4.0
- Imágenes
- La rama de laurel de la primera página, una acuarela · Generated With Diffusion Models · original
- Fuentes
- Linden Hill (SIL OFL 1.1) · Imbue (SIL OFL 1.1) · Libre Franklin (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)


