~nskaggs/ubuntu-filemanager-app/fix-ap-item-renames

« back to all changes in this revision

Viewing changes to README.translations

  • Committer: Girish Rawat
  • Date: 2015-12-19 07:34:45 UTC
  • mto: This revision was merged to the branch mainline in revision 511.
  • Revision ID: emailgirishrawat@gmail.com-20151219073445-ymuc9aykt4wsqe8k
Improved READMEs

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Updating translations
2
 
 
3
 
Translations for the Filemanager app happen in [Launchpad Translations][] and
4
 
are automatically committed daily on the trunk branch in the po/ folder.
5
 
 
6
 
They are then built and installed as part of the package build, so that
7
 
developers don't really need to worry about them.
8
 
 
9
 
However, there is one task that needs to be taken care of: exposing new
10
 
translatable messages to translators. So whenever you add new translatable
11
 
messages in the code, make sure to follow these steps:
12
 
 
13
 
 1. Run click-buddy retaining the build directory:
14
 
    `click-buddy --dir . --no-clean`
15
 
 2. Commit the generated .pot file: `bzr commit -m"Updated translation template"`
16
 
 3. Push the branch and send a merge proposal as usual
17
 
 
18
 
And that's it, once the branch lands Launchpad should take care of all the rest!
19
 
 
20
 
# Behind the scenes
21
 
 
22
 
Behind the scenes, whenever the po/*.pot file (also known as translations template)
23
 
is committed to trunk Launchpad reads it and updates the translatable strings
24
 
exposed in the web UI. This will enable translators to work on the new strings.
25
 
The translations template contains all translatable strings that have been
26
 
extracted from the source code files.
27
 
 
28
 
Launchpad will then store translations in its database and will commit them daily
29
 
in the form of textual po/*.po files to trunk. The PO files are also usually
30
 
referred to as the translations files. You'll find a translation file for each
31
 
language the app has got at least a translated message available for.
32
 
 
33
 
Translations for core apps follow the standard [gettext format].
34
 
 
35
 
 [Launchpad Translations]: https://translations.launchpad.net/ubuntu-filemanager-app
36
 
 [gettext format]: https://www.gnu.org/software/gettext/