باختصار
وثيقة تشريعية قصيرة. تعرض الصياغة القديمة لقانون مع شطب الكلمات المحذوفة وتسطير الجديدة، ثم القسم كله بعد تعديله في إطار رمادي.
ما الذي ستنضده
وثيقة لجنة من النوع الذي يرافق مشروع قانون: خمس صفحات تبيّن ما فعله القسم 102 من قانون سوني بونو لتمديد مدة حق المؤلف لعام 1998 بالباب 17 من مدوَّنة قوانين الولايات المتحدة. فالقانون يقول فقط «احذف “fifty” وأدرج “70”»؛ أما هذه الوثيقة فتصفّ القانون كما كان، وتعلّم كل تغيير في موضعه، فتشطب المحذوف وتسطّر المضاف، تحت المفتاح الذي يطبعه محرّرو التشريعات الاتحادية وتشريعات الولايات فوق مثل هذه النصوص، ثم تعرض القسم 302 بعد تعديله في إطار ملوَّن، كل حرف بند عند حافته وأسطره معلّقة تحت النص. وتفعل الطبعة الإسبانية الشيء نفسه مع التعديلات الثلاثة للدستور الإسباني المنشورة في الجريدة الرسمية (BOE) في 1992 و2011 و2024.
تجيب هذه الوصفة عن
- كيف أعرض تعديلًا تكون فيه الكلمات المحذوفة مشطوبة والمضافة مسطَّرة؟
الجواب المختصر
// In the text, ~~fifty~~ strikes a deleted word and :underline[70] underlines the new one.
// Both lines are painted from the face's own metrics and take no room, so the struck and
// the inserted words justify and hyphenate like any others. The amended text then sits in
// a box whose paragraphs hang: '(a)', a tab, and every turnover line under the text.
const label = { fontFamily: SANS, fontSize: pt(7.5), fontWeight: 700, letterSpacing: pt(1.1),
textTransform: 'uppercase', color: col('accent') };
const clauses = { fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(13), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), textAlign: 'left', // a box's measure is short
hangingIndent: HANG, // every line but the first starts 7 mm in (postext ≥ 1.71)
tabStops: [{ position: HANG }] }; // and the tab after the marker takes the text there
const pad = (v, h) => ({ top: mm(v), right: mm(h), bottom: mm(v), left: mm(h) });
const calloutStyles = [
// The coding legend: a red rule down its side, the label face.
{ id: 'legend', backgroundEnabled: false,
stripe: { enabled: true, side: 'left', width: pt(2.5), color: col('accent') },
padding: pad(1.5, 3.5), body: { fontFamily: SANS, fontSize: pt(9), lineHeight: pt(12.5),
color: col('ink'), boldColor: col('accent'), firstLineIndent: pt(0), textAlign: 'left' } },
// The bill's own words: a red rule on top, clauses hung, no tint.
{ id: 'bill', backgroundEnabled: false,
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('accent') },
padding: pad(2.5, 0), body: clauses, keepTogether: false, // it may run on to the next page
// its title keeps its case: "(b)" stays "(b)"
titleStyle: { ...label, textTransform: 'none', letterSpacing: pt(0.2), fontSize: pt(8.5),
color: col('ink') } },
// The text as amended: a tint, the clauses hung the same way.
{ id: 'amended', background: col('tint'), padding: pad(3.5, 4.5), titleStyle: label,
body: clauses },
];
المكونات
- الميزات
- الشطبالتسطيرفقرات معلَّقة داخل إطارمواضع الجدولة ونقاط التوجيهإطارات التنبيهإطارات تنقسم أو تبقى كاملةلوحة ألوان دلاليةصفحات افتتاح مصمَّمةسمات العنوانالترويسات وأرقام الصفحاتالترويسات بحسب دور الصفحةهوامش متناظرةأنماط الفقراتالأسطر الأرامل والأسطر اليتيمة والكلمات المعزولةالتصدير إلى PDFالخطوط المضمَّنة في PDF
- الخطوط
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · علِّم التغيير حيث يقع
الشيفرة في الجواب المختصر أعلاه. والعلامات نفسها في Markdown: يشطب ~~fifty~~ :underline[70] الكلمة القديمة ويسطّر الجديدة (الشطب، التسطير). لا يأخذ أيّ من الخطين مكانًا، فيُضبط بند مشطوب من ستة أسطر ويُقسَّم كالنص المحيط به، وفي الصفحة 3 يُشطب البند الفرعي القديم 304(b) كله ويُسطَّر بديله في فقرة واحدة. ويُرسم كل خط من قياسات الشطب والتسطير في الخط الطباعي نفسه وبلون الكلمات، فتنال الحروف الكبيرة الصغيرة في عنوان البند خطًّا خاصًّا بها على ارتفاعها.
#2 · علِّق البنود داخل الإطار
يعلّق body.hangingIndent في نمط الإطار كل فقرات الإطار (التنسيق الطباعي داخل الإطار): يبدأ السطر الأول عند الحافة الداخلية، وتبدأ الأسطر التالية أبعد بـ 7 مم. ووقفة جدولة عند الـ 7 مم نفسها تنقل النص الذي يلي «(a)» أو «(c)» إلى تلك الحافة مهما كان عرض الحرف؛ لذا تكتب في Markdown (a):tab In General.—…. وتشترك بنود القانون والقسم المعدَّل في التنسيق ولا يختلفان إلا في الإطار: خط أحمر فوق القانون، ولون خلفية وراء النص النافذ. ويجوز أن ينقسم إطار القانون (keepTogether: false)، فتنتهي الصفحة 1 ببنديه الأولين.
#3 · شريط للافتتاح
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const BAND = 66; // mm from the trim top to the foot of the band
const opener = { enabled: true, minHeight: mm(BAND - 22 + 6), marginBottom: pt(0), slot: {
elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(BAND + 3) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, color: col('pale'),
placement: { ...at('container', 'top-left', 0, 6), size: { width: mm(112) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: SERIF, fontWeight: 700,
fontSize: pt(30), lineHeight: 1.05, color: col('paper'), align: 'left',
placement: { ...at('#kicker', 'below', 0, 3), size: { width: mm(112), height: 'auto' } } },
{ kind: 'text', id: 'dek', content: '{attr.dek}', fontFamily: SERIF, italic: true,
fontSize: pt(10.5), lineHeight: 1.3, color: col('pale'), align: 'left',
placement: { ...at('#title', 'below', 0, 3.5), size: { width: mm(104), height: 'auto' } } },
] } };
يمتد الشريط الكحلي حتى حافة القصّ من أعلى ومن الجانبين، ويأتي العنوان الفرعي والمقدمة من سمات في سطر العنوان (سمات العناوين). ويحدّد minHeight موضع بداية المفتاح، على بُعد مليمترات قليلة تحت الشريط.
#4 · ترويسات بحسب الزوجية
const head = (id, content, parity, edge, x, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'body', fontFamily: SANS, fontSize: pt(7.5),
fontWeight: 600, letterSpacing: pt(1.1), textTransform: 'uppercase', color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(13) } }, ...extra });
const folio = { fontWeight: 700, color: col('ink') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
head('recto-title', '{firstMark.h2}', 'odd', 'top-right', -(OUTER + 8)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'top', 0,
{ ...folio, pages: 'opener', placement: at('container', 'top', 0, 9) })] };
تحمل الصفحة الزوجية عنوان الوثيقة، وتحمل الفردية الجزء الذي تبدأ فيه، مأخوذًا من أول عنوان من المستوى الثاني في الصفحة. ويُبقي pages: 'body' الترويسات خارج صفحة الافتتاح، التي تحمل بدلًا منها رقم صفحة في أسفلها.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 182 · An amendment shown struck through and underlined ═════
// https://postext.dev/en/cookbook/amendment-redline
// Code: MIT · Text: Pub. L. 105-298 and 17 U.S.C. (US Gov., PD); Constitución Española (BOE)
// Fonts: Source Serif 4, Source Sans 3 (SIL OFL 1.1) · Needs postext ≥ 1.73.0
// A comparative print: the law as it stood, each deletion ~~struck through~~ and each
// insertion :underline[underlined], then the amended text in a box whose clauses hang.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'amendment-redline';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a government-print navy, one red for rules and labels
const palette = {
ink: '#1b1d22', // text: a cool near-black
band: '#1f2b47', // the opener's band: navy
accent: '#a1321f', // labels, stripes, the legend's rule
tint: '#eef0f4', // the box of the amended text
rule: '#c7ccd6', // hairlines
muted: '#5d6370', // running heads, notes, colophon
paper: '#ffffff',
pale: '#c9d2e6', // the kicker and the standfirst on the band
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const SERIF = 'Source Serif 4', SANS = 'Source Sans 3';
const TRIM = [152, 229], INNER = 20, OUTER = 17; // mm: a 6 × 9 in committee print
const LEAD = 14; // pt: the body leading
const HANG = mm(7); // how far the clauses of a box hang: the width of "(a)" and a space
// #region answer: the marks live in the Markdown; the boxes hang their clauses
// In the text, ~~fifty~~ strikes a deleted word and :underline[70] underlines the new one.
// Both lines are painted from the face's own metrics and take no room, so the struck and
// the inserted words justify and hyphenate like any others. The amended text then sits in
// a box whose paragraphs hang: '(a)', a tab, and every turnover line under the text.
const label = { fontFamily: SANS, fontSize: pt(7.5), fontWeight: 700, letterSpacing: pt(1.1),
textTransform: 'uppercase', color: col('accent') };
const clauses = { fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(13), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), textAlign: 'left', // a box's measure is short
hangingIndent: HANG, // every line but the first starts 7 mm in (postext ≥ 1.71)
tabStops: [{ position: HANG }] }; // and the tab after the marker takes the text there
const pad = (v, h) => ({ top: mm(v), right: mm(h), bottom: mm(v), left: mm(h) });
const calloutStyles = [
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#اكتب المضاف بالصيغة ++text++
عند تفعيل plusUnderline يسطّر ++70++ كما يسطّر :underline[70]، وهي الصيغة التي يستعملها Pandoc وmarkdown-it للنص المُدرَج.
textAlign: 'justify', firstLineIndent: mm(4.5), indentAfterHeading: false,
+ plusUnderline: true, // ++text++ underlines; C++ in the text is then written C\+\+#أبقِ بنود القانون معًا
من دون keepTogether: false ينتقل الإطار كاملًا إلى الصفحة 2، وتنتهي الصفحة 1 بالسطر الذي يقدّمه.
- padding: pad(2.5, 0), body: clauses, keepTogether: false, // it may run on to the next page
+ padding: pad(2.5, 0), body: clauses,أخطاء شائعة
- الفقرة التي تبدأ برقم ونقطة (
2. Solamente…) تُقرأ بندًا في قائمة، والشرطة المائلة العكسية قبل النقطة تُطبع كما هي. لذلك تضع الطبعة الإسبانية في النص الجاري رابط كلمات (U+2060) بين الرقم والنقطة، وتكتب في الإطار علامة الجدولة بعد النقطة مباشرة،1.:tab، ولا تطابقها أي علامة قائمة. - اللون وحده لا يصمد أمام النسخ الضوئي، وكثيرًا ما تتداول هذه الوثائق نسخًا مصوَّرة؛ أما الشطب والتسطير فيُقرآن بالأبيض والأسود، ولهذا اختارهما المحرّرون.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- Section 102 of the Sonny Bono Copyright Term Extension Act (Pub. L. 105-298, 112 Stat. 2827, 1998) and sections 302–304 of title 17, United States Code, as in force in 1997 · United States Congress · ملك عام
- Articles 13.2, 49 and 135 of the Spanish Constitution in their 1978 wording and the reforms of 1992, 2011 and 2024 (official texts, not subject to copyright under art. 13 LPI) · Cortes Generales, Boletín Oficial del Estado · ملك عام
- The editor’s notes, the coding legends and the colophons · Ignacio Ferro · CC BY 4.0
- الخطوط
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


