باختصار
أول تدوينة من يوميات كتبها الشاعر تاكوبوكو عام 1909 باليابانية بحروف لاتينية، مع قراءتها بالكتابة اليابانية تحت كل فقرة.
ما الذي ستنضده
أربع صفحات من Rōmaji nikki، اليوميات التي دوّنها إيشيكاوا تاكوبوكو في طوكيو ربيع 1909 بالحروف اللاتينية كي لا تقرأها زوجته: أسطر العنوان في دفتره والتدوينة الأولى، يوم 7 أبريل، حتى Kanasii koto da! تُنضَّد اليوميات طبعةً دراسية على صفحة A5: الروماجي بخط Source Serif 4، مضبوط الطرفين ولا تُقسم كلماته أبدًا، وتحت كل فقرة قراءتها بالكانا والكانجي بخط Noto Serif JP، أصغر وأفتح وبإزاحة. يكتب تاكوبوكو بنظام Nippon-shiki، si وtu وhu، مع علامة الإمالة على الحروف الطويلة، Tôkyô؛ وتستعمل أسطر المحرر نظام هيبورن بالمدّات، Rōmaji، ويصل الاثنان إلى PDF.
تجيب هذه الوصفة عن
- كيف أنضّد اليابانية المكتوبة بالروماجي: أي وسم للغة، وأي تقسيم للكلمات، والمدّات في PDF؟
- ما الخطوط التي تنضّد اليابانية، بالكانجي في أشكاله اليابانية، على الشاشة وفي PDF؟
الجواب المختصر
// ja-Latn is Japanese written in Latin script (BCP 47). Its language is ja, so the kana
// under each paragraph get the Japanese rules (kinsoku, 、。 spacing, the space after !)
// and the built-in strings are Japanese; and Japanese has no hyphenation patterns, so the
// rōmaji is never divided at a line end. English patterns would divide tatinobotta or
// Surigarasu by English syllables, not by the morae a Japanese reader hears.
const language = { locale: 'ja-Latn' }; // spread into the config
const bodyText = {
fontFamily: SERIF, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1.2), indentAfterHeading: false,
optimalLineBreaking: true, maxWordSpacing: 1.8, // no hyphens: the spaces take the slack
};
// The reading in kana, under its paragraph: smaller, a shade lighter, indented.
const kana = { id: 'kana', fontFamily: MINCHO, fontSize: pt(8.6), lineHeight: pt(LEAD),
color: col('kana'), textAlign: 'justify', indent: em(1.5), firstLineIndent: em(1),
marginTop: pt(LEAD / 4), marginBottom: pt(LEAD * 0.75) };
المكونات
- الميزات
- الكانا والكانجي والروماجيتقسيم الكلمات ولغة المستندالخطوط الصينية واليابانية والكوريةتباعد علامات الترقيم اليابانية (yakumono)كسر الأسطر الياباني (kinsoku)خط المتنصفحات افتتاح مصمَّمةأنماط العناوينسمات العنوانأنماط الفقراتالترويسات وأرقام الصفحاتالترويسات بحسب دور الصفحةهوامش متناظرةلون الورقلوحة ألوان دلاليةالتصدير إلى PDFالخطوط المضمَّنة في PDF
- تستخدم أيضًا
- تقسيم الأسطر في النص الصينيفصول بلا أرقام
- الخطوط
- Source Serif 4, Source Sans 3, Noto Serif JP (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · اوسم النص ja-Latn
الشيفرة هي الجواب المختصر أعلاه. ja-Latn هو وسم BCP 47 لليابانية المكتوبة بالحروف اللاتينية. ولغته ja، فتتبع القراءة تحت كل فقرة القواعد اليابانية: الكينسوكو، وتباعد 、。، والفراغ بعرض em الذي يضيفه المحرك بعد ! داخل الجملة، كما في 「ええ! ええ!」. ولا أنماط لتقسيم الكلمات في اليابانية، فلا يُقسم الروماجي أبدًا؛ ومع en كانت الأنماط الإنجليزية ستقسم كلمات مثل tatinobotta أو Surigarasu بحسب المقاطع الإنجليزية، لا بحسب المورات التي يسمعها القارئ الياباني. وبلا واصلات تمتص الفراغات الفائض، لذا يبلغ عرض السطر نحو 70 حرفًا وmaxWordSpacing قيمته 1.8 (تقسيم الكلمات بالواصلة).

#2 · احمل المدّات إلى PDF
// Fontsource keeps ō ū ā in a latin-ext file. cjkPdfProvider serves Noto Serif JP from its
// slices, and adds that file after the latin one for a Latin face whose text needs it.
offerPdf(() => renderToPdf(doc, { fontProvider: cjkPdfProvider }), `${RECIPE}.pdf`);
يحفظ Fontsource الحروف ō ū ā في ملف latin-ext منفصل. تحمّله الشاشة (يرى loadFonts حرف ō في العيّنة)، ويفعل cjkPdfProvider في عدّة الأدوات الشيء نفسه في PDF: يقدّم Noto Serif JP من شرائحه اليابانية، وإذا صفّ خط لاتيني حرفًا لا يوجد إلا في latin-ext أجاب بملفين، latin ثم latin-ext، فيأخذ postext-pdf كل شكل من أول ملف يحويه. أما fontsourceProvider البسيط في عدّة الأدوات فلا يسلّم PDF إلا ملف latin، ومعه لا يكون في PDF شكل لحرف ō.
#3 · افتتح بأسطر اليوميات نفسها
const onField = { color: col('paper'), align: 'center', overflow: 'wrap' };
const title = {
id: 'title', numbered: false, toc: false, span: 'page', runningChapter: false,
breakBefore: { enabled: true, parity: 'any' }, // its page is an opener: no running heads
advancedDesign: { enabled: true, minHeight: mm(166), slot: { elements: [
{ kind: 'box', id: 'field', style: { backgroundColor: col('indigo') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill',
height: 'fill' } } },
{ kind: 'text', id: 'lines', content: '{attr.lines}', ...onField, fontFamily: SERIF,
fontWeight: 600, fontSize: pt(20), lineHeight: 1.9, letterSpacing: pt(5),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(18) } } },
{ kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('paper'),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(122) },
size: { width: mm(24) } } },
{ kind: 'text', id: 'note', content: '{attr.note}', inlineMarks: true, ...onField,
fontFamily: SANS, fontSize: pt(8.5), lineHeight: 1.5, placement: { anchor: { to:
'container', edge: 'top' }, offset: { y: mm(130) }, size: { width: mm(84) } } },
] } },
};
// The entry: its day as a heading, the address under it from an attribute.
const entry = {
level: 2, fontFamily: SANS, fontWeight: 600, fontSize: pt(10), letterSpacing: pt(2.5),
color: col('indigo'), marginTop: pt(LEAD), marginBottom: pt(LEAD), advancedDesign: {
enabled: true, minHeight: pt(2 * LEAD), slot: { elements: [
{ kind: 'text', id: 'day', content: '{titleText}', fontFamily: SANS, fontWeight: 600,
fontSize: pt(10), letterSpacing: pt(2.5), color: col('indigo'),
placement: { anchor: { to: 'container', edge: 'top-left' } } },
{ kind: 'text', id: 'place', content: '{attr.place}', fontFamily: SANS, fontSize: pt(7.5),
letterSpacing: pt(1), color: col('muted'), overflow: 'wrap', align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: pt(LEAD) },
size: { width: 'fill' } } },
] } },
};
يبدأ الدفتر بـ NIKKI. I. MEIDI 42 NEN. 1909. APRIL. TOKYO.، بندًا في كل سطر. يأخذها العنوان من سمة، وكل \n سطر جديد، وينضّدها بحروف كبيرة متباعدة على مساحة نيلية، قماش غلاف دفتر. وصفحته صفحة افتتاح، فلا تظهر فيها الترويسات.
#4 · ترويسات بحسب زوجية الصفحة
const head = (id, content, parity, edge) => ({ kind: 'text', id, content, parity,
pages: 'body', fontFamily: SANS, fontSize: pt(7.5), letterSpacing: pt(1.5), color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { y: mm(13), // 'top' centres on the page
x: mm(edge.endsWith('left') ? 16 : edge.endsWith('right') ? -16 : 0) } } });
const header = { elements: [
head('folio-even', '{pageNumber}', 'even', 'top-left'),
head('book', 'ROMAZI NIKKI · 1909', 'even', 'top'),
head('place', 'TOKYO · APRIL', 'odd', 'top'),
head('folio-odd', '{pageNumber}', 'odd', 'top-right'),
] };
على الصفحة الزوجية اسم اليوميات وعلى الفردية المكان والشهر، مع أرقام الصفحات في الزوايا الخارجية، بخط Source Sans 3 بحجم 7.5 pt.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 130 · Japanese in Latin letters: Takuboku's Rōmaji Diary ════
// https://postext.dev/en/cookbook/romaji-nikki
// Code: MIT · Text: Ishikawa Takuboku, 1909 (public domain); transcription (CC BY 4.0)
// Fonts: Source Serif 4, Source Sans 3, Noto Serif JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A diary written in Japanese with Latin letters, and its reading in kana under each paragraph.
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 note; the diary is Japanese in both editions
const RECIPE = 'romaji-nikki';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: diary ink, a faded indigo, the cream of a notebook
const palette = {
ink: '#22201d', // the rōmaji
indigo: '#34497a', // the date and the title (8.4:1 on the paper)
kana: '#5a554e', // the transcription, a step lighter than the text (7:1)
rule: '#c9c1b2',
muted: '#6f6a62', // running heads, folios, the note
paper: '#fcfaf4',
};
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: 'indigo (defaults)', value: { hex: palette.indigo, model: 'hex' } },
];
// #endregion
const SERIF = 'Source Serif 4'; // the rōmaji: ô û â ê in latin, ō ū in latin-ext
const SANS = 'Source Sans 3'; // labels, running heads, folios, the note
const MINCHO = 'Noto Serif JP'; // the kana: Noto Serif JP's Latin is Source Serif's
const [BODY, LEAD] = [10.5, 15]; // pt
// #region answer: a Japanese text in Latin letters is tagged ja-Latn
// ja-Latn is Japanese written in Latin script (BCP 47). Its language is ja, so the kana
// under each paragraph get the Japanese rules (kinsoku, 、。 spacing, the space after !)
// and the built-in strings are Japanese; and Japanese has no hyphenation patterns, so the
// rōmaji is never divided at a line end. English patterns would divide tatinobotta or
// Surigarasu by English syllables, not by the morae a Japanese reader hears.
const language = { locale: 'ja-Latn' }; // spread into the config
const bodyText = {
fontFamily: SERIF, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1.2), indentAfterHeading: false,
optimalLineBreaking: true, maxWordSpacing: 1.8, // no hyphens: the spaces take the slack
};
// The reading in kana, under its paragraph: smaller, a shade lighter, indented.
const kana = { id: 'kana', fontFamily: MINCHO, fontSize: pt(8.6), lineHeight: pt(LEAD),
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#اكتب الروماجي بنظام هيبورن
قد تعيد طبعة حديثة كتابة اليوميات بنظام هيبورن بالمدّات، Tōkyō بدل Tôkyô. في ملف PDF حرف ō أصلًا، فلا يتغير إلا النص؛ وأضف ملاحظة تذكر أن الإملاء من عمل المحرر.
#قسّم بين المورات
إن احتاج عمود ضيق إلى واصلات، فضع واصلات لينة (U+00AD) بين مورات الروماجي، Suna-hokori في الشيفرة أو U+00AD مكتوبة في النص: المستند الموسوم ja-Latn لا يقسم الكلمات من تلقاء نفسه، لكنه يكسر عند الواصلة اللينة إذا لم تتسع الكلمة.
أخطاء شائعة
خطأ شائع
اوسم النص الياباني بـ '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: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →
- ليس في Shippori Mincho حرفا ō وū؛ أما Noto Serif JP وSource Serif 4 ففيهما في ملفات
latin-ext. افحص الخط قبل أن تختاره لنص بنظام هيبورن. - الصينية بالحروف اللاتينية هي البينيين، وتُنضَّد ruby فوق الحروف في كتاب قراءة أول بالبينيين فوق كل حرف؛ أما روماجي تاكوبوكو فهو النص نفسه، فيُنضَّد نصًّا لاتينيًّا بتباعده الخاص، لا تعليقًا.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- Ishikawa Takuboku, ROMAZI NIKKI (the Rōmaji Diary), the entry of 7 April 1909 to “Kanasii koto da!”, in Latin letters as he wrote it, after the Iwanami Bunko edition (ed. Kuwabara Takeo, 1977) as transcribed on the blog 啄木の息 · Ishikawa Takuboku (1886–1912) · ملك عام
- The transcription into kana and kanji under each paragraph and the note on the text, written for this recipe · Postext Cookbook · CC BY 4.0
- الخطوط
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1) · Noto Serif JP (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


