En pocas palabras
Una pequeña edición de una famosa conferencia científica sobre una vela. Enseña a reunir las notas al final, en una página propia a dos columnas, en lugar de al pie de cada página.
Lo que vas a componer
La primera conferencia de The Chemical History of a Candle, de Michael Faraday, en inglés, compuesta como una pequeña edición de lectura de 156 × 234 mm. Se abre sobre un campo de hollín con una vela encendida apoyada en su borde inferior, una fotografía generada con modelos de difusión cuyo negro es el del hollín, y sigue en una columna justificada de Libre Bodoni. Donde un libro pondría notas al pie, unos números pequeños y volados, en naranja oscuro, remiten a las notas, reunidas en una página propia bajo una banda de hollín con la vela ya apagada. Van a dos columnas en bandera, en cuerpo de 8,2 pt y con el número en negrita colgado en la sangría. Tres de las seis son de William Crookes, editor del texto en 1861, y salen de la reimpresión de 1908; las otras tres, nuevas, van firmadas Ed. Las dos columnas acaban en la misma línea, y el colofón cierra la segunda.
Esta receta responde a
- ¿Cómo hago notas al pie?
- ¿Cómo compongo una bibliografía o un glosario (sangría francesa, cuerpo menor)?
- ¿Cómo escribo superíndices, subíndices y fórmulas químicas sin escribir LaTeX?
La respuesta corta
// 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
- Funciones
- Superíndices y subíndicesBibliografías y glosariosGeometría por secciónEstilos de títuloEquilibrado de columnasFilete de columnaEstilos de párrafoEscapes y caracteres literalesNegrita, cursiva y sus coloresCitas que colocan las figurasPies numeradosTipos de recurso propiosEstilo de los piesAperturas diseñadasImágenes en los diseños de páginaAtributos de títuloCabeceras y foliosMárgenes simétricosPaleta de color semántica
- Tipografía
- Libre Bodoni, Besley, Archivo Narrow (SIL OFL 1.1)
- Recursos
candle-640.jpgsnuffed-600.jpg- La vela encendida de la apertura de la conferencia, una fotografía (Generated With Diffusion Models, original)
- La vela apagada de la banda de las notas, una fotografía (Generated With Diffusion Models, original)
- La figura 1, la llama vista y en sección, dibujada en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Convierte las notas al pie en notas finales antes de componer
El preprocesador es la respuesta corta de arriba. Postext compone por sí mismo las notas [^1] (notas al pie): al pie de la columna que las cita o, con placement: 'chapterEnd', detrás del último bloque del capítulo. En los dos casos se quedan en la columna del capítulo, con la letra del texto y bajo un filete corto. Esta edición quiere para las notas un título, una banda y una página a dos columnas, y eso un estilo de encabezado solo lo da a un título escrito en el Markdown. Por eso el pen reescribe el Markdown antes de pasárselo a buildDocument, y el motor nunca ve una llamada [^1]. Numera las llamadas por el orden en que el texto las cita por primera vez y coloca todas las definiciones, en ese orden, donde está la primera, bajo ## Notes. Cada nota empieza por **1**, porque 1. abriría una lista numerada. Un unidor de palabras (U+2060) abre cada llamada; sin él, el ** de la llamada que sigue a *Royal George* se juntaría con el asterisco que cierra la cursiva en un ***, y los asteriscos saldrían impresos.
#2 · Reserva la negrita para las llamadas
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 preprocesador escribe cada llamada como **^n^**. Los circunflejos ponen el número al 58 % del cuerpo del texto, elevado un tercio de ese cuerpo (formato en línea), y la negrita le da el color de bodyText.boldColor, que aquí está libre porque Faraday no usa negritas. Una cifra de 5,8 pt necesita un contraste de 4,5:1 sobre el papel, y el naranja de la llama solo llega a 2,6:1; por eso las llamadas van en el de la brasa, más oscuro. La remisión [Fig. 1] de la página 17 sale del mismo color y en redonda, porque referenceColor hereda el color de la negrita y referenceBold: false le quita la negrita.
#3 · Compón las notas en cuerpo menor, con el número colgado
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) },
];
Las notas van a 8,2 pt sobre 10,7 pt, unos cuatro quintos del cuerpo del texto. El hangingIndent de su estilo de párrafo se mide en la fuente, una vez cargada: un 5 en negrita y un espacio de medio cuadratín suman 1,12 em en Libre Bodoni, así que la primera palabra de cada nota queda alineada con sus líneas siguientes (estilos de párrafo). Con el número fuera, en la sangría francesa, las notas no necesitan espacio entre ellas. Van en bandera porque la justificación estiraría ese espacio, y una columna justificada de 55 mm a 8,2 pt quedaría con demasiado blanco entre palabras. Las virgulillas marcan los subíndices igual que los circunflejos marcan los superíndices, como en C~25~H~52~ en la nota 4 y H~2~O en la nota 5.
#4 · Da a las notas una página a dos columnas
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 encabezado ## Notes {style="notes" …} abre una sección cuyas páginas toman la disposición y el diseño del estilo. parity: 'any' la empieza en la página siguiente, sea par o impar, y span: 'page' extiende la banda sobre las dos columnas, de modo que llega al corte y la segunda columna empieza debajo (estilos de encabezado). La banda fija la reserva, pero la primera línea de la rejilla base libre de ella queda solo 3 mm por debajo del hollín; con los 5 mm que BAND_GAP suma a minHeight, las notas empiezan una línea más abajo. El filete de columna es el columnRule del layout del propio estilo, así que solo lo dibujan las páginas de las notas. El equilibrado de columnas, activo por defecto, corta la última página para que las dos columnas acaben en la misma línea (equilibrado de columnas).
#5 · Abre la conferencia sobre un campo de hollín
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 campo es una caja anclada a la página, y la vela, un elemento de imagen con un JPEG, se apoya en su borde inferior. La conferencia va a una sola columna, y un diseño que se queda en su columna se pinta igualmente donde se anclan sus elementos, así que el campo va desde el corte y cruza los márgenes superior y laterales. El antetítulo, el subtítulo y la firma salen de la línea del encabezado, # A Candle {kicker="Lecture I" subtitle="…" byline="…"}, así que la conferencia II no pediría código nuevo. Como el campo baja más que el título, es él quien fija la reserva. A ella se suma el margen inferior por defecto del título, de 0,5 em, y el texto empieza una línea de la rejilla base por debajo de la primera libre de hollín. El subtítulo mide 86 mm de ancho para que se parta después de una semirraya y nunca antes.
#6 · Usa la llama sobre el hollín y la brasa sobre el 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' } }));
El naranja de la llama da un contraste de 6:1 sobre el hollín, pero solo de 2,6:1 sobre el papel. Por eso se reserva para los antetítulos de las bandas oscuras y para la figura 1, y todo lo pequeño que va en naranja sobre el papel (llamadas, números de nota, la etiqueta del pie de figura) usa la brasa, más oscura, que da 5,1:1. main-color apunta a la brasa, así que cualquier valor por defecto que la configuración no repita sigue el diseño en lugar de salir en azul.
La receta 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));
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Deja que Postext componga las notas
Quita endnotes() y el encabezado ## Notes, deja una línea en blanco entre las definiciones (el motor lee cada una hasta la siguiente línea en blanco) y añade footnotes: { placement: 'chapterEnd' } a la configuración. El motor numera las llamadas y compone las notas al final de la conferencia, detrás del colofón, en su única columna; Notas al pie de la columna que las cita muestra cómo dar estilo a las notas que compone el motor.
#Imprime las llamadas en tinta
Si el texto usa la negrita para su propio énfasis, pon las llamadas en tinta: boldColor da el mismo color a las llamadas y a cada palabra en negrita.
-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#Deja que las columnas de notas acaben desiguales
Sin el equilibrado de la última página, la primera columna se llena hasta el pie antes de que empiece la segunda.
- headings: { fontFamily: DISPLAY, color: col('ink'), levels: [
+ headings: { fontFamily: DISPLAY, color: col('ink'), balancing: { trailing: false }, levels: [Errores frecuentes
Error frecuente
«1998. » o «- » al principio de un párrafo abren una lista
Un párrafo que empieza por un número, un punto y un espacio, o por un guion y un espacio, se convierte en un elemento de lista. Pon un unidor de palabras (U+2060) antes del número y escribe los diálogos con raya. Escapes y caracteres literales →
Error frecuente
Un flotante 'top' va a la página siguiente a su cita salvo que pueda encabezar la página que lo cita
Por defecto un flotante nunca va por encima de su propia referencia, así que un flotante 'top' a todo el ancho citado en la página N abre la página N+1. Con placement.citingPage: true en el recurso o en el defaultPlacement de su tipo (o layout.floatsAtCitingPage para todo el libro, desde postext 1.25) encabeza en cambio la página N, y el texto de encima de la referencia baja bajo él, cuando cabe dentro de layout.maxTopFraction y la línea que lo cita sigue en esa página. Nunca encabeza la primera página de un capítulo ni una página tras un salto forzado: allí sigue abriendo la página siguiente, y 'auto' o 'bottom' pueden ocupar el pie de la página que lo cita. Colocación de figuras →
Error frecuente
Una apertura reserva altura hasta su elemento anclado más bajo
Una apertura de diseño avanzado reserva la altura de su elemento más bajo, y cuentan también los anclados a la página o a la sangre que quedan por debajo del título, así que un adorno al pie de la página empuja el texto a la siguiente. Dale a ese elemento reserve: false (desde postext 1.5): se pinta donde está anclado y no reserva nada. Los elementos que siguen a la propia banda (anclados a su pie, o de altura 'fill') nunca fijan su altura. Aperturas diseñadas →
Error frecuente
Sin <marker> ni filtros en los SVG, o pasan a mapa de bits
Una figura SVG solo sigue siendo vectorial en el PDF sin <marker>, filtros ni máscaras; si no, pasa a mapa de bits, y los filtros muy anidados pueden dejarla en blanco en Chrome. Dibuja las puntas de flecha como trazados. Figuras y tablas como recursos →
Error frecuente
La página 1 es impar: planifica con números físicos
La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →
Créditos
- Receta
- Ignacio Ferro
- Texto
- The Chemical History of a Candle, conferencia I (abreviada), y las notas de William Crookes, de la reimpresión de Chatto & Windus de 1908 · Michael Faraday; William Crookes · dominio público
- Las notas firmadas Ed., el colofón y los dibujos · Ignacio Ferro · CC BY 4.0
- Imágenes
- La vela encendida de la apertura de la conferencia, una fotografía · Generated With Diffusion Models · original
- La vela apagada de la banda de las notas, una fotografía · Generated With Diffusion Models · original
- La figura 1, la llama vista y en sección, dibujada en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
- Fuentes
- Libre Bodoni (SIL OFL 1.1) · Besley (SIL OFL 1.1) · Archivo Narrow (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


