Translation

As Mifos is an open source organisation and the app is being used over the globe, there's a dire need to have it translated into various languages.

We welcome everyone who can translate the app but also request not to add incorrect/equivocal/ambiguous words (which may be the case if someone uses Google Translate or some similar translation technology) and hence, prefer the natives or those with substantial knowledge of the language to contribute to translation.

For your convenience, below is a detailed (don't worry it's rather small) guide explaining how you can translate the app; to contribute to the project, or just to solve your own purpose.

Pre-Requisites

• Translation of the app doesn't require any kind of prior programming knowledge. However, you must have built the code on your system. The instructions for the same are mentioned at

1. https://github.com/openMF/android-client/wiki/Android-Studio-Setup and at
2. https://github.com/openMF/android-client/wiki/Building-up-Code

• If you'd like to contribute and send a Pull Request (aka PR), which we'll appreciate very much, you should also possess some knowledge of git.

Procedure

Now, since you are ready to add your own flavor into the app, follow these steps:

1. Select Project in the Project Explorer (refer below GIF if you don't know what it is) section.
2. Expand to /res/values-xx directory If it's not present, create a new directory with the name values-xx (without quotes where xx is the code for the language, e.g. en for English). You may find the code in the issue listed, most probably, here: https://github.com/openMF/android-client/issues/703
3. Create a new file with the name strings.xml. You may ignore the popup shown in the GIF file.
4. Copy the contents of the /res/values/strings.xml file.
5. Enter the values for the corresponding strings in the target language.

Below GIF elucidates this seemingly daunting task by translating the string login into लॉग इन करें - the corresponding text in Hindi (hi). Right click on the GIF and select 'Open in new tab' if the words are illegible.

If you want, you can also utilise Android Studio's 'Translation Editor' to add the translated strings. To do that, you should follow the aforementioned steps 1-3. After that follow these steps:

4. Expand the directories to find values (default) folder and double tap on the strings.xml file.
5. Observe the Open Editor on the right top side and click it.
6. Select the string you want to translate and add the translated text.

For your convenience, below GIF presents an example on how you can do that by taking Account Number as an example and translating it into खाता संख्या - the corresponding Hindi (hi) text. Right click on the GIF and select 'Open in new tab' if the words are illegible.