Saltar al contingut principal
Recepta número 18

Receptari · Capítol 3 · Títols i obertures

Títols de secció fins a set nivells

Seccions de l'1.1 a l'1.12 numerades en una píndola ambre que creix amb el número, quatre nivells més per sota i un setè tret d'un estil d'encapçalament.

En aquesta pàgina
  • Mostra en castellà: encara no hi ha edició en català
  • Format 176 × 250 mm
  • 2 columnes, espai entre columnes de 6 mm
  • IBM Plex Serif 9,4/13,2
  • IBM Plex Mono
  • IBM Plex Sans Condensed
  • 3 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 61 ms
  • 178 línies de codi

En poques paraules

Un capítol d'un manual per a colles que tenen cura de senders, sobre com treure l'aigua dels camins. Ensenya a donar set nivells als títols, cadascun amb el seu aspecte, per veure com encaixen les parts.

Què compondràs

Drenaje, capítol 1 del manual de camp d'una brigada de senders, en tres pàgines B5 a dues columnes: IBM Plex Serif per al text, Sans Condensed per a títols i números de secció, i Mono per a etiquetes, folis i números d'apartat. L'obertura posa el número en una gran píndola ambre sobre el perfil del sender, amb dotze punts ambre on aniran nous desviadors. Les seccions 1.1 a 1.12 porten el número en píndoles més petites, que s'eixamplen a l'1.10. Un filet verd i majúscules espaiades marquen els apartats 1.2.1, 1.5.1 i 1.5.2. Els nivells 4 a 6, sense número, canvien de lletra, de color o de caixa, i un setè, en cursiva grisa, anomena les eines. Les normes de seguretat comencen en negreta verda. Tanca el capítol una llista de control sense número, amb un quadrat buit al costat, llistes 1., a) i i. i dues caselles.

Aquesta recepta respon a

  • Com numero els títols (1, 1.1, 1.1.1) i dono a cada nivell un estil diferent?
  • Com faig una insígnia amb el número al costat del títol que s'eixampli quan el número creix (9 → 10)?
  • Què faig si necessito més de sis nivells de títol?
  • Com personalitzo les llistes: pics per nivell, numeració (a)/(i), caselles de tasques i un espaiat que respecti la retícula?

La resposta curta

script.js · línies 34–51al codi complet
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')] } } };

Ingredients

Tipografia
IBM Plex Serif, IBM Plex Sans Condensed, IBM Plex Mono (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Posa el número en una píndola que creix amb ell

El codi és a la resposta curta, més amunt. numberingTemplate: '{1}.{2}' ajunta el comptador del capítol i el de la secció, i així les seccions van de l'1.1 a l'1.12 (configuració per nivell). Si el nivell té un disseny avançat, el número ja no s'imprimeix davant del títol i és el disseny el que col·loca {number}. Aquí va en un element de text amb una caixa (box) de fons ambre i cantonades arrodonides, sense amplada fixa, de manera que la píndola fa el que fa el número més el seu farciment: 10,1 mm a l'1.9 i 12,7 mm a l'1.10. 'right-of' penja el títol de la vora dreta de la píndola i n'alinea les línies a l'esquerra; per això el títol llarg de la 1.5 passa a una segona línia al costat del número i no a sota (posicionament d'elements). A la píndola li falten 3 pt per fer dues línies de la retícula, i com que cada títol de secció comença en una línia de la retícula, aquests 3 pt són el blanc que queda entre la píndola i el text de sota, tant si el títol obre una columna com si segueix un paràgraf.

Pàgina 3: la píndola s'eixampla de l'1.9 a l'1.10 i el títol es desplaça a la dreta el que ocupa la xifra de més.

#2 · Posa filet i espaiat al tercer nivell

script.js · línies 55–67al codi complet
// 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 nivell 3 també és un disseny: un filet verd de 0,75 pt, el número en IBM Plex Mono i, al costat, el títol en majúscules espaiades. El tercer comptador de '{1}.{2}.{3}' torna a començar a cada secció; per això tant l'1.2.1 com l'1.5.1 acaben en 1. DROP baixa només el filet. El número es col·loca LEAD - DROP per sota seu, de manera que número i títol queden una línia de la retícula per sota d'on comença el títol, sigui quin sigui DROP. Com que el filet queda més a prop del número que del paràgraf anterior, es llegeix com a part del títol.

#3 · Baixa del nivell 4 al 6

script.js · línies 96–107al codi complet
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 nivell sense numberingTemplate no imprimeix número, així que a partir del nivell 4 el que distingeix un títol d'un altre és la lletra, el color o la caixa: una cursiva amb gràcies al 4, la lletra dels títols, en verd, al 5 i majúscules seminegres d'amplada fixa al 6. L'interlineat i els marges definits al mateix headings arriben a tots els nivells i posen cada títol sobre la retícula, amb una línia en blanc a sobre i cap a sota. El nivell 1 obre cada capítol en pàgina senar, amb parity: 'odd'.

#4 · Fes un setè nivell i una secció sense número amb estils

script.js · línies 111–130al codi complet
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 passa de ######, i ###### *Barra de palanca* seria un nivell 6 més, només que en cursiva. L'estil d'encapçalament 'level7' compon els noms de les eines en una cursiva estreta grisa de gruix 500, més lleugera que el 600 del nivell 6, i textTransform: 'none' els treu les majúscules que heretarien. Es llegeixen un graó per sota de l'etiqueta d'amplada fixa que els precedeix, tot i que a 8,4 pt són més grans que els 7,8 pt de l'etiqueta (estils d'encapçalament). numbered: false deixa la llista de control fora del compte, de manera que una secció posterior continuaria sent la 1.13. Un {number} buit continuaria pintant la píndola ambre, així que l'estil porta el seu propi disseny, amb un quadrat buit al seu lloc. El verd dels termes que obren les normes de seguretat és el boldColor d'un estil de paràgraf.

#5 · Canvia les marques de la llista amb la profunditat

script.js · línies 134–141al codi complet
// 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 profunditat pren de levels la seva marca, el seu color i el seu separador: la llista de control numera amb 1., a) i i. (sobreescriptures per nivell de les llistes numerades) i els pics passen del verd al sàlvia (sobreescriptures per nivell de les no ordenades). El nivell 1 conserva el format per defecte, 'arabic'. Les dues entrades - [ ] del final de la llista de control porten, en lloc de pic, el taskCheckboxChar, que per defecte és ☐, en el verd dels pics de primer nivell (extensions per a llistes de tasques). Amb els marges de dalt i de baix a zero, totes les llistes continuen sobre la retícula de base.

#6 · Obre el capítol sobre el perfil del sender

script.js · línies 71–92al codi complet
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 és un element d'imatge de l'obertura, ancorat a la pàgina i tan ample com ella. Si fos una figura flotant a tota l'amplada, citada a la pàgina 1 i col·locada a dalt, obriria la pàgina 2 (elements d'imatge). L'obertura reserva alçada fins al peu de la imatge, i minHeight arriba 6 mm més avall, així que el text comença a la primera línia de la retícula que quedi almenys 6 mm per sota del perfil. La llegenda sobre el verd és text de disseny, i surt de l'atribut profile del títol. La píndola gran repeteix la lletra i l'ambre de les de secció, i el seu {number} és el número del capítol, que dona numberingTemplate: '{1}'.

La recepta completa

Sandbox
// ═══ 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)) });

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Treu el número del capítol de les píndoles

Treu de la plantilla el comptador del capítol i les píndoles aniran de l'1 al 12, més amples a partir del 10; el nivell 3 continuarà imprimint 1.5.1 mentre la seva pròpia plantilla conservi {1}.

-const h2 = { level: 2, numberingTemplate: '{1}.{2}',
+const h2 = { level: 2, numberingTemplate: '{2}',

#Dona a totes les píndoles la mateixa amplada

Una amplada fixa, la de l'1.10, centra cada número en una píndola igual a les altres i alinea els títols en una sola columna.

-  placement: at('container', 'top-left') }; // plus its padding
+  placement: { ...at('container', 'top-left'), size: { width: mm(12.7) } } };

Errors freqüents

Error freqüent

Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita

Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →

Comprovació del Sandbox · headingHierarchy

Salt en la jerarquia de títols

Per què. Un títol se salta un nivell, per exemple un H1 seguit directament d'un H3.

Solució. Fes servir el nivell immediatament inferior, o canvia l'estil del nivell que volies en lloc de saltar-te'l. Documentació →

  • El setè nivell és un títol de nivell 6 amb l'estil level7, així que cap títol de l'exemple no baixa més d'un nivell respecte a l'anterior: La zanja, Herramientas para la zanja, BARRAS DE ACERO i Barra de palanca són dels nivells 4, 5, 6 i 6. El Sandbox avisa d'aquest cas amb «Salt en la jerarquia de títols», i en aquest capítol l'avís no apareix.

Crèdits

Text
Text original, CC BY 4.0
Fonts
IBM Plex Serif (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1) · IBM Plex Mono (SIL OFL 1.1)
Sandbox