From fc5d44b3b1e2a344e94677401e7b103b1715d50a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Frans-Lukas=20L=C3=B6venvald?= Date: Thu, 4 Jun 2020 14:04:20 +0200 Subject: [PATCH] #2111 Created STRING_RESOURCES.md --- STRING_RESOURCES.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 STRING_RESOURCES.md diff --git a/STRING_RESOURCES.md b/STRING_RESOURCES.md new file mode 100644 index 000000000..d6fead918 --- /dev/null +++ b/STRING_RESOURCES.md @@ -0,0 +1,20 @@ +# String resources +All user visible strings in an Android application should be listed in strings.xml files to allow for easy translation, replacement and modification. Newly added string resources are imported by translatewiki and are then manually translated. After translations are complete the translations are merged with Kiwix Android. + +## How do I add a new string resource? +Start by adding your new string resource `new_string` to `values/strings.xml` in English. That is: +``` +... +New String +... +``` +You will now have to describe the string in `values-qq/strings.xml` with where and how the new string is used. E.x. for the string `On`: + +`values-qq/strings.xml:` +``` +... +This is used in the settings screen to turn on the night mode. +... +``` +- The values in `values/strings.xml` are the strings that are going to be displayed in the Kiwix application to the user. +- The values in `values-qq/strings.xml` are only visible to the translator and are only there to help them make a correct translation.