# Citas y estadísticos fuera de los bordes de línea

> Un artículo a dos columnas compuesto dos veces: las primeras pruebas avisan de cada cita o signo en un borde de línea; las segundas encarecen esos cortes.

- Versión HTML: https://postext.dev/es/cookbook/clinical-paper-line-edges
- Receta N.º 186 · Texto y tipografía · Nivel 2 (Intermedio) · Salidas: Canvas
- Géneros: Artículos y trabajos académicos
- Requiere postext ≥ 1.79.0 · probada con 1.79.0 el 2026-11-12
- Páginas: [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)
- Abrir en el Sandbox: https://postext.dev/es/sandbox#recipe=clinical-paper-line-edges&lang=es (.postext: https://postext.dev/cookbook/clinical-paper-line-edges/es/clinical-paper-line-edges.postext)
- Última actualización: 2026-11-12
- Otros idiomas: [en](https://postext.dev/en/cookbook/clinical-paper-line-edges.md), [ca](https://postext.dev/ca/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 pocas palabras

En una columna justificada estrecha, una llamada como [2, 3] puede quedarse sola al principio de una línea, y p < 0,05 puede partirse tras el signo. El artículo se compone dos veces: una enseña dónde pasa y otra lo evita casi siempre.

## Lo que vas a componer

Tres páginas de una revista de pediatría de 170 × 240 mm, a dos columnas justificadas de 66 mm en STIX Two Text: un estudio original sobre la ecografía pulmonar en la neumonía infantil, con la bibliografía numerada en estilo Vancouver. Una columna tan estrecha deja al cortador de líneas pocas salidas, y en cuatro sitios el texto español se corta mal. Dos veces la llamada *[4, 5]* se parte entre dos líneas, lejos de la palabra a la que apoya, y dos veces un estadístico se separa de su signo: *kappa* sobre *= 0,84*, *CP+* sobre *= 19,19*. Las primeras pruebas se componen con `citationBreaks` y `operatorBreaks` en `'warn'`: no cambian ningún corte, marcan cada uno con una banda ámbar pálido y los listan en una papeleta tras la bibliografía. Las segundas se componen con `'avoid'`, y queda uno de los cuatro. La edición inglesa compone el mismo estudio con punto decimal.

**Esta receta responde a:**

- ¿Cómo evito que una llamada bibliográfica o un estadístico como p < 0,05 se parta al final de una línea?
- ¿Cómo pongo los números de cita en superíndice y hago que los DOI sean enlaces, como en las revistas médicas?

## La respuesta corta

```js
// script.js, líneas 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,
};
```

## Ingredientes

**Enseña**

- [Citas y signos en los bordes de línea](https://postext.dev/es/docs/configuration-text.md#texto-base): Encuentra las líneas que empiezan con una cita numerada ([12], (12–15)) o que terminan o empiezan con un signo entre espacios (p < 0,05, CP+ = 19,19), y las señala (bodyText.citationBreaks / operatorBreaks: 'warn') o hace que el corte de líneas componga el párrafo de otra manera ('avoid', al coste citationBreakPenalty / operatorBreakPenalty).
- [Corte de líneas óptimo (Knuth–Plass)](https://postext.dev/es/docs/justification.md#knuth-plass-ver-el-párrafo-completo): Corta cada párrafo en su conjunto para igualar el espacio entre palabras, dentro de los límites fijados, en lugar de llenar línea a línea.

**También usa**

- [Citas en un estilo de cita](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía)
- [Bibliografía a partir de las referencias](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía)
- [Marcas de resaltado](https://postext.dev/es/docs/document-format-inline.md#marcas-de-resaltado)
- [Separación silábica e idioma del documento](https://postext.dev/es/docs/justification.md#idiomas-admitidos)
- [Una o dos columnas](https://postext.dev/es/docs/configuration-page-layout.md#tipos-de-disposición)
- [Aperturas diseñadas](https://postext.dev/es/docs/configuration-headings.md#apertura-a-toda-página-y-diseño-avanzado)
- [Atributos de título](https://postext.dev/es/docs/document-format.md#atributos-de-encabezado)
- [Estilos de título](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)
- [Cabeceras y folios](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies)
- [Cabeceras según el tipo de página](https://postext.dev/es/docs/configuration-headers-footers.md#elementos-de-texto)
- [Márgenes simétricos](https://postext.dev/es/docs/configuration-page-layout.md#márgenes-simétricos-espejo)
- [Recuadros](https://postext.dev/es/docs/configuration-callouts.md#estilos-de-recuadro)
- [Paleta de color semántica](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#paleta-de-colores)
- [Salir de la rejilla a propósito](https://postext.dev/es/docs/architecture.md#elementos-que-rompen-la-rejilla)
- [Estilos de párrafo](https://postext.dev/es/docs/configuration-styles.md#estilos-de-párrafo)
- [Preliminares en romanos](https://postext.dev/es/docs/document-format-directives.md#numbering)
- [Superíndices y subíndices](https://postext.dev/es/docs/document-format-inline.md#formato-en-línea)
- [Capítulos sin número](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)

**La configuración de un vistazo**

- [`bodyText`](https://postext.dev/es/docs/configuration-text.md#texto-base), [`calloutStyles`](https://postext.dev/es/docs/configuration-callouts.md#estilos-de-recuadro), [`checks`](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#comprobación-del-contenido-configuración), [`citations`](https://postext.dev/es/docs/configuration-notes-references.md#citas), [`colorPalette`](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#paleta-de-colores), [`footer`](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies), [`header`](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies), [`headingStyles`](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado), [`headings`](https://postext.dev/es/docs/configuration-headings.md#encabezados), [`layout`](https://postext.dev/es/docs/configuration-page-layout.md#disposición), [`locale`](https://postext.dev/es/docs/configuration-language.md#separación-silábica), [`markStyles`](https://postext.dev/es/docs/configuration-styles.md#estilos-de-resaltado), [`page`](https://postext.dev/es/docs/configuration-page-layout.md#página), [`paragraphStyles`](https://postext.dev/es/docs/configuration-styles.md#estilos-de-párrafo)

**API**

- [`LOCALES`](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía), [`STYLES`](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía), [`buildDocumentWithFonts`](https://postext.dev/es/docs/configuration-programmatic-usage.md#cargar-las-fuentes-antes-de-componer), [`createCiteprocEngine`](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía), [`registerCitationEngine`](https://postext.dev/es/docs/document-format-notes-references.md#citas-y-bibliografía), [`renderPageToCanvas`](https://postext.dev/es/docs/configuration-programmatic-usage.md#renderizar-una-página-como-mapa-de-bits)

**Tipografías**

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

## Elaboración

### 1 · Un precio para dos clases de corte

El código está en [la respuesta corta](https://postext.dev/es/cookbook/clinical-paper-line-edges.md#la-respuesta-corta). Hay corte de cita cuando una línea empieza con una llamada numerada o con la segunda mitad de una, como *5]* tras *[4,*. Hay corte de signo cuando una línea acaba o empieza con un signo entre espacios: `=`, `<`, `±`, `×`, el menos. `'warn'` avisa de los dos y deja las líneas como están. `'avoid'` suma una penalización a los deméritos de esos cortes, y el cortador de Knuth–Plass busca otra forma de partir el párrafo. Necesita `optimalLineBreaking`: el cortador voraz no tiene deméritos a los que sumar nada.

La penalización por omisión, 10000, es lo que cuesta una línea estirada hasta el límite del espacio entre palabras, de modo que el cortador nunca abre una línea más allá de ese límite para dejar una cita junto a su palabra. En esta columna, 10000 dejaba dos cortes en cada edición. Con 30000 el cortador acepta líneas más abiertas, siempre dentro de `maxWordSpacing`, y queda uno en cada edición. Un valor más alto ya no cambiaba nada: el último corte no tiene alternativa dentro del límite.

### 2 · Marcar los cortes en el texto

```js
// script.js, líneas 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 aviso trae su clase, la cita o el signo, el texto de las dos líneas, la posición en el texto fuente de la primera y la página. El script busca esas dos líneas en el documento compuesto y envuelve el corte en `:mark[…]`: la palabra anterior a la cita y la cita, o el signo y el número del otro lado. Una marca pinta una banda bajo el texto y deja los cortes donde estaban. La banda no llega al número que genera el estilo de citas, así que en la página solo se marca la palabra anterior.

![Página 212: Prueba en estudio. Primeras pruebas, página 212: kappa al final de una línea y = 0,84 al principio de la siguiente, marcados.](https://postext.dev/cookbook/clinical-paper-line-edges/es/p02.webp?v=112a1714)

*Primeras pruebas, página 212: kappa al final de una línea y = 0,84 al principio de la siguiente.*

### 3 · Dos pruebas y una papeleta de consultas

```js
// script.js, líneas 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 prueba se compone dos veces. La primera composición encuentra los cortes; la segunda compone el artículo con las marcas y una papeleta tras la bibliografía, de modo que la papeleta cae en la última página. Así devuelve un cajista las pruebas con sus consultas. Las líneas de la papeleta unen sus palabras con espacios de no separación, para no añadir cortes propios. `capture.doc` publica las dos composiciones marcadas, `[1, 3]`.

![Página 213: Discusión. La última página de las segundas pruebas: CP+ = 19,19 ya en una sola línea, y la papeleta lista el único corte que queda, anteriores 4, sobre 5, en la página 213.](https://postext.dev/cookbook/clinical-paper-line-edges/es/p06.webp?v=112a1714)

*Segundas pruebas, página 213: la papeleta lista un corte en todo el artículo.*

El corte que queda en español es *anteriores [4,* sobre *5]*, en la página 213. En la edición inglesa las primeras pruebas encuentran tres, entre ellos *LR− =* sobre *0.09* dos veces, y las segundas dejan uno, *first* sobre *[2, 3]*.

### 4 · Llamadas numeradas entre corchetes

```js
// script.js, líneas 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 procesador de citas compone cada `[@clave]` como un número entre corchetes tras un espacio y agrupa las series como *[4–6]*. El espacio anterior al corchete y el que sigue a una coma dentro de él son sitios donde una línea puede cortarse; por eso una columna estrecha con muchas citas necesita la regla.

### 5 · La cabecera y el bloque del artículo

```js
// script.js, líneas 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) }),
] } };
```

El estilo del título dibuja la banda de la revista, el tipo de artículo, el título, los autores con sus números de filiación y una nota, todo a partir de atributos del H1. Las dos ediciones comparten el estilo, y el texto se queda en el Markdown.

## La receta completa

Un solo archivo, compuesto a partir de la carpeta de la receta con el texto de ejemplo y el kit común del Recetario ya incluidos; construye su propia página. Para ejecutarlo, ponlo en un `<script type="module">` de una página vacía o pégalo en el panel JS de un pen nuevo de CodePen (como módulo). Importa postext desde esm.sh, así que no hay nada que instalar ni compilar.

- Carpeta de la receta: 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 ───────────────────────────────────────────────────────────────────────
```

## Variantes

### Avisar de los cortes sin cambiar nada

Una revista que revisa las pruebas a mano puede dejar la regla en `'warn'`: el Sandbox lista cada corte entre sus avisos y las líneas se quedan como las compuso el cortador.

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

### Mantener la penalización por omisión

Con 10000 el espaciado queda algo más apretado y se quedan dos cortes por edición en lugar de uno.

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

## Errores frecuentes

- **Aviso de maquetación: Cita al principio de línea** (`citationBreak`). Una línea de un párrafo empieza con una cita numerada puesta tras una palabra, o con un trozo de ella: «autores» al final de una línea y «[12]» al principio de la siguiente, o «[14,» sobre «16]». Un número entre corchetes o paréntesis tras un número no es una cita («2016 (3)»), ni una palabra entre corchetes. El texto de derecha a izquierda y el chino, japonés o coreano se dejan como están. Con bodyText.citationBreaks en 'warn' se informa de todos esos cortes; en 'avoid', de los que el corte de líneas mantuvo porque ninguna composición dentro del espaciado entre palabras los evitaba por menos que bodyText.citationBreakPenalty. El motor anota cada uno en doc.contentWarnings con la cita, las dos líneas y su página. Solución: Pon bodyText.citationBreaks en 'avoid': el corte de líneas pone precio a un corte antes de una cita o dentro de ella y compone el párrafo de otro modo donde el espaciado entre palabras lo permite; el espacio sigue estirándose con los demás. Un corte que sigue cuesta más de evitar que bodyText.citationBreakPenalty, a menudo porque la cita es ancha para la medida: sube la penalización para cambiarlo por líneas más sueltas, o escribe un espacio de no separación (U+00A0) entre la palabra y la cita para unir ese par sea cual sea la regla. En un port de un libro existente deja 'warn': el port reproduce los cortes del original. ([Documentación](https://postext.dev/es/docs/configuration-text.md#texto-base))
- **Aviso de maquetación: Signo en el borde de línea** (`operatorBreak`). Una línea de un párrafo termina o empieza con un signo suelto entre espacios, uno de = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: «LR+ =» al final de una línea con «18,29» en la siguiente, o «± 0,03» al principio de una línea. Un guion entre palabras no es un signo. El texto de derecha a izquierda y el chino, japonés o coreano se dejan como están. Con bodyText.operatorBreaks en 'warn' se informa de todos esos cortes, uno por corte (una línea que empieza y termina con un signo da dos); en 'avoid', de los que el corte de líneas mantuvo porque ninguna composición dentro del espaciado entre palabras los evitaba por menos que bodyText.operatorBreakPenalty. El motor anota cada uno en doc.contentWarnings con el signo, el extremo (final o comienzo), las dos líneas y su página. Solución: Pon bodyText.operatorBreaks en 'avoid': el corte de líneas pone precio a un corte en los espacios a ambos lados del signo y compone el párrafo de otro modo donde el espaciado entre palabras lo permite. Un corte que sigue cuesta más de evitar que bodyText.operatorBreakPenalty, a menudo en una columna estrecha donde el signo y sus dos términos son anchos: sube la penalización para cambiarlo por líneas más sueltas, o escribe espacios de no separación (U+00A0, o U+202F para uno fino) alrededor del signo para unirlo sea cual sea la regla. En un port de un libro existente deja 'warn': el port reproduce los cortes del original. ([Documentación](https://postext.dev/es/docs/configuration-text.md#texto-base))

- Los cortes se buscan en las líneas tal como quedaron. Si cambian el formato, el cuerpo o el texto, cambian de sitio, así que hay que leer los avisos de cada composición y no copiar posiciones de una anterior.
- Para mantener una cita concreta junto a su palabra en cualquier columna, escribe un espacio de no separación delante en el Markdown. La regla se ocupa del resto del artículo.

## Créditos

- Receta: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Tipografías: STIX Two Text (OFL-1.1), IBM Plex Sans (OFL-1.1), IBM Plex Sans Condensed (OFL-1.1)
- Código: MIT · Contenido de ejemplo: CC-BY-4.0

## Relacionadas

- [N.º 184 · Prosa justificada sin repeticiones en los bordes de línea](https://postext.dev/es/cookbook/prose-without-stacks.md): Una página de Clarín compuesta dos veces en una medida estrecha: las primeras pruebas señalan cada repetición; las segundas la pesan en el corte de líneas. · Nivel 2 (Intermedio) · Narrativa, teatro y prosa literaria
- [N.º 095 · Un artículo médico en estilo Vancouver](https://postext.dev/es/cookbook/medical-article-vancouver.md): Un ensayo clínico en A4 a dos columnas: números de cita volados, una bibliografía numerada al modo Vancouver y DOI que se abren como enlaces en el PDF. · Nivel 2 (Intermedio) · Artículos y trabajos académicos
- [N.º 014 · Espaciado uniforme en columnas estrechas y justificadas](https://postext.dev/es/cookbook/justification-lab.md): Corte Knuth–Plass con los espacios entre 0,8 y 1,6 veces el normal, junto a un control voraz con sus líneas flojas, solas y cortas marcadas desde el VDT. · Nivel 3 (Avanzado) · Revistas y fanzines
