Live GIS Translate

This page describes how to translate documentation for the OSGeo-Live DVD.
= Getting Started =
Thanks for considering translating the OSGeo-Live documentation. To get started:
; Introduce yourself.
: Please join our email list at: http://lists.osgeo.org/mailman/listinfo/live-demo, and send an email introducing yourself and your wish to help out. If you wish to start translating to a new language, let us know so that we can create a new status worksheet for you.
We moved from svn to git. So please read about the next steps here:
* Live_GIS_Disc#Git_migration
; Credit yourself
: As a first test to see subversion is working, add your name to the list of translators.
 
= Status Sheet =
* Documents ready to translate are marked "Final" in our Project Status Spreadsheet.
* Check the Translation Status to find files that need translation, or need updating. Note that the hyperlink for each translated doc will take you to a page showing the differences in the English doc since last translation. (This document is updated hourly by extracting document version from subversion).
= Nightly documentation builds =
* http://adhoc.osgeo.osuosl.org/livedvd/
** Latest documentation build can be found in the docs/ dir.
** Please have a look at and squash any problems which show up in the error log, which can be found in the logs/ dir.
= Translations =
This is how it works:
* Find documents that have a "Final" status in our Project Status sheet and which are not translated or outdated in the Translation Status.
* If this is a new translated document, use subversion to copy the English version of the document to new language directory. (This retains our subversion history, while svn add does not)
 svn copy doc/en/<doc>.rst doc/lang/<doc>.rst (old version with svn)
 cp en/<doc>.rst doc/lang/<doc>.rst
* add your name as translator of the document: add :Translator: Your_name at the top of document near :Reviewer: or Author
* translate the document and then commit back to subversion
 git add docX.rst
 git commit -m "Translated docX.rst to Italian" docX.rst
 git push origin master
* Once complete change status="complete"
== Adding new languages ==
Make sure you edit the list in:
* doc/Makefile
* doc/themes/overview/page.html
* doc/index.template
* bin/lang_stats.sh
Setup the dir structure:
 LCODE=pt
 
 cd doc/
 mkdir $LCODE
 cd $LCODE
 mkdir overview/ quickstart/ standards/
 cd ..
 git add $LCODE
 git commit -m 'new directory' $LCODE
 git push origin master
Remember that when `doc/Makefile` changes the hash needs to be updated; contact Hamish.
== Glossary ==
At this page you can find a glossary of OSGeo-Live documentation related terms, please fell free to add new terms.
== Use OmegaT for the translations ==
* there is a nice tool to generate the translations http://www.omegat.org/ (here you find a good documentation)
* To install the tool on a Ubuntu or Debian system (such as the live disc) run:
 sudo apt-get install omegat
* add the ending rst to be supported by OmegaT
** configure: Options → file filter → textfiles → add → add *.rst 
* Create a new project: 
** Select a folder where OmegaT can write its files 
** Select your destination language, point Source Files directory to doc/en, and Translated Files directory to doc/$your-language-code. The two middle options can stay where they are in subfolders of OmegaT project folder.
** Translate something.
** Write files: Project → Create Translated Documents will populate doc/$your-language into git tree. All .rst files contain both translated and untranslated strings.
** git commit
** git push origin master
* Work on an already started translation:
** TO BE DONE - is OmegaT able to handle contents under version control? Seems not, for me.
== Move to Transifex ==
There is the plan to move the translation to Transifex. The documentation/discussion can be found here: https://wiki.osgeo.org/wiki/Talk:Live_GIS_Translate
Category: Live-demo
Category: Translation