Pular para o conteúdo principal
Receita número 5

Receitas · Capítulo 4 · Cabeços e fólios

Cabeços pela paridade num livro de ensaios

Cabeços filtrados por paridade e tipo de página: o título do livro nas pares, o do ensaio cortado nas ímpares, fólios em abas na margem e um fólio ao pé.

Nesta página
Saída
Canvas
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.57.0
Licença
Atualizada em 22 de out. de 2026
Código MIT · Texto MIT

p. 30–31 · 2–3 de 5

  • Amostra em inglês: ainda sem edição em português
  • Refile 132 × 198 mm
  • 1 coluna
  • Baskervville 10,2/14
  • Alegreya SC
  • Libre Caslon Display
  • 5 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 63 ms
  • 174 linhas de código

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

script.js · linhas 67–95no código completo
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

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

script.js · linhas 14–26no código completo
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

script.js · linhas 31–48no código completo
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.

Página 30, par: aba, fio e título do livro, da margem externa para dentro.
Página 31, ímpar: o título do ensaio, cortado antes do fio e da aba na margem externa.

#3 · Espelhe as margens e conte linhas inteiras

script.js · linhas 52–63no código completo
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

script.js · linhas 99–121no código completo
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

script.js · linhas 139–147no código completo
  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

script.js · linhas 251–255no código completo
// 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

Sandbox
// ═══ 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 →

Verificação do Sandbox · headerFooterUnknownPlaceholder

Marcador desconhecido

Por quê. Um texto de design usa um marcador {name} que não existe e por isso é impresso literalmente.

Correção. Use um marcador aceito ({pageNumber}, {chapterTitle}, {title}, {attr.x}…) ou escreva {{ e }} para chaves literais. Docs →

Verificação do Sandbox · headerFooterMetadataMissing

Metadado do marcador ausente

Por quê. Um marcador como {author} ou {title} não tem valor nos metadados do documento e por isso sai vazio.

Correção. Acrescente o valor ao front matter, entre aspas, ou remova o marcador. 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 minWordSpacing de 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

Texto
Fontes
Baskervville (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1)
Sandbox