انتقل إلى المحتوى الرئيسي
الوصفة رقم 76

دليل الوصفات · الفصل 2 · الحروف والنص

كتاب قراءة بالبينيين: النطق فوق كل حرف

روبي أحادي في كتاب قراءة أول من هونغ كونغ: {人之初|rén zhī chū} يضع مقطع بينيين واحدًا في الوسط فوق كل حرف، بخط Andika، داخل فجوة أسطر من 28 نقطة.

في هذه الصفحة
المُخرَج
Canvas
المستوى
متوسط
Postext
اختُبرت مع Postext 1.65.0
تتطلب ≥ 1.25.0
الترخيص
حُدّثت في 10 أكتوبر 2026
الشيفرة MIT · النص CC BY 4.0

ص 36–37 · 1–2 من 4

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 184 × 260 مم
  • عمود واحد
  • LXGW WenKai TC 26/54
  • Andika
  • Noto Sans TC
  • 4 صفحات
  • المستوى
  • Postext 1.57.1
  • أُخرجت في 73 ms
  • أسطر الشيفرة: 180

باختصار

صفحات من كتاب قراءة أول للأطفال في هونغ كونغ. يبيّن كيف يُطبع النطق بالحروف اللاتينية فوق كل حرف صيني، مع مربعات للتدرّب على الكتابة.

ما الذي ستنضده

صفحتان متقابلتان مرتين من 《蒙學誦讀》، كتاب قراءة أول متخيَّل من هونغ كونغ، حيث يقرأ الأطفال Three Character Classic (كتاب الحروف الثلاثة) بصوت عالٍ بلغة البوتونغهوا. كل صفحة درس من أربعة أبيات مزدوجة بخط Kai بحجم 一号 (26 نقطة)، وكل حرف تحت مقطع البينيين الخاص به. تُنضَّد المقاطع بخط Andika لأنه يرسم الحرفين a وg بطابق واحد كما تطبعهما الكتب المدرسية الصينية. وعلى شريط شاحب شارة درس حمراء، ولوحة مائية صغيرة، والعنوان بحجم 初号 (42 نقطة) بنطقه الخاص. وتحت النص ستة مربعات كتابة (田字格) فيها الحروف المطلوب نسخها، وملاحظة تشرح للأسرة معنى الأبيات. ونظيره الإسباني هو كتاب القراءة بشارات المقاطع، حيث كل مقطع شارة ملوّنة بدل نطق فوق حرف.

يخرج كتاب القراءة الأول عن قواعد الكتاب الصيني عن قصد. يقرأ الطفل حروفًا كبيرة قليلة في كل مرة، فيتسع السطر لاثني عشر حرفًا بحجم 26 نقطة، حيث ينضّد الكتاب من 25 إلى 40 بحجم 10.5 نقطة، ويزيد تباعد الأسطر قليلًا على ضعف الحجم ليتسع للنطق. ويقف كل بيت مزدوج في وسط سطر خاص به، لا مضبوطًا ولا بإزاحة. والنص بخط Kai، الخط الذي يتبع الفرشاة، لأنه يُظهر الضربات التي يتعلم الطفل كتابتها؛ أما الكتاب فكان سينضّده بخط Song.

تجيب هذه الوصفة عن

  • كيف أضيف البينيين فوق الحروف الصينية؟

الجواب المختصر

script.js · الأسطر 36–56في الشيفرة الكاملة
// {人之初|rén zhī chū} gives each character its own syllable (mono ruby): three readings for
// three characters, split on the spaces. The reading sits in the line gap, centred on its
// character; a syllable wider than the character widens that character's box by what the
// reading needs, less the quarter of the reading's size it may lend a neighbour.
const cjk = {
  // The type area in characters: 12 per line, 11 lines of 54 pt. The margins grow to centre it.
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 11 },
  ruby: {
    fontFamily: PINYIN, // one-storey a and g, as a Chinese primer prints them
    // 9.9 pt over the text, 16 pt over the title: the widest syllables (xiāng, zhuān) still fit
    // over one character, so every couplet is 8 em long and keeps to the grid.
    fontSize: em(0.38),
    color: col('pinyin'),
  },
};
// The line pitch never changes for a reading: the gap between lines (54 − 26 = 28 pt) must
// hold it, or the build warns rubyExceedsLeading.
const text = {
  fontFamily: KAI, fontSize: pt(TEXT), lineHeight: pt(LINE),
  textAlign: 'center', firstLineIndent: pt(0), // one couplet to a line, centred
};

المكونات

الخطوط
LXGW WenKai TC, Noto Sans TC, Andika (SIL OFL 1.1)
الأصول
  • brush-800.jpg
  • jade-800.jpg
  • shuttle-800.jpg
  • sprout-800.jpg
  • The writing squares, drawn in code in the page’s palette (Postext Cookbook, CC BY 4.0)
  • Lesson 1’s vignette: a seedling, a watercolour (Generated With Diffusion Models, أصلي)
  • Lesson 2’s vignette: the shuttle of a loom, a watercolour (Generated With Diffusion Models, أصلي)
  • Lesson 3’s vignette: a brush and its first stroke, a watercolour (Generated With Diffusion Models, أصلي)
  • Lesson 4’s vignette: a jade disc on a red cord, a watercolour (Generated With Diffusion Models, أصلي)

طريقة التحضير

#1 · مقطع فوق كل حرف

الشيفرة هي الجواب المختصر أعلاه. يضع {人之初|rén zhī chū} فوق ثلاثة حروف ثلاثة أنطاق، مقسومة عند المسافات: كل مقطع في الوسط فوق حرفه، ويجوز أن ينكسر السطر بينها. لا يأخذ النطق مكانًا خاصًا به. إنه يجلس في فجوة الأسطر، 54 − 26 = 28 نقطة هنا، وإذا كانت الفجوة أضيق من النطق ظهر التحذير rubyExceedsLeading. أما المقطع الأعرض من حرفه فيأخذ مكانًا: يوسّع مربع ذلك الحرف، وفي سطر موسَّط تنزاح الحروف التالية عن الشبكة. لذا نُضّدت الأنطاق بالحجم الذي يظل فيه أعرض المقاطع هنا، xiāng وzhuān، يتسع فوق حرف واحد، أي 0.38 em (9.9 نقطة): كل بيت مزدوج طوله ثمانية حروف ويحتفظ كل حرف بمربعه. وبحجم 0.45 em كان 性相近,習相遠 سيتمدد إلى ثمانية حروف ونصف ويفتح فجوات حول 相.

#2 · العنوان يحتفظ بنطقه

script.js · الأسطر 60–77في الشيفرة الكاملة
const BAND = 68; // mm from the top edge
// Heading designs ignore parity: a place for the drawing on each side, 14 mm from the outer
// edge, named {left="…"} on a verso and {right="…"} on a recto. A missing attribute draws nothing.
const picture = (side, x) => ({ kind: 'image', id: `picture-${side}`,
  resourceId: `{attr.${side}}`, decorative: true, reserve: false,
  placement: { anchor: { to: 'page', edge: `top-${side}` }, offset: { x: mm(x), y: mm(14) },
    size: { width: mm(42), height: mm(42) } } });
const opener = { enabled: true, slot: { elements: [
  { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
    placement: { anchor: { to: 'page', edge: 'top-left' },
      size: { width: mm(184), height: mm(BAND) } } },
  picture('left', 14), picture('right', -14),
  { kind: 'text', id: 'lesson', content: '{titleText}', fontFamily: HEI, fontSize: pt(11),
    fontWeight: 700, letterSpacing: pt(2), color: col('paper'), align: 'center', overflow: 'wrap',
    placement: { anchor: { to: 'container', edge: 'top' } },
    box: { backgroundColor: col('red'), borderRadius: mm(3.5),
      padding: { top: mm(1.2), right: mm(3.6), bottom: mm(1.2), left: mm(3.6) } } },
] } };

نص التصميم لا يطبع أنطاقًا، فلا يمكن أن يأتي العنوان من تصميم صفحة الافتتاح. عنوان المستوى الأول، 第一課، يرسم الشريط والصورة والشارة الحمراء؛ أما العنوان فهو عنوان المستوى الثاني تحته، عنوان عادي بحجم 初号 ينضّده منضِّد النص مع البينيين الخاص به. ويُخرج reserve: false الشريط والصورة من ارتفاع العنوان، ويرسمهما span: 'page' تحت النص.

تصميم العنوان يتجاهل parity، فللصورة عنصر على كل جانب من الصفحة: {attr.left} على بعد 14 مم من الحافة اليسرى و{attr.right} على بعد 14 مم من اليمنى. تكتب الدروس التي على الصفحات الزوجية # 第一課 {left="sprout"} والتي على الصفحات الفردية {right="shuttle"}، فتجلس كل صورة على الجانب الخارجي من الصفحتين المتقابلتين؛ والعنصر الذي تغيب سمته لا يرسم شيئًا.

#3 · ستة مربعات من سمة واحدة

script.js · الأسطر 81–101في الشيفرة الكاملة
// Design text prints no readings, so the squares hold the characters alone. A Han character
// is one em wide, so tracking of (pitch − em) sets one in the middle of each square.
const [SQ, GAP, WRITE] = [15, 3.4, 30]; // mm, mm, pt
const ROW = 6 * SQ + 5 * GAP; // mm
const X0 = (MEASURE - ROW) / 2; // the row is centred on the measure
const EM = WRITE * 25.4 / 72; // mm: one character at 30 pt, 10.6 mm wide
const squares = { enabled: true, slot: { elements: [
  { kind: 'text', id: 'label', content: '{titleText}', fontFamily: HEI, fontSize: pt(10),
    fontWeight: 700, letterSpacing: pt(1.5), color: col('red'), align: 'left', overflow: 'wrap',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { x: mm(X0) } } },
  ...Array.from({ length: 6 }, (_, k) => ({ kind: 'image', id: `square${k}`, resourceId: 'tian',
    decorative: true, placement: { anchor: { to: 'container', edge: 'top-left' },
      offset: { x: mm(X0 + k * (SQ + GAP)), y: mm(7) },
      size: { width: mm(SQ), height: mm(SQ) } } })),
  { kind: 'text', id: 'chars', content: '{attr.write}', fontFamily: KAI, fontSize: pt(WRITE),
    lineHeight: 1, letterSpacing: mm(SQ + GAP - EM), color: col('ink'), align: 'left',
    verticalAlign: 'middle', overflow: 'clip',
    placement: { anchor: { to: 'container', edge: 'top-left' },
      offset: { x: mm(X0 + (SQ - EM) / 2), y: mm(7) },
      size: { width: mm(ROW + GAP), height: mm(SQ) } } },
] } };

يمرّر ### 我會寫 {write="人之本不相以"} إلى التصميم الحروفَ الستة في سمة واحدة. كل حرف هاني في LXGW WenKai TC عرضه em واحد، فتباعدُ حروفٍ قدره خطوة المربعات ناقص em واحد (18.4 − 10.6 مم) ينقل الحروف من مربع إلى مربع، ويملأ عنصر نصي واحد الصف. والمربع ملف SVG مرسوم بالشيفرة: إطار أحمر وصليب متقطع.

#4 · كل خط يحمّل حروفه

script.js · الأسطر 282–289في الشيفرة الكاملة
// Fontsource cuts a Chinese face into about a hundred files by character range
// (gotcha: cjk-fonts-slices). The Kai sets the whole sample; the Hei only the headings'
// labels and the footer's series line, so it fetches a few files.
const labels = (markdown.match(/^#{1,3} [^{\n]*/gm) ?? []).join('') + '蒙學誦讀 第一冊';
await loadFonts(FONTS, markdown); // the latin files, and Andika's latin-ext for ǎ ǐ ǒ ǔ
await Promise.all([loadCjkFonts({ [KAI]: FONTS[KAI] }, markdown),
  loadCjkFonts({ [HEI]: FONTS[HEI] }, labels),
  loadSvg('tian.svg', tian), ...VIGNETTES.map((fileId) => loadImage(fileId, asset(fileId)))]);

يقطع Fontsource كل خط صيني إلى نحو مئة ملف بحسب نطاقات الحروف. خط Kai ينضّد النموذج كله ويحمّل الملفات التي فيها حروفه. وخط Hei لا ينضّد إلا الشارات والتسميات والتذييل، فيأخذ ذلك النص ويجلب ملفات قليلة. ويأتي Andika من loadFonts، الذي يضيف ملف latin-ext حين يحتوي النص حروفًا خارج Latin-1، كما هو حال ǎ وǐ.

#5 · ترقيم هونغ كونغ من الإعداد المحلي

script.js · الأسطر 121–123في الشيفرة الكاملة
  // Punctuation at full width, where LXGW WenKai TC centres it as Hong Kong and Taiwan print
  // it, and the basic line-breaking rules. Written out, never LANG (gotcha: cjk-locale-tag).
  locale: 'zh-HK',

يضع zh-HK قواعد هونغ كونغ: علامات ترقيم بعرض كامل وقواعد كسر الأسطر الأساسية، التي لا يحتاجها أي بيت مزدوج هنا. يرسم LXGW WenKai TC فواصله ونقاطه في وسط المربع، كما تطبعها هونغ كونغ وتايوان، ولهذا يأتي كتاب القراءة هذا من هونغ كونغ. أما كتاب القراءة الأول في البر الصيني فيُنضَّد بخط Kai أيضًا، بالحروف المبسّطة مع الفاصلة والنقطة في أسفل يسار المربع. غير أن Fontsource ليس فيه خط نص Kai للصينية المبسّطة، والخط التقليدي كان سيحشر تلك العلامات بالحرف التالي، لذا تأخذ صفحة البر الصيني في دليل الوصفات هذا خط Noto Serif SC، خط Song في صفحة الرواية من البر الصيني.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 076 · A pinyin primer: readings over every character ═══
// https://postext.dev/en/cookbook/pinyin-primer
// Code: MIT · Text: 三字經 (PD); pinyin, notes: CC BY 4.0 · Vignettes: diffusion models
// Fonts: LXGW WenKai TC, Noto Sans TC, Andika (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'pinyin-primer';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a primer's colours, every one linked by id
const palette = {
  ink: '#29241f', // the characters: a warm near-black
  pinyin: '#355a4d', // the readings, a shade off the ink so the two layers part
  red: '#bf3a2b', // lesson badges and the writing squares
  jade: '#2f7a5e', // the folio discs
  tint: '#edf4ea', // the band behind each lesson's title
  cream: '#faf3e4', // the note for families
  muted: '#6d665e', // series line, colophon
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the red.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [KAI, HEI, PINYIN] = ['LXGW WenKai TC', 'Noto Sans TC', 'Andika'];
const TEXT = 26; // pt: 一号, the size of a first reader's text
const LINE = 54; // pt: 2.1 × the size, so a reading fits between two lines
const CHARS = 12; // characters per line: the measure is 12 × 26 pt = 110 mm
const MEASURE = CHARS * TEXT * 25.4 / 72; // mm

// #region answer: one reading per character, in Andika, in a line gap wide enough to hold it
// {人之初|rén zhī chū} gives each character its own syllable (mono ruby): three readings for
// three characters, split on the spaces. The reading sits in the line gap, centred on its
// character; a syllable wider than the character widens that character's box by what the
// reading needs, less the quarter of the reading's size it may lend a neighbour.
const cjk = {
  // The type area in characters: 12 per line, 11 lines of 54 pt. The margins grow to centre it.
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 11 },
  ruby: {
    fontFamily: PINYIN, // one-storey a and g, as a Chinese primer prints them
    // 9.9 pt over the text, 16 pt over the title: the widest syllables (xiāng, zhuān) still fit
    // over one character, so every couplet is 8 em long and keeps to the grid.
    fontSize: em(0.38),
    color: col('pinyin'),

يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)

تنويعات

#أظهر الشبكة في أثناء تنضيد الصفحة

يرسم show: true المربعات الاثني عشر لكل سطر في Canvas؛ ويتركها ملف PDF ما لم يُعطَ renderToPdf الخيار characterGrid: true.

-  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 11 },
+  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 11, show: true },

#ضع الجويين بجوار الحروف

أنطاق البوبوموفو تقف في عمود على يمين كل حرف؛ وينضّدها كتاب القراءة بالجويين نزولًا في صفحة عمودية.

أخطاء شائعة

خطأ شائع

القراءات تُطبع في النص، لا في التصاميم ولا في التعليقات ولا في الخلايا

تُرسَم قراءات ruby في الفقرات والعناوين وبنود القوائم والاقتباسات والإطارات. أما عنصر نص التصميم (افتتاحية، ترويسة، شارة)، والتعليق، والحاشية السفلية، وخلية الجدول، فتطبع الحروف الأساسية دون قراءاتها. العنوان الذي يحتاج إلى pinyin الخاص به عنوانٌ بلا تصميم خاص به: ارسم ما يحيط به (شريط، رقم الدرس) بتصميم العنوان الذي قبله، الذي تُرسَم عناصره ذات reserve: false تحت نص افتتاحية span: 'page'. قراءات ruby: pinyin وzhuyin →

خطأ شائع

ضع ترقيم كل منطقة بخط من تلك المنطقة

تنقل عروض علامات الترقيم الفراغ الذي بجانب كل علامة إلى الجهة التي تضعه فيها منطقة المستند، لا الجهة التي يرسمه فيها الخط: مع zh-Hans تحتفظ فاصلة Kaiming بالنصف الأيسر من إطارها، حيث يرسم الخط المبسط الحرف، وتتخلى عن النصف الأيمن. أما الخط التقليدي فيضع ,。 في وسط الإطار، فيحمل النصف المحذوف جزءًا من الحرف وتزاحم الفاصلةُ الحرفَ التالي. وهذا ما يفعله LXGW WenKai TC، وهو خط Kai النصي الوحيد في Fontsource، في النص المبسط. ضع نص البر الرئيسي وحواشيه واقتباساته بـ Noto Serif SC أو Noto Sans SC، واحتفظ بخطوط TC للنص zh-Hant، ولا تستخدم خط فرشاة مبسطًا (Ma Shan Zheng) إلا لأسطر العرض، حيث لا يطبّق نص التصميم عروض الترقيم. كما يرسم ذلك الخط أشكالًا موروثة لا يطبعها معيار البر الرئيسي ولا معيار تايوان، 為 برأس 爫 الذي في 爲، و令 (في 冷 و領) بقاعدة 卩: افحص الحروف التي تضعها الصفحة به. عروض علامات الترقيم الصينية →

خطأ شائع

الخطوط الصينية تُحمَّل شرائح، عبر الكتلة cjk

يقدّم Fontsource العائلة الصينية أو اليابانية أو الكورية في نحو مئة ملف لكل وزن، يغطي كل منها نطاقًا من الحروف. لا يجلب loadFonts إلا ملف latin، فتأتي حروف الهان على الشاشة من خط النظام وتُقاس خطأً، ويسلّم fontsourceProvider ملف latin ذاك إلى PDF، فيطبعها مربعات فارغة. اذكر كتلة الأدوات cjk، واستدعِ loadCjkFonts(FONTS, markdown) بعد loadFonts (مرة لكل صوت، مع النص الذي يضعه، حين يستخدم الكتاب عدة خطوط CJK)، وأعطِ renderToPdf القيمة fontProvider: cjkPdfProvider: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →

خطأ شائع

اوسم المستند بـ 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). تقسيم الأسطر في النص الصيني →

تحذير الإخراج · rubyExceedsLeading

القراءات تزاحم السطر التالي

السبب. فقرة فيها قراءات روبي فوق نصها أو تحته، وفراغها بين الأسطر أضيق من القراءات: فهي تقع في تباعد الأسطر وتلامس السطر المجاور.

الحل. نضّد الفقرة بتباعد أسطر أكبر (حجم النص مضافًا إليه `cjk.ruby.fontSize` على الأقل)، أو صغّر القراءات. التوثيق →

  • لا تقدّم هذه الوصفة ملف PDF. فـfontsourceProvider في العُدّة لا يضمّن إلا ملف latin للخط، وحروف النغمات ā ǎ ǐ ǒ ǔ في latin-ext، فكان ملف PDF سيفقدها وكان postext-pdf سيُصدر لكلٍّ منها التحذير missingGlyph. إن احتجت إليه، فنضّد الأنطاق بخط صيني، يختار cjkPdfProvider ملفاته حرفًا حرفًا.

  • طابق كل حرف في المربعات مع الأشكال المعيارية للمنطقة. يرسم LXGW WenKai TC الحرف 為 بأعلى 爫 من 爲، شكلٌ أقدم يمرّ في النص الجاري، كما في 老何為 و為人子 هنا، لكن لا في مربع ينسخه طفل في هونغ كونغ. لذا يتدرّب الدرس الثالث على 幼 بدلًا منه.

الحقوق

الوصفة
Ignacio Ferro
النص
الصور
  • The writing squares, drawn in code in the page’s palette · Postext Cookbook · CC BY 4.0
  • Lesson 1’s vignette: a seedling, a watercolour · Generated With Diffusion Models · أصلي
  • Lesson 2’s vignette: the shuttle of a loom, a watercolour · Generated With Diffusion Models · أصلي
  • Lesson 3’s vignette: a brush and its first stroke, a watercolour · Generated With Diffusion Models · أصلي
  • Lesson 4’s vignette: a jade disc on a red cord, a watercolour · Generated With Diffusion Models · أصلي
الخطوط
LXGW WenKai TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · Andika (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox