Contribute

I would like to thank the following contributors who have suggested code improvements, fixes, translations, updates, changes and helped me when I didn't have a clue what was going on (most are contributors via GitHub and I've used their 'handle' to credit them).  I'm sorry if I've missed anyone or if you'd rather I didn't list you here or want it shown differently - just let me know!!  Most of you will know who you are already and that I appreciate your regular communications and support.

• iv-gha

• Alistair

• millerthegorilla

• angelosne

• ermshiperete

• tklute

• hohwille

• Steban23m

• SergKnyz

• Malcy

• Oliver

• Ol-li

• Frank

• Jan

• Ivan

• Tsaraz

• Michał Dominiczak

Improve the translations

OpenSongApp was originally created using an English translation, however, I have attempted to provide alternative translations with the app.  These translations were originally made using Google Translate, so they aren't perfect.  I would encourage you to help out with translations if you can.  Read on to find out more.

How to help

The app is created using Android studio and the translations are saved as XML files.  They are stored on GitHub and can be edited freely.  You don't need to know any of the complicated stuff (Android programming, JAVA, Repositories, GitHub branches/masters),  all you need to do is be able to understand simple xml and I'll show you how.....

Open up the OpenSong Tablet source code on GitHub (the links below takes you to the translations folders).

If you want to edit a specific language, click on the appropriate values folder (make sure you are on the MaterialApp branch):

• values = English (UK)

• values-af = Afrikaans

• values-cz = Czech

• values-de = German

• values-el = Greek

• values-es = Spanish

• values-fr = French

• values-hu = Hungarian

• values-it = Italian

• values-ja = Japanese

• values-pl = Polish

• values-pt = Portuguese

• values-ru = Russian

• values-sr = Serbian

• values-sv = Swedish

• values-uk = Ukranian

• values-zh = Chinese (simplified)

- https://github.com/thebigg73/OpenSongTablet/tree/MaterialApp/app/src/main/res

Each folder has a file in it named strings.xml.  These are the translation files and you can view them by clicking on the file you want.  They all follow the same format.  An excerpt of the English translation (values/strings.xml) looks like this:

<string name="options_song_newfolder">Create new song folder</string>

The name part identifies the text so the app can find it.  Do not change this!  The bit I've highlighted in bold can be changed.  If you use the app in German and think the translation of this bit of text can be improved (this is a menu item), here's how to do it-

Open the German translation (values-de/strings.xml), look for the same string name and find the line:

<string name="options_song_newfolder">"Erstelle eine neue Song-Ordner"</string>

You can simply copy this line and email it to me, or post it on the forum with your improved translation.  I'll incorporate it in the app.  Or, better still register for a free GitHub account, sign in and edit the translation file directly.  I will be notified of changes and will be asked to approve them (you won't break anything!).  Please notice that the translation text can be placed inside quotation marks (" "), but these aren't required.  Any apostrophes should be 'escaped' by placing a backslash in front of them: \' rather than '.  If you see \n in a string, this simply is an instruction for the app to start the next piece of text on a new line.

Any changes made here will become active when I next update the app.

You will notice that some strings are combined.  E.g.  the string names "ok", "on" and "off" are sometimes added to other strings.