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

دليل الوصفات · الفصل 6 · الإطارات والملاحظات

حواشٍ بجانب نص ياباني عمودي، عبر الصفحتين المتقابلتين

الفصل الأول من «ألعاب الصغار» لإيتشيو مع سبع حواشٍ من نوع 傍注: الرقم (1) يمين السطر، وحواشي الصفحتين عند الحافة الخارجية للصفحة اليسرى.

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

ص 二–三 · 2–3 من 4

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 127 × 188 مم
  • عمود واحد
  • Shippori Mincho 9.3/16.3
  • Noto Sans JP
  • 4 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 68 ms
  • أسطر الشيفرة: 126

باختصار

قصة يابانية كلاسيكية مع شروح قصيرة لأسماء أماكنها القديمة. تقف الأرقام الصغيرة بجانب النص، وتُجمع شروح الصفحتين المفتوحتين عند الحافة الخارجية للصفحة اليسرى.

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

أربع صفحات من طبعة 四六判 لـ«ألعاب الصغار» (たけくらべ، 1895–1896) لهيغوتشي إيتشيو، فصلها الأول، مع سبع حواشٍ عن حي يوشيوارا القديم الذي تصفه. الحواشي من نوع 傍注 (bōchū)، أي الحواشي الجانبية في طبعات الكلاسيكيات اليابانية بغلاف ورقي: يقف رقم صغير (1) يمين السطر بعد الكلمة التي يشرحها، وتُجمع الحواشي المُحال إليها في الصفحتين المتقابلتين كلتيهما عند الحافة الخارجية للصفحة اليسرى، تحت خط طوله ثلث السطر، بحروف أصغر بالخُمس. فيجد القارئ كل حاشية دون أن يقلب صفحة. والنص، 42 حرفًا نزولًا في 17 سطرًا بخط Shippori Mincho بحجم 9.25 pt، يحتفظ بفقرة إيتشيو الطويلة الوحيدة وبعلامات السمسم التي وضعتها على ぎつちよんちよん. والحواشي في ذيل العمود في رواية أوروبية هي رقم 071.

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

  • كيف أنضّد حواشي كتاب ياباني: (1) في آخر الفصل، أو في ذيل الصفحة، أو بجانب النص على الصفحتين المتقابلتين؟
  • كيف أضيف الحواشي السفلية؟
  • كيف أميّز نصًّا يابانيًّا بنقاط السمسم أو بخط جانبي بدل المائل؟

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

script.js · الأسطر 32–48في الشيفرة الكاملة
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
  numbering: 'spread',
  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
  numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
  fontSize: em(0.8), lineHeight: em(1.5),
  separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  emphasisMark: { style: 'sesame', position: 'over' },
};

المكونات

الميزات
الحواشي في الكتب اليابانيةالحواشي السفليةعلامات التوكيد اليابانية (bōten)النص العموديكتب مجلّدة من اليمينفوريغانا: قراءات الكانا فوق الكانجيأرقام قائمة في النص العموديالأعداد اليابانية وعدّادات الكاناعناوين تشغل أسطرًا من المتن (gyōdori)شبكة المحارفكسر الأسطر الياباني (kinsoku)استيراد نصوص Aozora Bunkoالخطوط الصينية واليابانية والكوريةالترويسات وأرقام الصفحاتالترويسات بحسب دور الصفحةأنماط العناوينصفحات افتتاح مصمَّمةهوامش متناظرةلوحة ألوان دلاليةالتصدير إلى PDF
الخطوط
Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · اجمع حواشي الصفحتين عند الحافة الخارجية للصفحة اليسرى

الشيفرة هي الجواب المختصر أعلاه. يضع footnotes.placement: 'spread' الحواشي المُحال إليها في الصفحتين 2 و3 بعد نهاية نص الصفحة 3، وهي في كتاب مجلَّد من اليمين حافتها الخارجية، ويبدأ numbering: 'spread' حواشي كل صفحتين متقابلتين من (1) (الحواشي السفلية). الحاشية المُحال إليها في الصفحة اليمنى تنتظر الصفحة اليسرى؛ وإن تركت الحواشي للصفحة اليسرى أقل من سطر واحد من النص بقيت البقية عند ذيل الصفحة اليمنى، كما تجيز JLReq. والمستند الموسوم ja يضع علامات الكتاب العمودي أصلًا على هيئة ({n}) يمين السطر، بحجم 0.7 em، وأرقامها قائمة: السطران المكتوبان صراحةً يُظهران ذلك. ويضع numberGap: 'em' بعد الرقم مسافة بعرض حرف كامل من حروف الحاشية، ويصفّ hangingIndent: em(2) أسطرها التالية بعده.

#2 · اكتب العلامات حيث تضعها اليابانية

يكتب Markdown 見返り柳[^1] بعد الكلمة التي تشرحها الحاشية، والحواشي فقرات [^1]: … في نهاية الفصل. تتبع العلامة الكلمة التي تشرحها الحاشية؛ والعلامة التي تنهي جملة تأتي قبل 。 (…先生[^1]。)، ولا يترك المحرّك 。 ولا علامة حاشية تبدأ سطرًا أبدًا. كُتبت الحواشي السبع لهذه الوصفة بيابانية حديثة بسيطة: ما كان 見返り柳 وما كانت お齒ぐろ溝، وأين كان 大音寺前، وما الذي كان يُباع في 酉の市.

#3 · احتفظ بعلامات السمسم التي في الأصل

يحدد cjk.emphasisMark ما يطبعه *…* و:dots[…] في هذا الكتاب: نقاط السمسم، يمين السطر العمودي. والمستند ja يستعملها أصلًا، وكتابتها صراحةً تُظهر علامات التوكيد (圏点, kenten) في قائمة الميزات. يعلّم نص Aozora الكلمة ぎつちよんちよん بـ傍点، وكتبها aozora.py هكذا :dots[ぎつちよんちよん]{style=sesame}؛ أما الكتب الصينية فتضع النقاط تحت السطر (العلامات والروبي والواريتشو).

#4 · ابدأ على صفحتين متقابلتين

script.js · الأسطر 52–71في الشيفرة الكاملة
// Page-anchored design on a vertical page: x runs down the page from its top edge, y across
// it leftwards from its right edge. The title stands on the page's axis, the author lower.
const PT = 25.4 / 72; // mm in a point
const page = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
  offset: { x: mm(down), y: mm(across) } });
const TITLE = 26; // pt
// parity 'any': the story opens on the next page, either side (the default waits for a recto).
const story = { level: 1, breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: lines(LINES), 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: page(42, 127 / 2 - (TITLE * PT) / 2) },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6), color: col('plum'),
      placement: { ...page(42, 127 / 2 + (TITLE * PT) / 2 + 5), size: { width: mm(24) } } },
    { kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(12),
      letterSpacing: pt(4), color: col('ink'),
      placement: page(118, 127 / 2 + (TITLE * PT) / 2 + 3) },
  ] } } };
const section = { level: 2, fontFamily: MINCHO, fontWeight: 700, fontSize: pt(11),
  lineSpan: 3, indent: em(7) }; // 3行取り, seven characters down, as the Aozora text marks it

تحيل الجملة الأولى من الفصل إلى أربع حواشٍ في أسطرها الثلاثة الأولى. لو وُضعت تحت عنوان في الصفحة 1 لما تركت إلا مكانًا لثلاثة أسطر من النص، فالصفحة اليسرى المنفردة تضم حواشيها وحدها ولا تضم حواشي غيرها. أما صفحة عنوان وحدها في الصفحة 1 فتنقل الفصل إلى الصفحة 2، وهي صفحة يمنى، فتضم الصفحتان المتقابلتان الأوليان النص وحواشيه كلها. وصفحة العنوان عنوان من المستوى الأول يملأ تصميمه الصفحة، مربوط بحدود القصّ ليقف العنوان على محور الصفحة.

#5 · ضع الترويسة وأرقام الصفحات نزولًا على الحافة الخارجية

script.js · الأسطر 75–89في الشيفرة الكاملة
const foreEdge = (id, content, parity, edge, y, pages) => ({
  kind: 'text', id, content, parity, pages, writingMode: 'vertical-rl',
  fontFamily: GOTHIC, fontSize: pt(7), letterSpacing: pt(1), color: col('muted'),
  overflow: 'clip', placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
  foreEdge('hashira', '{title}', 'odd', 'top', 2, 'body'),
  foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'body'),
] };
// The title page carries the colophon across the foot, in the edition's language.
const footer = { elements: [{ kind: 'text', id: 'colophon', content: '{attr.colophon}',
  pages: 'opener', fontFamily: GOTHIC, fontSize: pt(5.5), lineHeight: 1.45,
  color: col('muted'), overflow: 'wrap', align: 'center',
  placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-6) },
    size: { width: mm(100) } } }] };

يجري العنوان نزولًا في الهامش الخارجي للصفحات اليسرى، خارج الحواشي، وتقف أرقام الصفحات بالكانجي عند ذيل كل صفحة ما عدا صفحة العنوان.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 121 · Notes beside a vertical Japanese text, across the spread ══
// https://postext.dev/en/cookbook/vertical-notes-and-sidenotes
// Code: MIT · Text: 樋口一葉『たけくらべ』, Aozora Bunko 389 (PD); notes CC BY 4.0 · Pictures: none
// Fonts: Shippori Mincho, 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 story is Japanese in both
const RECIPE = 'vertical-notes-and-sidenotes';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, a muted plum for the note numbers' rule, cream paper
const palette = {
  ink: '#211d1b', // the text and the notes
  plum: '#6b3a55', // 紫: the rule over the notes, the engine's defaults
  muted: '#6b645d', // the hashira and the folios
  paper: '#fbf7ef',
};
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.plum, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Shippori Mincho', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9.25, 16.25, 42, 17]; // pt, pt: 四六判 42字 × 17行
const lines = (n) => pt(n * LEAD);

// #region answer: 傍注, the notes of both pages of a spread at the fore-edge of the left one
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
  numbering: 'spread',
  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
  numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
  fontSize: em(0.8), lineHeight: em(1.5),
  separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  emphasisMark: { style: 'sesame', position: 'over' },
};

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

تنويعات

#اجمع الحواشي في نهاية الفصل

بلا placement يضع كتاب ja العمودي حواشيه على هيئة 後注 (kōchū): بعد نص الفصل، تحت الخط نفسه، مرقّمة على امتداد الفصل. وهي هنا تملأ النصف الأيسر من الصفحة 4.

-  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
-  numbering: 'spread',
+  placement: 'chapterEnd', // 後注, the default for a vertical ja book
+  numbering: 'chapter',

#ضع العلامة بجانب الكلمة

يضع markerPosition: 'side' علامة أصغر في الفراغ الذي بجانب السطر، كما تُوضع الروبي بين الأسطر، فلا تأخذ من السطر أي مكان.

-  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
+  markerPosition: 'side', markerTemplate: '{n}',

أخطاء شائعة

خطأ شائع

اوسم النص الياباني بـ '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
النص
  • 樋口一葉「たけくらべ」 (Child’s Play, 1895–96), chapter one; Aozora Bunko card 389, from 「日本現代文學全集10 樋口一葉集」 (Kōdansha, 1962), input 青空文庫, proofreading 米田進 and 小林繁雄, converted with aozora.py; the seven notes were written for this recipe (CC BY 4.0) · Higuchi Ichiyō; Aozora Bunko volunteers · ملك عام
الخطوط
Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF