باختصار
نشرة حيّ يابانية مطبوعة في أسطر من الأعلى إلى الأسفل. تُظهر الطرق المختلفة لكتابة الأعداد في اليابانية، وكيف تبقى التواريخ مقروءة في النص العمودي.
ما الذي ستنضده
أربع صفحات عمودية من نشرة حيّ، 東若葉台だより، العدد 第百二十号، على صفحة B5 مجلدة على اليمين: إعلان مهرجان الصيف، وتقويم أغسطس، والاشتراكات مع إيصال تبرع، وتاريخ موجز للجمعية. الجمعية متخيَّلة، لكن أعدادها مكتوبة كما يكتبها محرر ياباني. رقم العدد، و第三十二回 للمهرجان، و二千四百人 الذين حضروه تُعدّ بـ 十 و百 و千؛ والسنوات تُكتب رقمًا رقمًا، 二〇二六年 و一九六〇年؛ ومبلغ الإيصال بالأعداد الرسمية (大字, daiji)، 壱萬弐阡، التي لا تُحرَّف بخط واحد؛ والأوقات والتواريخ بأرقام عربية، ويقوم 22 في خانة واحدة. وتنزل القوائم 一、 → (一) → イ → あ، والتقويم في الغلاف الخلفي.
تجيب هذه الوصفة عن
- كيف أرقّم الفصول 第一章 بالأعداد الكانجية، أو عناصر القائمة あ い う وイ ロ ハ؟
- لماذا يخرج نصّي الياباني بالقواعد الصينية: تسمية 图، وكانا صغيرة في أول الأسطر، وكانجي بأشكال صينية؟
الجواب المختصر
// formatNumeral is the counter the engine numbers pages, lists and headings with.
const ISSUE = 120;
const kan = (n) => formatNumeral(n, 'japanese-informal'); // 120 → 百二十: counted
const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
const daiji = (n) => formatNumeral(n, 'japanese-formal'); // 12000 → 壱萬弐阡: on money
// {{daiji:12000}} in the text: the amount of a receipt in the hard-to-alter daiji.
const withDaiji = (md) => md.replace(/\{\{daiji:(\d+)\}\}/g, (_, n) => daiji(Number(n)));
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
uprightDigits: 2, // 8月22日: one or two Arabic digits stand in one cell (the default)
};
// Sections 一、二、三、, items (一)(二), then イ ロ ハ and あ い う beneath them.
const sectionLevel = { level: 2, numberingTemplate: '{2:一}、', numberSeparator: '',
fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(12), color: col('leaf'), lineSpan: 2 }; // 二行取り
const level = (n, numberFormat, prefix, separator) => ({ level: n, numberFormat, prefix,
separator }); // each level starts where the text of the one above starts
const orderedLists = {
fontFamily: GOTHIC, color: col('leaf'), fontWeight: 700, gap: em(0.5),
marginTop: pt(0), marginBottom: pt(0), itemSpacing: pt(0),
levels: [level(1, 'japanese-informal', '(', ')'), level(2, 'katakana-iroha', '', ''),
level(3, 'hiragana', '', '、')],
};
المكونات
- الميزات
- الأعداد اليابانية وعدّادات الكاناأرقام قائمة في النص العموديالقوائم المرقّمةالنص العموديكتب مجلّدة من اليمينشبكة المحارفالكانا والكانجي والروماجيالخطوط الصينية واليابانية والكوريةتباعد علامات الترقيم اليابانية (yakumono)عناوين تشغل أسطرًا من المتن (gyōdori)العناوين المرقّمةصفحات افتتاح مصمَّمةأنماط العناوينأنماط الفقراتإطارات التنبيهأنماط الجداول المسمّاةأنواع موارد مخصّصةلون الورقلوحة ألوان دلاليةالتصدير إلى PDF
- تستخدم أيضًا
- قوائم المراجع ومسارد المصطلحاتتقسيم الأسطر في النص الصينيسمات العنوانأشكال في هذا الموضع بالضبطالترويسات بحسب دور الصفحةالخطوط المضمَّنة في PDFترقيم روماني للصفحات التمهيديةفصول بلا أرقام
- الخطوط
- Noto Serif JP, Noto Sans JP, Zen Maru Gothic (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · اختر الكتابة بحسب موضع العدد
الشيفرة هي الجواب المختصر أعلاه. formatNumeral هو العدّاد الذي يرقّم به المحرك الصفحات والقوائم والعناوين، وتستدعيه الوصفة للأعداد التي تركّبها بنفسها: japanese-informal يعدّ (120 → 百二十، بلا 一 قبل 十 و百 و千)، وcjk-decimal يكتب رقمًا رقمًا (2026 → 二〇二六)، وjapanese-formal يُنتج الصيغة الرسمية للمبلغ (12000 → 壱萬弐阡). ويصير {{daiji:12000}} في النص مبلغ الإيصال، فيُكتب العدد مرة واحدة بالأرقام. وتُستعمل الأساليب نفسها في العدّادات: الأقسام {2:一}、، ويضبط orderedLists.levels الصيغة (一)، ثم katakana-iroha (イ ロ ハ)، ثم hiragana مع 、 (あ、い、う). ويقيم cjk.uprightDigits: 2 التاريخين 8月22日 و23日 بلا ترميز، ويتقاسم !? في 「雨が降ったら中止!?」 خانة واحدة، وهذا سلوك افتراضي في اليابانية (الأرقام في النص العمودي).

#2 · ضع الترويسة في شريط على الحافة اليمنى
const BAND = 46; // mm from the right trim edge
const at = (x, y, extra = {}) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(x), y: mm(y) }, ...extra }); // x down the sheet, y leftward from its right
const onBand = { color: col('paper'), overflow: 'wrap', align: 'left' };
// The date of issue, composed from kan() and pos() as the issue number is: design text the
// contentInConfig check allows, since spelling it is what the recipe shows (#849).
const ISSUED = `${pos(2026)}年(令和${kan(8)}年)${kan(8)}月${kan(1)}日発行`;
const masthead = {
id: 'masthead', numbered: false, toc: false, runningChapter: false,
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: mm(BAND - 15), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('leaf') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(BAND) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: ROUND,
fontWeight: 700, fontSize: pt(36), lineHeight: 1.1, letterSpacing: pt(3),
placement: at(HEAD, 9) },
{ kind: 'text', id: 'issue', content: `第${kan(ISSUE)}号`, ...onBand, fontFamily: GOTHIC,
fontWeight: 700, fontSize: pt(12), letterSpacing: pt(2), placement: at(HEAD, 26) },
{ kind: 'text', id: 'date', content: ISSUED,
...onBand, fontFamily: GOTHIC, fontSize: pt(10), align: 'right',
placement: at(HEAD, 26, { size: { width: mm(LINE) } }) },
{ kind: 'text', id: 'publisher', content: '{author}', ...onBand, fontFamily: GOTHIC,
fontSize: pt(10), align: 'right', placement: at(HEAD, 33, { size: { width: mm(LINE) } }) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', ...onBand, fontFamily: GOTHIC,
fontSize: pt(7.5), placement: at(HEAD, 40) },
] } },
};
في الصفحة العمودية يكون أعلى التدفق هو الحافة اليمنى للورقة، فتصميم العنوان المربوط بأعلى النزف شريطٌ على تلك الحافة، وsize.height الخاص به هو عرضه على الورقة. ورقم العدد والتاريخ نص تصميم مبني بـkan() وpos()، وينتهي التاريخ عند أسفل مساحة النص بـalign: 'right'.
#3 · أعطِ التقويم صفحة خاصة به
const DAYS = { 2: '訓練', 9: '清掃', 13: 'お盆', 18: '練習会', 19: '練習会',
22: '夏祭り', 23: '夏祭り', 30: '役員会' };
const day = (d) => (d ? { content: `**${d}**\n${DAYS[d] ?? '\u00a0'}`, align: 'center',
...(DAYS[d] ? { background: col(d === 22 || d === 23 ? 'blush' : 'tint') } : {}) }
: { content: '' });
const weeks = []; // 1 August 2026 is a Saturday
for (let d = -5; d <= 31; d += 7) weeks.push([0, 1, 2, 3, 4, 5, 6].map((k) => day(d + k > 0
&& d + k <= 31 ? d + k : 0)));
const calendar = { id: 'calendar', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
// An upright table takes every line of the vertical page it stands on (gap:
// vertical-tables): the calendar is the back page, cited at the end of the text.
placement: { position: 'top', span: 'page' },
caption: '八月の行事。13日から16日まではごみの収集がありません。',
table: { model: { headerRowCount: 1, rows: [[...'日月火水木金土'].map((c) => ({ content: c,
isHeader: true, align: 'center' })), ...weeks] } } };
const resourceTypes = [{ id: 'table', name: '表', shortLabel: '表', captionPrefix: '表',
numberingTemplate: '{n}', counterFormat: '一', resetOn: 'never' }]; // 表一, 表二…
يقوم الجدول في الصفحة العمودية ويُقرأ أفقيًا، كما تطبع الكتب اليابانية جداولها؛ ويأخذ كل أسطر الصفحة التي يقع فيها. يُستشهد بالتقويم بعد آخر فقرة كعنصر عائم بعرض الصفحة، فيصير الغلاف الخلفي ويملأ النص الذي قبله صفحاته. ويرقّمه resourceTypes بالرمز 一 (表一)، ويضع مستند ja التسمية 表一 من تلقاء نفسه: التسمية والرقم متصلان وبعدهما مسافة إيديوغرافية.
#4 · حمّل كل صوت بالنص الذي ينضّده
const heads = (markdown.match(/^#+ .*$/gm) ?? []).join('');
const gothicText = `${heads}${markdown}第号年月日発行令和${kan(ISSUE)}${pos(2026)}${
calendar.caption}日月火水木金土${Object.values(DAYS).join('')}領収証(記入例)表一`;
ينضّد Noto Serif JP النص، وNoto Sans JP العناوين والقوائم والتقويم وتسمية الإيصال، وZen Maru Gothic العنوان وحده. يحمّل كل خط ملفات Fontsource لحروفه هو، إضافة إلى الأعداد التي تركّبها الوصفة.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 129 · Kanji numerals, counters and dates in vertical text ═══
// https://postext.dev/en/cookbook/kanji-numerals-and-dates
// Code: MIT · Text: written for the recipe (CC BY 4.0)
// Fonts: Noto Serif JP, Noto Sans JP, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A neighbourhood newsletter set vertically: every way Japanese writes a number.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates, formatNumeral,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the frame; the newsletter is Japanese in both
const RECIPE = 'kanji-numerals-and-dates';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the green of young leaves, its tint, a festival red and its blush
const palette = {
ink: '#1f2420', // the text
leaf: '#2f6b3f', // masthead band, section numbers (6.4:1 on the paper)
tint: '#e4efdf', // the calendar's marked days, the receipt
red: '#b4362b', // the receipt's amount
blush: '#f4d4cc', // the festival days in the calendar
muted: '#5f665f', // folios, the colophon
paper: '#fdfdf9',
};
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: 'leaf (defaults)', value: { hex: palette.leaf, model: 'hex' } },
];
// #endregion
const MINCHO = 'Noto Serif JP'; // the text
const GOTHIC = 'Noto Sans JP'; // section heads, labels, the calendar
const ROUND = 'Zen Maru Gothic'; // the masthead's title
const [BODY, LEAD] = [11, 20]; // pt: large print for every age on the street
const [CHARS, LINES] = [44, 20];
const PT = 25.4 / 72; // mm in a point
const TRIM = { w: 182, h: 257 }; // mm, B5
const LINE = CHARS * BODY * PT; // mm: 170.7, the length of a line
const HEAD = 30 + (TRIM.h - 30 - 24 - LINE) / 2; // mm: the head of the type area
// #region answer: one number, four spellings, chosen by where it stands
// formatNumeral is the counter the engine numbers pages, lists and headings with.
const ISSUE = 120;
const kan = (n) => formatNumeral(n, 'japanese-informal'); // 120 → 百二十: counted
const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
const daiji = (n) => formatNumeral(n, 'japanese-formal'); // 12000 → 壱萬弐阡: on money
// {{daiji:12000}} in the text: the amount of a receipt in the hard-to-alter daiji.
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#اكتب كل السنوات بالعدّ
يفضّل بعض الكتّاب 二千二十六年 على 二〇二六年 في النص الجاري؛ غيّر أسلوب pos.
-const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
+const pos = (n) => formatNumeral(n, 'japanese-informal'); // 2026 → 二千二十六#أقم الأعداد ذات الثلاثة أرقام
مع 3 يأخذ 100 أو 365 في النص خانة واحدة أيضًا.
- uprightDigits: 2, // 8月22日: one or two Arabic digits stand in one cell (the default)
+ uprightDigits: 3,أخطاء شائعة
خطأ شائع
اوسم النص الياباني بـ '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: كلاهما يأخذ الملفات التي تحتوي حروف النص. الخطوط الصينية واليابانية والكورية →
- يشغل التقويم صفحة كاملة لأن الجدول القائم يأخذ كل أسطر الصفحة العمودية (فجوة: الجداول في النص العمودي). والجدول الذي يجب أن يشارك النص صفحته يحتاج صفحة أفقية، أو رسمًا SVG يضعه تصميم عنوان.
- يكتب العدّاد نفسه في الصينية 一百二十 و一千零一، وفي اليابانية 百二十 و千一. اكتب
locale: 'ja'وإلا اختار الرمز 一 الأسلوب الصيني. وينضّد القارئ الصيني تواريخ واختصارات قائمة في النص العمودي تواريخه بـuprightDigitsنفسه.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- The newsletter of a fictional neighbourhood association, written in Japanese for this recipe · Postext Cookbook · CC BY 4.0
- الخطوط
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Zen Maru Gothic (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


