Saltar al contingut principal
Recepta número 5

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

Capçaleres segons la paritat en un llibre d'assajos

Capçaleres per paritat i tipus de pàgina: el títol del llibre a les parelles, el de l'assaig tallat a les senars i només un foli al peu a les obertures.

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

pp. 30–31 · 2–3 de 5

  • Mostra en castellà: encara no hi ha edició en català
  • Format 132 × 198 mm
  • 1 columna
  • Baskervville 10,2/14
  • Alegreya SC
  • Libre Caslon Display
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 56 ms
  • 174 línies de codi

En poques paraules

Cinc pàgines d'un llibre d'assajos de butxaca. Ensenya a posar el títol del llibre a dalt de les pàgines de l'esquerra i el de l'assaig a les de la dreta.

Què compondràs

Les pàgines 29 a 33 dels Assajos de Montaigne en edició de butxaca i traducció nova: el capítol IV sencer i l'inici del V. Les parelles porten el títol del llibre en versals espaiades, i les senars, el de l'assaig en cursiva, tallat amb punts suspensius perquè el del capítol IV té 87 caràcters. Cada foli va en una pestanya sèpia al marge exterior, a 3 mm d'un filet de 0,5 pt a la vora de la caixa. Les obertures només tenen un foli al peu, i la pàgina en blanc anterior al capítol V no porta capçalera ni foli. El text va en Baskervville sobre paper ossi; els títols, en Libre Caslon Display, i els folis i el títol del llibre, en Alegreya SC. La configuració defineix totes les capçaleres, així que la del motor (Open Sans de 8 pt, en blau) no s'imprimeix.

Aquesta recepta respon a

  • 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?
  • Com evito que els títols, les negretes i les vinyetes surtin en blau?

La resposta curta

script.js · línies 67–95al codi complet
const GAP = 3; // mm from the tab to the divider, which lands on the text block's edge
const HEAD = 12; // mm from the top edge of the page to the top of the tab
const CAP = t({ en: 60.5, es: 66.8 }); // mm: the head's widest line, set per edition so
// essay IV's is cut after 'false' and 'objetos'; a short running title suits any title
const page = (edge) => ({ to: 'page', edge }); // the trim box (gotcha: negative-offsets)
const header = { elements: [
  // Verso (even): tab | divider | THE BOOK'S TITLE from the frontmatter
  folio({ id: 'folio-even', parity: 'even', pages: 'body', anchor: page('top-left'),
    x: OUTER - GAP - TAB, y: HEAD }),
  divider({ id: 'rule-even', parity: 'even', from: 'folio-even', edge: 'right-of', x: GAP }),
  { kind: 'text', id: 'book', content: '{title}', parity: 'even', pages: 'body',
    fontFamily: 'Alegreya SC', fontSize: pt(FOLIO_PT), lineHeight: LINE / FOLIO_PT,
    color: col('muted'), textTransform: 'uppercase', letterSpacing: pt(1.3),
    placement: { anchor: { to: '#rule-even', edge: 'right-of' }, // top: the tab's top
      offset: { x: mm(2.5), y: pt(PAD.top) } } }, // PAD.top down: on the folio's baseline
  // Recto (odd): the essay's title, cut short with an ellipsis | divider | tab.
  folio({ id: 'folio-odd', parity: 'odd', pages: 'body', anchor: page('top-right'),
    x: -(OUTER - GAP - TAB), y: HEAD }), // from the right edge, a negative x runs inwards
  divider({ id: 'rule-odd', parity: 'odd', from: 'folio-odd', edge: 'left-of', x: -GAP }),
  { kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
    fontFamily: 'Baskervville', italic: true, fontSize: pt(TITLE_PT),
    lineHeight: LINE / TITLE_PT, color: col('muted'),
    overflow: 'ellipsis-end', // stated, though a running head's default
    placement: { anchor: { to: '#rule-odd', edge: 'left-of' },
      offset: { x: mm(-2.5), y: pt(PAD.top) }, size: { maxWidth: mm(CAP) } } },
] };
// Openers: no head, only a drop folio HEAD above the page's foot, centred under the text block.
const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };

Ingredients

Tipografia
Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Substitueix la capçalera blava de sèrie

script.js · línies 14–26al codi complet
const palette = {
  ink: '#1f1b16', // text: a warm near-black, never #000
  sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
  muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
  paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
  // Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
  // pointed at the sepia, none of them prints in the engine's blue.
  { id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];

Cada color de la configuració enllaça amb una d'aquestes entrades. Si deixes header sense definir, el motor dibuixa la seva capçalera de sèrie: {title} a les senars i {chapterTitle} a les parelles sobre un filet d'1 pt, en Open Sans 600 de 8 pt i en blau #295AA3 (encapçalaments i peus). Si main-color pren el valor del sèpia, canvien els colors per defecte del text i també el d'aquesta capçalera, però la lletra, el filet i el costat on va cada títol continuen sent els del motor. Per això aquí cada capçalera s'escriu sencera, amb cada color enllaçat a una entrada de la paleta. La negreta, la cursiva i les referències també prenen main-color per defecte, i bodyText els retorna el color de la tinta.

#2 · Totes les capçaleres surten d'una pestanya

script.js · línies 31–48al codi complet
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
  kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
  fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
  box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
    padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
  placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
  kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
  color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
    size: { height: pt(TAB_H) } },
});

La resposta curta ancora a 'page' la pestanya de cada capçalera, així que els seus desplaçaments es mesuren des del tall. Des de la cantonada top-right, una x positiva treu la pestanya de la pàgina; per això la de la senar la porta negativa. De la pestanya penja el filet, i del filet, el títol (posicionament d'elements). Les mesures de la pestanya van en constants perquè les altres peces es mesuren a partir d'aquestes. El filet fa TAB_H d'alt. El foli i els dos títols comparteixen una caixa de línia de 9 pt, i la línia de base d'un text de disseny cau al 80 % de l'alçada d'aquesta caixa, així que tots tres queden sobre la mateixa línia de base amb qualsevol cos.

Pàgina 30, parella: pestanya, filet i títol del llibre, cap endins des del marge exterior.
Pàgina 31, senar: el títol de l'assaig, retallat abans del filet i de la pestanya del marge exterior.

#3 · Marges en mirall i línies senceres

script.js · línies 52–63al codi complet
const TRIM = { width: 132, height: 198 }; // mm
const TOP = 22; // mm: the top margin, which holds the heads (gotcha: header-paints-over-text)
const INNER = 15; // mm
const OUTER = 21; // mm: the outer margin, where the folio tabs hang
const LINES = 31; // whole lines of LEAD in the text block, so full pages end level
const MEASURE = TRIM.width - INNER - OUTER; // the text block's width: 96 mm
const geometry = { // left is the inner margin on a recto; mirror swaps it on the versos
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, // 150 dpi is for the screen
  backgroundColor: col('paper'),
  margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - (LINES * LEAD * 25.4) / 72),
    left: mm(INNER), right: mm(OUTER), mirror: true },
};

Amb mirror: true, el marge right és l'exterior a la pàgina senar i passa a l'esquerra a la parella, així que OUTER és sempre el del tall davanter, on pengen les pestanyes. El marge inferior es calcula a partir del format, del marge superior i de LINES, de manera que la caixa de text té exactament LINES línies de LEAD (aquí, 31 de 14 pt), tingui el format o el marge superior que tingui. Tota pàgina plena acaba a la línia 31, i per això dues pàgines encarades, com la 30 i la 31, acaben a la mateixa altura.

#4 · L'obertura mostra el títol sencer

script.js · línies 99–121al codi complet
const PLATE = 26; // mm: a square plate at the head of the text block
const opener = {
  enabled: true,
  minHeight: mm(58), // the text of every essay starts on the same line
  slot: { elements: [
    { kind: 'box', id: 'plate', style: { backgroundColor: col('sepia') },
      placement: { anchor: { to: 'container', edge: 'top-left' },
        size: { width: mm(PLATE), height: mm(PLATE) } } },
    { kind: 'text', id: 'numeral', content: '{attr.num}', fontFamily: 'Libre Caslon Display',
      fontSize: pt(48), lineHeight: 1, color: col('paper'),
      placement: { anchor: { to: '#plate', edge: 'align-top' }, // the plate's own box, where
        size: { width: mm(PLATE), height: mm(PLATE) } } }, // the text centres by default
    { kind: 'text', id: 'book', content: '{subtitle}', fontFamily: 'Alegreya SC',
      fontSize: pt(8.5), letterSpacing: pt(1.4), color: col('sepia'), align: 'left',
      placement: { anchor: { to: 'container', edge: 'top-left' },
        offset: { x: mm(PLATE + 4.5), y: mm(PLATE - 2.9) } } }, // its baseline on the plate's foot
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Libre Caslon Display',
      fontSize: pt(20), lineHeight: 1.12, color: col('ink'), align: 'left',
      overflow: 'wrap', // an opener shows the whole title; the running head cuts it
      placement: { anchor: { to: '#plate', edge: 'below' }, offset: { y: mm(6) },
        size: { width: mm(MEASURE) } } },
  ] },
};

L'obertura compon el títol complet amb overflow: 'wrap', partit a cada \\ de la línia del títol. Només una obertura a tota la pàgina respecta aquests salts, i d'aquí ve el span: 'page' del nivell (salts de línia als títols). A la capçalera, {chapterTitle} dona sempre el títol en una sola línia, i els punts suspensius tallen aquesta línia. El número romà surt de l'atribut {num="IV"} del títol, i les versaletes al costat de la placa, del subtitle del frontmatter.

#5 · Cada assaig obre en pàgina senar

script.js · línies 139–147al codi complet
  headings: { // 400, the face's only weight: the default 700 would ask for one that is missing
    fontFamily: 'Libre Caslon Display', fontWeight: 400, color: col('ink'),
    levels: [
      // 'odd' puts every opener on a recto, adding a blank verso when one is needed;
      // span: 'page' makes the design an opener, where a \\ in the title breaks the line.
      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
        marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener },
    ],
  },

Amb 'odd', un assaig que acaba en senar va seguit d'una pàgina parella en blanc. Aquí el capítol IV acaba en una senar, de manera que la 32 queda en blanc i el V obre a la 33. El pages: 'body' de les capçaleres les deixa fora de les pàgines en blanc i de les obertures (les pàgines que comencen amb aquest títol). El pages: 'opener' del peu imprimeix el foli només a les obertures (elements de text).

#6 · Els folis comencen pel 29

script.js · línies 251–255al codi complet
// 28 pages come before this one, so recto and verso, the mirrored margins and the odd/even
// heads follow the book page (gotcha: parity-page1-recto); the folios start at 29.
const continuation = { pageIndexOffset: 28, pageNumbering: { startAt: 29 } };
const doc = await buildDocumentWithFonts({ markdown, continuation }, config(), kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Running heads by parity', es: 'Cabeceras según la paridad' }) });

parity es calcula a partir del lloc que ocupa la pàgina al llibre, i el foli no hi intervé. pageIndexOffset: 28 suma 28 a l'índex de cada pàgina, així que les senars i les parelles, els marges en mirall i les capçaleres de cada costat segueixen la pàgina del llibre. Després, pageNumbering.startAt numera aquestes pàgines del 29 al 33. Sense aquest desplaçament, la primera pàgina composta és senar, sigui quin sigui el seu foli. Amb el foli 29 coincideix per casualitat, però amb startAt: 30 el títol del llibre cauria a la 31 i el de l'assaig a la 32, cadascun al costat equivocat de la doble pàgina.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 005 · Running heads by parity ═══════════════════════════════
// https://postext.dev/en/cookbook/running-heads-by-parity
// Code: MIT · Text: Montaigne, tr. Cotton (PD, Gutenberg #3600); es: new translation (MIT)
// Fonts: Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// Pages 29 to 33 of a pocket Montaigne. Versos carry the book's title and rectos the essay's,
// the folios sit in tabs in the outer margin, and an opener prints only a folio at the foot.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'running-heads-by-parity';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: four colours with semantic ids; main-color points at the sepia
const palette = {
  ink: '#1f1b16', // text: a warm near-black, never #000
  sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
  muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
  paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
  // Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
  // pointed at the sepia, none of them prints in the engine's blue.
  { id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];
// #endregion
const LEAD = 14; // pt: the body leading, the pitch of the baseline grid

// #region tab: the folio tab and its divider, the two pieces every head is built from
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
  kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
  fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
  box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
    padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
  placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
  kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
  color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
    size: { height: pt(TAB_H) } },
});

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

#Posa un titolet curt als títols llargs

Escriu la capçalera curta a la línia del títol, {num="IV" short="Los objetos falsos"}, i imprimeix l'atribut en lloc del títol sencer; un capítol sense short no hi imprimeix res.

-  { kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
+  { kind: 'text', id: 'essay', content: '{attr.short}', parity: 'odd', pages: 'body',

#Deixa que els assajos obrin a qualsevol pàgina

Amb 'any', cada assaig comença a la pàgina següent, parella o senar, i mai no s'hi afegeix una pàgina en blanc. La placa penja de la cantonada superior esquerra de la caixa de text i el foli del peu va centrat a sota, així que tots dos queden igual en parella que en senar.

-      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+      { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },

#Pinta de sèpia la pàgina en blanc

Un element box amb pages: 'blank' només s'imprimeix a les pàgines que afegeix el salt a senar: en aquesta edició omple de sèpia la pàgina 32, i l'edició anglesa, que no té pàgina en blanc, no canvia.

 const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
-  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };
+  anchor: { to: 'container', edge: 'bottom' }, y: -HEAD }),
+  { kind: 'box', id: 'blank-leaf', pages: 'blank', style: { backgroundColor: col('sepia') },
+    placement: { anchor: page('top-left'),
+      size: { width: mm(TRIM.width), height: mm(TRIM.height) } } }] };

Errors freqüents

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 →

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

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 →

Avís de maquetació · designTextTruncated

Text de disseny retallat

Per què. Un element de text d'un disseny (una capçalera, un foli, una obertura de capítol, una pàgina de part, una fila de part de l'índex) era més ample que el seu espai i va perdre part d'una línia: es va tallar amb punts suspensius, com demana el seu overflow, o es va retallar amb tinta fora de la caixa amb overflow: 'clip'. Les capçaleres, els folis i les files de part de l'índex acaben en punts suspensius per defecte; els dissenys de títol i de part passen de línia tret que l'element digui una altra cosa. Una capçalera retallada a totes les pàgines d'un capítol s'avisa una sola vegada.

Solució. Posa overflow: 'wrap' a l'element per repartir el text en més línies, dona-li més espai (un size.width o maxWidth més gran, un fontSize més petit, un letterSpacing més estret) o escurça el text. Deixa els punts suspensius on el disseny és una sola línia, com en una capçalera; l'avís només confirma aleshores el que s'ha tallat. Documentació →

Comprovació del Sandbox · headerFooterUnknownPlaceholder

Marcador desconegut

Per què. Un text de disseny fa servir un marcador {nom} que no existeix, de manera que s'imprimeix tal qual.

Solució. Fes servir un marcador admès ({pageNumber}, {chapterTitle}, {title}, {attr.x}…), o escriu {{ i }} per a claus literals. Documentació →

Comprovació del Sandbox · headerFooterMetadataMissing

Falta la metadada del marcador

Per què. Un marcador com {author} o {title} no té valor a les metadades del document, de manera que s'imprimeix buit.

Solució. Afegeix el valor al frontmatter, entre cometes, o treu el marcador. Documentació →

  • CAP està fixat a cada edició per al títol de l'assaig IV, l'únic que mostra aquí una capçalera. Els punts suspensius van darrere de l'última paraula sencera que hi cap, i aquesta paraula pot ser una preposició: amb 64 mm aquesta capçalera acabaria en «…sus pasiones sobre…». Un llibre de títols llargs necessita la capçalera curta de les variants.
  • A l'edició anglesa, pujar minWordSpacing de 0,7 a 0,75 deixa la primera línia de l'assaig V («Quintus Marcius, the Roman legate…») sense cap tall dins de la forquilla, i els seus espais entre paraules s'obren fins a 2,4 vegades la seva amplada normal. A l'espanyola no passa. Després de qualsevol canvi, revisa les línies més obertes que llista la captura.

Crèdits

Text
Fonts
Baskervville (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1)
Sandbox