Saltar al contingut principal
Recepta número 66

Receptari · Capítol 3 · Títols i obertures

Capítols de conte amb vinyetes i sumaris

Un sol estil d'encapçalament obre tots els capítols; cada títol indica en atributs la seva vinyeta i el seu sumari en cursiva, que pinta l'obertura.

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 CC BY 4.0

pp. 6–7 · 1–2 de 5

  • Mostra en castellà: encara no hi ha edició en català
  • Format 190 × 240 mm
  • 1 columna
  • Averia Serif Libre 13/19
  • Fredericka the Great
  • Quicksand
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 60 ms
  • 162 línies de codi

En poques paraules

Les primeres pàgines d'una edició infantil italiana de Pinotxo. Cada capítol comença amb una il·lustració pròpia en aquarel·la i un breu resum del que hi passa.

Què compondràs

Les primeres pàgines d'una edició infantil italiana de Le avventure di Pinocchio, de Collodi, compostes en Averia Serif Libre de 13/19 pt, en format de 190 × 240 mm. Davant del capítol I, a la pàgina parella, va una portada il·lustrada: una aquarel·la dels turons toscans, on un carro estirat per un ase porta llenya al taller d'un fuster, per sobre del títol en Fredericka the Great. Cada capítol comença sota una vinyeta en aquarel·la que es fon amb el paper (mestre Ciliegia amb la destral enlaire sobre el tronc que parla al capítol I, Geppetto amb la seva perruca groga rebent el tronc al II) i continua amb la línia del capítol i el sumari de Collodi en cursiva centrada. Les quatre imatges es van generar amb models de difusió a partir d'unes mateixes indicacions d'estil i la paleta de la pàgina. Només porten capçalera les pàgines 8 i 9, totes dues sense obertura. Els folis van en discos color fusta, i el capítol I acaba amb dues cireres sense peu ni número.

Aquesta recepta respon a

  • Com dono a cada capítol la seva pròpia foto, el seu color o una variant d'obertura?
  • Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?
  • Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?
  • 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?

La resposta curta

script.js · línies 44–64al codi complet
// # Capitolo I {style="capitolo" vignetta="ceppo" summary="Come andò che Maestro Ciliegia…"}
// resourceId takes placeholders like a design text: '{attr.vignetta}' draws the resource the
// heading names, so every chapter shares one style.
const VIGNETTE = { width: 84, height: 56 }; // mm, centred at the head of the text block
const SUMMARY = 124; // mm: the summary's measure, narrower than the text's
const opener = { enabled: true,
  // A floor for the height the opener reserves, in whole lines, so the text under chapter I's
  // two-line summary starts on the same grid line as the text under chapter II's three lines.
  minHeight: pt(14 * LEAD),
  slot: { elements: [
    { kind: 'image', id: 'vignette', resourceId: '{attr.vignetta}',
      placement: at('container', 'top', 0, 0,
        { width: mm(VIGNETTE.width), height: mm(VIGNETTE.height) }) },
    // The chapter line 6 mm under the picture's foot, the summary 5 mm under the chapter line.
    text('chapter', '{titleText}', DISPLAY, 24, at('container', 'top-left', 0,
      VIGNETTE.height + 6, { width: mm(MEASURE) }), { ...caps(2.4), lineHeight: 1 }),
    text('summary', '{attr.summary}', TEXT, 12.5, at('#chapter', 'below',
      (MEASURE - SUMMARY) / 2, 5, { width: mm(SUMMARY) }), { italic: true, lineHeight: 1.38 }),
  ] },
};
const chapter = { id: 'capitolo', advancedDesign: opener };

Ingredients

Tipografia
Averia Serif Libre, Fredericka the Great, Quicksand (SIL OFL 1.1)
Recursos
  • ceppo-1200.jpg
  • ciliegie-600.jpg
  • frontespizio-1400.jpg
  • polenta-1200.jpg
  • The frontispiece: Tuscan hills, a hill village and a donkey cart of firewood on its way to the carpenter’s workshop (Generated With Diffusion Models, original)
  • Chapter I’s vignette: Maestro Ciliegia, axe raised over the talking log (Generated With Diffusion Models, original)
  • Chapter II’s vignette: Geppetto in his yellow wig receives the log, beside a pot of polenta (Generated With Diffusion Models, original)
  • The cherry tailpiece (Generated With Diffusion Models, original)

Elaboració

#1 · Un sol estil d'encapçalament, la vinyeta a cada títol

El codi d'aquest pas és a la resposta curta. El resourceId d'un element d'imatge admet els mateixos marcadors que un text de disseny, així que '{attr.vignetta}' dibuixa el recurs que indica el títol, igual que {attr.summary} imprimeix el seu sumari. Els dos capítols comparteixen l'estil capitolo i indiquen la seva imatge a la línia de títol: # Capitolo II {style="capitolo" vignetta="polenta" summary="…"}. Un tercer capítol necessita un recurs i un títol més, no un altre estil (elements d'imatge). La línia del capítol es col·loca des del cap del contenidor, 6 mm per sota de la caixa de la vinyeta, i el sumari penja 5 mm per sota d'ella; l'obertura reserva lloc fins a l'última línia del sumari. Amb minHeight com a mínim de 14 línies, el text del capítol I comença a la mateixa línia que el del II, que té un sumari d'una línia més; sense aquest mínim, el del capítol I comença 6,7 mm més amunt (extensió i disseny avançat).

#2 · Carrega les il·lustracions com a recursos de mapa de bits

script.js · línies 122–133al codi complet
const PICTURES = { // id: [file, width, height, alt text in the book's language]
  frontespizio: ['frontespizio-1400.jpg', 1400, 1105, 'Colline toscane con cipressi e un borgo; '
    + 'un contadino guida un asinello con un carretto di legna verso la bottega di un falegname.'],
  ceppo: ['ceppo-1200.jpg', 1200, 800, 'Maestro Ciliegia, con la scure alzata sopra un pezzo di '
    + 'legno sul banco, si guarda intorno spaventato.'],
  polenta: ['polenta-1200.jpg', 1200, 800, 'Geppetto, con la parrucca gialla, riceve il pezzo di '
    + 'legno da Maestro Ciliegia; accanto, un paiolo di polenta fumante.'],
  ciliegie: ['ciliegie-600.jpg', 600, 626, 'Due ciliegie rosse su un picciolo, con una foglia.'],
};
const resources = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
  id, typeId: 'fregio', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
  bitmap: { fileId, format: 'jpeg', width: w, height: h } }));

Cada imatge és un JPEG de la carpeta assets/ de la recepta, declarat amb la seva mida en píxels: la composició només llegeix aquestes mides, i el canvas pinta el que loadImage() hagi registrat amb cada identificador de fitxer quan dibuixa la pàgina. Les vinyetes i les cireres es van generar sobre blanc i després es van multiplicar pel color del paper, #fffaf0, de manera que els seus marges surten del color de la pàgina i les imatges no tenen una vora visible. La portada està retallada a 190:150, la forma del seu camp, perquè la imatge ajustada l'ompli sense una franja de paper. El paisatge i les vinyetes els pinten elements d'imatge dels dissenys; les cireres, la línia ::resource{id="ciliegie"} del Markdown.

#3 · Fes de la portada un estil d'encapçalament

script.js · línies 68–85al codi complet
const SKY = 150; // mm from the top edge: the foot of the painted field
// # Pinocchio {style="frontespizio" kicker="Le avventure di"}; subtitle and author come from
// the frontmatter. Every element hangs from the page, so the field runs off three edges.
const frontispiece = {
  id: 'frontespizio',
  footer: { elements: [] }, // no folio; the running heads already skip openers
  advancedDesign: { enabled: true, slot: { elements: [ // array order is paint order
    { kind: 'image', id: 'landscape', resourceId: 'frontespizio', // cut to the field's 190:150
      placement: at('page', 'top-left', 0, 0, { width: 'fill', height: mm(SKY) }) },
    text('kicker', '{attr.kicker}', LABEL, 11, at('page', 'top', 0, SKY + 11),
      { ...caps(2.6), fontWeight: 700 }),
    text('title', '{titleText}', DISPLAY, 70, at('page', 'top', 0, SKY + 17),
      { lineHeight: 1, color: col('bark') }),
    text('subtitle', '{subtitle}', TEXT, 15, at('page', 'top', 0, SKY + 44), { italic: true }),
    text('author', '{author}', LABEL, 9, at('page', 'top', 0, SKY + 58),
      { ...caps(2), fontWeight: 600 }),
  ] } },
};

La portada és el primer títol del Markdown, # Pinocchio {style="frontespizio" kicker="Le avventure di"}, i el seu estil la pinta sencera: el paisatge, de 150 mm d'alçada des de la vora superior de la pàgina, i després l'avanttítol de l'atribut, el títol i, des de les metadades del principi del fitxer, el subtítol i l'autor. Tots els elements pengen de la pàgina, no de la caixa de text, de manera que la il·lustració arriba a la vora superior i als dos costats del full encara que el títol continuï a l'única columna del llibre. El footer buit treu el disc del foli que porten les obertures de capítol, i pages: 'body' ja deixa les capçaleres fora d'aquesta pàgina (estils d'encapçalament).

#4 · Capçaleres a les pàgines de text, folis en discos

script.js · línies 89–110al codi complet
// The excerpt opens on book page 6, a verso, so the title page faces chapter I.
const continuation = { pageIndexOffset: 5, pageNumbering: { startAt: 6 } };
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre sits off the page's centre
const head = (id, content, parity, x) => text(id, content, LABEL, 8,
  at('page', 'top', x, 12), { ...caps(1.8), fontWeight: 600, parity, pages: 'body' });
const DISC = 7.4; // mm: the folio's disc
// A fixed square with a radius of half its side is a circle; the figures sit in its middle.
// lineHeight 1.17: the baseline falls at 0.8 of the line, 0.94 em down, so Quicksand's
// figures (0.70 em tall) leave 0.23 em above and below them, and 'middle' centres that line.
const disc = (id, parity, pages, edge, x) => text(id, '{pageNumber}', LABEL, 8.5,
  at('page', edge, x, -(BOTTOM - DISC) / 2, { width: mm(DISC), height: mm(DISC) }),
  { fontWeight: 700, color: col('paper'), lineHeight: 1.17, verticalAlign: 'middle', parity,
    pages, box: { backgroundColor: col('wood'), borderRadius: mm(DISC / 2) } });
const header = { elements: [
  head('verso-title', '{title}', 'even', -SHIFT), // the book on the left-hand page
  head('recto-chapter', '{chapterTitle}', 'odd', SHIFT), // the chapter on the right
] };
const footer = { elements: [
  disc('verso-folio', 'even', 'body', 'bottom-left', OUTER),
  disc('recto-folio', 'odd', 'body', 'bottom-right', -OUTER),
  disc('opener-folio', 'all', 'opener', 'bottom', 0), // a chapter opens on either side
] };

continuation numera l'extracte des de la pàgina 6 del llibre, que és parella, així que la portada queda davant del capítol I i el primer foli imprès és el 7. pages: 'body' deixa les capçaleres fora de la portada i de les dues obertures, de manera que només surten a les pàgines 8 i 9: el títol del llibre a la parella i el del capítol a la senar (elements de text). El foli és un text de disseny dins d'un quadrat fix de 7,4 mm amb cantonades d'un radi de mig costat, és a dir, un cercle; verticalAlign: 'middle' i l'alçada de línia que es calcula al comentari hi centren les xifres. Les xifres, color paper, tenen un contrast de 4,98:1 sobre la fusta. Els rètols en majúscules espaiades no porten cap desplaçament: en centrar una línia, l'espaiat que segueix l'última lletra no compta.

#5 · Tanca el capítol amb un cul de llàntia sense número

script.js · línies 114–118al codi complet
// No caption prefix and no caption, so the cherries that close chapter I print with no
// label or number. The pictures the design slots paint are of this type too.
const resourceTypes = [{ id: 'fregio', name: 'Fregio', namePlural: 'Fregi', shortLabel: 'Fregio',
  captionPrefix: '', numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
  defaultPlacement: { position: 'here', width: 0.16, align: 'center' } }];

Un tipus de recurs imprimeix el seu captionPrefix i el seu número davant del peu. Amb el prefix buit i sense peu, sota les cireres no surt res; amb captionPrefix: 'Fregio', el mateix recurs porta a sota Fregio 1. i creix 10 mm (tipus de recurs). El defaultPlacement del tipus col·loca cada recurs on hi ha la seva línia ::resource, centrat i amb un sisè de la mesura d'amplada, així que al Markdown n'hi ha prou amb ::resource{id="ciliegie"} després de l'últim paràgraf del capítol. Les altres imatges comparteixen el tipus, però cap :ref ni ::resource no hi fa referència, així que mai no es col·loquen ni es compten.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 066 · Storybook chapters with vignettes and summaries ═══
// https://postext.dev/en/cookbook/storybook-chapter-vignettes
// Code: MIT · Text: C. Collodi, 1883 (PD, Gutenberg #52484) · Pictures: diffusion models
// Fonts: Averia Serif Libre, Fredericka the Great, Quicksand (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document (the sample is Italian in both)
const RECIPE = 'storybook-chapter-vignettes';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config comes from here; the pictures were painted to it
  ink: '#2b2118', // text: a brown near-black
  paper: '#fffaf0', // a warm book paper, which the vignettes' margins were tinted to
  bark: '#6b4224', // chapter lines, running heads, the title
  wood: '#9a5f30', // the folio discs
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
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 defaults linked to main-color, bold among them, print in bark instead of blue.
  { id: 'main-color', name: 'bark (defaults)', value: { hex: palette.bark, model: 'hex' } },
];
// Text and summaries; the book's title and the chapter lines; running heads and folios.
const [TEXT, DISPLAY, LABEL] = ['Averia Serif Libre', 'Fredericka the Great', 'Quicksand'];
const TRIM = { width: 190, height: 240 }; // mm
const [TOP, INNER, OUTER] = [22, 22, 20]; // mm; mirrored, so the spine margin swaps sides
const MEASURE = TRIM.width - INNER - OUTER; // 148 mm
const [BODY, LEAD, LINES] = [13, 19, 29]; // pt, pt, and whole lines in the text block
const BOTTOM = TRIM.height - TOP - (LINES * LEAD * 25.4) / 72; // mm: 23.6
// Design-slot shorthands: a placement from an anchor's edge (mm), and a design text.
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
  content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
  overflow: 'wrap', // a long line wraps in every slot, the running heads too
  placement, ...extra });
const caps = (tracking) => ({ textTransform: 'uppercase', letterSpacing: pt(tracking),
  color: col('bark') });

// #region answer: one opener for every chapter: the vignette the heading names, then its summary
// # Capitolo I {style="capitolo" vignetta="ceppo" summary="Come andò che Maestro Ciliegia…"}
// resourceId takes placeholders like a design text: '{attr.vignetta}' draws the resource the
// heading names, so every chapter shares one style.
const VIGNETTE = { width: 84, height: 56 }; // mm, centred at the head of the text block
const SUMMARY = 124; // mm: the summary's measure, narrower than the text's

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', el capítol II passa a la pàgina 11 i la 10 queda en blanc; la portada desactiva el seu propi salt, perquè hereta el del nivell i, si no, passaria a la pàgina 7 després d'una pàgina 6 en blanc.

@@ l'estil de la portada @@
   id: 'frontespizio',
+  breakBefore: { enabled: false },
@@ headings, a config() @@
-    levels: [{ level: 1, breakBefore: { enabled: true, parity: 'any' } }],
+    levels: [{ level: 1, breakBefore: { enabled: true, parity: 'odd' } }],

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 →

  • Al Markdown, un espai de no separació (U+00A0) uneix cada guió llarg de diàleg de Collodi a la seva paraula, perquè un guió de tancament no obri mai línia; dos més mantenen junts di legno i in piedi al final dels seus paràgrafs. Els espais també aguanten en un paràgraf amb negreta o cursiva, com el de l'ohi de la pàgina 9, que en té quatre.

Crèdits

Text
  • Le avventure di Pinocchio (1883): chapter I and the opening of chapter II with Collodi’s chapter summaries, from the 1902 Bemporad edition, with typographic apostrophes, dashes and ellipses; chapter I’s summary has the comma after “falegname” that the edition’s table of contents prints and its chapter head leaves out · Carlo Collodi · domini públic
Imatges
  • The frontispiece: Tuscan hills, a hill village and a donkey cart of firewood on its way to the carpenter’s workshop · Generated With Diffusion Models · original
  • Chapter I’s vignette: Maestro Ciliegia, axe raised over the talking log · Generated With Diffusion Models · original
  • Chapter II’s vignette: Geppetto in his yellow wig receives the log, beside a pot of polenta · Generated With Diffusion Models · original
  • The cherry tailpiece · Generated With Diffusion Models · original
Fonts
Averia Serif Libre (SIL OFL 1.1) · Fredericka the Great (SIL OFL 1.1) · Quicksand (SIL OFL 1.1)
Sandbox