En poques paraules
Un llibre breu sobre com començar un capítol, on cada capítol arrenca amb un estil diferent. Ensenya a donar a un capítol el seu color, els seus marges i la seva maquetació amb un sol paràmetre.
Què compondràs
Cinc maneres de començar és un llibre de set pàgines sobre obertures de capítol, de 180 × 240 mm, i cada capítol va compost amb l'obertura que descriu. El primer és de novel·la: avantítol espaiat, títol en cursiva fina i caplletra vermella de cinc línies, amb capçaleres a les pàgines següents. El segon tanca el títol i un floró en una cartel·la crema de dos filets blaus. El tercer apila el títol en Fraunces Black blanca sobre un camp magenta a sang, damunt d'una inicial monoespaiada calada en una caixa. El quart, el del manual, porta capçaleres en monoespaiada, una insígnia taronja amb el número al costat del títol i dues columnes de Geist. La coda baixa el títol a mitja pàgina, sobre una inicial elevada. El capítol u fa servir l'obertura pròpia del nivell 1; els altres quatre indiquen un estil a la línia del seu títol.
Aquesta recepta respon a
- Com dono a cada capítol la seva pròpia foto, el seu color o una variant d'obertura?
- Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?
- Com poso el títol de capítol a tota l'amplada mentre el text continua a dues columnes a sota?
- Com faig una insígnia amb el número al costat del títol que s'eixampli quan el número creix (9 → 10)?
La resposta curta
// A heading line picks a style by id, and its attributes feed the opener's {attr.…} texts:
// # The Frame {style="framed" kicker="Chapter the Second"}
// A style overrides the level fields it names (opener, drop cap) and, until the next level-1
// heading, the section fields it names; the rest comes from the level and the document.
const level1 = () => ({ level: 1,
// span 'page' opens each chapter at the head of a new page and runs its opener across
// every column (chapter four has two). By default an H1 waits for a recto, with a blank
// page before it; parity 'any' lets these short chapters open on either side.
span: 'page',
breakBefore: { enabled: true, parity: 'any' },
marginBottom: pt(0), // each opener ends where its first paragraph starts
advancedDesign: literary, // chapter one, unstyled: the book's own opener
dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
gap: mm(2.5) } }); // a five-line drop in rubric red
const headingStyles = () => [ // factories, called by config() once every design exists
// Each style brings its opener and swaps 'accent' for a colour of its own, on its pages.
{ id: 'framed', advancedDesign: framed, palette: { accent: palette.lapis },
margins: { left: mm(EVEN), right: mm(EVEN) }, // a centred text block; 'accent' is blue:
dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 600, color: col('accent'),
gap: mm(2) } },
{ id: 'stacked', advancedDesign: stacked, palette: { accent: palette.magenta }, // white, on
dropCap: { lines: BOXED, fontFamily: 'Geist Mono', fontWeight: 700, color: col('paper'),
gap: mm(2.2) } }, // the square the opener draws for it
{ id: 'spec', advancedDesign: spec, palette: { accent: palette.signal }, dropCap: false,
marginBottom: pt(0), // the hairline under the title is the separator
margins: { left: mm(SPEC), right: mm(SPEC) }, // a 144 mm text block
layout: { layoutType: 'double', gutterWidth: mm(7) },
bodyStyle: { fontFamily: 'Geist', fontSize: pt(9.8), textAlign: 'left' }, // on the grid
header: { elements: [...specHead('even'), ...specHead('odd')] },
footer: { elements: [] } }, // no folio at the foot: the head gives the page
{ id: 'quiet', numbered: false, // a coda: it advances no chapter counter
advancedDesign: quiet, palette: { accent: palette.graphite }, footer: tinyFolio,
dropCap: { lines: 1, fontFamily: 'Fraunces', fontWeight: 300, fontSize: pt(46), // raised:
color: col('accent'), gap: mm(1.2) }, // on the first baseline, rising into the white
margins: { left: mm(QUIET.inner), right: mm(QUIET.outer) }, // a 106 mm measure
bodyStyle: { fontSize: pt(QUIET.size), lineHeight: pt(QUIET.lead), textAlign: 'left' } },
]; // hook-up in config(): headings: { levels: [level1(), …] }, headingStyles()
Ingredients
- Funcions
- Estils de títolGeometria per seccióCaplletres en paràgrafs de textCapçaleres per seccióObertures dissenyadesColors per partCapítols sense númeroBanda de capítol d'amplada completaTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaAtributs de títolBandes a sang i pestanyesSalts de línia als títolsAncoratge d'elements de dissenyCapçaleres i folisCapçaleres segons el tipus de pàginaPaleta de color semànticaTítols numeratsEstils de paràgrafFigures i taules com a recursos
- També fa servir
- Espai vertical explícit
- Tipografia
- Lora, Fraunces, Geist, Geist Mono (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Posa al nivell l'obertura pròpia del llibre
// The first paragraph, in :::paragraphs{style="lead"}, starts 17 mm under the title.
const literary = design([
text('kicker', '{attr.kicker}', 'Geist', 8, centred(22), { ...caps(1.7), align: 'center' }),
text('title', '{titleText}', 'Fraunces', 32, at('#kicker', 'below', 0, 4, 'fill'),
{ fontWeight: 300, italic: true, lineHeight: 1.05, align: 'center' }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.8), color: col('accent'),
placement: at('#title', 'below', (MEASURE - 18) / 2, 6, 18) }, // an 18 mm rule, centred
room('#title', 17),
]);
El capítol u no porta estil, així que pren el disseny del nivell 1, del qual parteix cada estil (la resposta curta mostra el nivell i els estils). El primer paràgraf del capítol és al Markdown, dins d'un grup :::paragraphs{style="lead"} un cos més gran que el text (12/17 punts enfront dels 10,8/14,5), i el dropCap del nivell l'obre (caplletres): la M es recolza a la cinquena línia de base i, sense fontSize, la seva part alta queda enrasada amb les majúscules de la primera línia, i totes dues alçades de majúscula es mesuren a Fraunces i Lora. L'obertura acaba amb una caixa buida, room(), 17 mm sota el títol, on comença l'entradeta; un :::space sota l'entradeta deixa una línia i fa començar el text arran.
#2 · Emmarca el títol amb dues caixes
const FRAME = 62; // mm: the outer box's height
const INSET = 3; // mm: the hairline box runs this far inside it
const FLEURON = 44; // mm: the ornament's width, centred under the title
const framed = design([ // array order is paint order: the boxes first, the type on top
{ kind: 'box', id: 'frame', placement: { ...at('container', 'top-left', 0, 0),
size: { width: 'fill', height: mm(FRAME) } },
style: { backgroundColor: col('tint'), borderColor: col('accent'), borderWidth: pt(1.6) } },
{ kind: 'box', id: 'hairline', placement: { ...at('#frame', 'align-top', INSET, INSET),
size: { width: mm(MEASURE - 2 * INSET), height: mm(FRAME - 2 * INSET) } },
style: { borderColor: col('accent'), borderWidth: pt(0.5) } },
text('kicker', '{attr.kicker}', 'Geist', 7.5, centred(14), { ...caps(1.6), align: 'center' }),
text('title', '{titleText}', 'Fraunces', 34, at('#kicker', 'below', 0, 3.5, 'fill'),
{ fontWeight: 600, lineHeight: 1.05, align: 'center' }),
// An image element draws a registered resource, never numbered or captioned. Its resourceId
// may be '{attr.photo}' (postext ≥ 1.8): then each heading names its own photo.
{ kind: 'image', id: 'fleuron', resourceId: 'fleuron',
placement: at('#title', 'below', (MEASURE - FLEURON) / 2, 4.5, FLEURON) },
room('#frame', 9), // the text starts 9 mm under the frame
]);
L'ordre de l'array és l'ordre de pintat: primer les caixes i al damunt el text; el floró és un element d'imatge, que dibuixa un recurs SVG registrat que no es numera ni se cita mai. Un element d'imatge també serveix per donar a cada capítol la seva pròpia foto: des de postext 1.8 el seu resourceId admet marcadors, així que amb resourceId: '{attr.foto}' un mateix estil dibuixa la foto que indica cada títol, # El marco {style="framed" foto="lago"}, com les receptes de la fitxa de cuina (elements d'imatge). L'estil framed de la resposta curta fa servir palette per tornar blau accent a les pàgines d'aquest capítol, de manera que els filets, l'avantítol i el foli surten en blau, i els seus margins centren la caixa de text sota el marc. El dropCap del mateix estil porta col('accent'), que la paleta també torna blau, i així la L de tres línies fa joc amb el marc.
#3 · Apila el títol i posa la inicial en una caixa
const FIELD = 130; // mm from the trim: the foot of the colour field
const S_BEARING = 1.2; // mm: the white left of the title's S (0.0365 em at 94 pt)
// The boxed initial: the style's drop cap sets the white letter; the opener draws the square,
// fitted by hand in pt. The text starts on the grid line 8 mm under the field (from the trim).
const TEXT_TOP = Math.ceil(((FIELD - TOP + 8) * 72) / 25.4 / LEAD) * LEAD; // pt
const BASE = 0.8; // a line's baseline stands 0.8 down its line box
const CAPS = 0.7; // the height of a capital in Lora, em
// Geist Mono, em: cap height, the advance every capital shares, the white either side of an M
const MONO = { caps: 0.71, advance: 0.6, side: 0.044 };
const BOXED = 3; // lines the initial spans
const capsTop = TEXT_TOP + BASE * LEADIN.lead - CAPS * LEADIN.size; // the first line's capitals
const foot = TEXT_TOP + (BOXED - 1 + BASE) * LEADIN.lead; // the third baseline: the letter's foot
// The M runs from the first line's capitals to its foot; the square runs past both as far as
// the M's sides sit in, so the colour is as wide on all four sides.
const letter = (foot - capsTop) / MONO.caps, pad = MONO.side * letter;
const stacked = design([
{ kind: 'box', id: 'field', style: { backgroundColor: col('accent') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(FIELD) } } },
text('kicker', '{attr.kicker}', 'Geist', 8, at('container', 'top-left', 0, 4),
{ ...caps(1.8), color: col('paper') }),
// {titleText} keeps the \\ breaks from the Markdown, so each line ends at the writer's \\.
// Moved left by the S's side bearing, so its curve meets the text edge.
text('title', '{titleText}', 'Fraunces', 94,
at('container', 'top-left', -S_BEARING, 15, 'fill'),
{ fontWeight: 900, lineHeight: 0.84, color: col('paper') }),
{ kind: 'box', id: 'initial', style: { backgroundColor: col('accent') }, reserve: false,
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: pt(capsTop - pad) },
size: { width: pt(MONO.advance * letter), height: pt(foot - capsTop + 2 * pad) } } },
room('container', (TEXT_TOP * 25.4) / 72, 'top-left'), // the opener ends where the text starts
]);
Els talls del títol s'escriuen al Markdown: # Salta \\ a la \\ vista. parteix {titleText} a cada \\, mentre que les capçaleres i els marcadors del PDF llegeixen el títol en una sola línia (salts de línia en els títols). El camp penja de la vora superior de la zona de sang, a tota l'amplada i amb 130 mm d'alçada, i l'entradeta comença a la primera línia de la retícula, 8 mm per sota (TEXT_TOP). La inicial en caixa es fa amb dues peces. El dropCap de l'estil compon la M en blanc sobre tres línies de l'entradeta, i l'obertura pinta a sota una caixa magenta, situada a partir de TEXT_TOP, de l'interlineat de l'entradeta i de les mides de Geist Mono, de manera que el color que queda a sobre i a sota de la M mesura el mateix que el seu blanc lateral. La caixa no ocupa lloc a l'obertura (reserve: false); una caixa room buida acaba l'obertura on comença l'entradeta.
#4 · Dona al manual la seva insígnia, dues columnes i les seves capçaleres
const SPEC = 18; // mm: both side margins, for a 144 mm text block in two columns
const PAD = 1.6; // mm of colour over the badge's figures
const spec = design([
{ kind: 'rule', id: 'top-rule', direction: 'horizontal', thickness: pt(2.4), color: col('ink'),
placement: at('container', 'top-left', 0, 0, 'fill') },
text('kicker', '{attr.kicker}', 'Geist Mono', 7.5, at('container', 'top-left', 0, 3.2),
{ ...caps(1.2, 500), color: col('graphite') }),
// The badge's width follows its text, with padding on both sides, so 9 → 10 widens it. Its
// line box holds 1 mm more under the figures than over them, so the foot pads 1 mm less.
text('badge', '{chapterNumber}', 'Geist Mono', 26, at('container', 'top-left', 0, 12),
{ fontWeight: 700, lineHeight: 1, box: { backgroundColor: col('accent'), padding: {
top: mm(PAD), right: mm(2.4), bottom: mm(PAD - 1), left: mm(2.4) } } }),
// Same size and line height as the badge, dropped by its top padding, so the baselines meet.
text('title', '{titleText}', 'Geist', 26, at('#badge', 'right-of', 4, PAD),
{ fontWeight: 700, lineHeight: 1 }),
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.5), color: col('ink'),
placement: at('container', 'top-left', 0, 31, 'fill') }, // room for a one-line title
]);
const specHead = (parity) => { // mono labels over the opener's rule, on every page of the section
const [edge, s] = parity === 'even' ? ['top-left', 1] : ['top-right', -1];
const mono = { ...caps(1.1, 500), color: col('graphite'), parity, pages: 'all' };
return [
text(`sp-page-${parity}`, '{pageNumber} / {totalPages}', 'Geist Mono', 7,
at('container', edge, 0, HEAD_Y), mono),
text(`sp-chap-${parity}`, '§ {chapterNumber} · {chapterTitle}', 'Geist Mono', 7,
at('container', edge, s * 16, HEAD_Y), mono),
];
};
La insígnia és un element de text amb fons i farciment interior però sense amplada, així que la seva amplada segueix la de {chapterNumber}, i el títol es col·loca a la seva dreta amb right-of: al capítol 10 la insígnia creix una xifra, 5,5 mm, i el títol es desplaça amb ella. El seu farciment inferior és 1 mm menor que el superior perquè la caixa de línia deixa aquest mil·límetre de més sota les xifres, i així el 4 queda centrat. A l'estil spec, layout passa la secció a dues columnes i el span: 'page' del nivell estén l'obertura sobre totes dues. Els seus margins eixamplen la caixa de text a 144 mm, bodyStyle compon Geist en bandera sobre la retícula de base de 14,5 punts del llibre, header substitueix les capçaleres del llibre i un footer buit treu el foli.
#5 · Deixa aire a la coda
const quiet = design([ // the kicker is in the accent, which this style turns graphite
text('kicker', '{attr.kicker}', 'Geist', 7.5, at('container', 'top-left', 0, 92),
caps(1.6, 500)),
text('title', '{titleText}', 'Fraunces', 26, at('#kicker', 'below', 0, 3),
{ fontWeight: 300, lineHeight: 1.1 }),
room('#title', 3), // and the initial's rise, in whole lines: the text 16 mm under the title
]);
const tiny = (parity, edge) => text(`tiny-${parity}`, '{pageNumber}', 'Geist', 6.5,
at('container', edge, 0, -12), { fontWeight: 500, color: col('muted'), parity });
const tinyFolio = { elements: [tiny('even', 'bottom-left'), tiny('odd', 'bottom-right')] };
L'avantítol penja 92 mm per sota del començament de la caixa de text, i la inicial elevada és la caplletra d'una sola línia de l'estil quiet: el seu peu es recolza a la primera línia de base i, amb 46 punts, sobresurt cap al blanc de dalt en lloc d'enfonsar-se al paràgraf. El paràgraf li reserva aquest espai per sobre en línies senceres, així que el room de l'obertura sota el títol només fa 3 mm. A l'estil quiet, margins estrenyen la mesura a 106 mm, bodyStyle compon el text en bandera a 12,5/17,5 punts, footer canvia el foli de l'obertura per un de petit a la cantonada exterior del peu i palette torna gris l'avantítol. En aquesta pàgina no s'imprimeix cap número de capítol, així que numbered: false només es notaria en un capítol afegit després de la coda, que continuaria sent el cinquè.
La recepta completa
// ═══ Postext Cookbook · Nº 017 · Five chapter openers in one book ═════════════════
// https://postext.dev/en/cookbook/five-chapter-openers
// Code: MIT · Text: original (CC BY 4.0) · Ornament: generated in code (CC BY 4.0)
// Fonts: Lora, Fraunces, Geist, Geist Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A small book about openers, each chapter set in the one it describes. Every heading style
// brings its opener and palette; three move the margins, two bring their own type and folios.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'five-chapter-openers';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region answer: one opener per chapter: the level's own, then heading styles by name
// A heading line picks a style by id, and its attributes feed the opener's {attr.…} texts:
// # The Frame {style="framed" kicker="Chapter the Second"}
// A style overrides the level fields it names (opener, drop cap) and, until the next level-1
// heading, the section fields it names; the rest comes from the level and the document.
const level1 = () => ({ level: 1,
// span 'page' opens each chapter at the head of a new page and runs its opener across
// every column (chapter four has two). By default an H1 waits for a recto, with a blank
// page before it; parity 'any' lets these short chapters open on either side.
span: 'page',
breakBefore: { enabled: true, parity: 'any' },
marginBottom: pt(0), // each opener ends where its first paragraph starts
advancedDesign: literary, // chapter one, unstyled: the book's own opener
dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
gap: mm(2.5) } }); // a five-line drop in rubric red
const headingStyles = () => [ // factories, called by config() once every design exists
// Each style brings its opener and swaps 'accent' for a colour of its own, on its pages.
{ id: 'framed', advancedDesign: framed, palette: { accent: palette.lapis },
margins: { left: mm(EVEN), right: mm(EVEN) }, // a centred text block; 'accent' is blue:
dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 600, color: col('accent'),
gap: mm(2) } },
{ id: 'stacked', advancedDesign: stacked, palette: { accent: palette.magenta }, // white, on
dropCap: { lines: BOXED, fontFamily: 'Geist Mono', fontWeight: 700, color: col('paper'),
gap: mm(2.2) } }, // the square the opener draws for it
{ id: 'spec', advancedDesign: spec, palette: { accent: palette.signal }, dropCap: false,
marginBottom: pt(0), // the hairline under the title is the separator
margins: { left: mm(SPEC), right: mm(SPEC) }, // a 144 mm text block
layout: { layoutType: 'double', gutterWidth: mm(7) },
bodyStyle: { fontFamily: 'Geist', fontSize: pt(9.8), textAlign: 'left' }, // on the grid
header: { elements: [...specHead('even'), ...specHead('odd')] },
footer: { elements: [] } }, // no folio at the foot: the head gives the page
{ id: 'quiet', numbered: false, // a coda: it advances no chapter counter
advancedDesign: quiet, palette: { accent: palette.graphite }, footer: tinyFolio,
dropCap: { lines: 1, fontFamily: 'Fraunces', fontWeight: 300, fontSize: pt(46), // raised:
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
#Obre cada capítol en pàgina senar
Amb 'odd', tots els capítols comencen en pàgina senar i del segon al cinquè porten al davant una parella en blanc, així que el llibre passa de 7 a 11 pàgines.
- breakBefore: { enabled: true, parity: 'any' },
+ breakBefore: { enabled: true, parity: 'odd' },#Deixa la caplletra en tres línies
Sense fontSize, el cos segueix el nombre de línies, així que una caplletra de tres línies també queda enrasada amb les majúscules de la primera.
- dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
+ dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),#Versaletes després de la inicial
leadIn compon en versaletes les primeres paraules després de la lletra, com fan moltes novel·les; words: 'line' hi inclou tota la primera línia.
- gap: mm(2.5) } });
+ gap: mm(2.5), leadIn: { words: 'line' } } });Errors freqüents
Error freqüent
Valors d'atribut: sense { ni }; cometes simples si porten "
Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →
- Les entradetes es componen en bandera, com a l'obertura d'una revista; una entradeta justificada al costat d'una inicial de cinc línies pot obrir molt els espais en una línia de poques paraules.
- La caixa magenta està ajustada a mà a Lora 12/17, a la M de Geist Mono i a la línia de base de la línia, a 0,8 de la seva caixa de línia (
BASE). Si canvies la font, el cos o l'interlineat de l'entradeta, la lletra inicial, el nombre de línies o l'alçada del camp, torna a comprovar la caixa contra les majúscules de la primera línia. - Els títols no es giren mai ni van en vertical: el text de disseny és sempre horitzontal. Apila les paraules amb
\\, com fa el capítol tres.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Lora (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Geist (SIL OFL 1.1) · Geist Mono (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)


