En pocas palabras
Un poema árabe clásico impreso como lo imprimen los libros de poesía antiguos: cada verso partido en dos mitades, una junto a otra, estiradas hasta el mismo ancho para que sus finales queden alineados a lo largo de la página.
Lo que vas a componer
Cuatro páginas de un diván, la poesía reunida de al-Mutanabbī, como las componían los impresores de El Cairo hace un siglo: una portadilla con ديوان en ruqʿa rojo y, bajo una cabecera con filetes rojos, la casida que recitó ante Sayf al-Dawla en el año 954. Cada uno de sus cuarenta y seis bayts ocupa una línea con dos hemistiquios, el ṣadr a la derecha y el ʿajuz a la izquierda, estirados con cachidas hasta un mismo ancho, de modo que las rimas en ‑mu bajan en línea recta por el borde izquierdo. El libro se encuaderna por la derecha y los folios cuentan con cifras arábigo-índicas. Solo la nota sobre el texto, al final, cambia con la edición. Poemas Tang frente a su versión inglesa compone verso chino clásico sobre su propia retícula.
Esta receta responde a
- ¿Cómo compongo verso árabe clásico con cada verso en dos hemistiquios?
La respuesta corta
// In the Markdown, a :::verse block takes one bayt a line, the ṣadr and the ʿajuz parted
// by ||:
// :::verse{style="bayt"}
// عَلى قَدْرِ أهْلِ العَزْم تأتي العَزائِمُ || وَتأتي علَى قَدْرِ الكِرامِ المَكارمُ
// :::
// The ṣadr goes on the right, the ʿajuz on the left, both stretched to the width of the
// widest half with a gap of 2 em between them. The style gives the poem its face and a
// leading deep enough for the harakat: 1.9 × the size.
const bayt = { id: 'bayt', fontFamily: NASKH, fontSize: pt(14), lineHeight: pt(26.6),
color: col('ink'), marginTop: pt(LEAD / 2), marginBottom: pt(LEAD) };
// Justified lines lengthen their words with kashidas (tatweel) before they open the
// spaces wide: 'auto' is the default in an Arabic document, written out here to say so.
// A hemistich may stretch a word twice as far as a line of prose does: 1.2 em.
const bodyKashida = { kashida: 'auto', kashidaPatterns: 'naskh', kashidaMaxLength: 0.6 };
Ingredientes
- Funciones
- Verso árabe (bayt en dos hemistiquios)Justificación con cachidaTexto de derecha a izquierdaFuentes árabesEl árabe como idioma del documentoLibros encuadernados por la derechaCifras de los números generadosAperturas diseñadasAtributos de títuloEstilos de títuloCubiertas, portadas y colofonesCabeceras y foliosCabeceras según el tipo de páginaColor del papelEstilos de párrafoPárrafos en la otra direcciónPaleta de color semánticaExportación a PDFFuentes incrustadas en el PDF
- También usa
- Cabeceras por sección
- 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 · Un bayt por línea y sus dos mitades al mismo ancho
El código es la respuesta corta de arriba. Dentro de :::verse cada línea es un bayt y || separa los dos hemistiquios, así que el Markdown se lee como el texto de Wikisource del que procede (:::verse). El poema mide cada hemistiquio, toma la mitad más ancha como ancho de las dos columnas (hasta la mitad de la medida menos el hueco central) y llena cada mitad hasta ese ancho, primero con cachidas y después con los espacios entre palabras (Verso clásico). El estilo bayt va a 14 pt con un interlineado de 26,6 pt, 1,9 veces el cuerpo, para que las šaddas y las kasras de dos líneas seguidas no se toquen (Signos vocálicos). El formato es de 17 × 24 cm: a 14 × 21 cm un tercio de los versos no cabía en su mitad de los 104 mm de la medida y pasaba a la composición escalonada, con el ṣadr y el ʿajuz en líneas propias.

#2 · Una banda de cabecera en ruqʿa
const rule = (id, y, thickness) => ({ kind: 'rule', id, direction: 'horizontal',
thickness: pt(thickness), color: col('rubric'),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) },
size: { width: 'fill' } } });
const opener = {
enabled: true, minHeight: mm(46),
slot: { elements: [
{ kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(4) },
size: { width: 'fill', height: mm(26) } } },
rule('band-top', 4, 1.5), rule('band-foot', 30, 0.5),
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: RUQAA, fontWeight: 700,
fontSize: pt(34), lineHeight: 1.1, align: 'center', color: col('rubric'),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(7.5) } } },
{ kind: 'text', id: 'metre', content: '{attr.metre}', fontFamily: KUFI, fontWeight: 500,
fontSize: pt(9), align: 'center', color: col('muted'),
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(35) } } },
] },
};
El encabezado de nivel 1 lo dibuja su diseño: una caja tintada con un filete rojo arriba y otro abajo, el título centrado encima en Aref Ruqaa y, debajo, el metro tomado de un atributo del encabezado, {metre="من البحر الطويل"}. La tipografía de exhibición en ruqʿa no lleva cachida, así que el título conserva su ancho natural (Justificación y cachida).
#3 · Cabeceras en los lados de la hoja
// 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 header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-right', -OUTER, { color: col('ink') }),
head('verso-book', '{title}', 'even', 'top-right', -(OUTER + 10)),
head('recto-rhyme', '{subtitle}', 'odd', 'top-left', OUTER + 10),
head('recto-folio', '{pageNumber}', 'odd', 'top-left', OUTER, { color: col('ink') }),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom', 0, {
pages: 'opener', color: col('ink'),
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-12) } } })] };
El texto corre de derecha a izquierda, y en él izquierda y derecha significan principio y final. Las cabeceras, en cambio, son físicas. En un libro encuadernado por la derecha la página par queda a la derecha de la doble página, así que su folio va arriba a la derecha y el de la impar arriba a la izquierda: los dos en el borde exterior (Orden de las páginas y encuadernación por la derecha). La etiqueta locale: 'ar' basta para fijar la dirección, la encuadernación y las cifras arábigo-índicas.
#4 · Una portadilla sin nada en el flujo
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', runningChapter: false,
breakBefore: { enabled: true, parity: 'any' },
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
line('diwan', 'ديوان', 52, { fontFamily: RUQAA, fontWeight: 700, fontSize: pt(64),
lineHeight: 1.2, color: col('rubric') }),
line('poet', '{titleText}', 84, { fontFamily: NASKH, fontWeight: 700, fontSize: pt(20) }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75),
color: col('rubric'), placement: { anchor: { to: 'page', edge: 'top' },
offset: { y: mm(100) }, size: { width: mm(24) } } },
line('rhyme', '{attr.rhyme}', 106, { fontFamily: KUFI, fontWeight: 500, fontSize: pt(11),
color: col('rubric') }),
line('latin', '{attr.latin}', 150, { fontFamily: NASKH, fontSize: pt(9.5),
color: col('muted'), italic: true }),
] } },
};
La portadilla es un estilo de encabezado con span: 'page' y una cabecera y un pie vacíos. Su texto es el nombre del poeta, de modo que la palabra ديوان es texto del diseño, a 64 pt encima de él, y la línea latina bajo la rima sale del atributo latin, que cada edición escribe en su idioma.
La receta completa
// ═══ Postext Cookbook · Nº 110 · A qasida on a diwan page, in two hemistichs ═══════════
// https://postext.dev/en/cookbook/qasida-diwan-page
// Code: MIT · Text: al-Mutanabbī, Dīwān, ar.wikisource (PD) · Pictures: none
// Fonts: Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.28.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 = 'qasida-diwan-page';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black text and red rubrics on a warm paper, as a Cairo diwan of the 1900s prints them.
const palette = {
ink: '#1f1a16', // text: a warm near-black
rubric: '#9a2b1f', // the accent: titles, the metre, the headpiece rules
tint: '#f1e6cf', // the headpiece band
rule: '#b8a27c', // hairlines
muted: '#6b6156', // running heads and 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
const RUQAA = 'Aref Ruqaa'; // display: the titles
const KUFI = 'Noto Kufi Arabic'; // labels: metre, running heads, folios
const [SIZE, LEAD] = [13, 21]; // pt: the prose, at 1.6 × for a lightly vocalised headnote
const [OUTER, TOP] = [18, 23]; // mm: a 17 × 24 cm diwan
// #region answer: one bayt a line, both hemistichs stretched to one width
// In the Markdown, a :::verse block takes one bayt a line, the ṣadr and the ʿajuz parted
// by ||:
// :::verse{style="bayt"}
// عَلى قَدْرِ أهْلِ العَزْم تأتي العَزائِمُ || وَتأتي علَى قَدْرِ الكِرامِ المَكارمُ
// :::
// The ṣadr goes on the right, the ʿajuz on the left, both stretched to the width of the
// widest half with a gap of 2 em between them. The style gives the poem its face and a
// leading deep enough for the harakat: 1.9 × the size.
const bayt = { id: 'bayt', fontFamily: NASKH, fontSize: pt(14), lineHeight: pt(26.6),
color: col('ink'), marginTop: pt(LEAD / 2), marginBottom: pt(LEAD) };
// Justified lines lengthen their words with kashidas (tatweel) before they open the
// spaces wide: 'auto' is the default in an Arabic document, written out here to say so.
// A hemistich may stretch a word twice as far as a line of prose does: 1.2 em.
const bodyKashida = { kashida: 'auto', kashidaPatterns: 'naskh', kashidaMaxLength: 0.6 };
// #endregion
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
#Marca el hueco con un adorno
Algunos divanes imprimen una estrella pequeña entre los hemistiquios. ornament pone una marca en el centro del hueco sin añadirla al texto.
-:::verse{style="bayt"}
+:::verse{style="bayt" ornament="٭"}#Da a todos los hemistiquios el mismo ancho
Un width fijo da a las dos columnas la misma medida en todas las páginas del diván, sea cual sea la mitad más ancha de cada poema.
-:::verse{style="bayt"}
+:::verse{style="bayt" width=58mm}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
- La casida ʿAlā qadri ahli l-ʿazmi taʾtī l-ʿazāʾimu, tal como la da ar.wikisource (revisión 447620), con sus vocales · al-Mutanabbī · dominio público
- El encabezamiento 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)


