Conversion and Translation.txt updates

Converted portugese strings.po into .js file

doc/translation.txt

@@ -1,77 +1,91 @@
  
-  HOWTO TRANSLATE 
+HOW TO TRANSLATE 
-===================
+=====================================================================
 
-**NOTE TO DEVELOPERS**: 
+** 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 
+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.
-- thank you :)
+
+If you want to add some strings in the css (using content), please edit /script/localization.js too.
+
+Thank you :)
+
+
+ADDING A NEW LANGUAGE 
+=====================================================================
 
-  ADD A NEW LANGUAGE 
-======================
 Required tools:
 
-ubuntu:
+	ubuntu:
-   apt-get install gettext
+   	     apt-get install gettext
-   apt-get install poedit
+   	     apt-get install poedit
-   apt-get install python
+   	     apt-get install python
 
+	windows:
+   	     windows: http://poedit.net/
+   	     https://www.python.org/download/windows/
 
-windows:
+Steps:
-   windows: http://poedit.net/
+1) Create a new directory lang/{new_language_code}
-   https://www.python.org/download/windows/
+2) Download the file adarkroom.pot in the lang folder as translation template
+3) Create the new po file:
 
-
-- create a new directory lang/{new_language_code}
-- download the file adarkroom.pot in the lang folder as translation template
-- 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
 
-- copy lang/main.css to lang/{new_language}
+4) Copy lang/main.css to lang/{new_language}
-- open lang/{new_language}/strings.po with a software poedit
+5) Open lang/{new_language}/strings.po with a software poedit
-- translate ...
+6) Translate ...
-- keep translating ...
+7) Keep translating ...
-- finished ? sure ?
+8) Finished? Sure?
-- use the python script (/tools/po2js.py) to convert the po file to a js file
+9) Use the python script (/tools/po2js.py) to convert the po file to a js file
-	python tools/po2js.py lang/{new_language}/strings.po
 
-- edit README.md and add the following string: [{new_language_name}](http://adarkroom.doublespeakgames.com/?lang={new_language_code})
+  	run from command line/terminal:
-- edit lang/langs.js and add the new language
+	     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
 
-- if your sentence are too big and you need to update some css, overload it in /lang/{new_language}/main.css
+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 TEMPLATEFILE
+UPDATE TEMPLATE FILE
-======================
+=====================================================================
-When new content or changes in the code introduce new strings the file lang/adarkroom.pot must be updated.
+
+When new content or changes in the code introduce new strings, the file lang/adarkroom.pot must be updated.
 
 Required tools:
 
-ubuntu:
+	ubuntu:
-  apt-get install python3-babel
+ 	     apt-get install python3-babel
 
-windows:
+	windows:
-  poedit
+  	     poedit
 
-- ubuntu:
+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
+UPDATE LANGUAGE AFTER UPDATE
-===============================
+=====================================================================
+
 Required tools:
 
-ubuntu:
+	ubuntu:
-  * gettext
+ 	     * gettext
-windows:
+	windows:
-  * poedit
+  	     * poedit
 
 
 - ubuntu:
@@ -89,8 +103,9 @@ windows:
 - Edit in poedit as in "ADD A NEW LANGUAGE"
 
 
-  SETUP POEDIT
+SETUP POEDIT
-=================
+=====================================================================
+
 To update from source without pot file need:
 
 - Create new parser: