From 551cd7da5b4903172246d8913db2a9da10adb647 Mon Sep 17 00:00:00 2001 From: "Y. Wang" Date: Wed, 4 Oct 2023 20:11:15 +0200 Subject: Link locale/README.md to its po/ counterpart --- advtrains/locale/README.md | 71 +--------------------------------------------- 1 file changed, 1 insertion(+), 70 deletions(-) mode change 100644 => 120000 advtrains/locale/README.md diff --git a/advtrains/locale/README.md b/advtrains/locale/README.md deleted file mode 100644 index 3e94682..0000000 --- a/advtrains/locale/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/locale/README.md b/advtrains/locale/README.md new file mode 120000 index 0000000..61e473c --- /dev/null +++ b/advtrains/locale/README.md @@ -0,0 +1 @@ +../po/README.md \ No newline at end of file -- cgit v1.2.3