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

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)


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

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