باختصار
الفصل الأول من رواية صينية كلاسيكية في كتاب بغلاف ورقي من تايوان. يجري النص في أعمدة من الأعلى إلى الأسفل، وتُقرأ من اليمين إلى اليسار، ويُفتح الكتاب من اليمين.
ما الذي ستنضده
إحدى عشرة صفحة من طبعة تايوانية بغلاف ورقي لـRomance of the Three Kingdoms (رواية الممالك الثلاث): الفصل 1 كاملًا، في تنقيح Mao Zonggang، منضَّدًا من الأعلى إلى الأسفل في أعمدة تُقرأ من اليمين على صفحة 148 × 210 مم (25開) مجلَّدة من اليمين. تقع صفحة العنوان وحدها على يسار الكعب. وفي الصفحتين المتقابلتين التاليتين يقابل نقشٌ خشبي لقَسَم بستان الخوخ، حُفر سنة 1592، بدايةَ الفصل، حيث يقف 第一回 وبيتاه بين خطوط بلون الزنجفر. في كل صفحة نص 16 عمودًا من 40 حرفًا، وكل علامة متوسَّطة في خانتها. يجري عنوان الكتاب نزولًا في الهامش الخارجي للصفحات اليمنى وعنوان الفصل في الصفحات اليسرى، فوق أرقام صفحات بالأرقام الصينية. وبنية الكتاب نفسها في كتاب أوروبي بغلاف ورقي هي الوصفة رقم 038.
تجيب هذه الوصفة عن
- كيف أنضد كتابًا صينيًّا عموديًّا، مجلَّدًا من اليمين؟
- كيف أرقّم الفصول 第一回، 第二回 بالأعداد الصينية؟
الجواب المختصر
// 'vertical-rl' turns the flow a quarter turn: lines run down, columns from right to left,
// and page.binding 'auto' becomes 'right', so page 1 is a left-hand page and the spreads
// read [3 | 2]. The grid sets the type area in characters; the margins are minimums it
// grows. zh-Hant resolves to Taiwan's rules: every mark full width and centred in its cell.
const page = {
sizePreset: 'custom', width: mm(148), height: mm(210), dpi: 150,
backgroundColor: col('paper'),
// 天頭 above 地腳; left is the spine side (the right edge of a left-hand page).
margins: { top: mm(32), bottom: mm(26), left: mm(16), right: mm(22), mirror: true },
pageNumbering: { format: 'trad-chinese-informal' }, // folios 一, 二 … 九, from the chapter
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = { grid: { enabled: true, charsPerLine: 40, linesPerPage: 16 } };
const chapter = {
level: 1, numberingTemplate: '第{1:一}回', numberSeparator: ' ', // 第一回 宴桃園…
breakBefore: { enabled: true, parity: 'odd' }, // a recto, with no blank page forced
marginBottom: pt(0),
};
المكونات
- الميزات
- النص العموديكتب مجلّدة من اليمينالأرقام الصينيةتقسيم الأسطر في النص الصينيعروض علامات الترقيم الصينيةشبكة المحارفالخطوط الصينية واليابانية والكوريةصفحات افتتاح مصمَّمةأنماط العناوينسمات العنوانالعناوين المرقّمةفواصل الأسطر في العناوينالترويسات وأرقام الصفحاتترويسات لكل قسمالترويسات بحسب دور الصفحةهوامش متناظرةأنماط الفقراتالصور في تصاميم الصفحةالتصدير إلى PDFلون الورق
- تستخدم أيضًا
- الخطوط المضمَّنة في PDFالأشكال والجداول بوصفها مواردترقيم روماني للصفحات التمهيديةفصول بلا أرقام
- الخطوط
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4 (SIL OFL 1.1)
- الأصول
peach-garden-oath-1592-v2.jpg- 桃園結義 (The Oath in the Peach Garden), woodcut from Yu Xiangdou’s 新刊京本校正演義全像三國志傳評林, Jianyang, 1592 (Waseda University Library); scan from Wikimedia Commons, cropped inside its frame and clear of what was left of it, cleaned and toned to the page’s ink and paper (Yu Xiangdou (publisher), anonymous block cutter, ملك عام)
طريقة التحضير
#1 · أدِر الصفحة ربع دورة وجلّدها من اليمين
الشيفرة هي الجواب المختصر أعلاه. يُخرج layout.writingMode: 'vertical-rl' كل صفحة كصفحة أفقية أُديرت ربع دورة باتجاه عقارب الساعة: سطر المجرى عمود من الحروف يُقرأ من اليمين، ويعمل كسر الأسطر وضبطها وإزاحة الحرفين نزولًا في العمود (الكتابة العمودية). تبقى page.binding على 'auto'، الذي يجلّد الكتاب العمودي من اليمين: الصفحة 1 ما زالت الصفحة الفردية، لكنها صفحة يسرى، ويضع mirror: true هامشها الداخلي، left، على يمينها (التجليد). تُخرج showBook في عُدّة الوصفات الصفحات المتقابلة كما يُفتح الكتاب، الصفحة 1 وحدها ثم [3 | 2]؛ ويطلب ملف PDF الترتيب نفسه من العارضات بـ/Direction /R2L، الذي يتبعه Acrobat ويتجاهله عارض Chrome.
تضبط شبكة الحروف منطقة الكتابة على 40 حرفًا بحجم 10.5 pt نزولًا و16 عمودًا بخطوة 19 pt عرضًا، أي 148.2 × 107.2 مم. الهوامش في page حدود دنيا: تكبّر الشبكة كل زوج منها بالتساوي، إلى 33.9 مم في الرأس و27.9 في الأسفل، و17.4 عند الكعب و23.4 عند الحافة الخارجية. يضبط locale: 'zh-Hant' إعدادات شرق آسيا على قيم تايوان: كل علامة em كامل ومتوسَّطة في خانتها، بلا ضغط بين العلامات. يطبع trad-chinese-informal أرقام الصفحات من 一 إلى 九، ويرقّم 第{1:一}回 الفصل (الترقيم).
#2 · سطّر الـ回目 في عمودين
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the title columns.
const [TITLE, PITCH] = [13.5, 1.5 * LEAD]; // pt: the couplet's size and its column pitch
const rule = (n) => ({ kind: 'rule', id: `rule-${n}`, direction: 'horizontal',
thickness: pt(0.5), color: col('vermilion'),
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: pt(LEAD + n * PITCH) }, size: { width: 'fill' } } });
const title = (id, content, x, family, weight) => ({ kind: 'text', id, content,
fontFamily: family, fontWeight: weight, fontSize: pt(TITLE), lineHeight: PITCH / TITLE,
color: col('ink'), align: 'left', // the head of the column
placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: pt(x), y: pt(LEAD) } } }); // a line of PITCH, centred between two rules
const opener = {
enabled: true,
minHeight: cols(5), // a blank column, the two title columns, a blank one: 5 × 19 pt
slot: { elements: [
rule(0), rule(1), rule(2),
title('number', '{number}', 2 * BODY, SONG, 700), // 第一回, two characters down
// The couplet's two halves, broken by the \\ in the heading, start level with each other.
title('couplet', '{titleText}', 2 * BODY + 4 * TITLE, KAI, 400),
] },
};
يُخرَج تصميم العنوان في الصفحة العمودية في إطار المجرى: يجري x نزولًا في العمود من رأس منطقة الكتابة، وy عرضًا في الصفحة من حافتها اليمنى. فالخط 'horizontal' إذن خط عمودي على الورقة، بطول العمود. ثلاثة خطوط بسمك 0.5 pt تؤطّر عمودي عنوان بينهما 28.5 pt، أي 1.5 ضعف خطوة أعمدة النص. كل عمود سطر ارتفاعه 28.5 pt تقف حروفه في منتصفه، في منتصف المسافة بين خطين. يطبع {number} الرقم 第一回 بخط Noto Serif TC Bold على بعد حرفين من الأعلى؛ ويطبع {titleText} البيتين بخط LXGW WenKai TC، بعده بحرف. يُكتب العنوان # 宴桃園豪傑三結義 \\ 斬黃巾英雄首立功، ويبدأ كسر السطر القسري النصف الثاني في العمود التالي، على مستوى الأول. يحجز minHeight خمسة أعمدة بخطوة 19 pt، فيبدأ النص على شبكته (الامتداد والتصميم المتقدم). وحيث يُقرأ العنوان على سطر واحد، في الترويسات وإشارات PDF المرجعية، يصير الفاصل مسافة إيديوغرافية.
#3 · ضع الترويسات وأرقام الصفحات نزولًا على الحافة الخارجية
const foreEdge = (id, content, parity, edge, y, pages) => ({
kind: 'text', id, content, parity, pages, writingMode: 'vertical-rl',
fontFamily: HEI, fontSize: pt(8.5), color: col('muted'), overflow: 'clip',
placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
foreEdge('book', '{title}', 'even', 'top', 4, 'body'), // 三國演義 on the right-hand page
foreEdge('chapter', '{chapterNumber} {chapterTitle}', 'odd', 'top', 4, 'body'),
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -5, 'all'), // on openers too
] };
كثيرًا ما تضع الكتب العمودية في تايوان الترويسة ورقم الصفحة نزولًا في الهامش الخارجي. يضع writingMode: 'vertical-rl' عنصر الترويسة من الأعلى إلى الأسفل على الورقة، ويضعه anchor.to: 'outer' في الهامش الخارجي، أي الأيسر في الصفحة الفردية والأيمن في الصفحة الزوجية حين يكون الكتاب مجلَّدًا من اليمين (عناصر النص العمودية). الإزاحات بوحدات em من حجم العنصر نفسه، 8.5 pt، أي نحو 80 % من حجم النص: تبدأ الترويسة بعد أربعة حروف تحت رأس منطقة الكتابة، وينتهي رقم الصفحة قبل خمسة حروف من أسفلها. يضع parity 三國演義 في الصفحات اليمنى والفصل في اليسرى. ويُبعد pages: 'body' الترويستين عن صفحة البداية، التي تحتفظ برقم صفحتها.
#4 · ضع اللوحة قبل الفصل
const none = { elements: [] };
// A point of a page design in the flow frame: mm down the column, mm leftward across the
// page from the right edge of the type area.
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
// The title slip (題簽), 96 × 22 mm: its axis, 55 mm in from the right of the type area, is
// the axis of the page, and of the imprint under it.
const SLIP = { down: 10, across: 44, long: 96, wide: 22 };
const AXIS = SLIP.across + SLIP.wide / 2;
const slip = (id, inset, thickness) => ({ kind: 'box', id,
placement: { ...at(SLIP.down + inset, SLIP.across + inset),
size: { width: mm(SLIP.long - 2 * inset), height: mm(SLIP.wide - 2 * inset) } },
style: { borderColor: col('vermilion'), borderWidth: pt(thickness) } });
const RUN = (4 * 40 + 3 * 10) * PT; // 三國演義 down the slip: four 40 pt characters, 3 gaps
const titlePage = {
id: 'title', numbered: false, toc: false, span: 'page', header: none,
breakBefore: { enabled: true, parity: 'any' },
footer: { elements: [{ kind: 'text', id: 'imprint', content: '{attr.colophon}',
fontFamily: ROMAN, fontSize: pt(6.5), lineHeight: 1.4, color: col('muted'),
// In the edition's language, set across and centred on the axis: the box runs from the
// left of the type area (16 columns) as far past the axis. Each \n in the attribute
// starts a line, and *…* sets the book's title in italic.
inlineMarks: true, overflow: 'wrap', align: 'center',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(4) },
size: { width: mm(2 * (16 * LEAD * PT - AXIS)) } } }] },
advancedDesign: { enabled: true, minHeight: cols(16), slot: { elements: [
slip('slip', 0, 1.4), slip('slip-in', 1.2, 0.4), // a heavy and a light vermilion rule
{ kind: 'text', id: 'book', content: '{titleText}', fontFamily: SONG, fontWeight: 700,
fontSize: pt(40), lineHeight: 1, letterSpacing: pt(10), color: col('ink'),
placement: at(SLIP.down + (SLIP.long - RUN) / 2, AXIS - 20 * PT) }, // 40 pt line on the axis
{ kind: 'text', id: 'author', content: '{author} 著', fontFamily: KAI, fontSize: pt(12),
color: col('ink'), placement: at(52, 72) },
{ kind: 'text', id: 'editor', content: '{attr.editor}', fontFamily: KAI, fontSize: pt(12),
color: col('ink'), placement: at(52, 80) },
] } },
};
// The woodcut, 138 mm tall in a double frame (四周雙邊), hangs from the top right corner of
// the type area, and its caption runs down the column on its left. In the flow frame a
// box's width runs down the page: the picture's width is its height on the sheet, and it
// stands upright in the canvas, the HTML and the PDF.
const PLATE = { right: 8.3, top: 5.1, h: 138, w: (138 * 806) / 1427 }; // mm
const frame = (id, inset, thickness) => ({ kind: 'box', id,
placement: { ...at(PLATE.top - inset, PLATE.right - inset),
size: { width: mm(PLATE.h + 2 * inset), height: mm(PLATE.w + 2 * inset) } },
style: { borderColor: col('ink'), borderWidth: pt(thickness) } });
const plate = {
id: 'plate', numbered: false, toc: false, span: 'page', header: none, footer: none,
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: cols(16), slot: { elements: [
{ kind: 'image', id: 'woodcut', resourceId: 'peach-garden',
placement: { ...at(PLATE.top, PLATE.right), size: { width: mm(PLATE.h), height: 'auto' } } },
frame('inner', 1.6, 0.4), frame('outer', 2.8, 1.4),
{ kind: 'text', id: 'caption', content: '{titleText}', fontFamily: HEI, fontSize: pt(9),
color: col('ink'), placement: at(PLATE.top - 2.8, PLATE.right + PLATE.w + 7) },
{ kind: 'text', id: 'note', content: '{attr.note}', fontFamily: KAI, fontSize: pt(8),
color: col('muted'), placement: at(PLATE.top - 2.8, PLATE.right + PLATE.w + 12) },
] } },
};
const resources = [{
id: 'peach-garden', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'peach-garden.jpg', format: 'jpeg', width: 806, height: 1427 },
caption: '桃園結義',
altText: '桃園結義圖:劉備、關羽、張飛立於祭桌前,桌上香爐燭臺與三杯酒,旁有烏牛白馬。',
}];
صفحة العنوان واللوحة عنوانان من المستوى الأول بنمطين خاصين، # 三國演義 {style="title" …} و# 桃園結義 {style="plate" …}. يتركهما numbered: false خارج العدّ، فيبقى الفصل 第一回، وتحلّ header الخاصة بهما، الفارغة، محل ترويسات الحافة الخارجية. يطلب breakBefore في الفصل صفحة فردية، الصفحة 3، التي تقع اللوحة على يمين صفحتيها المتقابلتين: يرى القارئ الصورة قبل النص، كما في الطبعات المصوّرة (繡像) (أنماط العناوين). وتستثني أرقام الصفحات الصفحتين كذلك. يرقّم المحرر الصيني النص (正文) من صفحته الأولى، لذا يبدأ سطر :::numbering{startAt=1} قبل عنوان الفصل مباشرة العدّ من جديد عند 一 في الصفحة 3 (:::numbering)؛ وما زالت صفحة العنوان واللوحة تُحسبان ورقتين في الزوجية والفردية، ويطلق عليهما العارض وملف PDF الرقمين 一 و二 مع ذلك (أحد التنويعات أدناه يميّز تسميتهما).
يتوسط 三國演義 شريطه نزولًا: RUN طول أربعة حروف بحجم 40 pt والفجوات الثلاث بينها بحجم 10 pt، دون تباعد الحروف بعد الحرف الأخير. يضع تذييل صفحة العنوان بيان النشر عرضًا في الأسفل، بلغة الطبعة، من السمة colophon في العنوان. لا خط مائلًا في Noto Serif TC، لذا يُنضَّد بيان النشر بـSource Serif 4: يقرأ inlineMarks: true النجمتين حول عنوان الكتاب، ويبدأ كل \n في السمة سطرًا، فتنكسر الأسطر حيث يقتضي المعنى (عناصر النص). عرض المستطيل ضعف المسافة من يسار منطقة الكتابة إلى محور الشريط، فيقع منتصف كل سطر تحت 三國演義. يعلّق تصميم اللوحة النقش الخشبي وإطاره المزدوج من الزاوية العليا اليمنى لمنطقة الكتابة، ويضع التعليق نزولًا في عمودين على يساره. في إطار المجرى يجري عرض المستطيل نزولًا في الصفحة، فـwidth الصورة هو ارتفاعها على الورقة؛ وتقف قائمة في Canvas وHTML وPDF، ويقرؤها ملف PDF الموسوم شكلًا له نصه البديل.
#5 · حمّل كل خط بالحروف التي ينضّدها
// Fontsource cuts a Chinese face into about a hundred files; loadCjkFonts fetches those
// that hold the characters it is given (gotcha: cjk-fonts-slices). vertical: true loads the
// face again with its vertical punctuation forms, for the canvas.
const heads = markdown.match(/^# .*$/gm).join('').replace(/\{[^}]*\}/g, ''); // no attributes
const attr = (key) => markdown.match(new RegExp(`${key}="([^"]*)"`))?.[1] ?? '';
const verse = markdown.match(/:::paragraphs\{style="verse"\}[\s\S]*?\n:::/g).join('');
await loadFonts(FONTS, markdown); // the Latin files: the imprint
await loadCjkFonts({ [SONG]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [SONG]: ['700'] }, '三國演義第一回'); // no punctuation: no vertical twin
await loadCjkFonts({ [KAI]: ['400'] }, `${heads}${verse}${attr('editor')}${attr('note')}羅貫中著`,
{ vertical: true });
await loadCjkFonts({ [HEI]: ['400'] }, `${heads}第回一二三四五六七八九十`, { vertical: true });
للكتاب ثلاثة أصوات: Noto Serif TC (宋) للنص، وLXGW WenKai TC (楷) للبيتين والشعر، وNoto Sans TC (黑) للحافة الخارجية. تقدّم Fontsource كل وزن من الخط الصيني في نحو مئة ملف، يغطي كل منها نطاقًا من الحروف، وتجلب loadCjkFonts الملفات التي تضم النص المعطى لها (الخطوط الصينية واليابانية والكورية). يأخذ خط النص الفصل كله ويجلب 67 ملفًا؛ ويأخذ خط Kai العناوين والشعر ويجلب 25، وخط Hei 15، والعريض 4. يضع العريض سبعة حروف بلا علامات ترقيم، فلا يحمّل أشكالًا عمودية. ويدخل Source Serif 4 الخاص ببيان النشر عبر loadFonts كأي خط لاتيني، بالقائم والمائل. تأخذ renderToPdf المزوّد cjkPdfProvider، الذي يضمّن الملفات نفسها كمجموعات جزئية، وimageBytes للنقش الخشبي.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 075 · A vertical Chinese novel, bound on the right ════════
// https://postext.dev/en/cookbook/vertical-novel-right-bound
// Code: MIT · Text: 三國演義 ch. 1, zh.wikisource (CC BY-SA 4.0) · Plate: woodcut, 1592 (PD)
// Fonts: Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4 (OFL) · Needs postext ≥ 1.25.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the frame; the novel is Chinese in both editions
const RECIPE = 'vertical-novel-right-bound';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink, one vermilion, the paper the plate was toned to
const palette = {
ink: '#2a221d', // the text, and the woodcut's lines
vermilion: '#a3301f', // 朱: the ruled columns of the opener, the title slip
muted: '#6f655c', // fore-edge heads, folios, the imprint
paper: '#fbf8f1', // the page; the plate's paper was toned to this value
};
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: 'defaults', value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [SONG, KAI, HEI] = ['Noto Serif TC', 'LXGW WenKai TC', 'Noto Sans TC']; // 宋, 楷, 黑
const ROMAN = 'Source Serif 4'; // the imprint: Noto Serif TC has no italic
const [BODY, LEAD] = [10.5, 19]; // pt: 五號 text on a column pitch of 1.8 em
const cols = (n) => pt(n * LEAD); // n columns across the page
const PT = 25.4 / 72; // mm in a point
// #region answer: vertical text on a 25開 page, bound on the right, 40 characters × 16 columns
// 'vertical-rl' turns the flow a quarter turn: lines run down, columns from right to left,
// and page.binding 'auto' becomes 'right', so page 1 is a left-hand page and the spreads
// read [3 | 2]. The grid sets the type area in characters; the margins are minimums it
// grows. zh-Hant resolves to Taiwan's rules: every mark full width and centred in its cell.
const page = {
sizePreset: 'custom', width: mm(148), height: mm(210), dpi: 150,
backgroundColor: col('paper'),
// 天頭 above 地腳; left is the spine side (the right edge of a left-hand page).
margins: { top: mm(32), bottom: mm(26), left: mm(16), right: mm(22), mirror: true },
pageNumbering: { format: 'trad-chinese-informal' }, // folios 一, 二 … 九, from the chapter
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = { grid: { enabled: true, charsPerLine: 40, linesPerPage: 16 } };
const chapter = {
level: 1, numberingTemplate: '第{1:一}回', numberSeparator: ' ', // 第一回 宴桃園…
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#اكتب أرقام الصفحات رقمًا رقمًا
يكتب cjk-decimal رمزًا صينيًا لكل خانة. ينتهي هذا الفصل عند رقم الصفحة 九، حيث تتفق الصيغتان؛ ومن الصفحة العاشرة من النص فصاعدًا يُقرأ 十 و十一 بصيغة 一〇 و一一.
- pageNumbering: { format: 'trad-chinese-informal' }, // folios 一, 二 … 九, from the chapter
+ pageNumbering: { format: 'cjk-decimal' }, // folios 一, 二 … 九, 一〇, 一一#ميّز تسمية الصفحات التمهيدية
لا تطبع صفحة العنوان واللوحة رقم صفحة، ومع ذلك يطلق عليهما العارض وملف PDF الرقمين 一 و二، مثل أول صفحتين من النص؛ ومع تسميات رومانية للصفحات التمهيدية ونقل الأرقام الصينية إلى سطر :::numbering، يعدّ ملف PDF i وii و一 و二 …
- pageNumbering: { format: 'trad-chinese-informal' }, // folios 一, 二 … 九, from the chapter
+ pageNumbering: { format: 'lower-roman' }, // i, ii: the title page and the plate-:::numbering{startAt=1}
+:::numbering{format="trad-chinese-informal" startAt=1}#نضّد الفصل أفقيًا
يضع عُرف البر الرئيسي الصيني هذا النوع من الفصول أفقيًا، مجلَّدًا من اليسار، بالحروف المبسَّطة وعلامات ترقيم Kaiming: صفحة رواية صينية على شبكة 28 × 28.
أخطاء شائعة
خطأ شائع
اوسم المستند بـ zh-Hans أو zh-Hant، لا بـ LANG
نسختا الوصفة هما en وes، لكن المثال الصيني صيني في كلتيهما: `locale: LANG` سيسمه بالإنجليزية أو الإسبانية، فيقسّم كلماته اللاتينية بالواصلة، ويسمّي أشكاله Figure أو Figura، ويعطي PDF لغة خاطئة. ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فتحت وسم إنجليزي أو إسباني يصفّ الخط الصيني أرقامه وعلامات الترقيم التي يشترك فيها مع النص اللاتيني بأشكال أخرى، وتنكسر الأسطر في مواضع أخرى. اكتب الوسم بنفسك: 'zh-Hans' (أعراف البر الرئيسي: كسر الأسطر وفق GB، وترقيم Kaiming) أو 'zh-Hant' (تايوان: ترقيم بعرض كامل متمركز)؛ و'zh-HK' لهونغ كونغ. أما 'zh' المجرّد فيُقرأ صينية مبسطة على أعراف البر الرئيسي. أما المثال الياباني فيُوسم بـ 'ja' (gotcha ja-locale-tag). تقسيم الأسطر في النص الصيني →
خطأ شائع
الخطوط الصينية تُحمَّل شرائح، عبر الكتلة cjk
يقدّم Fontsource العائلة الصينية أو اليابانية أو الكورية في نحو مئة ملف لكل وزن، يغطي كل منها نطاقًا من الحروف. لا يجلب loadFonts إلا ملف latin، فتأتي حروف الهان على الشاشة من خط النظام وتُقاس خطأً، ويسلّم fontsourceProvider ملف latin ذاك إلى PDF، فيطبعها مربعات فارغة. اذكر كتلة الأدوات cjk، واستدعِ loadCjkFonts(FONTS, markdown) بعد loadFonts (مرة لكل صوت، مع النص الذي يضعه، حين يستخدم الكتاب عدة خطوط CJK)، وأعطِ renderToPdf القيمة fontProvider: cjkPdfProvider: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →
خطأ شائع
الكتاب المجلَّد على اليمين يعرض صفحاته المتقابلة بـ showBook
في الكتاب المجلَّد على اليمين (نص عربي أو عبري أو فارسي، أو صيني عمودي، أو page.binding 'right') تبقى الصفحة 1 هي الصفحة الفردية، لكنها تقع على يسار الكعب، وتُقرأ الأزواج [3 | 2]. يعرض showPages كل كتاب مجلَّدًا على اليسار؛ أما showBook من الكتلة book (وتحمل الكتلة cjk الدالة نفسها) فيقرأ doc.binding ويعكس الأزواج. ولا يزال capture.hero يسمّي الصفحتين المتقابلتين بترتيب القراءة، [verso, recto]: [2, 3]. كتب مجلّدة من اليمين →
خطأ شائع
النسخ التقليدية المنقولة تحمل حروفًا مبسطة شاردة
النصوص المنسوخة من Wikisource أو من طبعة ويب أخرى لكتاب تقليدي تحمل أحيانًا شكلًا مبسطًا (颙 بدل 顒 في 三國演義، الفصل 1)، وقد لا يملكه خط TC مثل Noto Serif TC. يوقف loadCjkFonts مثال CodePen ويذكر الحرف في رسالته؛ وفي الصفحة كان سيُطبع بخط بديل. أعِد الشكل التقليدي في المثال واذكر ذلك في الحقوق. الخطوط الصينية واليابانية والكورية →
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- 三國演義 (Romance of the Three Kingdoms), chapter 1, Mao Zonggang recension (about 1679); Wikisource transcription, revision 2583915, with one character corrected (颙 → 顒) · Luo Guanzhong; transcription by Wikisource editors · CC BY-SA 4.0
- الصور
- 桃園結義 (The Oath in the Peach Garden), woodcut from Yu Xiangdou’s 新刊京本校正演義全像三國志傳評林, Jianyang, 1592 (Waseda University Library); scan from Wikimedia Commons, cropped inside its frame and clear of what was left of it, cleaned and toned to the page’s ink and paper · Yu Xiangdou (publisher), anonymous block cutter · ملك عام
- الخطوط
- Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · Source Serif 4 (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


