باختصار
عرض أسعار من صفحتين صادر عن ورشة نوافذ ألمانية. يبيّن كيف تضع العنوان وسائر أجزاء الرسالة التجارية حيث تضعها المواصفة الألمانية، لتناسب ظرفًا بنافذة.
ما الذي ستنضده
Fensterwerkstatt Tessin ورشة متخيَّلة في برلين ترمّم النوافذ المزدوجة، وهي ترسل عرض أسعار إلى الشركة التي تدير مبنى سكنيًا. يقع العرض في ورقتين A4 بالألمانية، مخرجتين وفق النموذج B من DIN 5008. يعبر أعلى الصفحة شريط بلون أزرق برلين عليه شعار الورشة واسمها. وتحته يقع كل جزء حيث تضعه المواصفة: سطر المرسل والعنوان داخل الحقل 85 × 45 مم الذي يظهر من نافذة ظرف DL، وكتلة المعلومات على بعد 125 مم من الحافة اليسرى، والموضوع بالخط العريض بعد سطرين فارغين تحت الحقل، وعلامات الطي والثقب عند 105 و148.5 و210 مم. تجري بيانات الشركة في ثلاثة أعمدة أسفل الورقتين. وتكرر الورقة الثانية المرجع بجانب «Seite 2 von 2» وتنتهي بتوقيع مرسوم بالشيفرة.
تجيب هذه الوصفة عن
- كيف أثبّت شارة أو ملصقًا في موضع ثابت من الصفحة؟
- كيف أضيف علامة مائية أو لونًا خفيفًا للخلفية أو صورة زخرفية في كل صفحة؟
- كيف أخفي الترويسات في صفحات الافتتاح والصفحات الفارغة، أو ألوّن صفحة زوجية فارغة بلون الجزء؟
- كيف أنضد نصًّا تصديريًّا أو إهداءً أو توقيعًا أو اقتباسًا بارزًا بعلامة اقتباس كبيرة؟
الجواب المختصر
const at = (x, y, size) => ({ anchor: { to: 'page', edge: 'top-left' }, // mm from the corner
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const ZONE = DIN.field.y + DIN.notes; // 62.7 mm: where the six address lines start
const SUBJECT = DIN.field.y + DIN.field.h + 2 * LEAD * PT; // two blank lines under the field
const firstPage = () => ({ enabled: true, slot: { elements: [ // in paint order
...letterhead(), // band, logo and name, and the corners of the window
text('from', FROM, FACE.from, at(DIN.left, ZONE - 3.6)), // the return line, underlined
rule('from-rule', 'muted', { anchor: { to: '#from', edge: 'below' }, offset: { y: mm(0.6) },
size: { width: mm(WINDOW) } }),
// One attribute holds the whole address: each '\n' in it starts a new line.
text('to', '{attr.to}', FACE.address, at(DIN.left, ZONE, { width: mm(WINDOW) })),
...infoBlock(), // labels, and values from {attr.*}
text('subject', '{titleText}', FACE.subject, at(DIN.left, SUBJECT, { width: mm(TEXT) })),
] } });
// The H1 reserves the sheet down to its lowest element (gotcha: opener-reserves-anchored).
// fontFamily: the design paints the H1, but the build measures it (default: Open Sans).
const headings = () => ({ fontFamily: 'Familjen Grotesk', levels: [{ level: 1,
breakBefore: { enabled: true, parity: 'any' }, // a letter starts on the next sheet
marginBottom: pt(2 * LEAD), // two blank lines between the subject and the salutation
advancedDesign: firstPage() }] });
المكونات
- الميزات
- تثبيت عناصر التصميمصفحات افتتاح مصمَّمةسمات العنوانالنصوص والخطوط والمربعات في تصاميم الصفحةالصور في تصاميم الصفحةشريط فصل بعرض الصفحةالترويسات بحسب دور الصفحةالترويسات وأرقام الصفحاتأشكال في هذا الموضع بالضبطالأشكال والجداول بوصفها مواردأنواع موارد مخصّصةأنماط الفقراتتقسيم الكلمات ولغة المستندمقاس القطعلوحة ألوان دلاليةالتصدير إلى PDFالخطوط المضمَّنة في PDFصفحات على اللوحة (Canvas)
- الخطوط
- Nunito Sans, Familjen Grotesk, Reddit Mono (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · ثبّت الصفحة الأولى على الورقة بالمليمتر
const at = (x, y, size) => ({ anchor: { to: 'page', edge: 'top-left' }, // mm from the corner
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const ZONE = DIN.field.y + DIN.notes; // 62.7 mm: where the six address lines start
const SUBJECT = DIN.field.y + DIN.field.h + 2 * LEAD * PT; // two blank lines under the field
const firstPage = () => ({ enabled: true, slot: { elements: [ // in paint order
...letterhead(), // band, logo and name, and the corners of the window
text('from', FROM, FACE.from, at(DIN.left, ZONE - 3.6)), // the return line, underlined
rule('from-rule', 'muted', { anchor: { to: '#from', edge: 'below' }, offset: { y: mm(0.6) },
size: { width: mm(WINDOW) } }),
// One attribute holds the whole address: each '\n' in it starts a new line.
text('to', '{attr.to}', FACE.address, at(DIN.left, ZONE, { width: mm(WINDOW) })),
...infoBlock(), // labels, and values from {attr.*}
text('subject', '{titleText}', FACE.subject, at(DIN.left, SUBJECT, { width: mm(TEXT) })),
] } });
// The H1 reserves the sheet down to its lowest element (gotcha: opener-reserves-anchored).
// fontFamily: the design paints the H1, but the build measures it (default: Open Sans).
const headings = () => ({ fontFamily: 'Familjen Grotesk', levels: [{ level: 1,
breakBefore: { enabled: true, parity: 'any' }, // a letter starts on the next sheet
marginBottom: pt(2 * LEAD), // two blank lines between the subject and the salutation
advancedDesign: firstPage() }] });
يربط at() العنصر من زاويته العليا اليسرى بـ'page'، أي مستطيل القصّ (موضع العناصر)، فكل x وy مسافة من زاوية الورقة، وتدخل أرقام المواصفة كما هي: العنوان على بعد 25 مم أفقيًا و62.7 مم عموديًا، وأول تسمية في كتلة المعلومات عند 125 و50. هذه العناصر تكوّن تصميم H1. نص العنوان هو الموضوع ({titleText}) وفي سماته العنوان البريدي والمراجع، ففي الإعدادات أدوات المراسلة وفي Markdown الرسالة. الموضوع، عند 100.6 مم، هو أدنى العناصر، فيحجز العنوان الورقة حتى أسفل الموضوع. يضيف marginBottom السطرين الفارغين، وتبدأ التحية على سطر الشبكة التالي، عند 117 مم.
العنوان البريدي خاصية واحدة بين أسطرها \n، وكل \n يبدأ سطرًا جديدًا في نص التصميم. العنوان الرئيسي يبقى في عمود النص، ومع ذلك يرسم تصميمه الشريط والشعار والاسم فوق الهامش العلوي البالغ 27 مم، لأن كل عنصر مثبّت على الصفحة.
#2 · اربط كتلة المعلومات بتسمية واحدة مثبَّتة
const INFO = [['Ihr Zeichen', 'ihr-zeichen'], ['Ihre Nachricht vom', 'ihre-nachricht'],
['Unser Zeichen', 'unser-zeichen'], ['Name', 'name'], ['Telefon', 'telefon'],
['E-Mail', 'email'], ['Datum', 'datum']]; // [label, heading attribute]
const VALUE = 29; // mm from the labels to the values
const infoBlock = () => INFO.flatMap(([label, key], i) => [
text(`label-${i}`, label, FACE.label, i === 0 ? at(DIN.info.x, DIN.info.y) : {
anchor: { to: `#label-${i - 1}`, edge: 'below' }, // each label under the last
offset: { y: mm(key === 'datum' ? ROW * PT : 0) } }), // a blank row before the date
text(`value-${i}`, `{attr.${key}}`, FACE.value, { // a 12 pt row as well, on the label's baseline
anchor: { to: `#label-${i}`, edge: 'align-top' }, offset: { x: mm(VALUE) },
size: { width: mm(DIN.info.w - VALUE) } }),
]);
لا تُربط بالورقة إلا التسمية الأولى. كل تسمية أخرى مرتبطة بموضع 'below' تحت سابقتها، وكل قيمة بتسميتها بـ'align-top' وإزاحة 29 مم، فلا يحتاج صف يُضاف إلى INFO إلى إحداثيات. يضع نص التصميم خط الأساس عند 80% من مستطيل السطر. التسمية بحجم 7 pt والقيمة بحجم 9 pt تضبطان كلتاهما lineHeight: pt(ROW)، أي سطرًا ارتفاعه 12 pt، فتشتركان في خط أساس واحد على كل صف ارتفاعه 4.23 مم.
#3 · ارسم ترويسة الشركة في التصميم نفسه
const [BAND, TICK] = [32, 3]; // mm: the band's depth, each arm of the window's corner angles
const LOGO = { y: 7, h: 18 }; // mm: the mark, centred in the band
const CRAFTS = 3 * 7.5 * 1.45 * PT; // mm: three 7.5 pt lines at 1.45
const letterhead = () => [
{ kind: 'box', id: 'band', style: { backgroundColor: col('brand') },
placement: at(0, 0, { width: 'fill', height: mm(BAND) }) },
{ kind: 'image', id: 'logo', resourceId: 'logo',
placement: at(DIN.left, LOGO.y, { height: mm(LOGO.h) }) },
text('name', 'Tessin', face('Familjen Grotesk', 30, 700, 'paper', { lineHeight: 1 }),
{ anchor: { to: '#logo', edge: 'right-of' }, offset: { x: mm(5), y: mm(1.2) } }),
text('trade', 'FENSTERWERKSTATT · BERLIN', face('Reddit Mono', 7.5, 500, 'sky',
{ letterSpacing: pt(1.2) }), { anchor: { to: '#name', edge: 'below' },
offset: { x: mm(0.4), y: mm(1.5) } }),
text('crafts', 'Kastenfenster\nHolzfenster\nDenkmalpflege', face('Reddit Mono', 7.5,
400, 'sky', { lineHeight: 1.45, align: 'right' }),
at(210 - DIN.right - 45, LOGO.y + (LOGO.h - CRAFTS) / 2, { width: mm(45) })),
...[[0, 0], [1, 0], [0, 1], [1, 1]].flatMap(([right, low], i) => { // turned inwards
const [x, y] = [DIN.field.x + right * DIN.field.w, DIN.field.y + low * DIN.field.h];
return [rule(`across-${i}`, 'marks', at(x - right * TICK, y, { width: mm(TICK) })),
rule(`down-${i}`, 'marks', at(x, y - low * TICK, { height: mm(TICK) }), 'vertical')];
}),
];
الشريط صندوق مربوط بزاوية الورقة. يمدّه width: 'fill' من حافة إلى حافة، ويتجاوز عمقه البالغ 32 مم الهامش العلوي (27 مم) بـ5 مم. الشعار عنصر صورة يرسم موردًا بارتفاع 18 مم ويأخذ عرضه من الرسم (عناصر الصور). يتدلّى الاسم 'right-of' الشعار، وسطر الحرفة 'below' الاسم. ثمانية خطوط طول كل منها 3 مم ترسم زاوية عند كل ركن من حقل العنوان 85 × 45 مم، وهو الجزء من الورقة الذي تُظهره نافذة الظرف.
#4 · ضع ما تشترك فيه الأوراق في الترويسة والتذييل
const header = { elements: [
// In the H1's design they would stretch its reserve (gotcha: opener-reserves-anchored).
...[[DIN.folds[0], 5], [DIN.punch, 8], [DIN.folds[1], 5]].map(([y, length], i) =>
rule(`mark-${i}`, 'marks', at(0, y, { width: mm(length) }))), // fold, punch, fold
// Page 1 opens with the H1, which makes it an 'opener'; later sheets are 'body' pages.
{ kind: 'box', id: 'strip', pages: 'body', style: { backgroundColor: col('brand') },
placement: at(0, 0, { width: 'fill', height: mm(4) }) },
text('ref', 'Fensterwerkstatt Tessin · Unser Zeichen {attr.unser-zeichen} · {attr.datum}',
FACE.small, at(DIN.left, 13.2), { pages: 'body' }),
text('page', 'Seite {pageNumber} von {totalPages}', FACE.small,
at(210 - DIN.right - 40, 13.2, { width: mm(40) }), { pages: 'body', align: 'right' }),
] };
const FOOT = 297 - DIN.bottom + 5; // mm: the hairline over the company data
const COMPANY = [ // three columns, 57 mm apart, inside the bottom margin
'Fensterwerkstatt Tessin GmbH\nRennbahnstraße 48\n13086 Berlin\nTelefon 030 23125-400',
'Geschäftsführer Martin Tessin\nAmtsgericht Charlottenburg\nHRB 000000 B\nUSt-IdNr. DE000000000',
'Musterbank Berlin\nIBAN DE00 0000 0000 0000 0000 00\nBIC MUSTDEBBXXX',
];
const footer = { elements: [
rule('foot-rule', 'rule', at(DIN.left, FOOT, { width: mm(TEXT) })),
...COMPANY.map((lines, i) => text(`company-${i}`, lines, FACE.small,
at(DIN.left + 57 * i, FOOT + 2.5, { width: mm(52) }))),
] };
العنصر من تصميم H1 المربوط تحت الموضوع يزيد الارتفاع الذي يحجزه العنوان. فلو كانت علامة الطي عند 210 مم في التصميم لنزلت التحية إلى 222.8 مم ولامتدت الرسالة إلى ثلاث صفحات. أما خانة الترويسة فتُرسم في كل صفحة ولا تحجز مساحة، لذا توضع فيها العلامات الثلاث (الترويسات والتذييلات). تبدأ الصفحة 1 بـH1، فهي صفحة 'opener'، ولذا يقصر pages: 'body' الشريط الأزرق وسطر المرجع وSeite {pageNumber} von {totalPages} على الأوراق التالية. يقرأ سطر المرجع سمات H1 عبر {attr.unser-zeichen} و{attr.datum}.
#5 · ضع التوقيع في مجرى النص
const resourceTypes = [{ id: 'drawing', name: 'Zeichnung', shortLabel: 'Zeichnung',
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }];
const drawing = (id, width, height, altText, placement) => ({ id, typeId: 'drawing',
kind: 'svg', svg: { fileId: `${id}.svg`, width, height }, altText, placement,
createdAt: 0, updatedAt: 0 });
const resources = [ // an image element draws the logo; nothing cites it
drawing('logo', 200, 280, 'Zeichen der Fensterwerkstatt Tessin, ein Kastenfenster'),
drawing('signature', 760, 328, 'Unterschrift von Martin Tessin',
{ position: 'here', width: 0.297 }), // 49 × 21.1 mm: under 4 lines, no grid gap below
];
يضع ::resource{id="signature"} الرسم تحت «Mit freundlichen Grüßen»، ويجعله width: 0.297 بعرض 49 مم وعمق 21.1 مم، أي أقل بقليل من أربعة أسطر ارتفاع كل منها 15 pt. النص الذي يلي موردًا في المجرى يعود إلى شبكة المتن. عند 0.25 كان عمق الرسم 17.8 مم، وأبعدت مسافة 3.4 مم التي أضافتها الشبكة تحته الاسمَ عن التوقيع. نوع المورد له captionPrefix فارغة، ولا يضع Postext تعليقًا حين تكون البادئة والتعليق فارغين معًا، فلا تظهر تحت التوقيع تسمية ولا رقم (أنواع الموارد). الشعار مورد من النوع نفسه، لا يرسمه إلا عنصر الصورة. لا يذكره أي :ref ولا ::resource، فلا يدخل المجرى أبدًا.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 058 · Business letter to DIN 5008 ═════════════════════
// https://postext.dev/en/cookbook/din-business-letter
// Code: MIT · Text: original, in German (CC BY 4.0) · Logo, signature: drawn in code (CC BY 4.0)
// Fonts: Nunito Sans, Familjen Grotesk, Reddit Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A German quotation on A4 whose H1 design pins the letterhead and the address to DIN 5008.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} 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 = 'din-business-letter';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#1f2429', brand: '#1b4a73', // text, a blue-grey near-black; Berlin blue, for the band
sky: '#b4cbe0', paper: '#ffffff', // the trade and the crafts on the band; the logo and name
muted: '#5b6670', pen: '#26408f', // labels, return line, company data; the signature's ink
marks: '#98a3ad', rule: '#c9d1d8', // fold marks, window corners; the hairline in the footer
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// main-color is the engine's default accent: the dashes of the list take it.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.brand })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// DIN 5008, form B: every position in mm from the sheet's top-left corner.
const DIN = {
left: 25, right: 20, top: 27, bottom: 30, // the margins of the text
field: { x: 20, y: 45, w: 85, h: 45 }, // the address field, behind the envelope window
notes: 17.7, // the field's top zone, for the return line; the address zone takes the rest
info: { x: 125, y: 50, w: 75 }, // the information block
folds: [105, 210], punch: 148.5, // fold marks for a DL envelope, and the punch mark
};
const TEXT = 210 - DIN.left - DIN.right; // 165 mm of text width
const WINDOW = DIN.field.w - 2 * (DIN.left - DIN.field.x); // 75 mm: text inset 5 mm each side
const PT = 25.4 / 72; // mm per point
const [LEAD, ROW] = [15, 12]; // pt: the body's leading, a row of the information block
// Design text is centred by default, and a header or footer line ends in '…': left, wrapped.
const text = (id, content, face, placement, more) => ({ kind: 'text', id, content,
align: 'left', overflow: 'wrap', ...face, placement, ...more }); // more: pages, align
const rule = (id, colour, placement, direction = 'horizontal') => ({ kind: 'rule', id,
direction, thickness: pt(0.5), color: col(colour), placement });
const face = (fontFamily, size, fontWeight, colour, more) => ({ fontFamily, fontSize: pt(size),
fontWeight, color: col(colour), ...more });
const FACE = { // lineHeight: a dimension is the line's depth, a number multiplies the size
label: face('Reddit Mono', 7, 400, 'muted', { lineHeight: pt(ROW) }),
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
أخطاء شائعة
خطأ شائع
تحجز الافتتاحية ارتفاعًا يصل إلى أدنى عناصرها المثبّتة على الصفحة
تحجز الافتتاحية ذات التصميم المتقدّم ارتفاع أدنى عناصرها، وتُحتسب كذلك العناصر المثبّتة على الصفحة أو على النزف تحت العنوان، فالزخرفة في أسفل الصفحة تدفع النص إلى الصفحة التالية. أعطِ مثل هذا العنصر reserve: false (منذ postext 1.5): يُرسَم حيث ثُبّت ولا يحجز شيئًا. أما العناصر التي تتبع الشريط نفسه (المثبّتة على أسفله، أو التي ارتفاعها 'fill') فلا تحدّد ارتفاعه أبدًا. صفحات افتتاح مصمَّمة →
خطأ شائع
عناصر الترويسة والتذييل تُرسَم فوق النص
تُرسَم عناصر الترويسة والتذييل فوق الصفحة، ولا تُفسح منطقة النص لها مكانًا. أبقِها داخل الهوامش، فالهوامش هي التي تحجز مساحتها. الترويسات وأرقام الصفحات →
- يعدّ
{totalPages}صفحات المستند كله، فلو كانت رسالتان في ملف Markdown واحد لقرأت الورقة الثانية من الرسالة الأولى «Seite 2 von 4». ابنِ كل رسالة وحدها.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- نص أصلي, CC BY 4.0
- الخطوط
- Nunito Sans (SIL OFL 1.1) · Familjen Grotesk (SIL OFL 1.1) · Reddit Mono (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


