Saltar al contingut principal
Recepta número 106

Receptari · Capítol 2 · Text i tipografia

Un informe bilingüe àrab-anglès

Una memòria anual en àrab amb la traducció al costat: {dir=ltr} a cada bloc i títol traduït, :ltr[…] per als noms llatins i una taula d'esquerra a dreta.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 1 columna
  • IBM Plex Sans Arabic 11/18
  • IBM Plex Sans
  • 3 pàgines
  • Nivell
  • Postext 1.63.6
  • Compost en 190 ms
  • 143 línies de codi

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

script.js · línies 32–45al codi complet
// 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

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ó

script.js · línies 49–82al codi complet
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

script.js · línies 86–102al codi complet
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

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

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