Em poucas palavras
Uma edição crítica de um poema de Milton. A cada cinco versos aparece um número na margem, e as notas depois do poema indicam pelo número os versos que explicam.
O que você vai compor
Lycidas, a elegia de Milton a Edward King, numa pequena edição crítica de 138 × 216 mm que segue o texto e a grafia dos Poems de 1645. A primeira página abre sob um ramo de louro, com o título em maiúsculas altas da Imbue sobre a nota preliminar que Milton acrescentou em 1645. Os 193 versos vêm a seguir, um por linha, com uma linha em branco entre as estrofes e os versos curtos recuados. A cada cinco versos, o número aparece em verde-louro, numa coluna de 6 mm na margem externa: à direita do poema nas páginas ímpares, à esquerda nas pares. O poema não leva chamadas de nota. As notas ocupam as duas páginas depois do poema, e cada uma abre com o número do verso, na mesma Libre Franklin verde da numeração da margem.
Esta receita responde a
- Como numero na margem cada quinto verso de um poema e remeto minhas notas a esses números de verso?
- Como componho poesia: um verso por linha, espaço entre estrofes, recuo deslocado nos versos que quebram e sem hifenização?
- Como faço notas de rodapé?
- Como monto uma diagramação em coluna e meia, com uma coluna de texto larga e uma coluna lateral estreita?
- Como acrescento espaço vertical entre dois blocos, se as linhas em branco não fazem nada?
A 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.
Ingredientes
- Funcionalidades
- Numeração de linhasVerso linha a linhaColuna de margem para flutuantesColuna e meiaEstilos de parágrafoChips no textoMargens espelhadasAberturas desenhadasTextos, fios e caixas nos designs de páginaImagens nos designs de páginaAtributos de títuloEstilos de títuloMetadados do documentoCabeços e fóliosCabeços por tipo de páginaPaleta de cores semântica
- Tipografia
- Linden Hill, Imbue, Libre Franklin (SIL OFL 1.1)
- Materiais
laurel-1040.jpg- The sprig of bay laurel on the first page, a watercolour (Generated With Diffusion Models, original)
Preparo
#1 · Conte os versos
O código deste passo é a resposta curta lá em cima. lineNumbers conta os versos do poema e imprime o número de cada quinto ao lado dele, na linha de base, em Libre Franklin de 7,5 pt e verde-louro (numeração de linhas). count: 'verse' conta só os versos dos poemas :::verse, por isso a nota sobre o texto e as notas depois do poema não recebem número, e um verso longo demais para a medida contaria uma vez só: a continuação não recebe número. restart: 'document' mantém uma única contagem no poema inteiro. Os números são pintados ao lado de versos que a composição já assentou, de modo que nunca movem nenhum deles.
#2 · Uma coluna 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 } };
Com sideColumnRole: 'floats', a coluna estreita de um layout oneAndHalf nunca recebe texto (tipos de layout), e position: 'side' compõe nela os números, encostados na borda do lado do poema; a medianiz de 4 mm é a distância entre um verso e o número. sideColumnPercent é uma fração da mancha, por isso o código o calcula a partir de milímetros: 6 de 90 mm, o bastante para o número mais largo. Os algarismos da Libre Franklin são proporcionais, e em 7,5 pt o zero é o mais largo (1,8 mm, contra 1,2 mm do um), por isso o 100, com 4,9 mm, é o número mais largo do poema; o 180 e o 190 medem 4,8 mm. 'outer' acompanha as margens espelhadas, de modo que os números ficam à direita do poema nas páginas ímpares, alinhados à esquerda, e à esquerda dele nas pares, alinhados à direita: em todas começam ou terminam à mesma distância do poema. A coluna do poema tem 80 mm, 1,9 mm a mais que o verso 31, o mais longo, por isso nenhum verso quebra para a linha seguinte.
#3 · O poema é um único bloco :::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) }];
Um bloco :::verse mantém o poema como ele é escrito: cada linha de Markdown é um verso, uma linha em branco separa as estrofes e os espaços antes de um verso são o recuo (:::verse). A abertura do bloco indica o estilo do poema e align=start, que alinha o poema com a margem em vez de centralizá-lo pelo verso mais longo. Entre duas estrofes fica uma linha em branco da grade (stanzaSpace, uma linha). Os catorze versos curtos de Milton, o 4 entre eles, começam com dois espaços, e indentStep: em(1) faz deles 2 em. O espaço entre estrofes é descartado no alto de uma página, de modo que a página 2 começa com o verso 15 no alto da mancha, e a troca de estrofe entre os versos 14 e 15 não aparece (veja “Erros comuns”).
#4 · O louro, o título e a 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) };
O título de nível 1 imprime um design no lugar do próprio texto (span e design avançado). {author} vem do front matter, e a nota preliminar, de um atributo na linha do título, # Lycidas {headnote="In this Monody …"} (atributos de título). O louro termina acima do antetítulo, por isso a profundidade da abertura vem dos textos abaixo dele: o antetítulo, a 50 mm do alto da mancha, o título e as quatro linhas da nota preliminar chegam até a linha 20 das 34 da página, e a primeira estrofe, de 14 versos, ocupa o resto. minHeight é um piso na mesma profundidade: corte a nota preliminar para três linhas e o poema continua começando na linha 21, enquanto sem o piso ele sobe para a linha 20. marginBottom: pt(0) tira do vão a margem padrão do título; com ela, o poema começaria na linha 22 e mandaria o verso 14 para a página 2. O design fica na coluna, e o louro, ancorado no canto superior direito da página, é pintado desde o refile do mesmo jeito: só o pé da coluna corta um design mantido nela.
#5 · Notas ligadas aos números dos versos
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))] } } };
As notas remetem aos números dos versos, por isso o poema não leva chamadas, e elas vêm depois dele como um comentário, sem tirar linhas das páginas. Cada nota abre com o número do verso, escrito :chip[8]{style="line"}, depois as palavras que explica, em itálico, e um colchete de fechamento. O chip não tem preenchimento, contorno nem espaçamento lateral, de modo que só mudam a fonte e a cor: Libre Franklin de 7,7 pt em verde-louro (estilos de chip). A Linden Hill não tem negrito, por isso os números se destacam pela troca de fonte. O estilo de nota recua 1,6 em todas as linhas depois da primeira, o que deixa os números livres à esquerda, e as notas são alinhadas à esquerda, como o poema. # Notes {style="notes"} salta para a página 8 e compõe o título nas maiúsculas da abertura, em 30 pt.

#6 · Cabeços por paridade
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 é ancorado à página e filtrado por parity e pages: 'body' (elementos de texto). A página par leva o autor, e a ímpar, {chapterTitle}, que diz LYCIDAS sobre o poema e NOTES sobre as notas, porque as notas abrem com um título próprio. O fólio fica na borda externa da mancha; as duas páginas de abertura, a 1 e a 8, o levam no pé.
A receita 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
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Numere de dez em dez
Poemas longos costumam ser numerados de dez em dez; a coluna de 6 mm não precisa mudar.
- interval: 5,
+ interval: 10,#Deixe todos os números à direita do poema
Com a coluna lateral fixa à direita, os números ficam à direita do poema em todas as páginas, o que nas pares os coloca junto à lombada.
- sideColumnSide: 'outer', // right of the verse on a recto, left of it on a verso
+ sideColumnSide: 'right', // right of the verse on every pageErros comuns
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
- O espaço entre estrofes é descartado no alto de uma página, por isso a troca de estrofe entre os versos 14 e 15, que cai na passagem da página 1 para a 2, não aparece. Se sua edição precisa mostrar todas as trocas, dê um recuo ao primeiro verso de cada estrofe, como faz a edição de 1645: dois espaços antes desse verso.
- Os números dividem a coluna lateral com qualquer boxe ou legenda lateral que você acrescentar. Um número que cai sobre um deles é impresso mesmo assim, e o Sandbox avisa (
lineNumberOverlap); mova o boxe ou leve os números para a margem externa composition: 'outer'. - As notas ainda trazem os números de verso escritos à mão (
:chip[8]{style="line"}): por enquanto, uma nota não consegue apontar para um verso e imprimir o número dele. Se você mudar o texto, confira os números das notas com os da margem.
Créditos
- Receita
- Ignacio Ferro
- Texto
- 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 · domínio público
- The note on the text, the notes and the colophon · Ignacio Ferro · CC BY 4.0
- Imagens
- The sprig of bay laurel on the first page, a watercolour · Generated With Diffusion Models · original
- Fontes
- Linden Hill (SIL OFL 1.1) · Imbue (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


