wiki:TranslatedPagesMacro

Version 13 (modified by Dirk Stöcker, 13 years ago) (diff)

typo

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 [download:translatedpagesmacro 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

No results

Recent Changes

18588 by stoecker on 2023-11-08 17:40:31
TranslatedPagesMacro: handle totally empty pages
18584 by stoecker on 2023-11-04 20:10:14
automated 2to3 conversion
17677 by stoecker on 2020-02-14 07:19:42
fix default for empty code spec
(more)

Author/Contributors

Author: ftofficer
Maintainer: ftofficer
Contributors: dottedmag

Attachments (5)

Download all attachments as: .zip