En poques paraules
Un capítol d'un llibre acadèmic sobre la història dels tipus d'impremta. Ensenya a crear dues llistes al final, una de persones i una altra de temes, amb la pàgina on surt cadascun.
Què compondràs
El capítol quart de Letras de metal, una monografia sobre tipus d'impremta de 155 × 235 mm: una columna de Crimson Pro, títols en Bodoni cursiva i un sol color d'accent, vermell maó. L'assaig va de la textura de Gutenberg als moderns de Bodoni, passant per Jenson, Aldo i Griffo, Garamond i Plantin, Caslon i Baskerville, els punts de Fournier i els tipus espanyols que van tallar Pradell i Gil i que va imprimir Ibarra. Acaba com acaben aquests llibres, amb dos índexs en pàgines encarades: impressors, gravadors i mecenes a la parella; tipus, eines i llibres a la senar. Tots dos surten del mateix text marcat, i cada número de pàgina és la pàgina on va caure la marca.
Aquesta recepta respon a
- Com imprimeixo dos índexs, un d'onomàstic i un altre de matèries, a partir del mateix text marcat?
- Com faig un índex analític els números de pàgina del qual canviïn sols quan el text es mou?
La resposta curta
// Marks in the Markdown. A person goes to the names index, inverted:
// :index[Aldus Manutius]{term="Manutius, Aldus" index="names" main}
// A subject goes to the main index, with levels split by "!" and a sort key when the
// printed form would file in the wrong place:
// :index[textura]{term="Blackletter!textura" main}
// :index{term="42-line Bible" sort="Forty-two-line Bible"}
// :index{term="Cursive" see="Italic"}
// Printed at the end, each under its own heading:
// # Index of Names {style="index"} then :::index{index="names"}
// # Index of Subjects {style="index"} then :::index
const indexHeading = {
id: 'index',
numbered: false, // no chapter number, and the next chapter is still chapter 5
breakBefore: { enabled: true, parity: 'any' },
layout: { layoutType: 'double', gutterWidth: mm(7) }, // the section after the heading
};
const index = {
fontSize: pt(8.6), lineHeight: pt(11.2), // one leading for entries and letter heads
indent: em(1), turnoverIndent: em(2),
rangeFormat: 'chicago', // 212–14, as a monograph prints it
main: { bold: true }, // the page of the principal discussion
groups: { fontFamily: 'Bodoni Moda', fontSize: pt(11), fontWeight: 600, color: col('brick') },
};
Ingredients
- Funcions
- Índex analíticEstils de títolCapítols sense númeroObertures dissenyadesAtributs de títolCapçaleres i folisMarges simètricsCapçaleres segons el tipus de pàginaEstils de paràgrafPaleta de color semànticaColor del paperVídues, òrfenes i línies curtesExportació a PDF
- També fa servir
- Fonts incrustades al PDFGeometria per secció
- Tipografia
- Crimson Pro, Bodoni Moda, Libre Franklin (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Marca cada persona per a l'índex onomàstic i cada matèria per al principal
La configuració és la resposta curta de més amunt; la resta és al Markdown. Una marca amb index="names" va a l'índex que imprimeix :::index{index="names"}, i totes les altres a l'índex principal, el que imprimeix :::index sense atributs. Així, :index[Aldo Manucio]{term="Manucio, Aldo" index="names" main} imprimeix el nom al text i anota una pàgina en negreta sota Manucio a l'onomàstic, mentre que :index[cursiva]{term="Cursiva" main}, dues línies més avall, anota la mateixa pàgina sota Cursiva al de matèries. Una persona que també és matèria del capítol pot portar les dues marques.
#2 · Inverteix els noms i ordena per la lletra on el lector buscarà
Els noms van amb el cognom al davant: term="Garamond, Claude", term="Dall’Aglio, Margherita". La coma forma part del terme, de manera que l'ordenació posa Didot, Firmin abans de Didot, François-Ambroise, com faria un indexador. Quan la forma impresa cauria a la lletra equivocada, sort dona la clau: l'edició anglesa marca term="42-line Bible" sort="Forty-two-line Bible" perquè la Bíblia quedi sota la F i no obri un grup 0–9. Les subentrades (term="Fundiciones!Plantin-Moretus"), les pàgines principals en negreta (main), range="start" i range="end" al voltant de l'apartat de Bodoni i les remissions (see="Cursiva", seealso="Matrices") fan la resta. Una destinació amb nivells s'imprimeix amb dos punts: Humana, lletra. Vegeu Lletra romana: veneciana.
#3 · Compon una sola vegada; el document fixa els seus propis números
// A pass finds the page of every mark and prints both indexes with those numbers. When the
// printed index moves a mark (an index set before the text would), the layout runs again,
// until no page number changes (in a buildBundle book, the chapter with :::index gets them all).
const doc = await buildDocumentWithFonts({ markdown }, config(), kitFonts(FONTS));
L'índex imprimeix números de pàgina que només existeixen després de maquetar, i imprimir-lo ocupa pàgines. buildDocument() ho resol: maqueta el capítol, llegeix la pàgina de cada marca, imprimeix els dos índexs i torna a maquetar cada vegada que un número canvia. Aquí els índexs van darrere del text, així que la segona passada confirma la primera; un índex col·locat abans del text desplaçaria totes les pàgines següents, i les passades continuarien fins que coincidissin. Afegeix un paràgraf a l'apartat de Bodoni i l'índex onomàstic donarà a Whittingham la seva pàgina nova sense que hi toquis res.
#4 · Dona a cada índex una obertura sobre dues columnes
const opener = (sink, size) => ({
enabled: true,
minHeight: pt(LEAD * sink), // the text starts on the same grid line in every chapter
slot: { elements: [
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, fontSize: pt(7.8),
letterSpacing: pt(1.6), color: col('brick'), align: 'left',
placement: at('container', 'top-left', 0, 10) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Bodoni Moda', italic: true,
fontSize: pt(size), lineHeight: 1.08, color: col('ink'), align: 'left',
overflow: 'wrap', // design text ends in an ellipsis by default
placement: { ...at('#kicker', 'below', 0, 3), size: { width: 'fill', height: 'auto' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('brick'),
placement: { ...at('#title', 'below', 0, 4.5), size: { width: mm(16) } } },
] },
});
L'estil d'encapçalament de la resposta curta fa tres coses per # Índice onomástico {style="index"}: obre pàgina (parity: 'any', perquè els dos índexs se segueixin sense una pàgina en blanc), compon a dues columnes separades 7 mm la secció que comença després i, amb numbered: false, no compta com a capítol. L'estil reutilitza l'obertura del capítol amb un enfonsament de sis línies i un títol de 20 pt, i les lletres de cada grup repeteixen la seva Bodoni en el color d'accent, amb l'alçada d'una línia de l'índex perquè les columnes no perdin el pas.
#5 · Posa el nom de l'índex a la pàgina senar
const head = (id, content, parity, edge, x, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'body', // never on openers
...label, fontSize: pt(7.2), letterSpacing: pt(1.3), color: col('muted'),
placement: at('page', edge, x, 12.5), ...extra,
});
const folio = { color: col('brick'), fontWeight: 700 };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', MARGIN.outer,
{ ...folio, align: 'left' }),
head('verso-title', '{title}', 'even', 'top-left', MARGIN.outer + 8, { align: 'left' }),
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(MARGIN.outer + 8),
{ align: 'right' }),
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, -12) }), pages: 'opener' }] };
La capçalera de la pàgina senar imprimeix {chapterTitle}, i el títol d'un índex és de primer nivell com el de qualsevol capítol, així que les pàgines que el segueixen diuen Índex de matèries a dalt. pages: 'body' treu les capçaleres de les dues obertures d'índex, que porten un foli al peu.
La recepta completa
// ═══ Postext Cookbook · Nº 073 · An index of names and an index of subjects ═══════
// https://postext.dev/en/cookbook/names-and-subjects-indexes
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Crimson Pro, Bodoni Moda, Libre Franklin (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import { 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 = 'names-and-subjects-indexes';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a warm black, one brick red for kickers, letter heads and folios
const palette = {
ink: '#211d19', // text: a warm near-black
brick: '#8e3b24', // the one accent
muted: '#6d645a', // running heads, colophon
rule: '#c8bba9', // hairlines
paper: '#fcfaf5',
};
// A colour is its hex and the palette entry it follows.
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.brick, model: 'hex' } },
];
// #endregion
const TRIM = { width: 155, height: 235 }; // a scholarly monograph
const MARGIN = { top: 22, bottom: 24, inner: 19, outer: 22 }; // mirrored: 114 mm measure
const LEAD = 13.6; // body leading in pt
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const label = { fontFamily: 'Libre Franklin', fontWeight: 600, textTransform: 'uppercase' };
// #region answer: two indexes from one text, each under a two-column heading style
// Marks in the Markdown. A person goes to the names index, inverted:
// :index[Aldus Manutius]{term="Manutius, Aldus" index="names" main}
// A subject goes to the main index, with levels split by "!" and a sort key when the
// printed form would file in the wrong place:
// :index[textura]{term="Blackletter!textura" main}
// :index{term="42-line Bible" sort="Forty-two-line Bible"}
// :index{term="Cursive" see="Italic"}
// Printed at the end, each under its own heading:
// # Index of Names {style="index"} then :::index{index="names"}
// # Index of Subjects {style="index"} then :::index
const indexHeading = {
id: 'index',
numbered: false, // no chapter number, and the next chapter is still chapter 5
breakBefore: { enabled: true, parity: 'any' },
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
#Imprimeix un únic índex
Treu index="names" de les marques de persones i el segon títol: llavors totes les marques van a l'índex principal, noms i matèries en un sol alfabet.
-:index[Aldo Manucio]{term="Manucio, Aldo" index="names" main}
+:index[Aldo Manucio]{term="Manucio, Aldo" main}#Treu les lletres de grup
Un onomàstic tan curt es llegeix bé sense aquestes lletres. groups.enabled: false les treu i deixa una línia d'espai entre lletres; l'opció val per als dos índexs.
- groups: { fontFamily: 'Bodoni Moda', fontSize: pt(11), fontWeight: 600, color: col('brick') },
+ groups: { enabled: false },Errors freqüents
- La configuració
indexés comuna: els dos índexs comparteixen lletra, interlineat i lletres de grup. - Una marca en un peu de figura o en una cel·la de taula s'imprimeix tal qual. Marca la persona al paràgraf que cita la figura.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- “From Textura to Bodoni”, an essay on the history of printing types written for this recipe, in English and Spanish · Ignacio Ferro · CC BY 4.0
- Fonts
- Crimson Pro (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · Libre Franklin (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)


