Saltar al contingut principal
Recepta número 71

Receptari · Capítol 6 · Requadres i notes

Notes al peu de la columna que les cita

Les crides [^id] passen a notes numerades al peu de la columna que les cita, amb interruptors per a una columna, notes finals i numeració contínua.

En aquesta pàgina
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 2 columnes, espai entre columnes de 7 mm
  • EB Garamond 10,5/13,5
  • Bodoni Moda
  • IBM Plex Sans Condensed
  • 3 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 69 ms
  • 164 línies de codi

En poques paraules

Una edició escolar del Lazarillo de Tormes, a dues columnes. Ensenya a col·locar cada nota al peu de la columna que la cita, perquè no calgui passar la pàgina per llegir-la.

Què compondràs

Una edició escolar del Lazarillo de Tormes, de 210 × 280 mm i a dues columnes d'EB Garamond: el pròleg i el començament del tractat primer, on Lázaro neix en un molí del Tormes i surt al món amb un cec. Les notes aclareixen el que un lector de 1554 sabia i un d'avui ignora: el llogaret de Tejares, l'armada contra els Gelves, el toro de pedra del pont de Salamanca. Cada nota va al peu de la columna que la cita, en un cos menor i sota un filet curt de color bordeus, de manera que la vista baixa del número a la nota i torna sense passar pàgina. Les notes de l'edició en castellà adapten les de Clements Markham, de 1908, i hi afegeixen algunes glosses de vocabulari.

Aquesta recepta respon a

  • Com faig notes a peu de pàgina?

La resposta curta

script.js · línies 42–54al codi complet
// 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') },
});

Ingredients

Tipografia
EB Garamond, Bodoni Moda, IBM Plex Sans Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Cita la nota on toca i defineix-la on vulguis

La configuració és la resposta curta de més amunt; la resta és Markdown. naturales de Tejares[^tejares] imprimeix un número volat enganxat a la paraula, i un paràgraf que comença per [^tejares]: conté la nota. Les definicions surten del flux siguin on siguin, així que aquesta mostra les aplega al final del capítol. Els números segueixen l'ordre de les crides: els ids del Markdown poden ser paraules, i renumerar un capítol mai no obliga a tocar les notes.

#2 · Deixa lloc a la columna per a les seves notes

Abans de col·locar una línia, la maquetació suma l'alçada de les notes que aquella línia cita per primera vegada, i la del filet si és la primera nota de la columna. Una línia que cita una nota que no hi cap a sota passa a la columna següent amb el seu paràgraf, segons les regles de vídues i òrfenes, de manera que un número mai no remet a una nota d'una altra columna. Les notes s'apilen des del peu amb el seu propi cos i interlineat, fora de la retícula de base, i el text de sobre hi continua; l'equilibratge de columnes només compta el text.

#3 · Enfonsa totes les obertures fins a la mateixa línia

script.js · línies 58–76al codi complet
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) } } },
  ] },
};

L'obertura ocupa les dues columnes i pren l'avanttítol de l'atribut kicker del títol. minHeight reserva deu línies de la retícula, l'espai d'un títol de dues línies en Bodoni amb el seu filet, així que el text de cada capítol comença a la mateixa línia i el filet mai no cau sobre la primera línia de text.

#4 · Posa el llibre a la pàgina parella i el capítol a la senar

script.js · línies 80–97al codi complet
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' }] };

Les capçaleres s'ancoren a la pàgina segons la seva paritat, amb el foli a la vora exterior; pages: 'body' les treu de les obertures, que porten un foli centrat al peu. Un títol de capítol llarg acaba en punts suspensius als 120 mm en lloc de topar amb el foli.

#5 · Prova les altres posicions

script.js · línies 222–250al codi complet
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 interruptor torna a compondre el capítol amb una opció canviada. Una columna posa les notes a peu de pàgina, que allà és la columna. Final del capítol les compon després de l'últim paràgraf i les baixa al peu de la columna que tanquen, sota el mateix filet. Contínua segueix la numeració del pròleg al tractat en lloc de tornar a començar per l'1.

La recepta 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 = 'es'; // @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

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 les notes finals sota el text

Amb placement: 'chapterEnd' les notes queden per defecte al peu de l'última columna; chapterEndAlign: 'text' les posa just sota l'últim paràgraf.

   placement: options.placement,
+  chapterEndAlign: 'text',

#Treu el filet

Sense filet, les notes continuen separades del text per spaceAbove i spaceBelowRule.

-  separator: { width: 0.25, lineWidth: pt(0.5), color: col('oxblood') },
+  separator: { enabled: false },

Errors freqüents

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 →

Avís de maquetació · undefinedFootnote

Nota sense definició

Per què. Una marca [^id] cita una nota que cap paràgraf [^id]: no defineix, de manera que el número s'imprimeix sobre una nota buida.

Solució. Afegeix un paràgraf [^id]: amb la nota o corregeix l'id de la marca. Documentació →

Avís de maquetació · unusedFootnote

Nota sense citar

Per què. Una definició [^id]: no té marca al text, de manera que la nota no es compon.

Solució. Cita-la amb [^id] on correspongui o treu la definició. Documentació →

  • Una crida en un peu de figura, una cel·la de taula o un títol s'imprimeix tal qual: les notes es llegeixen en paràgrafs, elements de llista, citacions i requadres.
  • Una nota mai no es parteix entre columnes: una de més alta que la seva columna la desborda. Mantén les notes en poques línies, com fan els editors.

Crèdits

Text
  • La vida de Lazarillo de Tormes, Burgos edition of 1554: the prologue and the beginning of the first treatise · Anonymous · domini públic
  • The Life of Lazarillo de Tormes, translated by Clements Markham (1908), with his notes: the prologue and the first chapter, abridged · Clements Markham · domini públic
  • The Spanish notes, adapted from Markham's and written for this edition · Ignacio Ferro · CC BY 4.0
Fonts
EB Garamond (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
SandboxPDF