En pocas palabras
En Marruecos, Argelia y Túnez los libros en árabe imprimen los números con las cifras que usa Europa, 1, 2, 3, y no con ١، ٢، ٣. Un solo ajuste, el idioma y el país del documento, da esas cifras a todo el libro.
Lo que vas a componer
Un capítulo de una guía de las ciudades antiguas de Marruecos, dedicado a las puertas de Fez, tal como lo imprimiría una editorial marroquí: 13,5 × 21 cm, Noto Naskh Arabic de 12,5 pt y títulos en Noto Kufi Arabic con el verde de los azulejos de Fez. El texto va de derecha a izquierda y el libro se encuaderna por la derecha, como cualquier libro árabe, pero todos los números de la página se escriben 1, 2, 3: los folios del 41 al 44, الفصل 3, los apartados 3-1 y 3-2, la lista de puertas del 1- al 5-, las llamadas de nota (1) y el número de figura شكل 3-1. Es el uso del Magreb, de Marruecos a Túnez, y la página lo consigue con un solo ajuste. Una novela árabe encuadernada por la derecha enseña el mismo libro con las cifras ١٢ del Mashreq.
Esta receta responde a
- ¿Cómo imprimo cifras europeas (1, 2, 3) en un libro árabe para una edición magrebí?
La respuesta corta
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
- Funciones
- Cifras de los números generadosTexto de derecha a izquierdaEl árabe como idioma del documentoLibros encuadernados por la derechaFuentes árabesTipografía del textoTítulos numeradosNotas al pieListas numeradasEstilo de los piesExportación a PDF
- También usa
- Párrafos en la otra direcciónAtributos de títuloFiguras justo aquíEstilos de párrafoFuentes incrustadas en el PDFFiguras y tablas como recursosPreliminares en romanos
- Tipografía
- Noto Naskh Arabic, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · El país elige las cifras
El código está en la respuesta corta, más arriba. numerals se queda en 'auto' y el motor saca las cifras de la etiqueta: ar-MA, ar-DZ, ar-TN, ar-LY, ar-MR y ar-EH dan cifras europeas; ar a secas y las regiones del Mashreq dan ١٢٣ (Cifras y estilos de numeración). Solo cambian los números que escribe el motor: el folio, los contadores de los títulos, los números de la lista, las llamadas de nota y los números de figura. Los años del texto, 789 y 1913, son del autor, tecleados con las cifras de la edición, y el motor nunca los reescribe. El {startAt=3} del título lee tanto ٣ como 3, así que el mismo Markdown sirve para las dos ediciones.
#2 · Los signos que rodean los 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') } };
Los libros árabes escriben el número de lista seguido de un guion, 1-, y la llamada de nota entre paréntesis, (1); las dos plantillas toman las cifras del documento, así que la edición del Mashreq imprime ١- y (١) con los mismos ajustes (Notas al pie). La etiqueta del pie termina en dos puntos, شكل 3-1:, porque un punto detrás de un número se lee como separador decimal. Las notas vuelven a empezar en (1) en cada página, como las numeran casi todos los libros árabes.
#3 · Una franja de azulejos dibujada con 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>';
}
La figura es un SVG generado en el propio script: estrellas de ocho puntas hechas con dos cuadrados girados 45° y cuadrados pequeños entre ellas, en el verde, el cobalto y el ocre de la paleta. Su pie está en árabe en las dos ediciones y se numera por capítulo, {h1}-{n}, como numeran sus figuras los tipos de recurso árabes.
La receta 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 = 'es'; // @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' },
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
Errores frecuentes
Error frecuente
Etiqueta un libro árabe 'ar', no con LANG
Las ediciones de una receta son en y es, pero una muestra árabe es árabe en las dos: `locale: LANG` la compondría de izquierda a derecha, la encuadernaría por la izquierda, numeraría sus páginas 1 2 3 y llamaría Figure o Figura a sus figuras. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente como Markazi Text no dibuja las formas árabes de sus comillas angulares y sus puntos, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'ar' (cifras arábigo-índicas, la convención del Mashriq), una región como 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' para una edición magrebí con cifras europeas. Una página latina que solo cita árabe conserva su propio locale. Texto de derecha a izquierda →
Error frecuente
Las fuentes árabes necesitan su archivo arabic, con el bloque arabic
Fontsource sirve Amiri, Noto Naskh Arabic o Scheherazade New en un archivo por subconjunto, y las letras árabes están en el archivo arabic. loadFonts solo descarga latin (y latin-ext), así que en pantalla el árabe sale de una fuente del sistema y se mide mal, y fontsourceProvider entrega al PDF ese archivo latin, que imprime cajas vacías. Añade el bloque arabic del kit, llama a loadArabicFonts(FONTS, markdown) después de loadFonts, con todos los pesos que las páginas usan en árabe listados en FONTS, y pasa a renderToPdf fontProvider: arabicPdfProvider. Fuentes árabes →
Error frecuente
«1998. » o «- » al principio de un párrafo abren una lista
Un párrafo que empieza por un número, un punto y un espacio, o por un guion y un espacio, se convierte en un elemento de lista. Pon un unidor de palabras (U+2060) antes del número y escribe los diálogos con raya. Escapes y caracteres literales →
Créditos
- Receta
- Ignacio Ferro
- Texto
- «Las puertas de Fez», capítulo escrito en árabe para la receta, de un libro inventado sobre las ciudades antiguas de Marruecos · Postext Cookbook · original
- Fuentes
- Noto Naskh Arabic (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


