简单来说
《一千零一夜》的开头,每一夜的标题都用阿拉伯文把序号写成词,“第一夜”“第二夜”,用与阿拉伯文“夜”相配的阴性形式。
成品一览
《一千零一夜》开头的十页:一张扉页,然后是山鲁佐德讲的第一个故事《商人与魔鬼》,跨了三夜。每一夜开头都是Hindawi版的套语“فلما كانت”,用小号库法体,下面是绿色鲁格阿体的序号:الليلة الأولى、الليلة الثانية、الليلة الثالثة,像印本那样写成词。这些序号都不在Markdown里:标题级别为每夜计数,再把数写成与“ليلة”一致的阴性序数词。故事在金线题头下开始,三位老人的故事各有小标题,书眉印书名和故事名。正文是Hindawi基金会2022年版,采用CC BY 4.0许可。
这道食谱解答
- 怎样用阿拉伯文序数词给章节编号,例如الليلة الأولى?
简短回答
// In the Markdown a night is a level-2 heading with no number: ## الليلة
// The level's template writes الليلة and the counter as a feminine ordinal, which agrees
// with the noun: الليلة الأولى، الليلة الثانية، الليلة الثالثة … الليلة الحادية بعد الألف.
// numberPosition 'replace' makes that number the whole title, so the heading, the PDF
// bookmarks and the alt text read الليلة الثانية. Hindawi's formula is a fixed design text.
const nights = {
level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
advancedDesign: { enabled: true, minHeight: mm(18), slot: { elements: [
{ kind: 'text', id: 'formula', content: 'فلما كانت', fontFamily: KUFI, fontWeight: 500,
fontSize: pt(8), align: 'center', color: col('muted'), placement: top(0) },
{ kind: 'text', id: 'night', content: '{titleText}', fontFamily: RUQAA, fontWeight: 700,
fontSize: pt(21), lineHeight: 1.2, align: 'center', color: col('accent'),
placement: top(4.5) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6), color: col('gold'),
placement: { ...top(16), size: { width: mm(16) } } },
] } },
};
// A tale does not count: an unnumbered heading leaves the deeper counters alone, so the
// nights run on from one tale to the next instead of starting again at الأولى.
const tale = { numbered: false, runningChapter: true };
用料
做法
#1 · 用文字给夜计数
代码见上文的简短回答。每一夜是一个二级标题## الليلة,该级别的numberingTemplate是'الليلة {2:ordinal-feminine}':-feminine修饰符写出الأولى、الثانية、الحادية عشرة、الحادية بعد الألف(序数词与基数词、以文字书写的编号)。numberPosition: 'replace'让序号成为整个标题:Markdown里##后面写的文字被舍弃,标题、PDF书签和替代文字都读作الليلة الثانية。版面设计把这个标题{titleText}排得很大,把Hindawi的套语فلما كانت作为固定文字,小字排在上面。故事标题使用一个numbered: false的样式:带编号的一级标题会在每个故事开头把夜的计数清零,而不编号的标题不动更低级别的计数器,夜数就能贯穿全书。

#2 · 每个故事的题头
const rule = (id, y, thickness) => ({ kind: 'rule', id, direction: 'horizontal',
thickness: pt(thickness), color: col('gold'),
placement: { ...top(y), size: { width: 'fill' } } });
const opener = {
enabled: true, minHeight: mm(50),
slot: { elements: [
{ kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { ...top(4), size: { width: 'fill', height: mm(30) } } },
rule('band-top', 4, 1.2), rule('band-foot', 34, 0.5),
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: KUFI, fontWeight: 500,
fontSize: pt(8.5), align: 'center', color: col('muted'), placement: top(7.5) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: RUQAA, fontWeight: 700,
fontSize: pt(30), lineHeight: 1.15, align: 'center', color: col('accent'),
placement: top(13) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', fontFamily: NASKH, italic: true,
fontSize: pt(9.5), align: 'center', color: col('muted'), placement: top(39) },
] },
};
一级标题是一条夹在两道金线之间的浅色横带,故事标题用鲁格阿体排在上面,上方小字和下方拉丁文行取自标题属性{kicker="…" latin="…"}。拉丁文行是首页上唯一随版本语言变化的部分。
#3 · 随故事而来的书眉
// Running heads stay on the sheet's sides: in a book bound on the right the verso (even)
// is the right-hand page, so its outer edge, where the folio goes, is the right one.
const head = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content,
parity, pages: 'body', fontFamily: KUFI, fontWeight: 500, fontSize: pt(8.5),
color: col('muted'), placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(12) } },
...extra });
const taleHeads = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-right', -OUTER, { color: col('accent') }),
head('verso-book', '{title}', 'even', 'top-right', -(OUTER + 10)),
head('recto-tale', '{chapterTitle}', 'odd', 'top-left', OUTER + 10),
head('recto-folio', '{pageNumber}', 'odd', 'top-left', OUTER, { color: col('accent') }),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom', 0, {
pages: 'opener', color: col('accent'),
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-12) } } })] };
书眉属于tale标题样式,所以每个故事带着自己的书眉;扉页没有。偶数页印书名,奇数页印{chapterTitle},即故事名。右侧装订的书,偶数页在跨页右边,所以它的页码在右上(页序与右侧装订)。
#4 · 鲁格阿体扉页
const at = (y) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } });
const line = (id, content, y, style) => ({ kind: 'text', id, content, align: 'center',
overflow: 'wrap', color: col('ink'), placement: at(y), ...style });
const titlePage = {
id: 'title', span: 'page', numbered: false, runningChapter: false,
breakBefore: { enabled: true, parity: 'any' }, header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'rule', id: 'over', direction: 'horizontal', thickness: pt(0.6), color: col('gold'),
placement: { ...at(62), size: { width: mm(40) } } },
line('book', '{titleText}', 70, { fontFamily: RUQAA, fontWeight: 700, fontSize: pt(54),
lineHeight: 1.25, color: col('accent') }),
{ kind: 'rule', id: 'under', direction: 'horizontal', thickness: pt(0.6), color: col('gold'),
placement: { ...at(100), size: { width: mm(40) } } },
line('volume', '{attr.kicker}', 106, { fontFamily: KUFI, fontWeight: 500, fontSize: pt(11),
color: col('accent') }),
line('latin', '{attr.latin}', 150, { fontFamily: NASKH, fontSize: pt(9.5), italic: true,
color: col('muted') }),
] } },
};
扉页是一个设了span: 'page'、numbered: false并配有空页眉页脚的标题样式,所以它既不计数,也没有书眉。
完整食谱
// ═══ Postext Cookbook · Nº 112 · Night headings in Arabic ordinal words ═══════════
// https://postext.dev/en/cookbook/nights-ordinal-headings
// Code: MIT · Text: Alf layla wa-layla, Hindawi Foundation 2022 (CC BY 4.0) · Pictures: none
// Fonts: Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.25.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 sample document ('en' | 'es')
const RECIPE = 'nights-ordinal-headings';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black text, a deep green for the titles and a gold hairline, on a cream paper.
const palette = {
ink: '#1c1a17', // text: a warm near-black
accent: '#1f564c', // titles, night headings, folios
gold: '#a8833a', // the rules under the nights and around the headpiece
tint: '#ebe3cc', // the headpiece band
muted: '#5e594f', // running heads, kickers, the note on the text
paper: '#faf6ec', // a cream paper
};
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: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
const NASKH = 'Amiri'; // the text and the sub-tale titles
const RUQAA = 'Aref Ruqaa'; // display: the book, the tale, the nights
const KUFI = 'Noto Kufi Arabic'; // labels: kickers, running heads, folios
const [SIZE, LEAD] = [13, 26]; // pt: 2 × the size: a ḍamma over a hamza clears the line above
const [OUTER, TOP] = [18, 22]; // mm: a 17 × 24 cm book
const top = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
// #region answer: the night's number in feminine ordinal words, from a level template
// In the Markdown a night is a level-2 heading with no number: ## الليلة
// The level's template writes الليلة and the counter as a feminine ordinal, which agrees
// with the noun: الليلة الأولى، الليلة الثانية، الليلة الثالثة … الليلة الحادية بعد الألف.
// numberPosition 'replace' makes that number the whole title, so the heading, the PDF
// bookmarks and the alt text read الليلة الثانية. Hindawi's formula is a fixed design text.
const nights = {
level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
advancedDesign: { enabled: true, minHeight: mm(18), slot: { elements: [
{ kind: 'text', id: 'formula', content: 'فلما كانت', fontFamily: KUFI, fontWeight: 500,
fontSize: pt(8), align: 'center', color: col('muted'), placement: top(0) },
{ kind: 'text', id: 'night', content: '{titleText}', fontFamily: RUQAA, fontWeight: 700,
fontSize: pt(21), lineHeight: 1.2, align: 'center', color: col('accent'),
placement: top(4.5) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6), color: col('gold'),
组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)
变化
#从第一千零一夜开始
在夜标题上加{startAt=1001}设定它的计数,模板就写出الليلة الحادية بعد الألف(标题属性)。
-## الليلة
+## الليلة {startAt=1001}#按布拉克的写法拼百位数
-classical把مئة写成مائة,第二百夜就成了الليلة المائتان。
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine-classical}', numberPosition: 'replace',#用阳性给章节编号
不加修饰符时序数词是阳性,配الفصل这样的名词:الفصل الأول、الفصل الثاني。
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الفصل {2:ordinal}', numberPosition: 'replace',常见问题
易错点
阿拉伯文书标记为'ar',不要用LANG
食谱的版本是en和es,但阿拉伯文示例在两个版本里都是阿拉伯文:`locale: LANG`会让它从左向右排、左装订、页码印成1 2 3,并把图标注为Figure或Figura。postext 1.30起,这个标记也是文字成形所用的语言(测量、绘制和嵌入都按它进行),所以标记成英文或西班牙文时,Markazi Text这样的字体不画尖角引号(« »)和句点的阿拉伯文字形,断行的位置也随之改变。自己写出标记:'ar'(阿拉伯-印度数字,马什里克惯例),或带地区的'ar-EG'、'ar-SA';马格里布版本用欧洲数字,写'ar-MA'、'ar-DZ'或'ar-TN'。只引用阿拉伯文的拉丁文页面保留自己的locale。 从右向左的文字 →
易错点
阿拉伯文字体需要通过arabic块加载其arabic文件
Fontsource把Amiri、Noto Naskh Arabic或Scheherazade New按子集分成多个文件提供,阿拉伯字母在arabic文件里。loadFonts只获取latin(以及latin-ext),所以屏幕上的阿拉伯文来自系统字体,测量不准;fontsourceProvider交给PDF的也是这个latin文件,印出来是空框。列出kit中的arabic块,在loadFonts之后调用loadArabicFonts(FONTS, markdown),并在FONTS中列出页面用于阿拉伯文的每个字重,再给renderToPdf传fontProvider: arabicPdfProvider。 阿拉伯文字体 →
致谢
- 文本
- The Merchant and the Jinni, nights 1 to 3 of Alf layla wa-layla, from the Hindawi Foundation edition (2022, vol. 1), with its vowels and punctuation · Hindawi Foundation · CC BY 4.0
- The kickers in Arabic, the note on the text and the colophon · Postext Cookbook · 原创
- 字体
- Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)


