En pocas palabras
El comienzo de las Mil y una noches, donde cada noche lleva su número escrito con palabras árabes, «la primera noche», «la segunda noche», en la forma femenina que concuerda con la palabra árabe para noche.
Lo que vas a componer
Diez páginas del comienzo de las Mil y una noches: una portadilla y El mercader y el genio, el primer cuento que narra Sherezade, que ocupa tres noches. Cada noche se abre con la fórmula de Hindawi, فلما كانت, en cúfica pequeña sobre su número en ruqʿa verde, الليلة الأولى, الليلة الثانية, الليلة الثالثة, escrito con letras como lo imprimen los libros. Ninguno de esos números está en el Markdown: el nivel de título cuenta las noches y escribe cada número como ordinal femenino, que concuerda con ليلة. El cuento se abre bajo una cabecera entre filetes dorados, los relatos de los tres ancianos llevan sus propios títulos pequeños, y las cabeceras de página llevan el libro y el cuento. El texto es la edición de 2022 de la Fundación Hindawi, con licencia CC BY 4.0.
Esta receta responde a
- ¿Cómo numero los capítulos con ordinales árabes en letras, como الليلة الأولى?
La respuesta corta
// 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 };
Ingredientes
- Funciones
- Ordinales árabes en letrasTítulos numeradosEstilos de títuloAtributos de títuloAperturas diseñadasTexto de derecha a izquierdaLibros encuadernados por la derechaFuentes árabesEl árabe como idioma del documentoCifras de los números generadosCabeceras y foliosCabeceras por secciónCabeceras según el tipo de páginaEstilos de párrafoPárrafos en la otra direcciónColor del papelPaleta de color semánticaExportación a PDFFuentes incrustadas en el PDF
- También usa
- Capítulos sin número
- Tipografía
- Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Noches contadas con letras
El código es la respuesta corta de arriba. Una noche es un encabezado de nivel 2, ## الليلة, y el numberingTemplate del nivel es 'الليلة {2:ordinal-feminine}': el modificador -feminine escribe الأولى, الثانية, الحادية عشرة, الحادية بعد الألف (Ordinales y cardinales con letras, Números con letras). Con numberPosition: 'replace' el número es el título entero: lo que el Markdown escriba tras ## se descarta, y el título, los marcadores del PDF y el texto alternativo dicen الليلة الثانية. El diseño imprime ese título, {titleText}, en grande y, encima y en pequeño, la fórmula فلما كانت de Hindawi, un texto fijo. Los títulos de los cuentos usan un estilo con numbered: false: un nivel 1 numerado reiniciaría la cuenta de noches con cada cuento, mientras que uno sin número deja en paz los contadores inferiores, y las noches siguen corriendo por todo el libro.

#2 · Una cabecera para cada cuento
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 encabezado de nivel 1 es una banda tintada entre dos filetes dorados, con el título del cuento en ruqʿa encima y un antetítulo y una línea latina tomados de atributos del encabezado, {kicker="…" latin="…"}. La línea latina es lo único de la apertura que cambia con la edición.
#3 · Cabeceras que llegan con el cuento
// 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) } } })] };
Las cabeceras pertenecen al estilo de encabezado tale, así que cada cuento trae las suyas; la portadilla no tiene. La página par lleva el título del libro y la impar {chapterTitle}, el cuento. En un libro encuadernado por la derecha la página par queda a la derecha, así que su folio va arriba a la derecha (Orden de las páginas y encuadernación por la derecha).
#4 · Una portadilla 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 portadilla es un estilo de encabezado con span: 'page', numbered: false y cabecera y pie vacíos, de modo que ni cuenta ni lleva cabecera.
La receta 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'),
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Empieza en la noche mil y una
{startAt=1001} en un título de noche fija su contador, y la plantilla escribe الليلة الحادية بعد الألف (Atributos de encabezado).
-## الليلة
+## الليلة {startAt=1001}#Escribe las centenas a la manera de Bulaq
-classical escribe مائة en lugar de مئة, y la noche doscientos se lee الليلة المائتان.
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine-classical}', numberPosition: 'replace',#Numera capítulos en masculino
Sin modificador el ordinal es masculino, para un sustantivo como الفصل: الفصل الأول، الفصل الثاني.
- level: 2, numberingTemplate: 'الليلة {2:ordinal-feminine}', numberPosition: 'replace',
+ level: 2, numberingTemplate: 'الفصل {2:ordinal}', numberPosition: 'replace',Errores frecuentes
Error frecuente
Etiqueta un libro árabe 'ar', no con LANG
Las ediciones de una receta son en y es, pero una muestra árabe es árabe en las dos: `locale: LANG` la compondría de izquierda a derecha, la encuadernaría por la izquierda, numeraría sus páginas 1 2 3 y llamaría Figure o Figura a sus figuras. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente como Markazi Text no dibuja las formas árabes de sus comillas angulares y sus puntos, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'ar' (cifras arábigo-índicas, la convención del Mashriq), una región como 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' para una edición magrebí con cifras europeas. Una página latina que solo cita árabe conserva su propio locale. Texto de derecha a izquierda →
Error frecuente
Las fuentes árabes necesitan su archivo arabic, con el bloque arabic
Fontsource sirve Amiri, Noto Naskh Arabic o Scheherazade New en un archivo por subconjunto, y las letras árabes están en el archivo arabic. loadFonts solo descarga latin (y latin-ext), así que en pantalla el árabe sale de una fuente del sistema y se mide mal, y fontsourceProvider entrega al PDF ese archivo latin, que imprime cajas vacías. Añade el bloque arabic del kit, llama a loadArabicFonts(FONTS, markdown) después de loadFonts, con todos los pesos que las páginas usan en árabe listados en FONTS, y pasa a renderToPdf fontProvider: arabicPdfProvider. Fuentes árabes →
Créditos
- Receta
- Ignacio Ferro
- Texto
- El mercader y el genio, noches 1 a 3 de Alf layla wa-layla, de la edición de la Fundación Hindawi (2022, vol. 1), con sus vocales y su puntuación · Hindawi Foundation · CC BY 4.0
- Los antetítulos en árabe, la nota sobre el texto y el colofón · Postext Cookbook · original
- Fuentes
- Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


