En poques paraules
La memòria anual d'una fundació escrita en àrab, amb cada paràgraf seguit de la seva versió en castellà. La pàgina barreja les dues direccions sense que es desordenin les paraules, els números ni les taules.
Què compondràs
La memòria del 2025 d'una fundació de traducció imaginària, Dar al-Dad, en una pàgina de 210 × 280 mm amb IBM Plex Sans Arabic i IBM Plex Sans, les dues meitats d'una mateixa família. La memòria és àrab: va de dreta a esquerra i numera les pàgines ٢, ٣. Cada paràgraf àrab va seguit de la seva versió en castellà, més petita i en gris pissarra, composta d'esquerra a dreta i en bandera per la dreta; cada títol àrab porta un rètol en castellà a l'altre marge. Els noms llatins dins de les frases àrabs conserven el seu ordre, i les xifres de l'any apareixen dues vegades, en una taula àrab que es llegeix des de la dreta i en una altra que es llegeix des de l'esquerra. A l'edició anglesa, la segona llengua és l'anglès.
Aquesta recepta respon a
- Com barrejo paràgrafs, números i taules en àrab i en anglès en una mateixa pàgina?
La resposta curta
// The document is Arabic (locale 'ar'): right to left, Arabic-Indic digits. A block in the
// other language says so in the Markdown, and its style gives it its own voice:
// :::paragraphs{style="second" dir=ltr} a paragraph or several, set left to right
// ### Director's note {style="second-head" dir=ltr}
// Inside an Arabic sentence, a Latin name is an isolate, :ltr[Penguin Classics]{lang=en}, so
// the words around it keep their order. 'start' and 'end' follow each block's own direction.
const second = { id: 'second', fontFamily: LATIN, fontSize: pt(9.5), lineHeight: pt(14),
color: col('slate'), textAlign: 'start', firstLineIndent: pt(0) };
const bodyText = { fontFamily: ARABIC, fontSize: pt(11), lineHeight: pt(LEAD),
color: col('ink'), boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'start', // ragged: the right edge for Arabic, the left for an English block
firstLineIndent: pt(0), paragraphSpacing: true,
// The Arabic is never slanted; italics stay for the titles in the Latin blocks.
emphasis: 'italic' };
Ingredients
- Funcions
- Paràgrafs en l'altra direccióFragments en l'altra direccióText de dreta a esquerraFonts àrabsL'àrab com a llengua del documentXifres dels números generatsTaules a partir de dadesEstil de taulesEstils de taula amb nomEstil dels peusTipus de recurs propisObertures dissenyadesEstils de títolEstils de paràgrafPaleta de color semànticaExportació a PDF
- També fa servir
- Atributs de títolFigures just aquíFigura i Taula en la teva llenguaCapçaleres segons el tipus de pàginaFonts incrustades al PDFLlibres enquadernats per la dreta
- Tipografia
- IBM Plex Sans Arabic, IBM Plex Sans (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · La segona llengua, en blocs marcats
El codi és a la resposta curta, més amunt. El document és àrab, així que tots els blocs van de dreta a esquerra mentre el Markdown no digui una altra cosa: {dir=ltr} a la línia d'obertura d'un :::paragraphs o en un títol gira aquell bloc, i textAlign: 'start' porta cada bloc al costat pel qual comença, la dreta en àrab i l'esquerra en castellà (Direcció del document, del bloc i del text en línia). Un nom llatí dins d'una línia àrab, :ltr[Harbour Modern Classics], és un aïllament: l'algorisme bidireccional el tracta com una sola peça neutra, i les paraules àrabs i la coma que l'envolten no es mouen (Aïllaments). emphasis: 'italic' deixa Middlemarch en cursiva al text castellà; el motor no inclina mai una lletra àrab, sigui quin sigui el paràmetre.
#2 · Una taula per a cada direcció
const cell = (content, extra = {}) => ({ content, ...extra });
const tableOf = (head, rows) => ({ headerRowCount: 1, columnWidths: [46, 18, 18, 18],
rows: [head.map((h, i) => cell(h, { isHeader: true, align: i ? 'end' : 'start' })),
...rows.map((r) => r.map((c, i) => cell(c, { align: i ? 'end' : 'start' })))] });
const FIGURES = [ // programme, 2024, 2025, change: the Foundation's own counts
['كتب مترجمة إلى العربية', 'Books translated into Arabic', 28, 34],
['كتب مترجمة من العربية', 'Books translated from Arabic', 9, 14],
['منح للمترجمين', 'Translator grants', 41, 52],
['ورشات تدريب', 'Training workshops', 12, 18],
['مشاركون في الورشات', 'Workshop participants', 310, 466]];
const SPANISH = { 'Books translated into Arabic': 'Libros traducidos al árabe',
'Books translated from Arabic': 'Libros traducidos del árabe',
'Translator grants': 'Becas para traductores', 'Training workshops': 'Talleres de formación',
'Workshop participants': 'Participantes en los talleres' };
const change = (a, b) => `${b > a ? '+' : ''}${Math.round((100 * (b - a)) / a)}%`;
const AR = (n) => String(n).replace(/\d/g, (d) => '٠١٢٣٤٥٦٧٨٩'[d]); // the author's ٠–٩
const tableAr = tableOf(['البرنامج', '٢٠٢٤', '٢٠٢٥', 'التغيّر'], FIGURES.map(([ar, , a, b]) =>
[ar, AR(a), AR(b), AR(change(a, b)).replaceAll('%', '٪')]));
const tableEn = tableOf(t({ en: ['Programme', '2024', '2025', 'Change'],
es: ['Programa', '2024', '2025', 'Cambio'] }), FIGURES.map(([, en, a, b]) =>
[t({ en, es: SPANISH[en] }), String(a), String(b), change(a, b)]));
// The English table has a heading of its own and no number: a generated number would print in
// the document's digits, ٢, inside the English block.
const resourceTypes = [...defaultResourceTypes('ar'), { id: 'data', name: 'Data',
shortLabel: 'Data', captionPrefix: '', numberingTemplate: '', resetOn: 'never',
counterFormat: 'decimal' }];
const resources = [
{ id: 'figures-ar', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
table: { model: tableAr }, placement: { position: 'here' },
caption: 'أرقام البرامج في عامي ٢٠٢٤ و٢٠٢٥' },
{ id: 'figures-en', typeId: 'data', kind: 'table', createdAt: 0, updatedAt: 0,
table: { model: tableEn, direction: 'ltr', styleId: 'second' },
placement: { position: 'here' } },
];
La taula àrab va amb el document: la primera columna, el programa, queda a la dreta, i align: 'end' enganxa els números a la vora esquerra de les cel·les. La taula en castellà declara direction: 'ltr', així que la primera columna queda a l'esquerra i 'end' és la vora dreta (Què volen dir esquerra, dreta, inici i final). Les xifres àrabs estan teclejades en ٠–٩ i les castellanes en 0–9: les xifres del document només s'apliquen als números que escriu el motor, com el número de la taula al seu peu, جدول ١-١. Per això la segona taula té un tipus propi sense comptador: un número allà sortiria com ٢.
#3 · Dos títols en una franja
const band = { enabled: true, minHeight: mm(70), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('teal') },
placement: { anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(216), height: mm(86) } } },
// A heading's design is set in the flow and mirrored with the page: 'left' is the side the
// text starts on, the sheet's right in this book, and 'right' its left. Design text takes
// the document's direction; the English title says 'ltr' and starts from the sheet's left.
{ kind: 'text', id: 'org', content: '{attr.org}', fontFamily: ARABIC, fontSize: pt(13),
fontWeight: 600, color: col('tint'), align: 'start',
placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(SIDE), y: mm(18) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: ARABIC, fontSize: pt(50),
fontWeight: 700, lineHeight: 1.15, color: col('paper'), align: 'start',
placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(SIDE), y: mm(30) } } },
{ kind: 'text', id: 'title-2', content: '{attr.second}', direction: 'ltr', fontFamily: LATIN,
fontSize: pt(18), fontWeight: 300, color: col('tint'), align: 'start',
placement: { anchor: { to: 'page', edge: 'top-right' }, offset: { x: mm(-SIDE), y: mm(66) } } },
] } };
La portada és el disseny del títol de primer nivell. El disseny d'un títol es compon dins el flux i s'emmiralla amb la pàgina, així que els seus ancoratges designen els costats del text: top-left és la dreta del full, on comencen el nom i el títol àrabs, i top-right l'esquerra, on comença el títol en castellà. El text de disseny pren la direcció del document, així que les línies àrabs no necessiten res més; el títol en castellà declara direction: 'ltr'. La franja és una caixa ancorada al sang, de 86 mm, i el minHeight de l'obertura deixa la carta de la directora just a sota.
La recepta completa
// ═══ Postext Cookbook · Nº 106 · A bilingual Arabic–English report ═══════════════════
// https://postext.dev/en/cookbook/bilingual-arabic-english-report
// Code: MIT · Text: original Arabic, English and Spanish prose (CC BY 4.0) · Pictures: none
// Fonts: IBM Plex Sans Arabic, IBM Plex Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, defaultResourceTypes,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the second language of the report: English, or Spanish in 'es'
const RECIPE = 'bilingual-arabic-english-report';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a deep teal for the Arabic, a slate for the second language
const palette = {
ink: '#1b1f22', // the Arabic text
teal: '#0e5a5c', // the accent: the cover band, headings, table heads
slate: '#45535c', // the English (or Spanish) text: a voice of its own, a step lighter
tint: '#e4eeec', // the second language's panels
rule: '#b9c4c2', // hairlines
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.teal })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [ARABIC, LATIN] = ['IBM Plex Sans Arabic', 'IBM Plex Sans']; // one superfamily
const LEAD = 18; // pt: the Arabic leading
const SIDE = 20; // mm: the side margins
// #region answer: one Arabic document, its English blocks marked {dir=ltr}
// The document is Arabic (locale 'ar'): right to left, Arabic-Indic digits. A block in the
// other language says so in the Markdown, and its style gives it its own voice:
// :::paragraphs{style="second" dir=ltr} a paragraph or several, set left to right
// ### Director's note {style="second-head" dir=ltr}
// Inside an Arabic sentence, a Latin name is an isolate, :ltr[Penguin Classics]{lang=en}, so
// the words around it keep their order. 'start' and 'end' follow each block's own direction.
const second = { id: 'second', fontFamily: LATIN, fontSize: pt(9.5), lineHeight: pt(14),
color: col('slate'), textAlign: 'start', firstLineIndent: pt(0) };
const bodyText = { fontFamily: ARABIC, fontSize: pt(11), lineHeight: pt(LEAD),
color: col('ink'), boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'start', // ragged: the right edge for Arabic, the left for an English block
firstLineIndent: pt(0), paragraphSpacing: true,
// The Arabic is never slanted; italics stay for the titles in the Latin blocks.
emphasis: 'italic' };
// #endregion
// #region tables: the Arabic table runs with the page; the English one runs left to right
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
#Posa primer l'altra llengua
Una memòria per a un patronat que no llegeix àrab intercanvia els papers: un document en castellà, els seus blocs sense marcar, i els àrabs marcats {dir=rtl}.
- locale: 'ar', // written out, never LANG (gotcha: arabic-locale-tag)
+ locale: 'es', // Arabic blocks then carry {dir=rtl}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 →
- Un número que escriu el motor dins d'un bloc en castellà, un número de llista o l'etiqueta d'un peu, continua prenent les xifres del document (٢ en una memòria àrab). Dona a aquestes taules un tipus de recurs sense comptador, o escriu tu els números.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The annual report of an invented translation foundation, written in Arabic, English and Spanish for the recipe · Postext Cookbook · original
- Fonts
- IBM Plex Sans Arabic (SIL OFL 1.1) · IBM Plex Sans (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)


