From f6d133804b7fdfab5a00d95a1985c3e220935ac1 Mon Sep 17 00:00:00 2001 From: Daniel Date: Sat, 5 Feb 2022 10:27:29 +1100 Subject: Provide nationalization (#893) * Nationalization * Add _ as builtins to flake8 * Removing conflict hash tag Co-authored-by: Daniel Girtler Co-authored-by: Anton Hvornum --- archinstall/locales/README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 archinstall/locales/README.md (limited to 'archinstall/locales/README.md') diff --git a/archinstall/locales/README.md b/archinstall/locales/README.md new file mode 100644 index 00000000..a2c65f79 --- /dev/null +++ b/archinstall/locales/README.md @@ -0,0 +1,33 @@ +# Nationalization + +Archinstall supports multiple languages, which depend on translations coming from the community :) + +New languages can be added simply by creating a new folder with the proper language abbrevation (see list `languages.json` if unsure). +Run the following command to create a new template for a language +``` + mkdir -p /LC_MESSAGES/ && touch /LC_MESSAGES/base.po +``` + +After that run the script `./locales_generator.sh` it will automatically populate the new `base.po` file with the strings that +need to be translated into the new language. +For example the `base.po` might contain something like the following now +``` +#: lib/user_interaction.py:82 +msgid "Do you really want to abort?" +msgstr "" +``` + +The `msgid` is the identifier of the string in the code as well as the default text to be displayed, meaning that if no +translation is provided for a language then this is the text that is going to be shown. + +To provide a translation for the language, simply write the translation in the `msgstr` part + +``` +#: lib/user_interaction.py:82 +msgid "Do you really want to abort?" +msgstr "Wollen sie wirklich abbrechen?" +``` + +After that run the script once more `./locales_generator.sh` and it will auto-generate the `base.mo` file with the included translations. +After that you're all ready to go and enjoy Archinstall in the new language :) + -- cgit v1.2.3-54-g00ecf