Saltar al contingut principal
Recepta número 110

Receptari · Capítol 2 · Text i tipografia

Una cassida en una pàgina de diwan, en dos hemistiquis

Un bloc :::verse compon els quaranta-sis versos d'al-Mutanabbī en dues columnes d'hemistiquis, cada meitat estirada amb caixides fins a una mateixa amplada.

En aquesta pàgina
Gènere
Poesia
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text MIT

pp. ٢–٣ · 2–3 de 4

  • Mostra en castellà: encara no hi ha edició en català
  • Format 170 × 240 mm
  • 1 columna
  • Amiri 13/21
  • Aref Ruqaa
  • Noto Kufi Arabic
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 95 ms
  • 144 línies de codi

En poques paraules

Un poema àrab clàssic imprès com l'imprimeixen els llibres de poesia antics: cada vers partit en dues meitats, l'una al costat de l'altra, estirades fins a la mateixa amplada perquè els finals quedin alineats al llarg de la pàgina.

Què compondràs

Quatre pàgines d'un diwan, la poesia aplegada d'al-Mutanabbī, com les componien els impressors del Caire fa un segle: una portadella amb ديوان en ruqʿa vermell i, sota una capçalera amb filets vermells, la cassida que va recitar davant de Sayf al-Dawla l'any 954. Cadascun dels seus quaranta-sis bayts ocupa una línia amb dos hemistiquis, el ṣadr a la dreta i el ʿajuz a l'esquerra, estirats amb caixides fins a una mateixa amplada, de manera que les rimes en ‑mu baixen en línia recta per la vora esquerra. El llibre s'enquaderna per la dreta i els folis compten amb xifres aràbigues orientals. Només la nota sobre el text, al final, canvia amb l'edició. Poemes Tang davant de la versió anglesa compon vers xinès clàssic sobre la seva pròpia retícula.

Aquesta recepta respon a

  • Com componc vers àrab clàssic amb cada vers en dos hemistiquis?

La resposta curta

script.js · línies 33–46al codi complet
// 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 };

Ingredients

També fa servir
Capçaleres per secció
Tipografia
Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Un bayt per línia i les dues meitats a la mateixa amplada

El codi és la resposta curta de dalt. Dins de :::verse cada línia és un bayt i || separa els dos hemistiquis, de manera que el Markdown es llegeix com el text de Wikisource d'on ve (:::verse). El poema mesura cada hemistiqui, pren la meitat més ampla com a amplada de les dues columnes (fins a la meitat de la mesura menys el buit central) i omple cada meitat fins a aquesta amplada, primer amb caixides i després amb els espais entre paraules (Vers clàssic). L'estil bayt va a 14 pt amb un interlineat de 26,6 pt, 1,9 vegades el cos, perquè les xaddes i les kasres de dues línies seguides no es toquin (Signes vocàlics). El format és de 17 × 24 cm: a 14 × 21 cm un terç dels versos no cabia a la seva meitat dels 104 mm de la mesura i passava a la composició esglaonada, amb el ṣadr i el ʿajuz en línies pròpies.

Pàgina 2: cada hemistiqui s'estira fins a l'amplada del més llarg. Una meitat curta rep més caixides, i totes les rimes acaben a la mateixa vora esquerra.

#2 · Una banda de capçalera en ruqʿa

script.js · línies 50–68al codi complet
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 títol de nivell 1 el dibuixa el seu disseny: una caixa tenyida amb un filet vermell a dalt i un altre a baix, el títol centrat al damunt en Aref Ruqaa i, a sota, el metre pres d'un atribut del títol, {metre="من البحر الطويل"}. La tipografia d'exhibició en ruqʿa no porta caixida, així que el títol conserva la seva amplada natural (Justificació i caixida).

#3 · Capçaleres als costats del full

script.js · línies 95–109al codi complet
// 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 text corre de dreta a esquerra, i en ell esquerra i dreta volen dir principi i final. Les capçaleres, en canvi, són físiques. En un llibre enquadernat per la dreta la pàgina parella queda a la dreta de la doble pàgina, així que el seu foli va a dalt a la dreta i el de la senar a dalt a l'esquerra: tots dos a la vora exterior (Ordre de les pàgines i enquadernació per la dreta). L'etiqueta locale: 'ar' n'hi ha prou per fixar la direcció, l'enquadernació i les xifres aràbigues orientals.

#4 · Una portadella sense res al flux

script.js · línies 72–91al codi complet
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 portadella és un estil d'encapçalament amb span: 'page' i una capçalera i un peu buits. El seu text és el nom del poeta, de manera que la paraula ديوان és text del disseny, a 64 pt al damunt, i la línia llatina sota la rima surt de l'atribut latin, que cada edició escriu en la seva llengua.

La recepta 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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Marca el buit amb un ornament

Alguns diwans imprimeixen una estrella petita entre els hemistiquis. ornament posa una marca al centre del buit sense afegir-la al text.

-:::verse{style="bayt"}
+:::verse{style="bayt" ornament="٭"}

#Dona a tots els hemistiquis la mateixa amplada

Un width fix dona a les dues columnes la mateixa mesura a totes les pàgines del diwan, sigui quina sigui la meitat més ampla de cada poema.

-:::verse{style="bayt"}
+:::verse{style="bayt" width=58mm}

Errors freqüents

Error freqüent

Etiqueta un llibre àrab 'ar', no amb LANG

Les edicions d'una recepta són en i es, però una mostra àrab és àrab en totes dues: `locale: LANG` la compondria d'esquerra a dreta, l'enquadernaria per l'esquerra, numeraria les seves pàgines 1 2 3 i anomenaria Figure o Figura les seves figures. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font com Markazi Text no dibuixa les formes àrabs de les cometes angulars i dels punts, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'ar' (xifres aràbigo-índiques, la convenció del Màixriq), una regió com 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' per a una edició magribina amb xifres europees. Una pàgina llatina que només cita àrab conserva el seu propi locale. Text de dreta a esquerra →

Error freqüent

Les fonts àrabs necessiten el seu fitxer arabic, amb el bloc arabic

Fontsource serveix Amiri, Noto Naskh Arabic o Scheherazade New en un fitxer per subconjunt, i les lletres àrabs són al fitxer arabic. loadFonts només baixa latin (i latin-ext), de manera que a la pantalla l'àrab surt d'una font del sistema i es mesura malament, i fontsourceProvider lliura al PDF aquell fitxer latin, que imprimeix caixes buides. Afegeix el bloc arabic del kit, crida loadArabicFonts(FONTS, markdown) després de loadFonts, amb tots els pesos que les pàgines fan servir en àrab llistats a FONTS, i passa a renderToPdf fontProvider: arabicPdfProvider. Fonts àrabs →

Crèdits

Text
  • The qasida ʿAlā qadri ahli l-ʿazmi taʾtī l-ʿazāʾimu, as ar.wikisource gives it (revision 447620), with its vowels · al-Mutanabbī · domini públic
  • The headnote in Arabic, the note on the text and the colophon · Postext Cookbook · original
Fonts
Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
SandboxPDF