Saltar al contingut principal
Recepta número 111

Receptari · Capítol 2 · Text i tipografia

Prosa clàssica vocalitzada i els parèntesis alcorànics

Una maqāma amb vocal a cada lletra, composta amb un interlineat del doble del cos perquè els signes d'una línia no toquin els de la següent.

En aquesta pàgina
Sortida
Canvas
Nivell
Bàsic
Postext
Provada amb Postext 1.65.0
Requereix ≥ 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 140 × 210 mm
  • 1 columna
  • Amiri 14/28
  • Aref Ruqaa
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 90 ms
  • 104 línies de codi

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

script.js · línies 28–45al codi complet
// 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

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

Pàgina 2: una vocal a cada lletra i 28 pt entre línies de base, de manera que les kasres d'una línia no toquen les xaddes de la següent.

#2 · Una pàgina petita amb una mesura ampla

script.js · línies 49–56al codi complet
// 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

script.js · línies 60–75al codi complet
// 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

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

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 →

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

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