Journal Translation

From OSGeo
Revision as of 01:49, 11 August 2014 by Leo (talk | contribs) (moved Journal Translation on wheels to Journal Translation over redirect)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

WORK IN PROGRESS - Reviewing the concepts as laid out here http://wiki.qgis.org/qgiswiki/DocumentationWritersCorner


The primary version of the OSGeo Journal is written in United States English. Translators are welcome to translate any portion of the OSGeo Journal into another language, but must work as close as possible with the Journal editorial team.

Please join the Journal mailing list and introduce yourself as a translator. Also add yourself to the appropriate list(s) below.

Guidelines

Please review the Journal Licensing and Guidelines page first, to read about licensing conditions of the work. There must be at least two people reviewing a translated work for a particular language, to help ensure accurate translation. A single translator must have someone proof-read the final work.

Translation Team

Please list your language and the names and contact information for those who are part of your translation language team.

DRAFT Ideas - need refining

Process

The text of the Journal is managed in a subversion code repository, as latex text files. When a volume of the Journal is released as US English, it is always stored in a folder with a version number and a folder called en-us, i.e. journal/volume_1/en-us.

Other language specific branches can then be made using their two letter language code and, optionally, a two letter country code (e.g. es for Spanish, pt for Portuguese, pt-br for Brazilian Portuguese, etc.).

Setting up SVN

Administrator creates language specific folder from a copy of main version

svn copy -m "set up french version" http://svn.osgeo.org/osgeo/journal/volume_1/en-us http://svn.osgeo.org/osgeo/journal/volume_1/fr

Translator checks out language specific folder

svn checkout http://svn.osgeo.org/osgeo/journal/volume_1/fr

Translator edits files in local copy of the language folder - not in main volume folder

vi fr/editorial/mitchell.tex
vi fr/topical/blake/blake.tex
etc...

Compiling documentation should still work after translation

cd fr
make
cp OSGeoJournal_vol1.pdf final_pdfs

Submit back to repository

svn commit --message "comments here" fr

Proof reader and co-translators must then review changes. Editorial team can then post the translated version to the main Journal pages.