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

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

علامات أسماء العلم وعناوين الكتب، عموديًا وأفقيًا

السيرة الأساسية لشيانغ يو مع علامات :name و:book، منضّدة في صفحة عمودية مجلّدة من اليمين ثم في صفحة أفقية: الخطوط يسار الأسماء، ثم تحتها.

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

ص 二–三 · 2–3 من 3

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 140 × 203 مم
  • عمود واحد
  • Noto Serif TC 10.5/18
  • LXGW WenKai TC
  • Noto Sans TC
  • 3 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 76 ms
  • أسطر الشيفرة: 168

باختصار

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

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

ثلاث صفحات نموذجية لكتاب مختارات من Records of the Grand Historian (سجلات المؤرّخ الكبير)، على مقاس القص 140 × 203 mm الخاص بالكتاب الصيني 大32開. المقطع هو مطلع السيرة الأساسية لشيانغ يو بالترقيم الكامل لطبعة كلاسيكية: خط مستقيم بجانب كل شخص ومكان ودولة وسلالة، وخط متموّج بجانب كل عنوان كتاب أو فصل، وكلاهما بالأحمر القرمزي. تنضّد الصفحة 1 المقدمة وأعراف المحرّر بخط Kai. وتنضّد الصفحتان 2 و3 مصدر Markdown نفسه مرتين، عموديًا ثم أفقيًا، فتُظهر الصفحتان المتقابلتان أين تقع العلامات: يسار الأسماء في الأسطر العمودية، وتحتها في الأفقية. الكتاب مجلّد من اليمين، ويقع كل عنوان على شريط نيلي. أما الوصفة رقم 044، Lycidas بنص 1645 فتميّز أسماءها على الطريقة الأوروبية، بالخط المائل.

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

  • كيف أعلّم أسماء الأعلام وعناوين الكتب في النص الصيني بخط مستقيم وخط متموّج؟
  • لماذا يُطبع التوكيد الصيني عندي بوجه مائل، وماذا أستعمل بدلًا منه؟
  • كيف أنضد كتابًا صينيًّا عموديًّا، مجلَّدًا من اليمين؟

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

script.js · الأسطر 45–62في الشيفرة الكاملة
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
  bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
  annotationColor: col('mark'), // unset, the marks print in the colour of the text
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
};
// The book runs down the page, bound on the right: the lines stand left of the names.
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
// # 項羽本紀 {style="across"} sets the same Markdown across the page, 28 characters to
// the line: the lines run under the names. Its margins set its grid; the book's grid
// counts down the page.
const MEASURE = 28 * SIZE * PT; // mm
const across = {
  id: 'across',
  layout: { layoutType: 'single', writingMode: 'horizontal-tb' },
  margins: { top: mm(SIDE), bottom: mm(H - SIDE - 25 * LEAD * PT), // 25 lines
    left: mm((W - MEASURE) / 2), right: mm((W - MEASURE) / 2) },
};

المكونات

الخطوط
Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · الترميز يضع العلامة، ونمط الكتابة يحدّد مكانها

الشيفرة هي الجواب المختصر أعلاه. يُبقي :name[項梁] و:book[史記] حروفهما في النص، فيقرأ البحث والنص المنسوخ وملف PDF 項梁 و史記، ويضيفان العلامات بجانبها (العلامات الصينية والروبي والواريتشو). يحدّد نمط الكتابة وحده الجانب: يضع layout.writingMode: 'vertical-rl' الخطوط يسار الحروف، ويضعها نمط العنوان across، الذي تخطيطه 'horizontal-tb'، تحتها. والقيمة bookTitleMark: 'wavy' هي ما يأخذه مستند zh-Hant افتراضيًا؛ وهي مكتوبة صراحةً لأن التبديل إلى zh-Hans كان سيطبع العناوين بين 《》. وحين تتلامس علامتان من نوع واحد، كما في 東漢班固 أو 史記項羽本紀، تتنازل كل منهما عن ثُمن em عند الطرفين المتلاقيين، فيُقرأ الخطان اسمين.

#2 · تباعد أسطر يتّسع للعلامات

script.js · الأسطر 32–41في الشيفرة الكاملة
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page

تقع العلامات في الفجوة بين الأسطر ولا تغيّر أبدًا تباعد الأسطر (العلامات والروبي والواريتشو). بحجم 10.5 pt على 18 pt تبلغ الفجوة 0.71 em، فتتسع لخطوط الأسماء في عمود ونقاط العمود التالي، كما في العرف الخامس في الصفحة 1. تَعُدّ الشبكة الصفحة بالحروف: 42 حرفًا نزولًا في كل سطر و17 سطرًا عرضًا، وتحرّك الهوامش لتكون مساحة النص هذه بالضبط: هامش 25.7 mm في الأعلى و21.7 mm في الأسفل (شبكة الحروف).

#3 · صفحة افتتاح واحدة تدور مع الصفحة

script.js · الأسطر 66–89في الشيفرة الكاملة
// The grid centres the text between the minimum margins; the band stops at its foot.
const FOOT = 20 + (H - 24 - 20 - CHARS * SIZE * PT) / 2; // mm, with minimums of 24 and 20
const BAND = SIDE + 3.5 * LEAD * PT; // mm from the trim, which is the right edge down the page
const onBand = { align: 'left', overflow: 'wrap' }; // design text centres and cuts by default
const next = (id, y) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) } });
const opener = {
  enabled: true,
  minHeight: pt(4 * LEAD), // the text starts on the fifth line, half a line clear of the band
  slot: { elements: [
    // Across the page the band's length runs past the trim; down it, it ends at the text's
    // foot, clear of the folio.
    { kind: 'box', id: 'band', style: { backgroundColor: col('band') },
      placement: { anchor: { to: 'bleed', edge: 'top-left' },
        size: { width: mm(H - FOOT), height: mm(BAND) } } },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: HEI,
      fontWeight: 700, fontSize: pt(8), letterSpacing: pt(1.6), color: col('tint'),
      placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(6 - SIDE) } } },
    { kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: SONG,
      fontWeight: 700, fontSize: pt(46), lineHeight: 1, letterSpacing: pt(3),
      color: col('paper'), placement: next('kicker', 2) },
    { kind: 'text', id: 'byline', content: '{attr.byline}', ...onBand, fontFamily: KAI,
      fontSize: pt(10), color: col('tint'), placement: next('title', 2) },
  ] },
};

يُخرَج تصميم العنوان في اتجاه سير صفحته، فتخدم مجموعة واحدة من العناصر الاتجاهين (الكتابة العمودية). الشريط مربوط بالزاوية العليا اليسرى من النزف، فيمتد عبر أعلى الصفحة الأفقية، وعلى طول الحافة اليمنى للصفحتين العموديتين، حيث تبدأ القراءة. ويتراصّ العنوان التمهيدي والعنوان واسم المؤلف في اتجاه السير أيضًا: واحد تحت الآخر في الصفحة الأفقية، وواحد يسار الآخر في العمودية. ويُقاس طول الشريط على اتجاه السير: يوقفه 181.3 mm عند أسفل النص العمودي، بعيدًا عن رقم الصفحة، ويمتد إلى ما بعد حدّ القص في الصفحة الأفقية.

#4 · أرقام صفحات لكتاب مجلّد من اليمين

script.js · الأسطر 93–102في الشيفرة الكاملة
const foot = (id, content, parity, edge, x, extra) => ({ kind: 'text', id, content, parity,
  fontFamily: HEI, fontSize: pt(7), color: col('muted'), ...extra,
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-11) } } });
const folio = { fontFamily: SONG, fontSize: pt(9) };
// Bound on the right, a recto (odd) lies left of the spine: its outer edge is its left one.
const footer = { elements: [
  foot('folio-odd', '{pageNumber}', 'odd', 'bottom-left', SIDE, folio),
  foot('folio-even', '{pageNumber}', 'even', 'bottom-right', -SIDE, folio),
  foot('slug', '{attr.slug}', 'all', 'bottom', 0, { letterSpacing: pt(0.4) }),
] };

يجعل النص العمودي تجليد الكتاب من اليمين (التجليد): تقع الصفحة 1 يسار الكعب، والحافة الخارجية للصفحة الفردية هي اليسرى. يذهب رقم الصفحة الفردية إلى أسفل اليسار، والزوجية إلى أسفل اليمين، عكس الكتاب الغربي، ويطبعها pageNumbering.format: 'trad-chinese-informal' على صورة 一 و二 و三. ويأتي السطر التعريفي بينهما من سمة في كل عنوان، slug="…"؛ وهو، مع بيانات الطبع، كل ما يتغيّر بين الطبعتين الإنجليزية والإسبانية.

#5 · حبر ثانٍ

script.js · الأسطر 17–29في الشيفرة الكاملة
const palette = {
  ink: '#221e1b', // the text
  band: '#23394b', // the opener band and the small heads
  mark: '#b5412c', // the name, title and emphasis marks: the second ink
  tint: '#c7d2da', // kickers and bylines on the band
  muted: '#6f6a64', // folios, slug lines, the colophon
  paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];

تطبع الطبعة الكلاسيكية علاماتها بحبر النص. أما كتاب المختارات للطلاب فيستطيع طباعتها بلون ثانٍ، فتنفصل عن ضربات الحروف: يربطها annotationColor بالمدخل mark في لوحة الألوان، وهو القرمزي الذي تُكتب به الشروح بالحبر الأحمر، وتغيير واحد في ذلك المدخل يعيد تلوين كل خط ونقطة في الكتاب.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 077 · Proper-name and book-title marks, across and down ═════
// https://postext.dev/en/cookbook/proper-name-marks
// Code: MIT · Text: Sima Qian, Shiji 7 (PD) · Punctuation, headnote, conventions: CC BY 4.0
// Fonts: Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Specimen pages for a classical reader: the opening of the Basic Annals of Xiang Yu with
// its proper-name lines and wavy title lines, set down the page and then across it.
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 slug lines and the colophon ('en' | 'es')
const RECIPE = 'proper-name-marks';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the indigo of a thread-bound cover, vermilion for the marks
const palette = {
  ink: '#221e1b', // the text
  band: '#23394b', // the opener band and the small heads
  mark: '#b5412c', // the name, title and emphasis marks: the second ink
  tint: '#c7d2da', // kickers and bylines on the band
  muted: '#6f6a64', // folios, slug lines, the colophon
  paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// #endregion
// #region type: 五號 on 18 pt, 42 characters by 17 lines down the page
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page
// #endregion

// #region answer: marks by the markup, their side by the writing mode
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
  bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
  annotationColor: col('mark'), // unset, the marks print in the colour of the text

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

تنويعات

#اطبع العناوين بين 《》

تنضّد كتب البر الصيني خارج الكلاسيكيات العناوين بين أقواس: يبقى Markdown كما هو، وتُطبع الأقواس علاماتِ ترقيم في النص.

-  bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
+  bookTitleMark: 'brackets', // 《史記》《項羽本紀》

#اطبع العلامات بحبر النص

اترك annotationColor بلا قيمة فتأخذ كل علامة لون الكتلة التي تميّزها.

-  annotationColor: col('mark'), // unset, the marks print in the colour of the text

أخطاء شائعة

خطأ شائع

اوسم المستند بـ zh-Hans أو zh-Hant، لا بـ LANG

نسختا الوصفة هما en وes، لكن المثال الصيني صيني في كلتيهما: `locale: LANG` سيسمه بالإنجليزية أو الإسبانية، فيقسّم كلماته اللاتينية بالواصلة، ويسمّي أشكاله Figure أو Figura، ويعطي PDF لغة خاطئة. ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فتحت وسم إنجليزي أو إسباني يصفّ الخط الصيني أرقامه وعلامات الترقيم التي يشترك فيها مع النص اللاتيني بأشكال أخرى، وتنكسر الأسطر في مواضع أخرى. اكتب الوسم بنفسك: 'zh-Hans' (أعراف البر الرئيسي: كسر الأسطر وفق GB، وترقيم Kaiming) أو 'zh-Hant' (تايوان: ترقيم بعرض كامل متمركز)؛ و'zh-HK' لهونغ كونغ. أما 'zh' المجرّد فيُقرأ صينية مبسطة على أعراف البر الرئيسي. أما المثال الياباني فيُوسم بـ 'ja' (gotcha ja-locale-tag). تقسيم الأسطر في النص الصيني →

خطأ شائع

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

خطأ شائع

لا مائل في الصينية

لا توفّر عائلات CJK وجهًا مائلًا، والطباعة الصينية تميّز التوكيد بنقاط بجانب الحروف، لا بالإمالة. في مستند موسوم بالصينية، يضع *…* نقاط التوكيد على الحروف الصينية التي يحتويها ويُبقي المائل للكلمات اللاتينية (cjk.emphasis: 'dots'، القيمة الافتراضية للصينية)؛ ويضعها :dots[…] في أي مكان. أما مع cjk.emphasis: 'italic'، أو في مستند موسوم بـ en أو es، فيجعل *…* لوحة Canvas تُميل الحروف القائمة، وهو مائل مصطنع لا تستخدمه الطباعة الصينية أبدًا (ويعود PDF إلى الوجه القائم): أبقِ الوسم الصيني، أو ضع التوكيد بالعريض أو بخط Kai (LXGW WenKai) عبر نمط فقرة أو نمط شارة. الخطوط الصينية واليابانية والكورية →

تحذير الإخراج · cjkMarksExceedLeading

العلامات تزاحم السطر التالي

السبب. فقرة فيها نقاط توكيد أو خطوط لأسماء الأعلام وعناوين الكتب، وفراغها بين الأسطر أقل من نصف em (خمسة أثمان إذا كانت العلامات على الجانبين): العلامات تقع في تباعد الأسطر، وارتفاعه لا يتغير من أجلها، فتلامس السطر التالي.

الحل. طبّق على الفقرة نمط فقرة بتباعد أسطر أكبر، أو ارفع `bodyText.lineHeight`. التوثيق →

  • العنوان الذي يرسمه تصميم يطبع نصه عبر التصميم، ونص التصميم يُسقط العلامات: فلن يُظهر # :book[項羽本紀] أي خط متموّج في الشريط. وكذلك تطبع الترويسات والتعليقات وخلايا الجداول نصها بلا علامات.
  • لا يتوقّف Postext عند cjkMarksExceedLeading: يسرده البناء في doc.contentWarnings وتُظهره لوحة الفحوص في Sandbox، لكن الصفحات تُطبع على أي حال، والعلامات تزاحم السطر التالي. حين تغيّر تباعد الأسطر اقرأ تلك القائمة؛ فبحجم 15 pt تضم كل فقرة فيها علامات في هذه الصفحات.

الحقوق

الوصفة
Ignacio Ferro
النص
  • The opening of the Basic Annals of Xiang Yu (項羽本紀), Records of the Grand Historian (史記), chapter 7; characters from the zh.wikisource transcription · Sima Qian (司馬遷) · ملك عام
  • The punctuation, the paragraphs and the marks of the passage, the headnote (題解), the conventions (凡例), the slug lines and the colophon · Ignacio Ferro · CC BY 4.0
الخطوط
Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF