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

Receitas · Capítulo 5 · Estrutura do livro

Pós-textuais de tese: apêndice, glossário e índice

As últimas páginas de uma tese em preto e branco: apêndice com letra, glossário em duas colunas, referências APA e índice montado a partir de marcas no texto.

Nesta página

p. 174–175 · 4–5 de 7

  • Amostra em inglês: ainda sem edição em português
  • Refile 176 × 250 mm
  • 1 coluna
  • Libertinus Serif 11/14,6
  • Libertinus Sans
  • Libertinus Serif Display
  • 7 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 107 ms
  • 183 linhas de código

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

script.js · linhas 27–51no código completo
// '# 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

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

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

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

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

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

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

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

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)
SandboxPDF