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:
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.
Is your language listed as one of the available translations above? If not, Joey needs to enable it. Edit the discussion 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?
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!
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!
- Install git, and run this command to check out
the wiki:
If you get a useful percentage of the basewiki translated, let Joey know so he can activate your translation in the next ikiwiki release.
Keep an eye on needstranslation to keep your translation up-to-date.
Instructions for Joey
This branch of ikiwiki is diverged from ikiwiki master, and should never
be directly merged into master. Remember to merge master into it from time
to time. After merging in master, the translatable underlays can be updated
by running cd po && make underlays
. Then check in any new po and pot
files to the l10n branch.
(Similarly, that should never be run on the master branch.)
When receiving a translation via this site, the po files have to be copied over to master by hand. This way, only translations that are in a consistent/complete state can land in master.
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:
-
?directives
-
?ikiwiki
-
?directive
- aggregate
- aggregate.pot
- brokenlinks
- brokenlinks.pot
- calendar
- calendar.pot
- color
- color.pot
- comment
- comment.pot
- commentmoderation.cs
- commentmoderation.da
- commentmoderation.de
- commentmoderation.es
- commentmoderation.fr
- copy
- copy.pot
- cut
- cut.pot
- cutpaste
- cutpaste.pot
- date.cs
- date.da
- date.de
- date.es
- date.fr
- edittemplate
- edittemplate.pot
- flattr.cs
- flattr.da
- flattr.de
- flattr.es
- flattr.fr
- format
- format.pot
- fortune
- fortune.pot
- graph
- graph.pot
- haiku
- haiku.pot
- if
- if.pot
- img
- img.pot
- inline
- inline.pot
- linkmap
- linkmap.pot
- listdirectives
- listdirectives.pot
- map
- map.pot
- meta
- meta.pot
- more
- more.pot
- orphans
- orphans.pot
- osm.cs
- osm.da
- osm.de
- osm.es
- osm.fr
- pagecount
- pagecount.pot
- pagestats
- pagestats.pot
- pagetemplate
- pagetemplate.pot
- paste
- paste.pot
- ping
- ping.pot
- poll
- poll.pot
- polygen
- polygen.pot
- postsparkline
- postsparkline.pot
- progress
- progress.pot
- shortcut
- shortcut.pot
- sidebar.cs
- sidebar.da
- sidebar.de
- sidebar.es
- sidebar.fr
- sparkline
- sparkline.pot
- table
- table.pot
- tag
- tag.pot
- taglink
- taglink.pot
- template
- template.pot
- testpagespec
- testpagespec.pot
- teximg
- teximg.pot
- toc
- toc.pot
- toggle
- toggle.pot
- toggleable
- toggleable.pot
- trailitem.cs
- trailitem.da
- trailitem.de
- trailitem.es
- trailitem.fr
- trailitems.cs
- trailitems.da
- trailitems.de
- trailitems.es
- trailitems.fr
- traillink.cs
- traillink.da
- traillink.de
- traillink.es
- traillink.fr
- trailoptions.cs
- trailoptions.da
- trailoptions.de
- trailoptions.es
- trailoptions.fr
- version
- version.pot
- waypoint.cs
- waypoint.da
- waypoint.de
- waypoint.es
- waypoint.fr
-
?directive
-
?ikiwiki
- ?smiley