From e458af0e306e1b23d7f29786bd3666ceea7e0512 Mon Sep 17 00:00:00 2001 From: per1234 Date: Sat, 13 Aug 2022 18:14:09 -0700 Subject: [PATCH] [skip changelog] Add readme for localization data Arduino CLI has been translated to 12 languages. The localization process follows the following steps: 1. An English language source string is defined in the Arduino CLI codebase 2. The source string is pushed to Transifex 3. Community translators localize the string 4. The localization data is pulled into the Arduino CLI repository 5. The localization data is incorporated into the Arduino CLI distribution Experience with maintenance of the Arduino IDE 1.x project indicates that the data files generated at step (4) can appear to be the appropriate place to make edits for casual contributors not familiar with the project's sophisticated internationalization infrastructure. Since those files are generated by automated systems, any edits made there would only be overwritten, so it is important to clearly communicate the correct way to make enhancements or corrections to these strings. This is accomplished by a local readme file most likely to be seen by those working in the folder containing these files, which supplements the existing information about translation in the project's CONTRIBUTING.md. --- i18n/data/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 i18n/data/README.md diff --git a/i18n/data/README.md b/i18n/data/README.md new file mode 100644 index 00000000000..e795dcd7735 --- /dev/null +++ b/i18n/data/README.md @@ -0,0 +1,12 @@ +# Localization data + +This folder contains the [localization](https://wikipedia.org/wiki/Language_localisation) data for **Arduino CLI**. + +❗ These files are automatically generated and so can not be edited directly. If you wish to modify the contents, do it +at the source: + +- **en.po** - edit the string in the source code file indicated by the comment above it
e.g., a comment + `#: commands/upload/upload.go:615` indicates the source string is at line 615 of the file + [`commands/upload/upload.go`](../../commands/upload/upload.go) +- **All other files** - the localization is done on **Transifex**:
+ https://explore.transifex.com/arduino-1/arduino-cli/