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

Receitas · Capítulo 2 · Tipo e texto

Uma qasida numa página de divã, em dois hemistíquios

Um bloco :::verse compõe os quarenta e seis bayts de al-Mutanabbī em duas colunas de hemistíquios, cada metade esticada com kashidas até a mesma largura.

Nesta página
Gênero
Poesia
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.28.0 · postext-pdf ≥ 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 170 × 240 mm
  • 1 coluna
  • Amiri 13/21
  • Aref Ruqaa
  • Noto Kufi Arabic
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 97 ms
  • 144 linhas de código

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

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

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.

Página 2: cada hemistíquio esticado até a largura do mais largo. Uma metade curta recebe mais kashidas, e todas as rimas terminam na mesma borda esquerda.

#2 · Uma faixa de cabeção em ruqʿa

script.js · linhas 50–68no código completo
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

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

script.js · linhas 72–91no código completo
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

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

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