Kurz gesagt
In einer schmalen Spalte im Blocksatz kann ein Verweis wie [2, 3] allein eine Zeile beginnen und p < 0,05 nach dem Zeichen umbrechen. Der Artikel wird zweimal gesetzt: einmal mit markierten Stellen, einmal so, dass es kaum noch vorkommt.
Was Sie setzen
Drei Seiten einer pädiatrischen Fachzeitschrift im Format 170 × 240 mm, zweispaltig im Blocksatz mit 66 mm Spaltenbreite aus der STIX Two Text: eine Originalarbeit über Lungenultraschall bei Pneumonie mit nummeriertem Literaturverzeichnis nach Vancouver. Eine so schmale Spalte lässt dem Zeilenumbruch wenig Spielraum, und an drei Stellen bricht der englische Text schlecht um. Ein Verweis, [2, 3], steht allein am Anfang einer Zeile, getrennt von dem Wort, auf das er sich bezieht, und zweimal bricht der negative Likelihood-Quotient LR− = 0.09 nach dem Gleichheitszeichen um. Die erste Korrektur wird mit citationBreaks und operatorBreaks auf 'warn' gesetzt. Sie ändert keinen Umbruch, markiert jeden mit einem blassen bernsteinfarbenen Band und listet sie auf einem Zettel nach dem Literaturverzeichnis. Die zweite wird mit 'avoid' gesetzt, und einer der drei bleibt. Die spanische Ausgabe setzt dieselbe Studie mit Dezimalkomma.
Dieses Rezept beantwortet
- Wie verhindere ich, dass eine Zitatnummer oder eine Angabe wie p < 0,05 am Zeilenende getrennt wird?
- Wie setze ich Zitatnummern hochgestellt und mache DOIs zu aktiven Links, wie medizinische Fachzeitschriften es tun?
Die kurze Antwort
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,
};
Zutaten
- Funktionen
- Zitate und Zeichen am ZeilenrandOptimaler Zeilenumbruch (Knuth-Plass)Zitate in einem ZitierstilLiteraturverzeichnis aus den QuellenHervorhebungenSilbentrennung und DokumentspracheEine oder zwei SpaltenGestaltete AuftakteÜberschriftenattributeÜberschriftenformateKolumnentitel und SeitenzahlenKopfzeilen nach SeitenrolleGespiegelte RänderKästenSemantische Farbpalette
- Nutzt außerdem
- Das Raster bewusst verlassenAbsatzformateRömisch paginierte TiteleiHoch- und TiefstellungKapitel ohne Nummer
- Schrift
- STIX Two Text, IBM Plex Sans, IBM Plex Sans Condensed (SIL OFL 1.1)
- Dateien
- Keine: Jedes Bild wird im Code gezeichnet
Zubereitung
#1 · Ein Preis für zwei Arten von Umbruch
Der Code steht oben in der kurzen Antwort. Ein Verweisumbruch liegt vor, wenn eine Zeile mit einem nummerierten Verweis beginnt oder mit der zweiten Hälfte eines Verweises, etwa 5] nach [4,. Ein Zeichenumbruch liegt vor, wenn eine Zeile mit einem Zeichen zwischen Leerzeichen endet oder beginnt: =, <, ±, × oder dem Minus. 'warn' meldet beide und lässt die Zeilen, wie sie sind. 'avoid' schlägt eine Strafe auf die Kosten dieser Umbrüche, und der Knuth–Plass-Umbruch sucht einen anderen Weg durch den Absatz. Dafür braucht es optimalLineBreaking: Der zeilenweise Umbruch hat keine Kosten, auf die sich etwas aufschlagen ließe.
Die voreingestellte Strafe, 10000, entspricht den Kosten einer Zeile, die bis an die Grenze des Wortabstands gedehnt ist. Der Umbruch öffnet also nie eine Zeile über diese Grenze hinaus, um einen Verweis bei seinem Wort zu halten. In dieser Spalte ließ 10000 in jeder Ausgabe zwei Umbrüche stehen. Bei 30000 nimmt der Umbruch lockerere Zeilen in Kauf, immer innerhalb von maxWordSpacing, und in jeder Ausgabe bleibt einer. Ein höherer Wert änderte nichts mehr: Für den letzten Umbruch gibt es innerhalb der Grenze keine Alternative.
#2 · Die Umbrüche im Text markieren
// 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);
}
Jede Warnung enthält ihre Art, den Verweis oder das Zeichen, den Text der beiden Zeilen, die Position der ersten im Quelltext und die Seite. Das Skript sucht diese beiden Zeilen im gesetzten Dokument und umschließt den Umbruch mit :mark[…]: das Wort vor dem Verweis und den Verweis, oder das Zeichen und die Zahl auf seiner anderen Seite. Eine Markierung malt ein Band unter den Text und lässt die Umbrüche, wo sie waren. Das Band reicht nicht bis zu der Nummer, die der Zitierstil erzeugt; auf der Seite ist deshalb nur das Wort davor markiert.

#3 · Zwei Korrekturen und ein Zettel mit Rückfragen
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') };
Jede Korrektur wird zweimal gesetzt. Der erste Durchgang findet die Umbrüche; der zweite setzt den Artikel mit den Markierungen und einem Zettel nach dem Literaturverzeichnis, der so auf die letzte Seite fällt. So schickt auch ein Setzer seine Korrekturabzüge mit Rückfragen zurück. Die Zeilen des Zettels verbinden ihre Wörter mit geschützten Leerzeichen und erzeugen so keine eigenen Umbrüche. capture.doc veröffentlicht die beiden markierten Durchgänge, [1, 3].

Der Umbruch, der im Englischen bleibt, ist first über [2, 3] auf Seite 211. Im Spanischen findet die erste Korrektur vier, darunter CP+ über = 19,19 und [4, über 5], wo der Verweis selbst getrennt wird, und die zweite behält einen, anteriores [4, über 5].
#4 · Nummerierte Verweise in eckigen Klammern
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' } };
Der Zitierprozessor setzt jedes [@key] als Nummer in eckigen Klammern nach einem Wortzwischenraum und fasst Folgen wie [4–6] zusammen. Der Zwischenraum vor der Klammer und der nach einem Komma in ihr sind beides Stellen, an denen eine Zeile umbrechen kann. Deshalb braucht eine schmale Spalte mit vielen Verweisen die Regel.
#5 · Zeitschriftenkopf und Artikelblock
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) }),
] } };
Der Überschriftenstil zeichnet das Band der Zeitschrift, die Artikelart, den Titel, die Autoren mit ihren Affiliationsnummern und eine Anmerkung, alles aus Attributen der H1. Beide Ausgaben teilen den Stil, und der Text bleibt im Markdown.
Das ganze Rezept
// ═══ 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
Das zusammengesetzte script.js läuft unverändert: Fügen Sie es in das Modulskript einer beliebigen Seite ein, oder öffnen Sie das Rezept auf CodePen. Ordner des Rezepts auf GitHub ↗ (öffnet sich in einem neuen Tab)
Varianten
#Umbrüche melden und nichts ändern
Eine Zeitschrift, die ihre Korrekturen von Hand prüft, kann die Regel auf 'warn' lassen: Die Sandbox listet jeden Umbruch unter ihren Warnungen, und die Zeilen bleiben, wie der Umbruch sie gesetzt hat.
- citationBreaks: 'avoid', operatorBreaks: 'avoid',
+ citationBreaks: 'warn', operatorBreaks: 'warn',#Die voreingestellte Strafe behalten
Bei 10000 bleibt der Satz etwas enger, und in jeder Ausgabe bleiben zwei Umbrüche statt einem.
- citationBreakPenalty: 30000, operatorBreakPenalty: 30000,Häufige Fehler
Layoutwarnung · citationBreak
Zitat am Zeilenanfang
Ursache. Eine Zeile eines Absatzes beginnt mit einem nummerierten Zitat nach einem Wort oder mit einem Stück davon: „Autoren“ am Ende einer Zeile und „[12]“ am Anfang der nächsten, oder „[14,“ über „16]“. Eine Zahl in Klammern nach einer Zahl ist kein Zitat („2016 (3)“), ebenso wenig ein Wort in Klammern. Text von rechts nach links und chinesischer, japanischer oder koreanischer Text bleiben, wie sie sind. Mit bodyText.citationBreaks auf 'warn' wird jeder solche Umbruch gemeldet; auf 'avoid' die, die der Zeilenumbruch behielt, weil kein Satz innerhalb des Wortabstands sie für weniger als bodyText.citationBreakPenalty vermied. Die Engine trägt jeden in doc.contentWarnings ein, mit dem Zitat, den beiden Zeilen und ihrer Seite.
Lösung. Setzen Sie bodyText.citationBreaks auf 'avoid': Der Zeilenumbruch gibt einem Umbruch vor oder in einem Zitat einen Preis und setzt den Absatz anders, wo der Wortabstand es erlaubt; das Leerzeichen dehnt sich weiter mit den anderen. Ein Umbruch, der bleibt, kostet mehr als bodyText.citationBreakPenalty, oft weil das Zitat für die Satzbreite breit ist: Erhöhen Sie den Strafwert, um ihn gegen lockerere Zeilen zu tauschen, oder schreiben Sie ein geschütztes Leerzeichen (U+00A0) zwischen Wort und Zitat, damit das Paar unabhängig von der Regel zusammenbleibt. Bei der Portierung eines bestehenden Buchs bleiben Sie bei 'warn': Die Portierung gibt die Umbrüche des Originals wieder. Doku →
Layoutwarnung · operatorBreak
Zeichen am Zeilenrand
Ursache. Eine Zeile eines Absatzes endet auf ein einzelnes Zeichen zwischen Leerzeichen oder beginnt damit, eines von = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: „LR+ =“ am Zeilenende mit „18,29“ in der nächsten Zeile, oder „± 0,03“ am Zeilenanfang. Ein Bindestrich zwischen Wörtern ist kein Zeichen. Text von rechts nach links und chinesischer, japanischer oder koreanischer Text bleiben, wie sie sind. Mit bodyText.operatorBreaks auf 'warn' wird jeder solche Umbruch gemeldet, einer pro Umbruch (eine Zeile, die mit einem Zeichen beginnt und endet, ergibt zwei); auf 'avoid' die, die der Zeilenumbruch behielt, weil kein Satz innerhalb des Wortabstands sie für weniger als bodyText.operatorBreakPenalty vermied. Die Engine trägt jeden in doc.contentWarnings ein, mit dem Zeichen, dem Rand (Ende oder Anfang), den beiden Zeilen und ihrer Seite.
Lösung. Setzen Sie bodyText.operatorBreaks auf 'avoid': Der Zeilenumbruch gibt einem Umbruch an den Leerzeichen beiderseits des Zeichens einen Preis und setzt den Absatz anders, wo der Wortabstand es erlaubt. Ein Umbruch, der bleibt, kostet mehr als bodyText.operatorBreakPenalty, oft in einer schmalen Spalte, in der das Zeichen und seine beiden Glieder breit sind: Erhöhen Sie den Strafwert, um ihn gegen lockerere Zeilen zu tauschen, oder schreiben Sie geschützte Leerzeichen (U+00A0, oder U+202F für ein schmales) um das Zeichen, damit es unabhängig von der Regel zusammenbleibt. Bei der Portierung eines bestehenden Buchs bleiben Sie bei 'warn': Die Portierung gibt die Umbrüche des Originals wieder. Doku →
- Die Umbrüche werden in den fertig umbrochenen Zeilen gesucht. Eine Änderung von Format, Schriftgrad oder Text verschiebt sie. Lesen Sie die Warnungen jedes Durchgangs und übernehmen Sie keine Positionen aus einem früheren.
- Um einen bestimmten Verweis in jeder Spalte bei seinem Wort zu halten, tippen Sie im Markdown ein geschütztes Leerzeichen davor. Den Rest des Artikels übernimmt die Regel.
Nachweise
- Rezept
- Ignacio Ferro
- Text
- Eigener Text, CC BY 4.0
- Schriften
- STIX Two Text (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
- Code
- MIT, wie Postext
Diesen Text bearbeiten ↗ (öffnet sich in einem neuen Tab)Ordner des Rezepts auf GitHub ↗ (öffnet sich in einem neuen Tab)


