Em poucas palavras
As últimas páginas de uma tese de doutorado, do capítulo final ao índice. O Postext monta o índice a partir de palavras marcadas no texto e preenche os números de página.
O que você vai compor
As sete últimas páginas de uma tese de doutorado sobre a leitura em tela e em papel, compostas numa página B5 em preto e branco. O capítulo 6, o apêndice A, o glossário, as referências e o índice abrem todos sob a mesma faixa preta de 62 mm de altura, com o título vazado em branco. O capítulo mostra o numeral na faixa, e o apêndice a letra; as seções pós-textuais trazem o antetítulo BACK MATTER e uma nota curta em itálico. O capítulo corre numa coluna justificada. O glossário e o índice passam para duas colunas alinhadas à esquerda, e as referências voltam para uma, com as linhas seguintes de cada entrada recuadas. O índice sai de marcas no texto: o motor ordena os termos sob as letras, acha a página de cada marca e junta as páginas seguidas em intervalos como 171–73. Os números em negrito remetem às definições do glossário.
Esta receita responde a
- Como componho uma bibliografia ou um glossário (recuo deslocado, corpo menor)?
- Como faço um índice remissivo cujos números de página mudem sozinhos quando o texto se move?
- Como evito que títulos, negritos e marcadores de lista saiam em azul?
- Como numero os títulos (1, 1.1, 1.1.1) e dou a cada nível um estilo diferente?
- 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 forço uma quebra de página ou de coluna e faço cada capítulo começar em página ímpar?
A resposta curta
// '# Glossary {style="glossary"}' in the Markdown picks a style. Each style starts a page
// of either parity, the appendix a recto (a style that sets no break inherits its level's
// 'odd': gotcha style-inherits-break), stays out of the chapter count (numbered: false, so
// its band has no numeral) and brings its own running heads; the glossary and the index
// set their pages in two columns until the next '#'. The appendix counts, in letters: its
// template prints the level's counter as A, B… config() takes both lists below.
const twoColumns = { layoutType: 'double', gutterWidth: mm(6) };
const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
const headingStyles = () => [
backMatter('appendix', { numbered: true, numberingTemplate: '{1:A}', header: appendixHeads,
breakBefore: { enabled: true, parity: 'odd' }, advancedDesign: opener('Appendix') }),
backMatter('glossary', { layout: twoColumns }),
backMatter('references'),
backMatter('index', { layout: twoColumns }),
];
// One paragraph per entry, in :::paragraphs{style="…"}: the turnover lines hang, so the
// first word of every entry stands clear at the left. Ragged, as APA asks of references,
// with every word whole (hyphenation.ragged is off). The index has its own settings.
const entries = (id, size, lead, hang, extra) => ({ id, fontSize: pt(size),
lineHeight: pt(lead), textAlign: 'left', hangingIndent: em(hang), ...extra });
const paragraphStyles = () => [
entries('term', 9.3, 12.4, 1), // the glossary: a bold term, then its definition
entries('reference', 9.3, 12.4, 1.5, { spaceBetween: pt(2.4) }),
];
Ingredientes
- Funcionalidades
- Geometria por seçãoBibliografias e glossáriosCapítulos sem númeroÍndice remissivoCabeços por seçãoEstilos de títuloTítulos numeradosCapítulos que abrem em página ímparFaixa de capítulo em largura totalAberturas desenhadasAtributos de títuloCabeços por tipo de páginaEstilos de parágrafoTipos de recurso personalizadosCitações que posicionam as figurasTabelas a partir de dadosEstilo de legendaPaleta de cores semânticaNegrito, itálico e suas coresExportação para PDF
- Também usa
- BoxesEquilíbrio de colunasFigura e Tabela no seu idiomaSair da grade de propósitoFontes incorporadas ao PDF
- Tipografia
- Libertinus Serif, Libertinus Serif Display, Libertinus Sans (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Dar a cada parte dos pós-textuais um estilo de título
O código é a resposta curta acima. # Glossary {style="glossary" note="…"} abre uma seção que vai até o próximo título de nível 1, e as páginas dela assumem a diagramação, os cabeços e a abertura do estilo (estilos de título); assim o glossário e o índice passam para duas colunas, enquanto as referências, cujo estilo não define diagramação, voltam à coluna única do documento. numbered: false deixa esses títulos fora da contagem de capítulos (sem ele, a faixa do glossário imprime 2), e cada estilo declara a quebra de página, porque um estilo que não declara nenhuma herda o 'odd' do capítulo e deixa páginas pares em branco. As entradas do glossário e das referências são parágrafos de um bloco :::paragraphs{style="…"} em 9,3 pt sobre 12,4 pt, contra os 11 sobre 14,6 do texto, com as linhas seguintes recuadas 1 em no glossário e 1,5 em nas referências (estilos de parágrafo).
#2 · Desenhar uma faixa para todas as aberturas
const SINK = 8; // lines reserved, 41.2 mm: 3.2 mm more than the band, and text on the grid
// Design text sets each baseline 0.8 of its line under the line's top, and a line is 1.2 × the
// size unless lineHeight says otherwise. In mm, a line's part above its baseline and below it:
const PT = 25.4 / 72;
const above = (size, lineHeight = 1.2) => 0.8 * size * lineHeight * PT;
const below = (size, lineHeight = 1.2) => 0.2 * size * lineHeight * PT;
const KICKER = 4.3, TITLE = BAND - TOP - 9.5; // mm under the text block's top: two baselines
// A bottom-aligned box that ends below() under a baseline sets its last line on it. The
// numeral's line is 0.72 of its size, so the line fits inside its box.
const text = (id, content, family, size, lineHeight, baseline, edge, w, extra) => ({
kind: 'text', id, content, fontFamily: family, fontSize: pt(size), lineHeight,
color: col('paper'), overflow: 'wrap', align: edge.endsWith('right') ? 'right' : 'left',
verticalAlign: 'bottom', ...extra, placement: { anchor: { to: 'container', edge },
size: { width: mm(w), height: mm(baseline + below(size, lineHeight)) } } });
// The mark is '{number}': the chapter's 6, the appendix's A, nothing on an unnumbered heading.
const opener = (label) => ({ enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') }, placement: {
anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(BAND) } } },
text('label', label, LABEL, 8, 1.2, KICKER, 'top-left', 80,
{ fontWeight: 700, letterSpacing: pt(1.6), textTransform: 'uppercase' }),
text('title', '{titleText}', DISPLAY, 34, 1.04, TITLE, 'top-left', 84),
text('mark', '{number}', DISPLAY, 118, 0.72, TITLE, 'top-right', 34),
text('note', '{attr.note}', TEXT, 8.6, 1.3, TITLE, 'top-right', 44, { italic: true }),
] } });
A marca é {number}: 6 no capítulo, A no apêndice e nada num título sem número. Um único design serve para os três, e as seções pós-textuais imprimem o {attr.note} onde ficaria o numeral. minHeight reserva oito linhas de 14,6 pt, 41,2 mm a partir do topo da mancha, o que deixa 3,2 mm de folga sob a faixa e mantém o texto na grade. O texto de design põe a linha de base a 0,8 da linha, por isso uma caixa alinhada embaixo cujo pé fica below() de uma linha de base assenta a última linha nessa linha de base. O título, o numeral de 118 pt e a última linha da nota se apoiam todos na linha de base do título, 52,5 mm abaixo do refile. A linha do numeral tem 0,72 do corpo dele, e assim cabe na caixa.
#3 · Tirar a letra do apêndice do estilo
// The style's '{1:A}' (see answer) prints the level's counter as a letter, and startAt=1 on the
// first appendix restarts it after chapter 6. The band and the running head read that letter.
// A resource template's {h1} is a number unless it names a style: '{h1:A}.{n}' counts the
// tables A.1, A.2… and B.1 in a second appendix, with one type for all of them.
const appendixHeads = heads('Appendix {chapterNumber}. {chapterTitle}');
const appendixTables = { ...defaultResourceTypes(LANG).find((type) => type.id === 'table'),
id: 'table-a', numberingTemplate: '{h1:A}.{n}', resetOn: 'h1' }; // a copy of 'table'
O estilo do apêndice define numberingTemplate: '{1:A}', que imprime o contador do nível como letra, e # Interview guide {style="appendix" startAt=1} reinicia esse contador, de modo que o primeiro apêndice é o A e não o G (estilos de título). A faixa lê a letra com {number} e o cabeço com {chapterNumber}. O {h1} de um tipo de recurso imprime o contador como número, a menos que indique um estilo, por isso as tabelas do apêndice usam um tipo com o modelo '{h1:A}.{n}': A.1, A.2 e assim por diante, e B.1 num segundo apêndice; com o tipo padrão, a tabela seria a Tabela 1.1. Os títulos do próprio capítulo contam a partir dos modelos de cada nível: '{1}.{2}' imprime 6.1, e continuation.headings.h1: 5 faz deste o sexto capítulo.
#4 · Pôr os cabeços na borda externa
const HEAD = 17.5, GAP = 9; // mm: the heads' baseline under the trim; the folio to the words
// Each text is placed by its top, above() over HEAD: the folio and the capitals share a baseline.
const head = (id, content, parity, edge, x, size = 7.5, extra) => ({ kind: 'text', id, content,
parity, pages: 'body', fontFamily: LABEL, fontSize: pt(size), fontWeight: 700,
letterSpacing: pt(1.3), textTransform: 'uppercase', color: col('ink'), ...extra, placement: {
anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD - above(size)) } } });
const folio = { fontFamily: TEXT, fontWeight: 400, letterSpacing: pt(0) };
const heads = (recto) => ({ elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, 9.5, folio),
head('verso', '{title}', 'even', 'top-left', OUTER + GAP),
head('recto', recto, 'odd', 'top-right', -(OUTER + GAP)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, 9.5, folio),
// The header's container spans the text block, so one rule serves both pages.
{ kind: 'rule', id: 'hairline', pages: 'body', direction: 'horizontal', thickness: pt(0.5),
color: col('rule'), placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: mm(HEAD + 2) }, size: { width: 'fill' } } },
] });
const chapterHeads = heads('Chapter {chapterNumber}. {chapterTitle}');
const sectionHeads = heads('{chapterTitle}'); // 'Glossary', 'References', 'Index'
// Openers drop the folio to the foot, centred under the text block, its baseline 12 mm below.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
pages: 'opener', ...folio, fontSize: pt(9.5), color: col('ink'), align: 'center',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(12 - above(9.5)) } } }] };
Os quatro elementos de texto são ancorados na página e filtrados por parity, o que mantém o fólio na borda externa das duas páginas; cada um é posicionado pelo topo, above() de uma linha de base 17,5 mm abaixo do refile, de modo que o fólio de 9,5 pt e as maiúsculas de 7,5 pt ficam na mesma linha. A página par traz o título da tese ({title}, do front matter) e a ímpar o da seção ({chapterTitle}), como INDEX na página 177. pages: 'body' os deixa fora das aberturas, cujo único fólio é o do rodapé, centralizado sob a mancha. A página ímpar do capítulo diria Chapter 6. Conclusion e a do apêndice Appendix A. Interview guide, mas nesta amostra só o índice continua numa página ímpar.
#5 · Marcar os termos onde o texto trata deles
// Glossary definitions carry 'main' (bold numbers); runs of pages join as 171–72 (Chicago).
// The heads stand on the entries' 11.6 pt pitch, 7.5 pt of space above them: 19 pt from the
// last entry of a letter to the next letter's baseline, 11.6 pt from a letter to its first entry.
const index = { fontFamily: TEXT, fontSize: pt(9), lineHeight: pt(11.6), color: col('ink'),
indent: em(1), turnoverIndent: em(2), rangeFormat: 'chicago',
groups: { fontFamily: DISPLAY, fontSize: pt(13), fontWeight: 400, color: col('ink'),
marginTop: pt(7.5) } };
:index[tablet] imprime a palavra e a registra sob ela mesma; Rayner:index{term="Rayner, Keith"} não imprime nada e registra a página de Rayner sob o nome completo; term="interviews!timing of" cria uma subentrada. Os termos do glossário levam main, por isso a página deles sai em negrito, como avisa a nota na faixa do índice. :::index sob # Index {style="index"} imprime as entradas nas duas colunas do estilo, e buildDocument diagrama o documento de novo até os números de página pararem de mudar. As entradas vão em 9 sobre 11,6 pt, com as linhas seguintes recuadas 2 em e as subentradas recuadas 1 em; as letras vão em 13 pt na fonte de títulos. As marcas não funcionam em células de tabela, por isso as linhas da Tabela 6.1 não acrescentam páginas: look-backs remete ao parágrafo que as relata, não à tabela.
#6 · Manter todos os padrões em tinta
const palette = { ink: '#000000', band: '#000000', rule: '#000000', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Bold, italic and list markers default to 'main-color': pointed at the ink, they print black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
Os padrões do motor para negrito, itálico, marcadores de lista e referências seguem a entrada main-color da paleta, de modo que apontá-la para a tinta os imprime em preto em vez de azul (paleta de cores). referenceBold: false compõe Table 6.1 em redondo, como as citações autor-data em volta dela.
A receita completa
// ═══ Postext Cookbook · Nº 031 · Thesis back matter: appendix, glossary and index ═══
// https://postext.dev/en/cookbook/thesis-back-matter
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Libertinus Serif, Serif Display and Sans (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import {
buildDocumentWithFonts, renderPageToCanvas, defaultResourceTypes,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en')
const RECIPE = 'thesis-back-matter';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one ink; every colour is black or white, each under its own name
const palette = { ink: '#000000', band: '#000000', rule: '#000000', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Bold, italic and list markers default to 'main-color': pointed at the ink, they print black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Libertinus Serif', DISPLAY = 'Libertinus Serif Display', LABEL = 'Libertinus Sans';
const TOP = 24, INNER = 25, OUTER = 31; // mm: a 120 mm measure, about 70 characters at 11 pt
const LEAD = 14.6; // pt: the body's leading, the grid every page is set on
const BAND = 62; // mm from the trim's top: the black band at the head of every opener
// #region answer: back matter as unnumbered heading styles, entries in hanging indents
// '# Glossary {style="glossary"}' in the Markdown picks a style. Each style starts a page
// of either parity, the appendix a recto (a style that sets no break inherits its level's
// 'odd': gotcha style-inherits-break), stays out of the chapter count (numbered: false, so
// its band has no numeral) and brings its own running heads; the glossary and the index
// set their pages in two columns until the next '#'. The appendix counts, in letters: its
// template prints the level's counter as A, B… config() takes both lists below.
const twoColumns = { layoutType: 'double', gutterWidth: mm(6) };
const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
const headingStyles = () => [
backMatter('appendix', { numbered: true, numberingTemplate: '{1:A}', header: appendixHeads,
breakBefore: { enabled: true, parity: 'odd' }, advancedDesign: opener('Appendix') }),
backMatter('glossary', { layout: twoColumns }),
backMatter('references'),
backMatter('index', { layout: twoColumns }),
];
// One paragraph per entry, in :::paragraphs{style="…"}: the turnover lines hang, so the
// first word of every entry stands clear at the left. Ragged, as APA asks of references,
// with every word whole (hyphenation.ragged is off). The index has its own settings.
const entries = (id, size, lead, hang, extra) => ({ id, fontSize: pt(size),
lineHeight: pt(lead), textAlign: 'left', hangingIndent: em(hang), ...extra });
const paragraphStyles = () => [
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
#Começar cada seção numa página ímpar
Teses encadernadas para biblioteca costumam abrir cada seção numa página da direita. O glossário, as referências e o índice passam então para as páginas 175, 177 e 179, cada um depois de uma página par em branco, e os números em negrito do índice apontam para a página 175.
-const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
- parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
+const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
+ parity: 'odd' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });#Compor também o começo da tese
Os pré-textuais, contados em algarismos romanos antes da página 1, estão em Pré-textuais com fólios romanos e depois a página 1.
Erros comuns
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
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 →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Libertinus Serif (SIL OFL 1.1) · Libertinus Serif Display (SIL OFL 1.1) · Libertinus Sans (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)


