Em poucas palavras
Uma história árabe antiga impressa com todos os sinaizinhos de vogal em cima e embaixo das letras. As linhas ficam afastadas o bastante para que os sinais de uma não batam nos da linha de baixo.
O que você vai compor
Quatro páginas de um livro árabe clássico em que cada letra leva a vogal: a Maqāma do hospício, de al-Hamadhānī, em que um louco do hospício de Basra deixa um teólogo sem resposta e depois diz o próprio nome em verso. O texto com todas as vogais empilha fatḥa e shadda em cima das letras e kasra embaixo, e esses sinais moram no espaço entre as linhas. Por isso a página é composta em Amiri, 14 pt sobre 28 pt, o dobro do corpo, e mais nada: a entrelinha é o projeto gráfico. O texto é justificado com kashidas, abre com um recuo de 1,5 em à direita e põe as três citações do Corão entre os parênteses ornamentais ﴿ ﴾ do muṣḥaf impresso. Só a linha latina do título e a nota sobre o texto mudam com a edição.
Esta receita responde a
- De quanta entrelinha o árabe totalmente vocalizado precisa?
A 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,
};
Ingredientes
- Funcionalidades
- Fontes árabesTipografia do textoTexto da direita para a esquerdaÁrabe como idioma do documentoRecuos, alinhamento e espaço entre parágrafosJustificação com kashidaVerso árabe (bayt em dois hemistíquios)Livros encadernados pela direitaParágrafos na outra direçãoNíveis de títuloFormato da páginaMargens espelhadasCor do papelPaleta de cores semânticaPáginas em um canvas
- Também usa
- Algarismos dos números geradosAtributos de títuloQuebras de página e de colunaEstilos de parágrafo
- Tipografia
- Amiri, Aref Ruqaa (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Uma entrelinha do dobro do corpo
O código é a resposta curta acima. A entrelinha nunca cresce para abrir espaço para os sinais: a kasra de uma linha e a shadda da seguinte dividem o mesmo vão, por isso o vão é escolhido pela linha mais vocalizada do livro (Sinais vocálicos). Neste texto, uma entrelinha de 1,6 vez o corpo deixa seis parágrafos com sinais que se chocam, e 1,9 ainda deixa um; com 2, nenhum. A composição avisa: quando duas linhas se chocam, ela aponta o parágrafo com arabicMarksExceedLeading e a entrelinha de que ele precisaria (Texto árabe).

#2 · Uma página pequena com uma medida larga
// 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 },
};
Uma página de 14 × 21 cm com margens laterais de 16 e 18 mm deixa uma medida de 106 mm, umas doze palavras vocalizadas, e dezessete linhas no passo de 28 pt. Os sinais deixam as linhas acinzentadas, de modo que a página fica sóbria: sem cabeços, papel creme e um único título em vermelho. mirror: true põe a margem mais larga na lombada, que num livro encadernado pela direita é a borda direita de uma página ímpar (Ordem das páginas e encadernação pela direita).
#3 · Títulos que respeitam a grade
// 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) },
],
};
Os títulos não têm desenho: o título em ruqʿa ocupa uma caixa de linha com a altura de três linhas da grade, e o autor e a linha latina ocupam uma linha de 28 pt cada um, por isso a primeira linha de texto cai na grade. A linha latina leva {dir=ltr}, um título da esquerda para a direita num livro da direita para a esquerda (Direção do documento, do bloco e do texto em linha).
A receita 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 = 'en'; // @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
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Tirar as vogais para uma edição de leitura
tashkil: 'strip' remove da composição as vogais breves e a shadda, de modo que o mesmo texto pode ser composto com 1,6 vez o corpo; 'strip-vowels' mantém a shadda.
- textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh',
+ textAlign: 'justify', kashida: 'auto', kashidaPatterns: 'naskh', tashkil: 'strip',#Ver o aviso
Com a entrelinha em 1,6 vez o corpo, a composição aponta seis parágrafos com arabicMarksExceedLeading, cada um com a entrelinha de que precisa, até 1,89 em neste texto.
-const LEAD = 2 * SIZE; // pt: 28
+const LEAD = 1.6 * SIZE; // pt: 22.4Erros comuns
Erro comum
Marque um livro árabe como 'ar', não com LANG
As edições de uma receita são en e es, mas uma amostra árabe é árabe nas duas: `locale: LANG` a comporia da esquerda para a direita, a encadernaria pela esquerda, numeraria as suas páginas 1 2 3 e chamaria as suas figuras de Figure ou Figura. Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então, sob uma marcação inglesa ou espanhola, uma fonte como a Markazi Text não desenha as formas árabes das aspas angulares e dos pontos, e as linhas quebram em outro ponto. Escreva você mesmo a marcação: 'ar' (algarismos arábico-índicos, a convenção do Machrek), uma região como 'ar-EG' ou 'ar-SA', ou 'ar-MA', 'ar-DZ' ou 'ar-TN' para uma edição magrebina com algarismos europeus. Uma página latina que só cita árabe mantém o seu próprio locale. Texto da direita para a esquerda →
Erro comum
Fontes árabes precisam do seu arquivo arabic, pelo bloco arabic
O Fontsource serve Amiri, Noto Naskh Arabic ou Scheherazade New em um arquivo por subconjunto, e as letras árabes estão no arquivo arabic. loadFonts baixa só latin (e latin-ext), então na tela o árabe vem de uma fonte do sistema e é medido errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que imprime caixas vazias. Inclua o bloco arabic do kit, chame loadArabicFonts(FONTS, markdown) depois de loadFonts, com todos os pesos que as páginas usam em árabe listados em FONTS, e passe a renderToPdf fontProvider: arabicPdfProvider. Fontes árabes →
Aviso de diagramação · arabicMarksExceedLeading
Sinais vocálicos encostam na linha vizinha
Por quê. Um parágrafo de árabe vocalizado coloca os sinais vocálicos (fatḥa, kasra, shadda, tanwīn…) na entrelinha, que não cresce por causa deles: onde um sinal sobre uma palavra de uma linha alcança as letras ou os sinais pendurados sob a palavra de cima, as duas linhas se tocam.
Correção. Aumente `bodyText.lineHeight` (1,7–1,85 em para texto vocalizado em parte, 1,9–2,1 em para verso totalmente vocalizado), dê ao parágrafo um estilo de parágrafo com mais entrelinha ou defina `bodyText.tashkil: 'strip-vowels'` para uma edição sem vogais. Docs →
Créditos
- Receita
- Ignacio Ferro
- Texto
- 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ī · domínio público
- The note on the text, the Latin title line and the colophon · Postext Cookbook · original
- Fontes
- Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


