X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/df9801a3715a4d79bf7659b1a8f44ed818e16755..aeefbbff3b7f3e9057db67fd928976baf894952a:/doc/translation.mdwn?ds=sidebyside diff --git a/doc/translation.mdwn b/doc/translation.mdwn index 81a3092b4..71e50cb1b 100644 --- a/doc/translation.mdwn +++ b/doc/translation.mdwn @@ -1,9 +1,9 @@ If you want to translate your wiki into another language, there are -essentailly three peices needed for a complete translation: +essentially three pieces needed for a complete translation: 1. The messages in the ikiwiki program itself need to be translated. Ikiwiki is internationalised, and most such messages are already marked - with `gettext()`. THe source tarball includes a creates a `po/ikiwiki.pot` + with `gettext()`. The source tarball includes a `po/ikiwiki.pot` that can be copied and translated as a po file. All very standard. Note that a few things in the source are not currently translated. These @@ -30,3 +30,15 @@ essentailly three peices needed for a complete translation: 1. The [[basewiki]] itself needs to be translated. The [[plugins/contrib/po]] ikiwiki plugin will allow translating wikis using po files and can be used for this. + + To generate the po and pot files for translating the basewiki, + get ikiwiki's source, and edit the `basewikipo.setup` file, + adding your language. Then run 'perl Makefile.PL; make basewikipo`. + This will generate many po files under `po/underlays`. The first + ones you'll want to translate are in the `po/underlays/basewiki` directory, + which is really not very large, just a few thousand words. + After that is done, you can tackle those under + `po/underlays/directives`, which are a much larger tens of + thousands of words. + +