translate.mdwn 5.65 KB
Newer Older
1
[[!meta title="Improve Tails in your own language"]]
2
3
4

<div id="intro">

5
6
<p>So you want to make it easier to use Tails in your own language.
Welcome aboard! Please read-on.</p>
7
8
9
10
11
12
13
14
15
16
17

[[!toc levels=3]]

</div>

# Things to translate

## Custom programs

Tails ships with several custom programs that need to be translated.

18
19
20
21
22
23
24
25
26
One can find the (gettext) PO files:

* in [[!tails_devel_gitweb_dir config/chroot_local-includes/usr/share/locale]]
* [liveusb-creator
  gitweb](http://git.immerda.ch/?p=tails/liveusb-creator.git;a=tree;f=po;hb=HEAD)
* [tails-greeter
  gitweb](http://git.immerda.ch/?p=tails/tails-greeter.git;a=tree;f=po;hb=HEAD)
* [tails-persistence-setup
  gitweb](http://git.immerda.ch/?p=tails/persistence-setup.git;a=tree;f=po;hb=HEAD)
27
28
29

## Website and documentation

30
31
32
The [[end-user documentation|doc]] is being reorganized and rewritten. You can
have a look at the [[todo/documentation_translation]] page to know which pages
are ready to be translated.
33

34
## Other text to be translated
35
36
37

See the *Translate* section of the [[/TODO]] list.

38
39
# For English native speakers

127.0.0.1's avatar
127.0.0.1 committed
40
Most of Tails' developers are not native English speakers so you're also more than
41
42
welcome to edit, rephrase, correct or improve our English. Since you won't be
able to use translation tools for that but rather edit the original code or wiki
127.0.0.1's avatar
127.0.0.1 committed
43
pages your best option will be using Git to submit patches.
44

45
46
47
48
# Translation tools

## Web interface

49
50
One can translate pages on this website using the web interface: there
is an *Improve translation* button on the top right of every page that
Tails developers's avatar
Tails developers committed
51
is a translation. It is nice for quick tasks such as un-fuzzying
52
53
54
a recently changed string or fixing a typo; on the other hand, most
translators find it painful and error-prone for more serious
translation work.
55
56
57
58

Moreover, parts of Tails (most notably our custom programs) cannot be
translated using the web interface. We therefore recommend anyone
willing to seriously get involved into Tails translation work to use
59
more appropriate tools, such as a real PO file editor; see below for
60
61
details.

62
63
64
## Locked pages

Some pages on this website are 'locked' and cannot be edited through the web
127.0.0.1's avatar
127.0.0.1 committed
65
interface. Those are pages we considered too sensitive for open editing: the
66
Download page, the page about our GnuPG key, etc. For those pages you will need
127.0.0.1's avatar
127.0.0.1 committed
67
to use Git to send us your work.
68

69
70
71
72
73
## PO editor

The [Poedit](http://poedit.sourceforge.net/) editor is installed in
Tails.

127.0.0.1's avatar
127.0.0.1 committed
74
Many different workflows can be used to translate Tails strings
75
76
using a PO editor. Let's describe a few recommended ones, from the
smallest to the biggest initial setup time... the last ones actually
127.0.0.1's avatar
127.0.0.1 committed
77
being the most comfortable to work with in the long run.
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

### Piggy-back the web interface

1. In the web interface, click the *Improve translation* button on the
   page you wish to translate.
2. In the text edition web page, copy the whole text.
3. Paste it into a new, empty raw text document.
4. Save this text document as a file whose name ends with the `.po`
   extension.
5. Open the `.po` file in your preferred PO file editor.
6. Translate whatever you can.
7. Paste back the whole resulting text into your web browser.
8. Preview your changes.
9. Click *Save* when satisfied with the results.

### Using Git

You can either send us Git patches or ask us to pull from your Git
branch.

Note that the website shall be translated in the `master` branch,
while custom Tails programs live in the `devel` branch.

#### Send us Git patches

Tails developers's avatar
Tails developers committed
103
1. Clone Tails [[Git repository|contribute/git]] onto your local system.
104
105
2. Translate whatever you can in your preferred PO file editor. 
3. Commit the changes you made to `.po` files.
106
107
108
109
110
   You could encounter numerous false positive when committing modified .po 
   files. It's due to the fact that Poedit [doesn't handle the wordwrapping 
   correctly](http://www.poedit.net/trac/ticket/25). In order to avoid this, 
   you should run the following command :
     `msgcat --width=80 -o your_output_file.po your_input_file.po`
111
4. Use the `git format-patch` command to prepare patches.
112
5. [[Send us|contribute/talk]] your patches.
113
114
115
116
6. Frequently merge changes from our main repository into yours.

#### Ask us to pull from your Git branch

Tails developers's avatar
Tails developers committed
117
1. Setup your personal [[Git repository|contribute/git]]: if you already know
Tails developers's avatar
Tails developers committed
118
119
   where to host it in a public place, this is great; or else [fork us
   on repo.or.cz](http://repo.or.cz/w/tails.git).
120
121
2. Translate whatever you can in your preferred PO file editor. 
3. Commit the changes you made to `.po` files.
122
123
124
125
126
   You could encounter numerous false positive when committing modified .po 
   files. It's due to the fact that Poedit [doesn't handle the wordwrapping 
   correctly](http://www.poedit.net/trac/ticket/25). In order to avoid this, 
   you should run the following command :
     `msgcat --width=80 -o your_output_file.po your_input_file.po`
127
4. Push your changes to your online Git repository.
128
5. [[Ask us|contribute/talk]] to pull from the branch you worked on.
129
130
131
132
6. Frequently merge changes from our main repository into yours.

# Supported languages

133
134
135
Currently, only a few languages are somewhat supported in Tails,
namely:  Arabic, Chinese, English, French, Italian, German,
Portuguese and Spanish (Castellano).
136
137
138
139
140
141
142
143
144
145

Support for only a subset of these languages is enabled on this
website.

Adding support for your preferred language is possible, but beware:

* our website text evolves relatively quickly;
* useful translations are no one-shot job and need to be maintained on
  the long run, which may take roughly two hours a month.

127.0.0.1's avatar
127.0.0.1 committed
146
In conclusion, forming a team of translators dedicated to your
147
148
149
150
151
language's support in Tails might be useful to make the maintenance
work happier and more sustainable.

# Talk to us

152
[[!inline pages="contribute/talk" raw="yes"]]