ee4f74d566
The system used for localization of this project leverages the infrastructure and data that already exists for VS Code. These assets are applicable to Arduino IDE 2.x due to the project being built on the Eclipse Theia IDE framework. In this way, the Arduino IDE developers and community are only responsible for internationalization and localization of the Arduino-specific strings (e.g., "Sketchbook") used in the IDE's UI. The unfortunate downside to this approach is that there is a hard technical limit on localization of the project to languages for which a VS Code "language pack" is available. It will be helpful to clearly communicate the set of languages for which we are able to ship contributions from translators. Likewise, it will be useful to also communicate that, we are able to ship contributions of translations of Arduino CLI user interface strings for any language. This is due to the fact that the Arduino CLI codebase uses a completely different internationalization system that does not impose any technical limits on the scope of localization.
2.9 KiB
Translator Guide
The text of the Arduino IDE user interface is translated into several languages. The language can be selected in the dialog opened via File > Preferences in the Arduino IDE menus (Arduino IDE > Preferences for macOS users).
Translating text and improving on existing translations is a valuable contribution to the project, helping make Arduino accessible to everyone.
The translations for the text found in Arduino IDE come from several sources:
Arduino IDE Text
The text of the Arduino IDE application can be translated to the following languages:
- čeština (Czech)
- Deutsch (German)
- Dutch
- español (Spanish)
- français (French)
- italiano (Italian)
- magyar (Hungarian)
- polski (Polish)
- português (Portuguese)
- Türkçe (Turkish)
- български (Bulgarian)
- русский (Russian)
- українська (Ukrainian)
- 한국어 (Korean)
- 中文(简体) (Chinese Simplified)
- 中文(繁體) (Chinese Traditional)
- 日本語 (Japanese)
⚠ Unfortunately the 3rd party localization system used by the Arduino IDE application imposes a technical limitation to that set of languages. For this reason, we are unable to add support to Arduino IDE for additional languages (see arduino/arduino-ide#1447 for details).
There is no technical limitation on the set of languages to which Arduino CLI can be translated. If you would like to contribute translations for a language not on the above list, you are welcome to contribute to the Arduino CLI project.
Translations of Arduino IDE's text is done in the "Arduino IDE 2.0" project on the Transifex localization platform:
https://explore.transifex.com/arduino-1/ide2/
Base Application Text
Arduino IDE leverages the localization data available for the VS Code editor to localize shared UI text. This reduces the translation work required to add a new language to the text specific to the Arduino IDE project.
For this reason, some of Arduino IDE's text is not found in the Transifex project. Suggestions for corrections or improvement to this text are made by submitting an issue to the microsoft/vscode-loc GitHub repository.
Before submitting an issue, please check the existing issues to make sure it wasn't already reported:
https://github.com/microsoft/vscode-loc/issues
After that, submit an issue here:
https://github.com/microsoft/vscode-loc/issues/new
Arduino CLI Text
The Arduino CLI tool handles non-GUI operations for the Arduino IDE. Some of the text printed in the "Output" panel and in notifications originates from Arduino CLI.
Translations of Arduino CLI's text is done in the "Arduino CLI" Transifex project: