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

Receitas · Capítulo 6 · Boxes e notas

Notas de rodapé no pé da coluna que as cita

As chamadas [^id] do Markdown viram notas numeradas no pé da coluna que as cita, com chaves para uma coluna, notas no fim do capítulo e numeração contínua.

Nesta página
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0 · postext-pdf ≥ 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 210 × 280 mm
  • 2 colunas, medianiz de 7 mm
  • EB Garamond 10,5/13,5
  • Bodoni Moda
  • IBM Plex Sans Condensed
  • 3 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 28 ms
  • 164 linhas de código

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

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

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

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

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

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

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

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

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