Update translation readme

5 files changed, 70 insertions, 281 deletions

diff --git a/advtrains/locale/README.md b/advtrains/locale/README.md
index 61e473c..2446cbf 120000..100644
--- a/advtrains/locale/README.md
+++ b/advtrains/locale/README.md
@@ -1 +1,70 @@
-../po/README.md
\ No newline at end of file
+# Translations
+Please read this document before working on any translations.
+
+## Getting Started
+Advtrains uses `.po` files for localization. These can be edited with
+a regular text editor or with specialized programs (e.g. Poedit).
+
+If the translation file for your language does not exist, you can
+create it using:
+
+`msginit -l LL -o <domain>.LL.po`
+
+where `LL` is the language code and `<domain>` is the "domain" of the
+translation file (which, for the Advtrains modpack, corresponds to the
+name of the mods, e.g. `advtrains_interlocking`).
+
+Feel free to use the [discussion mailing list][srht-discuss] if you
+have any questions regarding localization.
+
+You can share your `.po` file directly or [as a patch][gsm] to the [dev
+mailing list][srht-devel]. The latter is encouraged, but, unlike code
+changes, translation files sent directly are also accepted.
+
+[srht-discuss]: https://lists.sr.ht/~gpcf/advtrains-discuss
+[srht-devel]: https://lists.sr.ht/~gpcf/advtrains-devel
+[gsm]: https://git-send-email.io
+
+## Translation Notes
+* Translations should be consistent. You can use other entries or the
+translations in Minetest as a reference.
+* Translations do not have to fully correspond to the original text -
+they only need to provide the same information. In particular,
+translations do not need to have the same linguistical structure as the
+original text.
+* Replacement sequences (`@1`, `@2`, etc) should not be translated.
+* Certain abbreviations or names, such as "Ks" or "Zs 3", should
+generally not be translated.
+
+### (de) German
+* Verwenden Sie die neue Rechtschreibung und die Sie-Form.
+* Mit der deutschen Tastaturbelegung unter Linux können die
+Anführungszeichen „“ mit AltGr-V bzw. AltGr-B eingegeben werden.
+
+### (zh) Chinese
+(This section is written in English to avoid writing the note twice or
+using only one of the variants, as most of this section applies to both
+the traditional and simplified variants.)
+
+* Please use the 「」 quotation marks for Traditional Chinese and “”
+for Simplified Chinese.
+* Please use the fullwidth variants of: ， 、 。 ？ ！ ： ；
+* Please use the halfwidth variants of: ( ) [ ] / \ |
+* Please do not leave any space between Han characters (including
+fullwidth punctuation marks).
+* Please leave a space between Han characters (excluding fullwidth
+punctuation marks) and characters from other scripts (including
+halfwidth punctuation marks). However, do not leave any space between
+Han characters and Arabic numerals.
+
+## Notes for developers
+* The `update-translations.sh` script can be used to update the
+translation files.
+* Please make sure that the first argument to `S` _only_ includes
+string literals without formatting or concatenation. This is
+unfortunately a limitation of the `xgettext` utility.
+* Avoid word-by-word translations.
+* Avoid manipulating translated strings (except for concatenation). Use
+server-side translations if you have to modify the text sent to users.
+* Avoid truncating strings unless translations and multibyte characters
+are handled properly.
diff --git a/advtrains/po/README.md b/advtrains/po/README.md
deleted file mode 100644
index 3e94682..0000000
--- a/advtrains/po/README.md
+++ /dev/null
@@ -1,70 +0,0 @@
-# Translations
-Please read this document before working on any translations.
-
-Unlike many other mods, Advtrains uses `.po` files for localization,
-which are then automatically converted to `.tr` files when the mod is
-loaded. Therefore, please submit patches that edit the `.po` files.
-
-## Getting Started
-The translation files can be edited like any other `.po` file.
-
-If the translation file for your language does not exist, create it by
-copying `template.txt` to `advtrains.XX.tr`, where `XX` is replaced by
-the language code.
-
-Feel free to use the [discussion mailing list][srht-discuss] if you
-have any questions regarding localization.
-
-You can share your `.po` file directly or [as a patch][gsm] to the [dev
-mailing list][srht-devel]. The latter is encouraged, but, unlike code
-changes, translation files sent directly are also accepted.
-
-[tr-format]: https://minetest.gitlab.io/minetest/translations/#translation-file-format
-[srht-discuss]: https://lists.sr.ht/~gpcf/advtrains-discuss
-[srht-devel]: https://lists.sr.ht/~gpcf/advtrains-devel
-[gsm]: https://git-send-email.io
-
-## Translation Notes
-* Translations should be consistent. You can use other entries or the
-translations in Minetest as a reference.
-* Translations do not have to fully correspond to the original text -
-they only need to provide the same information. In particular,
-translations do not need to have the same linguistical structure as the
-original text.
-* Replacement sequences (`@1`, `@2`, etc) should not be translated.
-* Certain abbreviations or names, such as "Ks" or "Zs 3", should
-generally not be translated.
-
-### (de) German
-* Verwenden Sie die neue Rechtschreibung und die Sie-Form.
-* Mit der deutschen Tastaturbelegung unter Linux können die
-Anführungszeichen „“ mit AltGr-V bzw. AltGr-B eingegeben werden.
-
-### (zh) Chinese
-(This section is written in English to avoid writing the note twice or
-using only one of the variants, as most of this section applies to both
-the traditional and simplified variants.)
-
-* Please use the 「」 quotation marks for Traditional Chinese and “”
-for Simplified Chinese.
-* Please use the fullwidth variants of: ， 、 。 ？ ！ ： ；
-* Please use the halfwidth variants of: ( ) [ ] / \ |
-* Please do not leave any space between Han characters (including
-fullwidth punctuation marks).
-* Please leave a space between Han characters (excluding fullwidth
-punctuation marks) and characters from other scripts (including
-halfwidth punctuation marks). However, do not leave any space between
-Han characters and Arabic numerals.
-
-## Notes for developers
-* The `update-translations.sh` script can be used to update the
-translation files. However, please make sure to install the
-`basic_trains` mod before running the script.
-* Please make sure that the first argument to `S` (or `attrans`) _only_
-includes string literals without formatting or concatenation. This is
-unfortunately a limitation of the `xgettext` utility.
-* Avoid word-by-word translations.
-* Avoid manipulating translated strings (except for concatenation). Use
-server-side translations if you have to modify the text sent to users.
-* Avoid truncating strings unless multibyte characters are handled
-properly.
diff --git a/advtrains_interlocking/po/README.md b/advtrains_interlocking/po/README.md
deleted file mode 100644
index 3e94682..0000000
--- a/advtrains_interlocking/po/README.md
+++ /dev/null
@@ -1,70 +0,0 @@
-# Translations
-Please read this document before working on any translations.
-
-Unlike many other mods, Advtrains uses `.po` files for localization,
-which are then automatically converted to `.tr` files when the mod is
-loaded. Therefore, please submit patches that edit the `.po` files.
-
-## Getting Started
-The translation files can be edited like any other `.po` file.
-
-If the translation file for your language does not exist, create it by
-copying `template.txt` to `advtrains.XX.tr`, where `XX` is replaced by
-the language code.
-
-Feel free to use the [discussion mailing list][srht-discuss] if you
-have any questions regarding localization.
-
-You can share your `.po` file directly or [as a patch][gsm] to the [dev
-mailing list][srht-devel]. The latter is encouraged, but, unlike code
-changes, translation files sent directly are also accepted.
-
-[tr-format]: https://minetest.gitlab.io/minetest/translations/#translation-file-format
-[srht-discuss]: https://lists.sr.ht/~gpcf/advtrains-discuss
-[srht-devel]: https://lists.sr.ht/~gpcf/advtrains-devel
-[gsm]: https://git-send-email.io
-
-## Translation Notes
-* Translations should be consistent. You can use other entries or the
-translations in Minetest as a reference.
-* Translations do not have to fully correspond to the original text -
-they only need to provide the same information. In particular,
-translations do not need to have the same linguistical structure as the
-original text.
-* Replacement sequences (`@1`, `@2`, etc) should not be translated.
-* Certain abbreviations or names, such as "Ks" or "Zs 3", should
-generally not be translated.
-
-### (de) German
-* Verwenden Sie die neue Rechtschreibung und die Sie-Form.
-* Mit der deutschen Tastaturbelegung unter Linux können die
-Anführungszeichen „“ mit AltGr-V bzw. AltGr-B eingegeben werden.
-
-### (zh) Chinese
-(This section is written in English to avoid writing the note twice or
-using only one of the variants, as most of this section applies to both
-the traditional and simplified variants.)
-
-* Please use the 「」 quotation marks for Traditional Chinese and “”
-for Simplified Chinese.
-* Please use the fullwidth variants of: ， 、 。 ？ ！ ： ；
-* Please use the halfwidth variants of: ( ) [ ] / \ |
-* Please do not leave any space between Han characters (including
-fullwidth punctuation marks).
-* Please leave a space between Han characters (excluding fullwidth
-punctuation marks) and characters from other scripts (including
-halfwidth punctuation marks). However, do not leave any space between
-Han characters and Arabic numerals.
-
-## Notes for developers
-* The `update-translations.sh` script can be used to update the
-translation files. However, please make sure to install the
-`basic_trains` mod before running the script.
-* Please make sure that the first argument to `S` (or `attrans`) _only_
-includes string literals without formatting or concatenation. This is
-unfortunately a limitation of the `xgettext` utility.
-* Avoid word-by-word translations.
-* Avoid manipulating translated strings (except for concatenation). Use
-server-side translations if you have to modify the text sent to users.
-* Avoid truncating strings unless multibyte characters are handled
-properly.
diff --git a/advtrains_line_automation/po/README.md b/advtrains_line_automation/po/README.md
deleted file mode 100644
index 3e94682..0000000
--- a/advtrains_line_automation/po/README.md
+++ /dev/null
@@ -1,70 +0,0 @@
-# Translations
-Please read this document before working on any translations.
-
-Unlike many other mods, Advtrains uses `.po` files for localization,
-which are then automatically converted to `.tr` files when the mod is
-loaded. Therefore, please submit patches that edit the `.po` files.
-
-## Getting Started
-The translation files can be edited like any other `.po` file.
-
-If the translation file for your language does not exist, create it by
-copying `template.txt` to `advtrains.XX.tr`, where `XX` is replaced by
-the language code.
-
-Feel free to use the [discussion mailing list][srht-discuss] if you
-have any questions regarding localization.
-
-You can share your `.po` file directly or [as a patch][gsm] to the [dev
-mailing list][srht-devel]. The latter is encouraged, but, unlike code
-changes, translation files sent directly are also accepted.
-
-[tr-format]: https://minetest.gitlab.io/minetest/translations/#translation-file-format
-[srht-discuss]: https://lists.sr.ht/~gpcf/advtrains-discuss
-[srht-devel]: https://lists.sr.ht/~gpcf/advtrains-devel
-[gsm]: https://git-send-email.io
-
-## Translation Notes
-* Translations should be consistent. You can use other entries or the
-translations in Minetest as a reference.
-* Translations do not have to fully correspond to the original text -
-they only need to provide the same information. In particular,
-translations do not need to have the same linguistical structure as the
-original text.
-* Replacement sequences (`@1`, `@2`, etc) should not be translated.
-* Certain abbreviations or names, such as "Ks" or "Zs 3", should
-generally not be translated.
-
-### (de) German
-* Verwenden Sie die neue Rechtschreibung und die Sie-Form.
-* Mit der deutschen Tastaturbelegung unter Linux können die
-Anführungszeichen „“ mit AltGr-V bzw. AltGr-B eingegeben werden.
-
-### (zh) Chinese
-(This section is written in English to avoid writing the note twice or
-using only one of the variants, as most of this section applies to both
-the traditional and simplified variants.)
-
-* Please use the 「」 quotation marks for Traditional Chinese and “”
-for Simplified Chinese.
-* Please use the fullwidth variants of: ， 、 。 ？ ！ ： ；
-* Please use the halfwidth variants of: ( ) [ ] / \ |
-* Please do not leave any space between Han characters (including
-fullwidth punctuation marks).
-* Please leave a space between Han characters (excluding fullwidth
-punctuation marks) and characters from other scripts (including
-halfwidth punctuation marks). However, do not leave any space between
-Han characters and Arabic numerals.
-
-## Notes for developers
-* The `update-translations.sh` script can be used to update the
-translation files. However, please make sure to install the
-`basic_trains` mod before running the script.
-* Please make sure that the first argument to `S` (or `attrans`) _only_
-includes string literals without formatting or concatenation. This is
-unfortunately a limitation of the `xgettext` utility.
-* Avoid word-by-word translations.
-* Avoid manipulating translated strings (except for concatenation). Use
-server-side translations if you have to modify the text sent to users.
-* Avoid truncating strings unless multibyte characters are handled
-properly.
diff --git a/advtrains_luaautomation/po/README.md b/advtrains_luaautomation/po/README.md
deleted file mode 100644
index 3e94682..0000000
--- a/advtrains_luaautomation/po/README.md
+++ /dev/null
@@ -1,70 +0,0 @@
-# Translations
-Please read this document before working on any translations.
-
-Unlike many other mods, Advtrains uses `.po` files for localization,
-which are then automatically converted to `.tr` files when the mod is
-loaded. Therefore, please submit patches that edit the `.po` files.
-
-## Getting Started
-The translation files can be edited like any other `.po` file.
-
-If the translation file for your language does not exist, create it by
-copying `template.txt` to `advtrains.XX.tr`, where `XX` is replaced by
-the language code.
-
-Feel free to use the [discussion mailing list][srht-discuss] if you
-have any questions regarding localization.
-
-You can share your `.po` file directly or [as a patch][gsm] to the [dev
-mailing list][srht-devel]. The latter is encouraged, but, unlike code
-changes, translation files sent directly are also accepted.
-
-[tr-format]: https://minetest.gitlab.io/minetest/translations/#translation-file-format
-[srht-discuss]: https://lists.sr.ht/~gpcf/advtrains-discuss
-[srht-devel]: https://lists.sr.ht/~gpcf/advtrains-devel
-[gsm]: https://git-send-email.io
-
-## Translation Notes
-* Translations should be consistent. You can use other entries or the
-translations in Minetest as a reference.
-* Translations do not have to fully correspond to the original text -
-they only need to provide the same information. In particular,
-translations do not need to have the same linguistical structure as the
-original text.
-* Replacement sequences (`@1`, `@2`, etc) should not be translated.
-* Certain abbreviations or names, such as "Ks" or "Zs 3", should
-generally not be translated.
-
-### (de) German
-* Verwenden Sie die neue Rechtschreibung und die Sie-Form.
-* Mit der deutschen Tastaturbelegung unter Linux können die
-Anführungszeichen „“ mit AltGr-V bzw. AltGr-B eingegeben werden.
-
-### (zh) Chinese
-(This section is written in English to avoid writing the note twice or
-using only one of the variants, as most of this section applies to both
-the traditional and simplified variants.)
-
-* Please use the 「」 quotation marks for Traditional Chinese and “”
-for Simplified Chinese.
-* Please use the fullwidth variants of: ， 、 。 ？ ！ ： ；
-* Please use the halfwidth variants of: ( ) [ ] / \ |
-* Please do not leave any space between Han characters (including
-fullwidth punctuation marks).
-* Please leave a space between Han characters (excluding fullwidth
-punctuation marks) and characters from other scripts (including
-halfwidth punctuation marks). However, do not leave any space between
-Han characters and Arabic numerals.
-
-## Notes for developers
-* The `update-translations.sh` script can be used to update the
-translation files. However, please make sure to install the
-`basic_trains` mod before running the script.
-* Please make sure that the first argument to `S` (or `attrans`) _only_
-includes string literals without formatting or concatenation. This is
-unfortunately a limitation of the `xgettext` utility.
-* Avoid word-by-word translations.
-* Avoid manipulating translated strings (except for concatenation). Use
-server-side translations if you have to modify the text sent to users.
-* Avoid truncating strings unless multibyte characters are handled
-properly.