This wiki is used to translate ikiwiki's basewiki, and demonstrate those translations. Ikiwiki is a wiki engine; its basewiki is the set of pages that are copied into every wiki it powers.

Most of the English pages on this wiki are locked. You cannot edit them. You can, however, edit the translated versions of those pages, and your edits to their PO files will be folded back into ikiwiki proper.

The SandBox is unlocked if you just want to play around with editing a translatable wiki.

Instructions for translators

If you want to translate ikiwiki's basewiki into your language, follow these steps:

1. Note that the license of the basewiki is as follows. Your translation will need to be licensed the same:

   Redistribution and use in source and compiled forms, with or without modification, are permitted under any circumstances. No warranty.

2. Is your language listed as one of the available translations above? If not, Joey needs to enable it. Edit this page and request it be enabled. Include the name of your language as it should be displayed, and the two letter language code. Saying something about the translation resources you have available will help. Is it just you, or will there be a whole team? Do you have just a little time to help, or do you want to commit to translating the whole thing?

3. Now get to translating! The easiest way to get started is to find a page on this wiki that is less than 100% translated to your language, go to the translated version of the page, and edit it. You'll be dumped into a web form, editing a PO file. Save and watch the percent translated numbers go up!

4. After a while you might get tired of the web form and want a real text editor, or even a specialized po file editor. No problem, this wiki can be edited using git as well:

   • Install git, and run this command to check out the wiki: git clone git://l10n.ikiwiki.info/
   • Edit the po files for your language, in the l10n.ikiwiki.info/po/underlays/ directory.
   • Run git commit -a to commit your changes.
   • Run git push to push your changes back to this wiki. It will automatically update!

5. If you get a useful percentage of the basewiki translated, let Joey know so he can activate your translation in the next ikiwiki release.

6. Keep an eye on needstranslation to keep your translation up-to-date.

Requests for translation

• Czech: Hi Joey, could you please enable Czech (cs) language?

  • It seems I'm the only translator for this language
  • I have the translation of basewiki already ready, so after the activation I will just commit it and fix any issues I will notice in the live environment.
  • I have just enough of time to keep basewiki updated (expecting it not to change too much)
  • I might have a look at the other pages in the future, but nothing promised

Done, thanks! Please let me know when it's checked. Hope I got the name right BTW. --Joey

Update: Czech basewiki was included in ikiwiki 3.1415926. --Joey

• Svenska: Hi Joey, could you please enable Swedish (sv)? //Martin Bagge brother@bsnet.se
  • I will most probably be the only one doing the translation but I'll mention it to the others in debian-l10n-swedish and see if anyone is up to it.
  • I have done a clone for the wiki and will do most changes there.
  • For time I am not to stressed for the time being.

Done, thanks! Please let me know when you have a translation of the basewiki. --Joey

Translation hints

• This page does not need to be translated.
• Don't translate page names inside WikiLinks, such as [[FooPage]]
• Do translate link descriptions inside WikiLinks, such as [[Page about foo|FooPage]]
• Some directives don't contain translatable bits; some do. Compare [[!inline pages="blog/*"]] with [[!inline pages="blog/*" description="this is my blog"]]

Translation problems

redirection

Some pages use redirection (cut, copy, paste, taglink, ...) which translates to

URL=../../../../ikiwiki/directive/cutpaste/

on the English page, but to

URL=../../../../ikiwiki/directive/cutpaste.cs/

on the Czech page returning an error about nonexistent page

Hmm, I don't see the problem when I go to http://l10n.ikiwiki.info/ikiwiki/directive/cut/index.da.html I am redirected to the English cutpaste page, no 404. --Joey

If you try French or Czech you might get the error. (And the localized version will be usually prefered by the browser automatically.)

Aha, the redirect does not lead to http://l10n.ikiwiki.info/directives/ikiwiki/directive/cutpaste/ but to http://l10n.ikiwiki.info/ikiwiki/directive/cutpaste/

Ah, ok. Then this should only be a problem on this wiki. The pages redirect to '/ikiwiki/directive/cutpaste', and that version of the page is the one shipped in an ikiwiki release (not the one this site lets you translate), and so is not translated to French/Czech yet. So I think this will clear itself up once I add those translations to ikiwiki mainline and upgrade to that version. --Joey

List of pages

See needstranslation for lists of pages that are not fully translated into each language.

Here is a list of all the translatable pages in the basewiki:

If you manage to translate all of the above, here are some additional translatable pages: