Em poucas palavras
Uma pequena edição de uma famosa palestra de ciência sobre uma vela. Mostra como juntar as notas no fim, numa página própria em duas colunas, em vez de no pé de cada página.
O que você vai compor
A Lecture I de The Chemical History of a Candle, de Michael Faraday, composta como uma pequena edição de leitura numa página de 156 × 234 mm. A palestra abre num campo de fuligem com uma vela acesa apoiada na borda inferior, uma fotografia gerada com modelos de difusão cujo preto é o mesmo da fuligem, e o texto corre numa coluna justificada de Libre Bodoni. Onde um livro poria notas de rodapé, pequenos números elevados em laranja-escuro mandam o leitor para o fim da palestra. As notas vêm numa página própria, sob uma faixa de fuligem com a vela apagada, em duas colunas alinhadas à esquerda de corpo 8,2 pt, com cada número em negrito pendurado no recuo. Três das seis são de William Crookes, tiradas da reimpressão de 1908 da edição de 1861; as outras três são novas e assinadas Ed. As duas colunas terminam na mesma linha, e o colofão fecha a segunda.
Esta receita responde a
- Como faço notas de rodapé?
- Como componho uma bibliografia ou um glossário (recuo deslocado, corpo menor)?
- Como escrevo sobrescritos, subscritos e fórmulas químicas sem recorrer à notação matemática completa?
A resposta curta
// Use: buildDocument({ markdown: endnotes(markdown) }, config()), with a 'note' paragraph style.
// [^label] in the text → **^n^**, numbered by first citation; bold, so it takes bodyText.boldColor.
// The [^label]: definitions (one line each) print where the first stood, a 'note' paragraph each:
// '**n** text', never '1. text', which would open a numbered list (gotcha: digit-period-list).
function endnotes(markdown, style = 'note') {
const notes = new Map(); // label → text
const HOLE = '\u0000'; // marks where a definition stood: the first becomes the notes
const text = markdown.replace(/^\[\^([^\]\s]+)\]:[ \t]*(.+)\n?/gm,
(_, label, note) => { notes.set(label, note.trim()); return HOLE; });
const cited = []; // labels in order of first citation
const number = (label) => {
if (!notes.has(label)) throw new Error(`The note [^${label}] has no definition`);
if (!cited.includes(label)) cited.push(label);
return cited.indexOf(label) + 1;
};
// Markers side by side share one superscript, [^a][^b] → **^1,2^**, never 12 raised (note 12).
// A word joiner (U+2060, no width) opens each one: after an italic, '*Royal George*' and the
// bold's ** would make '***', which the parser reads as a bold run, and print the asterisks.
const marked = text.replace(/(?:\[\^[^\]\s]+\])+/g, (run) => {
const numbers = [...run.matchAll(/\[\^([^\]\s]+)\]/g)].map(([, label]) => number(label));
return `**^${numbers.join(',')}^**`;
});
const unused = [...notes.keys()].filter((label) => !cited.includes(label));
if (unused.length) console.warn(`Notes never cited: ${unused.join(', ')}`);
const entries = cited.map((label, i) => `**${i + 1}** ${notes.get(label)}`);
const section = `:::paragraphs{style="${style}"}\n${entries.join('\n\n')}\n:::\n`;
return marked.replace(HOLE, () => section).replaceAll(HOLE, ''); // () =>: '$&' stays text
}
Ingredientes
- Funcionalidades
- Sobrescritos e subscritosBibliografias e glossáriosGeometria por seçãoEstilos de títuloEquilíbrio de colunasFio entre colunasEstilos de parágrafoEscapes e caracteres literaisNegrito, itálico e suas coresCitações que posicionam as figurasLegendas numeradasTipos de recurso personalizadosEstilo de legendaAberturas desenhadasImagens nos designs de páginaAtributos de títuloCabeços e fóliosMargens espelhadasPaleta de cores semântica
- Tipografia
- Libre Bodoni, Besley, Archivo Narrow (SIL OFL 1.1)
- Materiais
candle-640.jpgsnuffed-600.jpg- The lit candle on the lecture’s opener, a photograph (Generated With Diffusion Models, original)
- The snuffed candle on the notes’ band, a photograph (Generated With Diffusion Models, original)
- Figure 1, the flame as seen and in section, drawn in code in the page’s palette (Ignacio Ferro, CC BY 4.0)
Preparo
#1 · Transforme as notas de rodapé em notas de fim antes da composição
O pré-processador é a resposta curta lá em cima. O Postext compõe sozinho as notas [^1] (notas de rodapé), no pé da coluna que as cita ou, com placement: 'chapterEnd', depois do último bloco do capítulo. Nos dois casos elas ficam na coluna do capítulo, na fonte do texto, sob um fio curto. Esta edição dá às notas um título, uma faixa e uma página em duas colunas, e um estilo de título só faz isso para um título escrito no Markdown. Por isso o código reescreve o Markdown antes de chamar buildDocument, e o motor nunca vê um [^1]. Ele numera as chamadas na ordem em que o texto as cita pela primeira vez e põe todas as definições, nessa ordem, onde está a primeira delas, sob ## Notes. Cada nota começa com **1**, já que 1. abriria uma lista numerada. Um word joiner (U+2060) abre cada chamada; sem ele, o ** da chamada depois de *Royal George* se juntaria ao asterisco que fecha o itálico num ***, e os asteriscos sairiam impressos.
#2 · Reserve o negrito para as chamadas
const markers = { boldColor: col('ember'), // **^n^**: a superscript at 58 % of the text size
referenceBold: false }; // [Fig. 1] follows the bold colour, set roman
O pré-processador escreve cada chamada como **^n^**. Os acentos circunflexos põem o número a 58% do corpo, elevado em um terço desse corpo (formatação em linha), e o negrito lhe dá bodyText.boldColor, que está livre porque Faraday nunca usa negrito. Um algarismo de 5,8 pt precisa de contraste de 4,5:1 sobre o papel, e o laranja da chama chega só a 2,6:1, por isso as chamadas usam o tom de brasa, mais escuro. A remissão [Fig. 1] na página 17 sai na mesma cor, em redondo, porque referenceColor herda por padrão a cor do negrito e referenceBold: false tira o negrito.
#3 · Componha as notas em corpo menor, com o número pendurado
const NOTE = 8.2; // pt: the notes' size, about four fifths of the text
// The hang is a bold number and an en space, measured in the notes' face once the fonts are in:
// a bold 5 matches 2, 3 and 6 within 0.02 em (the 4 is 0.05 em wider, the 1 0.14 em narrower).
function hang(label = '5') { // from ten notes on, pass the widest label: hang('10')
const ctx = new OffscreenCanvas(1, 1).getContext('2d');
const width = (w, s) => { ctx.font = `${w} 100px "${TEXT}"`; return ctx.measureText(s).width; };
return em((width(700, label) + width(400, ' ')) / 100);
}
// Ragged, as justifying would stretch the en space after each number.
const noteStyles = () => [{ id: 'note', fontSize: pt(NOTE), lineHeight: pt(NOTE * 1.3),
textAlign: 'left', hangingIndent: hang() },
// 22 pt above the colophon is copy-fitted: its last line and the first column's share a line.
{ id: 'colophon', fontFamily: LABEL, fontSize: pt(7), lineHeight: pt(9.2), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(22) },
];
As notas ficam em 8,2 pt sobre 10,7 pt, uns quatro quintos do corpo. O código mede o hangingIndent do estilo na Libre Bodoni depois que as fontes carregam: um 5 em negrito e um espaço de meio quadratim dão 1,12 em, de modo que a primeira palavra de cada nota se alinha com as linhas de continuação (estilos de parágrafo). Com o número para fora, no recuo, as notas não precisam de espaço entre elas. Elas são alinhadas à esquerda porque a justificação esticaria esse espaço de meio quadratim, e uma coluna justificada de 55 mm em corpo 8,2 pt fica frouxa. Os tis marcam subscritos como os circunflexos marcam sobrescritos, como em C~25~H~52~ na nota 4 e H~2~O na nota 5.
#4 · Dê às notas uma página em duas colunas
const BAND = 82; // mm from the trim's top: level with the foot of Figure 1 across the spread
// The band sets the reserve too, but the first grid line clear of it lies 3 mm under the soot:
const BAND_GAP = 5; // mm more of minHeight moves the notes down a line
const notesSection = { id: 'notes', // an opener page: the drop folio, no running heads
breakBefore: { enabled: true, parity: 'any' }, span: 'page', // the next page, either side
layout: { layoutType: 'double', gutterWidth: mm(6), // two columns of about 40 characters
columnRule: { enabled: true, color: col('rule') } }, // and a hairline between them
advancedDesign: { enabled: true, minHeight: mm(BAND - TOP + BAND_GAP), slot: { elements: [
soot(BAND), art('snuffed', 32, 64, BAND, 12), series,
text('kicker', '{attr.kicker}', LABEL, 9.5, 'flame', at('container', 'top-left', 0, 16),
caps(9.5)),
text('title', '{titleText}', DISPLAY, 52, 'wax', below('kicker', 0.5, 80), display),
text('intro', '{attr.intro}', LABEL, 8.4, 'rule', below('title', 2.5, 92),
{ lineHeight: 1.3 }),
] } } };
O título ## Notes {style="notes" …} abre uma seção cujas páginas recebem o layout e o design do estilo. parity: 'any' a começa na página seguinte, par ou ímpar, e span: 'page' estende a faixa pelas duas colunas, de modo que ela chega ao refile e a segunda coluna começa embaixo dela (estilos de título). A faixa define a reserva, mas a primeira linha da grade livre dela fica só 3 mm abaixo da fuligem, de modo que BAND_GAP soma 5 mm a minHeight e as notas começam uma linha mais abaixo. O fio fino entre as colunas é o columnRule do layout do próprio estilo, de modo que só as páginas das notas o desenham. O equilíbrio de colunas vem ativado por padrão e corta a última página para que as duas colunas terminem na mesma linha (equilíbrio de colunas).
#5 · Abra a palestra num campo de fuligem
const FIELD = 112; // mm from the trim's top
// The field reaches below the heading, so it sets the reserve (gotcha: opener-reserves-anchored);
// the H1's default bottom margin (0.5 em of 18 pt) rides on it: the text starts a grid line lower.
const opener = { enabled: true,
slot: { elements: [soot(FIELD), art('candle', 40, 100, FIELD, 10), series,
text('kicker', '{attr.kicker}', LABEL, 9.5, 'flame', below('series', 17, 60), caps(9.5)),
text('title', '{titleText}', DISPLAY, 48, 'wax', below('kicker', 1.5, 96), display),
// 86 mm wide, so the subtitle breaks after a dash, never before one
text('subtitle', '{attr.subtitle}', DISPLAY, 11.5, 'rule', below('title', 3.5, 86),
{ fontWeight: 500, italic: true, lineHeight: 1.3 }),
text('byline', '{attr.byline}', LABEL, 7.6, 'rule', below('subtitle', 7, 84), caps(7.6)),
] } };
O campo é uma caixa ancorada à página, e a vela, um elemento de imagem com um JPEG, se apoia na borda inferior dele. A palestra tem uma só coluna, e um design que fica na coluna é pintado mesmo assim onde seus elementos se ancoram, de modo que o campo parte do refile e atravessa as margens superior e laterais. O antetítulo, o subtítulo e a autoria vêm da linha do título, # A Candle {kicker="Lecture I" subtitle="…" byline="…"}, de modo que a Lecture II não precisaria de código novo. O campo desce além do título, por isso é ele que define a reserva. A margem inferior padrão do título, de 0,5 em, se soma a ela, e o texto começa uma linha da grade abaixo da primeira linha livre da fuligem. O subtítulo tem 86 mm de largura para quebrar depois de um travessão, nunca antes.
#6 · Use a chama sobre a fuligem e a brasa sobre o papel
const palette = {
ink: '#1f1c19', paper: '#fffdf8', // text and the soot of the fields; a warm white page
flame: '#e08a1e', ember: '#a9560c', // kickers on soot (6:1); markers and numbers (5.1:1)
wax: '#f6efe1', rule: '#d4c6ad', // type on soot; hairlines and small type on soot (10:1)
muted: '#6d6356', blue: '#4f7cae', // running heads, colophon (5.8:1); a flame's blue foot
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the ember, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ember })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
O laranja da chama tem contraste de 6:1 sobre a fuligem, mas só de 2,6:1 sobre o papel. Ele colore os antetítulos das faixas escuras e a Figura 1; tudo o que é pequeno e sai em laranja sobre o papel (chamadas, números das notas, o rótulo da figura) usa a brasa, mais escura, com 5,1:1. main-color aponta para a brasa, por isso um valor padrão que a configuração não repete acompanha o design em vez de sair em azul.
A receita completa
// ═══ Postext Cookbook · Nº 020 · Endnotes on a page of their own, in two columns ═════
// https://postext.dev/en/cookbook/endnotes-instead-of-footnotes
// Code: MIT · Text: Faraday, ed. Crookes (PD) · Notes, figure: CC BY 4.0 · Photos: diffusion models
// Fonts: Libre Bodoni, Besley, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'endnotes-instead-of-footnotes';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: soot, wax and a flame; the ember is the flame dark enough for small type
const palette = {
ink: '#1f1c19', paper: '#fffdf8', // text and the soot of the fields; a warm white page
flame: '#e08a1e', ember: '#a9560c', // kickers on soot (6:1); markers and numbers (5.1:1)
wax: '#f6efe1', rule: '#d4c6ad', // type on soot; hairlines and small type on soot (10:1)
muted: '#6d6356', blue: '#4f7cae', // running heads, colophon (5.8:1); a flame's blue foot
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the ember, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ember })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Libre Bodoni', DISPLAY = 'Besley', LABEL = 'Archivo Narrow'; // text; titles; labels
const TOP = 22, INNER = 18, OUTER = 22; // mm: margins, and a 116 mm measure of 74 characters
// #region answer: Markdown footnotes become raised markers and a Notes section
// Use: buildDocument({ markdown: endnotes(markdown) }, config()), with a 'note' paragraph style.
// [^label] in the text → **^n^**, numbered by first citation; bold, so it takes bodyText.boldColor.
// The [^label]: definitions (one line each) print where the first stood, a 'note' paragraph each:
// '**n** text', never '1. text', which would open a numbered list (gotcha: digit-period-list).
function endnotes(markdown, style = 'note') {
const notes = new Map(); // label → text
const HOLE = '\u0000'; // marks where a definition stood: the first becomes the notes
const text = markdown.replace(/^\[\^([^\]\s]+)\]:[ \t]*(.+)\n?/gm,
(_, label, note) => { notes.set(label, note.trim()); return HOLE; });
const cited = []; // labels in order of first citation
const number = (label) => {
if (!notes.has(label)) throw new Error(`The note [^${label}] has no definition`);
if (!cited.includes(label)) cited.push(label);
return cited.indexOf(label) + 1;
};
// Markers side by side share one superscript, [^a][^b] → **^1,2^**, never 12 raised (note 12).
// A word joiner (U+2060, no width) opens each one: after an italic, '*Royal George*' and the
// bold's ** would make '***', which the parser reads as a bold run, and print the asterisks.
const marked = text.replace(/(?:\[\^[^\]\s]+\])+/g, (run) => {
const numbers = [...run.matchAll(/\[\^([^\]\s]+)\]/g)].map(([, label]) => number(label));
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
#Deixe o Postext compor as notas
Tire endnotes() e o título ## Notes, ponha uma linha em branco entre as definições (o motor lê uma definição até a próxima linha em branco) e acrescente footnotes: { placement: 'chapterEnd' } à configuração. O motor numera as chamadas e compõe as notas no fim da palestra, depois do colofão, na única coluna; Notas de rodapé no pé da coluna que as cita mostra como estilizar as notas que o motor compõe.
#Imprima as chamadas na cor da tinta
Se o texto usa negrito para a própria ênfase, imprima as chamadas na cor da tinta, já que boldColor colore igualmente as chamadas e cada palavra em negrito.
-const markers = { boldColor: col('ember'), // **^n^**: a superscript at 58 % of the text size
+const markers = { boldColor: col('ink'), // **^n^**: a superscript at 58 % of the text size#Deixe as colunas de notas terminarem desniveladas
Desative o equilíbrio da última página, e a primeira coluna se enche até o pé antes de a segunda começar.
- headings: { fontFamily: DISPLAY, color: col('ink'), levels: [
+ headings: { fontFamily: DISPLAY, color: col('ink'), balancing: { trailing: false }, levels: [Erros comuns
Erro comum
'1998. ' ou '- ' no início de um parágrafo abre uma lista
Um parágrafo que começa com um número, um ponto e um espaço, ou com um hífen e um espaço, vira item de lista. Coloque um word joiner (U+2060) antes do número e escreva os diálogos com travessão. Escapes e caracteres literais →
Erro comum
Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita
Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →
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 →
Erro comum
Sem <marker> nem filtros na arte SVG (vira bitmap)
Uma figura SVG só continua vetorial no PDF sem <marker>, filtros e máscaras; caso contrário, é rasterizada, e filtros muito aninhados podem deixá-la em branco no Chrome. Desenhe as pontas de seta como caminhos (paths). Figuras e tabelas como recursos →
Erro comum
A página 1 é ímpar: planeje com os números físicos
A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →
Créditos
- Receita
- Ignacio Ferro
- Texto
- The Chemical History of a Candle, Lecture I (abridged), and William Crookes’s notes to it, from the Chatto & Windus impression of 1908 · Michael Faraday; William Crookes · domínio público
- The notes signed Ed., the colophon and the drawings · Ignacio Ferro · CC BY 4.0
- Imagens
- The lit candle on the lecture’s opener, a photograph · Generated With Diffusion Models · original
- The snuffed candle on the notes’ band, a photograph · Generated With Diffusion Models · original
- Figure 1, the flame as seen and in section, drawn in code in the page’s palette · Ignacio Ferro · CC BY 4.0
- Fontes
- Libre Bodoni (SIL OFL 1.1) · Besley (SIL OFL 1.1) · Archivo Narrow (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)


