Saltar al contenido principal
Receta número 112

Recetario · Capítulo 3 · Títulos y aperturas

Títulos con ordinales árabes en letras: la primera noche…

Una plantilla de nivel escribe cada noche como الليلة y un ordinal femenino, الليلة الأولى, الثانية, الثالثة, sin que el Markdown lleve ningún número.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto MIT

pp. ٢–٣ · 2–3 de 10

  • Formato 170 × 240 mm
  • 1 columna
  • Amiri 13/26
  • Aref Ruqaa
  • Noto Kufi Arabic
  • 10 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 114 ms
  • 158 líneas de código

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

script.js · líneas 34–54en el código completo
// 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

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.

Página 5: la segunda noche, con su número escrito por la plantilla e impreso como título entero.

#2 · Una cabecera para cada cuento

script.js · líneas 58–75en el código completo
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

script.js · líneas 79–93en el código completo
// 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

script.js · líneas 97–115en el código completo
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

Sandbox
// ═══ 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

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)
SandboxPDF