Em poucas palavras
Um poema árabe clássico impresso como nos livros antigos de poesia: cada verso dividido em duas metades lado a lado, esticadas até a mesma largura para que os finais fiquem alinhados ao longo da página.
O que você vai compor
Quatro páginas de um divã, a poesia reunida de al-Mutanabbī, como os impressores do Cairo a compunham um século atrás: um anterrosto com ديوان em ruqʿa vermelho e depois, sob um cabeção com fios vermelhos, a qasida que ele recitou diante de Sayf al-Dawla em 954. Cada um dos quarenta e seis bayts é uma linha de dois hemistíquios, o ṣadr à direita e o ʿajuz à esquerda, os dois esticados com kashidas até a mesma largura, e assim as rimas em ‑mu descem em linha reta pela borda esquerda. O livro é encadernado pela direita, e os fólios contam com algarismos arábico-índicos. Só a nota sobre o texto, no fim, muda com a edição. Poemas Tang diante dos versos em inglês compõe verso chinês clássico na própria grade.
Esta receita responde a
- Como componho verso árabe clássico com cada verso dividido em dois hemistíquios?
A 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 };
Ingredientes
- Funcionalidades
- Verso árabe (bayt em dois hemistíquios)Justificação com kashidaTexto da direita para a esquerdaFontes árabesÁrabe como idioma do documentoLivros encadernados pela direitaAlgarismos dos números geradosAberturas desenhadasAtributos de títuloEstilos de títuloCapas, folhas de rosto e colofõesCabeços e fóliosCabeços por tipo de páginaCor do papelEstilos de parágrafoParágrafos na outra direçãoPaleta de cores semânticaExportação para PDFFontes incorporadas ao PDF
- Também usa
- Cabeços por seção
- Tipografia
- Amiri, Aref Ruqaa, Noto Kufi Arabic (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Um bayt por linha, as duas metades com a mesma largura
O código é a resposta curta logo acima. Dentro de :::verse, cada linha é um bayt, e || separa os dois hemistíquios, de modo que o Markdown se lê como o texto do Wikisource de onde veio (:::verse). O poema mede cada hemistíquio, toma a metade mais larga como largura das duas colunas (até metade da medida menos o vão central) e preenche cada metade até essa largura, primeiro com kashidas e depois com os espaços entre palavras (Verso clássico). O estilo bayt é composto em 14 pt com passo de 26,6 pt, 1,9 vez o corpo, para que as šaddas e as kasras de linhas vizinhas não se encostem (Sinais vocálicos). O formato é de 17 × 24 cm: em 14 × 21 cm, um terço dos bayts não cabia na metade da medida de 104 mm e caía num arranjo escalonado, com o ṣadr e o ʿajuz em linhas próprias.

#2 · Uma faixa de cabeção em 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) } } },
] },
};
O título de nível 1 é desenhado pelo design: uma caixa tingida com um fio vermelho em cima e outro embaixo, o título centralizado sobre ela em Aref Ruqaa e, abaixo, o metro, tirado de um atributo do título, {metre="من البحر الطويل"}. Letra de display em ruqʿa não leva kashida, por isso o título mantém a largura natural (Justificação e kashida).
#3 · Cabeços nos lados da folha
// 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) } } })] };
O texto corrido vai da direita para a esquerda, e nele esquerda e direita significam início e fim. Os cabeços continuam físicos. Num livro encadernado pela direita, o verso, uma página par, fica do lado direito da página dupla, por isso o fólio vai no alto à direita e o do reto no alto à esquerda: os dois ficam na borda externa (Ordem das páginas e encadernação à direita). Só a etiqueta locale: 'ar' já define a direção, a encadernação e os algarismos arábico-índicos.
#4 · Um anterrosto sem nada no fluxo
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 }),
] } },
};
O anterrosto é um estilo de título com span: 'page' e cabeçalho e rodapé próprios, vazios. O texto do título é o nome do poeta, de modo que a palavra ديوان é texto de design, composta em 64 pt acima dele, e a linha em caracteres latinos sob a rima vem do atributo latin, que cada edição escreve no idioma.
A receita 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 = 'en'; // @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
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
#Marque o vão com um ornamento
Alguns divãs imprimem uma estrelinha entre os hemistíquios. ornament põe uma marca no meio do vão sem acrescentá-la ao texto.
-:::verse{style="bayt"}
+:::verse{style="bayt" ornament="٭"}#Dê a mesma largura a todos os hemistíquios
Uma width fixa dá às duas colunas a mesma medida em todas as páginas do divã, seja qual for a metade mais larga de cada poema.
-:::verse{style="bayt"}
+:::verse{style="bayt" width=58mm}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 →
Créditos
- Receita
- Ignacio Ferro
- Texto
- The qasida ʿAlā qadri ahli l-ʿazmi taʾtī l-ʿazāʾimu, as ar.wikisource gives it (revision 447620), with its vowels · al-Mutanabbī · domínio público
- The headnote in Arabic, the note on the text and the colophon · Postext Cookbook · original
- Fontes
- Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1) · Noto Kufi Arabic (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)


