En poques paraules
Un relat àrab antic imprès amb tots els seus petits signes de vocal damunt i sota les lletres. Les línies van prou separades perquè els signes d'una no xoquin amb la de sota.
Què compondràs
Quatre pàgines d'un llibre àrab clàssic en què cada lletra porta la seva vocal: la Maqāma del manicomi d'al-Hamadhānī, en què un boig del manicomi de Bàssora deixa sense resposta un teòleg i després diu el seu nom en vers. El text amb totes les vocals apila fatḥa i xadda damunt les lletres i kasra a sota, i aquests signes viuen a l'espai entre línies. Per això la pàgina es compon en Amiri a 14 pt sobre 28 pt, el doble del cos, i res més: l'interlineat és el disseny. El text va justificat amb caixides, amb un sagnat d'1,5 em a la dreta, i les seves tres cites de l'Alcorà van entre els parèntesis ornamentals ﴿ ﴾ del muṣḥaf imprès. Només la línia llatina del títol i la nota sobre el text canvien amb l'edició.
Aquesta recepta respon a
- Quant interlineat necessita l'àrab amb totes les vocals?
La resposta curta
// 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,
};
Ingredients
- Funcions
- Fonts àrabsTipografia del textText de dreta a esquerraL'àrab com a llengua del documentSagnats, alineació i separació de paràgrafsJustificació amb caixidaVers àrab (bayt en dos hemistiquis)Llibres enquadernats per la dretaParàgrafs en l'altra direccióNivells de títolFormat de pàginaMarges simètricsColor del paperPaleta de color semànticaPàgines en un canvas
- També fa servir
- Xifres dels números generatsAtributs de títolSalts de pàgina i de columnaEstils de paràgraf
- Tipografia
- Amiri, Aref Ruqaa (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un interlineat del doble del cos
El codi és la resposta curta de dalt. L'interlineat no creix mai per fer lloc als signes: la kasra d'una línia i la xadda de la següent comparteixen el mateix buit, així que el buit es tria per a la línia més vocalitzada del llibre (Signes vocàlics). Amb aquest text, un interlineat d'1,6 vegades el cos deixa sis paràgrafs amb signes que xoquen, i 1,9 encara en deixa un; amb 2 no en queda cap. La composició ho avisa: quan dues línies xoquen, dona per al paràgraf l'avís arabicMarksExceedLeading amb l'interlineat que necessitaria (Text àrab).

#2 · Una pàgina petita amb una mesura ampla
// 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 amb marges laterals de 16 i 18 mm deixa una mesura de 106 mm, unes dotze paraules vocalitzades, i disset línies amb el pas de 28 pt. Els signes engrisen les línies, així que la pàgina queda sòbria: sense capçaleres, paper crema i un sol títol en vermell. mirror: true posa el marge més ample al llom, que en un llibre enquadernat per la dreta és la vora dreta de la pàgina senar (Ordre de les pàgines i enquadernació per la dreta).
#3 · Títols que respecten 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) },
],
};
Els títols no porten disseny: el títol en ruqʿa ocupa una caixa de línia de tres línies de la retícula, i l'autor i la línia llatina n'ocupen una de 28 pt cadascun, així que la primera línia de text cau a la retícula. La línia llatina porta {dir=ltr}: un títol d'esquerra a dreta en un llibre de dreta a esquerra (Direcció del document, del bloc i del text en línia).
La recepta 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
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
#Treu les vocals per a una edició de lectura
tashkil: 'strip' treu les vocals breus i la xadda de la composició, de manera que el mateix text pot anar a 1,6 vegades el cos; 'strip-vowels' conserva la xadda.
- textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh',
+ textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh', tashkil: 'strip',#Mira l'avís
Amb un interlineat d'1,6 vegades el cos, la composició dona l'avís arabicMarksExceedLeading per a sis paràgrafs, cadascun amb l'interlineat que necessita, fins a 1,89 em en aquest text.
-const LEAD = 2 * SIZE; // pt: 28
+const LEAD = 1.6 * SIZE; // pt: 22.4Errors 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 →
Avís de maquetació · arabicMarksExceedLeading
Signes vocàlics enganxats a la línia veïna
Per què. Un paràgraf d'àrab vocalitzat posa els signes vocàlics (fatḥa, kasra, shadda, tanwīn…) a l'interlineat, que no creix per ells: on un signe damunt d'una paraula d'una línia arriba a les lletres o als signes que pengen sota la paraula de sobre, les dues línies es toquen.
Solució. Apuja `bodyText.lineHeight` (1,7–1,85 em per a text vocalitzat en part, 1,9–2,1 em per a vers vocalitzat del tot), dona al paràgraf un estil de paràgraf amb més interlineat, o posa `bodyText.tashkil: 'strip-vowels'` per a una edició sense vocals. Documentació →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Al-Maqāma al-Māristāniyya, fully vocalised, as ar.wikisource gives it (revision 601165), with twenty typing slips corrected, its paragraphs divided and its Qurʾān quotations set between ﴿ ﴾ · Badīʿ al-Zamān al-Hamadhānī · domini públic
- The note on the text, the Latin title line and the colophon · Postext Cookbook · original
- Fonts
- Amiri (SIL OFL 1.1) · Aref Ruqaa (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)


