[[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 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 [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]'' == 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/}}}. The new version has {{{: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 [wiki: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: [[Image(translated_pages_sample_english.png)]] And in Zh_TW:WikiStart will generate: [[Image(translated_pages_sample_chinese.png)]] An example of an actively used installation can be found at [http://josm.openstreetmap.de/wiki/Translations]. == 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]