X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/057ac645cba94430cf56749b44ad42eb7b0e79a6..9b20e0a24ef0bba1a04eb5d29a5a855f242cd933:/doc/plugins/contrib/linguas.mdwn diff --git a/doc/plugins/contrib/linguas.mdwn b/doc/plugins/contrib/linguas.mdwn index 7778bf461..bf502606e 100644 --- a/doc/plugins/contrib/linguas.mdwn +++ b/doc/plugins/contrib/linguas.mdwn @@ -1,13 +1,18 @@ -[[template id=plugin name=linguas author="Jordà Polo"]] -[[meta title="linguas (third-party plugin)"]] +[[!template id=plugin name=linguas author="Jordà Polo"]] Linguas ======= -Linguas is a plugin for [ikiwiki](http://ikiwiki.kitenet.net/) that +Linguas is a plugin for [ikiwiki](http://ikiwiki.info/) that allows translations of wiki pages. -Download: [linguas.pm](http://wiki.ettin.org/files/linguas.pm) (2006-08-21). +Download: [linguas.pm](http://ettin.org/pub/ikiwiki/linguas.pm) (2006-08-21). + +Note that even though it is still available for download, this plugin is no +longer actively maintained. If you are interested in multilingual wiki pages, you +can also take a look at other approaches such as [[todo/l10n]], [[plugins/contrib/po]], +or Lars Wirzenius's +[Static website, with translations, using IkiWiki](http://liw.iki.fi/liw/log/2007-05.html#20070528b). Usage ----- @@ -16,14 +21,14 @@ Translatable pages and translations must have the following format: `pagename.$LANG`, where `$LANG` is a ISO639-1 (two-letter) language code. To enable linguas, add the following line in the source code of the page: - \[[linguas ]] + \[[!linguas ]] Note that linguas is only required in one of the pages (the original, for instance); the rest of translations will be automatically updated. Additionally, it is also possible to specify the title of the translation: - \[[linguas title="Translated title"]] + \[[!linguas title="Translated title"]] Template @@ -57,7 +62,7 @@ fine, but it fails from ikiwiki.setup.) > but not hashes or more complex data structures. --[[Joey]] > > Right. With this simple - > > [patch](http://wiki.ettin.org/files/hash_setup.patch) it seems to + > > [patch](http://ettin.org/pub/ikiwiki/hash_setup.patch) it seems to > > work. However, note that 1) it only allows simple hashes, hashes of > > hashes will not work (I don't think getops can handle complex hashes > > anyway); 2) I don't really know when/why you call @@ -86,13 +91,17 @@ it... any hints?) > > I'll take a look when I have the time. Thanks for your comments. > > --Jordà -Examples --------- - -* [Linguas](http://wiki.ettin.org/linguas.en.html). A page with the same -content than this one. - -* [Hello in some languages](http://wiki.ettin.org/hello/hello.en.html). The -translations were taken from [Hello in many -languages](http://www.omniglot.com/language/phrases/hello.htm) and from -the [Debian](http://www.debian.org/) website. +* The changes to htmllink in ikiwiki 1.44 broke this plugin. +The following fixes it: + + --- linguas.pm.orig 2006-08-23 19:07:04.000000000 +0200 + +++ linguas.pm 2007-03-24 01:53:18.000000000 +0100 + @@ -100,7 +100,7 @@ + if (exists $linguas{$2} && defined $linguas{$2}) { + $link = $linguas{$2}{'name'}; + } + - push @links, IkiWiki::htmllink($page, $destpage, $trans, 0, 0, $link); + + push @links, IkiWiki::htmllink($page, $destpage, $trans, noimageinline => 0, forcesubpage => 0, linktext => $link); + } + + my $otherlinguas = 'Translations:';