En poques paraules
Una edició crítica d'un poema de Milton. Cada cinc versos apareix un número al marge, i les notes que segueixen el poema remeten per número als versos que expliquen.
Què compondràs
Lycidas, l'elegia de Milton a la mort d'Edward King, en una edició crítica de 138 × 216 mm que segueix el text i l'ortografia dels Poems de 1645. La primera pàgina s'obre sota una branca de llorer, amb el títol en versals altes d'Imbue sobre la nota preliminar que Milton va afegir el 1645. Segueixen els 193 versos, amb una línia en blanc entre estrofes i els versos curts sagnats. La numeració va de cinc en cinc, en verd llorer, en una columna de 6 mm del costat exterior: a la dreta del poema a les pàgines senars i a l'esquerra a les parelles. El poema no porta crides de nota. Les notes ocupen les dues pàgines següents, i cadascuna comença pel número del seu vers, en la mateixa Libre Franklin verda de la numeració.
Aquesta recepta respon a
- Com numero al marge cada cinquè vers d'un poema i remeto les meves notes a aquests números de vers?
- Com componc poesia: un vers per línia, espai entre estrofes, sagnat francès als versos que no hi caben i sense partició de mots?
- Com faig notes a peu de pàgina?
- Com compono en columna i mitja, amb una columna de text ampla i una de lateral estreta?
- Com afegeixo espai vertical entre dos blocs, si les línies en blanc no fan res?
La resposta curta
// 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.
Ingredients
- Funcions
- Numeració de líniesVers línia a líniaColumna al marge per a flotantsColumna i mitjaEstils de paràgrafChips en líniaMarges simètricsObertures dissenyadesTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaAtributs de títolEstils de títolMetadades del documentCapçaleres i folisCapçaleres segons el tipus de pàginaPaleta de color semàntica
- També fa servir
- Bibliografies i glossarisFigures i taules com a recursos
- Tipografia
- Linden Hill, Imbue, Libre Franklin (SIL OFL 1.1)
- Recursos
laurel-1040.jpg- The sprig of bay laurel on the first page, a watercolour (Generated With Diffusion Models, original)
Elaboració
#1 · Compta els versos
El codi d'aquest pas és la resposta curta, més amunt. lineNumbers compta els versos del poema i imprimeix el número de cada cinquè al seu costat, sobre la seva línia de base, en Libre Franklin de 7,5 pt i verd llorer (numeració de línies). count: 'verse' compta només els versos dels poemes :::verse, així que la nota sobre el text i les notes que segueixen el poema no porten número, i un vers massa llarg per a la mesura comptaria una sola vegada: el que passa a la línia següent no porta número. restart: 'document' manté un sol compte en tot el poema. Els números es pinten al costat de versos que la composició ja ha col·locat, així que no en mouen mai cap.
#2 · Una columna de sis mil·límetres
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 } };
Amb sideColumnRole: 'floats', la columna estreta d'una disposició oneAndHalf mai no rep text (tipus de disposició), i position: 'side' hi compon els números, arran de la vora del costat del vers; els 4 mm de separació entre columnes són la distància entre un vers i el seu número. sideColumnPercent és un percentatge de la caixa de text, i el codi el calcula a partir de mil·límetres: 6 de 90 mm, prou per al número més ample. Les xifres de Libre Franklin són proporcionals, i a 7,5 pt el zero és la més ampla (1,8 mm, davant d'1,2 mm de l'u), així que el número més ample del poema és el 100, amb 4,9 mm; el 180 i el 190 fan 4,8 mm. 'outer' segueix els marges simètrics, de manera que els números queden a la dreta del vers a les pàgines senars, alineats a l'esquerra, i a la seva esquerra a les parelles, alineats a la dreta: a totes comencen o acaben a la mateixa distància del vers. La columna del vers fa 80 mm, 1,9 mm més que el vers 31, el més llarg, així que cap vers no passa a la línia següent.
#3 · El poema és un sol bloc :::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 bloc :::verse conserva el poema tal com s'escriu: cada línia de Markdown és un vers, una línia en blanc separa les estrofes i els espais davant d'un vers són el seu sagnat (:::verse). La línia d'obertura indica l'estil del vers i align=start, que alinea el poema amb el marge en lloc de centrar-lo sobre el seu vers més llarg. Entre dues estrofes queda una línia en blanc de la retícula (stanzaSpace, una línia). Els catorze versos curts de Milton, el 4 entre ells, comencen amb dos espais, i indentStep: em(1) els converteix en 2 em. L'espai entre estrofes es descarta al principi d'una pàgina, així que la pàgina 2 comença amb el vers 15 a dalt de la caixa de text i el canvi d'estrofa entre els versos 14 i 15 no es veu (mira «Errors freqüents»).
#4 · El llorer, el títol i 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 títol de primer nivell imprimeix un disseny en lloc del seu propi text (extensió i disseny avançat). {author} surt del frontmatter, i la nota preliminar, d'un atribut a la línia del títol, # Lycidas {headnote="In this Monody …"} (atributs d'encapçalament). El llorer acaba per sobre de l'avanttítol, així que l'alçada de l'obertura la donen els textos que té a sota: l'avanttítol, a 50 mm de dalt de la caixa de text, el títol i les quatre línies de la nota preliminar arriben fins a la línia 20 de les 34 de la pàgina, i la primera estrofa, de 14 versos, ocupa la resta. minHeight fixa un mínim a aquesta mateixa profunditat: si retalles la nota preliminar a tres línies, el poema continua començant a la línia 21, mentre que sense aquest mínim puja a la 20. marginBottom: pt(0) deixa fora del buit el marge que el títol porta per defecte; amb aquest marge, el poema començaria a la línia 22 i el vers 14 passaria a la pàgina 2. El disseny es queda a la columna, i el llorer, ancorat a la cantonada superior dreta de la pàgina, es pinta igualment des del tall: un disseny que es queda a la columna només el retalla el peu d'aquesta.
#5 · Notes remeses al número de vers
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))] } } };
Les notes remeten als números de vers, de manera que el poema no porta crides, i van després d'ell, com un comentari, sense treure línies a cap pàgina del poema. Cada nota comença pel número del vers que comenta, escrit :chip[8]{style="line"}, seguit del lema en cursiva (les paraules comentades) i d'un claudàtor de tancament. El xip no té fons, contorn ni emplenament lateral, així que només canvien la lletra i el color: Libre Franklin de 7,7 pt en verd llorer (estils de xip). Linden Hill no té negreta, i per això els números es distingeixen pel canvi de lletra. L'estil de nota sagna 1,6 em totes les línies menys la primera, de manera que els números sobresurten a l'esquerra, i les notes van en bandera, igual que el vers. # Notes {style="notes"} salta a la pàgina 8 i compon el seu títol amb les versals de l'obertura, a 30 pt.

#6 · Capçaleres segons la paritat
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 element s'ancora a la pàgina i es filtra amb parity i pages: 'body' (elements de text). La pàgina parella porta l'autor, i la senar, {chapterTitle}, que diu LYCIDAS sobre el poema i NOTES sobre les notes, perquè les notes s'obren amb un títol propi. El foli va a la vora exterior de la caixa de text; les dues pàgines d'obertura, la 1 i la 8, el porten al peu.
La recepta 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
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Numera els versos de deu en deu
Els poemes llargs se solen numerar de deu en deu; la columna de 6 mm es queda com està.
- interval: 5,
+ interval: 10,#Deixa tots els números a la dreta del vers
Amb la columna lateral fixa a la dreta, els números queden a la dreta del vers a totes les pàgines, i a les parelles, al costat del llom.
- sideColumnSide: 'outer', // right of the verse on a recto, left of it on a verso
+ sideColumnSide: 'right', // right of the verse on every pageErrors freqüents
Error freqüent
Valors d'atribut: sense { ni }; cometes simples si porten "
Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
- L'espai entre estrofes es descarta al principi d'una pàgina, així que el canvi d'estrofa entre els versos 14 i 15, que coincideix amb el pas de la pàgina 1 a la 2, no es veu. Si la teva edició ha de marcar tots els canvis d'estrofa, sagna el primer vers de cadascuna en lloc de deixar una línia en blanc, com fa l'edició de 1645: dos espais davant d'aquest vers.
- Els números comparteixen la columna lateral amb qualsevol requadre o peu lateral que hi afegeixis. Un número que cau sobre un d'ells s'imprimeix igualment, i el Sandbox l'avisa (
lineNumberOverlap); mou el requadre o porta els números al marge exterior ambposition: 'outer'. - Les notes continuen escrivint a mà els seus números de vers (
:chip[8]{style="line"}): de moment, una nota no pot apuntar a un vers i imprimir-ne el número. Si canvies el text, confronta els números de les notes amb els del marge.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Lycidas, with its headnote, in the text of Poems of Mr. John Milton (1645), pages 57–65, from the proofread Wikisource transcription of the 1927 facsimile; checked against H. C. Beeching’s Oxford text (Project Gutenberg eBook 1745) · John Milton · domini públic
- The note on the text, the notes and the colophon · Ignacio Ferro · CC BY 4.0
- Imatges
- The sprig of bay laurel on the first page, a watercolour · Generated With Diffusion Models · original
- Fonts
- Linden Hill (SIL OFL 1.1) · Imbue (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


