Em poucas palavras
Os três primeiros capítulos de um romance brasileiro numa edição em brochura. Cada capítulo começa numa página da direita, mais abaixo, sob um número de capítulo grande.
O que você vai compor
Oito páginas de uma brochura de 140 × 216 mm trazem os três primeiros capítulos de Quincas Borba (1891), de Machado de Assis. A capa, uma pintura gerada com modelos de difusão e carregada como JPEG, mostra o mar entre os troncos de duas árvores: um veleiro no horizonte e uma sombrinha branca subindo da praia entre flores amarelas e brancas. O colofão fica no pé do verso da capa. Cada capítulo abre numa página ímpar com o texto a 81 mm do topo, sob um numeral em itálico de 48 pt, um fio vermelho-ferrugem de 18 mm e a primeira frase do capítulo em versaletes, centralizada e, quando ocupa duas linhas, quebrada pelo sentido. Os capítulos I e II, curtos, terminam nas próprias aberturas, nas páginas 3 e 5, com uma vinheta de camomila; as páginas 4 e 6 ficam em branco, sem cabeço nem fólio, e o capítulo III abre na página 7. Os cabeços trazem o autor nas páginas pares e o título em itálico nas ímpares; nestas oito páginas, só a página 8 leva cabeço.
Esta receita responde a
- Como forço uma quebra de página ou de coluna e faço cada capítulo começar em página ímpar?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
- Como insiro páginas em branco de propósito, ou começo uma seção em uma nova página dupla?
- Como configuro os cabeços: título do livro na página esquerda, título do capítulo na direita e fólio do lado de fora?
- Como faço uma capa, uma falsa folha de rosto, uma folha de rosto e um colofão?
- Como acrescento espaço vertical entre dois blocos, se as linhas em branco não fazem nada?
- Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?
A 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 };
Ingredientes
- Funcionalidades
- Aberturas desenhadasCapítulos que abrem em página ímparCabeços por seçãoMargens espelhadasEstilos de títuloCapas, folhas de rosto e colofõesAtributos de títuloTextos, fios e caixas nos designs de páginaImagens nos designs de páginaGeometria por seçãoCabeços por tipo de páginaCabeços e fóliosMetadados do documentoEstilos de parágrafoEspaço vertical explícitoFiguras e tabelas como recursosTipos de recurso personalizadosFiguras exatamente aquiCor do papelViúvas, órfãs e linhas curtas
- Tipografia
- Crimson Pro, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- Materiais
cover-1190.jpgcover-it-1190.jpg- A vista do mar da capa, uma pintura (Generated With Diffusion Models, original)
- A capa da edição italiana: um detalhe de Settignano (c. 1880), óleo sobre tela; digitalização do Wikimedia Commons, um recorte de 1744 × 1669 px reduzido a 1190 px de largura (Telemaco Signorini, domínio público)
- A vinheta de camomila, desenhada em código com a paleta da página (Ignacio Ferro, MIT)
Preparo
#1 · A abertura sai do título e do seu atributo
O código é a resposta curta acima. Os capítulos de Machado não têm título, por isso cada título só traz o numeral (# I), que {titleText} imprime. {attr.lead} imprime o atributo lead do título, que guarda a primeira frase do capítulo; o parágrafo Markdown sob o título começa com a frase seguinte (atributos de título). A primeira frase fica centralizada, e o \n a quebra pelo sentido, depois de enseada, e depois de há; a primeira frase do capítulo III, Um criado trouxe o café., cabe numa linha e não leva \n. A caixa da primeira frase começa nove linhas da grade abaixo do topo da mancha, e um minHeight de 12 linhas deixa uma linha em branco embaixo dela; sem minHeight, o texto começa logo abaixo da frase (span e design avançado). marginBottom: pt(0) substitui a margem padrão de meio eme do nível, que empurraria o texto uma linha para baixo.
breakBefore com paridade 'odd' manda cada capítulo para uma página ímpar, com uma par em branco só depois de um capítulo que termina numa ímpar (quebrar antes). Para forçar uma página ímpar onde não há título, escreva :::pagebreak{parity="odd"} no Markdown; numa diagramação de duas colunas ou mais, :::columnbreak passa o texto para a coluna seguinte (:::pagebreak).
#2 · Uma página de brochura com linhas inteiras
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 },
};
A margem inferior é o que sobra dos 216 mm do refile depois da margem superior e de 35 linhas de 14 pt, de modo que toda página cheia termina na mesma linha, a última da mancha, onde também termina o colofão da página 2. Com mirror: true, a margem interna de 20 mm cai do lado da lombada tanto nas ímpares quanto nas pares (margens espelhadas). A medida de 104,5 mm comporta uns 69 caracteres de Crimson Pro de 10,5 pt. O texto corrido mantém os espaços entre palavras entre 0,7 e 1,9 do normal; com o mínimo padrão de 0,6, uma linha destas páginas se fecha até 0,62.
#3 · Cabeços que pulam aberturas e páginas em branco
// {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' põe o autor em versaletes de Cormorant SC nas páginas pares, e 'odd' põe o título em itálico nas ímpares; os fólios ficam na borda externa da mancha. pages: 'body' deixa os quatro elementos fora das aberturas e das páginas 4 e 6, as páginas pares em branco que a quebra com paridade acrescenta. Com pages: 'all', a página 6 imprimiria 6 e Machado de Assis. As aberturas recebem no lugar um fólio no pé, um elemento de rodapé que pages: 'opener' restringe a elas (elementos de texto).
#4 · A capa é uma seção sem cabeços
// 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) };
A capa é um título, # Quincas Borba {style="cover"}. O estilo dele põe a pintura nos 134 mm de cima, o título do front matter em 50 pt e o autor em versaletes. O estilo também vale para a seção que o título abre, as páginas 1 e 2, até o capítulo I. O header e o footer vazios tiram o fólio no pé da capa e os cabeços do colofão. A margem superior dele põe o colofão nas seis últimas linhas da grade da mancha, por isso a última linha do colofão fica na última linha da mancha, a 35ª da grade (estilos de título). A coluna da seção começa a 165 mm, e o design, ancorado na página e na sangria, é pintado acima dela do mesmo jeito: só o pé da coluna corta um design preso a ela.

#5 · Uma vinheta fecha cada capítulo
// 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}.` }))),
];
O tipo ornamento não tem prefixo de legenda, por isso a flor de camomila sai sem rótulo, com 17% da medida de largura, onde está ::resource{id="tailpiece-1"} (tipos de recurso). Um elemento inserido no texto mantém uma linha da grade acima dele, e o :::space que vem antes acrescenta uma segunda entre a última linha do capítulo e a flor (:::space). As três vinhetas desenham o mesmo arquivo, fleuron.svg, sob três ids, porque um recurso só é posicionado uma vez.
A receita 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 = 'pt'; // @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
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
#Deixar o capítulo II seguir na página seguinte
Com paridade 'any', o capítulo II abre na página 4, uma página par, o III na página 5, e o livro termina na página 6; o fólio no pé é centralizado na mancha, não na página, de modo que nessa página par ele continua sob o meio do texto.
-const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },
+const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },#Marcar uma quebra de cena dentro de um capítulo
Entre duas linhas :::space, a mesma flor marca uma quebra de cena, e o parágrafo seguinte começa sem recuo porque indentAfterHeading está desativado. Na edição em inglês, posta depois de seemed long to him., a flor cai no pé da página 4; o segundo espaço já não cabe ali e é descartado. A quebra acrescenta quatro linhas, que empurram a vinheta do capítulo I sozinha para a página 6, sob um cabeço, por isso ajuste o texto do capítulo de novo depois de acrescentar uma.
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, …Erros comuns
Erro comum
A página 1 é ímpar: planeje com os números físicos
A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →
Erro comum
::resource{id="…"} só aceita aspas duplas
Uma inserção em bloco só é reconhecida como ::resource{id="…"} com aspas duplas; qualquer outra forma fica no texto como uma linha visível. Figuras exatamente aqui →
Verificação do Sandbox · parityCascade
Cascata de paridade
Por quê. Quebras com paridade se acumulam e produzem mais de duas páginas em branco seguidas.
Correção. Revise as quebras always-odd e as paridades de breakBefore; em capítulos curtos, a paridade any costuma evitar essas páginas em branco. Docs →
- Com
'always-odd', uma página separadora em branco vem depois de cada seção, antes de qualquer preenchimento de paridade, por isso, na edição em inglês, o capítulo I passaria para a página 5, depois de duas páginas em branco, e o livro chegaria a dez páginas. - As páginas da edição em inglês foram ajustadas linha a linha. Com uma margem externa de 16 mm em vez de 15,5, a página 7 parte after-din-ner num segundo hífen e termina uma linha antes, a página 8 fecha um parágrafo com o fragmento spondent., e a segunda vinheta cai numa nona página. Confira o pé de todas as páginas depois de mudar a medida, o corpo ou o rebaixamento.
- Na edição em inglês, Mr. e Mrs. ficam presos ao nome por um espaço não separável (U+00A0). O parágrafo que termina em seemed long to him. fica com um espaço comum, porque prender o nome ali abre a primeira linha dele até 2,2 vezes o espaço normal entre palavras.
Créditos
- Receita
- Ignacio Ferro
- Texto
- The Awakening (O despertar, 1899), capítulos I e II, na edição em inglês · Kate Chopin · domínio público
- Quincas Borba (1891), capítulos I a III, com a ortografia atualizada · Machado de Assis · domínio público
- Madame Gervaisais (1869), capítulos I e II, o texto da edição francesa, com a ortografia da primeira edição · Edmond et Jules de Goncourt · domínio público
- Beate und Mareile (Beate e Mareile, 1903), capítulos 1 e 2 (o segundo abreviado), o texto da edição alemã, com a ortografia da edição de S. Fischer · Eduard von Keyserling · domínio público
- Le avventure di Pinocchio (As aventuras de Pinóquio, Felice Paggi, Florença, 1883), capítulos I e II, o texto da edição italiana, com a ortografia da primeira edição, sem os sumários dos capítulos · Carlo Collodi · domínio público
- O colofão · Postext Cookbook · original
- Imagens
- A vista do mar da capa, uma pintura · Generated With Diffusion Models · original
- A capa da edição italiana: um detalhe de Settignano (c. 1880), óleo sobre tela; digitalização do Wikimedia Commons, um recorte de 1744 × 1669 px reduzido a 1190 px de largura · Telemaco Signorini · domínio público
- A vinheta de camomila, desenhada em código com a paleta da página · Ignacio Ferro · MIT
- Fontes
- Crimson Pro (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant SC (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)


