# Citations and statistics kept off the line edges

> A two-column clinical paper set twice: the first proof reports every citation or sign left at a line edge, the second prices those breaks in the line breaker.

- HTML version: https://postext.dev/en/cookbook/clinical-paper-line-edges
- Recipe Nº 186 · Type & text · Level 2 (Intermediate) · Outputs: Canvas
- Genres: Papers & academic
- Requires postext ≥ 1.79.0 · tested with 1.79.0 on 2026-11-12
- Pages: [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)
- Open in Sandbox: https://postext.dev/en/sandbox#recipe=clinical-paper-line-edges&lang=en (.postext: https://postext.dev/cookbook/clinical-paper-line-edges/en/clinical-paper-line-edges.postext)
- Last updated: 2026-11-12
- Other languages: [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), [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)

## In short

In a narrow justified column a reference number such as [2, 3] can start a line on its own, and p < 0.05 can split after the sign. The paper is set twice: once showing where that happens, once with the lines broken so it mostly doesn't.

## What you'll build

Three pages of a paediatric journal, 170 × 240 mm, set in two justified columns of 66 mm in STIX Two Text: an original study of lung ultrasound for pneumonia with a numbered Vancouver reference list. A column that narrow gives the line breaker few choices, and in three places the English text breaks badly. A citation, *[2, 3]*, starts a line on its own, away from the word it supports, and twice the likelihood ratio *LR− = 0.09* splits after the equals sign. The first proof is set with `citationBreaks` and `operatorBreaks` at `'warn'`. It changes no break, marks each one with a pale amber band and lists them on a slip after the references. The second proof is set with `'avoid'`, and one of the three is left. The Spanish edition sets the same study with a decimal comma.

**This recipe answers:**

- How do I keep a citation number or a statistic such as p < 0.05 from breaking at the end of a line?
- How do I set citation numbers as superscripts and make DOIs live links, as medical journals do?

## The short answer

No line opens on a citation, no line ends or opens on a lone sign.

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

## Ingredients

**Teaches**

- [Citations and signs at line edges](https://postext.dev/en/docs/configuration-text.md#body-text): Finds lines that start with a numbered citation ([12], (12–15)) or end or start on a sign set between spaces (p < 0.05, LR+ = 19.19), and reports them (bodyText.citationBreaks / operatorBreaks: 'warn') or makes the line breaker set the paragraph another way ('avoid', at the cost citationBreakPenalty / operatorBreakPenalty).
- [Optimal line breaking (Knuth–Plass)](https://postext.dev/en/docs/justification.md#knuth-plass-seeing-the-whole-paragraph): Breaks each paragraph as a whole for even word spacing, within word-spacing bounds, instead of filling line by line.

**Also uses**

- [Citations in a citation style](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography)
- [Bibliography from the references](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography)
- [Highlight marks](https://postext.dev/en/docs/document-format-inline.md#highlight-marks)
- [Hyphenation and document language](https://postext.dev/en/docs/justification.md#supported-locales)
- [One or two columns](https://postext.dev/en/docs/configuration-page-layout.md#layout-types)
- [Designed openers](https://postext.dev/en/docs/configuration-headings.md#span-and-advanced-design)
- [Heading attributes](https://postext.dev/en/docs/document-format.md#heading-attributes)
- [Heading styles](https://postext.dev/en/docs/configuration-styles.md#heading-styles)
- [Running heads and folios](https://postext.dev/en/docs/configuration-headers-footers.md#headers--footers)
- [Heads by page role](https://postext.dev/en/docs/configuration-headers-footers.md#text-elements)
- [Mirrored margins](https://postext.dev/en/docs/configuration-page-layout.md#mirrored-margins)
- [Callout boxes](https://postext.dev/en/docs/configuration-callouts.md#callout-styles)
- [Semantic colour palette](https://postext.dev/en/docs/configuration-fonts-colors-viewers.md#color-palette)
- [Leaving the grid on purpose](https://postext.dev/en/docs/architecture.md#grid-breaking-elements)
- [Paragraph styles](https://postext.dev/en/docs/configuration-styles.md#paragraph-styles)
- [Roman front matter](https://postext.dev/en/docs/document-format-directives.md#numbering)
- [Superscripts and subscripts](https://postext.dev/en/docs/document-format-inline.md#inline-formatting)
- [Unnumbered chapters](https://postext.dev/en/docs/configuration-styles.md#heading-styles)

**Config at a glance**

- [`bodyText`](https://postext.dev/en/docs/configuration-text.md#body-text), [`calloutStyles`](https://postext.dev/en/docs/configuration-callouts.md#callout-styles), [`checks`](https://postext.dev/en/docs/configuration-fonts-colors-viewers.md#content-check-config), [`citations`](https://postext.dev/en/docs/configuration-notes-references.md#citations), [`colorPalette`](https://postext.dev/en/docs/configuration-fonts-colors-viewers.md#color-palette), [`footer`](https://postext.dev/en/docs/configuration-headers-footers.md#headers--footers), [`header`](https://postext.dev/en/docs/configuration-headers-footers.md#headers--footers), [`headingStyles`](https://postext.dev/en/docs/configuration-styles.md#heading-styles), [`headings`](https://postext.dev/en/docs/configuration-headings.md#headings), [`layout`](https://postext.dev/en/docs/configuration-page-layout.md#layout), [`locale`](https://postext.dev/en/docs/configuration-language.md#hyphenation), [`markStyles`](https://postext.dev/en/docs/configuration-styles.md#highlight-styles), [`page`](https://postext.dev/en/docs/configuration-page-layout.md#page), [`paragraphStyles`](https://postext.dev/en/docs/configuration-styles.md#paragraph-styles)

**APIs**

- [`LOCALES`](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography), [`STYLES`](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography), [`buildDocumentWithFonts`](https://postext.dev/en/docs/configuration-programmatic-usage.md#loading-fonts-before-layout), [`createCiteprocEngine`](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography), [`registerCitationEngine`](https://postext.dev/en/docs/document-format-notes-references.md#citations-and-bibliography), [`renderPageToCanvas`](https://postext.dev/en/docs/configuration-programmatic-usage.md#rendering-a-page-to-a-bitmap)

**Typefaces**

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

## Method

### 1 · A price on two kinds of break

The code is [the short answer](https://postext.dev/en/cookbook/clinical-paper-line-edges.md#the-short-answer) above. A citation break is a line that starts with a numbered citation, or with the second half of one, such as *5]* after *[4,*. An operator break is a line that ends or starts on a sign set between spaces: `=`, `<`, `±`, `×`, the minus. `'warn'` reports both and leaves the lines as they are. `'avoid'` adds a penalty to the demerits of those breaks, and the Knuth–Plass breaker looks for another way to set the paragraph. It needs `optimalLineBreaking`, since the greedy breaker has no demerits to add to.

The default penalty, 10000, is what a line stretched to the word-spacing limit costs, so the breaker never opens a line past that limit to keep a citation with its word. In this column 10000 left two breaks in each edition. At 30000 the breaker takes looser lines, still within `maxWordSpacing`, and one break is left in each. A higher value changed nothing more: the last break has no alternative within the limit.

### 2 · Mark the breaks in the text

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

Each warning carries its kind, the citation or the sign, the text of the two lines, the source position of the first one and the page. The script finds those two lines in the built document and wraps the break in `:mark[…]`: the word before a citation and the citation, or the sign and the number on its other side. A mark paints a band under the text and leaves the breaks where they were. The band does not reach the number the citation style generates, so on the page only the word before it is marked.

![Opening page 211: Point-of-care lung ultrasound for community- acquired pneumonia in children: a prospective diagnostic accuracy study. First proof, page 211: pale amber bands under = 0.09 split across two lines of the abstract and under first, at the end of a line whose next line opens on 2, 3.](https://postext.dev/cookbook/clinical-paper-line-edges/en/p01.webp?v=56d4126e)

*First proof, page 211: LR− = 0.09 split in the abstract, and first at a line end with [2, 3] opening the next line.*

### 3 · Two proofs and a query slip

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

Each proof is built twice. The first build finds the breaks; the second sets the article with the marks and a slip after the references, so the slip falls on the last page. A typesetter returns proofs with queries in the same way. The slip's lines join their words with no-break spaces, so they add no breaks of their own. `capture.doc` publishes the two marked builds, `[1, 3]`.

![Page 213: Article information. The second proof's last page: LR− = 0.09 now on one line, and the slip lists the one break left, first over 2, 3 on page 211.](https://postext.dev/cookbook/clinical-paper-line-edges/en/p06.webp?v=56d4126e)

*Second proof, page 213: the slip lists one break left in the article.*

The break left in English is *first* over *[2, 3]* on page 211. In Spanish the first proof finds four, among them *CP+* over *= 19,19* and *[4,* over *5]* where the citation itself splits, and the second proof keeps one, *anteriores [4,* over *5]*.

### 4 · Numbered citations in brackets

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

The citation processor sets each `[@key]` as a bracketed number after a word space and collapses runs such as *[4–6]*. The space before the bracket and the space after a comma inside it are both places a line can break, which is why a narrow column with many citations needs the rule.

### 5 · The masthead and the article block

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

The heading style draws the journal band, the article type, the title, the authors with their affiliation numbers and a note, all from attributes on the H1. The two editions share the style, and the text stays in the Markdown.

## The whole recipe

One file, composed from the recipe's folder with the sample text and the Cookbook's shared kit inlined; it builds its own page. To run it, put it in a `<script type="module">` on an empty page, or paste it into the JS panel of a new CodePen (as a module). It imports postext from esm.sh, so there is nothing to install or build.

- Source folder: 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 ───────────────────────────────────────────────────────────────────────
```

## Variations

### Report the breaks and change nothing

A journal that checks its proofs by hand can keep the rule at `'warn'`: the Sandbox lists each break in Review, and the lines stay as the breaker set them.

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

### Keep the default penalty

At 10000 the spacing stays a little tighter and two breaks are left in each edition instead of one.

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

## Pitfalls

- **Layout warning: Citation at line start** (`citationBreak`). A line of a paragraph starts with a numbered citation set after a word, or with a piece of one: “authors” at the end of one line and “[12]” at the head of the next, or “[14,” over “16]”. A number in brackets or parentheses after a number is no citation (“2016 (3)”), nor a word in brackets. Right-to-left and Chinese, Japanese or Korean text is left alone. With bodyText.citationBreaks on 'warn' every such break is reported; on 'avoid', the ones the line breaker kept because no setting within the word spacing avoided them for less than bodyText.citationBreakPenalty. The engine lists each in doc.contentWarnings with the citation, the two lines and their page. Fix: Set bodyText.citationBreaks to 'avoid': the line breaker prices a break before or inside a citation and sets the paragraph otherwise where the word spacing allows; the space still stretches with the others. A break that stays costs more to avoid than bodyText.citationBreakPenalty, often because the citation is wide for the measure: raise the penalty to trade looser lines for it, or write a no-break space (U+00A0) between the word and the citation to bind that pair whatever the rule. In a port of an existing book keep 'warn': the port reproduces the original's breaks. ([Documentation](https://postext.dev/en/docs/configuration-text.md#body-text))
- **Layout warning: Sign at line edge** (`operatorBreak`). A line of a paragraph ends or starts on a lone sign set between spaces, one of = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: “LR+ =” at the end of a line with “18.29” on the next, or “± 0.03” at the head of a line. A hyphen between words is no sign. Right-to-left and Chinese, Japanese or Korean text is left alone. With bodyText.operatorBreaks on 'warn' every such break is reported, one per break (a line that starts and ends on a sign gives two); on 'avoid', the ones the line breaker kept because no setting within the word spacing avoided them for less than bodyText.operatorBreakPenalty. The engine lists each in doc.contentWarnings with the sign, the edge (end or start), the two lines and their page. Fix: Set bodyText.operatorBreaks to 'avoid': the line breaker prices a break at the spaces on either side of the sign and sets the paragraph otherwise where the word spacing allows. A break that stays costs more to avoid than bodyText.operatorBreakPenalty, often in a narrow column where the sign and its two terms are wide: raise the penalty to trade looser lines for it, or write no-break spaces (U+00A0, or U+202F for a thin one) around the sign to bind it whatever the rule. In a port of an existing book keep 'warn': the port reproduces the original's breaks. ([Documentation](https://postext.dev/en/docs/configuration-text.md#body-text))

- The breaks are found in the lines as broken. A change of trim, size or text moves them, so read the warnings of each build rather than copying positions from an earlier one.
- To keep one citation with its word whatever the column, type a no-break space before it in the Markdown. The rule does the rest of the paper.

## Credits

- Recipe: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Type: STIX Two Text (OFL-1.1), IBM Plex Sans (OFL-1.1), IBM Plex Sans Condensed (OFL-1.1)
- Code: MIT · Sample content: CC-BY-4.0

## Related

- [Nº 184 · Justified prose without stacked words at the line edges](https://postext.dev/en/cookbook/prose-without-stacks.md): One page of Dickens set twice in a narrow measure: the first proof reports and marks every stack, the second weighs them in the line breaker. · Level 2 (Intermediate) · Fiction, drama & literary prose
- [Nº 095 · A medical article in Vancouver style](https://postext.dev/en/cookbook/medical-article-vancouver.md): A clinical trial report on A4 in two columns: raised citation numbers, a numbered Vancouver reference list and DOIs that open as links in the PDF. · Level 2 (Intermediate) · Papers & academic
- [Nº 014 · Even word spacing in narrow justified columns](https://postext.dev/en/cookbook/justification-lab.md): Knuth–Plass breaking with word spaces held to 0.8–1.6 times normal, set beside a greedy control whose loose lines, lone lines and runts are marked from the VDT. · Level 3 (Advanced) · Magazines & zines
