docs/README.i18n
changeset 64 dab0e9deeb67
parent 63 d76966db18e5
child 65 ce1c4d5e1576
equal deleted inserted replaced
63:d76966db18e5 64:dab0e9deeb67
     1 README.i18n
       
     2 
       
     3 
       
     4 Using a translation
       
     5 -----------------------------------------------------------------------
       
     6 
       
     7 All available translations can be found in the locale directory in the
       
     8 poweradmin base directory. The Dutch translation for example, can be
       
     9 found in locale/nl_NL. To review the status of the translation, you 
       
    10 can have a look at the nl.po file in the LC_MESSAGES directory.
       
    11 
       
    12 If you want to use a translation, say the nl_NL, all you have to do is 
       
    13 edit inc/i18n.php file and change the $language variable to the desired
       
    14 language, for example "nl_NL".
       
    15 
       
    16 If this doesn't work, please try to do the following:
       
    17 
       
    18  - cd /path/to/poweradmin/locale/$lang/LC_MESSAGES/
       
    19  - msgfmt $lang.po -o messages.mo 
       
    20 
       
    21 If that doesn't help either, most likely your system itself is not
       
    22 setup properly. See <https://rejo.zenger.nl/misc/1176630442.php> maybe
       
    23 of some help.
       
    24 
       
    25 
       
    26 Adding a new translation
       
    27 -----------------------------------------------------------------------
       
    28 
       
    29 If you want to create a new translation you can do the following. For
       
    30 example, if you want to create a Dutch translation:
       
    31  
       
    32  - cd /path/to/poweradmin/
       
    33  - mkdir -p locale/nl_NL/LC_MESSAGES/
       
    34  - cp docs/template.pot locale/nl_NL/LC_MESSAGES/nl.po
       
    35  - cd locale/nl_NL/LC_MESSAGES/
       
    36  - vim nl.po
       
    37  - msgfmt nl.po -o messages.mo
       
    38 
       
    39 
       
    40 Updating the translation template file
       
    41 -----------------------------------------------------------------------
       
    42 
       
    43 If creating a new translation and you are not sure if the template file
       
    44 that was provided in the distribution, you may want to re-create the 
       
    45 template file. To do so, do the following:
       
    46 
       
    47 
       
    48  - cd /path/to/poweradmin/
       
    49  - xgettext --no-wrap -o docs/template.pot *.php inc/*.php
       
    50 
       
    51 The last command updates the template file in docs/ directory.
       
    52 
       
    53