Saltar al contenido principal
Receta número 111

Recetario · Capítulo 2 · Texto y tipografía

Prosa clásica vocalizada y los paréntesis coránicos

Una maqāma con vocal en cada letra, compuesta con un interlineado del doble de su cuerpo para que los signos de una línea no toquen los de la siguiente.

En esta página
Salida
Canvas
Nivel
Básico
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.28.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto MIT

pp. ٢–٣ · 2–3 de 4

  • Formato 140 × 210 mm
  • 1 columna
  • Amiri 14/28
  • Aref Ruqaa
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 90 ms
  • 104 líneas de código

En pocas palabras

Un relato árabe antiguo impreso con todos sus pequeños signos de vocal encima y debajo de las letras. Las líneas van tan separadas que los signos de una no chocan con la de abajo.

Lo que vas a componer

Cuatro páginas de un libro árabe clásico en el que cada letra lleva su vocal: la Maqāma del manicomio de al-Hamadhānī, en la que un loco del manicomio de Basora deja sin respuesta a un teólogo y luego dice su nombre en verso. El texto con todas sus vocales apila fatḥa y šadda encima de las letras y kasra debajo, y esos signos están en el espacio entre líneas. Por eso la página se compone en Amiri a 14 pt sobre 28 pt, el doble del cuerpo, y nada más: el interlineado es el diseño. El texto va justificado con cachidas, con una sangría de 1,5 em a la derecha, y sus tres citas del Corán van entre los paréntesis ornamentales ﴿ ﴾ del muṣḥaf impreso. Solo la línea latina del título y la nota sobre el texto cambian con la edición.

Esta receta responde a

  • ¿Cuánto interlineado necesita el árabe con todas sus vocales?

La respuesta corta

script.js · líneas 28–45en el código completo
// Every letter of this maqāma carries its vowel: fatḥa and shadda over the letters, kasra
// and kasratān under them, often two marks on one letter. The marks sit in the leading,
// which never grows for them, so the leading is chosen for the most vocalised line of the
// book. Unvocalised prose sets well at 1.6 × the size; fully vocalised text needs
// 1.9–2.1 ×: here 14 pt on 28 pt, 2 ×, so a kasra hanging under one line clears a shadda
// standing on the line below. Any closer and the build reports the paragraph
// (arabicMarksExceedLeading) with the leading it would need.
const SIZE = 14; // pt
const LEAD = 2 * SIZE; // pt: 28
const bodyText = {
  fontFamily: NASKH, fontSize: pt(SIZE), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // Justified with kashidas, the default in an Arabic book, written out to say so:
  // a line widens at its joins as well as at its spaces.
  textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh',
  firstLineIndent: em(1.5), indentAfterHeading: false, // on the start side, the right
  optimalLineBreaking: true, avoidWidows: true, avoidOrphans: true,
};

Ingredientes

Tipografía
Amiri, Aref Ruqaa (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Un interlineado del doble del cuerpo

El código es la respuesta corta de arriba. El interlineado nunca crece para hacer sitio a los signos: la kasra de una línea y la šadda de la siguiente comparten el mismo hueco, así que el hueco se elige para la línea más vocalizada del libro (Signos vocálicos). Con este texto, un interlineado de 1,6 veces el cuerpo deja seis párrafos con signos que chocan, y 1,9 aún deja uno; con 2 no queda ninguno. La composición lo avisa: cuando dos líneas chocan, marca el párrafo con un aviso arabicMarksExceedLeading y el interlineado que necesitaría (Texto árabe).

Página 2: una vocal en cada letra y 28 pt entre líneas base, de modo que las kasras de una línea libran las šaddas de la siguiente.

#2 · Una página pequeña con una medida ancha

script.js · líneas 49–56en el código completo
// 166 mm of text block hold seventeen lines on the 28 pt pitch (9.88 mm). The measure is
// 106 mm, about twelve words of vocalised Naskh.
const page = {
  sizePreset: 'custom', width: mm(140), height: mm(210), dpi: 150,
  backgroundColor: col('paper'),
  // mirror: left is the inner margin, at the spine (the right edge of an odd page here)
  margins: { top: mm(22), bottom: mm(22), left: mm(18), right: mm(16), mirror: true },
};

Una página de 14 × 21 cm con márgenes laterales de 16 y 18 mm deja una medida de 106 mm, unas doce palabras vocalizadas, y diecisiete líneas con el paso de 28 pt. Los signos agrisan las líneas, así que la página se queda sobria: sin cabeceras, papel crema y un único título en rojo. mirror: true pone el margen más ancho en el lomo, que en un libro encuadernado por la derecha es el borde derecho de la página impar (Orden de las páginas y encuadernación por la derecha).

#3 · Títulos que respetan la retícula

script.js · líneas 60–75en el código completo
// The headings carry no design: the title's line box, three lines of the grid deep, lowers
// it on the page (a top margin is dropped at the head of a page), and the levels under it
// keep to the 28 pt pitch, so the text starts on a line of the grid.
const headings = {
  fontFamily: NASKH, color: col('ink'), textAlign: 'center',
  levels: [
    // The maqāma opens on a recto.
    { level: 1, fontFamily: RUQAA, fontWeight: 700, fontSize: pt(32), lineHeight: pt(LEAD * 3),
      color: col('rubric'), marginTop: pt(0), marginBottom: pt(0),
      breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontWeight: 700, fontSize: pt(15), lineHeight: pt(LEAD), color: col('ink'),
      marginTop: pt(0), marginBottom: pt(0) },
    { level: 3, fontWeight: 400, fontSize: pt(10), lineHeight: pt(LEAD), color: col('muted'),
      marginTop: pt(0), marginBottom: pt(LEAD) },
  ],
};

Los títulos no llevan diseño: el título en ruqʿa ocupa una caja de línea de tres líneas de la retícula, y el autor y la línea latina ocupan una línea de 28 pt cada uno, así que la primera línea de texto cae en la retícula. La línea latina lleva {dir=ltr}: un título de izquierda a derecha en un libro de derecha a izquierda (Dirección del documento, del bloque y del texto en línea).

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 111 · Fully vocalised classical prose with Qur'anic brackets ═══
// https://postext.dev/en/cookbook/vocalised-classical-prose
// Code: MIT · Text: al-Hamadhānī, Maqāmāt, ar.wikisource (PD) · Pictures: none
// Fonts: Amiri, Aref Ruqaa (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'vocalised-classical-prose';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black text and a red title on a cream page, as the Beirut and Cairo editions of the
// Maqāmāt print them.
const palette = {
  ink: '#211b17', // text: a warm near-black
  rubric: '#94291d', // the accent: the title
  muted: '#6b6156', // the author's name, the Latin title line, the note on the text
  paper: '#fbf7ee', // 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: 'rubric (defaults)', value: { hex: palette.rubric, model: 'hex' } },
];
const NASKH = 'Amiri'; // the text: a Bulaq Naskh, with its own Latin for the note
const RUQAA = 'Aref Ruqaa'; // display: the title

// #region answer: a leading of 2 × the size for text with every vowel written
// Every letter of this maqāma carries its vowel: fatḥa and shadda over the letters, kasra
// and kasratān under them, often two marks on one letter. The marks sit in the leading,
// which never grows for them, so the leading is chosen for the most vocalised line of the
// book. Unvocalised prose sets well at 1.6 × the size; fully vocalised text needs
// 1.9–2.1 ×: here 14 pt on 28 pt, 2 ×, so a kasra hanging under one line clears a shadda
// standing on the line below. Any closer and the build reports the paragraph
// (arabicMarksExceedLeading) with the leading it would need.
const SIZE = 14; // pt
const LEAD = 2 * SIZE; // pt: 28
const bodyText = {
  fontFamily: NASKH, fontSize: pt(SIZE), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // Justified with kashidas, the default in an Arabic book, written out to say so:
  // a line widens at its joins as well as at its spaces.
  textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh',
  firstLineIndent: em(1.5), indentAfterHeading: false, // on the start side, the right
  optimalLineBreaking: true, avoidWidows: true, avoidOrphans: true,
};
// #endregion

// #region page: a 14 × 21 cm book page, seventeen lines of 28 pt

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

#Quita las vocales para una edición de lectura

tashkil: 'strip' quita las vocales breves y la šadda de la composición, de modo que el mismo texto puede ir a 1,6 veces el cuerpo; 'strip-vowels' conserva la šadda.

-  textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh',
+  textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh', tashkil: 'strip',

#Mira el aviso

Con un interlineado de 1,6 veces el cuerpo, la composición marca seis párrafos con un aviso arabicMarksExceedLeading, cada uno con el interlineado que necesita, hasta 1,89 em en este texto.

-const LEAD = 2 * SIZE; // pt: 28
+const LEAD = 1.6 * SIZE; // pt: 22.4

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 →

Aviso de maquetación · arabicMarksExceedLeading

Signos vocálicos pegados a la línea vecina

Por qué. Un párrafo de árabe vocalizado pone sus signos vocálicos (fatḥa, kasra, shadda, tanwīn…) en el interlineado, que no crece por ellos: donde un signo sobre una palabra de una línea alcanza las letras o los signos que cuelgan bajo la palabra de encima, las dos líneas se tocan.

Solución. Sube `bodyText.lineHeight` (1,7–1,85 em para texto vocalizado en parte, 1,9–2,1 em para verso vocalizado del todo), dale al párrafo un estilo de párrafo con más interlineado, o pon `bodyText.tashkil: 'strip-vowels'` para una edición sin vocales. Documentación →

Créditos

Texto
  • Al-Maqāma al-Māristāniyya, con todas sus vocales, tal como la da ar.wikisource (revisión 601165), con veinte erratas corregidas, dividida en párrafos y con sus citas del Corán entre ﴿ ﴾ · Badīʿ al-Zamān al-Hamadhānī · dominio público
  • La nota sobre el texto, la línea del título en latín y el colofón · Postext Cookbook · original
Fuentes
Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1)
Sandbox