الترجمات

Help make DataPass accessible to users worldwide by contributing translations. This guide explains how to add or improve translations for the documentation and interface.

Current Languages

DataPass currently supports:

  • English (en) - Primary language
  • Arabic (ar) - RTL support

We welcome contributions for additional languages, particularly those with large ML/AI research communities.

Translation Architecture

Translations are organized in two locations:

1. UI Strings

Interface strings are stored in src/i18n/translations/: 

src/i18n/translations/
  en.json      # English strings
  ar.json      # Arabic strings

2. Documentation

Documentation content is stored in src/content/docs/: 

src/content/docs/
  en/          # English documentation
    guides/
    reference/
    examples/
    spec/
  ar/          # Arabic documentation
    guides/
    reference/
    ...

Adding a New Language

Step 1: Register the Locale

Add the new locale to src/i18n/config.ts and astro.config.mjs.

Step 2: Create UI Translations

Copy src/i18n/translations/en.json to create your language file: 

cp src/i18n/translations/en.json src/i18n/translations/fr.json

Then translate all strings in the new file.

Step 3: Create Documentation Directory

Mirror the English documentation structure and translate the pages.

Translation Guidelines

Keep Technical Terms Consistent

Some terms should remain in English for consistency:

  • JSON, API, schema, validator
  • Field names: core, data, rights
  • Value literals: "real", "synthetic", "hybrid"
  • License identifiers: CC-BY-4.0, Apache-2.0

Handle RTL Languages

For right-to-left languages like Arabic:

  • The site automatically sets dir="rtl" based on locale
  • Code blocks remain left-to-right
  • Test navigation and layout carefully

Quality Standards

Completeness

  • All UI strings must be translated
  • All critical documentation pages must be translated
  • Missing pages will fall back to English

Accuracy

  • Technical accuracy is more important than literary style
  • When uncertain, keep original English term with explanation
  • Have translations reviewed by native speakers

Submitting Translations

  1. Fork the repository
  2. Create a branch: git checkout -b translate/fr
  3. Add your translations
  4. Test locally: npm run dev
  5. Open a pull request with title: Translation: Add French (fr)

Questions?

For questions about translations, open a discussion on GitHub or contact us at translations@datapass.meetkai.ai.