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
// 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
- Funciones
- Fuentes árabesTipografía del textoTexto de derecha a izquierdaEl árabe como idioma del documentoSangrías, alineación y separación de párrafosJustificación con cachidaVerso árabe (bayt en dos hemistiquios)Libros encuadernados por la derechaPárrafos en la otra direcciónNiveles de títuloFormato de páginaMárgenes simétricosColor del papelPaleta de color semánticaPáginas en un canvas
- También usa
- Cifras de los números generadosAtributos de títuloSaltos de página y de columnaEstilos de párrafo
- 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).

#2 · Una página pequeña con una medida ancha
// 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
// 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
// ═══ 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.4Errores 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
- Receta
- Ignacio Ferro
- 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)
- 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)


