Files
gods-eye-view/docs/translations/ar.md
T
German KhokhlovandClaude Opus 5.5 33985138ef docs(i18n): Arabic language notes and right-to-left guidance
- docs/translations/ar.md: style, Western digits and direction, units,
  the six plural forms and the glossary.
- TRANSLATORS.md and CURRENT-STATE.md list Arabic and say how a
  right-to-left language mirrors the chrome.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-28 13:28:52 +04:00

9.7 KiB
Raw Blame History

Arabic (ar)

Catalog: src/i18n/locales/ar.json. General rules: TRANSLATORS.md.

Translation sources: abiyeenzo (#915).

Style

  • Modern Standard Arabic, neutral across regions. Address the user with plain imperatives: «انقر»، «فعّل»، «أعد المحاولة».
  • Arabic has no letter case: an UPPERCASE English HUD label becomes the same short Arabic label. Keep labels as short as the English: «مباشر»، «متقادم»، «متوقف».
  • Status words in progress use «جارٍ …» («جارٍ التحميل»); finished actions use the passive («تم الحفظ»، «أُلغي التحميل»).
  • Arabic punctuation in Arabic text: ، ؛ ؟ and «» for quotes. Keep · as the HUD separator, — with spaces, and ….
  • Arrows that show a sequence point the way Arabic reads: «الإشارات ← الأخبار ← المحلي», «{origin} ← {destination}».
  • Product names, provider names and codes stay in Latin letters: Google, Cesium ion, CelesTrak, NOAA, FIRMS, AIS, ADS-B, GNSS, CCTV, HUD, CRT, NVG, FLIR, WHOT/BHOT, Ironbow, Street View, Mapillary. Aviation and camera abbreviations stay Latin too: HDG, FOV, BRG, CRS, GS, TRK, V/S, SQUAWK. Local place names from the Bhote Koshi scene (Rasuwagadhi, Bidur, Timure…) stay Latin; well-known cities and countries are written in Arabic (أوستن، طوكيو، نيبال).
  • Months are the international names used across the Arab world: يناير، فبراير … أغسطس.

Digits and direction

  • Western digits (0–9), as in the catalog. The HUD reads like an instrument panel, and mixing ٠–٩ with Latin codes and coordinates misreads. intlLocale('ar') in src/i18n/locale.js passes ar-u-nu-latn to every Intl formatter, so browsers that default to Arabic-Indic digits for an Arabic region still show 0–9.
  • Right to left. ar is in RTL_LOCALES, so the page gets <html dir="rtl">. The title, style indicator and both rails swap sides; the dock and the corner row reverse. The intel HUD (classification block, MGRS, coordinates, GSD) stays a left-to-right instrument overlay; its translated lines read right to left inside it. Media transport (previous / play / next) and the radio dial stay left to right, as on any player. Layout rules: src/ui/styles/rtl.css.
  • Latin runs inside Arabic sentences (product names, codes, {placeholders} filled with English data) are isolated by the bidi algorithm; write them as plain text, without manual direction marks.

Units

Distances and speeds take Arabic abbreviations after the number, with a space: كم، م، كم/س، كم/ث، م/ث، ميل/س، عقدة (knots)، قدم (feet)، مم. Time: ث (seconds)، د (minutes)، س (hours)، يوم. Scientific and radio units stay Latin: MHz، dB، dBFS، dBZ، hPa، MW، MiB. ° and % stay. Hemisphere letters in coordinates: ش (N)، ج (S)، ق (E)، غ (W), as in 21.33ش.

Plurals

Intl.PluralRules('ar') uses all six CLDR categories, and a tn() entry needs every one:

Form Counts Example
zero 0 0 مصدر
one 1 مصدر واحد (1)
two 2 مصدران (2)
few 3–10, 103–110… 3 مصادر
many 11–99, 111–199… 11 مصدرًا
other 100–102, 200–202, fractions 100 مصدر

Every form must keep {count}. For one and two, Arabic names the quantity with the noun itself (مصدر واحد، مصدران), so the number follows in parentheses. few takes the plural noun; many the accusative singular (مصدرًا، مفتاحًا); zero and other the genitive singular. When a word next to the number cannot agree in every form, or a short chip has no room, put the number after a colon instead: «القريبة: {count}»، «الملفات المحددة: {count}».

Glossary

English العربية
layer / data layer طبقة / طبقة بيانات
feed / source مصدر بيانات (short: مصدر) / مصدر
LIVE (status) / live data مباشر / البيانات المباشرة (not حي)
SIMULATED محاكى (status) / محاكاة
stale / degraded / unavailable متقادم / متدهور / غير متاح
ON / OFF (state) مفعّل / متوقف
retry إعادة المحاولة
key (API key) / POWER UP مفتاح (مفتاح API) / تشغيل
Provider Settings إعدادات المزوّدين
globe / map / map source / basemap الكرة الأرضية / الخريطة / مصدر الخريطة / الخريطة الأساسية
tiles بلاطات
aircraft / flight / military flights طائرة / رحلة / الرحلات العسكرية
vessel, ship سفينة
satellite قمر صناعي
launch (rocket) / space mission إطلاق / مهمة فضائية
contact (tracked object) هدف
installation, site / mapped منشأة، موقع / مرسوم
camera / CCTV camera كاميرا / كاميرا CCTV
earthquake / active fire / fire perimeter زلزال / حريق نشط / محيط حريق
cyclone advisory نشرة إعصار
scene / shot / scene recipe مشهد / لقطة / قالب المشهد
briefing / panel / dock إحاطة / لوحة / الشريط السفلي
preset / visual preset إعداد مسبق / نمط بصري
Scope (circular viewport mask) / keyhole المنظار / الفتحة
Clean UI واجهة نظيفة
cockpit القمرة (قمرة القيادة)
heading / altitude / ground speed الاتجاه (HDG) / الارتفاع / السرعة الأرضية
Street Level / Street View مستوى الشارع / Street View
Recent Imagery الصور الحديثة
Global Context / Context السياق العالمي / السياق
radio station / tuner / gain محطة / موالف / الكسب
decoder (SDR) مفكّك
transit / bike share النقل العام / الدراجات المشتركة
Previous / Next السابق / التالي
compass points (N, NNE, …) شمال، شمال شمال شرق، …
forecast / valid / issued توقع / صالح حتى / صدر
observation / observed رصد / مرصود
field (weather) / model حقل / نموذج
scene cloud غيوم المشهد
box (Recent Imagery area) / pin منطقة / تثبيت
THIS (voice pointer) المُشار إليه
outline / mark (map annotation) مخطط / علامة، تعليم
share (a view or link) مشاركة
AI agent وكيل ذكاء اصطناعي
stage (rocket) / downrange مرحلة / على امتداد المسار
frame (bring into view) إظهار في الإطار
story beat مرحلة القصة