docs/README.i18n
author rejo
Tue, 17 Apr 2007 19:43:24 +0000
changeset 4 55ed92aa7cf5
parent 3 64525a2eb098
child 6 9fcac40c1b0e
permissions -rw-r--r--
[feladat @ 5] - Second half of translation framework. - Several small typo's in code fixed. - Removed comments on a todo in leveldescription(), already done. - Replaced dal.inc.php with DB.php from package DB-1.7.6 from pear.php.net to fix problems using poweradmin 1.2.7-patched with php5/pear. The DB package has already been superseded by MDB2, but that version is incompatible with current code.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     1
README.i18n
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     2
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     3
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     4
Using a translation
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     5
-----------------------------------------------------------------------
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     6
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     7
All available translations can be found in the locale directory in the
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     8
poweradmin base directory. The Dutch translation for example, can be
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
     9
found in nl_NL. To review the status of the translation, you can have a
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    10
look at the nl.po file in the LC_MESSAGE directory.
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    11
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    12
If you want to use a translation, say the nl_NL, all you have to do is 
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    13
edit inc/i18n.php file and change the $language variable to the desired
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    14
language, for example "nl_NL".
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    15
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    16
If this doesn't work, your system isn't setup properly.
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    17
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    18
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    19
Adding a new translation
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    20
-----------------------------------------------------------------------
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    21
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    22
If you want to create a new translation you can do the following. For
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    23
example, if you want to create a Dutch translation:
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    24
 
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    25
 - cd /path/to/poweradmin/
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    26
 - mkdir -p locale/nl_NL/LC_MESSAGES/
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    27
 - cp docs/template.pot locale/nl_NL/LC_MESSAGES/nl.po
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    28
 - cd locale/nl_NL/LC_MESSAGES/
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    29
 - vim nl.po
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    30
 - msgfmt nl.po -o message.mo
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    31
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    32
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    33
Updating the translation template file
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    34
-----------------------------------------------------------------------
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    35
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    36
If creating a new translation and you are not sure if the template file
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    37
that was provided in the distribution, you may want to re-create the 
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    38
template file. To do so, do the following:
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    39
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    40
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    41
 - cd /path/to/poweradmin/
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    42
 - xgettext --no-wrap -o docs/template.pot *.php inc/*.php
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    43
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    44
The last command updates the template file in docs/ directory.
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    45
64525a2eb098 [feladat @ 4]
rejo
parents:
diff changeset
    46