# Cites i estadístics fora de les vores de línia

> Un article a dues columnes compost dues vegades: les primeres proves avisen de cada cita o signe a la vora d'una línia; les segones encareixen aquests talls.

- Versió HTML: https://postext.dev/ca/cookbook/clinical-paper-line-edges
- Recepta Núm. 186 · Text i tipografia · Nivell 2 (Intermedi) · Sortides: Canvas
- Gèneres: Articles i treballs acadèmics
- Requereix postext ≥ 1.79.0 · provada amb 1.79.0 el 2026-11-12
- Pàgines: [211](https://postext.dev/cookbook/clinical-paper-line-edges/es/p01.webp?v=112a1714), [212](https://postext.dev/cookbook/clinical-paper-line-edges/es/p02.webp?v=112a1714), [213](https://postext.dev/cookbook/clinical-paper-line-edges/es/p03.webp?v=112a1714), [213](https://postext.dev/cookbook/clinical-paper-line-edges/es/p06.webp?v=112a1714)
- Obre al Sandbox: https://postext.dev/ca/sandbox#recipe=clinical-paper-line-edges&lang=es (.postext: https://postext.dev/cookbook/clinical-paper-line-edges/es/clinical-paper-line-edges.postext)
- Última actualització: 2026-11-12
- Altres idiomes: [en](https://postext.dev/en/cookbook/clinical-paper-line-edges.md), [es](https://postext.dev/es/cookbook/clinical-paper-line-edges.md), [de](https://postext.dev/de/cookbook/clinical-paper-line-edges.md), [fr](https://postext.dev/fr/cookbook/clinical-paper-line-edges.md), [it](https://postext.dev/it/cookbook/clinical-paper-line-edges.md), [pt](https://postext.dev/pt/cookbook/clinical-paper-line-edges.md), [zh](https://postext.dev/zh/cookbook/clinical-paper-line-edges.md), [ja](https://postext.dev/ja/cookbook/clinical-paper-line-edges.md), [ar](https://postext.dev/ar/cookbook/clinical-paper-line-edges.md)

## En poques paraules

En una columna justificada estreta, una crida com [2, 3] pot quedar sola a principi de línia, i p < 0,05 es pot partir després del signe. L'article es compon dues vegades: una ensenya on passa i l'altra ho evita gairebé sempre.

## Què compondràs

Tres pàgines d'una revista de pediatria de 170 × 240 mm, a dues columnes justificades de 66 mm en STIX Two Text: un estudi original sobre l'ecografia pulmonar en la pneumònia infantil, amb la bibliografia numerada en estil Vancouver. Una columna tan estreta deixa al tallador de línies poques sortides, i en quatre llocs el text en castellà es talla malament. Dues vegades la crida *[4, 5]* es parteix entre dues línies, lluny de la paraula a què es refereix, i dues vegades un estadístic se separa del seu signe: *kappa* sobre *= 0,84*, *CP+* sobre *= 19,19*. Les primeres proves es componen amb `citationBreaks` i `operatorBreaks` en `'warn'`: no canvien cap tall, marquen cadascun amb una banda ambre pàl·lid i els llisten en una papereta després de la bibliografia. Les segones es componen amb `'avoid'`, i en queda un dels quatre. L'edició anglesa compon el mateix estudi amb punt decimal.

**Aquesta recepta respon a:**

- Com evito que una crida bibliogràfica o un estadístic com p < 0,05 es parteixi al final d'una línia?
- Com poso els números de cita en superíndex i faig que els DOI siguin enllaços, com a les revistes mèdiques?

## La resposta curta

```js
// script.js, línies 27–42
const bodyText = {
  fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  referenceBold: false, textAlign: 'justify', firstLineIndent: mm(3.5),
  indentAfterHeading: false, hyphenation: { enabled: true },
  optimalLineBreaking: true, // the rules price breaks in the Knuth–Plass breaker
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
  // A line that opens on a citation, "[8, 9]" (citationBreak), or ends or opens on a sign
  // set between spaces, "p <" / "0.05" (operatorBreak). 'warn' reports each one and changes
  // nothing; 'avoid' adds the penalty to the demerits of those breaks and reports the ones
  // it keeps. The first proof sets 'warn' (see proofs).
  citationBreaks: 'avoid', operatorBreaks: 'avoid',
  // 10000 by default, what a line spaced to the limit costs. A 66 mm column offers few other
  // breaks; at 30000 the breaker takes looser lines, never past maxWordSpacing.
  citationBreakPenalty: 30000, operatorBreakPenalty: 30000,
};
```

## Ingredients

**Ensenya**

- [Cites i signes als extrems de línia](https://postext.dev/ca/docs/configuration-text.md#text-de-cos): Troba les línies que comencen amb una cita numerada ([12], (12–15)) o que acaben o comencen amb un signe entre espais (p < 0,05, CP+ = 19,19), i les assenyala (bodyText.citationBreaks / operatorBreaks: 'warn') o fa que el tall de línies compongui el paràgraf d'una altra manera ('avoid', al cost citationBreakPenalty / operatorBreakPenalty).
- [Tall de línies òptim (Knuth–Plass)](https://postext.dev/ca/docs/justification.md#knuth-plass-veure-el-paràgraf-sencer): Talla cada paràgraf en conjunt per igualar l'espai entre paraules, dins dels límits fixats, en lloc d'omplir línia a línia.

**També fa servir**

- [Cites en un estil de cita](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia)
- [Bibliografia a partir de les referències](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia)
- [Marques de ressaltat](https://postext.dev/ca/docs/document-format-inline.md#marques-de-ressaltat)
- [Partició de mots i llengua del document](https://postext.dev/ca/docs/justification.md#llengües-compatibles)
- [Una o dues columnes](https://postext.dev/ca/docs/configuration-page-layout.md#tipus-de-disposició)
- [Obertures dissenyades](https://postext.dev/ca/docs/configuration-headings.md#extensió-i-disseny-avançat)
- [Atributs de títol](https://postext.dev/ca/docs/document-format.md#atributs-dencapçalament)
- [Estils de títol](https://postext.dev/ca/docs/configuration-styles.md#estils-dencapçalament)
- [Capçaleres i folis](https://postext.dev/ca/docs/configuration-headers-footers.md#capçaleres-i-peus)
- [Capçaleres segons el tipus de pàgina](https://postext.dev/ca/docs/configuration-headers-footers.md#elements-de-text)
- [Marges simètrics](https://postext.dev/ca/docs/configuration-page-layout.md#marges-simètrics)
- [Requadres](https://postext.dev/ca/docs/configuration-callouts.md#estils-de-requadre)
- [Paleta de color semàntica](https://postext.dev/ca/docs/configuration-fonts-colors-viewers.md#paleta-de-colors)
- [Sortir de la retícula a propòsit](https://postext.dev/ca/docs/architecture.md#elements-que-trenquen-la-retícula)
- [Estils de paràgraf](https://postext.dev/ca/docs/configuration-styles.md#estils-de-paràgraf)
- [Preliminars en romans](https://postext.dev/ca/docs/document-format-directives.md#numbering)
- [Superíndexs i subíndexs](https://postext.dev/ca/docs/document-format-inline.md#format-en-línia)
- [Capítols sense número](https://postext.dev/ca/docs/configuration-styles.md#estils-dencapçalament)

**La configuració d'un cop d'ull**

- [`bodyText`](https://postext.dev/ca/docs/configuration-text.md#text-de-cos), [`calloutStyles`](https://postext.dev/ca/docs/configuration-callouts.md#estils-de-requadre), [`checks`](https://postext.dev/ca/docs/configuration-fonts-colors-viewers.md#comprovació-del-contingut-configuració), [`citations`](https://postext.dev/ca/docs/configuration-notes-references.md#cites), [`colorPalette`](https://postext.dev/ca/docs/configuration-fonts-colors-viewers.md#paleta-de-colors), [`footer`](https://postext.dev/ca/docs/configuration-headers-footers.md#capçaleres-i-peus), [`header`](https://postext.dev/ca/docs/configuration-headers-footers.md#capçaleres-i-peus), [`headingStyles`](https://postext.dev/ca/docs/configuration-styles.md#estils-dencapçalament), [`headings`](https://postext.dev/ca/docs/configuration-headings.md#encapçalaments), [`layout`](https://postext.dev/ca/docs/configuration-page-layout.md#disposició), [`locale`](https://postext.dev/ca/docs/configuration-language.md#partició-de-mots), [`markStyles`](https://postext.dev/ca/docs/configuration-styles.md#estils-de-ressaltat), [`page`](https://postext.dev/ca/docs/configuration-page-layout.md#pàgina), [`paragraphStyles`](https://postext.dev/ca/docs/configuration-styles.md#estils-de-paràgraf)

**API**

- [`LOCALES`](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia), [`STYLES`](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia), [`buildDocumentWithFonts`](https://postext.dev/ca/docs/configuration-programmatic-usage.md#carregar-les-fonts-abans-de-compondre), [`createCiteprocEngine`](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia), [`registerCitationEngine`](https://postext.dev/ca/docs/document-format-notes-references.md#citacions-i-bibliografia), [`renderPageToCanvas`](https://postext.dev/ca/docs/configuration-programmatic-usage.md#renderitzar-una-pàgina-en-un-mapa-de-bits)

**Tipus de lletra**

- STIX Two Text (OFL-1.1), IBM Plex Sans (OFL-1.1), IBM Plex Sans Condensed (OFL-1.1)

## Elaboració

### 1 · Un preu per a dues classes de tall

El codi és [la resposta curta](https://postext.dev/ca/cookbook/clinical-paper-line-edges.md#la-resposta-curta) de més amunt. Hi ha tall de cita quan una línia comença amb una crida numerada o amb la segona meitat d'una, com *5]* després de *[4,*. Hi ha tall de signe quan una línia acaba o comença amb un signe entre espais: `=`, `<`, `±`, `×`, el menys. `'warn'` avisa de tots dos i deixa les línies com són. `'avoid'` suma una penalització als demèrits d'aquests talls, i el tallador de Knuth–Plass busca una altra manera de partir el paràgraf. Necessita `optimalLineBreaking`: el tallador voraç no té demèrits als quals sumar res.

La penalització per defecte, 10000, és el que costa una línia estirada fins al límit de l'espai entre paraules, de manera que el tallador no obre mai una línia més enllà d'aquest límit per deixar una cita al costat de la seva paraula. En aquesta columna, 10000 deixava dos talls a cada edició. Amb 30000 el tallador accepta línies més obertes, sempre dins de `maxWordSpacing`, i en queda un a cada edició. Un valor més alt ja no canviava res: l'últim tall no té alternativa dins del límit.

### 2 · Marcar els talls al text

```js
// script.js, línies 254–279
// The word before the citation and the citation, or the sign and the number on its other
// side, wrapped in :mark[…]: a band under ordinary text, so the breaks stay where they were.
const wordEnd = (s, i) => i + s.slice(i).search(/[\s;)]|[,.](?!\d)|$/); // 0.09, not 0
function sides(source, w, a, b) { // a warning names line a, before the break, by its source
  if (w.kind === 'citationBreak') { // "colleagues [@simel1991]"
    const cite = source.lastIndexOf('[@', b.sourceStart + 2);
    return [source.lastIndexOf(' ', cite - 2) + 1, source.indexOf(']', cite) + 1];
  }
  if (w.edge === 'end') { // "LR− = 0.09": the sign ends line a, the number opens line b
    const from = source.lastIndexOf(` ${w.text} `, a.sourceEnd) + 1;
    return [from, wordEnd(source, from + w.text.length + 1)];
  }
  const sign = source.indexOf(` ${w.text} `, b.sourceStart - 1); // the sign opens line b
  return [source.lastIndexOf(' ', sign - 1) + 1, sign + 1 + w.text.length];
}
function markBreaks(source, doc, found) {
  const pairs = doc.blocks.flatMap((b) => b.lines.map((line, i) => [line, b.lines[i + 1]]));
  const spans = new Map();
  for (const w of found) {
    const [a, b] = pairs.find(([line]) => line.sourceStart === w.sourceStart) ?? [];
    const [from, to] = b ? sides(source, w, a, b) : [];
    if (from > a?.sourceStart && to > from && to <= b.sourceEnd) spans.set(from, to);
  }
  return [...spans].sort(([x], [y]) => y - x).reduce((md, [from, to]) => `${md.slice(0, from)}`
    + `:mark[${md.slice(from, to)}]{style="edge"}${md.slice(to)}`, source);
}
```

Cada avís porta la seva classe, la cita o el signe, el text de les dues línies, la posició al text font de la primera i la pàgina. L'script busca aquestes dues línies al document compost i embolica el tall amb `:mark[…]`: la paraula anterior a la cita i la cita, o el signe i el número de l'altra banda. Una marca pinta una banda sota el text i deixa els talls on eren. La banda no arriba al número que genera l'estil de cites, així que a la pàgina només es marca la paraula anterior.

![Página 212: Prueba en estudio.](https://postext.dev/cookbook/clinical-paper-line-edges/es/p02.webp?v=112a1714)

*Primeres proves, pàgina 212: kappa al final d'una línia i = 0,84 al principi de la següent.*

### 3 · Dues proves i una papereta de consultes

```js
// script.js, línies 283–303
const KIND = { citationBreak: t({ en: 'citation', es: 'cita' }),
  operatorBreak: t({ en: 'sign', es: 'signo' }) };
const edge = (s, end) => (end ? s.trim().split(/\s+/).slice(-2) : s.trim().split(/\s+/)
  .slice(0, 2)).join('\u00a0').replace(/[.,;]$/, ''); // no-break spaces: no breaks of its own
const query = (doc, w) => `${t({ en: 'p.', es: 'pág.' })}\u00a0${doc.pages[w.pageIndex]
  .pageLabel}, ${KIND[w.kind]}: …${edge(w.lines[0], true)}\u00a0/ ${edge(w.lines[1])}…`;
const slip = (mode, doc, found) => ['', `:::callout{type="slip" title="${mode === 'warn'
  ? t({ en: 'First proof: queries', es: 'Primeras pruebas: consultas' })
  : t({ en: 'Second proof: queries', es: 'Segundas pruebas: consultas' })}"}`,
`citationBreaks / operatorBreaks: '${mode}' · ${found.length} ${found.length === 1
  ? t({ en: 'break', es: 'corte' }) : t({ en: 'breaks', es: 'cortes' })}.`,
...found.flatMap((w) => ['', query(doc, w)]), ':::', ''].join('\n');
const build = (md, mode) => buildDocumentWithFonts({ markdown: md }, { ...config,
  bodyText: { ...bodyText, citationBreaks: mode, operatorBreaks: mode } }, kitFonts(FONTS));
async function proof(mode) {
  const plain = await build(markdown, mode); // pass 1: where the breaks are
  const found = (plain.contentWarnings ?? []).filter((w) => /^(citation|operator)Break$/
    .test(w.kind));
  return build(markBreaks(markdown, plain, found) + slip(mode, plain, found), mode); // pass 2
}
const docs = { warn: await proof('warn'), avoid: await proof('avoid') };
```

Cada prova es compon dues vegades. La primera composició troba els talls; la segona compon l'article amb les marques i una papereta després de la bibliografia, de manera que la papereta cau a l'última pàgina. Així torna un caixista les proves amb les seves consultes. Les línies de la papereta uneixen les paraules amb espais de no separació, per no afegir-hi talls propis. `capture.doc` publica les dues composicions marcades, `[1, 3]`.

![Página 213: Discusión.](https://postext.dev/cookbook/clinical-paper-line-edges/es/p06.webp?v=112a1714)

*Segones proves, pàgina 213: la papereta llista un tall en tot l'article.*

El tall que queda en castellà és *anteriores [4,* sobre *5]*, a la pàgina 213. A l'edició anglesa les primeres proves en troben tres, entre els quals *LR− =* sobre *0.09* dues vegades, i les segones en deixen un, *first* sobre *[2, 3]*.

### 4 · Crides numerades entre claudàtors

```js
// script.js, línies 46–50
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = { style: 'elsevier-vancouver', locale: t({ en: 'en-GB', es: 'es-ES' }),
  marker: 'brackets', collapseRanges: true, // [8, 9] and [4–6], set after a word space
  bibliography: { fontSize: em(0.8), lineHeight: pt(9.6), entrySpacing: pt(1),
    labelWidth: mm(6), labelAlign: 'right', doi: 'hide' } };
```

El processador de cites compon cada `[@clave]` com un número entre claudàtors després d'un espai i agrupa les sèries com *[4–6]*. L'espai anterior al claudàtor i el que segueix una coma dins seu són llocs on una línia es pot tallar; per això una columna estreta amb moltes cites necessita la regla.

### 5 · La capçalera i el bloc de l'article

```js
// script.js, línies 54–78
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = { fontFamily: COND, fontWeight: 600, letterSpacing: pt(1.2),
  textTransform: 'uppercase' };
const JOURNAL = t({ en: 'Ribera Paediatric Journal', es: 'Revista Pediátrica de la Ribera' });
const white = { ...caps, color: col('paper') };
const titleBlock = { enabled: true, minHeight: mm(58), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('accent') }, placement: {
    anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(13) } } },
  text('journal', JOURNAL, COND, 9, { ...white, placement: at('page', 'top-left', INNER, 5) }),
  text('issue', '{attr.issue}', COND, 9, { ...white, align: 'right',
    placement: at('page', 'top-right', -OUTER, 5, 60) }),
  text('kind', '{attr.kind}', COND, 8.5, { ...caps, color: col('accent'),
    placement: at('container', 'top-left', 0, 0, MEASURE) }),
  text('title', '{titleText}', SANS, 16, { fontWeight: 600, lineHeight: 1.18,
    placement: at('#kind', 'below', 0, 2.5, MEASURE - 6) }),
  text('authors', '{attr.authors}', SERIF, 10, { inlineMarks: true, // ^1^ → ¹
    placement: at('#title', 'below', 0, 3.5, MEASURE) }),
  text('affiliations', '{attr.affiliations}', SANS, 7.2, { inlineMarks: true, lineHeight: 1.35,
    color: col('muted'), placement: at('#authors', 'below', 0, 1.6, MEASURE) }),
  text('note', '{attr.note}', SANS, 7.2, { color: col('muted'),
    placement: at('#affiliations', 'below', 0, 2.4, MEASURE) }),
] } };
```

L'estil del títol dibuixa la banda de la revista, el tipus d'article, el títol, els autors amb els seus números de filiació i una nota, tot a partir d'atributs de l'H1. Les dues edicions comparteixen l'estil, i el text es queda al Markdown.

## La recepta completa

Un sol fitxer, compost a partir de la carpeta de la recepta amb el text d'exemple i el kit comú del Receptari ja inclosos; construeix la seva pròpia pàgina. Per executar-lo, posa'l en un `<script type="module">` d'una pàgina buida o enganxa'l al tauler JS d'un pen nou de CodePen (com a mòdul). Importa postext des d'esm.sh, així que no cal instal·lar ni compilar res.

- Carpeta de la recepta: https://github.com/drnachio/postext/tree/main/cookbook/clinical-paper-line-edges

### script.js

```js
// ═══ Postext Cookbook · Nº 186 · Citations and statistics off the line edges ═══════════
// https://postext.dev/en/cookbook/clinical-paper-line-edges
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: STIX Two Text, IBM Plex Sans and Sans Condensed (SIL OFL 1.1) · Needs postext ≥ 1.79.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'clinical-paper-line-edges';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: an indigo journal, a pale amber band for the proof marks
const palette = { ink: '#1b1e26', accent: '#2c4a7c', tint: '#e9eef6', mark: '#f7dfa9',
  muted: '#596173', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS, COND] = ['STIX Two Text', 'IBM Plex Sans', 'IBM Plex Sans Condensed'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [170, 240, 20, 22, 17, 15, 6];
const MEASURE = TRIM_W - INNER - OUTER; // 138 mm: two columns of 66 mm, about 45 characters
const LEAD = 12.8; // pt, for 9.5 pt type

// #region answer: no line opens on a citation, no line ends or opens on a lone sign
const bodyText = {
  fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  referenceBold: false, textAlign: 'justify', firstLineIndent: mm(3.5),
  indentAfterHeading: false, hyphenation: { enabled: true },
  optimalLineBreaking: true, // the rules price breaks in the Knuth–Plass breaker
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
  // A line that opens on a citation, "[8, 9]" (citationBreak), or ends or opens on a sign
  // set between spaces, "p <" / "0.05" (operatorBreak). 'warn' reports each one and changes
  // nothing; 'avoid' adds the penalty to the demerits of those breaks and reports the ones
  // it keeps. The first proof sets 'warn' (see proofs).
  citationBreaks: 'avoid', operatorBreaks: 'avoid',
  // 10000 by default, what a line spaced to the limit costs. A 66 mm column offers few other
  // breaks; at 30000 the breaker takes looser lines, never past maxWordSpacing.
  citationBreakPenalty: 30000, operatorBreakPenalty: 30000,
};
// #endregion

// #region citations: numbered references in brackets, the list in the Vancouver order
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = { style: 'elsevier-vancouver', locale: t({ en: 'en-GB', es: 'es-ES' }),
  marker: 'brackets', collapseRanges: true, // [8, 9] and [4–6], set after a word space
  bibliography: { fontSize: em(0.8), lineHeight: pt(9.6), entrySpacing: pt(1),
    labelWidth: mm(6), labelAlign: 'right', doi: 'hide' } };
// #endregion

// #region title: the masthead band, article type, title, authors and the note
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = { fontFamily: COND, fontWeight: 600, letterSpacing: pt(1.2),
  textTransform: 'uppercase' };
const JOURNAL = t({ en: 'Ribera Paediatric Journal', es: 'Revista Pediátrica de la Ribera' });
const white = { ...caps, color: col('paper') };
const titleBlock = { enabled: true, minHeight: mm(58), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('accent') }, placement: {
    anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(13) } } },
  text('journal', JOURNAL, COND, 9, { ...white, placement: at('page', 'top-left', INNER, 5) }),
  text('issue', '{attr.issue}', COND, 9, { ...white, align: 'right',
    placement: at('page', 'top-right', -OUTER, 5, 60) }),
  text('kind', '{attr.kind}', COND, 8.5, { ...caps, color: col('accent'),
    placement: at('container', 'top-left', 0, 0, MEASURE) }),
  text('title', '{titleText}', SANS, 16, { fontWeight: 600, lineHeight: 1.18,
    placement: at('#kind', 'below', 0, 2.5, MEASURE - 6) }),
  text('authors', '{attr.authors}', SERIF, 10, { inlineMarks: true, // ^1^ → ¹
    placement: at('#title', 'below', 0, 3.5, MEASURE) }),
  text('affiliations', '{attr.affiliations}', SANS, 7.2, { inlineMarks: true, lineHeight: 1.35,
    color: col('muted'), placement: at('#authors', 'below', 0, 1.6, MEASURE) }),
  text('note', '{attr.note}', SANS, 7.2, { color: col('muted'),
    placement: at('#affiliations', 'below', 0, 2.4, MEASURE) }),
] } };
// #endregion

const small = { fontFamily: SANS, fontSize: pt(7.8), lineHeight: pt(10.6), textAlign: 'left',
  firstLineIndent: pt(0), color: col('ink'), boldColor: col('accent') };
const box = (id, spaced, more) => ({ id, border: { enabled: false }, snapToGrid: false,
  background: col('tint'), padding: mm(3), marginTop: pt(LEAD / 2), marginBottom: pt(LEAD),
  titleStyle: { ...caps, fontSize: pt(8), color: col('accent') },
  body: { ...small, paragraphSpacing: spaced }, ...more });
const calloutStyles = [box('abstract', true, { marginTop: pt(0) }), box('slip', false,
  { stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('accent') } })];
const head = (id, content, parity, edge, x, extra) => text(id, content, COND, 7.8, {
  parity, pages: 'body', fontWeight: 500, letterSpacing: pt(0.4), color: col('muted'),
  overflow: 'clip', placement: at('page', edge, x, 11, 100), ...extra });
const [folio, right] = [{ fontWeight: 600, color: col('accent') }, { align: 'right' }];
const header = { elements: [
  head('v-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
  head('v-title', '{attr.verso}', 'even', 'top-left', OUTER + 9), // the H1's attributes
  head('r-title', '{attr.recto}', 'odd', 'top-right', -OUTER - 9, right),
  head('r-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, { ...folio, ...right }),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom-right', -OUTER,
  { ...folio, ...right, pages: 'opener', placement: at('page', 'bottom-right', -OUTER, -12, 10) },
)] };

const sans = (size) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 600 });
const config = {
  locale: t({ en: 'en-gb', es: 'es' }),
  colorPalette, citations, calloutStyles, header, footer, bodyText,
  checks: { contentInConfig: { allow: [JOURNAL] } }, // the journal's name (#849)
  headingStyles: [{ id: 'article', numbered: false, span: 'page', advancedDesign: titleBlock },
    { id: 'back', numbered: false, ...sans(9), color: col('ink') }],
  page: { sizePreset: 'custom', width: mm(TRIM_W), height: mm(TRIM_H), dpi: 150,
    pageNumbering: { startAt: 211 }, // the article opens on page 211 of the issue
    margins: { top: mm(TOP), bottom: mm(BOTTOM), left: mm(INNER), right: mm(OUTER),
      mirror: true } },
  layout: { layoutType: 'double', gutterWidth: mm(GUTTER) },
  headings: { fontFamily: SANS, color: col('accent'), fontWeight: 600, levels: [
    { level: 1, breakBefore: { enabled: true, parity: 'any' } },
    { level: 2, ...sans(10.5), lineHeight: pt(LEAD), marginTop: pt(LEAD), marginBottom: pt(0) },
    { level: 3, ...sans(9), color: col('ink'), lineHeight: pt(LEAD), marginTop: pt(LEAD / 2),
      marginBottom: pt(0) },
  ] },
  paragraphStyles: [{ id: 'info', ...small }], // the article information, as journals set it
  markStyles: [{ id: 'edge', name: t({ en: 'Line edge', es: 'Borde de línea' }), color: col('ink'),
    background: col('mark'), paddingX: em(0.08), paddingTop: em(0.02), paddingBottom: em(0.08) }],
};

// ─── 2 · Content ────────────────────────────────────────────────────────────
const markdown = String.raw`---
title: "Ecografía pulmonar para la neumonía en niños"
author: "Inés Barreiro Soto, Tomasz Wierzbicki, Aisha Mensah y Pablo Lago Fernández"
---

# Ecografía pulmonar a pie de cama para la neumonía adquirida en la comunidad en niños: estudio prospectivo de precisión diagnóstica {style="article" issue="2026 · 9(4) · 211–213" verso="Rev Pediatr Ribera 2026;9(4)" recto="Barreiro Soto et al. · Ecografía pulmonar en la neumonía" kind="Original" authors="Inés Barreiro Soto^1^, Tomasz Wierzbicki^2^, Aisha Mensah^1^, Pablo Lago Fernández^3^" affiliations="^1^ Urgencias de Pediatría, Hospital Comarcal de la Ribera\n^2^ Servicio de Radiología, Hospital Comarcal de la Ribera\n^3^ Unidad de Epidemiología Clínica, Área Sanitaria de la Ribera" note="Artículo de ejemplo escrito para el Recetario de Postext: el estudio, sus autores y sus datos son inventados. Las obras citadas son reales."}

:::callout{type="abstract" title="Resumen"}
**Objetivo** Saber con qué precisión diagnostican los pediatras de urgencias la neumonía adquirida en la comunidad en niños mediante ecografía pulmonar, frente a la radiografía de tórax leída por dos radiólogos y una revisión al día 14.

**Métodos** Incluimos a 412 niños de 3 meses a 15 años que acudieron a un servicio de urgencias con fiebre y tos o respiración rápida. Uno de nueve pediatras exploró a cada niño antes de la radiografía, tras un curso de seis horas.

**Resultados** Se diagnosticó neumonía en 139 niños (33,7 %). La ecografía tuvo una sensibilidad del 91,4 % (IC del 95 %: 85,5 a 95,0) y una especificidad del 95,2 % (92,0 a 97,2), de modo que CP+ = 19,19 y CP− = 0,09. La exploración duró una mediana de 6 minutos.

**Conclusiones** Tras un curso breve, los pediatras de urgencias confirman o descartan la neumonía con la ecografía casi tan bien como la radiografía, y sin radiación.
:::

## Introducción

La neumonía es la infección grave más frecuente de la infancia y el motivo de muchas de las radiografías de tórax que se piden en las urgencias de pediatría. Las guías británicas desaconsejan la radiografía sistemática en el niño que puede tratarse en su casa [@harris2011], pero la placa se pide a menudo para salir de dudas ante una exploración poco clara, y dos radiólogos que leen la misma placa no siempre coinciden.

La ecografía pulmonar mira la misma enfermedad por otra ventana. El pulmón consolidado transmite el sonido y aparece como una zona sólida, parecida al hígado, con broncogramas aéreos brillantes, signos que se describieron y estandarizaron primero en adultos [@lichtenstein2008; @volpicelli2012]. En el niño, la pared torácica fina facilita la exploración, y un metanálisis y un estudio prospectivo amplio la encontraron sensible y específica [@pereda2015; @shah2013]. Sin embargo, la mayoría de esas ecografías las hicieron ecografistas o unos pocos médicos con mucha experiencia, y no se sabe si las cifras se mantienen cuando la exploración es una tarea más en una guardia de noche.

Medimos la precisión de la ecografía pulmonar hecha por los pediatras de urgencias de un hospital comarcal tras un curso breve, y la comunicamos según pide STARD 2015 [@bossuyt2015].

## Métodos

### Participantes

Entre el 1 de octubre de 2024 y el 30 de noviembre de 2025 propusimos el estudio a los niños de 3 meses a 15 años que acudieron a urgencias de un hospital comarcal de 280 camas con una temperatura de 38 °C o más y tos, respiración rápida o tiraje. No se incluyó a los niños con enfermedad pulmonar crónica, cardiopatía congénita o una radiografía hecha en otro centro la semana anterior. Los padres dieron su consentimiento por escrito y el comité de ética regional aprobó el protocolo. Los datos se registraron en REDCap [@harris2009].

### Prueba en estudio

Nueve pediatras que nunca habían usado la ecografía pulmonar hicieron un curso de seis horas, dos de ellas de exploración supervisada. Cada ecografía recorría seis zonas de cada hemitórax con una sonda lineal de 8 a 12 MHz y se consideraba positiva cuando se veía bajo la pleura una consolidación de 1 cm o más con broncogramas aéreos. La ecografía se hacía antes de la radiografía, y el pediatra anotaba el resultado antes de ver la placa.

### Patrón de referencia

Dos radiólogos que no conocían el resultado de la ecografía leyeron todas las radiografías, y un tercero resolvió los desacuerdos. El diagnóstico final unió la lectura acordada a una revisión telefónica al día 14, como aconseja STARD cuando ninguna prueba sirve por sí sola de patrón oro [@bossuyt2015]. El niño con una placa normal al que su pediatra de cabecera trató con antibióticos por neumonía en esos 14 días se contó como neumonía.

### Análisis estadístico

La sensibilidad y la especificidad se dan con intervalos de Wilson [@newcombe1998], y los cocientes de probabilidades con los intervalos de Simel y colaboradores [@simel1991]. Consideramos que un cociente positivo mayor que 10, o uno negativo menor que 0,1, cambian mucho la probabilidad de enfermedad [@altman1994; @deeks2004]. La concordancia se midió con la kappa de Cohen y se interpretó con la escala de Landis y Koch [@landis1977]. Previmos 400 niños para que, con una prevalencia de uno de cada tres, el límite inferior del intervalo de una sensibilidad del 90 % quedara por encima del 83 %. Se consideró significativo un valor de p < 0,05.

## Resultados

De 451 niños valorados se incluyó a 412. Su edad media era de 4,1 ± 3,2 años; 221 (53,6 %) eran niños y 97 (23,5 %) tenían menos de 2 años. Se diagnosticó neumonía en 139 (33,7 %), 14 de ellos solo en la revisión del día 14.

La ecografía fue positiva en 140 niños y acertó en 127 de ellos. Su sensibilidad fue del 91,4 % (IC del 95 %: 85,5 a 95,0) y su especificidad del 95,2 % (92,0 a 97,2), con un valor predictivo positivo del 90,7 % y un valor predictivo negativo del 95,6 %. Los cocientes de probabilidades fueron CP+ = 19,19 y CP− = 0,09, ambos más allá de los límites fijados de antemano. La sensibilidad fue menor en los menores de 2 años, 31 de 35 (88,6 %), que en los mayores, 96 de 104 (92,3 %), una diferencia del tamaño que daría el azar (p = 0,51). La sensibilidad también mejoró con la práctica, del 87,5 % en las 20 primeras ecografías de cada pediatra al 94,0 % en las siguientes (p = 0,18).

Los 12 falsos negativos fueron consolidaciones de menos de 1 cm en la placa (7), sombras detrás del corazón (3) y dos placas que ambos radiólogos leyeron como neumonía en niños cuya fiebre cedió sin antibióticos. En un modelo logístico, una consolidación de menos de 1 cm en la placa fue el único factor asociado a un diagnóstico fallido (OR = 6,2; IC del 95 %: 2,1 a 18,4; p < 0,001); la edad menor de 2 años no lo fue (OR = 1,6; p = 0,43). Entre los pediatras y un experto que revisó 120 vídeos guardados, kappa = 0,84; entre los dos radiólogos, kappa = 0,71. La exploración duró una mediana de 6 minutos (rango intercuartílico de 4 a 8) y ningún niño necesitó sedación.

## Discusión

Los pediatras de urgencias, con un curso de seis horas, diagnosticaron la neumonía con la ecografía casi con la misma precisión que los operadores expertos de estudios anteriores [@pereda2015; @shah2013], y coincidieron con un experto más de lo que coincidieron entre sí los radiólogos. Con CP+ = 19,19, una ecografía positiva en un niño con una probabilidad previa de uno entre tres la eleva por encima del 90 %, y con CP− = 0,09 una ecografía negativa la deja por debajo del 5 %.

Los falsos negativos muestran dónde falla la ecografía: las consolidaciones pequeñas y el pulmón que queda detrás del corazón, al que la sonda no llega entre las costillas. Muestran también los límites del patrón de referencia, porque dos de ellos fueron probablemente sombras en la placa. El estudio tiene otras limitaciones. Se hizo en un solo hospital, los pediatras se ofrecieron para el curso y una revisión telefónica al día 14 habrá dejado escapar algún caso leve.

La ecografía encaja en el lugar donde se toma la decisión. Al niño que de otro modo se enviaría a radiología se le puede explorar en el box, y la radiografía queda para aquel cuya ecografía es dudosa o cuya fiebre no cede como se esperaba.

## Información del artículo {style="back"}

:::paragraphs{style="info"}
**Financiación** Ninguna. **Conflictos de intereses** Ninguno. **Nota** Compuesto en STIX Two Text, IBM Plex Sans e IBM Plex Sans Condensed (SIL OFL). Texto: original, CC BY 4.0. El estudio, sus autores, el hospital y los resultados son inventados para este ejemplo; las referencias corresponden a obras publicadas reales.
:::

## Bibliografía {style="back"}

:::bibliography{title=""}

:::references{format=bibtex}
@article{harris2011,
  author = {Harris, Michael and Clark, Julia and Coote, Nicky and Fletcher, Penny and Harnden, Anthony and McKean, Michael and Thomson, Anne},
  title = {British Thoracic Society guidelines for the management of community acquired pneumonia in children: update 2011},
  journal = {Thorax}, year = 2011, volume = 66, number = {Suppl 2}, pages = {ii1--ii23}}
@article{landis1977,
  author = {Landis, J. Richard and Koch, Gary G.},
  title = {The measurement of observer agreement for categorical data},
  journal = {Biometrics}, year = 1977, volume = 33, number = 1, pages = {159--174}}
@article{lichtenstein2008,
  author = {Lichtenstein, Daniel A. and Mezière, Gilbert A.},
  title = {Relevance of lung ultrasound in the diagnosis of acute respiratory failure: the {BLUE} protocol},
  journal = {Chest}, year = 2008, volume = 134, number = 1, pages = {117--125}}
@article{volpicelli2012,
  author = {Volpicelli, Giovanni and Elbarbary, Mahmoud and Blaivas, Michael and Lichtenstein, Daniel A. and Mathis, Gebhard and Kirkpatrick, Andrew W. and Melniker, Lawrence},
  title = {International evidence-based recommendations for point-of-care lung ultrasound},
  journal = {Intensive Care Med}, year = 2012, volume = 38, number = 4, pages = {577--591}}
@article{pereda2015,
  author = {Pereda, Maria A. and Chavez, Miguel A. and Hooper-Miele, Christine C. and Gilman, Robert H. and Steinhoff, Mark C. and Ellington, Laura E. and Gross, Margaret},
  title = {Lung ultrasound for the diagnosis of pneumonia in children: a meta-analysis},
  journal = {Pediatrics}, year = 2015, volume = 135, number = 4, pages = {714--722}}
@article{shah2013,
  author = {Shah, Vaishali P. and Tunik, Michael G. and Tsung, James W.},
  title = {Prospective evaluation of point-of-care ultrasonography for the diagnosis of pneumonia in children and young adults},
  journal = {JAMA Pediatr}, year = 2013, volume = 167, number = 2, pages = {119--125}}
@article{bossuyt2015,
  author = {Bossuyt, Patrick M. and Reitsma, Johannes B. and Bruns, David E. and Gatsonis, Constantine A. and Glasziou, Paul P. and Irwig, Les and Lijmer, Jeroen G.},
  title = {{STARD} 2015: an updated list of essential items for reporting diagnostic accuracy studies},
  journal = {BMJ}, year = 2015, volume = 351, pages = {h5527}}
@article{harris2009,
  author = {Harris, Paul A. and Taylor, Robert and Thielke, Robert and Payne, Jonathon and Gonzalez, Nathaniel and Conde, Jose G.},
  title = {Research electronic data capture ({REDCap}): a metadata-driven methodology and workflow process for providing translational research informatics support},
  journal = {J Biomed Inform}, year = 2009, volume = 42, number = 2, pages = {377--381}}
@article{newcombe1998,
  author = {Newcombe, Robert G.},
  title = {Two-sided confidence intervals for the single proportion: comparison of seven methods},
  journal = {Stat Med}, year = 1998, volume = 17, number = 8, pages = {857--872}}
@article{simel1991,
  author = {Simel, David L. and Samsa, Gregory P. and Matchar, David B.},
  title = {Likelihood ratios with confidence: sample size estimation for diagnostic test studies},
  journal = {J Clin Epidemiol}, year = 1991, volume = 44, number = 8, pages = {763--770}}
@article{altman1994,
  author = {Altman, Douglas G. and Bland, J. Martin},
  title = {Diagnostic tests 1: sensitivity and specificity},
  journal = {BMJ}, year = 1994, volume = 308, number = 6943, pages = {1552}}
@article{deeks2004,
  author = {Deeks, Jonathan J. and Altman, Douglas G.},
  title = {Diagnostic tests 4: likelihood ratios},
  journal = {BMJ}, year = 2004, volume = 329, number = 7458, pages = {168--169}}
:::
`;

// ─── 3 · Fonts ──────────────────────────────────────────────────────────────
const FONTS = { 'STIX Two Text': ['400', '400i', '600'], 'IBM Plex Sans': ['400', '600'],
  'IBM Plex Sans Condensed': ['500', '600'] };

// ─── 4 · Build & show ───────────────────────────────────────────────────────
// #region marks: each break a build reported, marked in the source of the second build
// The word before the citation and the citation, or the sign and the number on its other
// side, wrapped in :mark[…]: a band under ordinary text, so the breaks stay where they were.
const wordEnd = (s, i) => i + s.slice(i).search(/[\s;)]|[,.](?!\d)|$/); // 0.09, not 0
function sides(source, w, a, b) { // a warning names line a, before the break, by its source
  if (w.kind === 'citationBreak') { // "colleagues [@simel1991]"
    const cite = source.lastIndexOf('[@', b.sourceStart + 2);
    return [source.lastIndexOf(' ', cite - 2) + 1, source.indexOf(']', cite) + 1];
  }
  if (w.edge === 'end') { // "LR− = 0.09": the sign ends line a, the number opens line b
    const from = source.lastIndexOf(` ${w.text} `, a.sourceEnd) + 1;
    return [from, wordEnd(source, from + w.text.length + 1)];
  }
  const sign = source.indexOf(` ${w.text} `, b.sourceStart - 1); // the sign opens line b
  return [source.lastIndexOf(' ', sign - 1) + 1, sign + 1 + w.text.length];
}
function markBreaks(source, doc, found) {
  const pairs = doc.blocks.flatMap((b) => b.lines.map((line, i) => [line, b.lines[i + 1]]));
  const spans = new Map();
  for (const w of found) {
    const [a, b] = pairs.find(([line]) => line.sourceStart === w.sourceStart) ?? [];
    const [from, to] = b ? sides(source, w, a, b) : [];
    if (from > a?.sourceStart && to > from && to <= b.sourceEnd) spans.set(from, to);
  }
  return [...spans].sort(([x], [y]) => y - x).reduce((md, [from, to]) => `${md.slice(0, from)}`
    + `:mark[${md.slice(from, to)}]{style="edge"}${md.slice(to)}`, source);
}
// #endregion

// #region proofs: the same article twice, 'warn' then 'avoid', each with a query slip
const KIND = { citationBreak: t({ en: 'citation', es: 'cita' }),
  operatorBreak: t({ en: 'sign', es: 'signo' }) };
const edge = (s, end) => (end ? s.trim().split(/\s+/).slice(-2) : s.trim().split(/\s+/)
  .slice(0, 2)).join('\u00a0').replace(/[.,;]$/, ''); // no-break spaces: no breaks of its own
const query = (doc, w) => `${t({ en: 'p.', es: 'pág.' })}\u00a0${doc.pages[w.pageIndex]
  .pageLabel}, ${KIND[w.kind]}: …${edge(w.lines[0], true)}\u00a0/ ${edge(w.lines[1])}…`;
const slip = (mode, doc, found) => ['', `:::callout{type="slip" title="${mode === 'warn'
  ? t({ en: 'First proof: queries', es: 'Primeras pruebas: consultas' })
  : t({ en: 'Second proof: queries', es: 'Segundas pruebas: consultas' })}"}`,
`citationBreaks / operatorBreaks: '${mode}' · ${found.length} ${found.length === 1
  ? t({ en: 'break', es: 'corte' }) : t({ en: 'breaks', es: 'cortes' })}.`,
...found.flatMap((w) => ['', query(doc, w)]), ':::', ''].join('\n');
const build = (md, mode) => buildDocumentWithFonts({ markdown: md }, { ...config,
  bodyText: { ...bodyText, citationBreaks: mode, operatorBreaks: mode } }, kitFonts(FONTS));
async function proof(mode) {
  const plain = await build(markdown, mode); // pass 1: where the breaks are
  const found = (plain.contentWarnings ?? []).filter((w) => /^(citation|operator)Break$/
    .test(w.kind));
  return build(markBreaks(markdown, plain, found) + slip(mode, plain, found), mode); // pass 2
}
const docs = { warn: await proof('warn'), avoid: await proof('avoid') };
// #endregion

const TITLE = t({ en: 'Citations and statistics off the line edges',
  es: 'Citas y estadísticos fuera de los bordes de línea' });
const show = (key) => showPages(docs[key], { title: `${TITLE} · '${key}'` });
const button = (key) => Object.assign(document.createElement('button'),
  { type: 'button', textContent: key, onclick: () => show(key) });
document.getElementById('pt-actions').prepend(button('warn'), button('avoid'));
show('warn');

// ─── Kit ── helpers shared by every Cookbook recipe · postext.dev/cookbook ─────

// ─── Kit · core v1 ── the same in every recipe · postext.dev/cookbook
function mm(value) { return { value, unit: 'mm' }; }
function pt(value) { return { value, unit: 'pt' }; }
function em(value) { return { value, unit: 'em' }; }
/** The sample language's string: t({ en: 'Figure', es: 'Figura' }). */
function t(strings) { return strings[LANG] ?? Object.values(strings)[0]; }
/** A file in this recipe's assets folder, served from the Postext repo by jsDelivr. */
function asset(file) { return `https://cdn.jsdelivr.net/gh/drnachio/postext@main/cookbook/${RECIPE}/assets/${file}`; }

// ─── Kit · fonts v3 ── the same in every recipe · postext.dev/cookbook
// Postext loads the faces a config asks for before layout and asks the kit
// for Fontsource's files, the ones the PDF embeds too.

/** buildDocumentWithFonts' options: the resolver, and FONTS' faces loaded
 *  with the config's. FONTS = { 'Family Name': ['400', '400i', '700'] }. */
function kitFonts(FONTS = {}) {
  const faces = Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) =>
    ({ family, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' })));
  return { resolve: fontsourceResolver, faces };
}

/** A face's files with their ranges: latin, then latin-ext and greek when
 *  `text` needs them (kitSubsetsFor). Null for a face Fontsource lacks. */
async function fontsourceResolver(family, weight, style, { text = '' } = {}) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  if (meta && !(await fontsourceWeights(family, style)).includes(weight)) return null;
  kitStatus('Loading fonts…');
  const at = await fontsourceAt(id);
  return ['latin', ...kitSubsetsFor(text, meta)].map((subset) => ({
    source: `${at}files/${id}-${subset}-${weight}-${style}.woff2`,
    unicodeRange: kitRanges()[subset],
  }));
}

/** Each file's unicode-range (a function: the kit runs after the pen's code). */
function kitRanges() {
  return {
    latin: 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,'
      + 'U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
    'latin-ext': 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,'
      + 'U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF',
    greek: 'U+0370-03FF',
  };
}

/** For the cjk, arabic and comics blocks: loads `faces` (as FONTS) for the
 *  sample `text`; `optional` skips a face Fontsource lacks. Files are added in
 *  the order asked, the last winning a shared character. Resolves to the count. */
async function loadFonts(faces, text = '', { optional = false } = {}) {
  kitStatus('Loading fonts…');
  const ranges = kitRanges();
  const jobs = [];
  for (const [family, specs] of Object.entries(faces)) {
    const id = fontsourceId(family);
    const todo = [...new Set(specs)].map((spec) => [parseInt(spec, 10), spec.endsWith('i') ? 'italic' : 'normal'])
      .filter(([weight, style]) => !hasFace(family, weight, style)); // before any await
    const at = fontsourceAt(id);
    const meta = optional || /[^\0-ÿ]/u.test(text) ? await fontsourceMeta(family) : null;
    const subsets = ['latin', ...kitSubsetsFor(text, meta)];
    for (const [weight, style] of todo) {
      if (optional && !(meta && (await fontsourceWeights(family, style)).includes(weight))) continue;
      for (const subset of subsets) {
        const url = `${await at}files/${id}-${subset}-${weight}-${style}.woff2`;
        const face = new FontFace(family, `url(${url}) format('woff2')`,
          { weight: String(weight), style, unicodeRange: ranges[subset] });
        jobs.push(face.load().catch(() => {
          if (subset === 'latin' && !optional) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        }));
      }
    }
  }
  const ready = await Promise.all(jobs).catch((error) => { kitFail(error); throw error; });
  return ready.filter((face) => face && document.fonts.add(face)).length;
}

/** A loaded FontFace covers this face (fonts.check() says yes to any family). */
function hasFace(family, weight, style) {
  for (const face of document.fonts) {
    if (face.status !== 'loaded' || face.style !== style) continue;
    if (face.family.replace(/^["']|["']$/g, '') !== family) continue;
    const [low, high = low] = face.weight.split(' ').map(Number);
    if (weight >= low && weight <= high) return true;
  }
  return false;
}

/** The files beyond latin `text` needs that `meta`'s family ships. */
function kitSubsetsFor(text, meta) {
  return [[/[Ā-˿ᴀ-ᶿḀ-ỿ†ℓⱠ-Ɀ꜠-ꟿ]/u, 'latin-ext'], [/[Ͱ-Ͽ]/u, 'greek']]
    .filter(([re, x]) => re.test(text) && meta?.subsets?.includes(x)).map(([, x]) => x);
}

/** Fontsource's id for a family: 'Source Serif 4' → 'source-serif-4'. */
function fontsourceId(family) { return family.toLowerCase().replace(/\s+/g, '-'); }

/** A package's folder at the one version @5 names now (#766). */
function fontsourceAt(id, u = `https://cdn.jsdelivr.net/npm/@fontsource/${id}@`) {
  return (fontsourceAt.c ??= {})[id] ??= fetch(u + '5/package.json').then((r) => r.json())
    .then((p) => p.version || 5, () => 5).then((v) => `${u}${v}/`);
}

/** The family's Fontsource metadata (weights, styles, subsets), or null. */
function fontsourceMeta(family, id = fontsourceId(family)) {
  return (fontsourceMeta.c ??= {})[id] ??= fetch(`https://api.fontsource.org/v1/fonts/${id}`)
    .then((res) => (res.ok ? res.json() : null), () => null);
}

/** The weights the package ships in `style`: the API pairs none (no Libre
 *  Caslon 700 italic file), so italics are read from latin-italic.css. */
function fontsourceWeights(family, style, id = fontsourceId(family)) {
  return (fontsourceWeights.c ??= {})[id + style] ??= fontsourceMeta(family).then(async (m) => {
    if (!m?.styles.includes(style)) return m ? [] : [400, 700];
    const css = style === 'italic' ? await fetch(`${await fontsourceAt(id)}latin-italic.css`).then((r) => (r.ok ? r.text() : ''), () => '') : '';
    const w = [...css.matchAll(/weight: (\d+)/g)].map((x) => +x[1]);
    return w.length ? w : m.weights;
  });
}

// ─── Kit · viewer v2 ── the same in every recipe · postext.dev/cookbook
/** The pages as spreads on a dark desk, page 1 alone, then verso | recto,
 *  each painted when it scrolls near. Other options go to renderPageToCanvas. */
function showPages(docs, { title, width = 460, ...render } = {}) {
  const root = viewer(title);
  const pages = [docs].flat().flatMap((doc) =>
    doc.pages.map((page) => ({ doc, page, n: (doc.pageIndexOffset ?? 0) + page.index })));
  const spreads = [];
  let verso = null;
  for (const p of pages) {
    if (p.n % 2 === 1) { if (verso) spreads.push([verso, null]); verso = p; }
    else { spreads.push([verso, p]); verso = null; }
  }
  if (verso) spreads.push([verso, null]);
  const density = Math.min(window.devicePixelRatio || 1, 2);
  showPages.painter?.disconnect();
  const painter = new IntersectionObserver((entries) => {
    for (const { isIntersecting, target } of entries) {
      if (!isIntersecting) continue;
      painter.unobserve(target);
      const { doc, page } = target.postext;
      renderPageToCanvas(page, doc, target, { ...render, scale: (width * density) / page.width });
    }
  }, { rootMargin: '800px' });
  showPages.painter = painter;
  root.replaceChildren(...spreads.map((pair) => {
    const spread = document.createElement('div');
    spread.className = 'pt-spread';
    for (const p of pair) {
      const figure = document.createElement('figure');
      if (p) {
        const label = p.page.pageLabel || String(p.n + 1);
        const canvas = document.createElement('canvas');
        canvas.postext = p;
        canvas.style.aspectRatio = `${p.page.width} / ${p.page.height}`;
        canvas.setAttribute('role', 'img');
        canvas.setAttribute('aria-label', `Page ${label}`);
        const folio = document.createElement('figcaption');
        folio.textContent = label;
        figure.append(canvas, folio);
        painter.observe(canvas);
      } else figure.className = 'pt-blank';
      spread.append(figure);
    }
    return spread;
  }));
  kitStatus(`${pages.length} ${pages.length === 1 ? 'page' : 'pages'}`);
  document.documentElement.dataset.postext = 'ready';
  return pages.length;
}

/** The desk, the bar and the error reporting, created once. */
function viewer(title) {
  if (!document.getElementById('pt-kit')) {
    document.head.insertAdjacentHTML('beforeend', `<style id="pt-kit">
      :root { color-scheme: dark; }
      body { margin: 0; background: #0e1014; color: #b9bcc4; font: 13px/1.45 system-ui, sans-serif; }
      #pt-bar { position: sticky; top: 0; z-index: 1; display: flex; flex-wrap: wrap; align-items: center;
        gap: 6px 16px; padding: 10px 16px; background: rgb(14 16 20 / .92); backdrop-filter: blur(6px);
        border-bottom: 1px solid #23262d; }
      #pt-bar strong { color: #f4f1ea; font-weight: 600; }
      #pt-actions { display: flex; gap: 12px; margin-left: auto; }
      #pt-actions a, #pt-actions button { color: #d8a21a; font: inherit; background: none; border: 0; padding: 0; cursor: pointer; }
      #pages { display: grid; justify-items: center; gap: 48px; padding: 32px 16px 72px; }
      .pt-spread { display: flex; }
      .pt-spread figure { margin: 0; width: min(460px, 44vw); }
      .pt-spread canvas { display: block; width: 100%; background: #fff;
        box-shadow: 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figure:first-child canvas { box-shadow: inset -14px 0 14px -14px rgb(0 0 0 / .18), 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figcaption { margin-top: 10px; text-align: center; font: 600 10px/1 system-ui, sans-serif;
        letter-spacing: .18em; text-transform: uppercase; color: #6c7079; }
      .pt-blank { visibility: hidden; }
      @media (max-width: 760px) {
        .pt-spread { flex-direction: column; gap: 32px; }
        .pt-spread figure { width: min(460px, 92vw); }
        .pt-blank { display: none; }
      }
    </style>`);
    document.body.insertAdjacentHTML('afterbegin',
      '<header id="pt-bar"><strong id="pt-title"></strong><span id="pt-status" role="status"></span><span id="pt-actions"></span></header>');
    document.getElementById('pt-title').textContent = document.title || 'Postext';
    addEventListener('error', (event) => kitFail(event.error ?? event.message));
    addEventListener('unhandledrejection', (event) => kitFail(event.reason));
  }
  if (title) document.getElementById('pt-title').textContent = title;
  return document.getElementById('pages')
    ?? document.body.appendChild(Object.assign(document.createElement('main'), { id: 'pages' }));
}

function kitStatus(text) {
  viewer();
  document.getElementById('pt-status').textContent = text;
}

function kitFail(error) {
  document.documentElement.dataset.postext = 'error';
  kitStatus(`Error: ${error?.message ?? error}`);
}

// ─── /Kit ───────────────────────────────────────────────────────────────────────
```

## Variants

### Avisar dels talls sense canviar res

Una revista que revisa les proves a mà pot deixar la regla en `'warn'`: el Sandbox llista cada tall entre els seus avisos i les línies es queden com les va compondre el tallador.

```diff
-  citationBreaks: 'avoid', operatorBreaks: 'avoid',
+  citationBreaks: 'warn', operatorBreaks: 'warn',
```

### Mantenir la penalització per defecte

Amb 10000 l'espaiat queda una mica més ajustat i queden dos talls per edició en lloc d'un.

```diff
-  citationBreakPenalty: 30000, operatorBreakPenalty: 30000,
```

## Errors freqüents

- **Avís de maquetació: Cita a l'inici de línia** (`citationBreak`). Una línia d'un paràgraf comença amb una cita numerada posada després d'una paraula, o amb un tros d'una: «autors» al final d'una línia i «[12]» al començament de la següent, o «[14,» sobre «16]». Un número entre claudàtors o parèntesis després d'un número no és una cita («2016 (3)»), ni una paraula entre claudàtors. El text de dreta a esquerra i el xinès, japonès o coreà es deixen tal com són. Amb bodyText.citationBreaks a 'warn' s'informa de tots aquests talls; a 'avoid', dels que el tall de línies va mantenir perquè cap composició dins l'espaiat entre paraules no els evitava per menys que bodyText.citationBreakPenalty. El motor anota cadascun a doc.contentWarnings amb la cita, les dues línies i la seva pàgina. Solució: Posa bodyText.citationBreaks a 'avoid': el tall de línies posa preu a un tall abans d'una cita o dins d'ella i compon el paràgraf d'una altra manera on l'espaiat entre paraules ho permet; l'espai continua estirant-se amb els altres. Un tall que es manté costa més d'evitar que bodyText.citationBreakPenalty, sovint perquè la cita és ampla per a la mesura: apuja la penalització per canviar-lo per línies més soltes, o escriu un espai de no separació (U+00A0) entre la paraula i la cita per unir aquest parell sigui quina sigui la regla. En un port d'un llibre existent deixa 'warn': el port reprodueix els talls de l'original. ([Documentació](https://postext.dev/ca/docs/configuration-text.md#text-de-cos))
- **Avís de maquetació: Signe a la vora de la línia** (`operatorBreak`). Una línia d'un paràgraf acaba o comença amb un signe solt entre espais, un de = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: «LR+ =» al final d'una línia amb «18,29» a la següent, o «± 0,03» al començament d'una línia. Un guionet entre paraules no és un signe. El text de dreta a esquerra i el xinès, japonès o coreà es deixen tal com són. Amb bodyText.operatorBreaks a 'warn' s'informa de tots aquests talls, un per tall (una línia que comença i acaba amb un signe en dona dos); a 'avoid', dels que el tall de línies va mantenir perquè cap composició dins l'espaiat entre paraules no els evitava per menys que bodyText.operatorBreakPenalty. El motor anota cadascun a doc.contentWarnings amb el signe, l'extrem (final o començament), les dues línies i la seva pàgina. Solució: Posa bodyText.operatorBreaks a 'avoid': el tall de línies posa preu a un tall en els espais a banda i banda del signe i compon el paràgraf d'una altra manera on l'espaiat entre paraules ho permet. Un tall que es manté costa més d'evitar que bodyText.operatorBreakPenalty, sovint en una columna estreta on el signe i els seus dos termes són amples: apuja la penalització per canviar-lo per línies més soltes, o escriu espais de no separació (U+00A0, o U+202F per a un de fi) al voltant del signe per unir-lo sigui quina sigui la regla. En un port d'un llibre existent deixa 'warn': el port reprodueix els talls de l'original. ([Documentació](https://postext.dev/ca/docs/configuration-text.md#text-de-cos))

- Els talls es busquen a les línies tal com han quedat. Si canvien el format, el cos o el text, canvien de lloc, així que cal llegir els avisos de cada composició i no copiar posicions d'una d'anterior.
- Per mantenir una cita concreta al costat de la seva paraula en qualsevol columna, escriu un espai de no separació al davant, al Markdown. La regla s'ocupa de la resta de l'article.

## Crèdits

- Recepta: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Tipus de lletra: STIX Two Text (OFL-1.1), IBM Plex Sans (OFL-1.1), IBM Plex Sans Condensed (OFL-1.1)
- Codi: MIT · Contingut d'exemple: CC-BY-4.0

## Relacionades

- [Núm. 184 · Prosa justificada sense repeticions als extrems de línia](https://postext.dev/ca/cookbook/prose-without-stacks.md): Una pàgina de Clarín composta dues vegades en una mesura estreta: les primeres proves assenyalen cada repetició; les segones la pesen en el tall de línies. · Nivell 2 (Intermedi) · Narrativa, teatre i prosa literària
- [Núm. 095 · Un article mèdic en estil Vancouver](https://postext.dev/ca/cookbook/medical-article-vancouver.md): Un assaig clínic en A4 a dues columnes: números de cita volats, una bibliografia numerada a la manera de Vancouver i DOI que s'obren com a enllaços al PDF. · Nivell 2 (Intermedi) · Articles i treballs acadèmics
- [Núm. 014 · Espaiat uniforme en columnes estretes i justificades](https://postext.dev/ca/cookbook/justification-lab.md): Tall Knuth–Plass amb els espais entre 0,8 i 1,6 vegades el normal, al costat d'un control voraç amb les línies fluixes, soles i curtes marcades des del VDT. · Nivell 3 (Avançat) · Revistes i fanzins
