Em poucas palavras
Um capítulo de um manual de campo para equipes que cuidam de trilhas, sobre como tirar a água dos caminhos. Mostra como dar sete níveis aos títulos, cada um com cara própria, para o leitor ver como as partes se encaixam.
O que você vai compor
O capítulo 1 do manual de campo de uma equipe de trilhas, Drainage, em três páginas B5 a duas colunas: IBM Plex Serif no texto, IBM Plex Sans Condensed nos títulos e nos números de seção, IBM Plex Mono nos rótulos, nos fólios e nos números de subseção. A abertura põe o número do capítulo numa pílula âmbar grande sobre o perfil altimétrico de uma trilha, onde pontos âmbar marcam doze locais escolhidos para novos desviadores de água. Pílulas menores numeram as seções 1.1 a 1.12 e ficam mais largas no 1.10. Os títulos 1.2.1, 1.5.1 e 1.5.2 vão em maiúsculas espaçadas sob um fio verde. Os níveis 4 a 6 não têm número e mudam de letra (itálico serifado, condensado negrito em verde, maiúsculas monoespaçadas), e um sétimo nível em itálico cinza nomeia as ferramentas. As regras de segurança começam com termos corridos em verde. Um checklist sem número, marcado por um quadrado vazado, fecha o capítulo com listas numeradas 1., a) e i. e duas caixas de tarefa.
Esta receita responde a
- Como numero os títulos (1, 1.1, 1.1.1) e dou a cada nível um estilo diferente?
- Como faço um selo com o número ao lado do título que se alarga quando o número cresce (9 → 10)?
- O que faço se preciso de mais de seis níveis de título?
- Como personalizo listas: marcadores por nível, numeração (a)/(i), caixas de seleção de tarefas e um espaçamento que fique na grade?
A resposta curta
const H2 = 13.5; // pt: the number and the title share one size and one line height,
const LH = 1.2; // so, under the same top padding, they share one baseline
// Every section head starts on a grid line, so the 3 pt the pill falls short of two lines
// is the gap the grid snap leaves between the pill and the text under it.
const PILL_H = 2 * LEAD - 3, PAD = (PILL_H - H2 * LH) / 2; // pt
const face = { fontFamily: DISPLAY, fontWeight: 700, fontSize: pt(H2), lineHeight: LH };
const pill = { kind: 'text', id: 'pill', content: '{number}', ...face, color: col('ink'),
box: { backgroundColor: col('signal'), borderRadius: mm(3), // no width: the pill is its
padding: { top: pt(PAD), bottom: pt(PAD), left: mm(1.8), right: mm(1.8) } }, // number
placement: at('container', 'top-left') }; // plus its padding
// 'right-of' hangs the title on the pill's right edge and aligns its lines left, so a long
// title wraps beside the number, never under it.
const sectionTitle = (from) => ({ kind: 'text', id: 'title', content: '{titleText}', ...face,
color: col('ink'), overflow: 'wrap', box: { padding: { top: pt(PAD) } },
placement: at(`#${from}`, 'right-of', mm(2.2)) });
// The H1 counter, a point, the H2 counter: 1.1 … 1.12 in the pill. h2 joins headings.levels.
const h2 = { level: 2, numberingTemplate: '{1}.{2}',
advancedDesign: { enabled: true, slot: { elements: [pill, sectionTitle('pill')] } } };
Ingredientes
- Funcionalidades
- Títulos numeradosTextos, fios e caixas nos designs de páginaAncoragem de elementos de designNíveis de títuloEstilos de títuloCapítulos sem númeroAberturas desenhadasImagens nos designs de páginaAtributos de títuloEstilos de parágrafoNegrito, itálico e suas coresListas com marcadores e de verificaçãoListas numeradasGrade de linhas de baseViúvas, órfãs e linhas curtasCabeços e fóliosCabeços por tipo de páginaMargens espelhadasPaleta de cores semânticaFiguras e tabelas como recursos
- Também usa
- Faixa de capítulo em largura total
- Tipografia
- IBM Plex Serif, IBM Plex Sans Condensed, IBM Plex Mono (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Ponha o número numa pílula que cresce com ele
O código está na resposta curta lá em cima. numberingTemplate: '{1}.{2}' junta os contadores do capítulo e da seção em 1.1 a 1.12 (ajustes por nível). Um nível com design avançado deixa de imprimir o número antes do título, por isso o próprio design posiciona {number}. Aqui ele fica num elemento de texto com uma box preenchida, de cantos arredondados e sem largura, de modo que a pílula tem a largura do número mais o preenchimento: 10,1 mm no 1.9 e 12,7 mm no 1.10. 'right-of' pendura o título na borda direita da pílula e alinha as linhas à esquerda, e é por isso que o título longo da 1.5 quebra ao lado do número (posicionamento de elementos). A pílula tem 3 pt a menos que duas linhas da grade, e todo título de seção começa numa linha da grade, por isso esses 3 pt são o espaço entre a pílula e o texto embaixo dela, quer o título abra uma coluna, quer venha depois de um parágrafo.

#2 · Dê fio e espaçamento ao terceiro nível
// A rule, a mono number and a tracked title: three elements, so this head is a design.
const small = { fontSize: pt(8.4), lineHeight: LH };
const DROP = 6; // pt: the rule drops this far toward the number, which keeps its grid line
const h3 = { level: 3, numberingTemplate: '{1}.{2}.{3}', // 1.5.1: restarts under every H2
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('band'),
placement: { ...at('container', 'top-left', mm(0), pt(DROP)), size: { width: 'fill' } } },
{ kind: 'text', id: 'num', content: '{number}', fontFamily: LABEL, fontWeight: 500, ...small,
color: col('band'), placement: at('#rule', 'below', mm(0), pt(LEAD - DROP)) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontWeight: 600,
...small, letterSpacing: pt(1.35), textTransform: 'uppercase', color: col('ink'),
overflow: 'wrap', placement: at('#num', 'right-of', mm(2)) },
] } } };
O nível 3 também é desenhado por um design: um fio verde de 0,75 pt, o número em IBM Plex Mono e, ao lado, o título espaçado. O terceiro contador de '{1}.{2}.{3}' recomeça em cada seção, por isso 1.2.1 e 1.5.1 terminam os dois em 1. DROP baixa só o fio. O número fica LEAD - DROP abaixo dele, o que mantém número e título uma linha da grade abaixo do alto do título, qualquer que seja o DROP. Com o fio mais perto do número do que do parágrafo de cima, ele é lido como parte do título.
#3 · Desça pelos níveis 4 a 6
const headings = { fontFamily: DISPLAY, color: col('ink'), // every head sits on the grid,
lineHeight: pt(LEAD), marginTop: pt(LEAD), marginBottom: pt(0), // a line above, none below
levels: [
// Each chapter opens on a recto.
{ level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
numberingTemplate: '{1}', advancedDesign: opener },
h2, h3,
// No template below level 3, so no number: each level changes face, colour or case.
{ level: 4, fontFamily: 'IBM Plex Serif', fontWeight: 400, italic: true, fontSize: pt(11) },
{ level: 5, fontSize: pt(9.4), color: col('band') },
{ level: 6, fontFamily: LABEL, fontWeight: 600, fontSize: pt(7.8), textTransform: 'uppercase' },
] };
Um nível sem numberingTemplate não imprime número, de modo que do nível 4 para baixo os títulos se distinguem pela letra, pela cor ou pela caixa: um itálico serifado no nível 4, a família de títulos em verde no 5 e maiúsculas monoespaçadas em seminegrito no 6. A entrelinha e as margens definidas no próprio headings chegam a todos os níveis e põem cada título na grade, com uma linha em branco acima e nenhuma abaixo. O nível 1 abre cada capítulo numa página ímpar, com parity: 'odd'.
#4 · Faça um sétimo nível e uma seção sem número com estilos
const headingStyles = [
// Markdown stops at ######: '###### Rock bar {style="level7"}' stays level 6 in the
// outline and is set in lower case, lighter and grey.
{ id: 'level7', fontFamily: DISPLAY, fontWeight: 500, italic: true, fontSize: pt(8.4),
textTransform: 'none', color: col('muted') },
// numbered: false: no number, and the H2 counter does not move. An empty {number} would
// still paint the amber pill, so the style draws a hollow square in its place.
{ id: 'checklist', numbered: false, advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'box', id: 'box', style: { borderColor: col('signal'), borderWidth: pt(1.8),
borderRadius: mm(1.5) }, placement: { ...at('container', 'top-left'),
size: { width: pt(PILL_H), height: pt(PILL_H) } } },
sectionTitle('box'),
] } } },
];
const paragraphStyles = [
// Run-in heads: the bold term opening each rule prints in the accent, not in body ink.
{ id: 'rules', boldColor: col('band'), firstLineIndent: pt(0) },
{ id: 'colophon', fontFamily: LABEL, fontSize: pt(6.8), lineHeight: pt(9),
color: col('muted'), textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) },
];
O Markdown para em ######, e ###### *Rock bar* seria mais um nível 6, só que em itálico. O estilo de título 'level7' compõe os nomes das ferramentas num itálico condensado cinza de peso 500, mais leve que o 600 do nível 6, e textTransform: 'none' desativa as maiúsculas que eles herdariam. Eles são lidos um degrau abaixo do rótulo monoespaçado acima deles, embora, com 8,4 pt, sejam maiores que os 7,8 pt do rótulo (estilos de título). numbered: false deixa o checklist fora da contagem, de modo que uma seção depois dele continuaria sendo a 1.13. Um {number} vazio ainda pintaria a pílula âmbar, por isso o estilo traz o próprio design, com um quadrado vazado no lugar da pílula. Os termos corridos em verde das regras de segurança vêm do boldColor de um estilo de parágrafo.
#5 · Mude os marcadores da lista com a profundidade
// Zero margins keep lists on the grid; a '- [ ]' item's bullet becomes taskCheckboxChar, '☐'.
const unorderedLists = { gap: mm(2), marginTop: pt(0), marginBottom: pt(0), color: col('band'),
levels: [{ level: 2, bulletChar: '–', color: col('sage') }] }; // '•' stays at level 1
// Level 1 keeps the defaults: 'arabic' and a full stop.
const orderedLists = { fontFamily: DISPLAY, color: col('band'), gap: mm(1.6),
marginTop: pt(0), marginBottom: pt(0), levels: [
{ level: 2, numberFormat: 'lower-alpha', separator: ')' },
{ level: 3, numberFormat: 'lower-roman', color: col('muted') }] };
Cada profundidade recebe de levels o marcador, a cor e o separador: o checklist conta 1., a) e i. (ajustes por nível das listas ordenadas) e os marcadores passam do verde ao verde-sálvia (ajustes por nível das listas não ordenadas). O nível 1 mantém o formato padrão, 'arabic'. Os dois itens - [ ] que fecham o checklist imprimem taskCheckboxChar, ☐ por padrão, no lugar do marcador, no verde dos marcadores de primeiro nível (extensões de listas de tarefas). Com margens zero acima e abaixo, todas as listas ficam na grade de linhas de base.
#6 · Abra o capítulo sobre o perfil da trilha
const DEPTH = 96; // mm: the profile's foot, measured from the top of the page
const CLEAR = 6; // mm: the least room between the profile's foot and the text under it
const LEGEND = 7; // mm: how far the legend's top sits above the profile's foot
const big = { ...face, fontSize: pt(54), lineHeight: 1, color: col('ink') };
// The opener reserves height down to the profile's foot; minHeight reaches CLEAR mm past
// it, so the text starts on the first grid line CLEAR mm or more under the picture.
const opener = { enabled: true, minHeight: mm(DEPTH - TOP + CLEAR), slot: { elements: [
{ kind: 'image', id: 'profile', resourceId: 'profile',
placement: { ...at('page', 'top-left'), size: { width: 'fill' } } },
{ kind: 'text', id: 'num', content: '{number}', ...big, box: { backgroundColor: col('signal'),
borderRadius: mm(4), padding: { top: pt(4), bottom: pt(4), left: mm(4), right: mm(4) } },
placement: at('container', 'top-left') },
{ kind: 'text', id: 'title', content: '{titleText}', ...big, box: { padding: { top: pt(4) } },
placement: at('#num', 'right-of', mm(4)) },
{ kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: 'IBM Plex Serif', italic: true,
fontSize: pt(11.5), lineHeight: 1.3, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { ...at('#num', 'below', mm(0), mm(5)), size: { width: mm(100) } } },
// The legend is design text over the picture: each edition words it in its heading.
{ kind: 'text', id: 'legend', content: '{attr.profile}', fontFamily: LABEL, fontWeight: 500,
fontSize: pt(7), color: col('tint'), placement: at('page', 'top-right', mm(-OUTER),
mm(DEPTH - LEGEND)) },
] } };
O perfil é um elemento de imagem da abertura, ancorado na página e tão largo quanto ela. Uma figura da largura da página, flutuando para o alto e citada na página 1, teria aberto a página 2 (elementos de imagem). A abertura reserva altura até o pé da imagem, e minHeight vai 6 mm além dele, por isso o texto começa na primeira linha da grade que fique 6 mm ou mais abaixo do perfil. A legenda sobre o verde é texto de design, preenchido pelo atributo profile do título. A pílula grande reaproveita a letra e o preenchimento da pílula de seção, e {number} imprime o número do próprio capítulo, vindo de numberingTemplate: '{1}'.
A receita completa
// ═══ Postext Cookbook · Nº 018 · Section heads seven levels deep ═════════════════
// https://postext.dev/en/cookbook/section-heads-field-manual
// Code: MIT · Text: original (CC BY 4.0) · Picture: drawn in code (MIT)
// Fonts: IBM Plex Serif, Sans Condensed, Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'section-heads-field-manual';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // forest green for structure, a signal amber for numbers
ink: '#1d2320', // text: a green-black
band: '#2f6b3f', // the accent: rules, run-in terms, bullets, numbers, folios (6.4:1)
signal: '#e0a526', // the number pills, with ink on them (7.3:1)
sage: '#7a9e80', // the second bullet and the profile's upper contours
tint: '#e9f0e6', // the opener's sky; the legend on the green (5.5:1)
muted: '#5f6a62', // running heads, level 7, roman list numbers, the colophon (5.6:1)
};
// col(id): a colour linked to its palette entry, in text styles and design slots alike.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Defaults this config does not restate link to 'main-color', so it points at the accent.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const TRIM = { width: 176, height: 250 }; // mm: ISO B5, a common size for field manuals
const [TOP, INNER, OUTER] = [22, 16, 14]; // mm: margins; the running heads align to OUTER
const LEAD = 13.2; // pt: the body leading, the pitch of the baseline grid
const LINES = 44; // grid lines in the text block, so every full column ends on one baseline
const [DISPLAY, LABEL] = ['IBM Plex Sans Condensed', 'IBM Plex Mono']; // with the serif text
const at = (to, edge, x, y) => ({ anchor: { to, edge }, offset: { x, y } });
// #region answer: section numbers 1.1 … 1.12 in an amber pill that widens with the number
const H2 = 13.5; // pt: the number and the title share one size and one line height,
const LH = 1.2; // so, under the same top padding, they share one baseline
// Every section head starts on a grid line, so the 3 pt the pill falls short of two lines
// is the gap the grid snap leaves between the pill and the text under it.
const PILL_H = 2 * LEAD - 3, PAD = (PILL_H - H2 * LH) / 2; // pt
const face = { fontFamily: DISPLAY, fontWeight: 700, fontSize: pt(H2), lineHeight: LH };
const pill = { kind: 'text', id: 'pill', content: '{number}', ...face, color: col('ink'),
box: { backgroundColor: col('signal'), borderRadius: mm(3), // no width: the pill is its
padding: { top: pt(PAD), bottom: pt(PAD), left: mm(1.8), right: mm(1.8) } }, // number
placement: at('container', 'top-left') }; // plus its padding
// 'right-of' hangs the title on the pill's right edge and aligns its lines left, so a long
// title wraps beside the number, never under it.
const sectionTitle = (from) => ({ kind: 'text', id: 'title', content: '{titleText}', ...face,
color: col('ink'), overflow: 'wrap', box: { padding: { top: pt(PAD) } },
placement: at(`#${from}`, 'right-of', mm(2.2)) });
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
#Tire o número do capítulo das pílulas
Tire o contador do capítulo do modelo e as pílulas vão de 1 a 12, alargando no 10; o nível 3 continua imprimindo 1.5.1 até que o próprio modelo também tire o {1}.
-const h2 = { level: 2, numberingTemplate: '{1}.{2}',
+const h2 = { level: 2, numberingTemplate: '{2}',#Dê a todas as pílulas a mesma largura
Uma largura fixa, a do 1.10, centraliza cada número numa pílula igual e alinha os títulos numa só coluna.
- placement: at('container', 'top-left') }; // plus its padding
+ placement: { ...at('container', 'top-left'), size: { width: mm(12.7) } } };Erros comuns
Erro comum
Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita
Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →
Verificação do Sandbox · headingHierarchy
Salto na hierarquia de títulos
Por quê. Um título pula um nível, por exemplo um H1 seguido diretamente de um H3.
Correção. Use o nível imediatamente abaixo ou mude o estilo do nível que você queria, em vez de pular um. Docs →
- O sétimo nível é um título de nível 6 com o estilo
level7, de modo que nenhum título do exemplo desce mais de um nível em relação ao título anterior: The trench, Tools for the trench, STEEL BARS e Rock bar são dos níveis 4, 5, 6 e 6. O aviso do Sandbox “Salto na hierarquia de títulos” aponta justamente esse tipo de pulo, por isso ele nunca aparece neste capítulo.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- IBM Plex Serif (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1) · IBM Plex Mono (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)


