Saltar al contenido principal
Receta número 66

Recetario · Capítulo 3 · Títulos y aperturas

Capítulos de cuento con viñetas y sumarios

Un solo estilo de encabezado abre todos los capítulos; cada título indica en atributos su viñeta y su sumario en cursiva, que pinta la apertura.

En esta página

pp. 6–7 · 1–2 de 5

  • Formato 190 × 240 mm
  • 1 columna
  • Averia Serif Libre 13/19
  • Fredericka the Great
  • Quicksand
  • 5 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 60 ms
  • 162 líneas de código

En pocas palabras

Las primeras páginas de una edición infantil italiana de Pinocho. Cada capítulo empieza con su propia ilustración en acuarela y un breve resumen de lo que pasa.

Lo que vas a componer

Las primeras páginas de una edición infantil italiana de Le avventure di Pinocchio, de Collodi, compuestas en Averia Serif Libre de 13/19 pt, en formato de 190 × 240 mm. Frente al capítulo I, en la página par, va una portada ilustrada: una acuarela de las colinas toscanas, donde un carro tirado por un asno lleva leña al taller de un carpintero, por encima del título en Fredericka the Great. Cada capítulo empieza bajo una viñeta en acuarela que se funde con el papel (maestro Ciliegia con el hacha en alto sobre el leño que habla en el capítulo I, Geppetto con su peluca amarilla recibiendo el leño en el II) y sigue con la línea del capítulo y el sumario de Collodi en cursiva centrada. Las cuatro imágenes se generaron con modelos de difusión a partir de unas mismas indicaciones de estilo y la paleta de la página. Solo llevan cabecera las páginas 8 y 9, las dos sin apertura. Los folios van en discos color madera, y el capítulo I termina con dos cerezas sin pie ni número.

Esta receta responde a

  • ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
  • ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
  • ¿Cómo añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?
  • ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?

La respuesta corta

script.js · líneas 44–64en el código completo
// # 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 };

Ingredientes

Tipografía
Averia Serif Libre, Fredericka the Great, Quicksand (SIL OFL 1.1)
Recursos
  • ceppo-1200.jpg
  • ciliegie-600.jpg
  • frontespizio-1400.jpg
  • polenta-1200.jpg
  • El frontispicio: colinas toscanas, un pueblo en lo alto y un carro de leña tirado por un asno camino del taller del carpintero (Generated With Diffusion Models, original)
  • La viñeta del capítulo I: Maestro Ciliegia, con el hacha en alto sobre el tronco que habla (Generated With Diffusion Models, original)
  • La viñeta del capítulo II: Geppetto, con su peluca amarilla, recibe el tronco junto a una olla de polenta (Generated With Diffusion Models, original)
  • El remate de las cerezas (Generated With Diffusion Models, original)

Elaboración

#1 · Un solo estilo de título, la viñeta en cada título

El código de este paso está en la respuesta corta. El resourceId de un elemento de imagen admite los mismos marcadores que un texto de diseño, así que '{attr.vignetta}' dibuja el recurso que indica el título, igual que {attr.summary} imprime su sumario. Los dos capítulos comparten el estilo capitolo e indican su imagen en la línea del encabezado: # Capitolo II {style="capitolo" vignetta="polenta" summary="…"}. Un tercer capítulo necesita un recurso y un título más, no otro estilo (elementos de imagen). La línea del capítulo se coloca desde la cabeza del contenedor, 6 mm por debajo de la caja de la viñeta, y el sumario cuelga 5 mm por debajo de ella; la apertura reserva sitio hasta la última línea del sumario. Con minHeight como mínimo de 14 líneas, el texto del capítulo I empieza en la misma línea que el del II, cuyo sumario ocupa una línea más; sin él, el del capítulo I empieza 6,7 mm más arriba (apertura a toda página y diseño avanzado).

#2 · Carga las ilustraciones como recursos de mapa de bits

script.js · líneas 122–133en el código completo
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 imagen es un JPEG de la carpeta assets/ de la receta, declarado con su tamaño en píxeles: la composición solo lee esos tamaños, y el canvas pinta lo que loadImage() haya registrado con cada identificador de archivo cuando dibuja la página. Las viñetas y las cerezas se generaron sobre blanco y después se multiplicaron por el color del papel, #fffaf0, de modo que sus márgenes salen del color de la página y las imágenes no tienen un borde visible. La portada está recortada a 190:150, la forma de su campo, para que la imagen ajustada lo llene sin una franja de papel. El paisaje y las viñetas los pintan elementos de imagen de los diseños; las cerezas, la línea ::resource{id="ciliegie"} del Markdown.

#3 · Haz de la portada un estilo de título

script.js · líneas 68–85en el código completo
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 es el primer encabezado del Markdown, # Pinocchio {style="frontespizio" kicker="Le avventure di"}, y su estilo la pinta entera: el paisaje, de 150 mm de alto desde el borde superior de la página, y después el antetítulo del atributo, el título y, desde los metadatos del principio del archivo, el subtítulo y el autor. Todos los elementos cuelgan de la página, no de la caja de texto, así que la ilustración llega al borde superior y a los dos lados de la hoja aunque el título siga en la única columna del libro. El footer vacío quita el disco del folio que llevan las aperturas de capítulo, y pages: 'body' ya deja las cabeceras fuera de esta página (estilos de encabezado).

#4 · Cabeceras en las páginas de texto, folios en discos

script.js · líneas 89–110en el código completo
// 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 el extracto desde la página 6 del libro, que es par, así que la portada queda frente al capítulo I y el primer folio impreso es el 7. pages: 'body' deja las cabeceras fuera de la portada y de las dos aperturas, de modo que solo salen en las páginas 8 y 9: el título del libro en la par y el del capítulo en la impar (elementos de texto). El folio es un texto de diseño dentro de un cuadrado fijo de 7,4 mm cuyas esquinas tienen un radio de medio lado, es decir, un círculo; verticalAlign: 'middle' y la altura de línea que se calcula en el comentario centran en él las cifras. Las cifras, color papel, tienen un contraste de 4,98:1 sobre la madera. Los rótulos en mayúsculas espaciadas no llevan ningún desplazamiento: al centrar una línea, el espaciado que sigue a su última letra no cuenta.

#5 · Cierra el capítulo con un remate sin número

script.js · líneas 114–118en el código completo
// 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 tipo de recurso imprime su captionPrefix y su número delante del pie. Con el prefijo vacío y sin pie, bajo las cerezas no sale nada; con captionPrefix: 'Fregio', el mismo recurso lleva debajo Fregio 1. y crece 10 mm (tipos de recurso). El defaultPlacement del tipo coloca cada recurso donde está su línea ::resource, centrado y con un sexto de la medida de ancho, así que en el Markdown basta con ::resource{id="ciliegie"} tras el último párrafo del capítulo. Las demás imágenes comparten el tipo, pero ningún :ref ni ::resource los cita, así que nunca se colocan ni se cuentan.

La receta 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

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Abre cada capítulo en página impar

Con 'odd', el capítulo II pasa a la página 11 y la 10 queda en blanco; la portada desactiva su propio salto, porque hereda el del nivel y, si no, pasaría a la página 7 tras una página 6 en blanco.

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

Errores frecuentes

Error frecuente

Valores de atributo: sin { ni }; comillas simples si llevan "

Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →

  • En el Markdown, un espacio de no separación (U+00A0) une cada raya de diálogo de Collodi a su palabra, para que una raya de cierre nunca abra línea; otros dos mantienen juntos di legno e in piedi al final de sus párrafos. Los espacios también aguantan en un párrafo con negrita o cursiva, como el del ohi de la página 9, que tiene cuatro.

Créditos

Texto
  • Le avventure di Pinocchio (1883): el capítulo I y el comienzo del II con los sumarios de Collodi, según la edición Bemporad de 1902, con apóstrofos, rayas y puntos suspensivos tipográficos; el sumario del capítulo I lleva, como el índice de la edición, la coma tras «falegname» que falta al comienzo del capítulo · Carlo Collodi · dominio público
Imágenes
  • El frontispicio: colinas toscanas, un pueblo en lo alto y un carro de leña tirado por un asno camino del taller del carpintero · Generated With Diffusion Models · original
  • La viñeta del capítulo I: Maestro Ciliegia, con el hacha en alto sobre el tronco que habla · Generated With Diffusion Models · original
  • La viñeta del capítulo II: Geppetto, con su peluca amarilla, recibe el tronco junto a una olla de polenta · Generated With Diffusion Models · original
  • El remate de las cerezas · Generated With Diffusion Models · original
Fuentes
Averia Serif Libre (SIL OFL 1.1) · Fredericka the Great (SIL OFL 1.1) · Quicksand (SIL OFL 1.1)
Sandbox