Em poucas palavras
Cinco páginas de um livrinho de ensaios. Mostra como imprimir o título do livro no alto das páginas da esquerda e o título do ensaio nas páginas da direita.
O que você vai compor
As páginas 29 a 33 de uma edição de bolso dos Ensaios de Montaigne na tradução inglesa de Charles Cotton: o capítulo IV inteiro e o começo do V. As pares levam o título do livro em maiúsculas espaçadas. As ímpares levam o título do ensaio em itálico, cortado com reticências, já que o do capítulo IV chega a 81 caracteres. Cada fólio fica numa aba sépia na margem externa, a 3 mm de um fio de 0,5 pt na borda da mancha. A abertura não tem cabeço, só um fólio ao pé. O texto vai em Baskervville sobre papel creme; os títulos, em Libre Caslon Display; os fólios e o título do livro, em Alegreya SC. Todos os cabeços são definidos na configuração, de modo que o cabeço padrão do motor, em Open Sans azul de 8 pt, nunca é impresso.
Esta receita responde a
- 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 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?
- Como evito que títulos, negritos e marcadores de lista saiam em azul?
A resposta curta
const GAP = 3; // mm from the tab to the divider, which lands on the text block's edge
const HEAD = 12; // mm from the top edge of the page to the top of the tab
const CAP = t({ en: 60.5, es: 66.8 }); // mm: the head's widest line, set per edition so
// essay IV's is cut after 'false' and 'objetos'; a short running title suits any title
const page = (edge) => ({ to: 'page', edge }); // the trim box (gotcha: negative-offsets)
const header = { elements: [
// Verso (even): tab | divider | THE BOOK'S TITLE from the frontmatter
folio({ id: 'folio-even', parity: 'even', pages: 'body', anchor: page('top-left'),
x: OUTER - GAP - TAB, y: HEAD }),
divider({ id: 'rule-even', parity: 'even', from: 'folio-even', edge: 'right-of', x: GAP }),
{ kind: 'text', id: 'book', content: '{title}', parity: 'even', pages: 'body',
fontFamily: 'Alegreya SC', fontSize: pt(FOLIO_PT), lineHeight: LINE / FOLIO_PT,
color: col('muted'), textTransform: 'uppercase', letterSpacing: pt(1.3),
placement: { anchor: { to: '#rule-even', edge: 'right-of' }, // top: the tab's top
offset: { x: mm(2.5), y: pt(PAD.top) } } }, // PAD.top down: on the folio's baseline
// Recto (odd): the essay's title, cut short with an ellipsis | divider | tab.
folio({ id: 'folio-odd', parity: 'odd', pages: 'body', anchor: page('top-right'),
x: -(OUTER - GAP - TAB), y: HEAD }), // from the right edge, a negative x runs inwards
divider({ id: 'rule-odd', parity: 'odd', from: 'folio-odd', edge: 'left-of', x: -GAP }),
{ kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
fontFamily: 'Baskervville', italic: true, fontSize: pt(TITLE_PT),
lineHeight: LINE / TITLE_PT, color: col('muted'),
overflow: 'ellipsis-end', // stated, though a running head's default
placement: { anchor: { to: '#rule-odd', edge: 'left-of' },
offset: { x: mm(-2.5), y: pt(PAD.top) }, size: { maxWidth: mm(CAP) } } },
] };
// Openers: no head, only a drop folio HEAD above the page's foot, centred under the text block.
const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };
Ingredientes
- Funcionalidades
- Cabeços e fóliosCabeços por tipo de páginaAncoragem de elementos de designTextos, fios e caixas nos designs de páginaAberturas desenhadasAtributos de títuloQuebras de linha nos títulosCapítulos que abrem em página ímparMargens espelhadasFormato da páginaCor do papelMetadados do documentoNegrito, itálico e suas coresPaleta de cores semânticaBoxesEstilos de parágrafoViúvas, órfãs e linhas curtasPáginas em um canvasLivros compostos capítulo a capítulo
- Também usa
- Faixa de capítulo em largura total
- Tipografia
- Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Substitua o cabeço azul embutido
const palette = {
ink: '#1f1b16', // text: a warm near-black, never #000
sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
// Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
// pointed at the sepia, none of them prints in the engine's blue.
{ id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];
Cada cor da configuração aponta para uma destas entradas. Se você deixar header sem definir, o motor desenha o cabeço padrão: {title} nas ímpares e {chapterTitle} nas pares, sobre um fio de 1 pt, em Open Sans 600 de 8 pt e no azul #295AA3 (cabeçalhos e rodapés). Apontar main-color para o sépia muda as cores padrão do texto e a daquele cabeço também, mas a fonte, o fio e o lado em que cada título sai continuam sendo os do motor. Por isso cada cabeço aqui é escrito por inteiro, com cada cor ligada a uma entrada da paleta. O negrito, o itálico e as referências também usam main-color por padrão, e bodyText os devolve à cor da tinta.
#2 · Todos os cabeços saem de uma aba
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
size: { height: pt(TAB_H) } },
});
A resposta curta ancora a aba de cada cabeço em 'page', de modo que os deslocamentos são medidos a partir do refile. A partir do canto top-right, um x positivo sai da página, e por isso a aba da ímpar recebe um valor negativo. O fio pende da aba, e o título, do fio (posicionamento de elementos). As medidas da aba ficam em constantes com nome porque as outras peças são medidas a partir delas. O fio tem TAB_H de altura. O fólio e os dois títulos dividem uma caixa de linha de 9 pt, e a linha de base de um texto de design fica a 80% da altura dessa caixa, por isso os três ficam sobre a mesma linha de base em qualquer corpo.


#3 · Espelhe as margens e conte linhas inteiras
const TRIM = { width: 132, height: 198 }; // mm
const TOP = 22; // mm: the top margin, which holds the heads (gotcha: header-paints-over-text)
const INNER = 15; // mm
const OUTER = 21; // mm: the outer margin, where the folio tabs hang
const LINES = 31; // whole lines of LEAD in the text block, so full pages end level
const MEASURE = TRIM.width - INNER - OUTER; // the text block's width: 96 mm
const geometry = { // left is the inner margin on a recto; mirror swaps it on the versos
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, // 150 dpi is for the screen
backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - (LINES * LEAD * 25.4) / 72),
left: mm(INNER), right: mm(OUTER), mirror: true },
};
Com mirror: true, a margem right é a externa na página ímpar e passa para a esquerda na par, por isso OUTER é sempre a margem do corte da frente, onde ficam as abas. A margem inferior sai do refile, da margem superior e de LINES, o que mantém a mancha com exatamente LINES linhas de LEAD (aqui, 31 × 14 pt), qualquer que seja o refile ou a margem superior. Toda página cheia termina na 31ª linha, e por isso páginas que se defrontam, como a 30 e a 31, terminam na mesma altura.
#4 · Deixe a abertura mostrar o título inteiro
const PLATE = 26; // mm: a square plate at the head of the text block
const opener = {
enabled: true,
minHeight: mm(58), // the text of every essay starts on the same line
slot: { elements: [
{ kind: 'box', id: 'plate', style: { backgroundColor: col('sepia') },
placement: { anchor: { to: 'container', edge: 'top-left' },
size: { width: mm(PLATE), height: mm(PLATE) } } },
{ kind: 'text', id: 'numeral', content: '{attr.num}', fontFamily: 'Libre Caslon Display',
fontSize: pt(48), lineHeight: 1, color: col('paper'),
placement: { anchor: { to: '#plate', edge: 'align-top' }, // the plate's own box, where
size: { width: mm(PLATE), height: mm(PLATE) } } }, // the text centres by default
{ kind: 'text', id: 'book', content: '{subtitle}', fontFamily: 'Alegreya SC',
fontSize: pt(8.5), letterSpacing: pt(1.4), color: col('sepia'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(PLATE + 4.5), y: mm(PLATE - 2.9) } } }, // its baseline on the plate's foot
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Libre Caslon Display',
fontSize: pt(20), lineHeight: 1.12, color: col('ink'), align: 'left',
overflow: 'wrap', // an opener shows the whole title; the running head cuts it
placement: { anchor: { to: '#plate', edge: 'below' }, offset: { y: mm(6) },
size: { width: mm(MEASURE) } } },
] },
};
A abertura compõe o título completo com overflow: 'wrap' e o quebra em cada \\ da linha do título. Só uma abertura de página inteira respeita essas quebras, e daí o span: 'page' do nível (quebras de linha nos títulos). No cabeço, {chapterTitle} sempre dá o título numa linha só, e as reticências cortam essa linha. O numeral vem do atributo {num="IV"} do título, e os versaletes ao lado da placa vêm do subtitle do front matter.
#5 · Abra cada ensaio numa página ímpar
headings: { // 400, the face's only weight: the default 700 would ask for one that is missing
fontFamily: 'Libre Caslon Display', fontWeight: 400, color: col('ink'),
levels: [
// 'odd' puts every opener on a recto, adding a blank verso when one is needed;
// span: 'page' makes the design an opener, where a \\ in the title breaks the line.
{ level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener },
],
},
Com 'odd', um ensaio que termina numa ímpar é seguido por uma página par em branco. A edição espanhola tem uma, porque lá o capítulo IV termina na página 31; aqui o capítulo IV termina na página 32, uma par, e o capítulo V abre na 33. O pages: 'body' dos cabeços os mantém fora das páginas em branco e das aberturas (as páginas cujo primeiro bloco é este título). O pages: 'opener' do rodapé imprime o fólio ao pé só nas aberturas (elementos de texto).
#6 · Comece os fólios em 29
// 28 pages come before this one, so recto and verso, the mirrored margins and the odd/even
// heads follow the book page (gotcha: parity-page1-recto); the folios start at 29.
const continuation = { pageIndexOffset: 28, pageNumbering: { startAt: 29 } };
const doc = await buildDocumentWithFonts({ markdown, continuation }, config(), kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Running heads by parity', es: 'Cabeceras según la paridad' }) });
parity segue o lugar da página no livro e ignora o fólio. pageIndexOffset: 28 soma 28 ao índice de cada página, de modo que ímpar e par, as margens espelhadas e os cabeços de cada lado acompanham a página do livro. Depois, pageNumbering.startAt numera estas páginas de 29 a 33. Sem o deslocamento, a primeira página do build é ímpar, seja qual for o fólio que imprime. Com a página 29 isso calha de dar certo, mas com startAt: 30 o título do livro cairia na página 31 e o do ensaio na 32, cada um do lado errado da página dupla.
A receita completa
// ═══ Postext Cookbook · Nº 005 · Running heads by parity ═══════════════════════════════
// https://postext.dev/en/cookbook/running-heads-by-parity
// Code: MIT · Text: Montaigne, tr. Cotton (PD, Gutenberg #3600); es: new translation (MIT)
// Fonts: Baskervville, Libre Caslon Display, Alegreya SC (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// Pages 29 to 33 of a pocket Montaigne. Versos carry the book's title and rectos the essay's,
// the folios sit in tabs in the outer margin, and an opener prints only a folio at the foot.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'running-heads-by-parity';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: four colours with semantic ids; main-color points at the sepia
const palette = {
ink: '#1f1b16', // text: a warm near-black, never #000
sepia: '#8a5a2b', // the one accent: folio tabs, dividers, opener plates (5.3:1 on paper)
muted: '#6f6558', // running heads, verse glosses, the colophon (5.2:1 on paper)
paper: '#f8f4ec', // a warm off-white page; also the type reversed out of the sepia
};
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' } })),
// Text-style defaults (headings, bold, italic, lists, boxes) link to 'main-color':
// pointed at the sepia, none of them prints in the engine's blue.
{ id: 'main-color', name: 'sepia (defaults)', value: { hex: palette.sepia, model: 'hex' } },
];
// #endregion
const LEAD = 14; // pt: the body leading, the pitch of the baseline grid
// #region tab: the folio tab and its divider, the two pieces every head is built from
const FOLIO_PT = 7.5; // pt: the folio, and the book's title in capitals beside it
const TITLE_PT = 8.8; // pt: the essay's title, whose italic lowercase reads small at 7.5
const LINE = FOLIO_PT * 1.2; // pt: the folio and both titles share this line box and baseline
const PAD = { top: 1, bottom: 1.4 }; // pt: 0.4 pt more below for the descending 3, 5, 7, 9
const TAB = 7.5; // mm: the tab's width
const TAB_H = LINE + PAD.top + PAD.bottom; // pt: the tab's height, which the divider matches
const folio = ({ id, parity, pages, anchor, x = 0, y }) => ({
kind: 'text', id, content: '{pageNumber}', parity, pages, fontFamily: 'Alegreya SC',
fontSize: pt(FOLIO_PT), fontWeight: 700, lineHeight: LINE / FOLIO_PT, color: col('paper'),
box: { backgroundColor: col('sepia'), borderRadius: mm(2), // a pill; the number is centred
padding: { top: pt(PAD.top), bottom: pt(PAD.bottom) } }, // by default in both directions
placement: { anchor, offset: { x: mm(x), y: mm(y) }, size: { width: mm(TAB) } },
});
const divider = ({ id, parity, from, edge, x }) => ({
kind: 'rule', id, parity, pages: 'body', direction: 'vertical', thickness: pt(0.5),
color: col('sepia'), placement: { anchor: { to: `#${from}`, edge }, offset: { x: mm(x) },
size: { height: pt(TAB_H) } },
});
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
#Dê aos títulos longos um título corrente curto
Escreva o texto do cabeço na linha do título, {num="IV" short="Of false objects"}, e imprima o atributo no lugar do título inteiro; um capítulo sem short não imprime nada ali.
- { kind: 'text', id: 'essay', content: '{chapterTitle}', parity: 'odd', pages: 'body',
+ { kind: 'text', id: 'essay', content: '{attr.short}', parity: 'odd', pages: 'body',#Deixe os ensaios abrirem em qualquer lado
Com 'any', o ensaio começa na página seguinte, par ou ímpar, e nunca se acrescenta uma página em branco. A placa pende do canto superior esquerdo da mancha e o fólio ao pé fica centralizado embaixo dela, de modo que os dois ficam do mesmo jeito numa par e numa ímpar.
- { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+ { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },#Pinte a página par em branco com a cor de destaque
Uma caixa com pages: 'blank' só é impressa nas páginas que a quebra para ímpar acrescenta: na edição espanhola ela enche a página 32 de sépia, e a edição inglesa, que não tem página em branco, não muda.
const footer = { elements: [folio({ id: 'drop-folio', parity: 'all', pages: 'opener',
- anchor: { to: 'container', edge: 'bottom' }, y: -HEAD })] };
+ anchor: { to: 'container', edge: 'bottom' }, y: -HEAD }),
+ { kind: 'box', id: 'blank-leaf', pages: 'blank', style: { backgroundColor: col('sepia') },
+ placement: { anchor: page('top-left'),
+ size: { width: mm(TRIM.width), height: mm(TRIM.height) } } }] };Erros comuns
Erro comum
Deslocamentos negativos relativos ao contêiner não pintam nada
O texto de design com largura automática fica limitado ao seu contêiner, então um deslocamento negativo em relação ao contêiner o empurra para fora e nada é pintado. Ancore esses elementos na página ou na sangria com deslocamentos explícitos em mm, ou dê a eles uma largura fixa. Ancoragem de elementos de design →
Erro comum
Os elementos de cabeçalho e rodapé são pintados sobre o texto
Os elementos de cabeçalho e rodapé são pintados por cima da página, e a área de texto não abre espaço para eles. Mantenha esses elementos dentro das margens, que são o que reserva o espaço deles. Cabeços e fólios →
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 →
Aviso de diagramação · designTextTruncated
Texto de design cortado
Por quê. Um elemento de texto de um design (um cabeço, um fólio, uma abertura de capítulo, uma página de parte, uma linha de parte do sumário) era mais largo que o espaço disponível e perdeu parte de uma linha: foi cortado com reticências, como pede o overflow dele, ou recortado com tinta além da caixa com overflow: 'clip'. Cabeços, fólios e linhas de parte do sumário terminam em reticências por padrão; designs de título e de parte quebram linha a menos que o elemento indique outra coisa. Para um cabeço cortado em todas as páginas de um capítulo, o aviso aparece uma só vez.
Correção. Defina overflow: 'wrap' no elemento para dividir o texto em mais linhas, dê-lhe mais espaço (um size.width ou maxWidth maior, um fontSize menor, um letterSpacing mais apertado) ou encurte o texto. Mantenha as reticências onde o design é uma só linha, como num cabeço; o aviso então só confirma o que foi cortado. Docs →
CAPé definido em cada edição para o título do ensaio IV, o único que um cabeço mostra aqui. As reticências vêm depois da última palavra inteira que cabe, e essa palavra pode ser uma preposição: com 64 mm o cabeço da edição espanhola terminaria em “…sus pasiones sobre…”. Um livro de títulos longos precisa do cabeço curto das Variações.- Na edição inglesa, subir
minWordSpacingde 0,7 para 0,75 deixa a primeira linha do ensaio V (“Quintus Marcius, the Roman legate…”) sem nenhum ponto de quebra dentro da faixa, e os espaços entre palavras se abrem até 2,4 vezes a largura normal. A edição espanhola não tem essa linha. Depois de qualquer mudança, confira as linhas mais frouxas que a captura lista.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Essays, Book I, chapters IV and V, in Charles Cotton’s translation edited by William Carew Hazlitt (1877) · Michel de Montaigne; Charles Cotton; William Carew Hazlitt · domínio público
- Essais, livre I, chapitres IV et V: the 1595 French text in the Général Michaud edition (Firmin-Didot, 1907) · Michel de Montaigne · domínio público
- Spanish translation, with its verse glosses · Postext Cookbook · original
- Fontes
- Baskervville (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Alegreya 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)

