انتقل إلى المحتوى الرئيسي
الوصفة رقم 106

دليل الوصفات · الفصل 2 · الحروف والنص

تقرير ثنائي اللغة بالعربية والإنجليزية

تقرير سنوي عربي وإلى جانبه نصه الإنجليزي: {dir=ltr} على كل كتلة إنجليزية، و:ltr[…] للأسماء اللاتينية في الأسطر العربية، وجدول من اليسار إلى اليمين.

في هذه الصفحة
المُخرَج
Canvas · PDF
المستوى
متوسط
Postext
اختُبرت مع Postext 1.65.0
تتطلب ≥ 1.25.0 · postext-pdf ≥ 1.25.0
الترخيص
حُدّثت في 10 أكتوبر 2026
الشيفرة MIT · النص CC BY 4.0
  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 210 × 280 مم
  • عمود واحد
  • IBM Plex Sans Arabic 11/18
  • IBM Plex Sans
  • 3 صفحات
  • المستوى
  • Postext 1.63.6
  • أُخرجت في 197 ms
  • أسطر الشيفرة: 143

باختصار

تقرير سنوي لمؤسسة مكتوب بالعربية، تتبع كل فقرة منه ترجمتها الإنجليزية. تجمع الصفحة الاتجاهين دون أن يختلّ ترتيب الكلمات أو الأعداد أو الجداول.

ما الذي ستنضده

التقرير السنوي لعام 2025 لمؤسسة ترجمة متخيَّلة، «دار الضاد»، على صفحة بعرض A4 قياسها 210 × 280 مم، بخطي IBM Plex Sans Arabic وIBM Plex Sans، وهما شطرا عائلة خطوط واحدة. التقرير عربي: يجري من اليمين إلى اليسار ويرقّم صفحاته ٢، ٣. تتبع كلَّ فقرة عربية ترجمتُها الإنجليزية، بحجم أصغر وبلون رمادي أردوازي، من اليسار إلى اليمين وبحافة حرّة على اليمين؛ ولكل عنوان عربي تسمية إنجليزية عند الهامش المقابل. تحتفظ الأسماء اللاتينية داخل الجمل العربية بترتيبها، وتظهر أرقام السنة مرتين: في جدول عربي يُقرأ من اليمين، وفي جدول إنجليزي يُقرأ من اليسار. وفي الطبعة الإسبانية تكون اللغة الثانية الإسبانية.

تجيب هذه الوصفة عن

  • كيف أمزج فقرات وأرقامًا وجداول عربية وإنجليزية في صفحة واحدة؟

الجواب المختصر

script.js · الأسطر 32–45في الشيفرة الكاملة
// 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' };

المكونات

الخطوط
IBM Plex Sans Arabic, IBM Plex Sans (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

طريقة التحضير

#1 · اللغة الثانية في كتل معلَّمة

الشيفرة هي الجواب المختصر أعلاه. المستند عربي، فكل كتلة من اليمين إلى اليسار ما لم يحدّد Markdown غير ذلك: {dir=ltr} على سطر فتح :::paragraphs أو على عنوان يقلب اتجاه تلك الكتلة، وtextAlign: 'start' يرسل كل كتلة إلى الجانب الذي تبدأ منه، اليمين للعربية واليسار للإنجليزية (اتجاه المستند والكتلة والنص داخل السطر). والاسم اللاتيني داخل سطر عربي، :ltr[Harbour Modern Classics]، عازل: تعامله خوارزمية النص ثنائي الاتجاه قطعة واحدة محايدة، فتبقى الكلمات العربية والفاصلة حوله في أماكنها (العوازل). ويُبقي emphasis: 'italic' كلمة Middlemarch مائلة في النص الإنجليزي؛ أما الحرف العربي فلا يُميله المحرّك أبدًا، أيًّا كان الإعداد.

#2 · جدول لكل اتجاه

script.js · الأسطر 49–82في الشيفرة الكاملة
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' } },
];

يجري الجدول العربي مع المستند: عموده الأول، البرنامج، على اليمين، وalign: 'end' يضع الأعداد عند الحافة اليسرى من خلاياها. أما الجدول الإنجليزي فيضبط direction: 'ltr'، فيقع عموده الأول على اليسار وتعني 'end' الحافة اليمنى (معنى اليسار واليمين والبداية والنهاية). كُتبت الأعداد العربية بالأرقام ٠–٩، والإنجليزية بالأرقام 0–9: أرقام المستند لا تنطبق إلا على الأعداد التي يكتبها المحرّك، مثل رقم الجدول في تعليقه، جدول ١-١. ولهذا أيضًا للجدول الإنجليزي نوع خاص به بلا عدّاد، لأن الرقم فيه كان سيُطبع ٢.

#3 · عنوانان على شريط واحد

script.js · الأسطر 86–102في الشيفرة الكاملة
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) } } },
] } };

الغلاف هو تصميم العنوان من المستوى الأول. وتصميم العنوان يُنضَّد في مجرى النص ويُعكس مع الصفحة، فمواضع الربط فيه تدلّ على جانبَي النص: top-left هو يمين الورقة، حيث يبدأ الاسم والعنوان العربيان، وtop-right يسارها، حيث يبدأ العنوان الإنجليزي. ويأخذ نص التصميم اتجاه المستند، فلا تحتاج الأسطر العربية شيئًا آخر؛ ويضبط العنوان الإنجليزي direction: 'ltr'. والشريط إطار مربوط بالنزف، عمقه 86 مم، وminHeight الخاص بصفحة الافتتاح يأتي بكلمة المدير تحته.

الوصفة كاملة

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 = 'en'; // @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

يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)

تنويعات

#قدّم الإنجليزية

تقرير لمجلس لا يقرأ أعضاؤه العربية يتبادل فيه الدوران: مستند إنجليزي كتله بلا علامات، والكتل العربية معلَّمة بـ{dir=rtl}.

-  locale: 'ar', // written out, never LANG (gotcha: arabic-locale-tag)
+  locale: 'en-us', // Arabic blocks then carry {dir=rtl}

أخطاء شائعة

خطأ شائع

اوسم الكتاب العربي بـ 'ar'، لا بـ LANG

نسختا الوصفة هما en وes، لكن المثال العربي عربي في كلتيهما: `locale: LANG` سيجعله من اليسار إلى اليمين، ويجلّده على اليسار، ويرقّم صفحاته 1 2 3، ويسمّي أشكاله Figure أو Figura. ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فتحت وسم إنجليزي أو إسباني لا يرسم خط مثل Markazi Text الأشكال العربية لعلامتَي التنصيص « » وللنقطة، وتنكسر الأسطر في مواضع أخرى. اكتب الوسم بنفسك: 'ar' (الأرقام العربية المشرقية، عُرف المشرق)، أو منطقة مثل 'ar-EG' أو 'ar-SA'، أو 'ar-MA' أو 'ar-DZ' أو 'ar-TN' لنسخة مغاربية بالأرقام الأوروبية. أما الصفحة اللاتينية التي تقتبس العربية فقط فتحتفظ بلغتها. النص من اليمين إلى اليسار →

خطأ شائع

الخطوط العربية تحتاج إلى ملفها arabic، عبر الكتلة arabic

يقدّم Fontsource الخطوط Amiri وNoto Naskh Arabic وScheherazade New في ملف لكل مجموعة فرعية، والحروف العربية في ملف arabic. لا يجلب loadFonts إلا latin (وlatin-ext)، فيأتي النص العربي على الشاشة من خط النظام ويُقاس خطأً، ويسلّم fontsourceProvider ملف latin ذاك إلى PDF، فيطبع مربعات فارغة. اذكر كتلة الأدوات arabic، واستدعِ loadArabicFonts(FONTS, markdown) بعد loadFonts، مع ذكر كل وزن تضع به الصفحاتُ نصًا عربيًا في FONTS، وأعطِ renderToPdf القيمة fontProvider: arabicPdfProvider. الخطوط العربية →

  • العدد الذي يكتبه المحرّك داخل كتلة إنجليزية، كرقم في قائمة أو تسمية تعليق، يأخذ أرقام المستند مع ذلك (٢ في تقرير عربي). اجعل لهذه الجداول نوع موارد بلا عدّاد، أو اكتب الأعداد بنفسك.

الحقوق

الوصفة
Ignacio Ferro
النص
  • The annual report of an invented translation foundation, written in Arabic, English and Spanish for the recipe · Postext Cookbook · أصلي
الخطوط
IBM Plex Sans Arabic (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF