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

Receitas · Capítulo 5 · Estrutura do livro

Um índice onomástico e um índice de assuntos

Marcas com index="names" alimentam um índice de pessoas e as demais um de assuntos; :::index imprime cada um em duas colunas e a montagem acerta as páginas.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 155 × 235 mm
  • 1 coluna
  • Crimson Pro 10,6/13,6
  • Bodoni Moda
  • Libre Franklin
  • 7 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 127 ms
  • 142 linhas de código

Em poucas palavras

Um capítulo de um livro acadêmico sobre a história dos tipos de impressão. Mostra como montar duas listas no fim do livro, uma de pessoas e outra de temas, com a página em que cada um aparece.

O que você vai compor

O capítulo quatro de Letters of Metal, uma monografia acadêmica sobre tipos de impressão composta em 155 × 235 mm: uma coluna de Crimson Pro, Bodoni itálico nos títulos, um destaque vermelho-tijolo. O ensaio vai da textura de Gutenberg aos modernos de Bodoni, passando por Jenson, Aldo e Griffo, Garamond e Plantin, Caslon e Baskerville, os pontos de Fournier e os tipos espanhóis que Pradell e Gil abriram e Ibarra imprimiu. Termina como esses livros terminam, com dois índices em páginas frente a frente: impressores, gravadores de punções e mecenas na página par; tipos, ferramentas e livros na ímpar. Os dois saem do mesmo texto marcado, e cada número de página neles é a página em que a marca caiu.

Esta receita responde a

  • Como imprimo dois índices, um onomástico e outro de assuntos, a partir do mesmo texto marcado?
  • Como faço um índice remissivo cujos números de página mudem sozinhos quando o texto se move?

A resposta curta

script.js · linhas 35–57no código completo
// Marks in the Markdown. A person goes to the names index, inverted:
//   :index[Aldus Manutius]{term="Manutius, Aldus" index="names" main}
// A subject goes to the main index, with levels split by "!" and a sort key when the
// printed form would file in the wrong place:
//   :index[textura]{term="Blackletter!textura" main}
//   :index{term="42-line Bible" sort="Forty-two-line Bible"}
//   :index{term="Cursive" see="Italic"}
// Printed at the end, each under its own heading:
//   # Index of Names {style="index"}    then    :::index{index="names"}
//   # Index of Subjects {style="index"} then    :::index
const indexHeading = {
  id: 'index',
  numbered: false, // no chapter number, and the next chapter is still chapter 5
  breakBefore: { enabled: true, parity: 'any' },
  layout: { layoutType: 'double', gutterWidth: mm(7) }, // the section after the heading
};
const index = {
  fontSize: pt(8.6), lineHeight: pt(11.2), // one leading for entries and letter heads
  indent: em(1), turnoverIndent: em(2),
  rangeFormat: 'chicago', // 212–14, as a monograph prints it
  main: { bold: true }, // the page of the principal discussion
  groups: { fontFamily: 'Bodoni Moda', fontSize: pt(11), fontWeight: 600, color: col('brick') },
};

Ingredientes

Tipografia
Crimson Pro, Bodoni Moda, Libre Franklin (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Marcar cada pessoa para o índice onomástico e cada assunto para o principal

O código é a resposta curta acima; o resto está no Markdown. Uma marca com index="names" vai para o índice que :::index{index="names"} imprime, e todas as outras vão para o índice principal, o que um :::index sem atributos imprime. Assim, :index[Aldus Manutius]{term="Manutius, Aldus" index="names" main} imprime o nome no texto e registra uma página em negrito sob Manutius no índice onomástico, enquanto :index[italic]{term="Italic" main}, duas linhas adiante, registra a mesma página sob Italic no de assuntos. Uma pessoa que também é assunto do capítulo pode levar as duas marcas.

#2 · Inverter os nomes e ordenar pela letra em que o leitor vai procurar

Os nomes entram com o sobrenome primeiro: term="Garamond, Claude", term="Dall’Aglio, Margherita". A vírgula faz parte do termo, e por isso a ordenação põe Didot, Firmin antes de Didot, François-Ambroise, como faria um indexador. Quando a forma impressa cairia na letra errada, sort dá a chave: a edição inglesa marca term="42-line Bible" sort="Forty-two-line Bible", e assim a Bíblia fica sob a letra F em vez de abrir um grupo 0–9. Subentradas (term="Foundries!Plantin-Moretus"), páginas principais em negrito (main), range="start" e range="end" em volta da seção sobre Bodoni e remissões (see="Italic", seealso="Matrices") fazem o resto; um destino de see com níveis é impresso com dois-pontos, como em Humanist type. See Roman type: Venetian.

#3 · Montar uma vez; o documento acerta os próprios números

script.js · linhas 217–220no código completo
// A pass finds the page of every mark and prints both indexes with those numbers. When the
// printed index moves a mark (an index set before the text would), the layout runs again,
// until no page number changes (in a buildBundle book, the chapter with :::index gets them all).
const doc = await buildDocumentWithFonts({ markdown }, config(), kitFonts(FONTS));

O índice imprime números de página que só existem depois da diagramação, e imprimi-lo ocupa páginas. buildDocument() resolve isso: diagrama o capítulo, lê a página de cada marca, imprime os dois índices e diagrama de novo sempre que um número muda. Aqui os índices vêm depois do texto, por isso uma segunda passada confirma a primeira; um índice posto antes do texto deslocaria todas as páginas seguintes, e as passadas continuariam até concordarem. Acrescente um parágrafo à seção sobre Bodoni e o índice onomástico dá a Whittingham a nova página sozinho.

#4 · Dar a cada índice uma abertura sobre duas colunas

script.js · linhas 61–75no código completo
const opener = (sink, size) => ({
  enabled: true,
  minHeight: pt(LEAD * sink), // the text starts on the same grid line in every chapter
  slot: { elements: [
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, fontSize: pt(7.8),
      letterSpacing: pt(1.6), color: col('brick'), align: 'left',
      placement: at('container', 'top-left', 0, 10) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Bodoni Moda', italic: true,
      fontSize: pt(size), lineHeight: 1.08, color: col('ink'), align: 'left',
      overflow: 'wrap', // design text ends in an ellipsis by default
      placement: { ...at('#kicker', 'below', 0, 3), size: { width: 'fill', height: 'auto' } } },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('brick'),
      placement: { ...at('#title', 'below', 0, 4.5), size: { width: mm(16) } } },
  ] },
});

O estilo de título da resposta curta faz três coisas por # Index of Names {style="index"}: abre uma página (parity: 'any', para que os dois índices venham um depois do outro sem página em branco), compõe em duas colunas separadas por 7 mm a seção que vem depois dele e, com numbered: false, não mexe na contagem de capítulos. O estilo reaproveita a abertura de capítulo com um rebaixamento de seis linhas e um título de 20 pt, e as letras de grupo repetem o Bodoni dela na cor de destaque, com a altura de uma linha do índice, para que as colunas mantenham o passo.

#5 · Pôr o nome do índice na página ímpar

script.js · linhas 79–96no código completo
const head = (id, content, parity, edge, x, extra = {}) => ({
  kind: 'text', id, content, parity, pages: 'body', // never on openers
  ...label, fontSize: pt(7.2), letterSpacing: pt(1.3), color: col('muted'),
  placement: at('page', edge, x, 12.5), ...extra,
});
const folio = { color: col('brick'), fontWeight: 700 };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', MARGIN.outer,
    { ...folio, align: 'left' }),
  head('verso-title', '{title}', 'even', 'top-left', MARGIN.outer + 8, { align: 'left' }),
  head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(MARGIN.outer + 8),
    { align: 'right' }),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -MARGIN.outer,
    { ...folio, align: 'right' }),
] };
// Openers carry a drop folio instead, centred under the text block.
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all', 'bottom', 0,
  { ...folio, align: 'center', placement: at('page', 'bottom', 0, -12) }), pages: 'opener' }] };

O cabeço da página ímpar imprime {chapterTitle}, e o título de um índice é de nível um como o de qualquer capítulo, por isso as páginas seguintes trazem Index of Subjects no alto. pages: 'body' tira os cabeços das duas aberturas de índice, que levam um fólio no pé.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 073 · An index of names and an index of subjects ═══════
// https://postext.dev/en/cookbook/names-and-subjects-indexes
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Crimson Pro, Bodoni Moda, Libre Franklin (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import { buildDocumentWithFonts, renderPageToCanvas } 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' | 'es')
const RECIPE = 'names-and-subjects-indexes';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a warm black, one brick red for kickers, letter heads and folios
const palette = {
  ink: '#211d19', // text: a warm near-black
  brick: '#8e3b24', // the one accent
  muted: '#6d645a', // running heads, colophon
  rule: '#c8bba9', // hairlines
  paper: '#fcfaf5',
};
// A colour is its hex and the palette entry it follows.
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 accent, never the default blue.
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.brick, model: 'hex' } },
];
// #endregion
const TRIM = { width: 155, height: 235 }; // a scholarly monograph
const MARGIN = { top: 22, bottom: 24, inner: 19, outer: 22 }; // mirrored: 114 mm measure
const LEAD = 13.6; // body leading in pt
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const label = { fontFamily: 'Libre Franklin', fontWeight: 600, textTransform: 'uppercase' };

// #region answer: two indexes from one text, each under a two-column heading style
// Marks in the Markdown. A person goes to the names index, inverted:
//   :index[Aldus Manutius]{term="Manutius, Aldus" index="names" main}
// A subject goes to the main index, with levels split by "!" and a sort key when the
// printed form would file in the wrong place:
//   :index[textura]{term="Blackletter!textura" main}
//   :index{term="42-line Bible" sort="Forty-two-line Bible"}
//   :index{term="Cursive" see="Italic"}
// Printed at the end, each under its own heading:
//   # Index of Names {style="index"}    then    :::index{index="names"}
//   # Index of Subjects {style="index"} then    :::index
const indexHeading = {
  id: 'index',
  numbered: false, // no chapter number, and the next chapter is still chapter 5
  breakBefore: { enabled: true, parity: 'any' },

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

#Imprimir um índice único

Tire index="names" das marcas de pessoas e o segundo título: todas as marcas vão então para o índice principal, nomes e assuntos num só alfabeto.

-:index[Aldus Manutius]{term="Manutius, Aldus" index="names" main}
+:index[Aldus Manutius]{term="Manutius, Aldus" main}

#Tirar as letras de grupo

Um índice onomástico curto como este se lê bem sem elas. groups.enabled: false remove as letras e deixa uma linha de espaço entre um grupo e outro; a configuração vale para os dois índices.

-  groups: { fontFamily: 'Bodoni Moda', fontSize: pt(11), fontWeight: 600, color: col('brick') },
+  groups: { enabled: false },

Erros comuns

  • A configuração index é compartilhada: os dois índices usam a mesma fonte, a mesma entrelinha e as mesmas letras de grupo.
  • Uma marca numa legenda ou numa célula de tabela é impressa como foi escrita. Marque a pessoa no parágrafo que cita a figura.

Créditos

Texto
  • “From Textura to Bodoni”, an essay on the history of printing types written for this recipe, in English and Spanish · Ignacio Ferro · CC BY 4.0
Fontes
Crimson Pro (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1)
SandboxPDF