 
HOW TO TRANSLATE 
=====================================================================

** NOTE TO DEVELOPERS **: 

All strings sent to the page must go through the javascript function _() which will translate it. So please if you add new strings, wrap them with _('') function.

If you want to add some strings in the css (using content), please edit /script/localization.js too.

Thank you :)


ADDING A NEW LANGUAGE 
=====================================================================

Required tools:

	ubuntu:
   	     apt-get install gettext
   	     apt-get install poedit
   	     apt-get install python

	windows:
   	     http://poedit.net/
   	     https://www.python.org/download/windows/

	mac:
	    http://poedit.net
	    https://www.python.org/downloads/mac-osx/

Steps:
1) Create a new directory lang/{new_language_code}
2) Download the file adarkroom.pot in the lang folder as translation template
3) Create the new po file:

  ubuntu:
	msginit --locale {locale for new language eg: en_US} -i lang/adarkroom.pot -o lang/{new_language}/strings.po
  windows:
        - open application interface > File > New... > [select language for translation] > Save as... > lang/{new_language_code}/strings.po
        - [update from POT file] > select lang/adarkroom.pot

4) Copy lang/main.css to lang/{new_language}
5) Open lang/{new_language}/strings.po with a software poedit
6) Translate ...
7) Keep translating ...
8) Finished? Sure?
9) Use the python script (/tools/po2js.py) to convert the po file to a js file

  	run from command line/terminal:
	     python tools/po2js.py lang/{new_language}/strings.po
  	Note:
	     make sure to have polib module installed or the command line/terminal will give you an error
	     polib can be downloaded and installed via the command line/terminal from the python website
       on windows it could be necessary to run the command prompt as Administrator 
       Win Vista/7: start > right-click on command prompt > Run as Administrator
       Win 8: File panel > mouse over Command prompt > click on Run command prompt as Administrator

10) Edit README.md and add the following string: [{new_language_name}](http://adarkroom.doublespeakgames.com/?lang={new_language_code})
11) Edit lang/langs.js and add the new language

Note: If your sentence are too big and you need to update some css, overload it in /lang/{new_language}/main.css


UPDATE TEMPLATE FILE
=====================================================================

When new content or changes in the code introduce new strings, the file lang/adarkroom.pot must be updated.

Required tools:

	ubuntu:
 	     apt-get install python3-babel

	windows & mac:
  	     poedit

Steps:
  ubuntu:
	pybabel extract -F babel.cfg -c "TRANSLATORS" script > lang/adarkroom.pot
  
  windows:
	use poedit
	Use menu "Cataloge"-> "New Catalog from POT file..."


UPDATE LANGUAGE AFTER UPDATE
=====================================================================

Required tools:

	ubuntu:
 	     * gettext
	windows & mac:
  	     * poedit


- ubuntu:
	msgmerge -U lang/{language}/strings.po lang/adarkroom.pot

  windows:
	Open lang/{language}strings.po in poedit
	Use menu "Cataloge"-> "Update from POT file..."

	OR

	After "SETUP POEDIT"
	Use menu "Cataloge"-> "Update from source"

- Edit in poedit as in "ADD A NEW LANGUAGE"


SETUP POEDIT
=====================================================================

To update from source without pot file need:

- Create new parser:
  File > Preferences > Parsers > New

  Language:
  JS

  List of extension:
  *.js

  Parser command:
  xgettext --language=JavaScript --force-po --add-comments=TRANSLATORS -o %o %C %K %F

  Item in Keyword List:
  -k%k

  Item in input files list:
  %f

  Source code charset:
  --from-code=%c
