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

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

نص 漢文 بعلامات قراءته، وقراءته اليابانية

ثلاثة أقوال من «المختارات» ورباعية من عصر تانغ كما ينضّدها كتاب قراءة ياباني: علامات العودة وحروف okurigana بلون الزنجفر، والقراءة بالكانا تحت كل مقطع.

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

ص 一 · 1 من 3

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 148 × 210 مم
  • عمود واحد
  • Klee One 10.5/21
  • Noto Sans JP
  • Zen Old Mincho
  • 3 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 52 ms
  • أسطر الشيفرة: 131

باختصار

الصينية الكلاسيكية كما يتعلمها القرّاء اليابانيون: علامات حمراء صغيرة بجانب الحروف تخبر القارئ بأي ترتيب يقرؤها وأي لواحق يابانية يضيف، وتلي كلَّ مقطع قراءتُه اليابانية كاملة.

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

ثلاث صفحات من كتاب قراءة مدرسي ياباني في 漢文 (kanbun)، أي الصينية الكلاسيكية مقروءةً باليابانية، على صفحة A5 مجلَّدة من اليمين: ثلاثة أقوال من «المختارات» ورباعية منغ هاوران «فجر الربيع». يُنضَّد كل مقطع بخط Zen Old Mincho بحجم 15 pt بالترتيب الصيني، وعلاماته 訓点 (kunten) بجانب الحروف بلون الزنجفر وبنصف حجمها: علامات العودة (返り点) أسفل يسار الحرف تطلب من القارئ أن يتابع ثم يعود إليه، وحروف okurigana (送り仮名) يمينه تضيف اللواحق اليابانية. وتحت كل مقطع يجري 書き下し文 (yomikudashi)، أي النص نفسه مكتوبًا باليابانية، بخط Klee One، وهو خط الكتب المدرسية، مع الفوريغانا حيث تصعب القراءة. والكلاسيكيات الصينية بأدوات قراءتها الخاصة هي رقم 080.

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

  • كيف أطبع الكانبون بعلامات الرجوع والـ okurigana؟
  • كيف أضيف الفوريغانا فوق الكانجي، قراءة لكل حرف أو قراءة واحدة للكلمة كلها؟

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

script.js · الأسطر 32–52في الشيفرة الكاملة
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
  // The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
  // quatrain takes two lines, a couplet to the line with a space between its verses.
  { id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    firstLineIndent: em(0), textAlign: 'justify' },
  { id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // The reading (書き下し文), two characters down in a school-book hand.
  { id: 'kudashi', indent: em(2), firstLineIndent: em(0), marginTop: pt(LEAD) },
  { id: 'kudashi-shi', indent: em(4), firstLineIndent: em(0), marginTop: pt(0),
    marginBottom: pt(0) },
];

المكونات

الخطوط
Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · علّم كل حرف بـ:kunten

الشيفرة هي الجواب المختصر أعلاه. يضع :kunten[習]{kaeri="レ" okuri="フ"} على الحرف 習 علامة العودة レ وحرف okurigana フ؛ ويحتفظ النص بالحرف، فيقرأ البحث والنسخ وملف PDF المقطع كما كُتب، ولا تأخذ العلامات أي حرف منه (العلامات والروبي والواريتشو). اقرأ 学ビテ而時ニ習フレ之ヲ: ترسل レ التي على 習 القارئ إلى 之 أولًا ثم تعيده، فيقرأ 之を習ふ؛ ولا علامة على 而 فلا يُقرأ. في النص العمودي تقف علامة العودة أسفل يسار حرفها وتأخذ نصف حرف من السطر، وتقف حروف okurigana يمينه، ابتداءً من منتصف الحرف نزولًا، كما يضعها JIS X 4051. ويضبط cjk.kunten حجمها، نصف حجم النص، ولونها، الزنجفر الذي يكتبها به القارئ؛ والمقطع بحجم 15 pt على سطرين من الشبكة، فيبقى بجانب كل سطر 27 pt لحروف okurigana.

#2 · اقفز بـ一 二 وبـ一レ

تُرجع الأرقام القارئ أبعد من ذلك. في 不二亦タ説バシカラ一乎 يتخطى القارئ 不، التي عليها 二، فيقرأ 亦た説ばしから، وعند 一 يعود صعودًا إلى 不: 亦た説ばしからずや. وفي 為政 تؤدي العلامة المركّبة 一レ على 為 العملين معًا: يُقرأ 可二以テ為一レ師ト矣 هكذا: 以て، ثم 師と (レ)، ثم 為る، ثم العودة إلى 可 (من 一 إلى 二)، فتصير 以て師と為るべし. وتُقرأ نقاط الترميز الخاصة بالكانبون ㆑ ㆒ ㆓ على أنها الحروف التي تنوب عنها، فيحتفظ النص المنسوخ من مصدر آخر بعلاماته.

#3 · دع الـokurigana الطويلة تدفع الحرف التالي

حروف okurigana الأطول من حرفها لا تجري بجانب الحرف التالي: في 花落ツルコト知ル多少 تأخذ حروف الكانا الأربعة ツルコト طول حرفين، فينزل 知 ليبدأ بعدها، كما يضعها JIS X 4051 (§5.6.4). يطول السطر، وينتقل موضع انكساره التالي معه.

#4 · أعطِ كل مقطع تسمية بارتفاع سطرين

script.js · الأسطر 56–70في الشيفرة الكاملة
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
  offset: { x: pt(down), y: pt(across) } });
const TITLE = 26; // pt
const part = { level: 1, breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: pt(5 * LEAD), slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
      fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
      placement: at(2 * BODY, 2 * LEAD - TITLE / 2) },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(8.5),
      letterSpacing: pt(2), color: col('vermilion'), placement: at(2 * BODY + 3 * TITLE + 18,
        2 * LEAD - 8.5 / 2) },
  ] } } };
// 2行取り, the passage's book and number in gothic, two characters down.
const passage = { level: 2, fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(9.5),
  color: col('muted'), lineSpan: 2, indent: em(2) };

يفتتح كل باب من أبواب كتاب القراءة صفحةً بعنوانه، 論語 أو 唐詩، والأول مع ملاحظة صغيرة بلون الزنجفر عمّا يحويه؛ ويأخذ كل مقطع تسمية بخط غير مذيّل (gothic) بعرض سطرين من أسطر المتن (2行取り)، 学而第一 أو 春暁 孟浩然، فتبقى المقاطع التي تحتها على الشبكة. والقراءة كتلة :::paragraphs{style="kudashi"} على بعد حرفين من الرأس، بخط المتن وحجمه، مع فوريغانا 熟語 (jukugo): يضع {君子|くん|し} فوق كل حرف قراءته الخاصة، فيمكن أن ينكسر السطر بينهما.

#5 · حمّل كل صوت بحروفه

script.js · الأسطر 173–186في الشيفرة الكاملة
const FENCE = /:::paragraphs\{style="([\w-]+)"\}\n([\s\S]*?)\n:::/g;
const fence = (style) => [...markdown.matchAll(FENCE)].filter((m) => m[1] === style)
  .map((m) => m[2]).join('');
const kanbun = `${fence('kanbun')}${fence('shi')}`; // the text and its marks' kana
const reading = `${fence('kudashi')}${fence('kudashi-shi')}`;
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
const colophon = markdown.match(/colophon="([^"]*)"/)[1];
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, kanbun, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [KYOKASHO]: ['400'] }, reading, { vertical: true });
await loadCjkFonts({ [GOTHIC]: ['400', '700'] },
  `${heads}${colophon}${markdown.match(/kicker="([^"]*)"/)[1]}漢文訓読一二三四五六七八九十`,
  { vertical: true });

يُنضَّد النص الكلاسيكي وقراءته بخطين مختلفين، فيحمّل كل منهما ملفات حروفه: Zen Old Mincho للمقاطع وعلاماتها، وحروف الكانا فيها داخل سمات :kunten، وKlee One للقراءات وفوريغاناها، وNoto Sans JP للتسميات. وتُنضَّد الرباعية بيتين في السطر بينهما مسافة إيديوغرافية، وهي طريقة شائعة لطباعتها، فتتسع القصيدة وقراءتها في الصفحة تحت العنوان.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 122 · Kanbun with its reading marks, and the Japanese reading ═══
// https://postext.dev/en/cookbook/kanbun-kundoku
// Code: MIT · Text: 論語, 孟浩然「春暁」 (public domain); kunten and readings CC BY 4.0
// Fonts: Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the colophon; the page is Japanese in both
const RECIPE = 'kanbun-kundoku';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the vermilion of hand-written kunten, a school-book paper
const palette = {
  ink: '#1e1c1a', // the text
  vermilion: '#c0392b', // 朱: the reading marks, as a reader adds them by hand
  muted: '#6a635c', // the headings' labels, the folios
  paper: '#fcfbf7',
};
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 [MINCHO, KYOKASHO, GOTHIC] = ['Zen Old Mincho', 'Klee One', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10.5, 21, 36, 16]; // pt, pt: 36字 × 16行, a 2 em pitch
const KANBUN = 15; // pt: the classical text, set larger on two lines of the grid

// #region answer: kanbun with 返り点 and 送り仮名, its yomikudashi beside it in furigana
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
  // The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
  // quatrain takes two lines, a couplet to the line with a space between its verses.
  { id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    firstLineIndent: em(0), textAlign: 'justify' },
  { id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // The reading (書き下し文), two characters down in a school-book hand.

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

تنويعات

#اطبع العلامات بالأسود

يضع كتاب القراءة المطبوع علامات 訓点 بحبر النص؛ احذف اللون.

-  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+  kunten: { fontSize: em(0.5), placement: 'inline' },

#ضع العلامات بين الأسطر

يُخرج placement: 'interlinear' علامات العودة من السطر إلى الفراغ الذي بجانب النصف الأسفل من الحرف، فيحتفظ المقطع بتباعد النص المجرد (白文). ويضعها JIS داخل السطر، وهي القيمة الافتراضية.

-  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'interlinear' },

أخطاء شائعة

خطأ شائع

اوسم النص الياباني بـ 'ja'، لا بـ zh-Hans ولا بـ LANG

نسختا الوصفة هما en وes، لكن المثال الياباني ياباني في كلتيهما: `locale: LANG` سيسمه بالإنجليزية أو الإسبانية، والوسم الصيني سينضّده بالقواعد الصينية (ترقيم Kaiming، وكانا صغيرة يجوز أن تبدأ بها الأسطر، و图 بدل 図، وأشكال صينية للحروف في PDF). ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فكل وسم غير 'ja' يعطي أشكالًا للحروف غير اليابانية (الصينية منها مع وسم صيني) وكسرًا آخر للأسطر. اكتب 'ja': يختار منطقة اليابان (كسر الأسطر والترقيم وفق JLReq، ونقاط السمسم، وتوزيع الفوريغانا، وتسميتي 図 و表) ويوقف تقسيم الكلمات. ويُفشل الفحصُ نصًّا فيه كانا موسومًا بـ zh أو ko. كسر الأسطر الياباني (kinsoku) →

خطأ شائع

الخطوط الصينية تُحمَّل شرائح، عبر الكتلة 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]. كتب مجلّدة من اليمين →

الحقوق

الوصفة
Ignacio Ferro
النص
  • 論語 (the Analects of Confucius), 學而 1 and 3, 爲政 11, and 孟浩然「春曉」 (Spring Dawn), in shinjitai; the kunten (返り点, 送り仮名) and the yomikudashi follow the usual Japanese school reading and were set for this recipe (CC BY 4.0) · Confucius and his disciples; Meng Haoran; Ignacio Ferro (kunten and reading) · ملك عام
الخطوط
Zen Old Mincho (SIL OFL 1.1) · Klee One (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF