Saltar al contingut principal
Recepta número 46

Receptari · Capítol 4 · Capçaleres i folis

Diccionari amb índex de pestanyes

Un bucle fa un estil d'encapçalament per lletra, i el peu de cadascun posa la pestanya blava de la lletra un pas més avall al tall, sobre l'índex pàl·lid.

En aquesta pàgina
Sortida
Canvas
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.65.0
Llicència
Actualitzada el 31 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 150 × 200 mm
  • 2 columnes, espai entre columnes de 4 mm
  • Alegreya 8/10,4
  • Alegreya SC
  • Alegreya Sans SC
  • 4 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 195 ms
  • 180 línies de codi

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

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

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

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

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

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

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

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

Errors 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: 10 deixa 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

Text
Fonts
Alegreya (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1) · Alegreya Sans SC (SIL OFL 1.1)
Sandbox