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
// 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
- Funcions
- Vers àrab (bayt en dos hemistiquis)Justificació amb caixidaText de dreta a esquerraFonts àrabsL'àrab com a llengua del documentLlibres enquadernats per la dretaXifres dels números generatsObertures dissenyadesAtributs de títolEstils de títolCobertes, portades i colofonsCapçaleres i folisCapçaleres segons el tipus de pàginaColor del paperEstils de paràgrafParàgrafs en l'altra direccióPaleta de color semànticaExportació a PDFFonts incrustades al PDF
- 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.

#2 · Una banda de capçalera 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 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
// 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
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
// ═══ 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


