# Citazioni e statistiche lontane dai margini della riga

> Un articolo a due colonne composto due volte: la prima bozza segnala ogni richiamo o segno al margine della riga, la seconda penalizza quelle interruzioni.

- Versione HTML: https://postext.dev/it/cookbook/clinical-paper-line-edges
- Ricetta Nº 186 · Caratteri e testo · Livello 2 (Intermedio) · Output: Canvas
- Generi: Articoli scientifici e testi accademici
- Richiede postext ≥ 1.79.0 · provata con 1.79.0 il 2026-11-12
- Pagine: [211](https://postext.dev/cookbook/clinical-paper-line-edges/en/p01.webp?v=56d4126e), [212](https://postext.dev/cookbook/clinical-paper-line-edges/en/p02.webp?v=56d4126e), [213](https://postext.dev/cookbook/clinical-paper-line-edges/en/p03.webp?v=56d4126e), [213](https://postext.dev/cookbook/clinical-paper-line-edges/en/p06.webp?v=56d4126e)
- Apri nella Sandbox: https://postext.dev/it/sandbox#recipe=clinical-paper-line-edges&lang=en (.postext: https://postext.dev/cookbook/clinical-paper-line-edges/en/clinical-paper-line-edges.postext)
- Ultimo aggiornamento: 2026-11-12
- Altre lingue: [en](https://postext.dev/en/cookbook/clinical-paper-line-edges.md), [es](https://postext.dev/es/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), [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)

## In breve

In una colonna giustificata stretta un richiamo come [2, 3] può aprire da solo una riga, e p < 0,05 può spezzarsi dopo il segno. L’articolo è composto due volte: una mostra dove succede, l’altra spezza le righe perché non succeda quasi più.

## Che cosa comporrai

Tre pagine di una rivista di pediatria di 170 × 240 mm, su due colonne giustificate di 66 mm in STIX Two Text: uno studio originale sull’ecografia polmonare nella polmonite del bambino, con una bibliografia numerata in stile Vancouver. Una colonna così stretta lascia poche scelte all’algoritmo che divide le righe, e in tre punti il testo inglese si spezza male. Un richiamo, *[2, 3]*, apre da solo una riga, lontano dalla parola a cui si riferisce, e due volte il rapporto di verosimiglianza *LR− = 0.09* si spezza dopo il segno di uguale. La prima bozza è composta con `citationBreaks` e `operatorBreaks` a `'warn'`. Non cambia nessuna interruzione, marca ciascuna con una banda ambra pallido e le elenca su un cartellino dopo la bibliografia. La seconda è composta con `'avoid'`, e delle tre ne resta una. L’edizione spagnola compone lo stesso studio con la virgola decimale.

**Questa ricetta risponde a:**

- Come evito che un richiamo bibliografico o una statistica come p < 0,05 si spezzi a fine riga?
- Come compongo i numeri delle citazioni come apici e rendo i DOI link attivi, come fanno le riviste mediche?

## La risposta breve

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

## Ingredienti

**Insegna**

- [Citazioni e segni ai margini della riga](https://postext.dev/it/docs/configuration-text.md#testo-corrente): Trova le righe che cominciano con una citazione numerata ([12], (12–15)) o che finiscono o cominciano con un segno tra spazi (p < 0,05, RV+ = 19,19), e le segnala (bodyText.citationBreaks / operatorBreaks: 'warn') o fa comporre il paragrafo in un altro modo all'interruzione di riga ('avoid', al costo citationBreakPenalty / operatorBreakPenalty).
- [Divisione in righe ottimale (Knuth–Plass)](https://postext.dev/it/docs/justification.md#knuth-plass-vedere-lintero-paragrafo): Divide ogni paragrafo nel suo insieme per avere spazi tra le parole uniformi, entro i limiti di spaziatura, invece di riempire riga per riga.

**Usa anche**

- [Citazioni in uno stile citazionale](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia)
- [Bibliografia dai riferimenti](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia)
- [Evidenziazioni](https://postext.dev/it/docs/document-format-inline.md#evidenziazioni)
- [Sillabazione e lingua del documento](https://postext.dev/it/docs/justification.md#lingue-supportate)
- [Una o due colonne](https://postext.dev/it/docs/configuration-page-layout.md#tipi-di-impaginazione)
- [Aperture progettate](https://postext.dev/it/docs/configuration-headings.md#estensione-e-grafica-avanzata)
- [Attributi dei titoli](https://postext.dev/it/docs/document-format.md#attributi-dei-titoli)
- [Stili di titolo](https://postext.dev/it/docs/configuration-styles.md#stili-dei-titoli)
- [Testatine e folio](https://postext.dev/it/docs/configuration-headers-footers.md#intestazioni-e-piè-di-pagina)
- [Testatine secondo il ruolo della pagina](https://postext.dev/it/docs/configuration-headers-footers.md#elementi-di-testo)
- [Margini speculari](https://postext.dev/it/docs/configuration-page-layout.md#margini-speculari)
- [Riquadri](https://postext.dev/it/docs/configuration-callouts.md#stili-dei-riquadri)
- [Tavolozza di colori semantica](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#tavolozza-dei-colori)
- [Uscire dalla griglia di proposito](https://postext.dev/it/docs/architecture.md#elementi-che-rompono-la-griglia)
- [Stili di paragrafo](https://postext.dev/it/docs/configuration-styles.md#stili-di-paragrafo)
- [Pagine preliminari in numeri romani](https://postext.dev/it/docs/document-format-directives.md#numbering)
- [Apici e pedici](https://postext.dev/it/docs/document-format-inline.md#formattazione-in-linea)
- [Capitoli non numerati](https://postext.dev/it/docs/configuration-styles.md#stili-dei-titoli)

**La configurazione in breve**

- [`bodyText`](https://postext.dev/it/docs/configuration-text.md#testo-corrente), [`calloutStyles`](https://postext.dev/it/docs/configuration-callouts.md#stili-dei-riquadri), [`checks`](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#controllo-del-contenuto-configurazione), [`citations`](https://postext.dev/it/docs/configuration-notes-references.md#citazioni), [`colorPalette`](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#tavolozza-dei-colori), [`footer`](https://postext.dev/it/docs/configuration-headers-footers.md#intestazioni-e-piè-di-pagina), [`header`](https://postext.dev/it/docs/configuration-headers-footers.md#intestazioni-e-piè-di-pagina), [`headingStyles`](https://postext.dev/it/docs/configuration-styles.md#stili-dei-titoli), [`headings`](https://postext.dev/it/docs/configuration-headings.md#titoli), [`layout`](https://postext.dev/it/docs/configuration-page-layout.md#impaginazione), [`locale`](https://postext.dev/it/docs/configuration-language.md#sillabazione), [`markStyles`](https://postext.dev/it/docs/configuration-styles.md#stili-di-evidenziazione), [`page`](https://postext.dev/it/docs/configuration-page-layout.md#pagina), [`paragraphStyles`](https://postext.dev/it/docs/configuration-styles.md#stili-di-paragrafo)

**API**

- [`LOCALES`](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia), [`STYLES`](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia), [`buildDocumentWithFonts`](https://postext.dev/it/docs/configuration-programmatic-usage.md#caricare-i-font-prima-dellimpaginazione), [`createCiteprocEngine`](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia), [`registerCitationEngine`](https://postext.dev/it/docs/document-format-notes-references.md#citazioni-e-bibliografia), [`renderPageToCanvas`](https://postext.dev/it/docs/configuration-programmatic-usage.md#rasterizzare-una-pagina)

**Caratteri**

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

## Preparazione

### 1 · Un prezzo per due tipi di interruzione

Il codice è [la risposta breve](https://postext.dev/it/cookbook/clinical-paper-line-edges.md#la-risposta-breve) qui sopra. C’è un’interruzione di citazione quando una riga comincia con un richiamo numerato, o con la seconda metà di un richiamo, come *5]* dopo *[4,*. C’è un’interruzione di operatore quando una riga finisce o comincia con un segno tra due spazi: `=`, `<`, `±`, `×`, il meno. `'warn'` segnala entrambe e lascia le righe come sono. `'avoid'` aggiunge una penalità ai demeriti di quelle interruzioni, e l’algoritmo di Knuth–Plass cerca un altro modo di spezzare il paragrafo. Serve `optimalLineBreaking`: la divisione riga per riga non ha demeriti a cui aggiungere qualcosa.

La penalità predefinita, 10000, è il costo di una riga allargata fino al limite dello spazio tra le parole, quindi l’algoritmo non apre mai una riga oltre quel limite per tenere un richiamo accanto alla sua parola. In questa colonna 10000 lasciava due interruzioni in ogni edizione. Con 30000 l’algoritmo accetta righe più larghe, sempre entro `maxWordSpacing`, e in ogni edizione ne resta una. Un valore più alto non cambiava più nulla: l’ultima interruzione non ha alternative entro il limite.

### 2 · Marcare le interruzioni nel testo

```js
// script.js, righe 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);
}
```

Ogni avviso riporta il suo tipo, il richiamo o il segno, il testo delle due righe, la posizione della prima nel sorgente e la pagina. Lo script trova quelle due righe nel documento composto e avvolge l’interruzione in `:mark[…]`: la parola prima del richiamo e il richiamo, oppure il segno e il numero dall’altra parte. Una marcatura dipinge una banda sotto il testo e lascia le interruzioni dov’erano. La banda non arriva al numero generato dallo stile delle citazioni, quindi sulla pagina è marcata solo la parola che lo precede.

![Opening page 211: Point-of-care lung ultrasound for community- acquired pneumonia in children: a prospective diagnostic accuracy study.](https://postext.dev/cookbook/clinical-paper-line-edges/en/p01.webp?v=56d4126e)

*Prima bozza, pagina 211: LR− = 0.09 spezzato nell’abstract, e first a fine riga con [2, 3] all’inizio della riga seguente.*

### 3 · Due bozze e un cartellino di quesiti

```js
// script.js, righe 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') };
```

Ogni bozza è composta due volte. La prima composizione trova le interruzioni; la seconda compone l’articolo con le marcature e un cartellino dopo la bibliografia, che cade quindi sull’ultima pagina. È così che un compositore restituisce le bozze con i suoi quesiti. Le righe del cartellino uniscono le parole con spazi indivisibili, così non aggiungono interruzioni proprie. `capture.doc` pubblica le due composizioni marcate, `[1, 3]`.

![Page 213: Article information.](https://postext.dev/cookbook/clinical-paper-line-edges/en/p06.webp?v=56d4126e)

*Seconda bozza, pagina 213: il cartellino elenca un’interruzione rimasta nell’articolo.*

L’interruzione che resta in inglese è *first* sopra *[2, 3]*, a pagina 211. In spagnolo la prima bozza ne trova quattro, tra cui *CP+* sopra *= 19,19* e *[4,* sopra *5]*, dove si spezza il richiamo stesso, e la seconda ne tiene una, *anteriores [4,* sopra *5]*.

### 4 · Richiami numerati tra parentesi quadre

```js
// script.js, righe 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' } };
```

Il processore delle citazioni compone ogni `[@key]` come un numero tra parentesi quadre dopo uno spazio e raggruppa le serie come *[4–6]*. Lo spazio prima della parentesi e quello dopo una virgola al suo interno sono entrambi punti in cui una riga può spezzarsi: per questo una colonna stretta con molte citazioni ha bisogno della regola.

### 5 · La testata e il blocco dell’articolo

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

Lo stile del titolo disegna la fascia della rivista, il tipo di articolo, il titolo, gli autori con i numeri di affiliazione e una nota, tutto a partire da attributi dell’H1. Le due edizioni condividono lo stile, e il testo resta nel Markdown.

## La ricetta completa

Un unico file, composto a partire dalla cartella della ricetta con il testo di esempio e il kit comune del Ricettario già inclusi; costruisce la propria pagina. Per eseguirlo, mettilo in uno `<script type="module">` di una pagina vuota, oppure incollalo nel pannello JS di un nuovo pen di CodePen (come modulo). Importa postext da esm.sh: non c’è niente da installare né da compilare.

- Cartella della ricetta: 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 = 'en'; // @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: "Lung ultrasound for pneumonia in children"
author: "Inés Barreiro Soto, Tomasz Wierzbicki, Aisha Mensah and Pablo Lago Fernández"
---

# Point-of-care lung ultrasound for community-acquired pneumonia in children: a prospective diagnostic accuracy study {style="article" issue="2026 · 9(4) · 211–213" verso="Ribera Paediatr J 2026;9(4)" recto="Barreiro Soto et al. · Lung ultrasound for pneumonia" kind="Original research" authors="Inés Barreiro Soto^1^, Tomasz Wierzbicki^2^, Aisha Mensah^1^, Pablo Lago Fernández^3^" affiliations="^1^ Paediatric Emergency Department, Hospital Comarcal de la Ribera\n^2^ Department of Radiology, Hospital Comarcal de la Ribera\n^3^ Clinical Epidemiology Unit, Ribera Health Area" note="Illustrative article written for the Postext Cookbook: the study, its authors and its data are invented. The works cited are real."}

:::callout{type="abstract" title="Abstract"}
**Objective** To find out how accurately emergency paediatricians diagnose community-acquired pneumonia in children with lung ultrasound, against chest radiography read by two radiologists and a review on day 14.

**Methods** We enrolled 412 children aged 3 months to 15 years who came to one emergency department with fever and cough or fast breathing. One of nine paediatricians scanned each child before the radiograph, after a six-hour course.

**Results** Pneumonia was diagnosed in 139 children (33.7%). Ultrasound had a sensitivity of 91.4% (95% CI 85.5 to 95.0) and a specificity of 95.2% (92.0 to 97.2), so LR+ = 19.19 and LR− = 0.09. A median scan took 6 minutes.

**Conclusions** After a short course, emergency paediatricians rule pneumonia in or out with ultrasound about as well as a radiograph does, and without radiation.
:::

## Introduction

Pneumonia is the commonest serious infection of childhood and the reason for many of the chest radiographs taken in children’s emergency departments. British guidelines advise against a routine radiograph in a child well enough to go home [@harris2011], yet the film is often asked for to settle a doubtful examination, and two radiologists reading the same film do not always agree.

Lung ultrasound looks at the same disease through another window. Consolidated lung carries sound and shows as a solid, liver-like area with bright air bronchograms, signs that were described and standardised in adults first [@lichtenstein2008; @volpicelli2012]. In children the thin chest wall makes the scan easier, and a meta-analysis and a large prospective study found it both sensitive and specific [@pereda2015; @shah2013]. Most of those scans, however, were done by sonographers or by a few physicians with long experience, and it is not known whether the figures hold when the scan is one task among many on a night shift.

We measured the accuracy of lung ultrasound done by the emergency paediatricians of a district hospital after a short course, and report it as STARD 2015 asks [@bossuyt2015].

## Methods

### Participants

From 1 October 2024 to 30 November 2025 we approached children aged 3 months to 15 years who came to the emergency department of a district hospital of 280 beds with a temperature of 38 °C or more and cough, fast breathing or chest indrawing. Children with chronic lung disease, congenital heart disease or a radiograph taken elsewhere in the previous week were not included. Parents gave written consent, and the regional ethics committee approved the protocol. Data were entered in REDCap [@harris2009].

### Index test

Nine paediatricians, none of whom had used lung ultrasound before, attended a course of six hours, two of them spent scanning under supervision. Each scan covered six zones on each side of the chest with a linear probe of 8 to 12 MHz and was recorded as positive when a consolidation of 1 cm or more with air bronchograms was seen under the pleura. The scan was done before the radiograph, and the paediatrician entered the result before seeing the film.

### Reference standard

Two radiologists who did not know the ultrasound result read every radiograph, and a third settled disagreements. The final diagnosis joined the agreed reading to a telephone review on day 14, as STARD advises when no single test is a gold standard [@bossuyt2015]. A child with a normal film who was given antibiotics for pneumonia by the family doctor within the 14 days was counted as having pneumonia.

### Statistical analysis

Sensitivity and specificity are given with Wilson intervals [@newcombe1998], and likelihood ratios with the intervals of Simel and colleagues [@simel1991]. We read a positive likelihood ratio above 10, or a negative one below 0.1, as a large change in the probability of disease [@altman1994; @deeks2004]. Agreement was measured with Cohen’s kappa and read on the scale of Landis and Koch [@landis1977]. We planned 400 children, so that with a prevalence of one in three the lower limit of the interval for a sensitivity of 90% would stay above 83%. A value of p < 0.05 was taken as significant.

## Results

Of 451 children screened, 412 were enrolled. Their mean age was 4.1 ± 3.2 years, 221 (53.6%) were boys and 97 (23.5%) were under 2 years. Pneumonia was diagnosed in 139 (33.7%), 14 of them only at the review on day 14.

Ultrasound was positive in 140 children and right in 127 of them. Its sensitivity was 91.4% (95% CI 85.5 to 95.0) and its specificity 95.2% (92.0 to 97.2), with a positive predictive value of 90.7% and a negative predictive value of 95.6%. The likelihood ratios were LR+ = 19.19 and LR− = 0.09, both past the limits set in advance. Sensitivity was lower in children under 2 years, 31 of 35 (88.6%), than in older children, 96 of 104 (92.3%), a difference of the size chance would give (p = 0.51). Sensitivity also rose with practice, from 87.5% in each paediatrician’s first 20 scans to 94.0% after them (p = 0.18).

The 12 false negatives were consolidations under 1 cm on the film (7), shadows behind the heart (3) and two films read as pneumonia by both radiologists in children whose fever settled without antibiotics. In a logistic model, a consolidation under 1 cm on the film was the only factor linked to a missed diagnosis (OR = 6.2, 95% CI 2.1 to 18.4; p < 0.001); an age under 2 years was not (OR = 1.6; p = 0.43). Between the paediatricians and an expert who reviewed 120 stored clips, kappa = 0.84; between the two radiologists, kappa = 0.71. The median scan took 6 minutes (interquartile range 4 to 8), and no child needed sedation.

## Discussion

With six hours of training, emergency paediatricians diagnosed pneumonia with ultrasound about as accurately as the experienced operators of earlier studies [@pereda2015; @shah2013], and agreed with an expert more closely than the radiologists agreed with each other. With LR+ = 19.19, a positive scan in a child whose pre-test probability is one in three raises it above 90%, and with LR− = 0.09 a negative scan brings it under 5%.

The false negatives show where the scan is weak: small consolidations and the lung behind the heart, which the probe cannot reach between the ribs. They also show the weakness of the reference standard, since two of them were probably shadows on the film. The study has other limits. It was done in one hospital, the paediatricians volunteered for the course, and a review by telephone on day 14 will have missed some mild cases.

The scan suits the place where the decision is taken. A child who would otherwise be sent to radiology can be scanned in the cubicle, and the radiograph kept for the child whose scan is doubtful or whose fever does not settle as expected.

## Article information {style="back"}

:::paragraphs{style="info"}
**Funding** None. **Competing interests** None declared. **Note** Set in STIX Two Text, IBM Plex Sans and IBM Plex Sans Condensed (SIL OFL). Text: original, CC BY 4.0. The study, its authors, the hospital and the results are invented for this example; the references are to real published works.
:::

## References {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 ───────────────────────────────────────────────────────────────────────
```

## Varianti

### Segnala le interruzioni senza cambiare nulla

Una rivista che controlla le bozze a mano può lasciare la regola a `'warn'`: la Sandbox elenca ogni interruzione tra i suoi avvisi, e le righe restano come le ha spezzate l’algoritmo.

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

### Tieni la penalità predefinita

Con 10000 la spaziatura resta un po’ più stretta e in ogni edizione restano due interruzioni invece di una.

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

## Errori frequenti

- **Avviso di impaginazione: Citazione a inizio riga** (`citationBreak`). Una riga di un paragrafo comincia con una citazione numerata posta dopo una parola, o con un pezzo di essa: «autori» alla fine di una riga e «[12]» all’inizio della successiva, o «[14,» sopra «16]». Un numero tra parentesi dopo un numero non è una citazione («2016 (3)»), né una parola tra parentesi. Il testo da destra a sinistra e il cinese, il giapponese o il coreano restano come sono. Con bodyText.citationBreaks su 'warn' si segnalano tutte queste interruzioni; su 'avoid', quelle che la divisione in righe ha tenuto perché nessuna composizione entro la spaziatura tra le parole le evitava per meno di bodyText.citationBreakPenalty. Il motore annota ciascuna in doc.contentWarnings con la citazione, le due righe e la loro pagina. Soluzione: Imposta bodyText.citationBreaks su 'avoid': la divisione in righe dà un prezzo a un’interruzione prima di una citazione o al suo interno e ricompone il paragrafo dove la spaziatura tra le parole lo permette; lo spazio continua ad allargarsi con gli altri. Un’interruzione che resta costa più di bodyText.citationBreakPenalty da evitare, spesso perché la citazione è larga per la giustezza: alza la penalità per scambiarla con righe più larghe, o scrivi uno spazio unificatore (U+00A0) tra la parola e la citazione per legare quella coppia qualunque sia la regola. Nel port di un libro esistente lascia 'warn': il port riproduce le divisioni dell’originale. ([Documentazione](https://postext.dev/it/docs/configuration-text.md#testo-corrente))
- **Avviso di impaginazione: Segno a bordo riga** (`operatorBreak`). Una riga di un paragrafo finisce o comincia con un segno isolato tra spazi, uno di = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: «LR+ =» alla fine di una riga con «18,29» nella successiva, o «± 0,03» all’inizio di una riga. Un trattino tra parole non è un segno. Il testo da destra a sinistra e il cinese, il giapponese o il coreano restano come sono. Con bodyText.operatorBreaks su 'warn' si segnalano tutte queste interruzioni, una per interruzione (una riga che comincia e finisce con un segno ne dà due); su 'avoid', quelle che la divisione in righe ha tenuto perché nessuna composizione entro la spaziatura tra le parole le evitava per meno di bodyText.operatorBreakPenalty. Il motore annota ciascuna in doc.contentWarnings con il segno, il bordo (fine o inizio), le due righe e la loro pagina. Soluzione: Imposta bodyText.operatorBreaks su 'avoid': la divisione in righe dà un prezzo a un’interruzione agli spazi ai due lati del segno e ricompone il paragrafo dove la spaziatura tra le parole lo permette. Un’interruzione che resta costa più di bodyText.operatorBreakPenalty da evitare, spesso in una colonna stretta dove il segno e i suoi due termini sono larghi: alza la penalità per scambiarla con righe più larghe, o scrivi spazi unificatori (U+00A0, o U+202F per uno sottile) attorno al segno per legarlo qualunque sia la regola. Nel port di un libro esistente lascia 'warn': il port riproduce le divisioni dell’originale. ([Documentazione](https://postext.dev/it/docs/configuration-text.md#testo-corrente))

- Le interruzioni si cercano nelle righe già spezzate. Un cambio di formato, di corpo o di testo le sposta: leggi gli avvisi di ogni composizione e non copiare le posizioni da una precedente.
- Per tenere un richiamo preciso accanto alla sua parola in qualunque colonna, scrivi uno spazio indivisibile prima di esso nel Markdown. Al resto dell’articolo pensa la regola.

## Crediti

- Ricetta: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Caratteri: STIX Two Text (OFL-1.1), IBM Plex Sans (OFL-1.1), IBM Plex Sans Condensed (OFL-1.1)
- Codice: MIT · Contenuto di esempio: CC-BY-4.0

## Ricette correlate

- [Nº 184 · Prosa giustificata senza ripetizioni ai margini della riga](https://postext.dev/it/cookbook/prose-without-stacks.md): Una pagina di Dickens composta due volte in una giustezza stretta: la prima bozza segnala e marca ogni ripetizione, la seconda la pesa nella divisione in righe. · Livello 2 (Intermedio) · Narrativa, teatro e prosa letteraria
- [Nº 095 · Un articolo medico in stile Vancouver](https://postext.dev/it/cookbook/medical-article-vancouver.md): Il resoconto di uno studio clinico su A4 in due colonne: numeri di citazione in apice, bibliografia numerata Vancouver e DOI che nel PDF si aprono come link. · Livello 2 (Intermedio) · Articoli scientifici e testi accademici
- [Nº 014 · Spazi uniformi in colonne giustificate strette](https://postext.dev/it/cookbook/justification-lab.md): Divisione Knuth–Plass con spazi tra parole tra 0,8 e 1,6 volte il normale, accanto a un controllo greedy con righe lasche, isolate e corte marcate dal VDT. · Livello 3 (Avanzato) · Riviste e fanzine
