Em poucas palavras
As páginas de abertura de capítulo de um livro de geologia. Uma faixa colorida com um número grande vai até a borda de cima da página, e o desenho é definido uma vez só para todos os capítulos.
O que você vai compor
As aberturas de capítulo de Earth in Motion, um livro didático de introdução à geologia numa página de 210 × 280 mm. O capítulo 3 abre sob uma faixa terracota sangrada no alto da página. Nela vão um chapéu espacejado, o título quebrado onde o autor quis, uma linha fina em itálico e um número de capítulo de 168 pt apoiado no fio escuro da faixa, junto à margem externa. Duas colunas justificadas começam sob a faixa, e o corte de uma placa que afunda ocupa o pé da página. O capítulo 4 repete o desenho em verde-azulado, até o marcador lateral, os números de seção, as remissões e o rótulo da figura. O desenho é definido uma vez, no título de nível 1. A linha de título de cada capítulo traz como atributos o tema do chapéu e a linha fina, e indica um estilo quando o capítulo muda de cor.
Esta receita responde a
- Como faço uma abertura de capítulo com uma faixa de cor sangrada, um número de capítulo grande e o título?
- Como coloco o título do capítulo na largura da página enquanto o texto segue em duas colunas abaixo?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
- Como dou a cada capítulo sua própria foto, cor ou variante de abertura?
- Como numero os títulos (1, 1.1, 1.1.1) e dou a cada nível um estilo diferente?
A resposta curta
const TOP = 24; // top margin, mm: the opener's container starts here
const OUTER = 16; // outer margin, mm: the numeral and the folios line up on it
const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
const BAND = 100; // mm from the trim to the foot of the band
const NUMERAL = 168; // pt; the baseline of a design text sits 0.8 down its line box
const PT = 25.4 / 72; // mm in a point
const AIR = 12; // mm, foot to text: ≥ 0.2 × NUMERAL × PT ≈ 11.9, the numeral box below its baseline
const BEARING = 2; // mm past the text edge: a rough optical nudge, as each digit's bearing differs
const bleedTop = { to: 'bleed', edge: 'top-left' }; // the trim's corner, pushed out by BLEED
// Design text centres by default; in a heading design it wraps by default too.
const onBand = { color: col('paper'), align: 'left' };
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) },
size: { width: mm(width) } }); // chained: a longer title pushes the standfirst down
const opener = { enabled: true,
// The text starts below the lowest element or minHeight (gotcha: opener-reserves-anchored).
minHeight: mm(BAND - TOP + AIR), // clears the numeral, so the text starts AIR below the foot
slot: {
elements: [ // array order is paint order: the band first, the type on top
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') }, placement: {
anchor: bleedTop, size: { height: mm(BLEED + BAND) } } }, // no width: runs to the far edge
{ kind: 'rule', id: 'foot', color: col('ink'), thickness: mm(1.6), placement: {
anchor: bleedTop, offset: { y: mm(BLEED + BAND) } } },
{ kind: 'text', id: 'numeral', content: '{chapterNumber}', ...onBand,
fontFamily: 'Archivo', fontWeight: 800, fontSize: pt(NUMERAL),
lineHeight: 1, // a box as tall as the type: the y below counts on it
placement: { anchor: { to: 'page', edge: 'top-right' }, // the fore-edge of a recto
offset: { x: mm(BEARING - OUTER), y: mm(BAND - 0.8 * NUMERAL * PT) } } }, // on the foot
{ kind: 'text', id: 'kicker', ...onBand, fontFamily: 'Archivo Narrow', fontWeight: 600,
content: `${t({ en: 'Chapter', es: 'Capítulo' })} {chapterNumber} · {attr.topic}`,
fontSize: pt(8.5), letterSpacing: pt(2), textTransform: 'uppercase',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(7) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, // breaks at the \\
fontFamily: 'Archivo', fontWeight: 800, fontSize: pt(34), lineHeight: 1.02,
placement: below('kicker', 3, 118) },
{ kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: 'Roboto Serif',
italic: true, fontSize: pt(10.5), lineHeight: 1.36, placement: below('title', 6, 100) },
],
},
}; // hook-up: headings.levels[0] = { span: 'page', breakBefore, advancedDesign: opener }
Ingredientes
- Funcionalidades
- Aberturas desenhadasFaixa de capítulo em largura totalAtributos de títuloQuebras de linha nos títulosEstilos de títuloCores por parteTítulos numeradosCapítulos que abrem em página ímparAncoragem de elementos de designTextos, fios e caixas nos designs de páginaFaixas sangradas e guias lateraisPaleta de cores semânticaCabeços e fóliosCabeços por tipo de páginaCitações que posicionam as figurasPosicionamento de figurasFiguras e tabelas como recursosLivros compostos capítulo a capítuloPáginas em um canvas
- Tipografia
- Roboto Serif, Archivo, Archivo Narrow (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Pendurar a faixa e o número na página
O código é a resposta curta lá em cima. A faixa e o fio pendem do canto superior esquerdo da sangria. Como toda caixa ou fio sem largura própria, eles se esticam até a borda oposta dessa caixa de referência, de modo que chegam ao refile, e à sangria assim que BLEED é definido. O número pende do canto superior direito da página: y: BAND - 0.8 * NUMERAL * PT apoia a linha de base no fio, e BEARING desloca a caixa 2 mm para dentro da margem para compensar o espaço lateral do algarismo, de modo que a tinta fica mais ou menos alinhada com a borda do texto. O chapéu pende do contêiner. O título pende abaixo do chapéu e a linha fina abaixo do título, por âncoras below, e um design de título quebra o texto por padrão, por isso um título mais longo empurra a linha fina para baixo. A linha fina é um elemento de texto preenchido com o atributo lead do título; uma linha de autor seria mais um, {attr.author}, encadeado do mesmo jeito. minHeight: BAND - TOP + AIR define onde começa o texto. A caixa do número desce 0,2 vez o corpo (11,9 mm) abaixo do fio, e uma abertura reserva espaço até o elemento mais baixo, por isso AIR precisa ter pelo menos 11,9 mm; com menos, seria a caixa do número que definiria onde começa o texto.
#2 · Dar a página ao título do capítulo
headings: {
fontFamily: 'Archivo', color: col('band'),
levels: [
// parity: 'odd' keeps openers on rectos, so the numeral's right-edge anchor is the
// fore-edge. The copy is fitted so no chapter spills a few lines onto a page of its own,
// which would leave that page and a blank verso before the next opener.
{ level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
// 0: the hidden title's default 0.5 em would add a grid line, and AIR alone sets the gap
marginBottom: pt(0), advancedDesign: opener },
{ level: 2, fontSize: pt(11.5), lineHeight: pt(LEAD), numberingTemplate: '{1}.{2}',
marginTop: pt(LEAD), marginBottom: pt(0) }, // one grid line above, none below
],
},
span: 'page' abre cada capítulo numa página nova e estende o título de nível 1 sobre as duas colunas; advancedDesign desenha a abertura no lugar do texto do título, e o corpo começa abaixo da altura reservada. breakBefore com parity: 'odd' põe cada abertura num recto, onde a âncora à direita do número é a margem externa. No nível 2, numberingTemplate: '{1}.{2}' numera as seções 3.1, 3.2… na cor da faixa; um nível 3 com '{1}.{2}.{3}' seguiria com 3.1.1.
#3 · Nomear a cor do capítulo uma vez só
const palette = {
ink: '#1b1f23', // text: a cool near-black
band: '#c2562b', // the chapter colour: band, tab, section numbers, references, captions
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
land: '#d5cbc0', // the crust in the drawings
muted: '#6b6259', // running heads and the colophon
paper: '#ffffff', // type on the band
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the link.
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 link to 'main-color': point it at the band, so nothing prints blue.
{ id: 'main-color', name: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// {style="teal"} on a heading line swaps 'band' up to the next level-1 heading: the style's
// palette reaches design slots through their link and repaints every text colour equal to
// the base 'band'.
const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
Cada cor da configuração se liga a uma destas entradas. Os próprios valores padrão do motor se ligam a main-color, por isso apontar essa entrada para a cor da faixa muda também todos os valores padrão que a configuração deixa sem definir. A linha de título do capítulo 4, # Fire from \\ Below {style="teal" topic="Volcanoes" lead="…"}, escolhe o estilo, que troca band até o próximo título de nível 1. Os espaços de design acompanham a troca pela ligação com a paleta, e as cores de texto iguais ao band de base são repintadas, de modo que o marcador lateral, os números de seção e de lista, as remissões, o rótulo da legenda e o fólio no pé ficam verde-azulados nas páginas 43 e 44. A mesma linha preenche {attr.topic} e {attr.lead}, e a \\ quebra {titleText} onde o autor quer (atributos de título, quebras de linha nos títulos).
#4 · Deixar a primeira citação posicionar cada figura
const figure = (id, placement, caption) => ({ id, typeId: 'figure', kind: 'svg', createdAt: 0,
updatedAt: 0, svg: { fileId: `${id}.svg`, width: ART[id].width, height: ART[id].height },
placement, caption, altText: ALT[id] }); // altText: read aloud in a PDF or HTML edition
const resources = [
// 'auto' may take the citing page's foot, 'top' never can (gotcha: top-float-next-page)
figure('plate-cycle', { position: 'auto', span: 'page' },
t({ en: 'A plate’s life in cross-section: born at a ridge (left), it cools as it drifts away '
+ 'and sinks under a continent; dots mark earthquakes.',
es: 'La vida de una placa, en corte: nace en la dorsal (izquierda), se enfría al alejarse y '
+ 'se hunde bajo el continente; los puntos son terremotos.' })),
figure('two-volcanoes', { position: 'bottom', span: 'page' }, // under the text on a last page
t({ en: 'Two volcanoes in cross-section: a broad shield built of runny basalt flows (left) '
+ 'and a steep stratovolcano of lava and ash layers (right).',
es: 'Dos volcanes en corte: un escudo ancho, de coladas de basalto fluido (izquierda), y un '
+ 'estratovolcán de capas de lava y ceniza (derecha).' })),
];
Um :ref numera a figura e a coloca no primeiro espaço livre depois do parágrafo que a cita. A figura 3.1 é auto. Ela é citada na abertura enquanto as duas colunas ainda têm espaço, de modo que ocupa o pé dessa página; como flutuante top, teria aberto a página 42, porque um flutuante nunca sobe acima da referência. A figura 4.1 é citada na parte de baixo da segunda coluna da página 43, onde uma faixa na largura da página já não cabe, e bottom a manda para a página 44. É a última página do capítulo, e numa última página o motor sobe os flutuantes do pé até ficarem logo abaixo das últimas linhas de texto, sem espaço acima deles.
#5 · Cabeços, marcador lateral e fólio no pé
const HEAD = 15.5; // mm from the trim to the folio's and the head's baseline: 8.5 above TOP
const INSET = 9; // mm from the folio's edge to the head: room for a three-digit folio
const TAB = { y: 36, w: 9, h: 26 }; // the thumb tab, mm: its top, its width, its height
const tabSize = (w) => ({ width: mm(w), height: mm(TAB.h) });
const baseline = (size) => mm(HEAD - 0.96 * size * PT); // box: 1.2 × size, baseline 0.8 down
const label = { fontFamily: 'Archivo Narrow', fontSize: pt(7.5), fontWeight: 600,
letterSpacing: pt(1.3), textTransform: 'uppercase', color: col('muted') };
const folio = { fontFamily: 'Archivo', fontSize: pt(9), fontWeight: 800, color: col('ink') };
const side = (parity) => { // the fore-edge is a verso's left edge and a recto's right edge
const [edge, s] = parity === 'even' ? ['left', 1] : ['right', -1]; // s: into the page
const at = (to, x, y, size) => ({ anchor: { to, edge: `top-${edge}` },
offset: { x: mm(s * x), y }, ...(size && { size }) });
return [
{ kind: 'text', id: `folio-${parity}`, content: '{pageNumber}', ...folio,
placement: at('page', OUTER, baseline(9)) },
// Textbooks name the chapter on the verso and the section on the recto: {firstMark.h2}
// is the first level-2 heading that starts on the page, or the one in force.
{ kind: 'text', id: `head-${parity}`, content: s > 0 ? '{chapterTitle}' : '{firstMark.h2}',
...label, placement: at('page', OUTER + INSET, baseline(7.5)) },
{ kind: 'box', id: `tab-${parity}`, style: { backgroundColor: col('band') }, // off the trim
placement: at('bleed', 0, mm(BLEED + TAB.y), tabSize(BLEED + TAB.w)) },
{ kind: 'text', id: `tab-no-${parity}`, content: '{chapterNumber}', ...folio, fontSize: pt(13),
color: col('paper'), // design text centres by default: here, on the trimmed tab
placement: at('page', 0, mm(TAB.y), tabSize(TAB.w)) },
].map((element) => ({ ...element, parity, pages: 'body' })); // never on an opener
};
const header = { elements: [...side('even'), ...side('odd')] };
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
...folio, color: col('band'), pages: 'opener', // centred by its anchor
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(10) } } }] };
Cada elemento do cabeçalho pende de um canto superior da página e é filtrado por parity, por isso o fólio e o marcador ficam sempre na margem externa. A caixa do marcador pende do canto da sangria e se alarga com BLEED, para continuar sangrando depois do refile. pages: 'body' tira todos esses elementos das aberturas, que recebem um fólio no pé definido no rodapé. O verso nomeia o capítulo com {chapterTitle}, numa só linha, porque a \\ só quebra o título na abertura. Livros didáticos costumam nomear a seção no recto. O cabeço do recto a imprime com {firstMark.h2}: o primeiro título de seção que começa na página, ou o que está em vigor quando nenhum começa. Nestas quatro páginas ele nunca aparece, porque os dois rectos são aberturas.
#6 · Começar o livro no capítulo 3
const continuation = { pageNumbering: { startAt: 41 }, // an odd folio: page 1 is still a recto
headings: { h1: 2, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } }; // the next # is chapter 3
const doc = await buildDocumentWithFonts({ markdown, resources, continuation }, config(),
kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Chapter opener on a full-bleed band',
es: 'Apertura de capítulo sobre banda a sangre' }) });
Estas páginas são os capítulos 3 e 4 de um livro mais longo, de modo que buildDocument recebe uma continuation com os contadores como os capítulos 1 e 2 os deixaram. Com h1: 2 nos headings, o próximo # é o capítulo 3: {chapterNumber} imprime 3, as seções são numeradas a partir de 3.1 e a primeira figura passa a ser a 3.1. pageNumbering.startAt: 41 começa os fólios em 41. A primeira página continua sendo um recto qualquer que seja o fólio, porque a paridade é contada sobre a página física e pageIndexOffset fica em 0; o primeiro fólio, 41, é ímpar para combinar.
A receita completa
// ═══ Postext Cookbook · Nº 003 · Chapter opener on a full-bleed band ══════════════
// https://postext.dev/en/cookbook/chapter-opener-bleed-band
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Roboto Serif, Archivo, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// Two chapters of a geology textbook. Every level-1 heading becomes a colour band bled off the
// top of the page, its number standing on the band's foot; a heading style recolours chapter 4.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'chapter-opener-bleed-band';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, and the style that swaps a chapter's
const palette = {
ink: '#1b1f23', // text: a cool near-black
band: '#c2562b', // the chapter colour: band, tab, section numbers, references, captions
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
land: '#d5cbc0', // the crust in the drawings
muted: '#6b6259', // running heads and the colophon
paper: '#ffffff', // type on the band
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the link.
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 link to 'main-color': point it at the band, so nothing prints blue.
{ id: 'main-color', name: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// {style="teal"} on a heading line swaps 'band' up to the next level-1 heading: the style's
// palette reaches design slots through their link and repaints every text colour equal to
// the base 'band'.
const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
// #endregion
// #region answer: the opener: a bleed band, the numeral on its foot, texts from the heading
const TOP = 24; // top margin, mm: the opener's container starts here
const OUTER = 16; // outer margin, mm: the numeral and the folios line up on it
const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
const BAND = 100; // mm from the trim to the foot of the band
const NUMERAL = 168; // pt; the baseline of a design text sits 0.8 down its line box
const PT = 25.4 / 72; // mm in a point
const AIR = 12; // mm, foot to text: ≥ 0.2 × NUMERAL × PT ≈ 11.9, the numeral box below its baseline
const BEARING = 2; // mm past the text edge: a rough optical nudge, as each digit's bearing differs
const bleedTop = { to: 'bleed', edge: 'top-left' }; // the trim's corner, pushed out by BLEED
// Design text centres by default; in a heading design it wraps by default too.
const onBand = { color: col('paper'), align: 'left' };
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
#Fazer a faixa mais alta
BAND define a altura da faixa, a posição do número e a altura reservada acima do texto. Uma faixa mais alta empurra texto para a página seguinte, por isso reajuste cada capítulo (veja o último erro comum) ou deixe os capítulos correrem seguidos.
-const BAND = 100; // mm from the trim to the foot of the band
+const BAND = 128; // mm from the trim to the foot of the band#Imprimir com sangria
Com uma sangria de 3 mm, a faixa, o fio e o marcador passam 3 mm do refile, o número continua sobre o fio e page.cutLines é ativado com o mesmo valor.
-const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
+const BLEED = 3; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines#Acrescentar uma cor para outro capítulo
Cada cor de capítulo é mais uma entrada na paleta e mais um estilo; escreva {style="slate"} na linha de título desse capítulo.
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
+ band3: '#3d4f6b', // a third chapter colour, a slate blue
@@
-const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
+const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } },
+ { id: 'slate', palette: { band: palette.band3 } }];#Deixar os capítulos correrem seguidos
Com 'any', um capítulo abre na página seguinte. Depois de um capítulo que termina num recto, ele abre no verso, sem página em branco antes, e o número fica junto à lombada, já que pende da borda direita da página. Estas páginas não mudam, porque o capítulo 3 já termina num verso.
- { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+ { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },Erros comuns
Erro comum
Uma abertura reserva altura até o seu elemento ancorado mais baixo
Uma abertura com design avançado reserva a altura do seu elemento mais baixo, e os elementos ancorados à página ou à sangria abaixo do título também contam, então um ornamento no pé da página empurra o texto para a página seguinte. Dê a esse elemento reserve: false (desde o postext 1.5): ele é pintado onde está ancorado e não reserva nada. Os elementos que acompanham a própria faixa (ancorados ao pé dela, ou com altura 'fill') nunca definem a altura dela. Aberturas desenhadas →
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 →
Erro comum
Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita
Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →
- A faixa tem altura fixa, enquanto o chapéu, o título e a linha fina pendem da margem superior e crescem para baixo, por isso uma linha fina mais longa ou um título de três linhas batem no fio. Limite as linhas finas a umas cinco linhas, como as duas edições fazem, ou calcule
BANDa partir da abertura mais longa. - A fórmula do
ydo número supõelineHeight: 1. A linha de base de um texto de design fica a 0,8 da altura da caixa de linha, e0.8 * NUMERALsó mede essa distância quando a caixa é tão alta quanto o corpo. Se você mudar a entrelinha ou a âncora, a fórmula tem que mudar junto.BEARINGé ajustado a olho, porque cada algarismo tem o próprio espaço lateral (aqui o 3 e o 4 terminam a 0,8 mm um do outro). - A paleta de um estilo muda a cor dos elementos de design e do texto. Uma imagem mantém as cores com que foi desenhada: a figura 4.1 é verde-azulada porque o código a desenha a partir de
band2, e uma figura terracota posta no capítulo 4 continuaria terracota. - Com
parity: 'odd', um capítulo que passa umas poucas linhas da última página deixa uma página quase vazia e um verso em branco antes da próxima abertura. Ajuste o texto, como as duas edições fazem aqui, e confira a última página de cada capítulo sempre que o texto ouBANDmudarem.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Roboto Serif (SIL OFL 1.1) · Archivo (SIL OFL 1.1) · Archivo Narrow (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)


