summaryrefslogtreecommitdiff
path: root/Master/tlpkg/etc/howto-translations.txt
blob: e66356ea054037482148d09fe34f3457145ef04d (plain)
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

Dealing with translations of TeX Live programs
==============================================


For translators
---------------

using poedit (poedit.sf.net):

Starting new translation NN.po:
- start fresh poedit
- click on "File -> New catalog from POT file"
- select messages.pot (in tlpkg/translations/messages.pot)
- A dialog opens that asks for some fields, like
        Project name and version:
        Team:
        Team's email address:
        Language:
        Country:
        Charset: UTF-8
        Source code charset:
        Plural Forms:
  etc all of which is unknown to me, but I filled in at least the Language
  and the email of myself of tex-live@tug.org
- click "Ok"
- select where to save (either in tlpkg/translations/NN.po or somewhere else
  and send us the file)
- start translating

Editing an existing NN.po:
- start poedit
- open NN.po
- start translating


Translating and remarks:
- click on the bold strings, those are missing the translation
- please use \" instead of ", as can be seen in the original strings
- several lines in the translations are merged together *without* adding
  anything. So if you want new lines please use \n in the text
  (as seen in several original strings)


We do update the messages.pot daily (nightly) and merge the strings into 
all the .po files (using msgmerge). That means if we change one of the
english strings the translation will normally be marked as "fuzzy" in the
.po file.

In poedit those fuzzy translations are shown in red, telling you that those
have had a change in the original string and the translation should be
checked.

So before any of you start out with editing a translation, please fetch the
latest messages.pot and NN.po

-----------------------------------------

For developers
--------------

Extraction of the messages == update of the po template messages.pot:
(should probably be done daily?)

  cd ..../Master
  xgettext -o tlpkg/translations/messages.pot  -L Perl   \
           -k__ -k\$__ -k%__ -k__x -k__n:1,2 -k__nx:1,2 -k__xn:1,2 -kN__ -k  \
	   tlpkg/installer/install-menu-perltk.pl \
	   tlpkg/installer/install-menu-wizard.pl \
	   texmf/scripts/texlive/tlmgrgui/*.pl


Merging/updating of the .po files
(should update de.po, and merge new file locations)

  cd Master/tlpkg/translations
  msgmerge --update de.po messages.pot