File: TRANSLATORS

package info (click to toggle)
sonata 1.7.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 4,164 kB
  • sloc: python: 9,480; sh: 33; makefile: 15
file content (96 lines) | stat: -rw-r--r-- 3,163 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Sonata provides a quick and easy way of creating a translation for
your language. If you find this software useful and are capable of
adding a language that has not yet been translated, it would be
greatly appreciated.

Sonata uses the `Transifex plateform
<https://www.transifex.com/projects/p/sonata/>`_ as a translation helping
plateform, although you can probably also use any `gettext` compatible
translation editor.

In order to add a new translation or update a new translation, you can subscribe
to the `Transifex <https://www.transifex.com>`_ project and add yourself to the
team of translators according to your preferred language on the `Sonata project
page <https://www.transifex.com/projects/p/sonata/>`_.

Once you have a new translation ready, feel free to contact the Sonat's mailing
list at sonata@lists.berlis.de (registration required at
https://lists.nongnu.org/mailman/listinfo/sonata beforehand) or to contact the
author by email so your translation will be included in the next release!


Instrutions (mostly for developers)
===================================

Using Transifex
---------------

You need the `Transifex client <http://help.transifex.com/features/client/>`_ and
to configure your Transifex configuration file (probably ``~/.transifexrc``)
according to `the official
documentation <http://help.transifex.com/features/client/#transifexrc>`_::

    [https://www.transifex.com]
    hostname = https://www.transifex.com
    token =

    username = YOUR TRANSIFEX USERNAME
    password = YOUR TRANSIFEX PASSWORD

You can use then the ``tx`` command line tool to get or send the translation
files from/to Transifex:

    To refresh the translation strings on Transifex (so that new translation
    strings are available to translators)::

        $ tx push -s

    To get/update translations from/to Transifex::

        $ tx pull -l fr # Get the latest French translation from transifex.com
        ...
        $ tx push -t fr # Send the latest French translation to transifex.com


You can read the `officiel Transifex
documentation <http://help.transifex.com/features/client/>`_ for more information
about using the Transifex client.


Managing the translation without Transifex
------------------------------------------

You can use the script in ``script/update-po`` which wraps ``intltool``, or
directly ``intltool`` if you want, to manage the translation directly from the
Sonata repository.

.. warning:: Note that Transifex is the preferred plateform to manage
    translations, and that it should be keep up-to-date with respect to the
    content of the source tree.


Adding a new translation
''''''''''''''''''''''''

1. Download the latest sources with git
	$ git clone git://github.com/multani/sonata

2. Generate a template
	$ cd po
	$ intltool-update -p
	$ mv untiled.pot <LANGCODE>.po

3. Translate the strings

Updating an existing translation
''''''''''''''''''''''''''''''''

1. Download the latest sources with git
	$ git clone git://github.com/multani/sonata

2. Update the po file for the language you're updating
	$ intltool-update <LANGCODE>

3. Translate any strings that are new or fuzzy

.. vim:ft=rst