En poques paraules
Quatre pàgines d'un antic diccionari de mariners. Unes pestanyes amb lletres baixen per la vora exterior, i la de la lletra actual va en fosc i més avall a mesura que avança l'alfabet.
Què compondràs
Quatre pàgines d'una nova edició del Sailor’s Word-Book de l'almirall Smyth (1867), de la A a la C, en una pàgina de 150 × 200 mm. Les entrades van en dues columnes justificades d'Alegreya de 8 pt, separades per un filet, amb el lema en negreta blau marí i sagnat francès d'1 em. Cada lletra s'obre dins de la seva columna amb una inicial blava de quatre línies sobre un filet color llautó, i les entrades continuen sense salt de pàgina. Al tall davanter, cada pàgina imprimeix l'índex sencer, 22 pestanyes en un to pàl·lid. La de la lletra en curs és blau marí, 3,2 mm més ampla que les altres, i baixa un pas amb cada lletra. L'edició castellana conserva els lemes anglesos de Smyth i tradueix les entrades.
Aquesta recepta respon a
- Com afegeixo un índex de pestanyes: una pestanya al tall davanter que baixa per la pàgina d'una lletra o d'un capítol al següent?
- Com componc una bibliografia o un glossari (sagnat francès, cos més petit)?
- Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?
- Com poso capçaleres: el títol del llibre a la pàgina esquerra, el del capítol a la dreta i el foli per fora?
- Com amago les capçaleres a les obertures i a les pàgines en blanc, o pinto una pàgina parella en blanc amb el color de la part?
La resposta curta
// 22 tabs share the 44 lines of the text block, two lines each; letters with few words
// share a tab, as in most thumb-indexed dictionaries.
const TABS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'QR', 'S', 'T', 'UV', 'W', 'XYZ'];
const STEP = 2 * LEAD * PT; // mm: 7.34
const EDGE = { odd: 'top-right', even: 'top-left' }; // the fore-edge: right on a recto
// A cell of the index, `width` mm inside the trim and 3 mm past it, so that only its
// inner corners show their rounding; its label is centred on the part inside the trim.
const cell = (id, label, i, parity, width, fill, ink, size) => {
const y = mm(TOP + i * STEP + 0.3); // a 0.6 mm gap between neighbours
const at = (x, w) => ({ anchor: { to: 'page', edge: EDGE[parity] }, offset: { x: mm(x), y },
size: { width: mm(w), height: mm(STEP - 0.6) } });
return [
{ kind: 'box', id, parity, style: { backgroundColor: col(fill), borderRadius: mm(1.2) },
placement: at(parity === 'odd' ? 3 : -3, width + 3) },
{ kind: 'text', id: `${id}-label`, parity, content: label, fontFamily: LABEL, fontWeight: 700,
fontSize: pt(size), lineHeight: 1, color: col(ink), align: 'center',
verticalAlign: 'middle', placement: at(0, width) },
];
};
const sides = (make) => ['odd', 'even'].flatMap(make);
// Every page prints the whole index, pale, in the book's header (hook-up in config()).
const ladder = sides((p) => TABS.flatMap((label, i) =>
cell(`index-${i}-${p}`, label, i, p, 5.8, 'tint', 'slate', 7.5)));
// The section's own tab goes in its footer, which paints after the header: it lies over
// its pale cell. Elements anchored to 'page' can sit anywhere, whichever slot holds them.
const letterStyles = () => TABS.flatMap((label, i) => [...label].map((letter) => ({
id: letter,
// '# B {style="B"}' opens the section of B: its pages take this footer, and a page
// where A ends and B begins takes B's (gotcha: section-last-wins).
footer: { elements: [...footer.elements,
...sides((p) => cell(`tab-${p}`, label, i, p, 9, 'navy', 'paper', 8.5))] },
})));
Ingredients
- Funcions
- Bandes a sang i pestanyesCapçaleres per seccióNegreta, cursiva i els seus colorsEstils de títolObertures dissenyadesAncoratge d'elements de dissenyImatges als dissenys de pàginaAtributs de títolEstils de paràgrafBibliografies i glossarisCapçaleres segons el tipus de pàginaCapçaleres i folisFilet de columnaEquilibri de columnesVídues, òrfenes i línies curtesPartició de mots i llengua del documentPaleta de color semànticaColor del paperMarges simètricsFigures i taules com a recursos
- Tipografia
- Alegreya, Alegreya SC, Alegreya Sans SC (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un estil d'encapçalament per lletra, cadascun amb la seva pestanya
El codi és a la resposta curta, més amunt. TABS enumera 22 pestanyes; les lletres amb poques entrades en comparteixen una (QR, UV, XYZ). Cada pestanya fa dues línies de text (7,34 mm), així que entre totes cobreixen les 44 línies de la caixa. El header del llibre imprimeix a totes les pàgines les capçaleres i l'índex pàl·lid. El bucle dona a cada lletra un estil d'encapçalament amb un footer que afegeix la pestanya blava d'aquella lletra, un pas més avall que l'anterior (estils d'encapçalament). El peu es pinta després de la capçalera, de manera que la pestanya queda damunt de la seva cel·la pàl·lida, i la configuració desa l'índex una sola vegada i no una per lletra. Cada cel·la s'escriu dues vegades, una per parity, i s'ancora a la vora exterior de la pàgina, no al contenidor propi del seu espai. Aquest contenidor és un marge de l'amplada de la caixa, i les pestanyes han d'arribar al tall davanter i baixar per les 44 línies. Una pàgina pren el peu de l'última secció que hi comença, així que la pàgina 2 comença a la A i porta la pestanya de la B.
#2 · Les capçaleres, fora de la primera pàgina
const HEAD = 11; // mm from the trim's top to the heads' top
const head = (id, content, parity, edge, x, extra) => ({ kind: 'text', id, content, parity,
pages: 'body', fontFamily: LABEL, fontSize: pt(8), fontWeight: 500, letterSpacing: pt(1),
color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD) } }, ...extra });
const folio = { fontWeight: 700, color: col('ink'), letterSpacing: pt(0) };
const runningHeads = [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
head('recto-letter', t({ en: 'Letter {chapterTitle}', es: 'Letra {chapterTitle}' }), 'odd',
'top-right', -(OUTER + 8)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
];
// The first page drops its folio to the foot, under the text block.
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'top', 0, {
...folio, pages: 'opener',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(6) } } })] };
Les capçaleres són elements de text ancorats a la pàgina i filtrats per parity i per pages: 'body' (elements de text). El títol de la pàgina 1 abasta les dues columnes, i això la converteix en pàgina d'obertura. Les capçaleres no hi surten, i el foli el posa el peu, un element amb pages: 'opener' que s'imprimeix 6 mm per sota de la caixa. A les senars, {chapterTitle} imprimeix la lletra de l'últim títol de nivell 1 que hi ha a la pàgina o abans, Letra C. {firstMark.<clave>} i {lastMark.<clave>} imprimeixen en el seu lloc el primer i l'últim lema de la pàgina, les paraules guia que porten gairebé tots els diccionaris; aquesta recepta conserva la lletra, que és el que indexen les seves pestanyes.
#3 · Color per als lemes i res més
// Bold and italic default to the engine's blue: the body sets them to ink, and only the
// entry style prints its bold, the headwords, in navy.
const BODY = 8; // pt: a reference size, about 50 characters to the 60 mm column
const bodyText = { fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), firstLineIndent: mm(0),
minWordSpacing: 0.7, maxWordSpacing: 1.7,
maxJustifyTracking: 10, // up to 1 % of tracking before a line's spaces pass 1.7
hyphenateAcrossColumns: false, // no word is divided over a column or a page
maxRuntTracking: 0 }; // a short last line stays: tracking it away crushes a 60 mm line
const paragraphStyles = [
{ id: 'entry', hangingIndent: em(1), boldColor: col('navy') }, // :::paragraphs{style="entry"}
{ id: 'colophon', fontSize: pt(7), color: col('muted'), textAlign: 'center',
marginTop: pt(LEAD) },
];
Cada entrada és un paràgraf d'un bloc :::paragraphs{style="entry"}, amb sagnat francès d'1 em (estils de paràgraf). El boldColor del cos deixa el Nota. de la pàgina 1 en el color del text, i el de l'estil d'entrada posa els lemes en blau marí. Un estil de paràgraf no té italicColor, així que les cursives de les entrades conserven el color del cos.
#4 · Una inicial de quatre línies dins de la columna
// Its cap line meets the first body line's and it stands on the fourth baseline. Cap
// heights measured on the glyph H: 0.652 em in Alegreya SC 900, 0.646 em in Alegreya.
const DROP = 4; // body lines the letter spans
const LETTER = ((DROP - 1) * LEAD + 0.646 * BODY) / 0.652; // pt: 55.8
// A design line sets its baseline 0.8 of its height below its top; a body line does too.
const letterHead = { enabled: true, slot: { elements: [
{ kind: 'text', id: 'letter', content: '{titleText}', fontFamily: DISPLAY, fontWeight: 900,
fontSize: pt(LETTER), lineHeight: 1, color: col('navy'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: pt((DROP - 0.2) * LEAD - 0.8 * LETTER) } } },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.6), color: col('brass'),
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: pt((DROP + 0.55) * LEAD) }, size: { width: 'fill' } } },
] } };
LETTER, 55,8 pt, és el cos amb què una majúscula d'Alegreya SC 900 (0,652 em d'alçada) s'assenta a la quarta línia de base i arriba a l'altura de les majúscules de la primera línia de text. La lletra i el filet color llautó acaben dins de la cinquena línia, i el bloc del títol baixa fins a la línia següent de la retícula de base, així que cada inicial ocupa cinc línies i les entrades de sota continuen a la retícula. A la pàgina 3, la C que encapçala la segona columna mesura el mateix que les quatre primeres línies de la primera. El nivell 1 declara breakBefore: { enabled: false }, que desactiva el salt de pàgina que un títol de nivell 1 té per defecte, i els estils de les lletres l'hereten, així que la B i la C comencen a mitja columna.
#5 · El títol a l'amplada de les dues columnes
const centred = (id, content, family, size, lineHeight, y, width, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), lineHeight, color: col('navy'), align: 'center',
overflow: 'wrap', ...extra, placement: { anchor: { to: 'container', edge: 'top' },
offset: { y: mm(y) }, size: { width: width ? mm(width) : 'fill' } } });
const rule = (id, y, thickness) => ({ kind: 'rule', id, direction: 'horizontal',
thickness: pt(thickness), color: col('navy'), placement: { anchor: { to: 'container',
edge: 'top-left' }, offset: { y: mm(y) }, size: { width: 'fill' } } });
const titleBand = { enabled: true, slot: { elements: [
{ kind: 'image', id: 'anchor', resourceId: 'anchor', placement: {
anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: mm(18) } } },
centred('name', '{titleText}', DISPLAY, 22, 1.1, 20, 0, { fontWeight: 900 }),
centred('subtitle', '{attr.subtitle}', TEXT, 9, 1.25, 29.5, 92, { italic: true,
color: col('ink') }),
centred('byline', '{attr.byline}', LABEL, 7, 1.2, 38.8, 0, { fontWeight: 500,
letterSpacing: pt(1.2), color: col('muted') }),
rule('thick', 43.6, 1.2),
rule('thin', 45, 0.4),
] } };
// '# The Sailor’s Word-Book {style="title" subtitle="…" byline="…"}' opens page 1.
const titleStyle = { id: 'title', span: 'page', advancedDesign: titleBand };
L'estil del títol abasta la pàgina amb una banda que reuneix l'àncora, el nom, un subtítol i una signatura presos d'atributs del títol, i un filet doble (extensió i disseny avançat). El filet fi acaba 45,1 mm per sota de la vora superior de la caixa, així que la banda s'ajusta a 13 línies de la retícula, 47,7 mm. El filet de columna comença sota la banda, a la línia on comença el text de les dues columnes.
La recepta completa
// ═══ Postext Cookbook · Nº 046 · Dictionary with a moving thumb index ═══════════════
// https://postext.dev/en/cookbook/dictionary-thumb-index
// Code: MIT · Text: W. H. Smyth, 1867 (PD); Spanish translation CC BY 4.0 · Pictures: code
// Fonts: Alegreya, Alegreya SC, Alegreya Sans SC (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'dictionary-thumb-index';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and navy on a warm paper, brass for the rules and the rope
const palette = {
ink: '#1b1f24', // text
navy: '#1f3a5f', // headwords, letters and tabs
brass: '#a4834f', // hairlines and the rope of the vignette
rule: '#cfccc3', // the column rule
tint: '#e4e9f0', // the pale cells of the index
slate: '#56657b', // their letters
muted: '#62666b', // running heads
paper: '#fbfaf6', // the page, and the letter reversed out of each tab
};
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' } }));
// #endregion
const TEXT = 'Alegreya', DISPLAY = 'Alegreya SC', LABEL = 'Alegreya Sans SC';
const PT = 25.4 / 72; // mm in a point
const LEAD = 10.4; // pt: the body's leading, the grid every column is set on
const LINES = 44; // lines in a full column
const TOP = 18, INNER = 12, OUTER = 14; // mm; the foot margin makes the block whole lines
const BOTTOM = 200 - TOP - LINES * LEAD * PT;
// #region answer: one heading style per letter, each with its tab one step down the fore-edge
// 22 tabs share the 44 lines of the text block, two lines each; letters with few words
// share a tab, as in most thumb-indexed dictionaries.
const TABS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'QR', 'S', 'T', 'UV', 'W', 'XYZ'];
const STEP = 2 * LEAD * PT; // mm: 7.34
const EDGE = { odd: 'top-right', even: 'top-left' }; // the fore-edge: right on a recto
// A cell of the index, `width` mm inside the trim and 3 mm past it, so that only its
// inner corners show their rounding; its label is centred on the part inside the trim.
const cell = (id, label, i, parity, width, fill, ink, size) => {
const y = mm(TOP + i * STEP + 0.3); // a 0.6 mm gap between neighbours
const at = (x, w) => ({ anchor: { to: 'page', edge: EDGE[parity] }, offset: { x: mm(x), y },
size: { width: mm(w), height: mm(STEP - 0.6) } });
return [
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 només la pestanya en curs
Els índexs de pestanyes impresos solen mostrar només la de la lletra en curs; treu ladder de la capçalera i la pestanya blava continuarà baixant de la A a la C.
- header: { elements: [...runningHeads, ...ladder] }, // the same on every page
+ header: { elements: [...runningHeads] }, // the same on every pageErrors freqüents
Error freqüent
Una pàgina pren la capçalera de l'última secció que hi comença
Quan dos estils de títol comencen a la mateixa pàgina, aquesta pren la capçalera, el peu i la paleta de l'últim. Una pàgina en blanc de separació pertany al capítol anterior, i l'emplenament de paritat, al següent. Capçaleres per secció →
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
Error freqüent
Els elements de capçalera i peu es pinten damunt del text
Els elements de capçalera i peu es pinten sobre la pàgina i l'àrea de text no els deixa lloc. Mantén-los dins dels marges, que són els que els reserven l'espai. Capçaleres i folis →
Error freqüent
Els desplaçaments negatius relatius al contenidor no pinten res
El text de disseny d'amplada automàtica es limita al seu contenidor, de manera que un desplaçament negatiu respecte al contenidor el treu fora i no es pinta res. Ancora aquests elements a la pàgina o a la sang amb desplaçaments explícits en mm, o dona'ls una amplada fixa. Ancoratge d'elements de disseny →
- Una columna de 60 mm admet uns 50 caràcters, i l'anglès de Smyth no es pot reescriure. Compostes només amb els seus espais, 18 de les 218 línies justificades angleses (un 8 %) els estiraven més d'1,7 vegades l'amplada normal, davant de menys d'un 2 % a l'edició castellana, amb una traducció ajustada a la columna, i la primera línia de Cross-trees no arribava a omplir-se.
maxJustifyTracking: 10deixa que una línia prengui fins a un 1 % de tracking abans que els seus espais passin aquest límit: a la captura en porten 25 de les 217 línies angleses i 9 de les 223 castellanes, i cap no passa d'1,7. L'anglès arribava al 17 % abans de canviar per unes altres les cinc entrades que pitjor componien (Aground, Aloft, Belay, Cockpit, Crow’s nest). Tria entrades que componguin bé, o eixampla la columna.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The Sailor’s Word-Book (London: Blackie and Son, 1867), entries from A, B and C · W. H. Smyth; Sir Edward Belcher · domini públic
- Spanish translation, editor’s note and colophon · Postext Cookbook · original
- Fonts
- Alegreya (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1) · Alegreya Sans SC (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)


