باختصار
صفحة من كتاب قراءة مدرسي ياباني، فوق كل كانجي فيها كانا صغيرة ليقرأها الطفل بصوت عالٍ. يضع Postext كل قراءة فوق حروفها، ويسمح للقراءة الطويلة بأن تميل على الكانا المجاورة، لا على كانجي آخر.
ما الذي ستنضده
الصفحات الأولى من «غون الثعلب» (ごんぎつね، 1932) لنييمي نانكيتشي كما يطبعها كتاب القراءة للسنة الرابعة، وهي القصة التي يلقاها كل طفل ياباني في التاسعة أو العاشرة. تتسع صفحة B5 لثمانية وعشرين حرفًا في واحد وعشرين سطرًا بخط Klee One، المرسوم على طريقة يد الكتب المدرسية، بحجم 14 نقطة على سطر من 28 نقطة، وفوق كل كانجي قراءة بكانا صغيرة. والقراءات هي موضوع الصفحة: قراءة لكل حرف فوق 村 و森، وقراءة للكلمة كلها فوق 百舌鳥 (mozu)، التي لا قراءة لحروفها منفردة، وقراءات jukugo فوق 兵十 (Hyōjū)، كلٌّ منها فوق الكانجي الخاص به إلى أن تطول إحداها عن حرفها. ويعرض إطار في آخر الصفحات الحالات الثلاث للمعلّم. ويضع كتاب القراءة بالبينيين القراءات الصينية فوق كل حرف بالطريقة نفسها.
تجيب هذه الوصفة عن
- كيف أضيف الفوريغانا فوق الكانجي، قراءة لكل حرف أو قراءة واحدة للكلمة كلها؟
الجواب المختصر
// In a document tagged 'ja' the compact {漢字|かん|じ} (one reading per character) is jukugo
// ruby: each reading stays over its own kanji when it fits, and when one is longer it may run
// onto the next kanji of the same word; a break may fall between the two. {百舌鳥|もず} (one
// reading for the word) is group ruby, spread over the word 1:2:1. :ruby[菜種]{rt="な たね"
// mode=jukugo} says the same as the compact form; mode=mono keeps each reading to its kanji.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
ruby: {
fontSize: em(0.5), // 7 pt: half the text, the size JLReq gives furigana
color: col('reading'),
align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
overhang: 'kana', // a longer reading may run one ruby character onto a kana, never a kanji
smallKana: 'keep', // ひょう with its small ょ, as today's books print it
},
};
// The line gap (28 − 14 = 14 pt) holds a 7 pt reading with room to spare: no line moves for one.
const bodyText = {
fontFamily: TEXT, fontSize: pt(SIZE), lineHeight: pt(PITCH), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1), indentAfterHeading: true,
avoidRunts: true, // no paragraph ends on one character
};
المكونات
- الميزات
- فوريغانا: قراءات الكانا فوق الكانجيقراءات ruby: pinyin وzhuyinالكانا والكانجي والروماجيعلامات التوكيد اليابانية (bōten)الخطوط الصينية واليابانية والكوريةشبكة المحارفتباعد علامات الترقيم اليابانية (yakumono)كسر الأسطر الياباني (kinsoku)عناوين تشغل أسطرًا من المتن (gyōdori)صفحات افتتاح مصمَّمةسمات العنوانإطارات التنبيهالترويسات وأرقام الصفحاتهوامش متناظرةلون الورقأنماط الفقراتلوحة ألوان دلاليةاستيراد نصوص Aozora Bunkoالتصدير إلى PDF
- تستخدم أيضًا
- تقسيم الأسطر في النص الصينيموازنة الأعمدةنقاط التوكيد وخطوط الأعلام والعناوينالخروج عن الشبكة عمدًاالخطوط المضمَّنة في PDF
- الخطوط
- Klee One, Zen Maru Gothic (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · ثلاث طرق لكتابة القراءة
الشيفرة هي الجواب المختصر أعلاه. في Markdown يضع {村|むら} むら فوق 村، ويضع {兵十|ひょう|じゅう} فوق كل كانجي قراءته. وفي مستند موسوم 'ja' يكون هذا روبي jukugo: تبقى القراءات فوق حروفها ما دامت تتسع، ويجوز للقراءة الأطول أن تميل على الكانجي التالي من الكلمة نفسها، لا على كانجي من كلمة أخرى. أما {百舌鳥|もず}، قراءة واحدة لثلاثة كانجي، فروبي جماعي يتوزع على الكلمة كلها. ويكتب :ruby[菜種]{rt="な たね" mode=jukugo} آخر أمثلة الإطار بصيغة التوجيه، التي تقبل أيضًا mode=mono وalign (العلامات والروبي والواريتشو).

#2 · نسبة 1:2:1، وقراءات لا تميل إلا على الكانا
الإعدادان تحت cjk.ruby هما ما تختاره 'ja' بنفسها. يضبط align: 'jis' القراءة الأقصر من أساسها على طريقة JIS X 4051: نصف وحدة فراغ عند كل طرف ووحدة كاملة بين حروف الكانا، فتقع も وず فوق مواضع التقاء حروف 百舌鳥 في الصفحة 25 بدل أن تتجمّع في وسطها. ويسمح overhang: 'kana' للقراءة الأطول من أساسها بأن تمتد بمقدار حرف روبي واحد على الأكثر فوق كانا مجاورة أو فوق بياض علامة ترقيم، ولا تمتد فوق كانجي أبدًا: ぎつね فوق 狐 في 「ごん狐」 تميل على ん وعلى القوس بعده، وじゅう في 兵十だな تميل على だ. وحيث لا كانا تميل عليها، تتباعد حروف الكانجي حتى تبلغ عرض القراءة. وعند طرف السطر تبقى القراءة داخل عرضه.

#3 · فجوة أسطر تتسع للقراءات
القراءات بحجم 7 نقاط، أي نصف النص البالغ 14 نقطة، والسطر 28 نقطة، فتتسع لها النقاط الأربع عشرة بين السطرين ويبقى فائض، ويظل كل سطر من الشبكة في موضعه. وإذا ضُبطت خطوة الأسطر أضيق من النص مع قراءاته، أصدر البناء التحذير rubyExceedsLeading.
#4 · صفحة الافتتاح لا تطبع قراءات
// Design text sets no furigana (gotcha: ruby-not-in-designs): the author's reading is a
// line of its own.
const BAND = 92; // mm from the trim's top
const opener = { enabled: true, minHeight: pt(PITCH * 6), slot: { elements: [
{ kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('straw') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'text', id: 'unit', content: '{attr.unit}', fontFamily: ROUND, fontSize: pt(16),
fontWeight: 700, color: col('paper'), align: 'center', verticalAlign: 'middle',
overflow: 'clip', box: { backgroundColor: col('red'), borderRadius: mm(6) },
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(-2) },
size: { width: mm(12), height: mm(12) } } },
{ kind: 'text', id: 'series', content: '{title}', fontFamily: ROUND, fontSize: pt(9),
fontWeight: 700, letterSpacing: pt(2), color: col('red'), align: 'left',
verticalAlign: 'middle', placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(16), y: mm(-2) }, size: { width: mm(80), height: mm(12) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: ROUND, fontSize: pt(48),
lineHeight: 1.1, fontWeight: 700, color: col('ink'), align: 'left',
placement: { anchor: { to: '#unit', edge: 'below' }, offset: { y: mm(7) } } },
{ kind: 'text', id: 'kana', content: '{attr.kana}', fontFamily: ROUND, fontSize: pt(8),
letterSpacing: pt(1), color: col('muted'), align: 'left',
placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(5) } } },
{ kind: 'text', id: 'author', content: '{attr.author} 作', fontFamily: ROUND,
fontSize: pt(13), fontWeight: 500, color: col('ink'), align: 'left',
placement: { anchor: { to: '#kana', edge: 'below' }, offset: { y: mm(1) } } },
] } };
العنوان واسم المؤلف نص تصميم، ونص التصميم لا ينضّد روبي، لذلك جاءت قراءة 新美南吉 سطرًا مستقلًا فوق الاسم، بالكانا، كما تطبعها كتب القراءة. والعنوان نفسه بالكانا، ごんぎつね، كما تكتبه كتب القراءة، مع أن نص Aozora يعنونه ごん狐.
#5 · لون مميِّز واحد، وقراءات أفتح بدرجة
const palette = {
ink: '#2a2420', // text: a warm near-black
red: '#b2402c', // the one accent: the unit badge, the section numbers, the box title
reading: '#5a4e45', // the furigana, a shade off the ink so the two layers part
straw: '#f6ecd6', // the opener band and the box
muted: '#7a6d62', // folios, the series line, the colophon
paper: '#fffdf8',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
تأخذ القراءات اللون reading، وهو بنيّ أفتح من الحبر بدرجة، فتميّز العين الطبقتين دون أن تبهت الكانا. ويلوّن أحمرُ زهور higanbana التي تتفتح في القصة الشارةَ ورقمَ القسم وعنوانَ الإطار.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 124 · A school reader with furigana: per character, per word ═══
// https://postext.dev/en/cookbook/jukugo-furigana-textbook
// Code: MIT · Text: 新美南吉「ごん狐」(1932), Aozora Bunko 628 (PD); readings: CC BY 4.0
// Fonts: Klee One, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the frame; the story is Japanese in both
const RECIPE = 'jukugo-furigana-textbook';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: an autumn reader: ink, the red of the higanbana, a pale straw ground
const palette = {
ink: '#2a2420', // text: a warm near-black
red: '#b2402c', // the one accent: the unit badge, the section numbers, the box title
reading: '#5a4e45', // the furigana, a shade off the ink so the two layers part
straw: '#f6ecd6', // the opener band and the box
muted: '#7a6d62', // folios, the series line, the colophon
paper: '#fffdf8',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, ROUND] = ['Klee One', 'Zen Maru Gothic']; // 教科書体-like text, rounded gothic
const [SIZE, PITCH] = [14, 28]; // pt: a fourth-year reader's size, on a line twice as tall
const [CHARS, LINES] = [28, 21]; // the type area in characters
// #region answer: readings over every kanji: by character, by word, jukugo, JIS 1:2:1
// In a document tagged 'ja' the compact {漢字|かん|じ} (one reading per character) is jukugo
// ruby: each reading stays over its own kanji when it fits, and when one is longer it may run
// onto the next kanji of the same word; a break may fall between the two. {百舌鳥|もず} (one
// reading for the word) is group ruby, spread over the word 1:2:1. :ruby[菜種]{rt="な たね"
// mode=jukugo} says the same as the compact form; mode=mono keeps each reading to its kanji.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
ruby: {
fontSize: em(0.5), // 7 pt: half the text, the size JLReq gives furigana
color: col('reading'),
align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
overhang: 'kana', // a longer reading may run one ruby character onto a kana, never a kanji
smallKana: 'keep', // ひょう with its small ょ, as today's books print it
},
};
// The line gap (28 − 14 = 14 pt) holds a 7 pt reading with room to spare: no line moves for one.
const bodyText = {
fontFamily: TEXT, fontSize: pt(SIZE), lineHeight: pt(PITCH), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#كانا بالحجم الكامل في القراءات
كانت الكتب القديمة تطبع っ وょ بالحجم الكامل في الروبي، がつこう بدل がっこう. ويفعل smallKana: 'full' الشيء نفسه، ويبقى النص الذي يُقرأ بصوت عالٍ ويُنسخ كما هو.
- smallKana: 'keep', // ひょう with its small ょ, as today's books print it
+ smallKana: 'full', // ひよう: the small kana at full size, as letterpress books printed them#وسّط كل قراءة
يضع align: 'center' القراءة القصيرة في وسط أساسها، كما تفعل معظم الكتب الصينية؛ أما الافتراض الياباني فنسبة 1:2:1.
- align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
+ align: 'center', // も ず together in the middle of 百舌鳥أخطاء شائعة
خطأ شائع
اوسم النص الياباني بـ 'ja'، لا بـ zh-Hans ولا بـ LANG
نسختا الوصفة هما en وes، لكن المثال الياباني ياباني في كلتيهما: `locale: LANG` سيسمه بالإنجليزية أو الإسبانية، والوسم الصيني سينضّده بالقواعد الصينية (ترقيم Kaiming، وكانا صغيرة يجوز أن تبدأ بها الأسطر، و图 بدل 図، وأشكال صينية للحروف في PDF). ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فكل وسم غير 'ja' يعطي أشكالًا للحروف غير اليابانية (الصينية منها مع وسم صيني) وكسرًا آخر للأسطر. اكتب 'ja': يختار منطقة اليابان (كسر الأسطر والترقيم وفق JLReq، ونقاط السمسم، وتوزيع الفوريغانا، وتسميتي 図 و表) ويوقف تقسيم الكلمات. ويُفشل الفحصُ نصًّا فيه كانا موسومًا بـ zh أو ko. كسر الأسطر الياباني (kinsoku) →
خطأ شائع
انضد اليابانية بخط ياباني
في Noto Serif SC وTC كانا، لكنهما ترسمان الكانجي بأشكال صينية (يختلف 直 و骨 و角) والكانا بتصميم صيني. انضد النص بـ Noto Serif JP أو Shippori Mincho B1 والعناوين بـ Noto Sans JP، محمَّلة بـ loadCjkFonts. لا تحوي ملفات Fontsource اليابانية الهينتايغانا ولا غيرها من الكانا التاريخية (U+1B000–1B16F): يفشل loadCjkFonts عندها ويطبع PDF مربعات، فاكتب الكانا الحديثة أو ضع في أصول الوصفة خطًّا يحويها. ولا يحوي Shippori Mincho أيضًا الصائتين ō وū بالمدّة: انضد الروماجي بخط لاتيني. الكانا والكانجي والروماجي →
خطأ شائع
الخطوط الصينية تُحمَّل شرائح، عبر الكتلة cjk
يقدّم Fontsource العائلة الصينية أو اليابانية أو الكورية في نحو مئة ملف لكل وزن، يغطي كل منها نطاقًا من الحروف. لا يجلب loadFonts إلا ملف latin، فتأتي حروف الهان على الشاشة من خط النظام وتُقاس خطأً، ويسلّم fontsourceProvider ملف latin ذاك إلى PDF، فيطبعها مربعات فارغة. اذكر كتلة الأدوات cjk، واستدعِ loadCjkFonts(FONTS, markdown) بعد loadFonts (مرة لكل صوت، مع النص الذي يضعه، حين يستخدم الكتاب عدة خطوط CJK)، وأعطِ renderToPdf القيمة fontProvider: cjkPdfProvider: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →
خطأ شائع
القراءات تُطبع في النص، لا في التصاميم ولا في التعليقات ولا في الخلايا
تُرسَم قراءات ruby في الفقرات والعناوين وبنود القوائم والاقتباسات والإطارات. أما عنصر نص التصميم (افتتاحية، ترويسة، شارة)، والتعليق، والحاشية السفلية، وخلية الجدول، فتطبع الحروف الأساسية دون قراءاتها. العنوان الذي يحتاج إلى pinyin الخاص به عنوانٌ بلا تصميم خاص به: ارسم ما يحيط به (شريط، رقم الدرس) بتصميم العنوان الذي قبله، الذي تُرسَم عناصره ذات reserve: false تحت نص افتتاحية span: 'page'. قراءات ruby: pinyin وzhuyin →
خطأ شائع
اقرأ ملفات Aozora بترميز CP932 لا Shift_JIS
ملفات نصوص Aozora Bunko بترميز Windows-31J (CP932). إذا فُكّت بـ Shift_JIS العادي خرجت الشرطة ―― شرطات U+2014، و~ شرطة متموجة 〜، وفشلت بعض محارف NEC وIBM. اقرأها بـ cp932، ثم حوّل الترميز: ruby بين 《》 وملاحظات [#…] ومحارف gaiji ※[#…] ليست Markdown، وتُطبع كما هي إن بقيت. ويقوم aozora.py في المهارة بالأمرين. استيراد نصوص Aozora Bunko →
تحذير الإخراج · rubyExceedsLeading
القراءات تزاحم السطر التالي
السبب. فقرة فيها قراءات روبي فوق نصها أو تحته، وفراغها بين الأسطر أضيق من القراءات: فهي تقع في تباعد الأسطر وتلامس السطر المجاور.
الحل. نضّد الفقرة بتباعد أسطر أكبر (حجم النص مضافًا إليه `cjk.ruby.fontSize` على الأقل)، أو صغّر القراءات. التوثيق →
- يكتب Aozora Bunko قراءة واحدة للكلمة كلها، 兵十《ひょうじゅう》، ويحتفظ بها المحوّل روبيًا جماعيًا،
{兵十|ひょうじゅう}. ولروبي jukugo قسّم القراءة على حروف الكانجي بيدك:{兵十|ひょう|じゅう}. - لا تنقسم القراءة عند الشرطة العمودية إلى جزء لكل حرف إلا إذا طابق عدد الأجزاء عدد حروف الأساس. في
{一人|ひ|と|り}ثلاثة أجزاء لحرفين، فتُنضَّد قراءةً واحدة للكلمة، وهذا ما يحتاجه 一人 على أي حال.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- “Gon gitsune” (ごん狐), section 1, by Niimi Nankichi (1932): Aozora Bunko card 628, base text 新美南吉童話集 (Iwanami Bunko, 1996, second printing 1997), input by 林裕司, proofing by 浜野智 · Niimi Nankichi (1913–1943) · ملك عام
- The readings over every kanji, the box on furigana and the opener’s labels · Postext Cookbook · CC BY 4.0
- الخطوط
- Klee One (SIL OFL 1.1) · Zen Maru Gothic (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


