En poques paraules
Una petita edició d'una famosa conferència científica sobre una espelma. Ensenya a reunir les notes al final, en una pàgina pròpia a dues columnes, en lloc de fer-ho al peu de cada pàgina.
Què compondràs
La primera conferència de The Chemical History of a Candle, de Michael Faraday, en anglès, composta com una petita edició de lectura de 156 × 234 mm. S'obre sobre un camp de sutge amb una espelma encesa recolzada a la seva vora inferior, una fotografia generada amb models de difusió, amb el negre del sutge, i continua en una columna justificada de Libre Bodoni. On un llibre posaria notes a peu de pàgina, uns números petits i volats, en taronja fosc, remeten a les notes, reunides en una pàgina pròpia sota una banda de sutge amb l'espelma ja apagada. Van a dues columnes en bandera, en cos de 8,2 pt i amb el número en negreta penjat al sagnat. Tres de les sis són de William Crookes, editor del text el 1861, i surten de la reimpressió del 1908; les altres tres, noves, van signades Ed. Les dues columnes acaben a la mateixa línia, i el colofó tanca la segona.
Aquesta recepta respon a
- Com faig notes a peu de pàgina?
- Com componc una bibliografia o un glossari (sagnat francès, cos més petit)?
- Com escric superíndexs, subíndexs i fórmules químiques sense escriure LaTeX?
La 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
}
Ingredients
- Funcions
- Superíndexs i subíndexsBibliografies i glossarisGeometria per seccióEstils de títolEquilibri de columnesFilet de columnaEstils de paràgrafEscapaments i caràcters literalsNegreta, cursiva i els seus colorsCites que col·loquen les figuresPeus numeratsTipus de recurs propisEstil dels peusObertures dissenyadesImatges als dissenys de pàginaAtributs de títolCapçaleres i folisMarges simètricsPaleta de color semàntica
- Tipografia
- Libre Bodoni, Besley, Archivo Narrow (SIL OFL 1.1)
- Recursos
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)
Elaboració
#1 · Converteix les notes a peu de pàgina en notes finals abans de compondre
El preprocessador és la resposta curta de més amunt. Postext compon per si mateix les notes [^1] (notes a peu de pàgina): al peu de la columna que les cita o, amb placement: 'chapterEnd', darrere de l'últim bloc del capítol. En tots dos casos es queden a la columna del capítol, amb la lletra del text i sota un filet curt. Aquesta edició vol per a les notes un títol, una banda i una pàgina a dues columnes, i això un estil d'encapçalament només ho dona a un títol escrit al Markdown. Per això el pen reescriu el Markdown abans de passar-lo a buildDocument, i el motor no veu mai una crida [^1]. Numera les crides per l'ordre en què el text les cita per primera vegada i col·loca totes les definicions, en aquest ordre, on hi ha la primera, sota ## Notes. Cada nota comença per **1**, perquè 1. obriria una llista numerada. Un unidor de paraules (U+2060) obre cada crida; sense ell, el ** de la crida que segueix *Royal George* s'ajuntaria amb l'asterisc que tanca la cursiva en un ***, i els asteriscs sortirien impresos.
#2 · Reserva la negreta per a les crides
const markers = { boldColor: col('ember'), // **^n^**: a superscript at 58 % of the text size
referenceBold: false }; // [Fig. 1] follows the bold colour, set roman
El preprocessador escriu cada crida com a **^n^**. Els circumflexos posen el número al 58 % del cos del text, elevat un terç d'aquest cos (format en línia), i la negreta li dona el color de bodyText.boldColor, que aquí és lliure perquè Faraday no fa servir negretes. Una xifra de 5,8 pt necessita un contrast de 4,5:1 sobre el paper, i el taronja de la flama només arriba a 2,6:1; per això les crides van en el de la brasa, més fosc. La remissió [Fig. 1] de la pàgina 17 surt del mateix color i en rodona, perquè referenceColor hereta el color de la negreta i referenceBold: false li treu la negreta.
#3 · Compon les notes en cos menor, amb el número penjat
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) },
];
Les notes van a 8,2 pt sobre 10,7 pt, uns quatre cinquens del cos del text. El hangingIndent del seu estil de paràgraf es mesura a la font, un cop carregada: un 5 en negreta i un espai de mig quadratí sumen 1,12 em en Libre Bodoni, així que la primera paraula de cada nota queda alineada amb les línies següents (estils de paràgraf). Amb el número fora, al sagnat francès, les notes no necessiten espai entre elles. Van en bandera perquè la justificació estiraria aquest espai, i una columna justificada de 55 mm a 8,2 pt quedaria amb massa blanc entre paraules. Les titlles marquen els subíndexs igual que els circumflexos marquen els superíndexs, com a C~25~H~52~ a la nota 4 i H~2~O a la nota 5.
#4 · Dona a les notes una pàgina a dues columnes
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 }),
] } } };
El títol ## Notes {style="notes" …} obre una secció amb pàgines que fan servir la disposició i el disseny de l'estil. parity: 'any' la comença a la pàgina següent, sigui parella o senar, i span: 'page' estén la banda sobre les dues columnes, de manera que arriba al tall i la segona columna comença a sota (estils d'encapçalament). La banda fixa la reserva, però la primera línia de la retícula de base lliure d'ella queda només 3 mm per sota del sutge; amb els 5 mm que BAND_GAP suma a minHeight, les notes comencen una línia més avall. El filet de columna és el columnRule del layout del mateix estil, de manera que només el dibuixen les pàgines de les notes. L'equilibratge de columnes, actiu per defecte, talla l'última pàgina perquè les dues columnes acabin a la mateixa línia (equilibrat de columnes).
#5 · Obre la conferència sobre un camp de sutge
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)),
] } };
El camp és una caixa ancorada a la pàgina, i l'espelma, un element d'imatge amb un JPEG, es recolza a la seva vora inferior. La conferència va a una sola columna, i un disseny que es queda a la seva columna es pinta igualment on s'ancoren els seus elements, de manera que el camp va des del tall i travessa els marges superior i laterals. L'avanttítol, el subtítol i la signatura surten de la línia del títol, # A Candle {kicker="Lecture I" subtitle="…" byline="…"}, així que la conferència II no demanaria codi nou. Com que el camp baixa més que el títol, és ell qui fixa la reserva. S'hi suma el marge inferior per defecte del títol, de 0,5 em, i el text comença una línia de la retícula de base per sota de la primera lliure de sutge. El subtítol fa 86 mm d'amplada perquè es parteixi després d'un guió mitjà i mai abans.
#6 · Fes servir la flama sobre el sutge i la brasa sobre el paper
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' } }));
El taronja de la flama dona un contrast de 6:1 sobre el sutge, però només de 2,6:1 sobre el paper. Per això es reserva per als avanttítols de les bandes fosques i per a la figura 1, i tot el que és petit i va en taronja sobre el paper (crides, números de nota, l'etiqueta del peu de figura) fa servir la brasa, més fosca, que dona 5,1:1. main-color apunta a la brasa, així que qualsevol valor per defecte que la configuració no repeteixi segueix el disseny en lloc de sortir en blau.
La recepta 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));
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Deixa que Postext compongui les notes
Treu endnotes() i el títol ## Notes, deixa una línia en blanc entre les definicions (el motor llegeix cadascuna fins a la línia en blanc següent) i afegeix footnotes: { placement: 'chapterEnd' } a la configuració. El motor numera les crides i compon les notes al final de la conferència, darrere del colofó, a la seva única columna; Notes a peu de la columna que les cita mostra com donar estil a les notes que compon el motor.
#Imprimeix les crides en tinta
Si el text fa servir la negreta per al seu propi èmfasi, posa les crides en tinta: boldColor dona el mateix color a les crides i a cada paraula en negreta.
-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#Deixa que les columnes de notes acabin desiguals
Sense l'equilibratge de l'última pàgina, la primera columna s'omple fins al peu abans que comenci la segona.
- headings: { fontFamily: DISPLAY, color: col('ink'), levels: [
+ headings: { fontFamily: DISPLAY, color: col('ink'), balancing: { trailing: false }, levels: [Errors freqüents
Error freqüent
«1998. » o «- » al començament d'un paràgraf obren una llista
Un paràgraf que comença per un número, un punt i un espai, o per un guionet i un espai, es converteix en un element de llista. Posa un unidor de paraules (U+2060) davant del número i escriu els diàlegs amb guió llarg. Escapaments i caràcters literals →
Error freqüent
Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita
Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →
Error freqüent
Una obertura reserva alçada fins al seu element ancorat més baix
Una obertura de disseny avançat reserva l'alçada del seu element més baix, i també hi compten els ancorats a la pàgina o a la sang que queden per sota del títol, així que un ornament al peu de la pàgina empeny el text a la següent. Dona a aquest element reserve: false (des de postext 1.5): es pinta on està ancorat i no reserva res. Els elements que segueixen la mateixa banda (ancorats al seu peu, o d'alçada 'fill') no en fixen mai l'alçada. Obertures dissenyades →
Error freqüent
Sense <marker> ni filtres als SVG, o passen a mapa de bits
Una figura SVG només continua sent vectorial al PDF sense <marker>, filtres ni màscares; si no, passa a mapa de bits, i els filtres molt imbricats la poden deixar en blanc a Chrome. Dibuixa les puntes de fletxa com a traçats. Figures i taules com a recursos →
Error freqüent
La pàgina 1 és senar: planifica amb números físics
La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 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 · domini públic
- The notes signed Ed., the colophon and the drawings · Ignacio Ferro · CC BY 4.0
- Imatges
- 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
- Fonts
- Libre Bodoni (SIL OFL 1.1) · Besley (SIL OFL 1.1) · Archivo Narrow (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


