En pocas palabras
Un capítulo de un manual para cuadrillas que cuidan senderos, sobre cómo sacar el agua de los caminos. Enseña a dar a los títulos siete niveles, cada uno con su aspecto, para ver cómo encajan las partes.
Lo que vas a componer
Drenaje, capítulo 1 del manual de campo de una brigada de senderos, en tres páginas B5 a dos columnas: IBM Plex Serif para el texto, Sans Condensed para títulos y números de sección, y Mono para etiquetas, folios y números de apartado. La apertura pone el número en una gran píldora ámbar sobre el perfil del sendero, con doce puntos ámbar donde irán nuevos desviadores. Las secciones 1.1 a 1.12 llevan el número en píldoras menores, que se ensanchan en el 1.10. Un filete verde y mayúsculas espaciadas marcan los apartados 1.2.1, 1.5.1 y 1.5.2. Los niveles 4 a 6, sin número, cambian de letra, de color o de caja, y un séptimo, en cursiva gris, presenta las herramientas. Las normas de seguridad empiezan en negrita verde. Cierra el capítulo una lista de control sin número, con un cuadrado hueco al lado, listas 1., a) e i. y dos casillas.
Esta receta responde a
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
- ¿Cómo hago una insignia con el número junto al título que se ensanche cuando el número crece (9 → 10)?
- ¿Qué hago si necesito más de seis niveles de título?
- ¿Cómo personalizo las listas: viñetas por nivel, numeración (a)/(i), casillas de tareas y un espaciado que respete la rejilla?
La respuesta corta
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
- Funciones
- Títulos numeradosTextos, filetes y cajas en los diseños de páginaAnclaje de elementos de diseñoNiveles de títuloEstilos de títuloCapítulos sin númeroAperturas diseñadasImágenes en los diseños de páginaAtributos de títuloEstilos de párrafoNegrita, cursiva y sus coloresListas de viñetas y de comprobaciónListas numeradasRejilla baseViudas, huérfanas y líneas cortasCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosPaleta de color semánticaFiguras y tablas como recursos
- También usa
- Banda de capítulo a todo el ancho
- Tipografía
- IBM Plex Serif, IBM Plex Sans Condensed, IBM Plex Mono (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Pon el número en una píldora que crece con él
El código está en la respuesta corta, más arriba. numberingTemplate: '{1}.{2}' junta el contador del capítulo y el de la sección, y así las secciones van del 1.1 al 1.12 (configuración por nivel). Si el nivel tiene un diseño avanzado, el número ya no se imprime delante del título y es el diseño el que coloca {number}. Aquí va en un elemento de texto con una caja (box) de fondo ámbar y esquinas redondeadas, sin ancho fijo, de modo que la píldora mide lo que el número más su relleno: 10,1 mm en el 1.9 y 12,7 mm en el 1.10. 'right-of' cuelga el título del borde derecho de la píldora y alinea sus líneas a la izquierda; por eso el título largo de la 1.5 pasa a una segunda línea junto al número y no debajo (colocación de elementos). A la píldora le faltan 3 pt para medir dos líneas de la rejilla, y como cada título de sección empieza en una línea de la rejilla, esos 3 pt son el blanco que queda entre la píldora y el texto de debajo, tanto si el título abre una columna como si sigue a un párrafo.

#2 · Pon filete y espaciado al tercer nivel
// 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)) },
] } } };
El nivel 3 también es un diseño: un filete verde de 0,75 pt, el número en IBM Plex Mono y, a su lado, el título en mayúsculas espaciadas. El tercer contador de '{1}.{2}.{3}' vuelve a empezar en cada sección; por eso tanto el 1.2.1 como el 1.5.1 terminan en 1. DROP baja solo el filete. El número se coloca LEAD - DROP por debajo de él, de modo que número y título quedan una línea de la rejilla por debajo de donde empieza el título, sea cual sea DROP. Como el filete queda más cerca del número que del párrafo anterior, se lee como parte del título.
#3 · Baja del nivel 4 al 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' },
] };
Un nivel sin numberingTemplate no imprime número, así que a partir del nivel 4 lo que distingue un título de otro es la letra, el color o la caja: una cursiva con remates en el 4, la letra de los títulos, en verde, en el 5 y mayúsculas seminegras de paso fijo en el 6. El interlineado y los márgenes definidos en el propio headings llegan a todos los niveles y ponen cada título sobre la rejilla, con una línea en blanco encima y ninguna debajo. El nivel 1 abre cada capítulo en página impar, con parity: 'odd'.
#4 · Haz un séptimo nivel y una sección sin número con 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) },
];
Markdown no pasa de ######, y ###### *Barra de palanca* sería un nivel 6 más, solo que en cursiva. El estilo de encabezado 'level7' compone los nombres de las herramientas en una cursiva estrecha gris de peso 500, más ligera que el 600 del nivel 6, y textTransform: 'none' les quita las mayúsculas que heredarían. Se leen un escalón por debajo de la etiqueta de paso fijo que los precede, aunque a 8,4 pt son más grandes que los 7,8 pt de la etiqueta (estilos de encabezado). numbered: false deja la lista de control fuera de la cuenta, de modo que una sección posterior seguiría siendo la 1.13. Un {number} vacío seguiría pintando la píldora ámbar, así que el estilo trae su propio diseño, con un cuadrado hueco en su lugar. El verde de los términos que abren las normas de seguridad es el boldColor de un estilo de párrafo.
#5 · Cambia las marcas de la lista con la profundidad
// 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 profundidad toma de levels su marca, su color y su separador: la lista de control numera con 1., a) e i. (valores por nivel de las listas ordenadas) y las viñetas pasan del verde al salvia (valores por nivel de las no ordenadas). El nivel 1 conserva el formato por defecto, 'arabic'. Las dos entradas - [ ] del final de la lista de control llevan, en lugar de viñeta, el taskCheckboxChar, que por defecto es ☐, en el verde de las viñetas de primer nivel (extensiones para listas de tareas). Con los márgenes de arriba y de abajo a cero, todas las listas siguen sobre la rejilla base.
#6 · Abre el capítulo sobre el perfil del sendero
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)) },
] } };
El perfil es un elemento de imagen de la apertura, anclado a la página y tan ancho como ella. Si fuera una figura flotante a todo el ancho, citada en la página 1 y colocada arriba, abriría la página 2 (elementos de imagen). La apertura reserva altura hasta el pie de la imagen, y minHeight llega 6 mm más abajo, así que el texto empieza en la primera línea de la rejilla que quede al menos 6 mm por debajo del perfil. La leyenda sobre el verde es texto de diseño, y sale del atributo profile del título. La píldora grande repite la letra y el ámbar de las de sección, y su {number} es el número del capítulo, que da numberingTemplate: '{1}'.
La receta 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 = 'es'; // @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)) });
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Quita el número del capítulo de las píldoras
Quita de la plantilla el contador del capítulo y las píldoras irán del 1 al 12, más anchas a partir del 10; el nivel 3 seguirá imprimiendo 1.5.1 mientras su propia plantilla conserve {1}.
-const h2 = { level: 2, numberingTemplate: '{1}.{2}',
+const h2 = { level: 2, numberingTemplate: '{2}',#Da a todas las píldoras el mismo ancho
Un ancho fijo, el del 1.10, centra cada número en una píldora igual a las demás y alinea los títulos en una sola columna.
- placement: at('container', 'top-left') }; // plus its padding
+ placement: { ...at('container', 'top-left'), size: { width: mm(12.7) } } };Errores frecuentes
Error frecuente
Un flotante 'top' va a la página siguiente a su cita salvo que pueda encabezar la página que lo cita
Por defecto un flotante nunca va por encima de su propia referencia, así que un flotante 'top' a todo el ancho citado en la página N abre la página N+1. Con placement.citingPage: true en el recurso o en el defaultPlacement de su tipo (o layout.floatsAtCitingPage para todo el libro, desde postext 1.25) encabeza en cambio la página N, y el texto de encima de la referencia baja bajo él, cuando cabe dentro de layout.maxTopFraction y la línea que lo cita sigue en esa página. Nunca encabeza la primera página de un capítulo ni una página tras un salto forzado: allí sigue abriendo la página siguiente, y 'auto' o 'bottom' pueden ocupar el pie de la página que lo cita. Colocación de figuras →
Comprobación del Sandbox · headingHierarchy
Salto en la jerarquía de títulos
Por qué. Un encabezado se salta un nivel, por ejemplo un H1 seguido directamente de un H3.
Solución. Usa el nivel inmediatamente inferior, o cambia el estilo del nivel que querías en lugar de saltártelo. Documentación →
- El séptimo nivel es un encabezado de nivel 6 con el estilo
level7, así que ningún título del ejemplo baja más de un nivel respecto al anterior: La zanja, Herramientas para la zanja, BARRAS DE ACERO y Barra de palanca son de los niveles 4, 5, 6 y 6. El Sandbox avisa de ese caso con «Salto en la jerarquía de títulos», y en este capítulo el aviso no aparece.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- 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 Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


