Skip to content

Translate documentation into natural Arabic (work in progress) - #1295

Draft
abdulrahman1s wants to merge 1 commit into
openmultiplayer:masterfrom
abdulrahman1s:arabic-documentation
Draft

abdulrahman1s wants to merge 1 commit into
openmultiplayer:masterfrom
abdulrahman1s:arabic-documentation

Conversation

@abdulrahman1s

Copy link
Copy Markdown

Goal and current scope

Translate the full documentation into clear, natural Modern Standard Arabic and correct the existing Arabic translations. This is one growing draft PR; it is not ready for a completeness review or merge.

Current coverage: 25 / 1,247 source pages. All nine pre-existing Arabic pages have been revised, and 16 pages have been added. Untranslated pages continue to fall back to English and are not counted as translated.

Included in the first batch

  • Introduction, contribution guide, client commands and client configuration.
  • Fourteen callbacks covering vehicle events, mod shops, spawning and streaming, plus five related vehicle functions and two vehicle reference pages.
  • Correct the OnVehicleStreamOut title, explain that OnVehicleDeath.killerid identifies the reporting player, distinguish paintjob previews from purchases, and restore missing callback return-value and siren notes.
  • Arabic navigation, sidebar categories, version/NPC notices and documentation accessibility labels.
  • Explicit Arabic RTL locale configuration and left-to-right isolation of inline code, so /quit is not displayed with its slash reversed.

API identifiers, paths, numeric data and fenced examples are preserved. Translations explain streaming as entering/leaving a player's viewing range rather than using a literal translation that obscures the meaning.

The coverage list, terminology conventions and remaining sections are recorded in frontend/i18n/ar/README.md. Future batches will extend this same branch.

Remaining before completion

  • Remaining client and server guides.
  • Remaining callbacks, functions, resources and Pawn language reference.
  • Tutorials, changelog, awesome list and remaining meta pages.
  • Independent Arabic language review and final coverage/link/rendering audit.

Validation

  • Arabic production build: npm run build -- --locale ar.
  • Fenced examples compared byte-for-byte with the English source; Arabic descriptions, JSON syntax, placeholders and relative link targets checked across all 25 pages.
  • Desktop and mobile browser checks of Arabic prose, tables, shared notices, preserved heading IDs, RTL layout and code direction.
  • git diff --check.

npm run typecheck currently reports four existing TS2367 errors in src/pages/index.tsx (lines 115, 123, 156 and 170). That file is unchanged from upstream. The production build also reports the existing duplicate /servers route warning.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant