lyase / keepscore

Score keeping app for Android.

KeepScore

Author

Nolan Lawson

License

WTFPL, although attribution would be nice.

Overview

KeepScore is a free and open-source score-keeping app for Android. Feel free to file bugs on the GitHub page or branch the code yourself! Just send me a merge request and I'll try to incorporate your changes into the app on the Android Market.

More details about the app can be found on my website or the Google Play Store.

Build it yourself

KeepScore is built using Maven. To build, install, and run on your device, simply cd to the KeepScore/ directory and do:

mvn clean install android:deploy android:run

To run the unit tests, cd to the KeepScoreTest/ directory and do:

mvn clean install

You must have Maven 3.0.3+ installed in order for this to work.

Add a translation

KeepScore is currently localized into English, French, Japanese, and German. For the benefit of board gamers around the world, though, I'm always happy to get new translations!

All you need to do is add some additional files, fork the project on GitHub, and send me a pull request. And thanks to GitHub file creation, you can do all of this through the web interface.

For instance, if your language is Esperanto (ISO code 'eo'), you would need to add the following files:

documentation/description-eo.txt              # Play Store description
documentation/updates-eo.txt                  # Play Store "What's New" (optional - not sure I'll maintain this)
KeepScore/res/values-eo/strings.xml           # main translations
KeepScore/res/values-eo/dimensions.xml        # useful if Esperanto has really long words, see e.g. French
KeepScore/res/raw-eo/version_and_credits.xml  # page shown in "About KeepScore"

You can use this table of the English, French, and Japanese translations to get an idea of what you should be doing:

English	French	Japanese
description-en.txt	description-fr.txt	description-ja.txt
strings.xml	strings.xml	strings.xml
dimensions.xml	dimensions.xml	dimensions.xml
version_and_credits.htm	version_and_credits.htm	version_and_credits.htm

Note that not all strings in strings.xml need to be translated. If you look at the English strings.xml file, you'll see that I've helpfully divided it into "non-translatable strings" and "translatable" strings. The "non-translatable" ones are just constants, so you only have to translate the latter group.

Please also tell me what name and email address you would like me to use in the "About" section, so I can give you proper credit. Or just fork and modify the file KeepScore/res/raw/translations.htm yourself. Thanks!