Saltar al contingut principal
Recepta número 20

Receptari · Capítol 6 · Requadres i notes

Notes finals en pàgina pròpia, a dues columnes

Un preprocessador breu numera les notes [^1] i les reuneix sota un títol Notes, amb un estil que les compon en pàgina pròpia, a dues columnes.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 18–19 · 4–5 de 5

  • Mostra en anglès: encara no hi ha edició en català
  • Format 156 × 234 mm
  • 1 columna
  • Libre Bodoni 10/13,8
  • Archivo Narrow
  • Besley
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 74 ms
  • 185 línies de codi

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

script.js · línies 29–56al codi complet
// 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

Tipografia
Libre Bodoni, Besley, Archivo Narrow (SIL OFL 1.1)
Recursos
  • candle-640.jpg
  • snuffed-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

script.js · línies 60–61al codi complet
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

script.js · línies 65–79al codi complet
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

script.js · línies 116–130al codi complet
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

script.js · línies 101–112al codi complet
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

script.js · línies 14–23al codi complet
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

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

Text
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)
Sandbox