Saltar al contenido principal
Receta número 110

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

Una casida en una página de diván, en dos hemistiquios

Un bloque :::verse compone los cuarenta y seis versos de al-Mutanabbī en dos columnas de hemistiquios, cada mitad estirada con cachidas hasta un mismo ancho.

En esta página
Género
Poesía
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto MIT

pp. ٢–٣ · 2–3 de 4

  • Formato 170 × 240 mm
  • 1 columna
  • Amiri 13/21
  • Aref Ruqaa
  • Noto Kufi Arabic
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 95 ms
  • 144 líneas de código

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

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

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.

Página 2: cada hemistiquio se estira hasta el ancho del más largo. Una mitad corta recibe más cachidas, y todas las rimas acaban en el mismo borde izquierdo.

#2 · Una banda de cabecera en ruqʿa

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

script.js · líneas 95–109en 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 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

script.js · líneas 72–91en 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', 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

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

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