باختصار
رواية قصيرة كاملة بالكتالونية، منضّدة كتابًا صغيرًا بغلاف ورقي. تُقسم الكلمات في آخر السطر كما تطلب أدلة الأسلوب الكتالونية، ومنها حرفا اللام المزدوجان بينهما نقطة.
ما الذي ستنضده
رواية El transplantat لنارسيس أوليه (Narcís Oller) كاملة، بنص Obres completes (برشلونة، 1928)، في كتاب جيب بقياس 12 × 18.5 سم من 32 صفحة. قبل الفصول الأربعة تأتي صفحة نصف العنوان، وصورة واجهة للخبّاز عند فرنه، وصفحة عنوان بخط Cormorant Garamond المائل الأحمر، وملاحظة عن الطبعة. ينفتح كل فصل تحت نقش بعمق اثني عشر سطرًا، ورقمه الروماني بالأحمر. النص، بخط Gentium Book Plus بحجم 9.85 pt، ينكسر عند المقاطع الكتالونية كما يطلب Institut d’Estudis Catalans: حرفان على الأقل في كل جانب، ولا تقسيم بين حرفي علّة متتاليين في مقطعين منفصلين، ولا تقسيم بعد الفاصلة العليا مباشرة، وtitil·laven تنكسر titil- | laven، فتأخذ الواصلة مكان النقطة الوسطى. والحوار مضبوط بالشرطات الطويلة، والاقتباسات بين «cometes baixes».
تجيب هذه الوصفة عن
- كيف أحصل على ضبط أسطر وتقسيم كلمات جيدين لنص إسباني أو فرنسي أو ألماني؟
- كيف أعطي كل فصل صورته أو لونه أو شكل افتتاحه الخاص؟
- كيف أنضد رسومًا غير مرقّمة: زخارف، وحليات، وشعارات؟
- كيف أكتب شرطات الحوار، والسنوات في بداية الفقرة، والأسعار، والرموز الحرفية من دون أن يسيء Markdown قراءتها؟
الجواب المختصر
const LOCALE = 'ca'; // the exact bundled code: 'ca-ES' resolves to it too (postext ≥ 1.14)
const bodyText = { // config().bodyText
fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
firstLineIndent: mm(4.5), indentAfterHeading: false,
// The defaults justify, hyphenate in config().locale and break by Knuth–Plass. With 'ca'
// the dictionary follows the IEC: two letters on each side (ter-ra, cai-xa), no split in
// a hiatus (cièn-cia) or after an apostrophe (s’ha-via), l·l broken with the hyphen for the
// dot. From 1.30 the face is asked for its Catalan forms too: this one has a single dot.
// compounds: false divides arrossegar-se only at its own hyphen (Llibre d’estil, VI 2.5).
hyphenation: { compounds: false },
// Spaces from 0.7× to 1.6×, then up to 10‰ of tracking; a last line under 22 characters is
// a runt. A line that must keep d’inaugurar-se whole still opens to 1.94× on page 7.
maxWordSpacing: 1.6, minWordSpacing: 0.7, maxJustifyTracking: 10, runtMinCharacters: 22,
hyphenateAcrossColumns: false, // no page ends on a divided word
};
المكونات
- الميزات
- تقسيم الكلمات ولغة المستندالتقسيم الأمثل للأسطر (Knuth–Plass)الأغلفة وصفحات العنوان وبيانات النشرصفحات افتتاح مصمَّمةالصور في تصاميم الصفحةأنماط العناوينسمات العنوانالنصوص والخطوط والمربعات في تصاميم الصفحةفصول تبدأ في صفحة فرديةالترويسات وأرقام الصفحاتالترويسات بحسب دور الصفحةهوامش متناظرةلون الورقأنماط الفقراتأنواع موارد مخصّصةالأسطر الأرامل والأسطر اليتيمة والكلمات المعزولةالبيانات الوصفية للمستندلوحة ألوان دلاليةالتصدير إلى PDFالخطوط المضمَّنة في PDF
- تستخدم أيضًا
- الأشكال والجداول بوصفها مواردترويسات لكل قسم
- الخطوط
- Gentium Book Plus, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- الأصول
cap1-1200.jpgcap2-1200.jpgcap3-1200.jpgcap4-1200.jpgfrontis-1000.jpg- Engraving, frontispiece: the baker at his oven's door (Generated With Diffusion Models, أصلي)
- Engraving, chapter I: the night train into Barcelona (Generated With Diffusion Models, أصلي)
- Engraving, chapter II: the village street in autumn (Generated With Diffusion Models, أصلي)
- Engraving, chapter III: the Rambla at dawn (Generated With Diffusion Models, أصلي)
- Engraving, chapter IV: the old man by the railway (Generated With Diffusion Models, أصلي)
طريقة التحضير
#1 · الكتالونية برمزها
الشيفرة في الجواب المختصر أعلاه. يختار locale: 'ca' أنماط التقسيم الكتالونية، ومنذ postext 1.14 تتبع Llibre d’estil الصادر عن IEC (اللغات المدعومة). الأنماط هي التي يستعملها TeX، مع حرفين على الأقل في كل جانب من موضع الكسر بدل الثلاثة التي تأتي مع حزمة npm، فيمكن أن تنكسر ter-ra وcai-xa وplu-ja. حرفا العلّة المتتاليان في مقطعين منفصلين يبقيان معًا (cièn-cia، ca-mions)، لكن i الواقعة بين حرفي علّة تفتح مقطعها (fe-ia). وتنكسر ela geminada بين حرفي l: ينتهي السطر بـ titil- ويبدأ التالي بـ laven، بلا نقطة وسطى في أي من الجانبين، ويقيس Knuth–Plass السطر دون النقطة.

يُبقي compounds: false الفعل وضميره كاملين إلا عند واصلتهما الخاصة (arrossegar- | se)، وهو ما يفضّله IEC (تقسيم الكلمات بالواصلة). وثمنه سطر واحد متخلخل: في الصفحة 7 يفتح السطر الذي يسبق d’inaugurar-se مسافاته إلى 1.88×، حتى مع maxJustifyTracking: 10 الذي يأخذ الفائض في الأسطر الأخرى.
#2 · صفحة جيب من أسطر كاملة
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LINE),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};
الهامش السفلي يُحسب من قياس القص والهامش العلوي وLINES، فتتسع كتلة النص لـ 29 سطرًا ارتفاع كل منها 14 pt، وكل صفحة ممتلئة تنتهي على خط الأساس نفسه. عرض السطر 89 مم يتسع لنحو 63 حرفًا من Gentium Book Plus. ويُبقي mirror: true الهامش البالغ 16 مم عند الكعب في صفحتي كل زوج متقابل (الهوامش المتناظرة).
#3 · صفحة افتتاح واحدة لأربعة فصول
// # II {style="capitol" art="cap2"}: the art attribute names the picture's resource.
const PICTURE = { width: MEASURE, height: 12 * LINE }; // 89 × 59.3 mm: twelve lines, 3:2
const chapter = { id: 'capitol',
breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
marginBottom: pt(0), // the opener's own height already ends on a line
advancedDesign: { enabled: true, minHeight: pt(16 * LEAD), slot: { elements: [
{ kind: 'image', id: 'art', resourceId: '{attr.art}',
placement: at('container', 'top', 0, 0,
{ width: mm(PICTURE.width), height: mm(PICTURE.height) }) },
// The numeral and its rule hang from the container's top, a fixed drop under the picture.
text('numeral', '{titleText}', DISPLAY, 21, at('container', 'top', 0, PICTURE.height + 4),
{ fontWeight: 600, color: col('vermell'), lineHeight: 1 }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
placement: { ...at('container', 'top', 0, PICTURE.height + 13), size: { width: mm(8) } } },
] } },
};
يرسم resourceId: '{attr.art}' الصورة التي يحدّدها العنوان، فيفتح # II {style="capitol" art="cap2"} الفصل II تحت نقشه الخاص بالنمط نفسه الذي للفصول الأخرى (سمات العناوين). يحجز minHeight ستة عشر سطرًا: اثنا عشر للصورة وأربعة للرقم وخطّه، فيبدأ النص على السطر السابع عشر من الصفحة، وهو نفسه في كل فصل.
#4 · أربع صفحات قبل الفصل I
const front = (id, elements, { minHeight, ...extra } = {}) => ({ id,
breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(0),
header: { elements: [] }, footer: { elements: [] }, ...extra,
advancedDesign: { enabled: true, ...(minHeight && { minHeight }), slot: { elements } } });
const FRONTIS = { width: MEASURE, height: MEASURE * 1.5 }; // mm: the engraving is 2:3
const headingStyles = [
front('avantportada', [text('title', '{titleText}', DISPLAY, 19,
at('container', 'top', 0, 9 * LINE), { italic: true, fontWeight: 500, lineHeight: 1 })]),
front('frontis', [
{ kind: 'image', id: 'art', resourceId: '{attr.art}',
placement: at('container', 'top', 0, 0,
{ width: mm(FRONTIS.width), height: mm(FRONTIS.height) }) },
text('legend', '{titleText}', LABEL, 8.5, at('container', 'top', 0, FRONTIS.height + 5),
{ ...caps(8.5, 1.4, 'muted') }),
]),
front('portada', [
text('author', '{author}', LABEL, 10, at('container', 'top', 0, 5 * LINE),
caps(10, 2.2, 'ink')),
text('title', '{titleText}', DISPLAY, 34, at('container', 'top', 0, 8 * LINE),
{ italic: true, fontWeight: 500, color: col('vermell'), lineHeight: 1 }),
text('subtitle', '{subtitle}', DISPLAY, 13, at('container', 'top', 0, 8 * LINE + 17),
{ italic: true, fontWeight: 500 }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
placement: { ...at('container', 'top', 0, 8 * LINE + 29), size: { width: mm(14) } } },
]),
// The note sits low on the verso behind the title, its label a line above it.
front('nota', [text('label', '{titleText}', LABEL, 8.5, at('container', 'top', 0, 13 * LINE),
caps(8.5, 1.4))], { minHeight: pt(15 * LEAD) }),
chapter,
];
كل قطعة من الصفحات التمهيدية عنوان من المستوى الأول بنمط خاص به: يطبع # El transplantat {style="portada"} المؤلف والعنوان الفرعي من البيانات التمهيدية (frontmatter) والعنوانَ نفسه عنوانًا للكتاب. كل نمط يعيد ذكر فاصل الصفحة الخاص به، لأن النمط يرث فاصل مستواه، ويُفرغ الترويسة والتذييل، فليس في هذه الصفحات ترويسات ولا أرقام صفحات. وتقع صورة الواجهة في الصفحة 2، وهي صفحة زوجية، فتقابل صفحة العنوان في الزوج المتقابل.
#5 · المؤلف على الصفحة الزوجية والعنوان على الفردية
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
const head = (id, content, parity, edge, x, y = 10, pages = 'body') => ({
kind: 'text', id, content, parity, pages, ...caps(8, 1.3, 'muted'),
placement: at('page', edge, x, y),
});
const folio = { fontFamily: TEXT, fontWeight: 400, letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
{ ...head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER), ...folio },
head('verso-author', '{author}', 'even', 'top', -SHIFT),
head('recto-title', '{title}', 'odd', 'top', SHIFT),
{ ...head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER), ...folio },
] };
const drop = (parity, x) => ({ ...head(`drop-${parity}`, '{pageNumber}', parity, 'bottom', x,
-11, 'opener'), ...folio });
const footer = { elements: [drop('odd', SHIFT), drop('even', -SHIFT)] };
يضع parity المؤلف على الصفحات الزوجية والعنوان على الفردية؛ ويُبقي pages: 'body' كليهما بعيدًا عن صفحات الافتتاح، حيث يحلّ محلهما رقم صفحة سفلي بـpages: 'opener'. ويحرّك SHIFT كل ترويسة إلى منتصف كتلة النص، على بعد نصف مليمتر من منتصف الصفحة لأن الهامشين مختلفان.
#6 · خمسة نقوش بلا تسميات
const resourceTypes = [{ id: 'gravat', name: 'Gravat', namePlural: 'Gravats', shortLabel: 'Gravat',
captionPrefix: '', numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }];
const PICTURES = { // id: [file, width, height, alt text in the book's language]
frontis: ['frontis-1000.jpg', 1000, 1500, 'Un carrer de poble al capvespre. A la porta del forn, '
+ 'on cremen les flames, el forner, gras i somrient, amb davantal blanc i els braços creuats.'],
cap1: ['cap1-1200.jpg', 1200, 800, 'De nit, el tren baixa cap a Barcelona: rengleres de fanals, '
+ 'la muntanya de Montjuïc i la lluna sobre el mar. Un pagès treu el cap per la finestreta.'],
cap2: ['cap2-1200.jpg', 1200, 800, 'Un carrer de poble buit en una nit de tardor. Per la porta '
+ 'baixa de la ferreria, el manyà pica l’enclusa enmig d’una estrella d’espurnes.'],
cap3: ['cap3-1200.jpg', 1200, 800, 'La Rambla a trenc d’alba des d’un balcó. Un fanaler apaga '
+ 'el gas amb la perxa; al fons, els pals dels vaixells del port.'],
cap4: ['cap4-1200.jpg', 1200, 800, 'Capvespre als afores. Un vell de cabells blancs, assegut '
+ 'al caire del desmunt, mira la via del tren, que es perd recta fins a l’horitzó.'],
};
const resources = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
id, typeId: 'gravat', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
bitmap: { fileId, format: 'jpeg', width: w, height: h } }));
تنتمي الصور إلى نوع موارد له captionPrefix فارغ، فلا شيء يرقّمها أو يضع لها تسمية. كل صورة معلنة بقياسها بالبكسل ومحمّلة تحت معرّف ملفها قبل البناء. حُوِّل أبيضها إلى لون الورق الكريمي وأسودها إلى حبره قبل حفظها، فتُطبع جزءًا من الصفحة لا صورًا فوتوغرافية ملصقة عليها.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 104 · A Catalan novella, hyphenated by the IEC rules ═══════
// https://postext.dev/en/cookbook/catalan-pocket-novella
// Code: MIT · Text: N. Oller, El transplantat, 1928 (PD, Viquitexts) · Pictures: diffusion models
// Fonts: Gentium Book Plus, Cormorant Garamond, Cormorant SC (OFL) · Needs postext ≥ 1.57.0
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 (the sample is Catalan in both)
const RECIPE = 'catalan-pocket-novella';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#2a2320', // text: a warm near-black, the pictures' ink too
vermell: '#953222', // the one accent: chapter numerals, rules, the title page's title
muted: '#6e6359', // running heads, the edition's note, the colophon
paper: '#f5efe1', // a cream book paper, the pictures' white
};
// Each colour names its palette entry and carries its hex.
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: 'vermell (defaults)', value: { hex: palette.vermell, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Gentium Book Plus', 'Cormorant Garamond', 'Cormorant SC'];
const [BODY, LEAD] = [9.85, 14]; // pt: body and leading, the pitch of every vertical measure
const LINE = (LEAD * 25.4) / 72; // mm: one line, 4.94
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
overflow: 'wrap', placement, ...extra }); // a long title takes a second line
const caps = (size, tracking, color = 'vermell') => ({ fontFamily: LABEL, fontSize: pt(size),
fontWeight: 600, letterSpacing: pt(tracking), color: col(color) });
// #region page: a 12 × 18.5 cm pocket book; the text block holds 29 whole lines
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - LINES * LINE),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};
// #endregion
// #region answer: Catalan by its own code: l·l breaks as il- | lusió, no word splits its hiatus
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#دع الضمائر تنقسم أيضًا
مع القيمة الافتراضية compounds: true تنكسر d’inaugurar-se داخل الفعل هكذا d’i- | naugurar-se، وتفقد الصفحة 7 سطرها المتخلخل: لا يتجاوز أي سطر في الكتاب 1.6×. ويبقى الكسر titil- | laven في الصفحة 27. والثمن حرف i وحيد بعد الفاصلة العليا في آخر السطر.
- hyphenation: { compounds: false },
+ hyphenation: { compounds: true },#افتح كل فصل على صفحة فردية
يضيف parity: 'odd' صفحة فارغة قبل الفصل الذي كان سيبدأ على صفحة زوجية، كما في طبعة أرحب. والفصل IV، الذي ينفتح في الصفحة 26، ينتقل إلى الصفحة 27 بعد صفحة فارغة.
- breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
+ breakBefore: { enabled: true, parity: 'odd' },أخطاء شائعة
خطأ شائع
يرث نمط العنوان فاصل الصفحة من مستواه
يأخذ مُدخل headingStyles كل حقل يتركه من مستوى عنوانه، بما فيه breakBefore. فصفحة المحتويات أو صفحة بيانات النشر المنسّقة على H1 بعد :::pagebreak ترث الزوجية 'odd' وتقع بعد صفحة فارغة. أعطِ هذا النمط breakBefore: { enabled: false }. أنماط العناوين →
خطأ شائع
قيم السمات: لا { ولا }؛ ضع القيمة التي فيها " بين علامتي اقتباس مفردتين
تنتهي قيمة السمة عند القوس المعقوف الختامي، فلا يمكن أن تحتوي { أو }. القيمة التي فيها علامة اقتباس مزدوجة توضع بين علامتي اقتباس مفردتين؛ أما علامة الدولار فلا مشكلة فيها. سمات العنوان →
- انظر كيف يرسم خط النص l·l قبل أن تستقر عليه. منذ postext 1.30 صار
localeالمستند أيضًا اللغة التي يُشكَّل بها النص (وحتى 1.29 كانت لغة الصفحة التي تعرض الكتاب)، ولكل خط طريقته في الاستجابة للكتالونية. لخط Gentium Book Plus نقطة وسطى واحدة لكل اللغات، بعرض 0.17 em بين حرفي l. أما Crimson Pro، الذي نُضّد به هذا الكتاب حتى 1.29، فيوسّع النقطة إلى 0.59 em في الكتالونية ويترك فجوة في intel·ligent. ويرسم Alegreya وLiterata نقطة أضيق فقط حيث يصلهما حرفا l في قطعة واحدة، فتخرج il·lustrats بشكل في فقرة فيها حروف مائلة وبشكل آخر في فقرة تخلو منها. - انسخ النص من Viquitexts مع حروفه المائلة: يعلّم أوليه tentu وEnsanxe وpalacio كلمات عامية أو إسبانية، والتصدير بنص خام يُسقطها. وراجع الكلمات المشكوك فيها على مسح مجلد 1928: في ست مرات تكتب النسخة tom- حيث الفعل tornar (tomà، tomaré، tomar)، ومرة واحدة jom بدل jorn.
- مع 6,800 كلمة، تجعل ملفات المحتوى الخمسة والعُدّة النصَّ البرمجي المركّب نحو 69 KB. الكتاب الكامل هو أكبر عيّنة يتضمّنها مثال CodePen؛ والعمل الأطول مكانه حزمة
.postext.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- El transplantat, complete, from the Obres completes, vol. VI (Barcelona, 1928), with misprints corrected, no opening ¿ ¡ and today’s dialogue dashes · Narcís Oller · ملك عام
- The note to the edition · Postext Cookbook · أصلي
- الصور
- Engraving, frontispiece: the baker at his oven's door · Generated With Diffusion Models · أصلي
- Engraving, chapter I: the night train into Barcelona · Generated With Diffusion Models · أصلي
- Engraving, chapter II: the village street in autumn · Generated With Diffusion Models · أصلي
- Engraving, chapter III: the Rambla at dawn · Generated With Diffusion Models · أصلي
- Engraving, chapter IV: the old man by the railway · Generated With Diffusion Models · أصلي
- الخطوط
- Gentium Book Plus (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant SC (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


