باختصار
كتاب قراءة مدرسي من تايوان مطبوع في أعمدة من الأعلى إلى الأسفل. بجانب كل حرف صيني دليل نطق صغير، فيقرأ الأطفال كلمات لم يتعلموها بعد.
ما الذي ستنضده
الدرس 12 من الكتاب 9 من 國語، وهو كتاب قراءة متخيَّل للصف الخامس من تايوان: حكايتان من Han Feizi، فلاح سونغ الذي ينتظر بجانب جذع شجرة أرنبًا آخر، ورجل تشنغ الذي يثق بمقاسه أكثر من قدميه. تُنضَّد كتب القراءة في تايوان عموديًا، بخط Kai، وزهويين كل حرف في عمود على يمينه، فيقرأ الطفل الحرف قبل أن يتعلمه. يُفتتح الدرس على صفحتين متقابلتين مجلدتين على اليمين. في الأعلى طبقة فيها الصور والحواشي والمؤلف والحروف الجديدة؛ وفي الأسفل يجري الدرس بخط Iansui بحجم 16 pt، ثلاثة وعشرون حرفًا في السطر. ونظيره بالحرف اللاتيني هو الكتاب المدرسي بعمود هامشي، الذي يصير عموده الجانبي المخصص للعناصر العائمة هنا الطبقةَ العليا، مُدارًا ربع دورة.
تجيب هذه الوصفة عن
- كيف أنضد التشويين (zhuyin) بجانب كل حرف من نص صيني عمودي؟
- كيف أنضد كتابًا صينيًّا عموديًّا، مجلَّدًا من اليمين؟
الجواب المختصر
const layout = {
writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
sideColumnPercent: 34,
gutterWidth: pt(2 * SIZE),
};
const cjk = {
// The lower tier: 23 characters down, 13 lines across the page.
grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
// Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
// so three symbols fit beside one character, and beside each of two in a row.
ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};
// The line pitch is twice the size: a gap of one em, which the zhuyin and its tone
// marks half fill. clreq asks for 1.5 em; one em keeps 13 lines of 23 on the page.
const LINE = 2 * SIZE;
const bodyText = {
fontFamily: KAI, fontSize: pt(SIZE), lineHeight: pt(LINE), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(2), indentAfterHeading: true,
};
المكونات
- الميزات
- قراءات ruby: pinyin وzhuyinالنص العموديكتب مجلّدة من اليمينالخطوط الصينية واليابانية والكوريةعروض علامات الترقيم الصينيةشبكة المحارفعمود ونصفعمود هامشي للعناصر العائمةملاحظات الهامشالأرقام الصينيةالقوائم المرقّمةأنواع موارد مخصّصةإطارات التنبيهأنماط الفقراتأنماط العناوينالنصوص والخطوط والمربعات في تصاميم الصفحةالترويسات وأرقام الصفحاتالتصدير إلى PDF
- تستخدم أيضًا
- تقسيم الأسطر في النص الصينيسمات العنوانالعناوين المرقّمةأشكال في هذا الموضع بالضبطالترويسات بحسب دور الصفحةالخطوط المضمَّنة في PDFالأشكال والجداول بوصفها مواردأرقام قائمة في النص العموديفصول بلا أرقام
- الخطوط
- Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1)
- الأصول
plate-1-1500.jpgplate-2-1500.jpg- The farmer waiting by the stump, a brush painting (Generated With Diffusion Models, أصلي)
- The man of Zheng hurrying home from the shoe stall, a brush painting (Generated With Diffusion Models, أصلي)
طريقة التحضير
#1 · عمود زهويين بجانب كل حرف
الشيفرة هي الجواب المختصر أعلاه. يضع {宋人|ㄙㄨㄥˋ|ㄖㄣˊ} لكل حرف قراءته الخاصة، واحدة لكل |؛ وتبقى علامات الترقيم خارج الأقواس، فلا يأخذ 。 ولا , شيئًا. في النص العمودي تقع القراءة بالبوبوموفو يمين العمود، ورموزها مكدسة، وعلامة النبرة يمين آخرها ونقطة النبرة المحايدة فوق أولها. وبنصف حجم النص يضبط cjk.ruby.fontSize الرموز على 0.3 em، فتتسع ثلاثة رموز بجانب حرف، وقراءتان كهاتين متتاليتين، كما في 就像، تبقيان على بعد ربع رمز على الأقل دون أن يتسع أي من الحرفين؛ أما بحجم 0.6 em فيصير ㄇㄧㄥˊ أطول من 明 ويباعد بين حرفي 明明. ويترك تباعد الأسطر البالغ 32 pt فراغًا قدره em واحد، يملأ الزهويين وعلامات نبراته نصفه. وتطلب clreq 1.5 em حين يقف الزهويين بين أسطر عمودية؛ وهذا تباعد 40 pt وعشرة أسطر في الصفحة، لذا تحتفظ هذه الصفحة بـ em واحد لثلاثة عشر سطرًا من ثلاثة وعشرين حرفًا، وتبقى كل قراءة على بعد نحو 8 pt من السطر المجاور.
#2 · الصور والحواشي في الطبقة العليا
const resourceTypes = [{ id: 'plate', name: '插圖', shortLabel: '圖', numberingTemplate: '{n}',
resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }]; // no prefix, no caption
const box = (id, title, body) => ({ id, title, background: col('tint'),
padding: { top: mm(3), right: mm(3), bottom: mm(3), left: mm(3) },
titleStyle: { fontFamily: HEI, fontSize: pt(11), fontWeight: 700, color: col('accent') },
body: { color: col('ink'), firstLineIndent: pt(0), textAlign: 'left', boldColor: col('ink'),
italicColor: col('ink'), ...body } });
// Zhuyin is 0.3 em of the text it reads: at 13 pt the notes' readings are 3.9 pt.
const calloutStyles = [ // fenced :::callout{type="notes" span="side"} in the text
box('notes', '注釋', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24) }),
box('author', '作者', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24),
textAlign: 'justify', firstLineIndent: em(2) }),
box('chars', '生字', { fontFamily: KAI, fontSize: pt(22), lineHeight: pt(40),
textAlign: 'center' }),
];
في النص العمودي تصير أعمدة تخطيط oneAndHalf طبقات، ويضع sideColumnSide: 'left' الطبقة المخصصة للعناصر العائمة في الأعلى. يرسل ::resource{id="plate-1"} في النص الصورة الأولى إلى هناك؛ ونوع plate بلا بادئة تعليق والصور بلا تعليق، فلا يُطبع شيء تحتها. والإطار الذي يُكتب بـspan="side" يقع في الطبقة ابتداءً من السطر الذي كُتب فيه، ويجري نصه نزولًا في الطبقة. وحواشي الحكايتين إطار واحد، مرقمة على امتداد الدرس ومكتوبة بعد النص الأصلي الأول، الذي ينتهي في الصفحة 86: فتملأ طبقة الصفحة 87، فتقع حواشي الحكايتين على الصفحتين المتقابلتين اللتين فيهما نصاهما الأصليان. والزهويين 0.3 em من النص الذي يقرؤه، وcjk.ruby إعداد واحد للكتاب كله، لذا تُنضَّد الحواشي وإطار المؤلف بحجم 13 pt لتبقى قراءاتها بحجم 3.9 pt.
#3 · أربعة خطوط، كل منها محمَّل بنصه
// {株|ㄓㄨ}: the characters are the text, the readings go to the zhuyin face.
const BOXES = /^:::callout\{type="(?:notes|author)"[^}]*\}\n([\s\S]*?)^:::$/gm;
const bases = (md) => md.replace(/\{([^|{}]+)((?:\|[^|{}]+)+)\}/g, '$1');
const readings = [...markdown.matchAll(/\{[^|{}]+((?:\|[^|{}]+)+)\}/g)].map((m) => m[1]).join('');
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [KAI]: ['400'] }, bases(markdown.replace(BOXES, '')), { vertical: true });
const notesText = [...markdown.matchAll(BOXES)].map((m) => m[1]).join('\n');
await loadCjkFonts({ [MING]: ['400'] }, bases(notesText), { vertical: true });
await loadCjkFonts({ [ZHUYIN]: ['400'] }, readings.replaceAll('|', ''), { vertical: true });
await loadCjkFonts({ [HEI]: ['400', '700'] }, LABELS, { vertical: true });
await Promise.all(Object.values(plates).map((fileId) => loadImage(fileId, asset(fileId))));
// Lesson 12 of a reader: page 86 is a verso, so the lesson opens on a spread.
const continuation = { pageIndexOffset: 1, pageNumbering: { startAt: 86 } };
const doc = await withLoadedFonts(
() => buildDocument({ markdown, resources, continuation }, config()),
{ ...kitFonts(FONTS), text: markdown });
showBook(doc, { title: t({ en: 'A vertical reader with zhuyin',
es: 'Un libro de lectura vertical con zhuyin' }) });
offerPdf(() => renderToPdf(doc, { fontProvider: cjkPdfProvider, resourceBytes: imageBytes }),
`${RECIPE}.pdf`);
الدرس بخط Iansui، وهو خط Kai مرسوم من Klee One على صيغ الحروف المعيارية في تايوان، وهي التي يتعلم الأطفال كتابتها. والقراءات بخط LXGW WenKai TC، الذي تبقى نقطة نبرته المحايدة مستديرة بحجم 4.8 pt، والحواشي بخط Noto Serif TC، والتسميات بخط Noto Sans TC. يحمّل كل خط الملفات التي تحتوي الحروف التي ينضّدها: تُفصل القراءات عن حروفها، وتذهب إطارات الحواشي إلى خط Ming وحده. ويضيف vertical: true الصيغ العمودية، فيقف 「」 و、 كما ينبغي نزولًا في العمود. ويجعل pageIndexOffset: 1 الصفحة 86 صفحة زوجية، فيُفتتح الدرس على صفحتين متقابلتين.
#4 · اللسان وأرقام الصفحات على الحافة الخارجية
// The verso lies on the right of the spread, so even pages carry both at the right edge.
const tab = (parity, edge) => [
{ kind: 'box', id: `tab-${parity}`, parity, pages: 'all',
placement: { anchor: { to: 'page', edge }, offset: { y: mm(24) },
size: { width: mm(9), height: mm(64) } }, style: { backgroundColor: col('accent') } },
{ kind: 'text', id: `unit-${parity}`, content: '第三單元 寓言故事', parity, pages: 'all',
writingMode: 'vertical-rl', fontFamily: HEI, fontSize: pt(9), fontWeight: 700,
color: col('paper'), align: 'center', verticalAlign: 'middle',
placement: { anchor: { to: `#tab-${parity}`, edge: 'align-top' },
size: { width: mm(9), height: mm(64) } } },
];
const foot = (id, parity, edge, x, content, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'all', fontFamily: HEI, fontSize: pt(8),
color: col('muted'), placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-9) } },
...extra,
});
const folio = { fontSize: pt(9), fontWeight: 700 };
const header = { elements: [...tab('even', 'top-right'), ...tab('odd', 'top-left')] };
const footer = {
elements: [
foot('folio-even', 'even', 'bottom-right', -16, '{pageNumber}', folio),
foot('book', 'even', 'bottom-right', -26, '國語 第九冊'),
foot('folio-odd', 'odd', 'bottom-left', 16, '{pageNumber}', folio),
foot('lesson', 'odd', 'bottom-left', 26, '{chapterNumber} {chapterTitle}'),
],
};
في كتاب مجلد على اليمين تقع الصفحة الزوجية على يمين الصفحتين المتقابلتين، فيقع لسان الوحدة ورقم الصفحة على الحافة اليمنى في الصفحات الزوجية، وعلى اليسرى في الفردية. واللسان صندوق فوقه عنصر نصي؛ يضع writingMode: 'vertical-rl' في العنصر 第三單元 寓言故事 نزولًا على اللسان، بينما تبقى أرقام الصفحات وأسطر التذييل أفقية. وتأتي أرقام الدرس والحكايتين من numberingTemplate في العناوين (第{1:一}課 و{2:一}، بمسافة إيديوغرافية في numberSeparator و{startAt=12} على عنوان الدرس)، منفصلة عن العنوان، فتبقى قراءة 寓 فوق 寓 وحده؛ ويطبع سطر تذييل الصفحات الفردية {chapterNumber} {chapterTitle}، لأن {chapterTitle} لا يتضمن الرقم.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 080 · A vertical reader with zhuyin to the right ═════════
// https://postext.dev/en/cookbook/zhuyin-vertical-reader
// Code: MIT · Text: Han Feizi, zh.wikisource (CC BY-SA 4.0) · Pictures: diffusion models
// Fonts: Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1) · 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 sample document ('en' | 'es')
const RECIPE = 'zhuyin-vertical-reader';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, every one linked by id
const palette = {
ink: '#2b2520', // text and zhuyin
accent: '#b83f28', // lesson title, labels, the unit's tab (4.9:1 on the tint)
tint: '#f7efdf', // the boxes of the upper tier
muted: '#72675b', // lead, folios, colophon
paper: '#ffffff', // the lettering on the tab
};
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 KAI = 'Iansui'; // 楷: the lesson, drawn to Taiwan's standard forms (為, not 爲)
const ZHUYIN = 'LXGW WenKai TC'; // the readings: a round dot for the neutral tone
const MING = 'Noto Serif TC'; // 明: notes and the author box
const HEI = 'Noto Sans TC'; // 黑: labels, folios, the tab
const SIZE = 16; // the text size (三號)
// #region answer: vertical text with a zhuyin column right of every character
const layout = {
writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
sideColumnPercent: 34,
gutterWidth: pt(2 * SIZE),
};
const cjk = {
// The lower tier: 23 characters down, 13 lines across the page.
grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
// Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
// so three symbols fit beside one character, and beside each of two in a row.
ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#اطبع الزهويين بلون ثانٍ
بعض كتب القراءة تطبع القراءات أفتح من النص، فتبرز الحروف.
- ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
+ ruby: { fontFamily: ZHUYIN, fontSize: em(0.5), color: col('muted') },#ضع القراءات فوق نص أفقي
ينضّد كتاب البينيين الأول مقطعًا صوتيًا واحدًا فوق كل حرف على عرض الصفحة، كما تفعل كتب القراءة الأولى في البر الرئيسي وهونغ كونغ.
أخطاء شائعة
خطأ شائع
القراءات تُطبع في النص، لا في التصاميم ولا في التعليقات ولا في الخلايا
تُرسَم قراءات ruby في الفقرات والعناوين وبنود القوائم والاقتباسات والإطارات. أما عنصر نص التصميم (افتتاحية، ترويسة، شارة)، والتعليق، والحاشية السفلية، وخلية الجدول، فتطبع الحروف الأساسية دون قراءاتها. العنوان الذي يحتاج إلى pinyin الخاص به عنوانٌ بلا تصميم خاص به: ارسم ما يحيط به (شريط، رقم الدرس) بتصميم العنوان الذي قبله، الذي تُرسَم عناصره ذات reserve: false تحت نص افتتاحية span: 'page'. قراءات ruby: pinyin وzhuyin →
خطأ شائع
في النص العمودي يصير العمود الجانبي طبقة، و'left' هي العليا
مع layout.writingMode 'vertical-rl' تكون الصفحة صفحة أفقية مُدارة ربع دورة، فيصير العمود الجانبي في تخطيط oneAndHalf طبقة عبر الصفحة: sideColumnSide 'left' يضعها في الرأس، موضع تعليقات الهامش العلوي (眉批)، و'right' في الأسفل. وتُقرأ 'outer' و'inner' على أنهما 'right' و'left' (فلا حافة خارجية للطبقة)، فالقيمة 'outer' لعمود هامش الكتاب المدرسي ترسل الحواشي إلى الأسفل. وsideColumnPercent نسبة من ارتفاع الصفحة. عمود هامشي للعناصر العائمة →
خطأ شائع
الخطوط الصينية تُحمَّل شرائح، عبر الكتلة 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]. كتب مجلّدة من اليمين →
خطأ شائع
اوسم المستند بـ 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). تقسيم الأسطر في النص الصيني →
-
خذ القراءات من قاموس تايوان. فالأدوات المبنية على قواميس البر الرئيسي، ومنها pypinyin، تعطي 度 duó و寧 nìng و時候 shíhou و市場 shìchǎng؛ أما Revised Mandarin Chinese Dictionary الصادر عن وزارة التعليم، الذي تتبعه كتب القراءة في تايوان، فيقرأ ㄉㄨㄛˋ وㄋㄧㄥˊ وㄕˊ ㄏㄡˋ وㄕˋ ㄔㄤˊ، ويضع 故事 و家裡 و過來 بمقطع ثانٍ محايد النبرة. ويقدّمه moedict.tw كلمة كلمة. وهو يُبقي 一 و不 بنبرتهما الأصلية، وكذلك يفعل هذا الدرس.
-
ارسم بعض الحروف بكل خط قبل أن تمزج الخطوط. يتبع LXGW WenKai TC الصيغ الموروثة ويرسم 為 (U+70BA) على هيئة 爲، فطبع درس منضد به 爲宋國笑 في النص و為宋國笑 في حاشية Ming على الصفحتين المتقابلتين نفسيهما. أما Iansui فيرسم 為 المعيارية.
-
لخط Iansui وزن واحد. تبرز العناوين بالحجم والمداخل الاصطلاحية باللون: يضبط نمط
idiomالقيمةboldFontWeight: 400ويجعل اللونَ المميِّز قيمةَboldColor، فيغيّر**…**اللون لا الخط.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- Han Feizi, chapter 49, “Wu du” (The five vermin): the man of Song who waited by the stump · Han Fei; transcription and punctuation by Wikisource editors (爲 set as 為, the Taiwan standard form) · CC BY-SA 4.0
- Han Feizi, chapter 32, “Wai chu shuo zuo shang”: the man of Zheng who went to buy shoes · Han Fei; transcription and punctuation by Wikisource editors · CC BY-SA 4.0
- The zhuyin (checked against the Ministry of Education's Revised Mandarin Chinese Dictionary), the modern Chinese versions, the notes, the author box, the lead and the exercises, written for this recipe · Postext Cookbook · CC BY 4.0
- الصور
- The farmer waiting by the stump, a brush painting · Generated With Diffusion Models · أصلي
- The man of Zheng hurrying home from the shoe stall, a brush painting · Generated With Diffusion Models · أصلي
- الخطوط
- Iansui (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


