Files @ ffd45b185016
Branch filter:

Location: kallithea/rhodecode/i18n/how_to

Bradley M. Kuhn
Imported some of the GPLv3'd changes from RhodeCode v2.2.5.

This imports changes between changesets 21af6c4eab3d and 6177597791c2 in
RhodeCode's original repository, including only changes to Python files and HTML.

RhodeCode clearly licensed its changes to these files under GPLv3
in their /LICENSE file, which states the following:
The Python code and integrated HTML are licensed under the GPLv3 license.

(See:
https://code.rhodecode.com/rhodecode/files/v2.2.5/LICENSE
or
http://web.archive.org/web/20140512193334/https://code.rhodecode.com/rhodecode/files/f3b123159901f15426d18e3dc395e8369f70ebe0/LICENSE
for an online copy of that LICENSE file)

Conservancy reviewed these changes and confirmed that they can be licensed as
a whole to the Kallithea project under GPLv3-only.

While some of the contents committed herein are clearly licensed
GPLv3-or-later, on the whole we must assume the are GPLv3-only, since the
statement above from RhodeCode indicates that they intend GPLv3-only as their
license, per GPLv3ยง14 and other relevant sections of GPLv3.
##########################
# to create new language #
##########################

Translations are available on transifex under::

    https://www.transifex.com/projects/p/RhodeCode/

Preferred method is to register on transifex and request new language translation.

manual creation of new language
+++++++++++++++++++++++++++++++
 
Dowload sources of RhodeCode. Run::

    python setup.py develop

To prepare the enviroment


Make sure all translation strings are extracted by running::

    python setup.py extract_messages

Create new language by executing following command::
    python setup.py init_catalog -l <new_language_code>

This creates a new language under directory rhodecode/i18n/<new_language_code>
Be sure to update transifex mapping under .tx/config for new language

Edit the new PO file located in LC_MESSAGES directory with poedit or your
favorite PO files editor. Do translations and at the end verify the translation
file for any errors. This can be done by executing::

    msgfmt -f -c rhodecode/i18n/<new_language_code>/LC_MESSAGES/<updated_file.po>

finally compile the translations::

    python setup.py compile_catalog -l <new_language_code>

##########################
# to update translations #
##########################

Fetch latest version of strings for translation by running::

    python setup.py extract_messages

Update PO file by doing::

    python setup.py update_catalog -l <new_language_code><- to update the translations

Edit the new updated po file. Repeat all steps after `init_catalog` step from
new translation instructions


########################
# testing translations #
########################

Edit test.ini file and set lang attribute to::

    lang=<new_language_code>

Run RhodeCode tests by executing::

    nosetests