انتقل إلى المحتوى الرئيسي
الوصفة رقم 186

دليل الوصفات · الفصل 2 · الحروف والنص

إحالات وإحصاءات بعيدًا عن حواف الأسطر

مقال سريري في عمودين يُنضَّد مرتين: البروفة الأولى تُبلغ عن كل إحالة أو علامة عند حافة سطر، والثانية ترفع كلفة هذه المواضع في تقسيم الأسطر.

في هذه الصفحة

ص 211 · 1 من 6

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 170 × 240 مم
  • عمودان, فاصل 6 مم بين الأعمدة
  • STIX Two Text 9.5/12.8
  • IBM Plex Sans
  • IBM Plex Sans Condensed
  • 6 صفحات
  • المستوى
  • Postext 1.79.0
  • أُخرجت في 153 ms
  • أسطر الشيفرة: 180

باختصار

في عمود ضيق مضبوط الطرفين قد يبدأ رقم إحالة مثل [2, 3] سطرًا وحده، وقد ينقسم p < 0.05 بعد العلامة. يُنضَّد المقال مرتين: مرة تبيّن أين يحدث ذلك، ومرة تُقسَّم فيها الأسطر بحيث لا يكاد يحدث.

ما الذي ستنضده

ثلاث صفحات من مجلة لطب الأطفال مقاسها 170 × 240 مم، في عمودين مضبوطي الطرفين عرض كلٍّ منهما 66 مم، بخط STIX Two Text: دراسة أصلية عن تصوير الرئة بالموجات فوق الصوتية في تشخيص الالتهاب الرئوي، مع قائمة مراجع مرقّمة بأسلوب Vancouver. العمود بهذا الضيق يترك لخوارزمية تقسيم الأسطر خيارات قليلة، وفي ثلاثة مواضع ينقسم النص الإنجليزي انقسامًا سيئًا. تبدأ إحالةٌ، [2, 3]، سطرًا وحدها بعيدًا عن الكلمة التي تسندها، وتنقسم نسبة الأرجحية السلبية LR− = 0.09 مرتين بعد علامة المساواة. تُنضَّد البروفة الأولى بضبط citationBreaks وoperatorBreaks على 'warn'. لا تغيّر أي موضع قطع، بل تضع تحت كلٍّ منها شريطًا كهرمانيًا باهتًا وتسردها في قسيمة بعد المراجع. وتُنضَّد الثانية بـ'avoid'، فيبقى موضع واحد من الثلاثة. وتنضّد الطبعة الإسبانية الدراسة نفسها بفاصلة عشرية.

تجيب هذه الوصفة عن

  • كيف أمنع رقم الإحالة أو قيمة إحصائية مثل p < 0.05 من الانقسام عند آخر السطر؟
  • كيف أنضد أرقام الاستشهادات علوية وأجعل معرّفات DOI روابط فعّالة، كما تفعل المجلات الطبية؟

الجواب المختصر

script.js · الأسطر 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,
};

المكونات

الخطوط
STIX Two Text, IBM Plex Sans, IBM Plex Sans Condensed (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

طريقة التحضير

#1 · ثمن لنوعين من القطع

الشيفرة هي الجواب المختصر أعلاه. يكون القطع عند إحالة حين يبدأ سطر برقم إحالة، أو بنصفها الثاني، مثل 5] بعد [4,. ويكون القطع عند علامة حين ينتهي سطر أو يبدأ بعلامة محاطة بمسافتين: = و< و± و× وعلامة الطرح. القيمة 'warn' تُبلغ عن النوعين وتترك الأسطر كما هي. والقيمة 'avoid' تضيف عقوبة إلى كلفة هذه المواضع، فتبحث خوارزمية Knuth–Plass عن تقسيم آخر للفقرة. ويلزم لذلك optimalLineBreaking: فالتقسيم سطرًا بسطر لا كلفة له يُضاف إليها شيء.

العقوبة الافتراضية 10000 هي كلفة سطر مُدَّ حتى حدّ المسافة بين الكلمات، فلا توسّع الخوارزمية سطرًا أبعد من هذا الحد لتُبقي إحالة بجانب كلمتها. في هذا العمود أبقت 10000 موضعين في كل طبعة. وبقيمة 30000 تقبل الخوارزمية أسطرًا أوسع، ضمن maxWordSpacing دائمًا، فيبقى موضع واحد في كل طبعة. ولم تغيّر قيمة أعلى شيئًا: فالموضع الأخير لا بديل له ضمن الحد.

#2 · تعليم مواضع القطع في النص

script.js · الأسطر 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);
}

يحمل كل تحذير نوعه، والإحالة أو العلامة، ونص السطرين، وموضع الأول منهما في النص المصدر، والصفحة. يبحث السكربت عن هذين السطرين في المستند المنضَّد ويحيط موضع القطع بـ:mark[…]: الكلمة التي قبل الإحالة والإحالة، أو العلامة والعدد الذي على جانبها الآخر. العلامة ترسم شريطًا تحت النص وتترك مواضع القطع حيث كانت. ولا يبلغ الشريط الرقم الذي يولّده أسلوب الإحالات، فلا تُعلَّم في الصفحة إلا الكلمة التي قبله.

البروفة الأولى، الصفحة 211: ‏LR− = 0.09 منقسمة في الملخص، وfirst في آخر سطر يبدأ السطر الذي يليه بـ[2, 3].

#3 · بروفتان وقسيمة استفسارات

script.js · الأسطر 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') };

تُنضَّد كل بروفة مرتين. التنضيد الأول يجد مواضع القطع، والثاني ينضّد المقال مع العلامات وقسيمة بعد المراجع، فتقع القسيمة في الصفحة الأخيرة. وهكذا يعيد المنضّد البروفات مع استفساراته. وتربط أسطر القسيمة كلماتها بمسافات غير فاصلة، فلا تضيف مواضع قطع من عندها. ينشر capture.doc التنضيدين المعلَّمين، [1, 3].

البروفة الثانية، الصفحة 213: تسرد القسيمة موضع قطع واحدًا باقيًا في المقال.

الموضع الباقي في الإنجليزية هو first فوق [2, 3] في الصفحة 211. وفي الإسبانية تجد البروفة الأولى أربعة، منها CP+ فوق = 19,19 و*[4,* فوق 5] حيث تنقسم الإحالة نفسها، وتُبقي الثانية واحدًا، anteriores [4, فوق 5].

#4 · إحالات مرقّمة بين معقوفين

script.js · الأسطر 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' } };

ينضّد معالج الإحالات كل [@key] رقمًا بين معقوفين بعد مسافة، ويجمع المتواليات مثل [4–6]. المسافة التي قبل المعقوف والتي بعد الفاصلة داخله كلتاهما موضع يمكن أن ينقطع فيه السطر، ولذلك يحتاج العمود الضيق الكثير الإحالات إلى هذه القاعدة.

#5 · ترويسة المجلة وكتلة المقال

script.js · الأسطر 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) }),
] } };

يرسم نمط العنوان شريط المجلة، ونوع المقال، والعنوان، والمؤلفين بأرقام انتماءاتهم، وحاشية، وكل ذلك من سمات H1. تشترك الطبعتان في النمط، ويبقى النص في Markdown.

الوصفة كاملة

Sandbox
// ═══ 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

يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)

تنويعات

#أبلغ عن مواضع القطع ولا تغيّر شيئًا

يمكن لمجلة تراجع بروفاتها يدويًا أن تُبقي القاعدة على 'warn': يسرد Sandbox كل موضع قطع بين تحذيراته، وتبقى الأسطر كما قسّمتها الخوارزمية.

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

#أبقِ العقوبة الافتراضية

بقيمة 10000 تبقى المسافات أضيق قليلًا، ويبقى موضعان في كل طبعة بدل موضع واحد.

-  citationBreakPenalty: 30000, operatorBreakPenalty: 30000,

أخطاء شائعة

تحذير الإخراج · citationBreak

إحالة في أول السطر

السبب. يبدأ سطر من فقرة بإحالة مرقّمة بعد كلمة، أو بجزء منها: «المؤلفون» في آخر سطر و«[12]» في أول السطر التالي، أو «[14,» فوق «16]». ولا يُعدّ إحالةً رقمٌ بين قوسين بعد رقم («2016 (3)»)، ولا كلمةٌ بين معقوفين. ويُترك النص من اليمين إلى اليسار والنص الصيني أو الياباني أو الكوري كما هو. إذا كانت bodyText.citationBreaks على 'warn' يُبلَّغ عن كل كسر من هذا النوع، وإذا كانت على 'avoid' فعن الكسور التي أبقاها كسر الأسطر لأنه لم يكن ثمة تنضيد ضمن التباعد بين الكلمات يتجنّبها بأقل من bodyText.citationBreakPenalty. ويُدرج المحرّك كلًّا منها في doc.contentWarnings مع الإحالة والسطرين وصفحتهما.

الحل. اجعل bodyText.citationBreaks على 'avoid': يضع كسر الأسطر ثمنًا للكسر قبل الإحالة أو داخلها وينضّد الفقرة على نحو آخر حيث يسمح التباعد بين الكلمات؛ وتظل المسافة تتمدّد مع غيرها. والكسر الذي يبقى كلفة تجنّبه أعلى من bodyText.citationBreakPenalty، وكثيرًا ما يكون ذلك لأن الإحالة عريضة بالنسبة إلى عرض السطر: ارفع العقوبة لتقبل أسطرًا أوسع تباعدًا مقابله، أو اكتب مسافة غير فاصلة (U+00A0) بين الكلمة والإحالة لتربط هذا الزوج أيًّا كانت القاعدة. وفي نقل كتاب قائم أبقِها على 'warn': فالنقل يعيد كسور الأسطر في الأصل. التوثيق →

تحذير الإخراج · operatorBreak

علامة على طرف السطر

السبب. ينتهي سطر من فقرة أو يبدأ بعلامة منفردة بين مسافتين، إحدى = < > ≤ ≥ ± × ≈ ≠ ÷ − + · →: «LR+ =» في آخر سطر و«18.29» في السطر التالي، أو «± 0.03» في أول سطر. ولا تُعدّ الشرطة بين كلمتين علامة. ويُترك النص من اليمين إلى اليسار والنص الصيني أو الياباني أو الكوري كما هو. إذا كانت bodyText.operatorBreaks على 'warn' يُبلَّغ عن كل كسر من هذا النوع، واحد لكل كسر (السطر الذي يبدأ بعلامة وينتهي بعلامة يعطي اثنين)، وإذا كانت على 'avoid' فعن الكسور التي أبقاها كسر الأسطر لأنه لم يكن ثمة تنضيد ضمن التباعد بين الكلمات يتجنّبها بأقل من bodyText.operatorBreakPenalty. ويُدرج المحرّك كلًّا منها في doc.contentWarnings مع العلامة والطرف (النهاية أو البداية) والسطرين وصفحتهما.

الحل. اجعل bodyText.operatorBreaks على 'avoid': يضع كسر الأسطر ثمنًا للكسر عند المسافتين على جانبي العلامة وينضّد الفقرة على نحو آخر حيث يسمح التباعد بين الكلمات. والكسر الذي يبقى كلفة تجنّبه أعلى من bodyText.operatorBreakPenalty، وكثيرًا ما يكون ذلك في عمود ضيق تكون فيه العلامة وطرفاها عريضة: ارفع العقوبة لتقبل أسطرًا أوسع تباعدًا مقابله، أو اكتب مسافات غير فاصلة (U+00A0، أو U+202F لمسافة رفيعة) حول العلامة لتربطها أيًّا كانت القاعدة. وفي نقل كتاب قائم أبقِها على 'warn': فالنقل يعيد كسور الأسطر في الأصل. التوثيق →

  • يُبحث عن مواضع القطع في الأسطر بعد تقسيمها. تغيير المقاس أو حجم الخط أو النص ينقلها، فاقرأ تحذيرات كل تنضيد ولا تنسخ مواضع من تنضيد سابق.
  • لإبقاء إحالة بعينها بجانب كلمتها في أي عمود، اكتب قبلها مسافة غير فاصلة في Markdown. وتتكفّل القاعدة ببقية المقال.

الحقوق

الوصفة
Ignacio Ferro
النص
نص أصلي, CC BY 4.0
الخطوط
STIX Two Text (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox