Pular para o conteúdo principal
Receita número 44

Receitas · Capítulo 2 · Tipo e texto

Edição crítica: versos numerados e notas por verso

Lycidas, de Milton, no texto de 1645: lineNumbers numera os versos de cinco em cinco na coluna lateral, e cada nota abre com o número do verso.

Nesta página
Gênero
Poesia
Saída
Canvas
Nível
Avançado
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 138 × 216 mm
  • Coluna e meia, medianiz de 4 mm
  • Linden Hill 10,5/14,5
  • Imbue
  • Libre Franklin
  • 9 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 71 ms
  • 168 linhas de código

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

script.js · linhas 30–43no código completo
// 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

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

script.js · linhas 47–63no código completo
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

script.js · linhas 67–72no código completo
// 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

script.js · linhas 76–101no código completo
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

script.js · linhas 105–124no código completo
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.

Página 8: cada nota abre com o número verde do verso; o poema, nas páginas 1 a 7, não leva chamadas.

#6 · Cabeços por paridade

script.js · linhas 128–149no código completo
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

Sandbox
// ═══ 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 page

Erros 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 com position: '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

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)
Sandbox