باختصار
فصل قصير يشرح الكلمات التي يستعملها المنضّدون اليابانيون، وفي آخره فهرس. لكل كلمة مفهرسة نطقها، ويرتّب به Postext الفهرس بترتيب الكانا الياباني، تحت رؤوس الصفوف あ行 وか行 وما يليها.
ما الذي ستنضده
فصل من دليل متخيَّل للتنضيد الياباني، 組版の言葉 («كلمات التنضيد»)، وفهرسه. يشرح الفصل أسماء أجزاء الصفحة وأحجام الحروف وقواعد علامات الترقيم، على صفحة A5 من 36 حرفًا في 28 سطرًا، وكل مصطلح معلَّم للفهرس في الموضع الذي يُشرح فيه. والفهرس هو موضوع الوصفة. لا ترتيب أبجديًا للكانجي في اليابانية، فيصنّف الفهرس كل مدخل بقراءته بالكانا، بترتيب جدول gojūon (五十音)، تحت رؤوس الصفوف あ行 وか行 وさ行. المصطلح الذي عليه فوريغانا يذكر قراءته بنفسه، وأي مصطلح آخر فيه كانجي يذكرها في السمة yomi. أما وصفة فهرس الأسماء الصينية فترتّب الأسماء الصينية بالبينيين وبعدد الضربات.
تجيب هذه الوصفة عن
- كيف أرتّب فهرسًا يابانيًّا بترتيب gojūon بحسب قراءاته؟
الجواب المختصر
// Each mark gives the reading the entry sorts by. A term written with furigana gives it
// itself: :index[{版面|はん|めん}] files 版面 as はんめん. Any other term with a kanji says it
// with yomi: :index[明朝体]{yomi="みんちょうたい"}. Kana and Latin terms need nothing. The
// reading orders the entries in JIS X 4061 order (katakana as hiragana, small kana as large,
// voiced after plain, ー as the vowel before it); Latin terms come first, under A to Z.
const index = {
groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14),
separator: ' ', locatorSeparator: '、', // 版面 3、5: an ideographic space, then 、
see: { italic: false }, // → ルビ, → 柱も見よ: upright, no italic in Japanese
groups: { fontFamily: GOTHIC, fontSize: pt(9), fontWeight: 700, color: col('vermilion'),
marginTop: pt(7) },
};
المكونات
- الميزات
- فهرس بترتيب gojūonالفهرس الأبجدي في آخر الكتابفوريغانا: قراءات الكانا فوق الكانجيقراءات ruby: pinyin وzhuyinالخطوط الصينية واليابانية والكوريةكسر الأسطر الياباني (kinsoku)تباعد علامات الترقيم اليابانية (yakumono)أنماط العناوينفصول بلا أرقامالعناوين المرقّمةعناوين تشغل أسطرًا من المتن (gyōdori)عمود واحد أو عمودانشبكة المحارفصفحات افتتاح مصمَّمةسمات العنوانالترويسات وأرقام الصفحاتهوامش متناظرةأنماط الفقراتالتصدير إلى PDF
- تستخدم أيضًا
- تقسيم الأسطر في النص الصينيموازنة الأعمدةالترويسات بحسب دور الصفحةالخطوط المضمَّنة في PDFهندسة القسم
- الخطوط
- Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · قراءة لكل مصطلح فيه كانجي
الشيفرة هي الجواب المختصر أعلاه. في النص يطبع :index[{版面|はん|めん}]{main} المصطلح 版面 وفوقه はんめん، ويصنّف المدخل تحت はんめん؛ ويطبع :index[明朝体]{yomi="みんちょうたい" main} المصطلح بلا قراءة ويصنّفه تحت みんちょうたい. ولا تحتاج المصطلحات المكتوبة بالكانا، مثل ノンブル أو のど، ولا المصطلحات اللاتينية، مثل DTP أو JIS X 4051، إلى شيء (علامات الفهرس). والقراءة لا تحدد إلا الترتيب، ويُطبع المدخل كما كُتب. ولا سبيل إلى تخمين قراءات الكانجي، فـ 天 تُقرأ てん هنا وあめ في موضع آخر، لذلك لا يحاول المحرّك ذلك أبدًا.
#2 · ترتيب JIS ورؤوس الصفوف
تختار 'auto' القيمة groupBy: 'gojuon' حين يكون locale: 'ja'. وتُرتَّب المداخل بترتيب JIS X 4061: الكاتاكانا كالهيراغانا، والكانا الصغيرة كالكبيرة، والكانا المجهورة بعد غير المجهورة مباشرة، وー كالصائت الذي قبلها. لذا يأتي 級 (きゅう) قبل 行取り (ぎょうどり)، وゴシック体 (ごしっくたい) بعد 小口 (こぐち). وتأتي المصطلحات اللاتينية أولًا، تحت حروفها، كما يرتّبها JIS؛ ولو وُجدت رموز وأرقام لسبقتها (الفهرس الأبجدي).

#3 · → وも見よ
إحالة «انظر» علامةٌ فيها see، مثل :index{term="振り仮名" yomi="ふりがな" see="ルビ"}، وتطبع 振り仮名 →ルビ. وإحالة «انظر أيضًا» تستعمل seealso وتطبع الأهداف قبل も見よ، 級 10 →歯も見よ، كما تصوغها الفهارس اليابانية. ويُبقي see: { italic: false } التسميات قائمة، لأن الخط الياباني لا مائل فيه. وتأتي المسافة الإيديوغرافية بعد كل مصطلح والعلامة 、 بين الصفحات من separator وlocatorSeparator.
#4 · الفهرس على عمودين
const band = { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(56) } } };
const opener = (sink, ground = []) => ({ enabled: true, minHeight: pt(PITCH * sink),
slot: { elements: [...ground,
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(9),
fontWeight: 700, letterSpacing: pt(2), color: col('vermilion'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(10) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: GOTHIC, fontSize: pt(22),
fontWeight: 700, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(3) } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5),
color: col('vermilion'), placement: { anchor: { to: '#title', edge: 'below' },
offset: { y: mm(4) }, size: { width: mm(12) } } },
] } });
عنوان الفهرس نمط عنوان فيه span: 'page' وlayout بعمودين: يمتد تصميمه، وهو شريط شاحب عليه العنوان، عبر الصفحة، ويجري :::index في عمودين تحته. وتُنضَّد رؤوس الصفوف بخط Gothic بلون الزنجفر، والمداخل بخط Mincho الذي يُنضَّد به النص، بحجم 8.5 نقطة على سطر من 14 نقطة.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 126 · A Japanese index in gojūon order, read from its readings ═══
// https://postext.dev/en/cookbook/gojuon-index
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Noto Serif JP, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.28.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 chapter is Japanese in both
const RECIPE = 'gojuon-index';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one vermilion for the row heads and the chapter label, pale rules
const palette = {
ink: '#211e1c', // text: a warm near-black
vermilion: '#b33a22', // the one accent: あ行 heads, the kicker, folios
tint: '#f5ece6', // the index heading's band
rule: '#d3c8c0', // the rule under each title
muted: '#6c625b', // running heads, the colophon
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [MINCHO, GOTHIC] = ['Noto Serif JP', 'Noto Sans JP'];
const [BODY, PITCH] = [9, 16]; // pt: 9 pt text on a 16 pt line
const [CHARS, LINES] = [36, 28]; // the type area in characters
// #region answer: the index in gojūon order: by reading, under あ行 か行 さ行…
// Each mark gives the reading the entry sorts by. A term written with furigana gives it
// itself: :index[{版面|はん|めん}] files 版面 as はんめん. Any other term with a kanji says it
// with yomi: :index[明朝体]{yomi="みんちょうたい"}. Kana and Latin terms need nothing. The
// reading orders the entries in JIS X 4061 order (katakana as hiragana, small kana as large,
// voiced after plain, ー as the vowel before it); Latin terms come first, under A to Z.
const index = {
groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14),
separator: ' ', locatorSeparator: '、', // 版面 3、5: an ideographic space, then 、
see: { italic: false }, // → ルビ, → 柱も見よ: upright, no italic in Japanese
groups: { fontFamily: GOTHIC, fontSize: pt(9), fontWeight: 700, color: col('vermilion'),
marginTop: pt(7) },
};
// #endregion
// #region opener: the chapter label, the title and a short rule; the index's on a band
const band = { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(56) } } };
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#رؤوس بأول حرف كانا
تجعل 'kana' رأس كل مجموعة أول حرف كانا في مداخلها، كما تفعل المعاجم وفهارس الأسماء الطويلة: か، き، く بدل رأس واحد هو か行.
- groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
+ groupBy: 'kana', // heads か き く け こ…#قراءة بلا فوريغانا في النص
لتُبقي أول ذكر للمصطلح بلا قراءة فوقه وتحدّد له قراءته مع ذلك، انقل القراءة إلى yomi.
-ページのうち、本文が組まれる範囲を:index[{版面|はん|めん}]{main}という。
+ページのうち、本文が組まれる範囲を:index[版面]{yomi="はんめん" main}という。أخطاء شائعة
خطأ شائع
اوسم النص الياباني بـ '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: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →
خطأ شائع
لا مائل في الصينية
لا توفّر عائلات CJK وجهًا مائلًا، والطباعة الصينية تميّز التوكيد بنقاط بجانب الحروف، لا بالإمالة. في مستند موسوم بالصينية، يضع *…* نقاط التوكيد على الحروف الصينية التي يحتويها ويُبقي المائل للكلمات اللاتينية (cjk.emphasis: 'dots'، القيمة الافتراضية للصينية)؛ ويضعها :dots[…] في أي مكان. أما مع cjk.emphasis: 'italic'، أو في مستند موسوم بـ en أو es، فيجعل *…* لوحة Canvas تُميل الحروف القائمة، وهو مائل مصطنع لا تستخدمه الطباعة الصينية أبدًا (ويعود PDF إلى الوجه القائم): أبقِ الوسم الصيني، أو ضع التوكيد بالعريض أو بخط Kai (LXGW WenKai) عبر نمط فقرة أو نمط شارة. الخطوط الصينية واليابانية والكورية →
تحذير الإخراج · indexReadingMissing
مدخل فهرس بلا قراءة
السبب. يرتّب الفهرس الياباني المداخل حسب قراءتها، ولا توجد خوارزمية تقرأ الكانجي بموثوقية: هذا المدخل فيه حرف كانجي ولا تذكر أي من علاماته قراءةً (yomi، أو روبي بالكانا على النص المعلَّم، أو مفتاح sort بالكانا)، فيُرتَّب بعد مداخل الكانا حسب نقطة الترميز.
الحل. أضف yomi="…" بالقراءة بالكانا إلى إحدى علامات المدخل (:index[東京]{yomi="とうきょう"})، أو علّم نصًّا عليه روبي ({東京|とう|きょう}). التوثيق →
- المصطلح الذي فيه كانجي بلا قراءة يثير
indexReadingMissing. فمن دونyomiنزل 明朝体 إلى آخر الفهرس، بعد わ行، بلا رأس، وحذّر البناء من أن للمدخل «كانجي بلا قراءة». - تحتاج
:ruby[…]داخل:index[…]إلى تهريب أقواسها، لأن العلامة تنتهي عند أول]؛ فاكتب الصيغة المختصرة،{版面|はん|めん}. - لا تُحتسب قراءة الروبي إلا إذا غطّت كل كانجي في المصطلح:
:index[行{取|ど}り]تترك 行 بلا قراءة وتحذّر، أما{行取|ぎょう|ど}りفتُنتج ぎょうどり.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- نص أصلي, CC BY 4.0
- الخطوط
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


