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
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
- Funcions
- Capçaleres i folisCapçaleres segons el tipus de pàginaAncoratge d'elements de dissenyTextos, filets i caixes als dissenys de pàginaObertures dissenyadesAtributs de títolSalts de línia als títolsCapítols que obren en pàgina senarMarges simètricsFormat de pàginaColor del paperMetadades del documentNegreta, cursiva i els seus colorsPaleta de color semànticaRequadresEstils de paràgrafVídues, òrfenes i línies curtesPàgines en un canvasLlibres construïts capítol a capítol
- També fa servir
- Banda de capítol d'amplada completa
- 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
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
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.


#3 · Marges en mirall i línies senceres
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
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
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
// 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
// ═══ 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ó →
CAPestà 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
minWordSpacingde 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
- Recepta
- Ignacio Ferro
- Text
- Essays, Book I, chapters IV and V, in Charles Cotton’s translation edited by William Carew Hazlitt (1877) · Michel de Montaigne; Charles Cotton; William Carew Hazlitt · domini públic
- Essais, livre I, chapitres IV et V: the 1595 French text in the Général Michaud edition (Firmin-Didot, 1907) · Michel de Montaigne · domini públic
- Spanish translation, with its verse glosses · Postext Cookbook · original
- Fonts
- Baskervville (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Alegreya 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)

