Simple Groupware is written in English and contains translations for German, Arabic, Brazil/Portuguese, Greek, Croatian, Czech, Danish, Dutch, Ukrainian, French, Hungarian, Indonesian, Italian, Russian, Polish, Slovak, Spanish, Swedish, Turkish and Chinese (Simplified). Translations include the wording and date/time formats.

This is a small guide to help you building your own translations and getting your language into the next release of Simple Groupware.

• To start with the translation into your language, please download the latest release of Simple Groupware (here).
• Extract the archive.
• You'll find a directory named "lang" in the root. Inside this directory all language files are kept.
• Every language has one file. In this file all strings that should be translated are kept, including those from PHP scripts, XML modules, Javascript files, HTML templates, etc.
• To start with your translation, make a copy of master.lang and specify a name corresponding to your language (e.g. de.lang for German).
• Inside the language file, every original item and every translated item is placed on a separate line.
• The original language is English. The English items are written inside translation tokens {t} and {/t} (e.g. {t}Sentence to translate{/t})
• The next line after the original English item will contain your translation
• The line after your translation is left empty.
• If you don't want to translate an item and use the English term instead, copy the English translation in the translation line.
• In addition to words and sentences, also date and time settings can be translated into your language.
• The exact expressions (e.g. m/d/Y) can be found under (http://www.php.net/date)
• E.g. "g:i a" shows hours and minutes in the 12 hour style, using the translation "H:i" gives the 24 hour style.
• When you're finished, please send your language file to info2009@simple-groupware.de. If you have any questions, feel free to mail me. You might also get some help with the translation by using Google Translate.
• It will be available with the next release and published under the GNU GPLv2 license.

Note: Simple Groupware automatically tries to detect the charset. If your language file is using UTF-8, it needs a BOM header at the beginning to be included correctly. I recommend Notepad++ as editor for creating or changing language files.

Note: Language files are not parsed by Simple Groupware for every page request. Instead they are compiled into the php code in order to increase the performance.
If you want to test your new language file, empty the directory "<sgs-dir>/bin/" and delete the file "<sgs-dir>/simple_store/config.php". Then open your browser with http://your_server/sgs_dir/src/index.php?lang=<your-country-extension>, e.g. http://localhost/sgs/src/index.php?lang=de to process the German translation file de.lang and run a new installation.

Important: Please commit your translation items as soon as you have created them in order to avoid duplicates and redundant work of others.