diff --git a/docs/development/retroarch/new-translations-crowdin.md b/docs/development/retroarch/new-translations-crowdin.md index 5d71f17a7f..a5f9c7ac9b 100644 --- a/docs/development/retroarch/new-translations-crowdin.md +++ b/docs/development/retroarch/new-translations-crowdin.md @@ -69,6 +69,7 @@ Click on any string to see them in the middle area. The **Source String** (the o In the very few cases where the source string can be kept as-is, you can click the ‘**Copy Source**’ button ![Copy Source](../../image/development/crowdin-copy-source.png) to do so. In the string list (on the left side of the screen) some strings have a balloon icon ![Comments icon](../../image/development/crowdin-comments-icon.png). This icon shows that the string has comments written by other translators and developers. Comments may include interesting and/or important information that could help you decide on how best to translate a specific string. You can also write comments in case you have questions or additional information regarding any particular string. + Please make sure that any comment you write is in __English__, as that is the official project language and the comments are visible to _everyone_. Comments will be displayed at Crowdin’s right column. In case there are no comments being displayed there, make sure that the left-most button of that column is active.
diff --git a/docs/development/retroarch/new-translations.md b/docs/development/retroarch/new-translations.md index 99f4bcb25f..f91c47aee7 100644 --- a/docs/development/retroarch/new-translations.md +++ b/docs/development/retroarch/new-translations.md @@ -1,6 +1,6 @@ -# Adding a translation to a new language +# Adding a new language to RetroArch -## Files you need to change +## Files to change * `libretro-common/include/libretro.h` * `msg_hash.h` @@ -96,20 +96,29 @@ * Be careful when creating and editing your new translation files as some text editors do strip the BOM without warning. +### Example: Addition of Arabic language: + +* Commit [45580cb](https://github.com/libretro/RetroArch/commit/45580cb9a8f0fcd0a87f00eadf26d87f05289485) +* Commit [d8f1a08](https://github.com/libretro/RetroArch/commit/d8f1a08a4758851d5530d311303146257cbf8216) +* Commit [7a0428f](https://github.com/libretro/RetroArch/commit/7a0428fc769fd0eca663207134bec311aa3e30f3) + ### Translation If you speak the target language xx then you could start translating literals in * `intl/msg_hash_xx.c` -* `intl/msg_hash_xx.h` -by replacing the English original ones with its translations. +by replacing the English original one with its translations. -### Example: Addition of Arabic language: +The main file for RetroArch is located here: -* Commit [45580cb](https://github.com/libretro/RetroArch/commit/45580cb9a8f0fcd0a87f00eadf26d87f05289485) -* Commit [d8f1a08](https://github.com/libretro/RetroArch/commit/d8f1a08a4758851d5530d311303146257cbf8216) -* Commit [7a0428f](https://github.com/libretro/RetroArch/commit/7a0428fc769fd0eca663207134bec311aa3e30f3) +* `intl/msg_hash_xx.h` + +But .h files are periodically updated and overwritten by the Crowdin translations website +([Link here](https://crowdin.com/project/retroarch), so it's best to do any changes to +non-English languages there. If you want to know more, go to the +([Helping with RetroArch translations](https://docs.libretro.com/development/retroarch/new-translations-crowdin/) +doc. ## See also diff --git a/docs/image/development/crowdin-approve-button.png b/docs/image/development/crowdin-approve-button.png index 6da873beed..8faa2bc8d8 100644 Binary files a/docs/image/development/crowdin-approve-button.png and b/docs/image/development/crowdin-approve-button.png differ diff --git a/docs/image/development/crowdin-comments-icon.png b/docs/image/development/crowdin-comments-icon.png index 7eeb548e4b..978768ec11 100644 Binary files a/docs/image/development/crowdin-comments-icon.png and b/docs/image/development/crowdin-comments-icon.png differ diff --git a/docs/image/development/crowdin-comments-tab.png b/docs/image/development/crowdin-comments-tab.png index a7979788de..8a5e7f69ee 100644 Binary files a/docs/image/development/crowdin-comments-tab.png and b/docs/image/development/crowdin-comments-tab.png differ diff --git a/docs/image/development/crowdin-copy-source.png b/docs/image/development/crowdin-copy-source.png index 436886dbb2..401da4f412 100644 Binary files a/docs/image/development/crowdin-copy-source.png and b/docs/image/development/crowdin-copy-source.png differ diff --git a/docs/image/development/crowdin-file-selection.png b/docs/image/development/crowdin-file-selection.png index 3a2fb2e59f..7435234494 100644 Binary files a/docs/image/development/crowdin-file-selection.png and b/docs/image/development/crowdin-file-selection.png differ diff --git a/docs/image/development/crowdin-gl-add-term.png b/docs/image/development/crowdin-gl-add-term.png index c967f2665b..ae7b53366c 100644 Binary files a/docs/image/development/crowdin-gl-add-term.png and b/docs/image/development/crowdin-gl-add-term.png differ diff --git a/docs/image/development/crowdin-gl-edit-term.png b/docs/image/development/crowdin-gl-edit-term.png index 68830c9deb..84df8546b4 100644 Binary files a/docs/image/development/crowdin-gl-edit-term.png and b/docs/image/development/crowdin-gl-edit-term.png differ diff --git a/docs/image/development/crowdin-gl-terms-add.png b/docs/image/development/crowdin-gl-terms-add.png index 8b0ed122f2..00a4caa1ea 100644 Binary files a/docs/image/development/crowdin-gl-terms-add.png and b/docs/image/development/crowdin-gl-terms-add.png differ diff --git a/docs/image/development/crowdin-gl-terms.png b/docs/image/development/crowdin-gl-terms.png index bcc198b6c1..079914d044 100644 Binary files a/docs/image/development/crowdin-gl-terms.png and b/docs/image/development/crowdin-gl-terms.png differ diff --git a/docs/image/development/crowdin-gl-translation.png b/docs/image/development/crowdin-gl-translation.png index 6a8287f709..5748e91d9b 100644 Binary files a/docs/image/development/crowdin-gl-translation.png and b/docs/image/development/crowdin-gl-translation.png differ diff --git a/docs/image/development/crowdin-join.png b/docs/image/development/crowdin-join.png index 6611e8a543..bcb0033f68 100644 Binary files a/docs/image/development/crowdin-join.png and b/docs/image/development/crowdin-join.png differ diff --git a/docs/image/development/crowdin-line-break.png b/docs/image/development/crowdin-line-break.png index a72e28ec3c..10c692ffd0 100644 Binary files a/docs/image/development/crowdin-line-break.png and b/docs/image/development/crowdin-line-break.png differ diff --git a/docs/image/development/crowdin-other-languages.png b/docs/image/development/crowdin-other-languages.png index 5e65e17664..b9ad97de36 100644 Binary files a/docs/image/development/crowdin-other-languages.png and b/docs/image/development/crowdin-other-languages.png differ diff --git a/docs/image/development/crowdin-placeholder-special.png b/docs/image/development/crowdin-placeholder-special.png index a34745d16c..b948e19221 100644 Binary files a/docs/image/development/crowdin-placeholder-special.png and b/docs/image/development/crowdin-placeholder-special.png differ diff --git a/docs/image/development/crowdin-placeholders.png b/docs/image/development/crowdin-placeholders.png index 3f413eb286..c970889d90 100644 Binary files a/docs/image/development/crowdin-placeholders.png and b/docs/image/development/crowdin-placeholders.png differ diff --git a/docs/image/development/crowdin-previously-translated-as.png b/docs/image/development/crowdin-previously-translated-as.png index 2d5a6c98de..0cf2a8521a 100644 Binary files a/docs/image/development/crowdin-previously-translated-as.png and b/docs/image/development/crowdin-previously-translated-as.png differ diff --git a/docs/image/development/crowdin-sign-up.png b/docs/image/development/crowdin-sign-up.png index fbcc4053ae..dc402d41a5 100644 Binary files a/docs/image/development/crowdin-sign-up.png and b/docs/image/development/crowdin-sign-up.png differ diff --git a/docs/image/development/crowdin-suggested-translations.png b/docs/image/development/crowdin-suggested-translations.png index 1f9ff232df..f2fa8460ec 100644 Binary files a/docs/image/development/crowdin-suggested-translations.png and b/docs/image/development/crowdin-suggested-translations.png differ diff --git a/docs/image/development/crowdin-tm-search.png b/docs/image/development/crowdin-tm-search.png index b242cae49f..d33c1107f5 100644 Binary files a/docs/image/development/crowdin-tm-search.png and b/docs/image/development/crowdin-tm-search.png differ diff --git a/docs/image/development/crowdin-tm.png b/docs/image/development/crowdin-tm.png index 4406c4f92b..b61f7e2f60 100644 Binary files a/docs/image/development/crowdin-tm.png and b/docs/image/development/crowdin-tm.png differ diff --git a/docs/image/development/crowdin-translate-page.png b/docs/image/development/crowdin-translate-page.png index 20d25a77b0..77540b77d0 100644 Binary files a/docs/image/development/crowdin-translate-page.png and b/docs/image/development/crowdin-translate-page.png differ diff --git a/docs/image/development/crowdin-translation-page.png b/docs/image/development/crowdin-translation-page.png index 821457147e..7ad01ccddb 100644 Binary files a/docs/image/development/crowdin-translation-page.png and b/docs/image/development/crowdin-translation-page.png differ diff --git a/docs/image/development/retropad-conceptual-diagram.png b/docs/image/development/retropad-conceptual-diagram.png index e549aeb3bf..b74e5de8ae 100644 Binary files a/docs/image/development/retropad-conceptual-diagram.png and b/docs/image/development/retropad-conceptual-diagram.png differ diff --git a/mkdocs.yml b/mkdocs.yml index d4cb19d616..2eefe646ec 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -303,8 +303,8 @@ nav: - 'Input Driver Specification': 'development/retroarch/input/input-drivers.md' - 'Input Overlays': 'development/retroarch/input/overlay.md' - 'Parallel Port Controllers': 'development/retroarch/input/parallel-port-controllers.md' - - 'Adding Translations(not active)': 'development/retroarch/new-translations.md' - - 'Adding Translations with Crowdin': 'development/retroarch/new-translations-crowdin.md' + - 'Adding New Languages or New Strings': 'development/retroarch/new-translations.md' + - 'Helping with RetroArch translations': 'development/retroarch/new-translations-crowdin.md' - 'Network Protocols': - 'Netplay': 'development/retroarch/netplay.md' - 'Network Control Interface': 'development/retroarch/network-control-interface.md'