En poques paraules
Al Marroc, Algèria i Tunísia els llibres en àrab imprimeixen els números amb les xifres que fa servir Europa, 1, 2, 3, i no amb ١، ٢، ٣. Un sol paràmetre, la llengua i el país del document, dona aquestes xifres a tot el llibre.
Què compondràs
Un capítol d'una guia de les ciutats antigues del Marroc, dedicat a les portes de Fes, tal com l'imprimiria una editorial marroquina: 13,5 × 21 cm, Noto Naskh Arabic de 12,5 pt i títols en Noto Kufi Arabic amb el verd de les rajoles de Fes. El text va de dreta a esquerra i el llibre s'enquaderna per la dreta, com qualsevol llibre àrab, però tots els números de la pàgina s'escriuen 1, 2, 3: els folis del 41 al 44, الفصل 3, els apartats 3-1 i 3-2, la llista de portes de l'1- al 5-, les crides de nota (1) i el número de figura شكل 3-1. És l'ús del Magrib, del Marroc a Tunísia, i la pàgina ho aconsegueix amb un sol paràmetre. Una novel·la àrab enquadernada per la dreta mostra el mateix llibre amb les xifres ١٢ del Màixriq.
Aquesta recepta respon a
- Com imprimeixo xifres europees (1, 2, 3) en un llibre àrab per a una edició magrebina?
La 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) } } }] },
});
Ingredients
- Funcions
- Xifres dels números generatsText de dreta a esquerraL'àrab com a llengua del documentLlibres enquadernats per la dretaFonts àrabsTipografia del textTítols numeratsNotes a peu de pàginaLlistes numeradesEstil dels peusExportació a PDF
- També fa servir
- Paràgrafs en l'altra direccióAtributs de títolFigures just aquíEstils de paràgrafFonts incrustades al PDFFigures i taules com a recursosPreliminars en romans
- Tipografia
- Noto Naskh Arabic, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · El país tria les xifres
El codi és a la resposta curta, més amunt. numerals es queda en 'auto' i el motor treu les xifres de l'etiqueta: ar-MA, ar-DZ, ar-TN, ar-LY, ar-MR i ar-EH donen xifres europees; ar sol i les regions del Màixriq donen ١٢٣ (Xifres i estils de numeració). Només canvien els números que escriu el motor: el foli, els comptadors dels títols, els números de la llista, les crides de nota i els números de figura. Els anys del text, 789 i 1913, són de l'autor, teclejats amb les xifres de l'edició, i el motor no els reescriu mai. El {startAt=3} del títol llegeix tant ٣ com 3, de manera que el mateix Markdown serveix per a les dues edicions.
#2 · Els signes que envolten els 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') } };
Els llibres àrabs escriuen el número de llista seguit d'un guionet, 1-, i la crida de nota entre parèntesis, (1); totes dues plantilles prenen les xifres del document, així que l'edició del Màixriq imprimeix ١- i (١) amb els mateixos ajustos (Notes a peu de pàgina). L'etiqueta del peu acaba en dos punts, شكل 3-1:, perquè un punt darrere d'un número es llegeix com a separador decimal. Les notes tornen a començar per (1) a cada pàgina, com les numeren gairebé tots els llibres àrabs.
#3 · Una franja de rajoles dibuixada amb codi
// 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 és un SVG generat al mateix script: estrelles de vuit puntes fetes amb dos quadrats girats 45° i quadrats petits entre elles, en el verd, el cobalt i l'ocre de la paleta. El seu peu és en àrab a les dues edicions i es numera per capítol, {h1}-{n}, com numeren les figures els tipus de recurs àrabs.
La recepta 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' },
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Imprimeix les xifres del Màixriq
L'edició egípcia o llevantina del mateix capítol: canvia l'etiqueta, no el Markdown.
- locale: 'ar-MA',
+ locale: 'ar-EG',#Mantén l'etiqueta marroquina i imprimeix ١٢٣
Un paràmetre escrit té prioritat sobre el valor per defecte de la regió.
locale: 'ar-MA',
+ numerals: 'arab',Errors freqüents
Error freqüent
Etiqueta un llibre àrab 'ar', no amb LANG
Les edicions d'una recepta són en i es, però una mostra àrab és àrab en totes dues: `locale: LANG` la compondria d'esquerra a dreta, l'enquadernaria per l'esquerra, numeraria les seves pàgines 1 2 3 i anomenaria Figure o Figura les seves figures. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font com Markazi Text no dibuixa les formes àrabs de les cometes angulars i dels punts, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'ar' (xifres aràbigo-índiques, la convenció del Màixriq), una regió com 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' per a una edició magribina amb xifres europees. Una pàgina llatina que només cita àrab conserva el seu propi locale. Text de dreta a esquerra →
Error freqüent
Les fonts àrabs necessiten el seu fitxer arabic, amb el bloc arabic
Fontsource serveix Amiri, Noto Naskh Arabic o Scheherazade New en un fitxer per subconjunt, i les lletres àrabs són al fitxer arabic. loadFonts només baixa latin (i latin-ext), de manera que a la pantalla l'àrab surt d'una font del sistema i es mesura malament, i fontsourceProvider lliura al PDF aquell fitxer latin, que imprimeix caixes buides. Afegeix el bloc arabic del kit, crida loadArabicFonts(FONTS, markdown) després de loadFonts, amb tots els pesos que les pàgines fan servir en àrab llistats a FONTS, i passa a renderToPdf fontProvider: arabicPdfProvider. Fonts àrabs →
Error freqüent
«1998. » o «- » al començament d'un paràgraf obren una llista
Un paràgraf que comença per un número, un punt i un espai, o per un guionet i un espai, es converteix en un element de llista. Posa un unidor de paraules (U+2060) davant del número i escriu els diàlegs amb guió llarg. Escapaments i caràcters literals →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- “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
- Fonts
- Noto Naskh Arabic (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


