Saltar al contingut principal
Recepta número 38

Receptari · Capítol 9 · Publicacions completes

Novel·la en rústica: obertures enfonsades i capítols senars

The Awakening en rústica de 140 × 216 mm: coberta pintada, colofó sense capçaleres i cada capítol enfonsat en pàgina senar sota un número romà en cursiva.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text MIT
  • Mostra en anglès: encara no hi ha edició en català
  • Format 140 × 216 mm
  • 1 columna
  • Crimson Pro 10,5/14
  • Cormorant Garamond
  • Cormorant SC
  • 8 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 74 ms
  • 196 línies de codi

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

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

Tipografia
Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
Recursos
  • cover-1190.jpg
  • cover-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

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

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

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

Pàgina 2: el colofó al peu del dors de la coberta, sense capçalera ni foli.

#5 · Un floró tanca cada capítol

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

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

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)
Sandbox