Translating Gaggle

This page documents how to add a new supported language to Gaggle.

The minimum set of files to change

https://raw.github.com/geeksville/Gaggle/master/res/values/strings.xml Download this and edit it using the text editor of your choice (notepad etc...). At the top of the file it explains how to change each of the strings.

Extra files to change

Changing just the strings.xml file will get you 90% of the way to supporting any language. However, if you'd like 'bonus points' the following files could also use fixing for a new lanugage:

1. https://raw.github.com/geeksville/Gaggle/master/res/values/arrays.xml Copy and translate the text for the sections marked as
2. https://raw.github.com/geeksville/Gaggle/master/assets/manual/no_flights.html
3. https://raw.github.com/geeksville/Gaggle/master/assets/manual/no_waypoints.html Feel free to change the waypoints file to include links to a source of waypoints that makes more sense for your language.

What to do with the translated files?

Just email your modified files to me and I'll spit out a test build and send it to you. Or if you'd like to use this as an excuse to learn github proceed to the next section:

Checking translation into github

1. Follow the instructions at http://help.github.com/fork-a-repo/ to fork https://github.com/geeksville/Gaggle
2. Create a subdirectory of "res" named "values-" where is the two letter code for your language.
3. Copy res/values/strings.xml and res/values/arrays.xml to the directory you just created. Apply translations as described above - making sure to delete any entries which you don't need to translate.
4. If you'd like to update the two most critical html files, cd into "assets" then copy no_flights.html and no_waypoints.html into no_flights-.html and no_waypoints-.html. See the existing Spanish translation for an example.
5. Change the files on your local machine then push them back up to your fork (see "Push Commits" in the fork-a-repo document linked above)
6. Send me a "pull request" from your repo - see instructions here: here

Learning git stuff might be kinda painful - if you have questions I'm happy to help. If you decide to just email the files that is fine too.