X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/ef003f48f4a3fe8fb67fda62c70a299b07d75976..208a77a977615b3e285d08b33345daca7072432e:/doc/translation.mdwn diff --git a/doc/translation.mdwn b/doc/translation.mdwn index e3e458ce7..9d874d98e 100644 --- a/doc/translation.mdwn +++ b/doc/translation.mdwn @@ -22,11 +22,25 @@ essentially three pieces needed for a complete translation: * The names and values of parameters, both to the program, in the setup file, and in preprocessor directives. +1. The [[basewiki]] needs to be translated. The + [[plugins/po]] ikiwiki plugin will allow translating + wikis using po files and can be used for this. + + There is now a website, [l10n.ikiwiki.info](http://l10n.ikiwiki.info) + that both demos the translated basewiki, and allows easy translation of + it. + + To generate the po and pot files for translating the basewiki, + get ikiwiki's source, edit the `po/underlay.setup` file, + adding your language. Then run 'make -C po underlays`. + 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). + 1. The templates also need to be translated. Some work has been done on an infrastructure for maintaining translated templates, as documented in [[todo/l10n]], but until that's complete, you'd need to copy and translate the templates by hand. - -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.