En poques paraules
El començament de Les mil i una nits, on cada nit porta el seu número escrit amb paraules àrabs, «la primera nit», «la segona nit», en la forma femenina que concorda amb la paraula àrab per a nit.
Què compondràs
Deu pàgines del començament de Les mil i una nits: una portadella i El mercader i el geni, el primer conte que explica Xahrazad, que ocupa tres nits. Cada nit s'obre amb la fórmula d'Hindawi, فلما كانت, en cúfica petita sobre el seu número en ruqʿa verd, الليلة الأولى, الليلة الثانية, الليلة الثالثة, escrit amb lletres com l'imprimeixen els llibres. Cap d'aquests números no és al Markdown: el nivell de títol compta les nits i escriu cada número com a ordinal femení, que concorda amb ليلة. El conte s'obre sota una capçalera entre filets daurats, els relats dels tres vells porten els seus títols petits, i les capçaleres de pàgina porten el llibre i el conte. El text és l'edició del 2022 de la Fundació Hindawi, amb llicència CC BY 4.0.
Aquesta recepta respon a
- Com numero els capítols amb ordinals àrabs en lletres, com الليلة الأولى?
La resposta curta
// 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 };
Ingredients
- Funcions
- Ordinals àrabs en lletresTítols numeratsEstils de títolAtributs de títolObertures dissenyadesText de dreta a esquerraLlibres enquadernats per la dretaFonts àrabsL'àrab com a llengua del documentXifres dels números generatsCapçaleres i folisCapçaleres per seccióCapçaleres segons el tipus de pàginaEstils de paràgrafParàgrafs en l'altra direccióColor del paperPaleta de color semànticaExportació a PDFFonts incrustades al PDF
- També fa servir
- Capítols sense número
- Tipografia
- Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Nits comptades amb lletres
El codi és la resposta curta de dalt. Una nit és un títol de nivell 2, ## الليلة, i el numberingTemplate del nivell és 'الليلة {2:ordinal-feminine}': el modificador -feminine escriu الأولى, الثانية, الحادية عشرة, الحادية بعد الألف (Ordinals i cardinals en lletres, Nombres en lletres). Amb numberPosition: 'replace' el número és el títol sencer: el que el Markdown escrigui després de ## es descarta, i el títol, els marcadors del PDF i el text alternatiu diuen الليلة الثانية. El disseny imprimeix aquest títol, {titleText}, en gran i, a sobre i en petit, la fórmula فلما كانت d'Hindawi, un text fix. Els títols dels contes fan servir un estil amb numbered: false: un nivell 1 numerat reiniciaria el compte de nits a cada conte, mentre que un sense número deixa en pau els comptadors inferiors, i les nits continuen per tot el llibre.

#2 · Una capçalera per a cada conte
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) },
] },
};
El títol de nivell 1 és una banda tenyida entre dos filets daurats, amb el títol del conte en ruqʿa al damunt i un avanttítol i una línia llatina presos d'atributs del títol, {kicker="…" latin="…"}. La línia llatina és l'única part de l'obertura que canvia amb l'edició.
#3 · Capçaleres que arriben amb el conte
// 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) } } })] };
Les capçaleres pertanyen a l'estil d'encapçalament tale, així que cada conte porta les seves; la portadella no en té. La pàgina parella porta el títol del llibre i la senar {chapterTitle}, el conte. En un llibre enquadernat per la dreta la pàgina parella queda a la dreta, així que el seu foli va a dalt a la dreta (Ordre de les pàgines i enquadernació per la dreta).
#4 · Una portadella en ruqʿa
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') }),
] } },
};
La portadella és un estil d'encapçalament amb span: 'page', numbered: false i capçalera i peu buits, de manera que ni compta ni porta capçalera.
La recepta completa
// ═══ 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 = 'es'; // @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'),
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Comença a la nit mil i una
{startAt=1001} en un títol de nit en fixa el comptador, i la plantilla escriu الليلة الحادية بعد الألف (Atributs d'encapçalament).
-## الليلة
+## الليلة {startAt=1001}#Escriu les centenes a la manera de Bulaq
-classical escriu مائة en lloc de مئة, i la nit dos-cents es llegeix الليلة المائتان.
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine-classical}', numberPosition: 'replace',#Numera capítols en masculí
Sense modificador l'ordinal és masculí, per a un substantiu com الفصل: الفصل الأول، الفصل الثاني.
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الفصل {2:ordinal}', numberPosition: 'replace',Errors freqüents
Error freqüent
Etiqueta un llibre àrab 'ar', no amb LANG
Les edicions d'una recepta són en i es, però una mostra àrab és àrab en totes dues: `locale: LANG` la compondria d'esquerra a dreta, l'enquadernaria per l'esquerra, numeraria les seves pàgines 1 2 3 i anomenaria Figure o Figura les seves figures. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font com Markazi Text no dibuixa les formes àrabs de les cometes angulars i dels punts, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'ar' (xifres aràbigo-índiques, la convenció del Màixriq), una regió com 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' per a una edició magribina amb xifres europees. Una pàgina llatina que només cita àrab conserva el seu propi locale. Text de dreta a esquerra →
Error freqüent
Les fonts àrabs necessiten el seu fitxer arabic, amb el bloc arabic
Fontsource serveix Amiri, Noto Naskh Arabic o Scheherazade New en un fitxer per subconjunt, i les lletres àrabs són al fitxer arabic. loadFonts només baixa latin (i latin-ext), de manera que a la pantalla l'àrab surt d'una font del sistema i es mesura malament, i fontsourceProvider lliura al PDF aquell fitxer latin, que imprimeix caixes buides. Afegeix el bloc arabic del kit, crida loadArabicFonts(FONTS, markdown) després de loadFonts, amb tots els pesos que les pàgines fan servir en àrab llistats a FONTS, i passa a renderToPdf fontProvider: arabicPdfProvider. Fonts àrabs →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 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 · original
- Fonts
- Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


