En bref
Dans une colonne justifiée étroite, un appel comme [2, 3] peut ouvrir seul une ligne, et p < 0,05 peut se couper après le signe. L’article est composé deux fois : l’une montre où cela arrive, l’autre l’évite presque partout.
Ce que vous allez composer
Trois pages d’une revue de pédiatrie de 170 × 240 mm, sur deux colonnes justifiées de 66 mm en STIX Two Text : une étude originale sur l’échographie pulmonaire dans la pneumonie de l’enfant, avec une bibliographie numérotée en style Vancouver. Une colonne aussi étroite laisse peu de choix à l’algorithme de coupure, et à trois endroits le texte anglais se coupe mal. Un appel, [2, 3], ouvre seul une ligne, loin du mot auquel il se rapporte, et deux fois le rapport de vraisemblance LR− = 0.09 se coupe après le signe égal. La première épreuve est composée avec citationBreaks et operatorBreaks à 'warn'. Elle ne change aucune coupure, marque chacune d’une bande ambre pâle et les liste sur un bulletin après la bibliographie. La seconde est composée avec 'avoid', et il en reste une sur trois. L’édition espagnole compose la même étude avec la virgule décimale.
Cette recette répond à
- Comment éviter qu’un appel de référence ou une statistique comme p < 0,05 soit coupé en fin de ligne ?
- Comment composer les numéros de citation en exposant et rendre les DOI cliquables, comme dans les revues médicales ?
La réponse courte
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,
};
Ingrédients
- Fonctionnalités
- Appels de référence et signes en bord de ligneCoupure optimale des lignes (Knuth–Plass)Citations dans un style bibliographiqueBibliographie tirée des référencesSurlignagesCésure et langue du documentUne ou deux colonnesOuvertures composéesAttributs de titreStyles de titreTitres courants et foliosTitres courants selon le rôle de la pageMarges en miroirEncadrésPalette de couleurs sémantique
- Utilise aussi
- Sortir de la grille volontairementStyles de paragraphePages liminaires en chiffres romainsExposants et indicesChapitres non numérotés
- Typographie
- STIX Two Text, IBM Plex Sans, IBM Plex Sans Condensed (SIL OFL 1.1)
- Ressources
- Aucune : chaque image est dessinée en code
Préparation
#1 · Un prix pour deux sortes de coupure
Le code est la réponse courte ci-dessus. Il y a coupure de citation quand une ligne commence par un appel numéroté, ou par la seconde moitié d’un appel, comme 5] après [4,. Il y a coupure d’opérateur quand une ligne finit ou commence par un signe placé entre deux espaces : =, <, ±, ×, le signe moins. 'warn' signale les deux et laisse les lignes telles quelles. 'avoid' ajoute une pénalité aux démérites de ces coupures, et l’algorithme de Knuth–Plass cherche une autre façon de couper le paragraphe. Il faut optimalLineBreaking : la coupure gloutonne n’a pas de démérites auxquels ajouter quoi que ce soit.
La pénalité par défaut, 10000, est ce que coûte une ligne étirée jusqu’à la limite de l’espacement entre les mots : l’algorithme n’ouvre donc jamais une ligne au-delà de cette limite pour garder un appel avec son mot. Dans cette colonne, 10000 laissait deux coupures dans chaque édition. À 30000, l’algorithme accepte des lignes plus lâches, toujours dans la limite de maxWordSpacing, et il en reste une dans chaque édition. Une valeur plus haute ne changeait plus rien : la dernière coupure n’a pas d’autre solution dans la limite.
#2 · Marquer les coupures dans le texte
// 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);
}
Chaque avertissement indique sa sorte, l’appel ou le signe, le texte des deux lignes, la position de la première dans la source et la page. Le script retrouve ces deux lignes dans le document composé et enveloppe la coupure dans :mark[…] : le mot qui précède l’appel et l’appel, ou le signe et le nombre de l’autre côté. Une marque peint une bande sous le texte et laisse les coupures où elles étaient. La bande n’atteint pas le numéro que produit le style de citation : sur la page, seul le mot qui le précède est marqué.

#3 · Deux épreuves et un bulletin de questions
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') };
Chaque épreuve est composée deux fois. La première composition trouve les coupures ; la seconde compose l’article avec les marques et un bulletin après la bibliographie, qui tombe donc sur la dernière page. C’est ainsi qu’un compositeur renvoie ses épreuves avec ses questions. Les lignes du bulletin lient leurs mots par des espaces insécables pour ne pas créer de coupures à leur tour. capture.doc publie les deux compositions marquées, [1, 3].

La coupure qui reste en anglais est first au-dessus de [2, 3], page 211. En espagnol, la première épreuve en trouve quatre, dont CP+ au-dessus de = 19,19 et [4, au-dessus de 5], où l’appel lui-même se coupe, et la seconde en garde une, anteriores [4, au-dessus de 5].
#4 · Des appels numérotés entre crochets
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' } };
Le processeur de citations compose chaque [@key] sous la forme d’un numéro entre crochets après une espace et regroupe les suites comme [4–6]. L’espace avant le crochet et celle qui suit une virgule à l’intérieur sont deux endroits où une ligne peut se couper : c’est pourquoi une colonne étroite chargée de citations a besoin de la règle.
#5 · Le bandeau de la revue et le bloc de l’article
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) }),
] } };
Le style de titre dessine le bandeau de la revue, le type d’article, le titre, les auteurs avec leurs numéros d’affiliation et une note, le tout à partir d’attributs du H1. Les deux éditions partagent ce style, et le texte reste dans le Markdown.
La recette complète
// ═══ 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
Le script.js composé s’exécute tel quel : collez-le dans le script de module de n’importe quelle page, ou ouvrez la recette sur CodePen. Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)
Variantes
#Signaler les coupures sans rien changer
Une revue qui vérifie ses épreuves à la main peut laisser la règle à 'warn' : le Sandbox liste chaque coupure parmi ses avertissements, et les lignes restent telles que l’algorithme les a coupées.
- citationBreaks: 'avoid', operatorBreaks: 'avoid',
+ citationBreaks: 'warn', operatorBreaks: 'warn',#Garder la pénalité par défaut
À 10000, l’espacement reste un peu plus serré et il reste deux coupures par édition au lieu d’une.
- citationBreakPenalty: 30000, operatorBreakPenalty: 30000,Erreurs fréquentes
Avertissement de mise en page · citationBreak
Citation en début de ligne
Pourquoi. Une ligne d’un paragraphe commence par une citation numérotée placée après un mot, ou par un morceau de celle-ci : « auteurs » en fin de ligne et « [12] » en tête de la suivante, ou « [14, » au-dessus de « 16] ». Un nombre entre crochets ou parenthèses après un nombre n’est pas une citation (« 2016 (3) »), ni un mot entre crochets. Le texte de droite à gauche et le chinois, le japonais ou le coréen sont laissés tels quels. Avec bodyText.citationBreaks sur 'warn', chaque coupure de ce genre est signalée ; sur 'avoid', celles que la coupure des lignes a gardées parce qu’aucune composition dans l’espacement des mots ne les évitait pour moins que bodyText.citationBreakPenalty. Le moteur note chacune dans doc.contentWarnings avec la citation, les deux lignes et leur page.
Correction. Réglez bodyText.citationBreaks sur 'avoid' : la coupure des lignes donne un prix à une coupure avant une citation ou à l’intérieur et recompose le paragraphe là où l’espacement des mots le permet ; l’espace continue de s’étirer avec les autres. Une coupure qui reste coûte plus à éviter que bodyText.citationBreakPenalty, souvent parce que la citation est large pour la justification : augmentez la pénalité pour l’échanger contre des lignes plus lâches, ou écrivez une espace insécable (U+00A0) entre le mot et la citation pour lier cette paire quelle que soit la règle. Dans le portage d’un livre existant, gardez 'warn' : le portage reproduit les coupures de l’original. Docs →
Avertissement de mise en page · operatorBreak
Signe en bord de ligne
Pourquoi. Une ligne d’un paragraphe finit ou commence par un signe isolé entre espaces, l’un de = < > ≤ ≥ ± × ≈ ≠ ÷ − + · → : « LR+ = » en fin de ligne avec « 18,29 » sur la suivante, ou « ± 0,03 » en tête de ligne. Un trait d’union entre deux mots n’est pas un signe. Le texte de droite à gauche et le chinois, le japonais ou le coréen sont laissés tels quels. Avec bodyText.operatorBreaks sur 'warn', chaque coupure de ce genre est signalée, une par coupure (une ligne qui commence et finit par un signe en donne deux) ; sur 'avoid', celles que la coupure des lignes a gardées parce qu’aucune composition dans l’espacement des mots ne les évitait pour moins que bodyText.operatorBreakPenalty. Le moteur note chacune dans doc.contentWarnings avec le signe, le bord (fin ou début), les deux lignes et leur page.
Correction. Réglez bodyText.operatorBreaks sur 'avoid' : la coupure des lignes donne un prix à une coupure aux espaces de part et d’autre du signe et recompose le paragraphe là où l’espacement des mots le permet. Une coupure qui reste coûte plus à éviter que bodyText.operatorBreakPenalty, souvent dans une colonne étroite où le signe et ses deux termes sont larges : augmentez la pénalité pour l’échanger contre des lignes plus lâches, ou écrivez des espaces insécables (U+00A0, ou U+202F pour une fine) autour du signe pour le lier quelle que soit la règle. Dans le portage d’un livre existant, gardez 'warn' : le portage reproduit les coupures de l’original. Docs →
- Les coupures se cherchent dans les lignes déjà coupées. Un changement de format, de corps ou de texte les déplace : lisez les avertissements de chaque composition au lieu de recopier les positions d’une composition antérieure.
- Pour garder un appel précis avec son mot quelle que soit la colonne, tapez une espace insécable devant lui dans le Markdown. La règle s’occupe du reste de l’article.
Crédits
- Recette
- Ignacio Ferro
- Texte
- Texte original, CC BY 4.0
- Polices
- STIX Two Text (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
Modifier ce texte ↗ (s’ouvre dans un nouvel onglet)Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)


