[[PageOutline(2-5,Contents,pullout)]]
= 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 

[[Image(translated_pages_sample_english.png)]]

to direct to translated versions of wiki pages.

== Bugs/Feature Requests == 

Existing bugs and feature requests for TranslatedPagesMacro are 
[report:9?COMPONENT=TranslatedPagesMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TranslatedPagesMacro&owner=ftofficer new ticket].

== Get the Plugin ==

See the [wiki:TracPlugins#Requirements Trac plugin requirements] for instructions on installing `setuptools`.  `Setuptools` includes the `easy_install` application which you can use to install the SpamFilter:
{{{
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 [source:translatedpagesmacro browse the source in Trac].

''[http://trac-hacks.org/svn/translatedpagesmacro/0.11/#egg=TranslatedPages-dev This is a link for setuptools to find the SVN download]''

== Example ==

For example, the page WikiStart was translated to Chinese version WikiStart/zh, Russian version WikiStart/ru and Spanish version WikiStart/es. Insert `[[TranslatedPages]]` to WikiStart will generate the following list:

[[Image(translated_pages_sample_english.png)]]

And in WikiStart/zh will generate:

[[Image(translated_pages_sample_chinese.png)]]

== Known Issues ==

[[TicketQuery(component=TranslatedPagesMacro,status=!closed)]]

== Recent Changes ==

[[ChangeLog(translatedpagesmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:ftofficer] [[BR]]
'''Maintainer:''' [wiki:ftofficer] [[BR]]
'''Contributors:''' [wiki:dottedmag]