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

دليل الوصفات · الفصل 10 · الإخراج والدمج

بروفة صحيفة كل خطأ فيها معلَّم بالأحمر

بروفة صحيفة تُراجَع مرتين، وكل خطأ يذكره المحرّك أو يجده المثال بنفسه معلَّم بالأحمر على الصفحة ومربوط بنص Markdown الذي سبّبه.

في هذه الصفحة
المستوى
متقدم
Postext
اختُبرت مع Postext 1.65.0
تتطلب ≥ 1.34.0
الترخيص
حُدّثت في 16 أكتوبر 2026
الشيفرة MIT · النص CC BY 4.0
  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 190 × 253 مم
  • عمود ونصف, فاصل 6 مم بين الأعمدة
  • Charis SIL 10/14
  • Chivo
  • Fragment Mono
  • صفحتان
  • المستوى
  • Postext 1.57.1
  • أُخرجت في 8 ms
  • أسطر الشيفرة: 250

باختصار

خبر من صحيفة أسبوعية محلية يُراجَع مرتين بحثًا عن الأخطاء. يبيّن كيف تعلّم كل خطأ بالأحمر على الصفحة وتربطه بسطر النص الذي سبّبه.

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

يتصدّر العدد 41 من The Tideline، وهي صحيفة أسبوعية في مقاطعة، خبرُ عودة العبّارة الليلية عبر نهر Sawyer، ويراجع المثال بروفة الخبر مرتين. الجولة الأولى هي النص كما سُلِّم، أي الخبر المصحَّح وقد أُعيدت إليه سبع هفوات، منها ختم كُتب توجيهًا غير موجود وإطار وقائع لا يُغلق أبدًا. تترك هذه الهفوات السبع إحدى عشرة علامة. وكما في البطاقة، يوضع تحت كل خطأ خط أحمر على السطر الذي نُضّد فيه (أما السطر المتخلخل فيُظلَّل بدلًا من ذلك)، ويطابق رقمه في الهامش مدخله في القائمة بجوار الصفحات. والنقر على سطر أو مدخل يحدّد نص Markdown الخاص به. والصفحات أدناه هي الجولة الثانية. لا تجد الفحوص فيها شيئًا، وختم PROOF · 2ND PASS مثبّت في الزاوية العليا اليمنى.

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

  • كيف أعرف ما الخطأ في مستندي (تحذيرات، فيض، إخراج لا يستقر)؟
  • كيف أربط نقرة على الصفحة المعروضة بموضعها في مصدر Markdown، لأبني محرّرًا؟
  • لماذا يُنضَّد سطر واحد غير مضبوط أو متمددًا أكثر من اللازم (عناوين URL، كلمات مركّبة طويلة، كلمات طويلة في الخلايا)؟

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

script.js · الأسطر 170–203في الشيفرة الكاملة
const MM = DPI / 25.4; // page px per mm
function proof(md, doc) {
  const faults = [];
  const add = (kind, from, to, detail, at) => faults.push({ kind, from, to, detail, at });
  const { blocks, issues } = parseMarkdownWithIssues(md); // a $, $$ or ::: left open
  for (const i of issues) add(i.kind, i.sourceStart, i.sourceEnd);
  for (const w of doc.warnings ?? []) { // calloutOverflow: a box no cut could split
    add(w.kind, w.sourceStart, w.sourceEnd, Math.round(w.overflowPx / MM), w);
  }
  if (!doc.converged) add('unsettled', 0, 1, doc.iterationCount); // the layout never settled
  // The pen's own readings of the source and the lines, in the same list and shape.
  const ids = new Set(resources.map((r) => r.id)); // an unknown id prints '?'
  for (const m of md.matchAll(/:ref\{id="([^"]*)"|^::resource\{id="([^"]*)"/gm)) {
    if (!ids.has(m[1] ?? m[2])) add('unknownResourceId', m.index, m.index + m[0].length);
  }
  for (const m of md.matchAll(/^:::?([a-z][\w-]*)/gim)) { // an unknown fence prints as text
    const known = KNOWN_CONTAINERS.has(m[1]) || KNOWN_DIRECTIVES.has(m[1]) || m[1] === 'resource';
    if (!known) add('unknownDirective', m.index, m.index + m[0].length);
  }
  for (const b of blocks) { // formulas count as faults only because this story has none
    if (b.startNumber > 999) add('yearList', b.sourceStart, b.sourceEnd); // 1971. opens a list
    for (const s of b.spans ?? []) if (s.math) add('formula', s.math.sourceStart, s.math.sourceEnd);
  }
  // The lines as set: spaces past maxWordSpacing, a line set ragged, a hyphen in an address.
  const max = doc.config.bodyText.maxWordSpacing;
  for (const l of doc.pages.flatMap((p) => p.columns.flatMap((c) => c.blocks))
    .flatMap((b) => b.lines ?? [])) {
    const ratio = Math.round(lineWordSpacing(l) * 100) / 100; // as the report prints it
    if (ratio > max) add('looseLine', l.sourceStart, l.sourceEnd, ratio);
    if (l.ragged) add('raggedLine', l.sourceStart, l.sourceEnd); // past 3×: no ratio left
    if (l.hyphenated && /[./]\S+-$/.test(l.text)) add('addressHyphen', l.sourceStart, l.sourceEnd);
  }
  return faults.sort((a, b) => a.from - b.from);
}

المكونات

تستخدم أيضًا
عمود ونصف
الخطوط
Charis SIL, Chivo, Fragment Mono (SIL OFL 1.1)
الأصول
  • crossing-1590.jpg
  • The night crossing at the head of page 1 (Generated With Diffusion Models, أصلي)
  • The route map, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)

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

#1 · اقرأ ما يبلّغ عنه المحرّك، ثم افحص الباقي

الشيفرة هي الجواب المختصر أعلاه. يعيد parseMarkdownWithIssues() مشكلةً لكل $ أو $$ أو ::: تُرك مفتوحًا، وفي doc.warnings تحذير calloutOverflow لكل إطار لم يستطع أي قطع أن يقسمه. ويبيّن doc.converged وdoc.iterationCount هل استقر الإخراج، وهذا الخبر يستقر بعد تكرار واحد بأخطائه أو بدونها. ويسجّل المحرّك أيضًا المعرّفات والتوجيهات المجهولة في doc.contentWarnings، وتعيد findLooseLines الأسطر المتخلخلة، وهي الفحوص نفسها التي تعرضها لوحة الفحوص في Sandbox (لوحات الشريط الجانبي). أما proof() فتجري هذه القراءات بنفسها، لتقع كل الأخطاء في قائمة واحدة بشكل واحد: نوع، ومدى في Markdown، وتفصيل. فهو يقارن معرّفات :ref و::resource بـresources في البناء، وأسماء الكتل بـKNOWN_CONTAINERS وKNOWN_DIRECTIVES. ولهذا الخبر يعلّم أيضًا كتلة القائمة التي يكون startNumber فيها سنةً، وأي صيغة رياضية، لأن الخبر لا يحوي أيًّا منها، ويقرأ الأسطر المنضّدة بحثًا عن مسافات تمددت فوق maxWordSpacing، وأسطر منضّدة بحافة حرّة، وواصلات أُضيفت داخل عنوان ويب.

#2 · أعِد الأخطاء إلى النص المصحَّح

script.js · الأسطر 157–166في الشيفرة الكاملة
const FIRST_PASS = [ // [corrected, faulty], replaced wherever it occurs
  [':::callout{type="stamp"}\n:::', t({ en: ':::stamp', es: ':::sello' })], // no such directive
  [':ref{id="route"}', ':ref{id="route-map"}'], // an id no resource has
  ['\\$', '$'], // bare dollars (gotcha: dollar-math)
  [' https://', ' '], // a web address without its scheme
  [':::\n:::\n', ''], // the fact box's two closing fences
  ['\u20601971.', '1971.'], // the word joiner before 1971 (gotcha: digit-period-list)
  [t({ en: 'October 2.\n:::', es: 'octubre.\n:::' }), t({ en: 'October 2.', es: 'octubre.' })],
]; // last: the timeline's closing fence, so its box stays open inside the open fact box
const firstPass = (md) => FIRST_PASS.reduce((out, [fix, fault]) => out.replaceAll(fix, fault), md);

يحتفظ المثال بملف Markdown واحد، هو الخبر المصحَّح، ويصنع منه الجولة الأولى بإلغاء سبعة تصحيحات، فلا تبتعد النسختان إحداهما عن الأخرى ويكون لكل علامة سبب معروف. ويُبنى النص المصحَّح أخيرًا، والصفحات أدناه تعرض ذلك البناء. يقوم \$ بتهريب علامة الدولار في السعر، فلا تُفتح صيغة رياضية. ورابط الكلمات (U+2060) قبل كل سنة في الخط الزمني على الصفحة 2 يمنع مدخلًا مثل 1971. The Tern… من أن يبدأ قائمة مرقّمة ابتداءً من سنته؛ ولا تحذف الجولة الأولى إلا الرابط الذي قبل 1971. ومع البادئة https:// يُنضَّد عنوان الويب على أنه عنوان، لا يُقسَّم بالواصلة أبدًا ولا ينكسر إلا عند مفاصله، كما في الصفحة 1 قبل .example. وبدونها يصير العنوان كلمة عادية، فتقسمه الجولة الأولى بالواصلة على هيئة night-ferry. والمدخل السابع يحذف سطر الإغلاق الذي يغلق إطار الخط الزمني، والخطوة 3 تبيّن ما يصنعه التنضيد به.

#3 · علّم كل خطأ حيث نُضّد

script.js · الأسطر 207–245في الشيفرة الكاملة
const linesOf = (page) => [...page.columns.flatMap((c) => c.blocks), ...(page.floats ?? [])]
  .flatMap((b) => (b.lines ?? []).map((l) => ({ ...l.bbox, from: l.sourceStart, to: l.sourceEnd,
    width: l.justifiedSpaceRatio // a bbox is the natural width; a justified line fills the block
      ? b.bbox.x + b.bbox.width - l.bbox.x : l.bbox.width })));
const REACH = 80; // characters after a fence where its first line may start
function spotOf(page, f) { // where a fault shows on this page: its first line, in page px
  if (f.at) { // a box that ran off its column: a bar under the column's foot
    const c = page.columns[f.at.columnIndex]?.bbox;
    return f.at.pageIndex === page.index ? { ...c, y: c.y + c.height, height: 1.6 * MM } : null;
  }
  const lines = linesOf(page); // a fence sets no line of its own: then the first line after it
  return lines.find((r) => r.from < f.to && r.to > f.from)
    ?? lines.find((r) => r.from >= f.from && r.from - f.to < REACH);
}
function paintMarks(canvas, page, faults, scale) {
  const ctx = canvas.getContext('2d');
  ctx.setTransform(scale, 0, 0, scale, 0, 0); // page px from here on
  Object.assign(ctx, { font: `${3 * MM}px "${MONO}"`, textAlign: 'center' });
  const taken = []; // the numbers set so far: two on one line sit side by side
  faults.forEach((f, n) => {
    const r = spotOf(page, f);
    if (!r) return;
    const wash = f.kind === 'looseLine'; // a loose line is washed, any other fault underlined
    Object.assign(ctx, { fillStyle: palette.proof, globalAlpha: wash ? 0.2 : 1 });
    ctx.fillRect(r.x, wash ? r.y : r.y + r.height, r.width, wash ? r.height : 0.45 * MM);
    const [left, y] = [r.x + r.width / 2 < page.width / 2, r.y + r.height / 2]; // nearest margin
    const shift = taken.filter((ty) => Math.abs(ty - y) < 4.5 * MM).length * 5.2 * MM;
    const [x, edge] = [left ? 6.5 * MM + shift : page.width - 6.5 * MM - shift,
      left ? r.x : r.x + r.width]; // the number, and a leader from it to the text
    taken.push(y);
    ctx.globalAlpha = 1;
    ctx.fillRect(Math.min(x, edge), y - 0.12 * MM, Math.abs(x - edge), 0.24 * MM);
    ctx.beginPath();
    ctx.arc(x, y, 2.4 * MM, 0, 2 * Math.PI);
    ctx.fill();
    ctx.fillStyle = palette.paper;
    ctx.fillText(String(n + 1), x, y + 1.05 * MM);
  });
}

لكل سطر في VDT sourceStart وsourceEnd، فيقود نطاق المصدر للخطأ إلى السطر الذي طبعه. وسطر فتح الحاوية لا يُنتج سطرًا مطبوعًا، فتوضع علامته على أول سطر يبدأ ضمن REACH (80) حرفًا بعده. ويأخذ calloutOverflow شريطًا تحت أسفل العمود الذي يذكره. وقد تترك هفوة واحدة عدة علامات. فعلامات الدولار غير المهرَّبة تحوّل $2.50 on foot, $ إلى صيغة رياضية، لا تطبع شيئًا لأن هذا المثال لا يحمّل محرّك الرياضيات أبدًا، وعلامة الدولار الثالثة تفتح صيغة لا تُغلق أبدًا. وبدون تلك العبارة يخرج سطر من فقرة الأجور بمسافات تبلغ 1.9 ضعف عرضها العادي. وسطرا الإغلاق المفقودان من إطار الوقائع يتركانه هو ومجموعة :::columns الخاصة به مفتوحين حتى نهاية الخبر، فيُنضَّد ما يليهما داخلهما، في العمود الثاني من المجموعة. ومجموعة الأعمدة تُقطع بين أعمدتها كالإطار الذي يحويها، فلا يتجاوز شيء حدوده بسبب هذين السطرين وحدهما. والتجاوز يأتي من سطر إغلاق الخط الزمني المفقود. يبقى إطاره مفتوحًا داخل إطار الوقائع، فيضمّ الفقرات الخمس الأخيرة وبيانات الطبع، والإطار الواقع داخل إطار آخر لا يُقطع أبدًا. يُنضَّد في الصفحة 3 ويتجاوز أسفل العمود بمقدار 69 مم؛ وما يقع تحت ذلك الأسفل لا يُطبع، فتكون الجولة الأولى ثلاث صفحات لا صفحتين. ويتضمّن التحذير نطاق المصدر لإطار الوقائع، لأنه الإطار الذي وضعه التنضيد، فيحدّد المدخل 8 الإطار الخارجي من سطر فتحه حتى نهاية الخبر. ويعدّ proof() السطر متخلخلًا حين يتجاوز تباعد كلماته، lineWordSpacing(line)، قيمة maxWordSpacing (1.6 هنا). أما السطر الذي ستتجاوز مسافاته 3 أضعاف فلا نسبة له تُقارَن، لأن المحرّك ينضّده بحافة حرّة بدلًا من ذلك، فيفحص proof() قيمة ragged أيضًا.

#4 · حدّد نص Markdown الذي وراء السطر

script.js · الأسطر 249–267في الشيفرة الكاملة
function selectSource(from, to) {
  const all = source.value; // measure the wrapped height of the text before the selection
  source.value = all.slice(0, from);
  const top = source.scrollHeight;
  source.value = all;
  source.focus({ preventScroll: true });
  source.setSelectionRange(from, to); // the offsets the parser and the layout give
  source.scrollTop = top > source.clientHeight ? top - source.clientHeight / 3 : 0;
}
function onPageClick(canvas, page) {
  canvas.onclick = ({ clientX, clientY }) => {
    const box = canvas.getBoundingClientRect(); // CSS px to page px
    const [x, y] = [(clientX - box.left) * (page.width / box.width),
      (clientY - box.top) * (page.height / box.height)];
    const hit = linesOf(page).find((r) => x >= r.x && x <= r.x + r.width && y >= r.y
      && y <= r.y + r.height);
    if (hit?.from !== undefined) selectSource(hit.from, hit.to);
  };
}

تصل النقرة ببكسلات CSS. يحوّلها onPageClick() إلى بكسلات الصفحة، ويجد السطر الذي يحتويها bbox الخاص به، ويحدّد نطاق مصدر ذلك السطر في منطقة النص؛ ويحدّد المدخل في القائمة نطاق خطئه بالطريقة نفسها. ويركّز selectSource() على منطقة النص دون تمرير الصفحة، ويضبط scrollTop لها من ارتفاع النص الذي قبل التحديد. ويحتفظ bbox للسطر المضبوط بعرض السطر الطبيعي، لا بالعرض الذي يُرسم به، فيمدّه linesOf() حتى الحافة اليمنى لكتلته. وإلا لتوقف التظليل قبل الهامش، ولما حدّدت النقرة قرب الحافة اليمنى شيئًا.

#5 · دع إطار الوقائع ينقسم، وثبّت الختم

script.js · الأسطر 54–68في الشيفرة الكاملة
const boxes = [
  // keepTogether: false: cut between two blocks at the page foot; a line of white closes it.
  { id: 'facts', keepTogether: false, backgroundEnabled: false, marginBottom: pt(LEAD),
    stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('proof') },
    padding: { ...NONE, top: mm(2.6) }, titleStyle: { ...caps(8), color: col('proof') },
    body: { fontSize: pt(9), lineHeight: pt(LEAD), textAlign: 'left', firstLineIndent: pt(0) },
    lists: { bulletChar: '•', color: col('proof') } },
  // 'fixed': pinned to the page its fence falls on, out of the flow; 'auto': as wide as its title.
  { id: 'stamp', placement: 'fixed', width: 'auto', backgroundEnabled: false,
    title: t({ en: 'Proof · 2nd pass', es: 'Segundas pruebas' }),
    fixed: { anchor: { to: 'page', edge: 'top-right' }, offset: { x: mm(-OUTER), y: mm(8) } },
    border: { enabled: true, color: col('proof'), width: pt(1.2) }, borderRadius: mm(1),
    padding: { top: mm(1.4), right: mm(2.4), bottom: mm(1.2), left: mm(2.4) },
    titleStyle: { ...caps(9), color: col('proof'), gap: mm(0) } },
];

يسمح keepTogether: false لإطار الوقائع بأن يبدأ في أسفل الصفحة 1 ويستمر على ظهرها تحت خطه الأحمر، بلا عنوانه. وليس للإطار خلفية ولا خط في أسفله، ففي الصفحة 2 لا يفصل جدول المواعيد عن الخبر إلا بياض، وmarginBottom سطر كامل من تباعد الأسطر، 14 نقطة؛ ومع 4 نقاط كان الجدول سينتهي على بعد 1.5 مم فوق الفقرة التالية. والختم placement: 'fixed'، خارج التدفق ومثبّت على بعد 8 مم تحت الحافة العليا، ويقلّصه width: 'auto' إلى عرض عنوانه، 42 مم بدل عرض العمود الرئيسي البالغ 110 مم.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 055 · A galley proof with every fault marked in red ══════
// https://postext.dev/en/cookbook/proof-sheet-diagnostics
// Code: MIT · Text: original (CC BY 4.0) · Map: code (CC BY 4.0) · Photo: diffusion models
// Fonts: Charis SIL, Chivo, Fragment Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import { buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
  parseMarkdownWithIssues, KNOWN_DIRECTIVES, KNOWN_CONTAINERS, lineWordSpacing,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'proof-sheet-diagnostics';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// col() links a colour to its palette entry; the hex is the value the entry holds.
const palette = { // proof: the one accent and the marks; rule: the map's banks; muted: furniture
  ink: '#1d1d1b', proof: '#d7263d', paper: '#f6f3ea', rule: '#bdb8aa', muted: '#76726a' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [...Object.entries(palette), ['main-color', palette.proof]] // every default
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })); // on main-color: red
const [TEXT, DISPLAY, MONO] = ['Charis SIL', 'Chivo', 'Fragment Mono'];
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [190, 253, 22, 20, 17, 14]; // mm, mirrored
const MEASURE = TRIM_W - INNER - OUTER; // mm: 159, the text block the opener spans
const [LEAD, ART_H, DPI] = [14, 50, 150]; // pt: leading; mm: the photograph; page px/inch
const NONE = { top: mm(0), right: mm(0), bottom: mm(0), left: mm(0) };
const caps = (size) => ({ fontFamily: MONO, fontSize: pt(size), letterSpacing: pt(size * 0.12),
  textTransform: 'uppercase', fontWeight: 400 });

const below = (id, gap, width = MEASURE) => ({ anchor: { to: id, edge: id === 'container'
  ? 'top-left' : 'below' }, offset: { x: mm(0), y: mm(gap) }, size: { width: mm(width) } });
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'left',
  overflow: 'wrap', placement, ...extra });
const opener = { enabled: true, slot: { elements: [ // the drawing, then the words under it
  { kind: 'image', id: 'art', resourceId: 'crossing', placement: { ...below('container', 0),
    size: { width: mm(MEASURE), height: mm(ART_H) } } },
  // The words start 6 mm under the drawing, and the opener reserves down to the byline.
  text('kicker', '{attr.kicker}', MONO, 8, 'proof', below('container', ART_H + 6), caps(8)),
  text('title', '{titleText}', DISPLAY, 50, 'ink', below('#kicker', 1.4),
    { fontWeight: 900, lineHeight: 0.96 }), // a multiple of the size
  text('standfirst', '{attr.standfirst}', TEXT, 11.5, 'ink', below('#title', 4, 136),
    { italic: true, lineHeight: 1.3 }),
  text('byline', '{attr.byline}', MONO, 7.5, 'muted', below('#standfirst', 3), caps(7.5))] } };
const head = (id, content, parity, edge, x, y = 12) => text(id, content, MONO, 7.5, 'muted',
  { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } }, { ...caps(7.5), parity,
    pages: 'body', align: edge.split('-')[1] ?? 'center' }); // y: mm from the trim
const RUNNING = t({ en: ['The Tideline · issue 41', 'News · the night ferry'],
  es: ['La Marea · número 41', 'Noticias · la barcaza nocturna'] });
const header = { elements: [
  head('verso', `{pageNumber}   ${RUNNING[0]}`, 'even', 'top-left', OUTER),

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

تنويعات

#أبقِ إطار الوقائع كاملًا

مع القيمة الافتراضية لـkeepTogether ينتقل الإطار إلى الصفحة 2 قطعة واحدة؛ فتنتهي الصفحة 1 قبل نهايتها بـ33 مم ويمتد الخبر إلى صفحة ثالثة.

-  { id: 'facts', keepTogether: false, backgroundEnabled: false, marginBottom: pt(LEAD),
+  { id: 'facts', backgroundEnabled: false, marginBottom: pt(LEAD),

#أوقف بناءً ما زالت فيه أخطاء

في سكربت بناء أو اختبار، شغّل proof() على النص النهائي وارمِ خطأً إن وجد أي شيء.

 const doc = await build(markdown); // last: the corrected galley, the pages below
+if (proof(markdown, doc).length) throw new Error('The second pass still has faults.');

أخطاء شائعة

خطأ شائع

علامة $ المجرّدة تفتح الرياضيات: اكتب \$

علامة الدولار تفتح رياضيات داخل السطر، فسعرٌ مثل $40 يبدأ صيغة. اكتب \$40. الهروب والمحارف الحرفية →

خطأ شائع

'1998. ' أو '- ' في أول الفقرة يفتح قائمة

الفقرة التي تبدأ برقم ثم نقطة ثم مسافة، أو بواصلة ثم مسافة، تصير بندًا في قائمة. ضع رابط الكلمات (U+2060) قبل الرقم، واكتب الحوار بالشرطة الطويلة. الهروب والمحارف الحرفية →

تحذير Markdown · unclosedMath

محدِّد صيغة رياضية غير مغلق

السبب. علامة $ تفتح صيغة داخل السطر لا تُغلق أبدًا، وعادةً لأنها جزء من سعر.

الحل. اكتب \$ لعلامة دولار حرفية، أو أغلق الصيغة في السطر نفسه. التوثيق →

تحذير Markdown · unclosedContainer

حاوية غير مغلقة

السبب. سطر الفتح ::: لا يتبعه سطر إغلاق، فتمتد الحاوية إلى آخر المستند.

الحل. أضف سطرًا فيه ::: وحدها حيث تنتهي الحاوية. التوثيق →

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

إطار يتجاوز عموده

السبب. إطار لا يمكن لأي قطع أن يقسمه (فيه شكل أو جدول أو إطار متداخل أطول من العمود، أو قيمة splitMinLines مرتفعة جدًّا) وُضع متجاوزًا عموده؛ يسجّله المحرّك في doc.warnings ويعرضه Sandbox في قائمته. وكذلك يتجاوز عمودَه إطارُ span: 'side' الأطول من عمود جانبي فارغ.

الحل. قصّر الإطار، أو اسمح بتقسيمه بـkeepTogether: false، أو اخفض splitMinLines، أو اختر له امتدادًا آخر. التوثيق →

فحص Sandbox · unknownResourceId

مورد غير معروف

السبب. :ref أو ::resource يذكر معرّفًا لا يملكه أي مورد؛ فتطبع الإحالة "?" ولا يوضع شيء.

الحل. صحّح المعرّف (بعلامات اقتباس مزدوجة فقط) أو أضف المورد. التوثيق →

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

توجيه غير معروف

السبب. سطر :::name ليس من توجيهات Postext أو حاوياته، فيُطبع نصًّا.

الحل. طابق الإملاء مع الأسماء المدعومة (pagebreak، columnbreak، numbering، space، toc، callout، paragraphs، part، columns، paper). التوثيق →

فحص Sandbox · looseLine

سطر متخلخل

السبب. سطر مضبوط تتمدد مسافاته فوق الحد المسموح، وسبب ذلك عادةً كلمة طويلة أو عنوان URL أو سطر ضيق.

الحل. فعّل تقسيم الكلمات بالواصلة باللغة الصحيحة، أو وسّع عرض السطر، أو أعد صياغة الجملة، أو اجعل المقطع غير مضبوط. التوثيق →

  • اضبط طول النص بحيث يملأ إطار الوقائع الصفحة 1 حتى سطرها الأخير. فالإطار الذي تُختم به صفحة ينزل إلى أسفلها حين تُوازَن الأعمدة (headings.balancing.closingBox، وقيمته الافتراضية 'first'): احذف الجملة الأخيرة من الفقرة الأولى فيقع خط الإطار على بعد 6.4 مم تحت فقرة الأجور بدل 2.4 مم.

الحقوق

الوصفة
Ignacio Ferro
النص
نص أصلي, CC BY 4.0
الصور
  • The night crossing at the head of page 1 · Generated With Diffusion Models · أصلي
  • The route map, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
الخطوط
Charis SIL (SIL OFL 1.1) · Chivo (SIL OFL 1.1) · Fragment Mono (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox