wiki:TranslatedPagesMacro

Version 14 (modified by stoecker, 3 years ago) (diff)

--

Show translated versions of wiki page

Description

A macro to output a list of translated versions of in current page. The English page should use the wiki name without language code, and translated wiki pages use OriginalWiki/language_code format (language_code follows ISO 639.2 Alpha-2 format). The [[TranslatedPages]] macro generates a list of languages like

to direct to translated versions of wiki pages.

Bugs/Feature Requests

Existing bugs and feature requests for TranslatedPagesMacro are here.

If you have any issues, create a new ticket.

Get the Plugin

See the Trac plugin requirements for instructions on installing setuptools. Setuptools includes the easy_install application which you can use to install the TranslatedPagesMacro:

easy_install TranslatedPagesMacro

You can also obtain the code from the Trac Subversion repository:

svn co http://trac-hacks.org/svn/translatedpagesmacro

or download zipped source.

See TracPlugins for instructions on building and installing plugins.

You can browse the source in Trac.

This is a link for setuptools to find the SVN download

Upgrading from older version 0.3

The macro enhanced a lot since version 0.3. A major change is the layout of the pages. Version 0.3 hardcoded the format page/<lang>. The new version has <lang>:page as default which is used more ofthen for wikis.

For existing installations using the old schema following settings must be used:

[translatedpages]
template = {page}/{lang}
regexp = ([a-z]{2})

also the layout of the language specification page changed (more entries required tables style design).

Example

An example of the required language specification page can be found at TranslatedPagesMacro/TracLanguages (note that this wiki installation does not yet display the table heads correctly).

For example, the page WikiStart was translated to Chinese version Zh_CN:WikiStart, Russian version Ru:WikiStart and Spanish version Es:WikiStart. Insert [[TranslatedPages]] to WikiStart will generate the following list:

And in Zh_CN:WikiStart will generate:

An example of an actively used installation can be found at http://josm.openstreetmap.de/wiki/Translations.

Known Issues

#11575
Display english page prominently in missing page overview

Recent Changes

[13545] by stoecker on 2014-01-04 22:51:24
minor fix in illegal argument detection
[11919] by stoecker on 2012-08-10 22:11:21
TranslatedPagesMacro: add label argument
[11708] by stoecker on 2012-07-04 08:42:28
TranslatedPages: fix links with spaces in name

Author/Contributors

Author: ftofficer
Maintainer: ftofficer
Contributors: dottedmag, stoecker

Attachments (5)

Download all attachments as: .zip