openpilot is an open source driver assistance system. openpilot performs the functions of Automated Lane Centering and Adaptive Cruise Control for over 200 supported car makes and models.

1.8 KiB

Raw Blame History

Multilanguage

Contributing

Before getting started, make sure you have set up the openpilot Ubuntu development environment by reading the tools README.md.

Adding a New Language

openpilot provides a few tools to help contributors manage their translations and to ensure quality. To get started:

Add your new language to languages.json with the appropriate language code and the localized language name (Simplified Chinese is 中文（繁體）).
Generate the translation file (*.ts):
```
selfdrive/ui/update_translations.py
```
Edit the translation file, marking each translation as completed:
```
linguist selfdrive/ui/translations/your_language_file.ts
```
Save your file and generate the compiled QM file used by the Qt UI:
```
selfdrive/ui/update_translations.py --release
```

Improving an Existing Language

Follow the steps above, omitting steps 1. and 2. Any time you edit translations you'll want to make sure to compile them.

Updating the UI

Any time you edit source code in the UI, you need to update and compile the translations to ensure the line numbers and contexts are up to date (last step above).

Testing

openpilot has a few unit tests to make sure all translations are up to date and that all strings are wrapped in a translation marker.

Tests translation files up to date:

selfdrive/ui/tests/test_translations.py

Tests all static source strings are wrapped:

selfdrive/ui/tests/create_test_translations.sh && selfdrive/ui/tests/test_translations

1.8 KiB Raw Blame History