Merge remote branch 'smcv/ready/transient-autoindex'

[git.ikiwiki.info.git] / doc / translation.mdwn

diff --git a/doc/translation.mdwn b/doc/translation.mdwn
index 81a3092b47b4574cfeb93231a911c7084c09b764..9d874d98e8b537a1cbeac21d7e4d95938a961189 100644 (file)
--- a/doc/translation.mdwn
+++ b/doc/translation.mdwn
@@ -1,9 +1,9 @@
 If you want to translate your wiki into another language, there are
 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
 
 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
    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


@@ -22,11 +22,25 @@ essentailly three peices needed for a complete translation:
    * The names and values of parameters, both to the program, in the setup
      file, and in preprocessor directives.
 
    * 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 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.