Em poucas palavras
Uma edição escolar de um romance clássico espanhol, em duas colunas. Mostra como pôr cada nota no pé da coluna que a menciona, para o leitor nunca ter de virar a página para encontrá-la.
O que você vai compor
Uma edição escolar do Lazarillo de Tormes, em 210 × 280 mm e duas colunas de EB Garamond: o prólogo e o começo do primeiro tratado, em que Lázaro nasce num moinho do Tormes e sai pelo mundo com um cego. As notas explicam o que um leitor de 1554 sabia e um leitor de hoje não sabe: a aldeia de Tejares, a expedição à ilha de Los Gelves, o touro de pedra da ponte de Salamanca. Cada uma fica no pé da coluna que a cita, em corpo menor, sob um fio curto cor de vinho, e assim o olho desce do número à nota e volta sem virar a página. A edição inglesa traz as notas do próprio Clements Markham para a tradução de 1908.
Esta receita responde a
- Como faço notas de rodapé?
A resposta curta
// In the Markdown: `Tejares,[^9]` cites a note (the id may be a word: `[^tejares]`), and
// a paragraph that opens with `[^9]:` anywhere in the chapter defines it. The engine
// numbers the notes in order of citation and keeps each note in the column of the line
// that cites it: a line whose note does not fit under it moves on with the note.
const footnotes = () => ({
placement: options.placement, // 'column' (the foot of the citing column) or 'chapterEnd'
numbering: options.numbering, // 'chapter': 1, 2, 3… again under every chapter heading
fontSize: pt(8.5), // off the baseline grid: the notes stack up from the column's foot
lineHeight: pt(10.5),
hangingIndent: em(0.9), // turnover lines align past the number
spaceBetween: pt(1.5),
separator: { width: 0.25, lineWidth: pt(0.5), color: col('oxblood') },
});
Ingredientes
- Funcionalidades
- Notas de rodapéSobrescritos e subscritosUma ou duas colunasAberturas desenhadasAtributos de títuloCabeços e fóliosMargens espelhadasCabeços por tipo de páginaEstilos de parágrafoPaleta de cores semânticaCor do papelViúvas, órfãs e linhas curtasExportação para PDFPDF acessível com tags
- Tipografia
- EB Garamond, Bodoni Moda, IBM Plex Sans Condensed (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Citar a nota onde ela cabe e defini-la em qualquer lugar
A configuração é a resposta curta acima; o resto é Markdown. natives of Tejares,[^9] imprime um número sobrescrito colado à vírgula, e um parágrafo que começa com [^9]: contém a nota. As definições saem do fluxo onde quer que você as escreva, por isso esta amostra as reúne todas no fim do capítulo, como as notas de Markham estavam no arquivo de origem. Os números seguem a ordem das chamadas, de modo que os ids do Markdown podem ser palavras ([^tejares] na edição espanhola), e renumerar um capítulo nunca obriga a mexer nas notas.
#2 · Deixar espaço na coluna para as suas notas
Antes de posicionar uma linha, a diagramação soma a altura das notas que essa linha cita pela primeira vez, e a do fio quando é a primeira nota da coluna. Uma linha cuja nota não cabe embaixo dela passa para a coluna seguinte com o parágrafo, segundo as regras de viúvas e órfãs, de modo que um número nunca aponta para uma nota de outra coluna. As notas se empilham a partir do pé, com corpo e entrelinha próprios, fora da grade de linhas de base, enquanto o texto acima delas continua na grade; o equilíbrio de colunas conta só o texto.
#3 · Rebaixar todas as aberturas até a mesma linha
const opener = {
enabled: true,
// The sink holds a two-line title and its rule, with ~8 mm to the first line of text,
// so every chapter starts on the same grid line whatever its title's length.
minHeight: pt(LEAD * 10),
slot: { elements: [
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, fontSize: pt(8.5),
letterSpacing: pt(1.8), color: col('oxblood'), align: 'center',
placement: at('container', 'top', 0, 7) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Bodoni Moda', italic: true,
fontSize: pt(26), lineHeight: 1.1, color: col('ink'), align: 'center',
overflow: 'wrap', // design text ends in an ellipsis by default
placement: { ...at('container', 'top-left', 0, 13),
size: { width: 'fill', height: 'auto' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('oxblood'),
placement: { anchor: { to: '#title', edge: 'below' }, // a rule starts at the box's left
offset: { x: mm((MEASURE - 14) / 2), y: mm(4.5) }, size: { width: mm(14) } } },
] },
};
A abertura ocupa as duas colunas e tira o chapéu do capítulo do atributo kicker do título. minHeight reserva dez linhas da grade, o bastante para um título de duas linhas em Bodoni com o fio, e assim o texto de cada capítulo começa na mesma linha e o fio nunca cai na primeira linha de texto.
#4 · Pôr o livro na página par e o capítulo na ímpar
const head = (id, content, parity, edge, x, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'body', // never on openers
...label, fontSize: pt(7.5), letterSpacing: pt(1.3), color: col('muted'),
placement: at('page', edge, x, 13), ...extra,
});
const folio = { color: col('oxblood') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', MARGIN.outer,
{ ...folio, align: 'left' }),
head('verso-title', '{title}', 'even', 'top-left', MARGIN.outer + 9, { align: 'left' }),
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(MARGIN.outer + 9),
{ align: 'right', overflow: 'ellipsis' }),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -MARGIN.outer,
{ ...folio, align: 'right' }),
] };
// Openers carry a drop folio instead, centred under the text block.
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all', 'bottom', 0,
{ ...folio, align: 'center', placement: at('page', 'bottom', 0, -11) }), pages: 'opener' }] };
Os cabeços são ancorados à página conforme a paridade, com o fólio na borda externa; pages: 'body' os tira das aberturas, que recebem um fólio centralizado no pé. Um título de capítulo longo termina em reticências aos 120 mm em vez de esbarrar no fólio.
#5 · Experimentar as outras posições
const CHOICES = {
columns: [[2, t({ en: 'Two columns', es: 'Dos columnas' })],
[1, t({ en: 'One column', es: 'Una columna' })]],
placement: [['column', t({ en: 'Column foot', es: 'Pie de columna' })],
['chapterEnd', t({ en: 'End of chapter', es: 'Final del capítulo' })]],
numbering: [['chapter', t({ en: 'Per chapter', es: 'Por capítulo' })],
['document', t({ en: 'Continuous', es: 'Continua' })]],
};
const bar = document.createElement('form');
bar.id = 'options';
bar.ariaLabel = t({ en: 'Footnote options', es: 'Opciones de las notas' });
for (const [key, choices] of Object.entries(CHOICES)) {
const group = bar.appendChild(document.createElement('fieldset'));
for (const [value, text] of choices) {
const input = Object.assign(document.createElement('input'), { type: 'radio', name: key,
value: String(value), checked: options[key] === value });
const item = group.appendChild(document.createElement('label'));
item.append(input, text);
}
}
bar.addEventListener('change', (event) => {
const { name, value } = event.target;
options[name] = name === 'columns' ? Number(value) : value;
config.layout = layoutFor(options.columns); // changed in place: the build sees it
config.footnotes = footnotes();
doc = buildDocument({ markdown }, config); // the fonts are loaded by now
showPages(doc, { title: TITLE });
});
document.getElementById('pages').before(bar);
Cada chave compõe o capítulo de novo com uma opção alterada. One column põe as notas no pé da página, que ali é a coluna. End of chapter as compõe depois do último parágrafo do capítulo e as desce até o pé da coluna que fecham, sob o mesmo fio. Continuous continua a numeração do prólogo no primeiro capítulo em vez de recomeçar em 1.
A receita completa
// ═══ Postext Cookbook · Nº 071 · Footnotes at the foot of the column ══════════════
// https://postext.dev/en/cookbook/novel-footnotes-column-foot
// Code: MIT · Text: Lazarillo de Tormes (1554) and Markham's 1908 translation (PD)
// Fonts: EB Garamond, Bodoni Moda, IBM Plex Sans Condensed (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import { buildDocument, buildDocumentWithFonts, renderPageToCanvas } 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 = 'novel-footnotes-column-foot';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: oxblood for the kickers, the folios and the notes' rule; ink on warm paper
const palette = {
ink: '#241e1a', // text: a warm near-black
oxblood: '#7d2b1f', // the one accent
muted: '#6f655b', // running heads, colophon
rule: '#c9bdae', // hairlines
paper: '#fbf8f2',
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
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, never the default blue.
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.oxblood, model: 'hex' } },
];
// #endregion
const TRIM = { width: 210, height: 280 }; // a school edition: two 82 mm columns
const MARGIN = { top: 23, bottom: 22, inner: 21, outer: 17 }; // mirrored
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 172 mm
const LEAD = 13.5; // body leading in pt: the baseline grid
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const label = { fontFamily: 'IBM Plex Sans Condensed', fontWeight: 600,
textTransform: 'uppercase' };
// The switches under the title change these and build again (#region live).
const options = { columns: 2, placement: 'column', numbering: 'chapter' };
const layoutFor = (columns) => (columns === 2
? { layoutType: 'double', gutterWidth: mm(7) } : { layoutType: 'single' });
// #region answer: the notes at the foot of the column that cites them
// In the Markdown: `Tejares,[^9]` cites a note (the id may be a word: `[^tejares]`), and
// a paragraph that opens with `[^9]:` anywhere in the chapter defines it. The engine
// numbers the notes in order of citation and keeps each note in the column of the line
// that cites it: a line whose note does not fit under it moves on with the note.
const footnotes = () => ({
placement: options.placement, // 'column' (the foot of the citing column) or 'chapterEnd'
numbering: options.numbering, // 'chapter': 1, 2, 3… again under every chapter heading
/* The option bar over the pages: three pairs of choices, each a segmented switch. */
#options {
display: flex; flex-wrap: wrap; justify-content: center; gap: 10px 18px;
max-width: 1120px; margin: 0 auto; padding: 18px 16px 6px;
font: 600 12px/1.2 "IBM Plex Sans Condensed", system-ui, sans-serif;
letter-spacing: .06em; text-transform: uppercase;
}
#options fieldset {
display: flex; margin: 0; padding: 2px; border: 1px solid #4a433d; border-radius: 999px;
}
#options label {
display: block; padding: 7px 14px; border-radius: 999px; color: #c9bdae; cursor: pointer;
}
#options input { position: absolute; opacity: 0; pointer-events: none; }
#options label:has(input:checked) { background: #7d2b1f; color: #fbf8f2; }
#options label:has(input:focus-visible) { outline: 2px solid #c9bdae; outline-offset: 2px; }
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
#Manter as notas de fim de capítulo sob o texto
Com placement: 'chapterEnd', as notas ficam por padrão no pé da última coluna; chapterEndAlign: 'text' as põe logo abaixo do último parágrafo.
placement: options.placement,
+ chapterEndAlign: 'text',#Tirar o fio
Sem o fio, as notas continuam separadas do texto por spaceAbove e spaceBelowRule.
- separator: { width: 0.25, lineWidth: pt(0.5), color: col('oxblood') },
+ separator: { enabled: false },Erros comuns
Erro comum
Uma abertura reserva altura até o seu elemento ancorado mais baixo
Uma abertura com design avançado reserva a altura do seu elemento mais baixo, e os elementos ancorados à página ou à sangria abaixo do título também contam, então um ornamento no pé da página empurra o texto para a página seguinte. Dê a esse elemento reserve: false (desde o postext 1.5): ele é pintado onde está ancorado e não reserva nada. Os elementos que acompanham a própria faixa (ancorados ao pé dela, ou com altura 'fill') nunca definem a altura dela. Aberturas desenhadas →
Aviso de diagramação · undefinedFootnote
Nota de rodapé sem definição
Por quê. Uma chamada [^id] cita uma nota que nenhum parágrafo [^id]: define; por isso, o número é impresso sobre uma nota vazia.
Correção. Acrescente um parágrafo [^id]: com a nota ou corrija o id da chamada. Docs →
Aviso de diagramação · unusedFootnote
Nota de rodapé nunca citada
Por quê. Uma definição [^id]: não tem chamada no texto; por isso, a nota não é composta.
Correção. Cite a nota com [^id] onde ela deve ficar ou exclua a definição. Docs →
- Uma chamada numa legenda, numa célula de tabela ou num título é impressa como foi escrita: as notas são lidas em parágrafos, itens de lista, citações e boxes.
- Uma nota nunca é dividida entre colunas: uma mais alta que a coluna passa do pé. Mantenha as notas em poucas linhas, como fazem os editores.
Créditos
- Receita
- Ignacio Ferro
- Texto
- La vida de Lazarillo de Tormes, Burgos edition of 1554: the prologue and the beginning of the first treatise · Anonymous · domínio público
- The Life of Lazarillo de Tormes, translated by Clements Markham (1908), with his notes: the prologue and the first chapter, abridged · Clements Markham · domínio público
- The Spanish notes, adapted from Markham's and written for this edition · Ignacio Ferro · CC BY 4.0
- Fontes
- EB Garamond (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · IBM Plex Sans Condensed (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)


