Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
[ikiwiki] / doc / todo / l10n.mdwn
1 ikiwiki should be fully internationalized.
2
3 ----
4
5 As to the hardcoded strings in ikiwiki, I've internationalized the program,
6 and there is a po/ikiwiki.pot in the source that can be translated.
7 --[[Joey]]
8
9 ----
10
11 > The now merged po plugin handles l10n of wiki pages. The only missing
12 > piece now is l10n of the templates.
13 > --[[Joey]]
14
15 ----
16
17 From [[Recai]]:
18 > Here is my initial work on ikiwiki l10n infrastructure (I'm sending it
19 > before finalizing, there may be errors).
20
21 I've revised the patches (tested OK):
22
23 - $config{lang} patch:
24
25     <http://people.debian.org/~roktas/patches/ikiwiki/ikiwiki-lang.diff>
26
27   + Support for CGI::FormBuilder.
28   + Modify Makefile.PL for l10n.
29
30 - l10n infrastructure from Koha project.  (This patch must be applied with
31   '-p1', also, it needs a 'chmod +x l10n/*.pl' after patching.)
32
33   + Leave templates dir untouched, use a temporary translations directory
34     instead.
35   + Fix Makefile (it failed to update templates).
36
37     <http://people.debian.org/~roktas/patches/ikiwiki/ikiwiki-l10n.diff>
38
39 However...
40
41 > fine.  Also a final note, I haven't examined the quality of generated
42 > templates yet.
43
44 Looks like, tmpl_process3 cannot preserve line breaks in template files.
45 For example, it processed the following template:
46
47     Someone[1], possibly you, requested that you be emailed the password for
48 user
49     <TMPL_VAR USER_NAME> on <TMPL_VAR WIKINAME>[2].
50
51     The password is: <TMPL_VAR USER_PASSWORD>
52
53     --
54     ikiwiki
55
56     [1] The user requesting the password was at IP address <TMPL_VAR
57 REMOTE_ADDR>
58     [2] Located at <TMPL_VAR WIKIURL>
59
60 as (in Turkish):
61
62 Birisi[1], ki muhtemelen bu sizsiniz, <TMPL_VAR WIKINAME>[2] üzerindeki
63 <TMPL_VAR USER_NAME> kullanıcısına ait parolanın epostalanması isteğinde
64 bulundu. Parola: <TMPL_VAR USER_PASSWORD> -- ikiwiki [1] Parolayı isteyen
65 kullanıcının ait IP adresi: <TMPL_VAR REMOTE_ADDR>[2] <TMPL_VAR WIKIURL>
66
67 > Looks like, tmpl_process3 cannot preserve line breaks in template files.
68 > For example, it processed the following template:
69
70 This could be easily worked around in tmpl_process3, but I wouldn't like to
71 maintain a separate utility.
72