Em poucas palavras
As primeiras páginas de uma edição infantil italiana de Pinóquio. Cada capítulo começa com uma ilustração própria em aquarela e um resumo curto do que acontece nele.
O que você vai compor
As primeiras páginas de uma edição infantil italiana de Le avventure di Pinocchio, de Collodi, compostas em Averia Serif Libre de 13/19 pt numa página de 190 × 240 mm. Uma folha de rosto ilustrada, na página par, fica diante do capítulo I: uma aquarela das colinas da Toscana, onde uma carroça puxada por um burro leva lenha até a oficina de um carpinteiro, acima do título em Fredericka the Great. Cada capítulo abre sob uma vinheta em aquarela que se funde com o papel (Mestre Cereja com o machado erguido sobre o tronco falante no capítulo I, Gepeto com a peruca amarela recebendo o tronco no capítulo II) e segue com a linha do capítulo e o sumário de Collodi em itálico centralizado. As quatro imagens foram geradas com modelos de difusão a partir de um mesmo prompt de estilo e da paleta da página. Os cabeços só saem nas páginas 8 e 9, as duas sem abertura. Os fólios ficam em discos cor de madeira, e duas cerejas fecham o capítulo I sem legenda nem número.
Esta receita responde a
- Como dou a cada capítulo sua própria foto, cor ou variante de abertura?
- Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
- Como oculto os cabeços nas aberturas e nas páginas em branco, ou pinto uma página par em branco com a cor da parte?
A resposta curta
// # 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
- Funcionalidades
- Aberturas desenhadasImagens nos designs de páginaCabeços e fóliosEstilos de títuloAtributos de títuloCapítulos que abrem em página ímparTextos, fios e caixas nos designs de páginaCabeços por tipo de páginaTipos de recurso personalizadosFiguras exatamente aquiFiguras e tabelas como recursosHifenização e idioma do documentoMargens espelhadasPaleta de cores semânticaPáginas em um canvas
- Tipografia
- Averia Serif Libre, Fredericka the Great, Quicksand (SIL OFL 1.1)
- Materiais
ceppo-1200.jpgciliegie-600.jpgfrontespizio-1400.jpgpolenta-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)
Preparo
#1 · Um só estilo de título, a vinheta indicada em cada título
O código deste passo está na resposta curta. O resourceId de um elemento de imagem aceita os mesmos marcadores de um texto de design, por isso '{attr.vignetta}' desenha o recurso que o título indica, do mesmo jeito que {attr.summary} imprime o sumário. Os dois capítulos compartilham o estilo capitolo e indicam a imagem na linha do título: # Capitolo II {style="capitolo" vignetta="polenta" summary="…"}. Um terceiro capítulo precisa de mais um recurso e mais um título, não de outro estilo (elementos de imagem). A linha do capítulo é posicionada a partir do topo do contêiner, 6 mm abaixo da caixa da vinheta, e o sumário fica 5 mm abaixo dela; a abertura reserva espaço até a última linha do sumário. Com minHeight como piso de 14 linhas, o texto do capítulo I começa na mesma linha que o do capítulo II, cujo sumário tem uma linha a mais; sem ele, o texto do capítulo I começa 6,7 mm mais acima (span e design avançado).
#2 · Carregar as pinturas como recursos bitmap
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 imagem é um JPEG da pasta assets/ da receita, declarado com o tamanho em pixels: a diagramação só lê esses tamanhos, e o canvas pinta o que loadImage() tiver registrado sob cada id de arquivo no momento em que desenha a página. As vinhetas e as cerejas foram geradas sobre branco e depois multiplicadas pela cor do papel, #fffaf0, de modo que as margens delas saem na cor da página e as imagens não têm borda visível. A ilustração da folha de rosto está recortada em 190:150, a proporção do campo, para que a imagem ajustada preencha o campo sem uma faixa de papel. A paisagem e as vinhetas são pintadas por elementos de imagem dos designs; as cerejas, por ::resource{id="ciliegie"} no Markdown.
#3 · Fazer da folha de rosto um estilo de título
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 }),
] } },
};
A folha de rosto é o primeiro título do Markdown, # Pinocchio {style="frontespizio" kicker="Le avventure di"}, e o estilo dela pinta tudo na página: a paisagem, com 150 mm de altura a partir da borda superior, e depois o antetítulo vindo do atributo, o título e, do front matter, o subtítulo e o autor. Todos os elementos pendem da página, não da mancha, de modo que a pintura chega à borda superior e aos dois lados da folha, embora o título continue na única coluna do livro. O footer vazio tira o disco do fólio que as aberturas de capítulo imprimem, e pages: 'body' já deixa os cabeços fora da página (estilos de título).
#4 · Cabeços nas páginas de texto, fólios em discos
// 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 o trecho a partir da página 6 do livro, uma página par, de modo que a folha de rosto fica diante do capítulo I e o primeiro fólio impresso é o 7. pages: 'body' deixa os cabeços fora da folha de rosto e das duas aberturas, por isso eles só saem nas páginas 8 e 9, o título do livro na par e o do capítulo na ímpar (elementos de texto). O fólio é um texto de design num quadrado fixo de 7,4 mm cujo raio de canto é metade do lado, o que dá um círculo; verticalAlign: 'middle' e a entrelinha calculada no comentário centralizam os algarismos nele. Os algarismos cor de papel têm contraste de 4,98:1 sobre a madeira. Os rótulos espaçados não levam nenhum deslocamento: ao centralizar uma linha, o tracking depois da última letra fica de fora.
#5 · Fechar o capítulo com uma vinheta de fecho sem número
// 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' } }];
Um tipo de recurso imprime o captionPrefix e o número antes da legenda. Com o prefixo vazio e sem legenda, nada sai sob as cerejas; com captionPrefix: 'Fregio', o mesmo recurso imprime Fregio 1. sob o desenho e fica 10 mm mais alto (tipos de recurso). O defaultPlacement do tipo põe cada recurso onde está a linha ::resource, com um sexto da medida de largura e centralizado, de modo que o Markdown só precisa de ::resource{id="ciliegie"} depois do último parágrafo do capítulo. As outras imagens compartilham o tipo, mas nenhum :ref ou ::resource as menciona, por isso nunca são posicionadas nem contadas.
A receita completa
// ═══ 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 = 'en'; // @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
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Abrir todo capítulo numa página ímpar
Com 'odd', o capítulo II passa para a página 11 e a página 10 fica em branco; a folha de rosto desativa a própria quebra, porque herda a do nível e, sem isso, iria para a página 7 depois de uma página 6 em branco.
@@ the frontispiece style @@
id: 'frontespizio',
+ breakBefore: { enabled: false },
@@ headings, in config() @@
- levels: [{ level: 1, breakBefore: { enabled: true, parity: 'any' } }],
+ levels: [{ level: 1, breakBefore: { enabled: true, parity: 'odd' } }],Erros comuns
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
- No Markdown, um espaço não separável (U+00A0) prende cada travessão de diálogo de Collodi à palavra, para que um travessão de fechamento nunca abra uma linha; outros dois mantêm juntos di legno e in piedi no fim dos parágrafos. Esses espaços seguram também num parágrafo com negrito ou itálico, como o do ohi na página 9, que tem quatro.
Créditos
- Receita
- Ignacio Ferro
- Texto
- 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 · domínio público
- Imagens
- 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
- Fontes
- Averia Serif Libre (SIL OFL 1.1) · Fredericka the Great (SIL OFL 1.1) · Quicksand (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


