باختصار
خبر من صحيفة أسبوعية محلية يُراجَع مرتين بحثًا عن الأخطاء. يبيّن كيف تعلّم كل خطأ بالأحمر على الصفحة وتربطه بسطر النص الذي سبّبه.
ما الذي ستنضده
يتصدّر العدد 41 من The Tideline، وهي صحيفة أسبوعية في مقاطعة، خبرُ عودة العبّارة الليلية عبر نهر Sawyer، ويراجع المثال بروفة الخبر مرتين. الجولة الأولى هي النص كما سُلِّم، أي الخبر المصحَّح وقد أُعيدت إليه سبع هفوات، منها ختم كُتب توجيهًا غير موجود وإطار وقائع لا يُغلق أبدًا. تترك هذه الهفوات السبع إحدى عشرة علامة. وكما في البطاقة، يوضع تحت كل خطأ خط أحمر على السطر الذي نُضّد فيه (أما السطر المتخلخل فيُظلَّل بدلًا من ذلك)، ويطابق رقمه في الهامش مدخله في القائمة بجوار الصفحات. والنقر على سطر أو مدخل يحدّد نص Markdown الخاص به. والصفحات أدناه هي الجولة الثانية. لا تجد الفحوص فيها شيئًا، وختم PROOF · 2ND PASS مثبّت في الزاوية العليا اليمنى.
تجيب هذه الوصفة عن
- كيف أعرف ما الخطأ في مستندي (تحذيرات، فيض، إخراج لا يستقر)؟
- كيف أربط نقرة على الصفحة المعروضة بموضعها في مصدر Markdown، لأبني محرّرًا؟
- لماذا يُنضَّد سطر واحد غير مضبوط أو متمددًا أكثر من اللازم (عناوين URL، كلمات مركّبة طويلة، كلمات طويلة في الخلايا)؟
الجواب المختصر
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);
}
المكونات
- الميزات
- التحذيرات والتشخيصالهروب والمحارف الحرفيةإطارات تنقسم أو تبقى كاملةالتقسيم الأمثل للأسطر (Knuth–Plass)إطارات وشارات مثبّتةاستشهادات تضع الأشكالعمود هامشي للعناصر العائمةملاحظات الهامشأعمدة داخل الإطار أو النصإطارات التنبيهصفحات افتتاح مصمَّمةشريط فصل بعرض الصفحةسمات العنوانالترويسات وأرقام الصفحاتالترويسات بحسب دور الصفحةصفحات على اللوحة (Canvas)الأشكال والجداول بوصفها مواردأنواع موارد مخصّصةلوحة ألوان دلاليةلون الورق
- تستخدم أيضًا
- عمود ونصف
- الخطوط
- 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 · أعِد الأخطاء إلى النص المصحَّح
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 · علّم كل خطأ حيث نُضّد
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 الذي وراء السطر
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 · دع إطار الوقائع ينقسم، وثبّت الختم
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 مم.
الوصفة كاملة
// ═══ 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),
<section id="proof">
<header>
<p id="slug" data-en="The Tideline 41 · news galley · proof desk" data-es="La Marea 41 · galerada · mesa de pruebas"></p>
<h2 id="verdict"></h2>
<p id="passes"></p>
</header>
<div class="desk">
<div id="galley"></div>
<ol id="report"></ol>
</div>
<div class="source">
<label for="source" data-en="The galley’s Markdown: click a line on a page to select it here" data-es="El Markdown de la galerada: pulsa una línea de una página para seleccionarla aquí"></label>
<textarea id="source" spellcheck="false"></textarea>
<p>
<button id="again" type="button" data-en="Proof again" data-es="Revisar de nuevo"></button>
<button id="fixed" type="button" data-en="Load the second pass" data-es="Cargar las segundas pruebas"></button>
</p>
</div>
<template id="words"><!-- the report's words, in the language of the sample -->
<i data-key="unclosedMath" data-en="Unclosed maths" data-es="Fórmula sin cerrar"></i>
<i data-key="unclosedMathBlock" data-en="Unclosed display maths" data-es="Fórmula en bloque sin cerrar"></i>
<i data-key="formula" data-en="Stray formula" data-es="Fórmula perdida"></i>
<i data-key="unclosedContainer" data-en="Unclosed fence" data-es="Valla sin cerrar"></i>
<i data-key="calloutOverflow" data-en="Box runs {} mm past its column" data-es="El recuadro desborda su columna en {} mm"></i>
<i data-key="unknownResourceId" data-en="Unknown id: prints “?”" data-es="Id desconocido: imprime «?»"></i>
<i data-key="unknownDirective" data-en="Unknown directive: prints as text" data-es="Directiva desconocida: sale como texto"></i>
<i data-key="yearList" data-en="A year opened a numbered list" data-es="Un año abrió una lista numerada"></i>
<i data-key="looseLine" data-en="Loose line, {}×" data-es="Línea floja, {}×"></i>
<i data-key="raggedLine" data-en="Line set ragged: its spaces would pass 3×" data-es="Línea en bandera: sus espacios pasarían de 3×"></i>
<i data-key="addressHyphen" data-en="Hyphen added inside an address" data-es="Guion añadido dentro de una dirección"></i>
<i data-key="unsettled" data-en="Layout did not settle in {} passes" data-es="La composición no se asentó en {} pasadas"></i>
<i data-key="faults" data-en="{} faults" data-es="{} fallos"></i>
<i data-key="fault" data-en="{} fault" data-es="{} fallo"></i>
<i data-key="clean" data-en="Nothing to mark" data-es="Nada que marcar"></i>
<i data-key="first" data-en="on the first pass" data-es="en las primeras pruebas"></i>
<i data-key="second" data-en="on the second pass" data-es="en las segundas pruebas"></i>
<i data-key="edited" data-en="in the edited copy" data-es="en la copia editada"></i>
<i data-key="page" data-en="Proof, page {}" data-es="Prueba, página {}"></i>
<i data-key="title" data-en="The Tideline · galley proof" data-es="La Marea · galerada"></i>
</template>
</section>
<main id="pages"></main>
/* The proof desk: the first pass marked in red beside its report, the Markdown under them.
Colours repeat the palette in script.js: newsprint, ink, the proofreader's red. */
#proof {
background: #e6e0d2; color: #1d1d1b; padding: 36px 32px 40px;
font: 15px/1.45 "Charis SIL", Georgia, serif;
}
#proof > * { max-width: 1216px; margin-inline: auto; }
#proof header { margin-bottom: 24px; }
#slug, #passes {
margin: 0; font: 12px/1.2 "Fragment Mono", monospace; letter-spacing: .14em;
text-transform: uppercase;
}
#slug { color: #b81d31; margin-bottom: 10px; }
#passes { color: #5f5b54; margin-top: 12px; text-transform: none; letter-spacing: .04em; }
#verdict { margin: 0; font: 900 clamp(38px, 6vw, 72px)/.95 Chivo, sans-serif; letter-spacing: -.01em; }
.desk { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 32px; align-items: start; }
#galley { display: flex; flex-wrap: wrap; gap: 14px; max-width: 854px; } /* two pages a row */
#galley canvas {
display: block; width: 420px; aspect-ratio: 190 / 253; cursor: text; /* DESK_W */
box-shadow: 0 1px 2px rgb(40 30 20 / .25), 0 18px 36px -18px rgb(40 30 20 / .55);
}
#report { list-style: none; margin: 0; padding: 0; border-top: 3px solid #d7263d; }
#report button {
all: unset; box-sizing: border-box; display: grid; grid-template-columns: 30px minmax(0, 1fr);
column-gap: 12px; width: 100%; padding: 9px 0 10px; border-bottom: 1px solid #bdb8aa; cursor: pointer;
}
#report button:hover span, #report button:focus-visible span { color: #b81d31; }
#report b {
grid-row: span 2; width: 26px; height: 26px; border-radius: 50%; background: #d7263d;
color: #f6f3ea; font: 13px/26px "Fragment Mono", monospace; text-align: center;
}
#report span { font: 400 16px/1.25 Chivo, sans-serif; }
#report code {
font: 12px/1.5 "Fragment Mono", monospace; color: #5f5b54;
overflow: hidden; white-space: nowrap; text-overflow: ellipsis;
}
.source { margin-top: 28px; }
.source label {
display: block; margin-bottom: 8px; font: 12px/1.3 "Fragment Mono", monospace; color: #5f5b54;
}
#source {
display: block; width: 100%; height: 280px; box-sizing: border-box; padding: 14px 16px;
font: 13px/1.6 "Fragment Mono", monospace; color: #1d1d1b; background: #f6f3ea;
border: 1px solid #bdb8aa; resize: vertical;
}
#source::selection { background: #d7263d; color: #f6f3ea; }
.source p { margin: 12px 0 0; display: flex; gap: 10px; flex-wrap: wrap; }
.source button {
يعمل ملف 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
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


