Documentation

In the quick installation, you use the [[include :multilingual:template]] module for each multilingual category. This module is merely an automatic template that is made of of three specialised modules:

  • Display Content Module
  • Translated Pages Module
  • Translate Language Module

You can actually customise your Multilingual Support settings per category by dropping the [[include :multilingual:template]] module and using the specialised modules managed. This is done by modifying the Live Template of each of your multilingual categories.

Display Content Module

[[include :multilingual:display]]

This is the most important module, as it is what displays your page in other languages.

Attribute Description Allowed Values Default
|import= This is where you specify what part of the page you want to display in that section. This is mainly for advanced users Any String %%content%%
|default= Specifies the default language of the category. It's value must be the same across all other modules on the same page. Any ISO 639-1 language en
|edit_text= Specifies the “Edit Translation” text Any String Edit Translation
|edit_location= Specifies whether the “Edit Translation” text appears above or below the page content above, below above

Translated Pages Module

[[include :multilingual:translated]]

This module displays the languages of which the page has already being translated into. Just click on a language to display the page in that language.

Attribute Description Allowed Values Default
|default= Specifies the default language of the category. It's value must be the same across all other modules on the same page. Any ISO 639-1 language en
|translated_text= Specifies the text showing available translations Any String This page is available in the following languages:

Translate Language Module

[[include :multilingual:languages]]

This module allows you to translate the page into other languages of your choice. It does not display languages that have already been translated.

Attribute Description Allowed Values Default
|default= Specifies the default language of the category. It's value must be the same across all other modules on the same page. Any ISO 639-1 language en
|show#= Specifies which languages are allowed to be translated into. Any ISO 639-1 language none

To show a language for translation, you need to specify the |show#= attribute. For example, if I want to support Japanese (whose ISO code is ja), I need type this code:

[[include :multilingual:languages
|show1=ja
]]

If I want to support Italian and Arabic as well, then I need to enter the next number up in the |show#= attributes. For example:
[[include :multilingual:languages
|show1=ja
|show2=it
|show3=ar
]]

There is currently support for up to 101 languages (though this can be increased).

Limitations

The Multilingual Framework is incompatible with Wikidot Data Form categories.

Additionally, because the content of your Multilingual Pages are contained within a ListPages module, you cannot use the ListPages module in translated pages.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License