Em poucas palavras
No Marrocos, na Argélia e na Tunísia, os livros em árabe imprimem os números com os algarismos usados na Europa, 1, 2, 3, e não com ١، ٢، ٣. Um só ajuste, o idioma e o país do documento, dá esses algarismos ao livro inteiro.
O que você vai compor
Um capítulo de um guia das cidades antigas do Marrocos, sobre as portas de Fez, como uma editora marroquina o imprimiria: 13,5 × 21 cm, Noto Naskh Arabic em 12,5 pt e títulos em Noto Kufi Arabic no verde dos azulejos de Fez. O texto corre da direita para a esquerda e o livro é encadernado pela direita, como qualquer livro árabe, mas todo número da página é escrito 1, 2, 3: os fólios de 41 a 44, الفصل 3, as seções 3-1 e 3-2, a lista de portas de 1- a 5-, as chamadas de nota (1) e o número de figura شكل 3-1. É o uso do Magrebe, do Marrocos à Tunísia, e a página o mostra com um único ajuste. Um romance árabe encadernado pela direita mostra o mesmo livro com os algarismos ١٢ do Mashreq.
Esta receita responde a
- Como imprimo algarismos europeus (1, 2, 3) em um livro árabe para uma edição magrebina?
A resposta curta
const config = () => ({
// Written out, never LANG (gotcha: arabic-locale-tag). The Moroccan tag keeps the text right
// to left and the binding on the right, and sets numerals: 'auto' to European digits: the
// folios, the chapter and section numbers, the list, the notes and the figure number.
locale: 'ar-MA',
colorPalette,
page: { width: mm(135), height: mm(210), dpi: 150, pageNumbering: { startAt: 41 },
margins: { top: mm(22), bottom: mm(22), left: mm(19), right: mm(16), mirror: true } },
layout: { layoutType: 'single' },
bodyText: { fontFamily: TEXT, fontSize: pt(12.5), lineHeight: pt(20.5), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1.5), indentAfterHeading: false },
headings: { fontFamily: LABEL, fontWeight: 700, color: col('green'), levels: [
// A chapter opens on an odd page, with no blank page forced before it.
{ level: 1, fontSize: pt(26), lineHeight: pt(41), numberingTemplate: 'الفصل {1}',
numberSeparator: ': ', breakBefore: { enabled: true, parity: 'odd' },
marginTop: pt(0), marginBottom: pt(10) },
{ level: 2, fontSize: pt(13), lineHeight: pt(20.5), numberingTemplate: '{1}-{2}',
numberSeparator: ' ', marginTop: pt(20.5), marginBottom: pt(0) },
] },
orderedLists, footnotes, captionStyle,
paragraphStyles: [{ id: 'colophon', fontFamily: TEXT, fontSize: pt(8.5), lineHeight: pt(11),
color: col('muted'), textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(20.5) }],
header: { elements: [] },
footer: { elements: [{ kind: 'text', id: 'folio', content: '{pageNumber}', fontFamily: LABEL,
fontSize: pt(9), color: col('muted'), align: 'center',
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-12) } } }] },
});
Ingredientes
- Funcionalidades
- Algarismos dos números geradosTexto da direita para a esquerdaÁrabe como idioma do documentoLivros encadernados pela direitaFontes árabesTipografia do textoTítulos numeradosNotas de rodapéListas numeradasEstilo de legendaExportação para PDF
- Também usa
- Parágrafos na outra direçãoAtributos de títuloFiguras exatamente aquiEstilos de parágrafoFontes incorporadas ao PDFFiguras e tabelas como recursosElementos pré-textuais em romanos
- Tipografia
- Noto Naskh Arabic, Noto Kufi Arabic (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · O país escolhe os algarismos
O código é a resposta curta acima. numerals fica em 'auto', e o motor tira os algarismos da etiqueta: ar-MA, ar-DZ, ar-TN, ar-LY, ar-MR e ar-EH dão algarismos europeus; ar sozinho e as regiões do Mashreq dão ١٢٣ (Algarismos e estilos de numeração). Só mudam os números que o motor escreve: o fólio, os contadores dos títulos, os números da lista, as chamadas de nota, os números de figura. Os anos do texto, 789 e 1913, são do autor, digitados com os algarismos da edição, e o motor nunca os reescreve. O {startAt=3} do título aceita tanto ٣ quanto 3, por isso o mesmo Markdown serve às duas edições.
#2 · Os sinais em volta dos números
// «1-» and «(1)», as Arabic books write them; the number itself follows numerals.
const orderedLists = { color: col('green'), fontWeight: 700, marginTop: pt(0),
marginBottom: pt(0), levels: [{ level: 1, numberFormat: 'arabic', separator: '-' }] };
const footnotes = { markerTemplate: '({n})', numbering: 'page', noteNumberPosition: 'inline',
fontSize: pt(10), lineHeight: pt(15), separator: { width: 0.3, color: col('green') } };
// A colon after the label: a full stop after a number reads as a decimal point.
const captionStyle = { fontFamily: TEXT, fontSize: pt(10), color: col('ink'), labelBold: true,
labelColor: col('green'), labelSeparator: ': ', note: { color: col('muted') } };
Os livros árabes escrevem o número de lista seguido de um hífen, 1-, e a chamada de nota entre parênteses, (1); os dois modelos usam os algarismos do documento, e assim a edição do Mashreq imprime ١- e (١) com as mesmas configurações (Notas de rodapé). O rótulo da legenda termina em dois-pontos, شكل 3-1:, porque um ponto depois de um número é lido como separador decimal. As notas recomeçam em (1) a cada página, como a maioria dos livros árabes as numera.
#3 · Uma faixa de azulejos desenhada em código
// The star is two squares turned 45°; between four stars a small square. Paths only.
const star = (cx, cy, r) => {
const pts = [];
for (let k = 0; k < 16; k++) {
const a = (k * Math.PI) / 8;
const d = k % 2 ? r * 0.7654 : r; // where the two squares' sides cross
pts.push(`${(cx + d * Math.sin(a)).toFixed(2)} ${(cy - d * Math.cos(a)).toFixed(2)}`);
}
return `M${pts.join('L')}Z`;
};
function zellige(W, H, S) {
let stars = '';
let inner = '';
let squares = '';
for (let y = 0; y <= H + S; y += S) {
for (let x = 0; x <= W + S; x += S) {
stars += star(x, y, S * 0.47);
inner += star(x, y, S * 0.2);
squares += `M${x + S / 2} ${y + S / 2 - S * 0.17}l${S * 0.17} ${S * 0.17}`
+ `l${-S * 0.17} ${S * 0.17}l${-S * 0.17} ${-S * 0.17}Z`;
}
}
return `<svg xmlns="http://www.w3.org/2000/svg" width="${W * 10}" height="${H * 10}" `
+ `viewBox="0 0 ${W} ${H}"><rect width="${W}" height="${H}" fill="${palette.green}"/>`
+ `<path d="${stars}" fill="${palette.cobalt}" stroke="${palette.paper}" stroke-width="0.5"/>`
+ `<path d="${inner}" fill="${palette.paper}"/>`
+ `<path d="${squares}" fill="${palette.ochre}" stroke="${palette.paper}" stroke-width="0.4"/>`
+ '</svg>';
}
A figura é um SVG gerado no próprio script: estrelas de oito pontas feitas de dois quadrados girados 45° e quadrados pequenos entre elas, no verde, no cobalto e no ocre da paleta. A legenda é em árabe nas duas edições, numerada pelo capítulo, {h1}-{n}, como os tipos de recurso árabes numeram as figuras.
A receita completa
// ═══ Postext Cookbook · Nº 109 · A Maghreb edition of an Arabic text, with European digits ═══
// https://postext.dev/en/cookbook/maghreb-edition-european-digits
// Code: MIT · Text: original Arabic prose (CC BY 4.0) · Pattern: drawn in code
// Fonts: Noto Naskh Arabic, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the frame; the chapter is Arabic in both editions
const RECIPE = 'maghreb-edition-european-digits';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// The green and cobalt of Fes tilework, on a white book paper.
const palette = {
ink: '#1c1d1b', // text
green: '#1d6650', // the accent: headings, the list numbers, the notes' rule
cobalt: '#25488a', // the tile's second colour
ochre: '#c99a3e', // the tile's third colour
muted: '#62655f', // folios, captions' notes, the colophon
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.green })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, LABEL] = ['Noto Naskh Arabic', 'Noto Kufi Arabic'];
// #region marks: list numbers, note markers and figure numbers in the same digits
// «1-» and «(1)», as Arabic books write them; the number itself follows numerals.
const orderedLists = { color: col('green'), fontWeight: 700, marginTop: pt(0),
marginBottom: pt(0), levels: [{ level: 1, numberFormat: 'arabic', separator: '-' }] };
const footnotes = { markerTemplate: '({n})', numbering: 'page', noteNumberPosition: 'inline',
fontSize: pt(10), lineHeight: pt(15), separator: { width: 0.3, color: col('green') } };
// A colon after the label: a full stop after a number reads as a decimal point.
const captionStyle = { fontFamily: TEXT, fontSize: pt(10), color: col('ink'), labelBold: true,
labelColor: col('green'), labelSeparator: ': ', note: { color: col('muted') } };
// #endregion
// #region answer: ar-MA prints 1, 2, 3 in every number the engine writes
const config = () => ({
// Written out, never LANG (gotcha: arabic-locale-tag). The Moroccan tag keeps the text right
// to left and the binding on the right, and sets numerals: 'auto' to European digits: the
// folios, the chapter and section numbers, the list, the notes and the figure number.
locale: 'ar-MA',
colorPalette,
page: { width: mm(135), height: mm(210), dpi: 150, pageNumbering: { startAt: 41 },
margins: { top: mm(22), bottom: mm(22), left: mm(19), right: mm(16), mirror: true } },
layout: { layoutType: 'single' },
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
#Imprimir os algarismos do Mashreq
A edição egípcia ou levantina do mesmo capítulo: muda a etiqueta, não o Markdown.
- locale: 'ar-MA',
+ locale: 'ar-EG',#Manter a etiqueta marroquina e imprimir ١٢٣
Um ajuste escrito explicitamente prevalece sobre o padrão da região.
locale: 'ar-MA',
+ numerals: 'arab',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 →
Erro comum
'1998. ' ou '- ' no início de um parágrafo abre uma lista
Um parágrafo que começa com um número, um ponto e um espaço, ou com um hífen e um espaço, vira item de lista. Coloque um word joiner (U+2060) antes do número e escreva os diálogos com travessão. Escapes e caracteres literais →
Créditos
- Receita
- Ignacio Ferro
- Texto
- “The gates of Fes”, a chapter written in Arabic for the recipe, from an invented book on the old cities of Morocco · Postext Cookbook · original
- Fontes
- Noto Naskh Arabic (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)


