Differences between revisions 21 and 22
Revision 21 as of 2014-07-03 07:09:25
Size: 6228
Editor: andywenk
Comment: added Larbi Kouiti
Revision 22 as of 2014-07-03 07:23:07
Size: 191
Editor: andywenk
Comment: delete content, add has moved indicator
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
''@@ WIP''

The [[http://docs.couchdb.org|CouchDB documentation]] will now also be available in other languages than English. If you would like to read the documentation in your own language, we invite you to join the CouchDB translation team. Subscribe to the [[http://couchdb.apache.org/#localisation-mailing-list|localisation-mailing-list]] and drop us a note on which language you would like to work.

== Translators and Contributors ==

These nice people are doing translation work or help to get things running.

 * Facundo Farias (Spanish)
 * Robert Kowalski (German)
 * Jackie Xu (Chinese, Dutch)
 * Ivo Limmen (Dutch)
 * Billy Lee (Chinese, Korean)
 * Ido Ran (Hebrew)
 * Daniel Sularea (Romanian, Italian)
 * Michael Bykov (Russian)
 * Octavian Damiean (German)
 * Oliver Kurowski (German)
 * Gabriel Hnatów (Polish)
 * Manolo Micozzi (Italian)
 * Kamyar Navidan (Persian)
 * Bruno Pedro (Portuguese)
 * Makoto Hashimoto (Japanese 日本語)
 * Luiz Antonio de Vasconcelos Filho (Portuguese)
 * Thiago Miotto (Portuguese)
 * Andre Albert Silva Van Drunen (Portuguese)
 * Argan Wang (Chinese)
 * Larbi Kouiti (Arabic)
 * Alexander Shorin (Russian, Setup)
 * Jan Iversen (Danish, Setup, Reviewer)
 * Andy Wenk (German, Setup)

== How are translations made? ==

The CouchDB project is using the [[https://translate.apache.org/de/CouchDB/|ASF translation service]]. The software behind the service is called [[http://pootle.translatehouse.org/|Pootle]] and offers a good web-interface for translation work.

== Joining the translation team ==

Drop us a note on the l10n@couchdb.apache.org mailing-list that you want to join the translation team. We will send you an invitation email and ask you to answer some questions:

 * your preferred username
 * the language you would like to work on
 * ask you to state that your contributions are under the Apache 2 license

After you have replied to this email with the details we asked for, we will create an Pootle account at https://translate.apache.org/ and send another email with your username and details for the password creation process to you. Then you are ready to go. Please read the following info before you start.

== Start translating ==

The overview for all available languages can be found at https://translate.apache.org/projects/CouchDB/. Choosing the language you want to do translations for will direct you to the translation sources. You will find a directory and file structure. This structure is representing the documentation at http://docs.couchdb.org.

The translation will be made in a .po file ([[http://en.wikipedia.org/wiki/GNU_gettext|more info regarding GNU_gettext]]). Clicking on a file you want to translate will open a new page with status information for this file. To start your translations click ''Continue translation''. You will then be directed to a new page where all sections of this file are available. Clicking on a section will open a text field where you fill in your translation. After finishing you have to possibilities:

=== Submit mode ===

When submitting your translation, you indicate that the translation is final. If you thing some more work has to be done on this section, mark the checkbox ''Needs work''. If the checkbox is marked, the translation will be shown in italic text mode.

=== Suggest mode ===

When using this mode, your translation will be marked as a suggestion. This is visible on the language overview page. The suggestion has to be accepted by you or by another translator.

== Keep the Markup in the .po files ==

The sources for the CouchDB documentation are living in the CouchDB source repository. It is written in ''.rst'' files. If you want to have a look at these files, please follow [[http://docs.couchdb.org/en/latest/contributing.html|this guide]]. The files you find in the translation tool are generated into ''.pot'' files from these ''.rst'' files with [[http://sphinx-doc.org|Sphinx]] and are available for each language as ''.po'' files - the files you are directly translating. You will find some kind of markup in the ''.po'' files like:

{{{
You can start the CouchDB server by running::
}}}

The double colon is markup from the .rst files and it is important, that you keep them exactly like they are. A German translation would then look like this:

{{{
Du kannst den CouchDB Server starten in dem folgenden Befehl ausführst::
}}}

Another example:

{{{
Try `gmake` if `make` is giving you any problems.
}}}

will result into:

{{{
Probiere `gmake` aus wenn es bei der Nutzung von `make` zu Problemen kommt.
}}}

== Terminology / Glossary ==

Each language has it's own Glossary. You can reach it with the link ''Terminology''. The glossary was initially created from the translation files when they have been set up. The Glossary is intended to help make the translations more concise. So for example the word ''replication'' could be translated in German to ''Replikation'' but we want Pootle to suggest Replication to keep the english word.

See also [[http://docs.translatehouse.org/projects/pootle/en/stable-2.5.0/features/terminology.html#terminology|the official docuemntation]] for terminology.

== Links ==

[[https://wiki.openoffice.org/wiki/Pootle_User_Guide/Online_Pootle_User_Interface|Overview of the Pootle service form the user guide written by our friends at the Apache Open Office project]]

[[http://docs.translatehouse.org/projects/pootle/en/stable-2.5.0/|Official Pootle documentation for version 2.5]]

== Compiling HTML output from the documentation ==

Note: this is actually just for the english documentation. But it shows how one can compile the HTML output of the documentation:

{{{
git clone https://git-wip-us.apache.org/repos/asf/couchdb.git
cd couchdb
./bootstrap && ./configure
cd share/doc
make html
}}}

Open build/html/index.html in your browser to see the result.

You need to install Sphinx on your machine to be able to run this. The best way to install Sphinx is with easy_install:

{{{
sudo easy_install sphinx
}}}
This content has moved to https://cwiki.apache.org/confluence/display/COUCHDB/Translation+Guide

The official documentation has moved to http://docs.couchdb.org — The transition is not 100% complete, but http://docs.couchdb.org should be seen as having the latest info. In some cases, the wiki still has some more or older info on certain topics inside CouchDB.

You need to be added to the ContributorsGroup to edit the wiki. But don't worry! Just email any Mailing List or grab us on IRC and let us know your user name.

Translate the CouchDB Documentation

This content has moved to https://cwiki.apache.org/confluence/display/COUCHDB/Translation+Guide

Translation (last edited 2014-07-03 07:23:07 by andywenk)