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
97
98
99
100
101
102
103
104
105
|
TRANSLATING VIM MESSAGES
This file explains how to create and maintain po files using
gnu-gettext.win32, a MINGW32 Windows port of gettext by Franco Bez
<franco.bez@gmx.de>. You can find it at:
http://home.a-city.de/franco.bez/gettext/gettext_win32_en.html
First read the README.txt file for the general remarks
The file that does the work is Make_ming.mak in the po directory. It is an
adaptation of the Unix Makefile, but it does NOT test the presence of any po,
pot, or mo files, so use it at your own risk but with care: it could even kill
your canary. It has been tested by me several times (and with different
languages) with success.
The make utility must be run from the po directory.
First of all you must set the environment variable LANGUAGE to xx, where xx is
the name of your language. You can do it from the command line or adding a
line to your autoexec.bat file: set LANGUAGE=xx. You must also add your
language to the Make_ming.mak file in the lines LANGUAGES, MOFILES, AND
POFILES.
If you don't have a xx.po file, you must create it with the command:
make -f Make_ming.mak first_time
This will produce a new brand xx.po file with all the messages in Vim ready
for translation. Then you must source the cleanup.vim script from inside Vim;
it will comment the untranslated messages (now, all). I recommend to use
syntax highlighting so you can identify the untranslated messages easily.
You also must remove the '..\' that prepends the name of the source files.
(I don't no why, but make is unable to change the directory from po to src and
back to po, so all the work must be done from the po dir, hence the '..\')
Then you must go step (2) below.
If you are updating a po file you must follow the next steps (they are nearly
the same as in the Unix case, only the commands change):
(1) Add new and changed messages from the Vim sources:
make -f Make_ming.mak xx
This will extract all the strings from Vim and merge them in with the
existing translations. Requires the GNU gettext utilities. Also requires
unpacking the extra archive.
Your original xx.po file will be copied to xx.po.orig
-- After you do this, you MUST do the next three steps! --
(2) Translate
See the gettext documentation on how to do this. You can also find
examples in the other po files.
Search the po file for items that require translation:
/\#\~ and also the fuzzy translations, /\#, fuzzy
Remove "#~" and "#, fuzzy" after adding the translation.
There is one special message:
msgid "Messages maintainer: The Vim Project"
You should include your name and E-mail address instead, for example:
msgstr "Berichten �bersetzt bei: John Doe <john@doe.org>"
(3) Clean up
This is very important to make sure the translation works on all systems.
Comment-out all non-translated strings. There are two types:
- items marked with "#, fuzzy"
- items with an empty msgstr
You can do this with the cleanup.vim script:
:source cleanup.vim
(4) Check:
vim -S check.vim xx.po
make -f Make_ming.mak xx.mo
Look out for syntax errors and fix them.
(5) This is an extra step, ;-). If you want the vim.mo file installed in your
system you must run:
make -f Make_ming.mak install
This will create the xx\LC_MESSAGES directory (if it does not exist) and
will copy vim.po to it.
You can also use the following command to install all languages:
make -f Make_ming.mak install-all
(6) Another extra step ;-)). The command:
make -f Make_ming.mak clean
will delete the temp files created during the process.
Suggestions will be welcomed.
Eduardo F. Amatria <eferna1@platea.pntic.mec.es>
Happy Vimming with NLS!!
vim:tw=78:
|