En poques paraules
Els dos primers capítols d'una novel·la nord-americana en una edició en rústica. Cada capítol comença en una pàgina de la dreta, més avall, sota un número gran.
Què compondràs
Els dos primers capítols de The Awakening (1899), de Kate Chopin, ocupen vuit pàgines de rústica de 140 × 216 mm. La coberta, una pintura generada amb models de difusió i carregada com a JPEG, mostra el golf des de Grand Isle: un lugre a l'horitzó entre els roures i l'ombrel·la blanca que puja entre la camamilla. El colofó va al peu del seu dors. Cada capítol comença en pàgina senar, amb el text a 81 mm de la vora superior, sota un número romà en cursiva de 48 pt, un filet vermell òxid de 18 mm i la primera frase en versaletes, partida en dues línies centrades. El capítol I acaba a la 5 amb un floró de camamilla, de manera que la 6 queda en blanc, sense capçalera ni foli, i el II comença a la 7. Les capçaleres porten el nom de l'autora a les parelles i el títol en cursiva a les senars.
Aquesta recepta respon a
- Com forço un salt de pàgina o de columna, i faig que cada capítol comenci en pàgina senar?
- Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?
- Com insereixo pàgines en blanc expressament, o començo una secció en una doble pàgina nova?
- 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 faig una coberta, una portadella, una portada i un colofó?
- Com afegeixo espai vertical entre dos blocs, si les línies en blanc no fan res?
- Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?
La resposta curta
// # I {lead="A green and yellow parrot, … kept repeating over and over:"}
// The heading's text is the numeral, printed by {titleText}; the chapter's first sentence
// travels as the heading's lead attribute, printed by {attr.lead} in small capitals: a
// centred display, which a \n in the attribute breaks by sense.
const [LEAD_AT, BODY_AT] = [9, 12]; // grid lines: the lead's top; where the text starts
const NUMERAL = 48; // pt
const RULE_Y = (LEAD_AT - 1.5) * LEAD * MM_PER_PT; // mm: a line and a half above the lead
const NUMERAL_Y = RULE_Y - NUMERAL * MM_PER_PT - 3; // mm: the numeral's box ends 3 mm above it
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y } });
const opener = {
enabled: true,
// The two-line lead ends on line LEAD_AT + 2; minHeight leaves a blank line under it and
// starts the text on line BODY_AT (a one-line lead would leave two).
minHeight: line(BODY_AT),
slot: { elements: [
{ kind: 'text', id: 'numeral', content: '{titleText}', fontFamily: DISPLAY, italic: true,
fontWeight: 500, fontSize: pt(NUMERAL), lineHeight: 1, color: col('ink'),
align: 'center', placement: centred(mm(NUMERAL_Y)) },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.6),
color: col('rubric'), placement: { ...centred(mm(RULE_Y)), size: { width: mm(18) } } },
{ kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9.5), letterSpacing: pt(0.6), color: col('ink'), align: 'center',
lineHeight: LEAD / 9.5, // one grid line to each line of the lead
placement: { ...centred(line(LEAD_AT)), size: { width: mm(MEASURE) } } },
] },
};
// Every chapter opens on a recto: 'odd' adds a blank verso only after a chapter that ends on
// a recto, where the default 'always-odd' leaves a blank page after every chapter.
// marginBottom 0: the level's default 0.5 em would start the text a line lower.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
marginBottom: pt(0), italic: true, advancedDesign: opener };
Ingredients
- Funcions
- Obertures dissenyadesCapítols que obren en pàgina senarCapçaleres per seccióMarges simètricsEstils de títolCobertes, portades i colofonsAtributs de títolTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaGeometria per seccióCapçaleres segons el tipus de pàginaCapçaleres i folisMetadades del documentEstils de paràgrafEspai vertical explícitFigures i taules com a recursosTipus de recurs propisFigures just aquíColor del paperVídues, òrfenes i línies curtes
- Tipografia
- Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- Recursos
cover-1190.jpgcover-it-1190.jpg- The cover’s view of the gulf, a painting (Generated With Diffusion Models, original)
- The Italian edition’s cover: a detail of Settignano (c. 1880), oil on canvas; scan from Wikimedia Commons, a 1,744 × 1,669 px cut reduced to 1,190 px wide (Telemaco Signorini, domini públic)
- The camomile tailpiece, drawn in code in the page’s palette (Ignacio Ferro, MIT)
Elaboració
#1 · L'obertura surt del títol i del seu atribut
El codi és la resposta curta de més amunt. Els capítols de Chopin només porten número, així que el títol de cadascun en Markdown és aquest número (# I), i {titleText} l'imprimeix. {attr.lead} imprimeix l'atribut lead del títol, que conté la primera frase del capítol; el paràgraf de Markdown que va a sota comença per la frase següent (atributs d'encapçalament). La primera frase va centrada, i el \n de cada atribut la talla pel sentit, després de cage i després de bright;. La frase comença nou línies de la retícula per sota de la vora superior de la caixa de text, i un minHeight de 12 línies deixa una línia en blanc a sota; sense minHeight, el text arrenca enganxat a la frase (extensió i disseny avançat). marginBottom: pt(0) substitueix el marge de mig cos que el nivell porta per defecte i que baixaria el text una línia.
breakBefore amb paritat 'odd' porta cada capítol a una pàgina senar, amb una parella en blanc només després d'un capítol que acaba en senar (salt de pàgina previ). Per forçar una pàgina senar on no hi ha títol, escriu :::pagebreak{parity="odd"} al Markdown; en una maquetació de dues o més columnes, :::columnbreak passa el text a la columna següent (:::pagebreak).
#2 · Una pàgina de rústica amb línies senceres
const TRIM = { width: 140, height: 216 }; // mm: 5½ × 8½ in
const [TOP, INNER, OUTER] = [22, 20, 15.5]; // mm; mirrored, so INNER is left on a recto
const LINES = 35; // every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 104.5 mm: about 69 characters of Crimson Pro
const MM_PER_PT = 25.4 / 72;
const page = {
sizePreset: 'custom', width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LEAD * MM_PER_PT),
left: mm(INNER), right: mm(OUTER), mirror: true },
};
El marge inferior és el que queda dels 216 mm d'alçada després del marge superior i 35 línies de 14 pt, així que totes les pàgines plenes acaben a la mateixa línia, com la 3 i la 4. Amb mirror: true, el marge interior de 20 mm queda al costat del llom tant a les senars com a les parelles (marges simètrics). La mesura de 104,5 mm admet uns 69 caràcters de Crimson Pro de 10,5 pt. El text de cos admet espais entre paraules de 0,7 a 1,9 vegades el normal; amb el mínim per defecte, 0,6, una línia d'aquestes pàgines es tanca fins a 0,62.
#3 · Capçaleres que se salten les obertures i les pàgines en blanc
// {author} and {title} come from the frontmatter.
const HEAD_Y = 12; // mm from the top edge to the top of the running heads
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
const head = (id, content, parity, edge, x, style) => ({
kind: 'text', id, content, parity, pages: 'body', // never on openers or blank pages
fontSize: pt(9), color: col('muted'), ...style,
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD_Y) } },
});
const smallCaps = { fontFamily: LABEL, fontWeight: 600, letterSpacing: pt(1.2) };
const italic = { fontFamily: DISPLAY, italic: true, fontWeight: 500, fontSize: pt(9.75) };
const folio = { fontFamily: TEXT, color: col('ink') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-author', '{author}', 'even', 'top', -SHIFT, smallCaps),
head('recto-title', '{title}', 'odd', 'top', SHIFT, italic),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
// Openers carry a drop folio instead, centred under the text block.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
pages: 'opener', fontFamily: TEXT, fontSize: pt(9), color: col('muted'), align: 'center',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(7) } } }] };
parity: 'even' posa el nom de l'autora, en versaletes de Cormorant SC, a les pàgines parelles, i 'odd', el títol en cursiva a les senars; els folis van a la vora exterior de la caixa de text. pages: 'body' aparta els quatre elements de les obertures i de la pàgina 6, la parella en blanc que afegeix el salt amb paritat. Amb pages: 'all', aquesta pàgina imprimiria 6 i Kate Chopin. Les obertures porten en lloc seu un foli al peu, un element del footer que pages: 'opener' reserva per a elles (elements de text).
#4 · La coberta és una secció sense capçaleres
// Page 1 is a recto (gotcha: parity-page1-recto): the cover, the colophon on its verso, and
// chapter I on page 3. # The Awakening {style="cover"} opens the section; chapter I closes it.
// The colophon: 2 + 2 + 1 lines of 11 pt and two gaps of 14.5 pt make 84 pt, six grid lines.
const COLOPHON_LINES = 6;
const COLOPHON_TOP = TOP + (LINES - COLOPHON_LINES) * LEAD * MM_PER_PT; // mm: the section's margin
const onPage = (y) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } }); // y mm down
const cover = {
id: 'cover',
header: { elements: [] }, footer: { elements: [] }, // no running heads on p. 1 or p. 2
margins: { top: mm(COLOPHON_TOP) },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'art', resourceId: 'cover',
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill' } } },
{ kind: 'text', id: 'title', content: '{title}', fontFamily: DISPLAY, italic: true,
fontWeight: 500, fontSize: pt(50), lineHeight: 1, color: col('ink'), align: 'center',
placement: onPage(155) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
color: col('rubric'), placement: { ...onPage(179), size: { width: mm(18) } } },
{ kind: 'text', id: 'author', content: '{author}', ...smallCaps, fontSize: pt(12),
letterSpacing: pt(2.4), color: col('rubric'), align: 'center', placement: onPage(184) },
] } },
};
const colophon = { id: 'colophon', fontSize: pt(8), lineHeight: pt(11), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), spaceBetween: pt(14.5) };
La coberta és un títol, # The Awakening {style="cover"}. El seu estil col·loca la pintura als 134 mm superiors, el títol del frontmatter a 50 pt i el nom de l'autora en versaletes. L'estil regeix a més la secció que obre aquest títol, les pàgines 1 i 2, fins al capítol I. El seu header i el seu footer buits treuen el foli al peu de la coberta i les capçaleres del colofó. El seu marge superior col·loca el colofó a les sis últimes línies de la caixa de text, així que l'última línia del colofó queda a l'altura de l'última de la pàgina 3 (estils d'encapçalament). La columna de la secció comença a 165 mm, i el disseny, ancorat a la pàgina i a la sang, es pinta igualment per sobre: un disseny que es queda a la columna només el retalla el peu d'aquesta.

#5 · Un floró tanca cada capítol
// At a chapter's end: :::space, then ::resource{id="tailpiece-1"} (double quotes: gotcha
// resource-double-quotes). The space adds a line to the gap the embed keeps above it.
const ornament = { id: 'ornament', name: 'Ornament', shortLabel: '', captionPrefix: '',
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
defaultPlacement: { position: 'here', width: 0.17, align: 'center' } };
const svg = (id, fileId, width, height, altText) => ({ id, typeId: 'ornament', kind: 'svg',
svg: { fileId, width, height }, altText, createdAt: 0, updatedAt: 0 });
// The cover is a painting, a JPEG in assets/ cut to the art's 140 × 134 mm, declared at its pixels;
// the it edition's is a detail of Signorini's Settignano.
const painting = { id: 'cover', typeId: 'ornament', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: t({ en: 'cover-1190.jpg', it: 'cover-it-1190.jpg' }), format: 'jpeg',
width: 1190, height: 1139 },
altText: t({ en: 'The gulf seen between the trunks of water-oaks, a lugger on the horizon; a '
+ 'white sunshade comes up from the beach through the camomile.',
pt: 'O mar visto entre os troncos de duas árvores, um veleiro no horizonte; uma sombrinha '
+ 'branca sobe da praia por um caminho entre flores amarelas e brancas.',
fr: 'La mer vue entre les troncs de deux arbres, un voilier à l’horizon ; une ombrelle '
+ 'blanche monte de la plage par un chemin entre des fleurs jaunes et blanches.',
de: 'Das Meer zwischen den Stämmen zweier Bäume, ein Segelboot am Horizont; ein weißer '
+ 'Sonnenschirm kommt vom Strand einen Weg zwischen gelben und weißen Blumen herauf.',
it: 'Una strada di Settignano: la bottega del pane e del vino, una donna seduta sulla '
+ 'soglia, un gatto sul selciato al sole.' }) };
const resources = [
painting,
// ::resource places each ornament once, so each chapter end has its own id.
...t({ en: ['I', 'II'], pt: ['I', 'II', 'III'], fr: ['I', 'II'], de: ['I', 'II'], it: ['I', 'II'] })
.map((n, i) => svg(`tailpiece-${i + 1}`, 'fleuron.svg', 40, 12,
t({ en: `A camomile flower between two sprigs closes chapter ${n}.`,
pt: `Uma flor de camomila entre dois ramos fecha o capítulo ${n}.`,
fr: `Une fleur de camomille entre deux brins clôt le chapitre ${n}.`,
de: `Eine Kamillenblüte zwischen zwei Zweigen schließt das Kapitel ${n}.`,
it: `Un fiore di camomilla tra due rametti chiude il capitolo ${n}.` }))),
];
El tipus d'ornament no té prefix de peu, així que la flor de camamilla s'imprimeix sense rètol, amb una amplada del 17 % de la mesura, al lloc de ::resource{id="tailpiece-1"} (tipus de recurs). Una inserció en línia deixa una línia de la retícula per sobre, i el :::space que la precedeix n'afegeix una altra entre l'última línia del capítol i la flor (:::space). Els dos florons fan servir el mateix fitxer, fleuron.svg, amb dos identificadors diferents, perquè cada recurs es col·loca una sola vegada.
La recepta completa
// ═══ Postext Cookbook · Nº 038 · Trade paperback: sunk openers and recto chapters ═══
// https://postext.dev/en/cookbook/trade-paperback-novel
// Code: MIT · Text: Chopin, Machado, Goncourt, Collodi, Keyserling (PD) · Covers: diffusion models, Signorini
// Fonts: Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: 'en' Chopin|'pt' Machado|'fr' Goncourt|'de' Keyserling|'it' Collodi
const RECIPE = 'trade-paperback-novel';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
ink: '#231d18', // the text: a warm near-black
rubric: '#8e3b22', // the one accent: the opener's hairline, the author, the tailpiece
muted: '#6e655b', // running heads, folios on openers, the colophon
paper: '#fbf7ef', // a cream book paper
};
// Each colour names its palette entry and carries its hex.
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' } })),
// The engine's defaults (headings, lists, callouts, captions) link to 'main-color', the rubric.
{ id: 'main-color', name: 'rubric (defaults)', value: { hex: palette.rubric, model: 'hex' } },
];
const TEXT = 'Crimson Pro'; // the text face
const DISPLAY = 'Cormorant Garamond'; // italic numerals and the cover's title
const LABEL = 'Cormorant SC'; // small capitals: the lead, the author's name
const [BODY, LEAD] = [10.5, 14]; // pt: the body size and its leading, the grid's pitch
const line = (n) => pt(n * LEAD); // n grid lines
// #region page: a 140 × 216 mm trade page whose text block holds 35 whole lines
const TRIM = { width: 140, height: 216 }; // mm: 5½ × 8½ in
const [TOP, INNER, OUTER] = [22, 20, 15.5]; // mm; mirrored, so INNER is left on a recto
const LINES = 35; // every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 104.5 mm: about 69 characters of Crimson Pro
const MM_PER_PT = 25.4 / 72;
const page = {
sizePreset: 'custom', width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150,
backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LEAD * MM_PER_PT),
left: mm(INNER), right: mm(OUTER), mirror: true },
};
// #endregion
// #region answer: a sunk opener: the numeral, a hairline, and the first sentence in small caps
// # I {lead="A green and yellow parrot, … kept repeating over and over:"}
// The heading's text is the numeral, printed by {titleText}; the chapter's first sentence
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
#Deixa que el capítol II continuï a la pàgina següent
Amb la paritat 'any', el capítol II comença a la pàgina 6, que és parella, i el llibre acaba a la 7; el foli al peu es centra a la caixa de text, no a la pàgina, així que en aquesta parella continua quedant sota el centre del text.
-const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
+const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },#Marca un canvi d'escena dins d'un capítol
Entre dues línies :::space, la mateixa flor marca un canvi d'escena, i el paràgraf següent comença sense sagnat perquè indentAfterHeading està desactivat. Després de seemed long to him., la flor cau al peu de la pàgina 4; el segon espai ja no hi cap i desapareix. El canvi afegeix quatre línies, que empenyen el floró del capítol I, sol, a la pàgina 6, sota una capçalera, així que hauràs de tornar a ajustar el capítol quan n'hi afegeixis un.
const resources = [
+ svg('break-1', 'fleuron.svg', 40, 12, 'A scene break.'),That was why the morning seemed long to him.
:::space
::resource{id="break-1"}
:::space
“You are burnt beyond recognition,” he added, …Errors freqüents
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 →
Error freqüent
::resource{id="…"} només admet cometes dobles
Una inserció de bloc només es reconeix com a ::resource{id="…"} amb cometes dobles; qualsevol altra forma es queda al text com una línia visible. Figures just aquí →
Comprovació del Sandbox · parityCascade
Cascada de paritat
Per què. Els salts amb paritat s'acumulen i produeixen més de dues pàgines en blanc seguides.
Solució. Revisa els salts always-odd i les paritats de breakBefore; en capítols curts, la paritat any sol evitar aquestes pàgines en blanc. Documentació →
- Amb
'always-odd', darrere de cada secció va una pàgina separadora en blanc abans del farciment de paritat, així que el capítol I passaria a la pàgina 5, després de dues pàgines en blanc, i el llibre arribaria a deu pàgines. - Aquestes pàgines estan ajustades a mà. Amb un marge exterior de 16 mm en lloc de 15,5, la pàgina 7 parteix after-din-ner per un segon guionet i acaba una línia abans, la 8 tanca un paràgraf amb el fragment spondent. i el segon floró passa a una novena pàgina. Revisa el peu de totes les pàgines quan canviïs la mesura, el cos o l'enfonsament.
- Mr. i Mrs. van units al nom amb un espai de no separació (U+00A0). El paràgraf que acaba en seemed long to him. porta un espai corrent, perquè unir-hi el nom obre la seva primera línia fins a 2,2 vegades l'espai normal entre paraules.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The Awakening (1899), chapters I and II · Kate Chopin · domini públic
- Quincas Borba (1891), chapters I to III, the Portuguese edition’s text, in modern spelling · Machado de Assis · domini públic
- Madame Gervaisais (1869), chapters I and II, the French edition’s text, in the first edition’s spelling · Edmond et Jules de Goncourt · domini públic
- Beate und Mareile (Beate and Mareile, 1903), chapters 1 and 2 (the second abridged), the German edition’s text, in the spelling of S. Fischer’s edition · Eduard von Keyserling · domini públic
- Le avventure di Pinocchio (The Adventures of Pinocchio, Felice Paggi, Florence, 1883), chapters I and II, the Italian edition’s text, in the first edition’s spelling, without the chapter summaries · Carlo Collodi · domini públic
- The colophon · Postext Cookbook · original
- Imatges
- The cover’s view of the gulf, a painting · Generated With Diffusion Models · original
- The Italian edition’s cover: a detail of Settignano (c. 1880), oil on canvas; scan from Wikimedia Commons, a 1,744 × 1,669 px cut reduced to 1,190 px wide · Telemaco Signorini · domini públic
- The camomile tailpiece, drawn in code in the page’s palette · Ignacio Ferro · MIT
- Fonts
- Crimson Pro (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant 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)


