Pular para o conteúdo principal
Receita número 111

Receitas · Capítulo 2 · Tipo e texto

Prosa clássica vocalizada e os parênteses corânicos

Uma maqāma com vogal em cada letra, composta com uma entrelinha do dobro do corpo para que os sinais de uma linha não encostem nos da linha seguinte.

Nesta página
Saída
Canvas
Nível
Básico
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.28.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto MIT

p. ٢–٣ · 2–3 de 4

  • Amostra em inglês: ainda sem edição em português
  • Refile 140 × 210 mm
  • 1 coluna
  • Amiri 14/28
  • Aref Ruqaa
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 81 ms
  • 104 linhas de código

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

script.js · linhas 28–45no código completo
// 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

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

Página 2: uma vogal em cada letra e 28 pt entre as linhas de base, de modo que as kasras de uma linha passam livres das shaddas da seguinte.

#2 · Uma página pequena com uma medida larga

script.js · linhas 49–56no código completo
// 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

script.js · linhas 60–75no código completo
// 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

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 = '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.4

Erros 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

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