Skip to content

Commit 5eb2926

Browse files
committed
Add a dedicated translator guide document
Translation of the strings of the Arduino IDE UI is a valuable contribution which helps to make Arduino accessible to everyone around the world. Localization of the Arduino-specific strings of the IDE is done in the "Arduino IDE 2.0" project on Transifex. Previously, the "Translation" row in the contribution methods summary table in the contributor guide entry page simply linked to that project. Arduino IDE also uses localized strings from several other sources: - VS Code language packs - Arduino CLI Users may notice unlocalized strings or errors or areas for improvement in the existing translations and wish to contribute translations. For this reason, it is important to also provide instructions for contributing to those other localization data sources. The contribution methods summary table can not effectively accommodate that additional content so a dedicated document is added for the purpose. This will also allow linking directly to that document from related documentation or conversations.
1 parent a4ab204 commit 5eb2926

File tree

2 files changed

+35
-2
lines changed

2 files changed

+35
-2
lines changed

docs/CONTRIBUTING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,14 @@ There are several ways you can get involved:
1111
| - Support<br/>- Question<br/>- Discussion | Post on the [**Arduino Forum**][forum] |
1212
| - Bug report<br/>- Feature request | Issue report (see the guide [**here**][issues]) |
1313
| Testing | Beta testing, PR review (see the guide [**here**][beta-testing]) |
14-
| Translation | [Transifex project][translate] |
14+
| Translation | See the guide [**here**][translate] |
1515
| - Bug fix<br/>- Enhancement | Pull request (see the guide [**here**][prs]) |
1616
| Monetary | - [Donate][donate]<br/>- [Sponsor][sponsor]<br/>- [Buy official products][store] |
1717

1818
[forum]: https://forum.arduino.cc
1919
[issues]: contributor-guide/issues.md#issue-report-guide
2020
[beta-testing]: contributor-guide/beta-testing.md#beta-testing-guide
21-
[translate]: https://www.transifex.com/arduino-1/ide2/dashboard/
21+
[translate]: contributor-guide/translation.md#translator-guide
2222
[prs]: contributor-guide/pull-requests.md#pull-request-guide
2323
[donate]: https://www.arduino.cc/en/donate/
2424
[sponsor]: https://github.com/sponsors/arduino

docs/contributor-guide/translation.md

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Translator Guide
2+
3+
The text of the Arduino IDE 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).
4+
5+
Translating text and improving on existing translations is a valuable contribution to the project, helping make Arduino accessible to everyone.
6+
7+
The translations for the text found in the Arduino IDE come from several sources:
8+
9+
## Arduino IDE Text
10+
11+
Translations of Arduino IDE's text is done in the "**Arduino IDE 2.0**" project on the **Transifex** localization platform:
12+
13+
https://explore.transifex.com/arduino-1/ide2/
14+
15+
## Base Application Text
16+
17+
Arduino IDE leverages the localization data available for the [**VS Code**](https://code.visualstudio.com/) 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.
18+
19+
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.
20+
21+
Before submitting an issue, please check the existing issues to make sure it wasn't already reported:<br />
22+
https://github.com/microsoft/vscode-loc/issues
23+
24+
After that, submit an issue here:<br />
25+
https://github.com/microsoft/vscode-loc/issues/new
26+
27+
## Arduino CLI Text
28+
29+
The [**Arduino CLI**](https://arduino.github.io/arduino-cli/latest/) 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**.
30+
31+
Translations of Arduino CLI's text is done in the "**Arduino CLI**" Transifex project:
32+
33+
https://explore.transifex.com/arduino-1/arduino-cli/

0 commit comments

Comments
 (0)