Em poucas palavras
Quatro páginas de um velho dicionário de marinheiros. Abas com letras descem pela borda externa de cada página, e a aba da letra atual é escura e fica mais baixa à medida que o alfabeto avança.
O que você vai compor
Quatro páginas de uma nova edição do Sailor’s Word-Book do almirante Smyth (1867), letras A a C, numa página de 150 × 200 mm. Os verbetes correm em duas colunas justificadas de Alegreya de 8 pt separadas por um fio fino, cada lema em negrito azul-marinho e cada linha de continuação com recuo deslocado de 1 em. Uma letra abre dentro da coluna, como uma inicial azul-marinho de quatro linhas sobre um fio cor de latão, e os verbetes seguem sem quebra de página. No corte da frente, toda página imprime o índice de dedo inteiro, 22 abas num tom claro. A aba da letra atual é azul-marinho, 3,2 mm mais larga que as outras, e desce um degrau a cada letra. A edição em espanhol mantém os lemas em inglês de Smyth e traduz os verbetes.
Esta receita responde a
- Como acrescento um índice de dedo: uma aba no corte da frente que desce pela página de uma letra ou de um capítulo para o seguinte?
- Como componho uma bibliografia ou um glossário (recuo deslocado, corpo menor)?
- Como dou cor aos termos-chave (em negrito ou itálico) no texto ou dentro dos boxes?
- 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?
A resposta curta
// 22 tabs share the 44 lines of the text block, two lines each; letters with few words
// share a tab, as in most thumb-indexed dictionaries.
const TABS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'QR', 'S', 'T', 'UV', 'W', 'XYZ'];
const STEP = 2 * LEAD * PT; // mm: 7.34
const EDGE = { odd: 'top-right', even: 'top-left' }; // the fore-edge: right on a recto
// A cell of the index, `width` mm inside the trim and 3 mm past it, so that only its
// inner corners show their rounding; its label is centred on the part inside the trim.
const cell = (id, label, i, parity, width, fill, ink, size) => {
const y = mm(TOP + i * STEP + 0.3); // a 0.6 mm gap between neighbours
const at = (x, w) => ({ anchor: { to: 'page', edge: EDGE[parity] }, offset: { x: mm(x), y },
size: { width: mm(w), height: mm(STEP - 0.6) } });
return [
{ kind: 'box', id, parity, style: { backgroundColor: col(fill), borderRadius: mm(1.2) },
placement: at(parity === 'odd' ? 3 : -3, width + 3) },
{ kind: 'text', id: `${id}-label`, parity, content: label, fontFamily: LABEL, fontWeight: 700,
fontSize: pt(size), lineHeight: 1, color: col(ink), align: 'center',
verticalAlign: 'middle', placement: at(0, width) },
];
};
const sides = (make) => ['odd', 'even'].flatMap(make);
// Every page prints the whole index, pale, in the book's header (hook-up in config()).
const ladder = sides((p) => TABS.flatMap((label, i) =>
cell(`index-${i}-${p}`, label, i, p, 5.8, 'tint', 'slate', 7.5)));
// The section's own tab goes in its footer, which paints after the header: it lies over
// its pale cell. Elements anchored to 'page' can sit anywhere, whichever slot holds them.
const letterStyles = () => TABS.flatMap((label, i) => [...label].map((letter) => ({
id: letter,
// '# B {style="B"}' opens the section of B: its pages take this footer, and a page
// where A ends and B begins takes B's (gotcha: section-last-wins).
footer: { elements: [...footer.elements,
...sides((p) => cell(`tab-${p}`, label, i, p, 9, 'navy', 'paper', 8.5))] },
})));
Ingredientes
- Funcionalidades
- Faixas sangradas e guias lateraisCabeços por seçãoNegrito, itálico e suas coresEstilos de títuloAberturas desenhadasAncoragem de elementos de designImagens nos designs de páginaAtributos de títuloEstilos de parágrafoBibliografias e glossáriosCabeços por tipo de páginaCabeços e fóliosFio entre colunasEquilíbrio de colunasViúvas, órfãs e linhas curtasHifenização e idioma do documentoPaleta de cores semânticaCor do papelMargens espelhadasFiguras e tabelas como recursos
- Tipografia
- Alegreya, Alegreya SC, Alegreya Sans SC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Dê a cada letra um estilo de título com a sua aba
O código é a resposta curta lá em cima. TABS lista 22 abas, e as letras raras dividem uma (QR, UV, XYZ). Cada aba tem a altura de duas linhas do texto (7,34 mm), de modo que juntas preenchem as 44 linhas da mancha. O header do livro imprime em todas as páginas os cabeços e o índice claro. O laço dá a cada letra um estilo de título cujo footer acrescenta a aba azul-marinho daquela letra, um degrau abaixo da anterior (estilos de título). O rodapé é pintado depois do cabeçalho, então a aba fica por cima da sua célula clara, e a configuração guarda o índice uma vez só, não uma vez por letra. Cada célula é escrita duas vezes, uma por parity, e ancorada à borda externa da página, não ao contêiner do próprio slot. Esse contêiner é uma margem da largura da mancha, enquanto as abas precisam chegar ao corte da frente e descer pelas 44 linhas. Uma página recebe o rodapé da última seção que começa nela, por isso a página 2 começa no A e mostra a aba do B.
#2 · Tire os cabeços da primeira página
const HEAD = 11; // mm from the trim's top to the heads' top
const head = (id, content, parity, edge, x, extra) => ({ kind: 'text', id, content, parity,
pages: 'body', fontFamily: LABEL, fontSize: pt(8), fontWeight: 500, letterSpacing: pt(1),
color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD) } }, ...extra });
const folio = { fontWeight: 700, color: col('ink'), letterSpacing: pt(0) };
const runningHeads = [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
head('recto-letter', t({ en: 'Letter {chapterTitle}', es: 'Letra {chapterTitle}' }), 'odd',
'top-right', -(OUTER + 8)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
];
// The first page drops its folio to the foot, under the text block.
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'top', 0, {
...folio, pages: 'opener',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(6) } } })] };
Os cabeços são elementos de texto ancorados à página e filtrados por parity e pages: 'body' (elementos de texto). O título da página 1 ocupa as duas colunas, o que faz dela uma página de abertura. Os cabeços pulam essa página, e o fólio dela vem do rodapé, um elemento com pages: 'opener' que imprime 6 mm abaixo da mancha. Numa página ímpar, {chapterTitle} imprime a letra do último título de nível 1 que está na página ou antes dela, Letter C. {firstMark.<key>} e {lastMark.<key>} imprimem no lugar dela o primeiro e o último lema da página, as palavras-guia que a maioria dos dicionários traz; esta receita mantém a letra, que é o que as abas indexam.
#3 · Dê cor aos lemas e a nada mais
// Bold and italic default to the engine's blue: the body sets them to ink, and only the
// entry style prints its bold, the headwords, in navy.
const BODY = 8; // pt: a reference size, about 50 characters to the 60 mm column
const bodyText = { fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), firstLineIndent: mm(0),
minWordSpacing: 0.7, maxWordSpacing: 1.7,
maxJustifyTracking: 10, // up to 1 % of tracking before a line's spaces pass 1.7
hyphenateAcrossColumns: false, // no word is divided over a column or a page
maxRuntTracking: 0 }; // a short last line stays: tracking it away crushes a 60 mm line
const paragraphStyles = [
{ id: 'entry', hangingIndent: em(1), boldColor: col('navy') }, // :::paragraphs{style="entry"}
{ id: 'colophon', fontSize: pt(7), color: col('muted'), textAlign: 'center',
marginTop: pt(LEAD) },
];
Cada verbete é um parágrafo de um bloco :::paragraphs{style="entry"}, com as linhas de continuação em recuo deslocado de 1 em (estilos de parágrafo). O boldColor do texto corrido deixa o Note. da página 1 na cor da tinta, e o boldColor do estilo de verbete imprime os lemas em azul-marinho. Um estilo de parágrafo não tem italicColor, por isso os subverbetes em itálico ficam na cor do texto corrido.
#4 · Ponha uma inicial de quatro linhas na coluna
// Its cap line meets the first body line's and it stands on the fourth baseline. Cap
// heights measured on the glyph H: 0.652 em in Alegreya SC 900, 0.646 em in Alegreya.
const DROP = 4; // body lines the letter spans
const LETTER = ((DROP - 1) * LEAD + 0.646 * BODY) / 0.652; // pt: 55.8
// A design line sets its baseline 0.8 of its height below its top; a body line does too.
const letterHead = { enabled: true, slot: { elements: [
{ kind: 'text', id: 'letter', content: '{titleText}', fontFamily: DISPLAY, fontWeight: 900,
fontSize: pt(LETTER), lineHeight: 1, color: col('navy'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: pt((DROP - 0.2) * LEAD - 0.8 * LETTER) } } },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.6), color: col('brass'),
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: pt((DROP + 0.55) * LEAD) }, size: { width: 'fill' } } },
] } };
LETTER, 55,8 pt, é o corpo em que uma maiúscula da Alegreya SC 900 (0,652 em de altura) se apoia na quarta linha de base e alcança a altura das maiúsculas da primeira linha do texto. A letra e o fio cor de latão terminam dentro da quinta linha, e o bloco do título desce até a linha seguinte da grade, por isso cada inicial ocupa cinco linhas e os verbetes abaixo dela continuam na grade. Na página 3, o C no alto da segunda coluna fica alinhado com as quatro primeiras linhas da primeira coluna. O nível 1 define breakBefore: { enabled: false }, que desativa a quebra de página que um título de nível 1 tem por padrão, e os estilos das letras herdam esse valor, de modo que B e C começam no meio da coluna.
#5 · Estenda o título pelas duas colunas
const centred = (id, content, family, size, lineHeight, y, width, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), lineHeight, color: col('navy'), align: 'center',
overflow: 'wrap', ...extra, placement: { anchor: { to: 'container', edge: 'top' },
offset: { y: mm(y) }, size: { width: width ? mm(width) : 'fill' } } });
const rule = (id, y, thickness) => ({ kind: 'rule', id, direction: 'horizontal',
thickness: pt(thickness), color: col('navy'), placement: { anchor: { to: 'container',
edge: 'top-left' }, offset: { y: mm(y) }, size: { width: 'fill' } } });
const titleBand = { enabled: true, slot: { elements: [
{ kind: 'image', id: 'anchor', resourceId: 'anchor', placement: {
anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: mm(18) } } },
centred('name', '{titleText}', DISPLAY, 22, 1.1, 20, 0, { fontWeight: 900 }),
centred('subtitle', '{attr.subtitle}', TEXT, 9, 1.25, 29.5, 92, { italic: true,
color: col('ink') }),
centred('byline', '{attr.byline}', LABEL, 7, 1.2, 38.8, 0, { fontWeight: 500,
letterSpacing: pt(1.2), color: col('muted') }),
rule('thick', 43.6, 1.2),
rule('thin', 45, 0.4),
] } };
// '# The Sailor’s Word-Book {style="title" subtitle="…" byline="…"}' opens page 1.
const titleStyle = { id: 'title', span: 'page', advancedDesign: titleBand };
O estilo do título ocupa a largura da página com uma faixa que reúne a âncora, o nome, um subtítulo e uma linha de autoria lidos de atributos do título, e um fio duplo (span e design avançado). O fio fino termina 45,1 mm abaixo do alto da mancha, por isso a faixa se ajusta a 13 linhas da grade, ou 47,7 mm. O fio entre colunas começa abaixo da faixa, na linha em que começa o texto das duas colunas.
A receita completa
// ═══ Postext Cookbook · Nº 046 · Dictionary with a moving thumb index ═══════════════
// https://postext.dev/en/cookbook/dictionary-thumb-index
// Code: MIT · Text: W. H. Smyth, 1867 (PD); Spanish translation CC BY 4.0 · Pictures: code
// Fonts: Alegreya, Alegreya SC, Alegreya Sans SC (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'dictionary-thumb-index';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and navy on a warm paper, brass for the rules and the rope
const palette = {
ink: '#1b1f24', // text
navy: '#1f3a5f', // headwords, letters and tabs
brass: '#a4834f', // hairlines and the rope of the vignette
rule: '#cfccc3', // the column rule
tint: '#e4e9f0', // the pale cells of the index
slate: '#56657b', // their letters
muted: '#62666b', // running heads
paper: '#fbfaf6', // the page, and the letter reversed out of each tab
};
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' } }));
// #endregion
const TEXT = 'Alegreya', DISPLAY = 'Alegreya SC', LABEL = 'Alegreya Sans SC';
const PT = 25.4 / 72; // mm in a point
const LEAD = 10.4; // pt: the body's leading, the grid every column is set on
const LINES = 44; // lines in a full column
const TOP = 18, INNER = 12, OUTER = 14; // mm; the foot margin makes the block whole lines
const BOTTOM = 200 - TOP - LINES * LEAD * PT;
// #region answer: one heading style per letter, each with its tab one step down the fore-edge
// 22 tabs share the 44 lines of the text block, two lines each; letters with few words
// share a tab, as in most thumb-indexed dictionaries.
const TABS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
'QR', 'S', 'T', 'UV', 'W', 'XYZ'];
const STEP = 2 * LEAD * PT; // mm: 7.34
const EDGE = { odd: 'top-right', even: 'top-left' }; // the fore-edge: right on a recto
// A cell of the index, `width` mm inside the trim and 3 mm past it, so that only its
// inner corners show their rounding; its label is centred on the part inside the trim.
const cell = (id, label, i, parity, width, fill, ink, size) => {
const y = mm(TOP + i * STEP + 0.3); // a 0.6 mm gap between neighbours
const at = (x, w) => ({ anchor: { to: 'page', edge: EDGE[parity] }, offset: { x: mm(x), y },
size: { width: mm(w), height: mm(STEP - 0.6) } });
return [
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
#Imprima só a aba atual
Os índices de dedo impressos costumam mostrar só a aba da letra atual; tire ladder do cabeçalho e a aba azul-marinho continua descendo do A ao C.
- header: { elements: [...runningHeads, ...ladder] }, // the same on every page
+ header: { elements: [...runningHeads] }, // the same on every pageErros comuns
Erro comum
A página assume o cabeçalho da última seção que começa nela
Quando dois estilos de título começam na mesma página, ela assume o cabeçalho, o rodapé e a paleta do último. Uma página em branco de separação pertence ao capítulo anterior, e o preenchimento de paridade, ao seguinte. Cabeços por seção →
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
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
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 →
- Uma coluna de 60 mm comporta uns 50 caracteres, e o inglês de Smyth não pode ser reescrito. Compostas só com os espaços entre palavras, 18 das 218 linhas justificadas em inglês (8%) os esticavam além de 1,7 vez a largura normal, contra menos de 2% no espanhol, cuja tradução foi ajustada à coluna, e a primeira linha de Cross-trees nem chegava a encher a medida.
maxJustifyTracking: 10deixa uma linha tomar até 1% de espaçamento entre letras antes que os espaços passem desse limite: na captura, 25 das 217 linhas em inglês e 9 das 223 em espanhol levam algum, e nenhuma passa de 1,7. O inglês estava em 17% antes de os cinco verbetes que compunham pior (Aground, Aloft, Belay, Cockpit, Crow’s nest) serem trocados por outros. Escolha verbetes que componham bem, ou alargue a coluna.
Créditos
- Receita
- Ignacio Ferro
- Texto
- The Sailor’s Word-Book (London: Blackie and Son, 1867), entries from A, B and C · W. H. Smyth; Sir Edward Belcher · domínio público
- Spanish translation, editor’s note and colophon · Postext Cookbook · original
- Fontes
- Alegreya (SIL OFL 1.1) · Alegreya SC (SIL OFL 1.1) · Alegreya Sans 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)


