Configuració: encapçalaments

#Encapçalaments

La propietat headings controla la tipografia de tots els nivells d'encapçalament (H1–H6). Pots establir valors generals per defecte que s'apliquen a tots els nivells, i després sobreescriure propietats específiques per nivell.

#Valors generals per defecte

Encapçalaments centrats per a poemes o els actes d'una obra de teatre, sense ranura de disseny:

headings: {
  textAlign: 'center',
  levels: [{ level: 2, textTransform: 'uppercase' }],
}

Un objecte headings conserva tots els valors per defecte de nivell que no repeteixis, inclòs el salt de pàgina d'H1 (vegeu Configuració per nivell).

#Configuració per nivell

Cada nivell d'encapçalament pot sobreescriure els valors generals a través de l'array levels. Només fontSize (més el breakBefore d'H1, indicat a sota) difereix per defecte — totes les altres propietats s'hereten de la configuració general d'encapçalaments.

El valor per defecte d'H1 reprodueix la maqueta clàssica d'un llibre: cada encapçalament de nivell superior s'obre en una pàgina dreta (senar) nova, amb una pàgina separadora en blanc obligatòria que tanca el capítol anterior. Anul·la levels[0].breakBefore si el teu document és més pla que un llibre.

El breakBefore d'un nivell es combina camp a camp amb aquest valor per defecte, i un objecte headings que no el menciona el conserva. { parity: 'odd' } a H1 manté el salt i només canvia la paritat; { enabled: false } deixa que els capítols vagin seguits:

headings: {
  fontFamily: 'Merriweather',                               // H1 continua saltant a una pàgina senar nova (always-odd)
  levels: [{ level: 1, breakBefore: { parity: 'odd' } }],    // …o: a una senar, sense pàgina en blanc obligatòria
}
 
headings: { levels: [{ level: 1, breakBefore: { enabled: false } }] } // capítols seguits

Canvia a postext 1.5. Fins a postext 1.4, qualsevol objecte headings desactivava el salt d'H1 llevat que es repetís levels[0].breakBefore, i un breakBefore parcial completava el camp que faltava amb el valor sense salt. Per això una configuració escrita en codi per a la 1.4 amb un objecte headings i sense salt d'H1 obre ara cada capítol en una pàgina senar nova, amb pàgines parelles en blanc on calgui. Perquè els capítols continuïn anant seguits, n'hi ha prou amb un camp a l'entrada d'H1 de levels:

headings: { fontFamily: 'Merriweather', levels: [{ level: 1, breakBefore: { enabled: false } }] } // com ho componia la 1.4

On la configuració estava desada, el motor ho pot saber i ho fa per tu: el Sandbox amb els llibres i les configuracions que va desar llavors (vegeu Sandbox → Persistència), i openBundle / readBundle amb un paquet .postext escrit per postext 1.4 o anterior (vegeu Paquets escrits per postext 1.4 o anterior). Una configuració que vas desar tu pot passar per migrateConfig(config) de postext/bundle, que escriu els salts tal com els componia la 1.4 (pinLegacyHeadingBreaks): enabled: false en un H1 que no tenia salt, i parity: 'any' al costat d'un enabled: true que no indicava paritat, a H1 i als estils d'encapçalament. També fixa la mida de les fórmules, l'espai al voltant de les figures en línia (també als requadres), les marques en línia dels encapçalaments, la mida de les caplletres, el lloc sota una línia de dos punts que introdueix una llista, les línies que deixa d'un paràgraf o d'un element de llista el tall d'una caixa, els talls de línia després d'un guió llarg, la composició línia a línia del text en bandera, la divisió d'un paràgraf sota un encapçalament, els talls de línia després del guionet d'un compost i l'espai sota els contenidors :::paragraphs, tal com els componia la 1.4. Si li passes el markdown del llibre com a tercer argument, { content }, omet la fixació de les fórmules quan el text no té cap $, les dels buits quan cap línia no insereix un recurs (la del buit als requadres quan cap no ho fa dins d'un requadre), la de les marques quan cap encapçalament no en porta cap, la dels dos punts quan cap llista no segueix una línia que acaba en dos punts, la del tall de les caixes quan el text no obre cap :::callout, la dels guions llargs quan cap guió llarg no va entre paraules sense espais, la de la divisió sota un encapçalament quan el text no té cap encapçalament, la dels contenidors quan el text no obre cap contenidor :::paragraphs, i la dels compostos quan cap guionet no va entre dues lletres; la del text en bandera només s'aplica a una configuració que posa en bandera algun text corregut, i la dels contenidors només a una que declara algun estil de paràgraf (vegeu Paquets escrits per postext 1.4 o anterior). Per fixar només els salts, crida pinLegacyHeadingBreaks(config).

Les configuracions per nivell admeten les mateixes propietats que els valors generals — fontSize, lineHeight, fontFamily, color, fontWeight, marginTop, marginBottom, snapToGrid — més aquests camps exclusius de cada nivell (un estil d'encapçalament també els admet):

headings: {
  fontFamily: 'Merriweather',
  levels: [
    // Preajust canònic de llibre: els capítols s'obren a la pàgina dreta (senar).
    { level: 1, fontSize: { value: 24, unit: 'pt' }, breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontSize: { value: 18, unit: 'pt' }, italic: true },
  ]
}

snapToGrid també funciona per nivell. Sense fixar, un nivell segueix headings.snapToGrid; fixat, el substitueix — així un mateix document pot deixar els seus H2 a línia i mitja del seu text, fora de la retícula fins al següent punt d'ajust, mentre els seus H3 arrodoneixen l'espai inferior a línies senceres de la retícula. Un estil d'encapçalament també el pot fixar, per als encapçalaments que l'usen.

headings: {
  marginBottom: { value: 1.5, unit: 'em' },
  levels: [
    { level: 2, snapToGrid: false }, // exactament 1,5 em sota cada H2
    { level: 3 },                    // hereta headings.snapToGrid: true
  ],
}

#Saltar abans

breakBefore és ortogonal als controls de numeració: activar-lo força un salt de pàgina, però el comptador numèric només es reinicia quan insereixes explícitament una directiva :::numbering. Les pàgines de farciment per paritat compten com a pàgines reals a la seqüència i reben capçaleres/peus segons les seves regles normals de senar/parell.

Un :::pagebreak just abans d'un d'aquests encapçalaments no substitueix el seu salt: l'encapçalament aplica igualment la seva paritat després de la pàgina que va obrir la directiva, cosa que pot afegir una pàgina en blanc. Vegeu Estils d'encapçalament per a un encapçalament que hagi de començar just després d'un salt manual.

Valors de paritat

Pertinença de les pàgines en blanc

Les pàgines en blanc que insereix breakBefore reben la capçalera {chapterTitle} en funció del motiu de la inserció:

• Les pàgines inserides per satisfer una restricció de paritat ('odd', 'even', o la cua de paritat de 'always-*') pertanyen al capítol entrant. El seu marcador {chapterTitle} es resol al títol del nou capítol — perquè la pàgina en blanc només existeix per empènyer el nou capítol fins a la paritat correcta.
• La pàgina separadora obligatòria que insereix 'always-odd' / 'always-even' pertany al capítol anterior. És una pausa de tancament de capítol deliberada, així que {chapterTitle} continua mostrant el títol del capítol sortint.

Les capçaleres i la paleta d'una secció amb estil (vegeu Estils d'encapçalament) segueixen les mateixes dues regles a les pàgines en blanc.

Excepció a l'inici del document

Quan el primer bloc del document és un encapçalament amb breakBefore activat — o la font comença amb :::pagebreak —, la imposició de paritat s'omet mentre la primera pàgina continuï buida. L'encapçalament aterra a la pàgina 1 tal qual, independentment de la paritat configurada, de manera que un document que comença amb # Capítulo 1 amb parity: 'odd' no arrossega una pàgina en blanc inicial innecessària. Un cop s'ha col·locat qualsevol contingut, la imposició de paritat funciona de la manera habitual.

#Span i disseny avançat

Cada nivell d'encapçalament admet dos camps addicionals que controlen com es renderitza l'encapçalament com a obertura de capítol a pàgina completa.

Una obertura tan alta com la pàgina. Quan l'alçada reservada arriba més enllà del peu de la columna — una portada el minHeight de la qual és l'alçada de la pàgina, una imatge o una caixa ancorada a la pàgina o a la sang que baixa fins al tall —, l'obertura reclama la resta de la pàgina: el text que la segueix comença a la pàgina següent, igual a totes les columnes d'una disposició a dues columnes o de columna i mitja. Per això una portada no necessita un :::pagebreak darrere (posar-lo no fa mal: no afegeix cap pàgina en blanc). Un encapçalament de columna (span: 'column') el disseny del qual és més alt que la seva columna reclama aquesta columna, i el text comença al capdamunt de la següent. El bloc de l'encapçalament baixa llavors fins al peu de la columna que reclama, i el seu disseny es compon contra aquesta banda: els elements ancorats a dalt es queden on són ancorats, i els que segueixen la banda —ancorats al seu centre o al seu peu, o amb alçada 'fill'— s'ajusten a l'espai que reclama l'encapçalament, igual que s'ajusten a l'alçada reservada quan hi cap (fins a postext 1.4 el bloc conservava l'alçada del seu text, de manera que aquests elements es componien contra una banda de l'alçada del títol, i el text que el seguia s'esmunyia sota el disseny). Els adorns de pàgina que no l'han de reclamar — una franja al llarg de tot el tall davanter, un ornament al peu de la pàgina — van al disseny de la capçalera o del peu: ancorats a 'page' o a 'bleed' i mostrats amb pages: 'opener', es pinten a la pàgina d'obertura sense reservar espai del cos.

Exemple — una obertura de capítol minimalista que mostra «Capítol N» damunt del títol:

{
  "headings": {
    "levels": [
      {
        "level": 1,
        "span": "page",
        "breakBefore": { "enabled": true, "parity": "always-odd" },
        "advancedDesign": {
          "enabled": true,
          "slot": {
            "elements": [
              {
                "kind": "text",
                "id": "chapterLabel",
                "placement": {
                  "anchor": { "to": "container", "edge": "top" },
                  "offset": { "y": { "value": 48, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "Capítol {numberRoman}",
                "fontSize": { "value": 10, "unit": "pt" },
                "align": "center",
                "overflow": "ellipsis-end"
              },
              {
                "kind": "text",
                "id": "chapterTitle",
                "placement": {
                  "anchor": { "to": "#chapterLabel", "edge": "below" },
                  "offset": { "y": { "value": 12, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "{titleText}",
                "fontSize": { "value": 24, "unit": "pt" },
                "fontWeight": 700,
                "align": "center",
                "overflow": "wrap",
                "hyphenate": true
              }
            ]
          }
        }
      }
    ]
  }
}

Marcadors disponibles dins d'una ranura de disseny d'encapçalament:

• {titleText} — text pla de l'encapçalament (sense prefix numèric). Un salt forçat al títol (\\) és aquí un salt de línia, tant en una banda d'obertura com en un disseny dins de la columna (fins a postext 1.4 un disseny dins de la columna imprimia un espai, tot i que la seva alçada es mesurava amb el salt). Les línies en què l'encapçalament ocult es reparteix a la seva columna es tornen a unir al títol tal com està escrit: una paraula tallada després del seu propi guionet conserva el guionet i no porta espai darrere, una paraula que la columna va dividir torna a quedar sencera, sense el guionet que hi va afegir el tall, un grup unit per un espai de no separació que no cabia a la columna i es va partir en aquest espai el recupera (Capítulo XVIII, no CapítuloXVIII), i cadascun dels altres talls retorna el seu espai. Fins a postext 1.4 cada salt de línia es convertia en un espai, de manera que un títol partit en un guionet imprimia Word- Book, i en aquest títol es perdia un salt forçat.
• {number} — número formatat segons numberingTemplate.
• {numberDecimal}, {numberRoman}, {numberRomanLower}, {numberAlpha}, {numberAlphaLower} — el comptador de l'encapçalament (el compte acumulat del seu nivell, imprimeixi el que imprimeixi la plantilla) en altres formats de numeració: el tercer capítol dona 3, III, iii, C, c, amb numberingTemplate o sense. Un encapçalament sense numerar (un estil amb numbered: false) els deixa buits.
• {numberWords}, {numberWordsLower}, {numberOrdinalWords}, {numberOrdinalWordsLower} — el mateix comptador en lletres, amb majúscula inicial o en minúscula: Tres / tres, Tercer / tercer (vegeu Nombres en lletres).
• {numberHan} — el mateix comptador en numerals xinesos, en l'escriptura del locale del document: una obertura composta amb 第{numberHan}回 imprimeix 第十二回 al dotzè capítol mentre l'índex mostra 12.
• {chapterNumber}, {chapterTitle}, {pageNumber}, {totalPages}, {bookTotalPages}, {title}, {subtitle}, {author}, {publishDate} — metadades compartides.
• {attr.<clave>} — un atribut escrit a la mateixa línia de l'encapçalament (# Título {author="I. Zango Martín"}), amb l'atribut de l'H1 del capítol actual com a alternativa. Els atributs absents es resolen com una cadena buida sense avís.

{chapterNumber} imprimeix el mateix que les capçaleres per a aquest capítol: el número de l'H1 quan el seu nivell (o el seu estil) té numberingTemplate; si no, l'ordinal del capítol —1, 2…, continuant després dels capítols maquetats abans que aquest—, i res per a un capítol sense numerar o un estil la plantilla del qual és ''. El disseny d'un encapçalament llegeix el capítol al qual pertany el seu encapçalament: un de nivell 1, el seu; un de nivell inferior, el de l'últim encapçalament de nivell 1 anterior. També és així quan dos capítols coincideixen en una pàgina, encara que les capçaleres d'aquesta pàgina imprimeixin el segon. L'alçada que reserva una obertura es mesura amb aquest mateix valor. Fins a postext 1.4 es mesurava amb el prefix numèric de l'encapçalament (buit sense plantilla), així que un disseny l'alçada del qual depengués de {chapterNumber} podia pintar-se més alt que l'espai que havia reservat; i el disseny imprimia el capítol de la pàgina, de manera que el primer de dos capítols que compartien pàgina mostrava el número del segon.

Els marcadors del comptador segueixen el llibre al llarg dels capítols compostos un a un (els comptadors que lliura continuationAfter()), i l'atribut startAt d'un encapçalament els reinicia (vegeu Format de document → Atributs d'encapçalament). Una obertura que diu Capítol III damunt d'un títol numerat 3. en el flux i a l'índex:

{
  level: 1,
  span: 'page',
  numberingTemplate: '{1}.',
  advancedDesign: {
    enabled: true,
    slot: { elements: [
      { kind: 'text', id: 'label', content: 'Capítol {numberRoman}', fontSize: { value: 10, unit: 'pt' }, overflow: 'ellipsis-end',
        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill', height: 'auto' } } },
      { kind: 'text', id: 'title', content: '{titleText}', fontSize: { value: 24, unit: 'pt' }, overflow: 'wrap',
        placement: { anchor: { to: '#label', edge: 'below' }, size: { width: 'fill', height: 'auto' } } },
    ] },
  },
}

Alçada reservada

Un encapçalament amb disseny avançat ocupa espai a la columna com qualsevol bloc: el text de cos que el segueix comença a sota d'aquest espai. L'espai és la més gran de tres alçades, totes mesurades cap avall des de la part superior de l'encapçalament (la part superior de l'àrea de contingut en una obertura que comença la seva pàgina):

1. el mateix text de l'encapçalament, amb la tipografia del nivell (queda ocult sota el disseny, però conserva les seves línies);
2. el fons del contingut del disseny: la vora inferior més baixa entre els elements que compten (vegeu més avall);
3. advancedDesign.minHeight.

A continuació s'hi suma el marginBottom de l'encapçalament (el del seu estil d'encapçalament, el del seu nivell o headings.marginBottom; 0,5 em si cap no en fixa un altre) i el resultat s'ajusta cap amunt a la retícula de base quan els encapçalaments s'hi ajusten. En una obertura (span: 'page') la mateixa franja queda lliure a totes les columnes de la pàgina. En un encapçalament de columna que no la desborda, el disseny es compon dins de la caixa de l'encapçalament, que té exactament aquesta alçada.

Quins elements compten. Compten tots els elements del disseny —textos, filets, caixes i imatges per igual (fins a postext 1.4 un element image no comptava mai, de manera que el text podia començar damunt d'una imatge de banda si minHeight no ho impedia)—, excepte:

• els que tenen reserve: false: decoració que pot quedar sota el text;
• els que segueixen la mateixa franja: els ancorats a la fila central del contenidor (left, center, right) o a la inferior (bottom-left, bottom, bottom-right), els que tenen una alçada 'fill' respecte al contenidor (una caixa o una línia vertical sense alçada l'omplen per defecte) i qualsevol element ancorat a un d'ells. El contenidor és la franja reservada, així que aquests elements es recolzen al seu peu o l'abasten: una línia sota la franja, un plafó de color darrere del títol. Segueixen l'alçada; mai no la fixen. Un text d'entre ells que conserva la seva pròpia alçada sí que necessita lloc: un títol ancorat al peu de la franja fa que la franja mesuri almenys el que fa el títol, de manera que mai no comença per damunt de la vora superior de l'encapçalament. Amb minHeight: 36mm i el títol ancorat a bottom-left, la caixa de l'encapçalament fa 36 mm més el seu marginBottom, ajustada cap amunt a la retícula, i el títol queda al peu d'aquesta caixa, just damunt del text que segueix; sense minHeight, un títol que ocupa més línies que el text del mateix encapçalament fa la franja tan alta com el títol. Fins a postext 1.4 aquest títol es pintava cap amunt, damunt del text que precedeix l'encapçalament. Les caixes, els filets i les imatges que segueixen la franja no fixen aquest mínim, així que un plafó ancorat al peu pot sobresortir per damunt de l'encapçalament.

Els elements ancorats a la pàgina o a la sang compten segons quant baixin per sota de la part superior de l'encapçalament. Una banda al capdamunt de la pàgina que acaba per damunt de l'encapçalament no compta gens; una imatge a sang que el sobrepassa empeny el text fins a la seva vora inferior. El mateix passa amb tot el que és a baix de la pàgina: un segell a 25 mm del peu, una banda lateral a tota alçada o un marc reserven la pàgina fins a la seva vora inferior, i el text sol començar a la pàgina següent. Marca aquesta decoració amb reserve: false —es continua pintant i altres elements s'hi poden continuar ancorant— i dona a l'encapçalament l'espai que necessita amb els seus elements de text o amb minHeight:

{
  "kind": "image", "id": "seal", "resourceId": "seal", "reserve": false,
  "placement": {
    "anchor": { "to": "page", "edge": "bottom-right" },
    "offset": { "x": { "value": -25, "unit": "mm" }, "y": { "value": -25, "unit": "mm" } },
    "size": { "width": { "value": 30, "unit": "mm" } }
  }
}

Un element ancorat a un altre que no reserva continua comptant tret que també el marquis (un rètol compost damunt del segell necessita el seu propi reserve: false).

On es pinta. El disseny d'una obertura (span: 'page') es dibuixa abans que el cos, així que la decoració que no reserva espai queda sota el text. El disseny d'un encapçalament de columna es dibuixa amb el bloc de l'encapçalament —damunt dels blocs que el precedeixen a la columna i sota dels que el segueixen— allà on estigui col·locat per damunt del peu de la seva columna: també als marges laterals, al marge superior, a la sang i a les columnes veïnes. El peu de la columna el talla, al llenç i al PDF, perquè allà acaba el flux (vegeu Més alt que la columna més avall). Fins a postext 1.4 el llenç i el PDF també el tallaven a la part alta de la seva columna, de manera que una banda ancorada a la part alta de la pàgina o de la sang entrava als marges laterals però s'aturava al marge superior. La decoració ancorada al peu de la pàgina va en una obertura, o al disseny del peu amb pages: 'opener'.

Més alt que la columna. Quan l'espai arriba més enllà del peu de la columna —un minHeight tan alt com la pàgina, una imatge o un marc que baixen fins al tall—, l'encapçalament reclama la resta de la seva pàgina (una obertura, a totes les seves columnes) o de la seva columna (un encapçalament de columna), i el text que el segueix comença a la pàgina o a la columna següent. El seu bloc arriba llavors fins al peu de la columna, sense retallar-se mai a l'alçada del seu text, de manera que la banda contra la qual es compon el seu disseny és l'espai que reclama (minHeight inclòs, fins al peu). Un disseny més alt que la mateixa pàgina —una entradeta llarga en una pàgina de pantalla petita— continua tallant-se al peu de la pàgina (un disseny de columna, al de la seva columna): el Sandbox ho assenyala al tauler Revisió com a Disseny de títol tallat. La maquetació no emet cap avís per això —una portada que reclama la seva pàgina és el més habitual i no perd res—, però qualsevol amfitrió pot fer la mateixa comprovació sobre la maquetació acabada: collectHeadingDesignCuts(doc) retorna un { kind: 'headingDesignCut', pageIndex, level, where, overflowPx, sourceStart, sourceEnd } per cada encapçalament el text de disseny del qual queda més enllà del peu del tall de la pàgina (where: 'page', una obertura) o de la seva columna (where: 'column'), i formatWarning en descriu cadascun. Vegeu Una obertura tan alta com la pàgina a Span i disseny avançat.

La columna lateral. En una disposició de columna i mitja la columna lateral de la qual acull flotants (sideColumnRole: 'floats'), un element del disseny d'un encapçalament de columna que cau a la columna lateral —un numeral de capítol ancorat a la pàgina a la columna del marge exterior, a l'obertura d'un llibre de text— manté la pila lateral apartada. Cada figura, taula o requadre amb span: 'side' que la pàgina col·loca després de l'encapçalament deixa un buit de flotant lliure al voltant de cadascun d'aquests elements: es queda on el posa la pila quan hi cap per damunt de l'element i, si no, passa per sota —o espera a la pàgina següent quan la resta de la columna lateral no el pot acollir allà—. Així, un numeral al capdamunt del canal manté tota la pila per sota, mentre que un número de secció penjat al marge al costat d'un encapçalament més avall de la pàgina deixa el capdamunt del canal a les figures que cita la pàgina (la figura marginal continua al capdamunt de la seva pàgina). El que la columna lateral ja acull quan es col·loca l'encapçalament no es mou: una figura apilada abans a la pàgina que arriba fins a l'element de l'encapçalament es queda on és, a sota de l'element; per això, si el disseny té un element a la columna lateral a mitja pàgina, convé citar-ne les figures després de l'encapçalament. Els elements amb reserve: false deixen lliure la columna lateral, igual que deixen lliure el text. Una obertura (span: 'page') no necessita res d'això: la seva banda es reserva a totes les columnes, la lateral inclosa. Fins a postext 1.4 una figura lateral citada en una obertura així es col·locava al capdamunt de la columna lateral, damunt del numeral.

Portades. Per això un encapçalament de portada que omple la seva pàgina —amb un minHeight tan alt com la pàgina, o amb una imatge a pàgina completa al seu disseny— envia tot sol el text que el segueix a la pàgina següent, tant en disposicions d'una columna com de diverses. Un :::pagebreak just darrere és opcional i no fa mal: un salt de pàgina en una pàgina encara buida no fa res, així que mai no afegeix una pàgina en blanc. Només cal quan el disseny de la portada acaba abans del peu de la pàgina i tot i així el text ha de començar en una pàgina nova.

# Memòria anual 2026 {style="portada"}
 
:::pagebreak
 
# Carta de la presidenta

#Nombres en lletres

Dos sufixos de les plantilles de numeració escriuen un comptador en lletres, en la llengua del document (el locale de primer nivell o, si no està definit, la llengua de partició — vegeu Llengua del document): words per al cardinal i ordinal per a l'ordinal. La caixa (majúscula o minúscula) del sufix fixa la de les paraules, com fan A / a amb les lletres:

S'escriuen en lletres l'anglès, l'espanyol, el francès, l'italià, l'alemany, el català, el portuguès, el xinès, el japonès i l'àrab; qualsevol altra llengua pren les paraules en anglès, com fan les cadenes integrades de continuació de taules. El xinès escriu els numerals informals de simp-chinese-informal o trad-chinese-informal, segons l'escriptura de locale (一万 / 一萬), amb 第 davant de l'ordinal; els caràcters han no tenen caixa, així que les tres grafies d'un sufix imprimeixen el mateix. L'anglès segueix l'ús nord-americà (one hundred five, sense and). L'espanyol fa servir per defecte les formes masculines, com es numera un capítulo o un libro (capítulo primero, tercero, veintiuno), i escriu els ordinals del 13 al 29 en una sola paraula, com prefereix la RAE (decimotercero, vigesimoprimero). Els cardinals s'escriuen fins a 999 999 i els ordinals espanyols, catalans i portuguesos fins a 999; els nombres més grans s'imprimeixen en xifres.

El francès segueix l'ortografia tradicional (vingt et un, soixante et onze, quatre-vingts, deux cent un) i escriu premier per a l'u (Chapitre premier, però vingt et unième); l'italià escriu cada nombre en una sola paraula (ventuno, ventitré, duemilaventiquattro; primo, ventunesimo), i l'alemany també (einundzwanzig, hunderteins; erste, einundzwanzigste), amb ss per ß en l'alemany de Suïssa (de-CH); el català segueix l'IEC (vint-i-u, dos-cents; primer, cinquè, vint-i-unè), i el portuguès és el del Brasil (dezesseis) llevat que locale indiqui una altra regió (pt-PT: dezasseis), amb els ordinals llatins (vigésimo primeiro). Els ordinals catalans i portuguesos, com els espanyols, s'escriuen fins a 999.

Les llengües romàniques llegeixen el modificador de gènere: -feminine (o -f) fa concordar les paraules amb un substantiu femení (Lliçó {1:ordinal-f} dona Lliçó primera, {1:Ordinal-f} partie dona en francès Première partie; i igualment vint-i-una, dues-centes, veintiuna, duzentas), i -masculine (-m) és el valor per defecte. En alemany el cardinal no varia (Kapitel eins), però l'ordinal sí: sense modificador porta la terminació que té després de l'article, igual en els tres gèneres (Das {1:ordinal} Kapitel dona Das erste Kapitel); davant d'un substantiu sense article, -masculine dona Erster Teil, -feminine Erste Lektion i -neuter (-n) Erstes Kapitel. Els nombres alemanys s'escriuen en minúscula, com els escriu la llengua (Kapitel {1:words} dona Kapitel eins); {1:Words} posa la inicial en majúscula, per a la paraula que obre el títol, i {1:WORDS} escriu la ß com a SS.

Els nombres àrabs concorden en gènere amb el substantiu que compten, així que el sufix admet un modificador: -feminine (o -f) per a un substantiu femení, -masculine (-m, el valor per defecte) per a un de masculí; -classical escriu les centenes مائة, com les edicions de Bulaq i la majoria de les egípcies, en lloc del modern مئة. {1:ordinal} escriu l'ordinal definit en nominatiu que fa servir un títol: الفصل {1:ordinal} dona الفصل الأول, الفصل الحادي عشر, الفصل الحادي والعشرون; الليلة {1:ordinal-feminine} dona الليلة الأولى, الليلة الحادية عشرة, الليلة الحادية والعشرون, الليلة المئتان i, per damunt de cent, la fórmula clàssica de «després de»: الليلة الخامسة والأربعون بعد الثلاثمئة, الليلة الحادية بعد الألف. {1:words} escriu el cardinal (واحد وعشرون; en femení إحدى عشرة, واحدة وعشرون). Els ordinals s'escriuen en lletres fins a 9 999 i els cardinals fins a 99 999; els modificadors es combinen ({1:ordinal-f-classical}); les llengües romàniques i l'alemany només en llegeixen el gènere (vegeu més amunt), i les altres llengües els ignoren. L'àrab no té majúscules, així que la caixa del sufix no canvia res. Els marcadors de disseny {numberWords} i {numberOrdinalWords} escriuen les formes masculines; per a una obertura en femení, posa l'ordinal a la plantilla del nivell i imprimeix-lo amb {number}.

En un disseny d'encapçalament, {numberWords} / {numberWordsLower} i {numberOrdinalWords} / {numberOrdinalWordsLower} escriuen el comptador de l'encapçalament de la mateixa manera, així l'obertura pot dir Capítulo uno mentre l'índex mostra 1. El textTransform: 'uppercase' d'un element de text dona les majúscules:

// Novel·la en espanyol: «CAPÍTULO PRIMERO» damunt del títol, «1.» a l'índex.
{ level: 1, numberingTemplate: '{1}.', span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'n', content: 'Capítulo {numberOrdinalWordsLower}', textTransform: 'uppercase', /* … */ },
    { kind: 'text', id: 't', content: '{titleText}', /* … */ },
  ] } } }