Wiki source code of Internationalization

Version 20.12 by Silvia Macovei on 2010/02/24

Hide last authors
Silvia Macovei 20.12 1 {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}}
Silvia Macovei 20.1 2
Silvia Macovei 19.4 3 XWiki can be set-up to support one or various languages. As of August 2009 XWiki Enterprise supports 21 languages:
Silvia Macovei 20.9 4
Vincent Massol 19.1 5 * Chinese (zh)
6 * Croatian (hr)
7 * Czech (cs)
8 * Dutch (nl)
9 * English (en)
10 * French (fr)
11 * Galician (gl)
12 * German (de)
13 * Hindi (hi)
14 * Italian (it)
15 * Korean (ko)
16 * Latvian (lv)
17 * Norwegian (nb)
18 * Polish (pl)
19 * Portuguese (pt)
20 * Romanian (ro)
21 * Russian (ru)
22 * Slovak (sk)
23 * Spanish (es)
24 * Swedish (sv)
25 * Ukrainian (uk)
Silvia Macovei 20.2 26
Silvia Macovei 20.1 27 To see the exact status for each language or if you wish to help, check our [[translation wiki>>http://l10n.xwiki.org/]] (for example you can see the [[status of translations for XWiki Enteprise>>http://l10n.xwiki.org/xwiki/bin/view/XE/XWikiCoreResources]]).
Guillaume Lerouge 1.1 28
Silvia Macovei 20.12 29 = Preferences =
Vincent Massol 18.1 30
31 Setting up languages is done in the Administration (link on the top right of every page).
Silvia Macovei 20.2 32
Silvia Macovei 20.1 33 {{info}}To make use of this feature for Languages with encodings that are not ISO-8859-1, you will need to adjust the encoding for your XWiki setup as documented in the [[Encodings page of the Administrators Guide>>platform:AdminGuide.Encoding]]{{/info}}
Silvia Macovei 20.2 34
Silvia Macovei 20.8 35 image:AdminLanguages.PNG
Vincent Massol 8.1 36
Silvia Macovei 20.12 37 = Switch to another language =
Vincent Massol 18.1 38
Silvia Macovei 20.4 39 By default the language displayed will be the one coming from the browser. However, on every page you can choose to switch between the different language translations that exist for the page. To do so click on the language name in the top right corner of the screen as shown in the following screenshots. Note that you can also force a language by suffixing a URL with ##language=<2-letter language code>##. In addition you can [[configure your wiki to always use a specific language or force a single language to be used>>AdminGuide.Configuration#HLanguagesettings]].
Guillaume Lerouge 1.1 40
Silvia Macovei 20.8 41 image:LanguageEN.PNG <-//English// //Deutsch//-> image:LanguageDE.PNG
Guillaume Lerouge 1.1 42
Silvia Macovei 20.11 43 //For the [[Mandriva Club>>http://club.mandriva.com]] website, XWiki supports 25 languages:
Vincent Massol 8.1 44
Silvia Macovei 20.1 45 image:Languages_MandrivaClub.JPG
Guillaume Lerouge 1.1 46
Silvia Macovei 20.1 47 {{info}}Once you click on a language, you're forcing it and thus all pages which have translations in that language will display these translations by default when you navigate to them.{{/info}}
Vincent Massol 8.1 48
Silvia Macovei 20.12 49 = Edit a translation =
Silvia Macovei 20.9 50
Silvia Macovei 20.8 51 When you go to the edition mode you are able to edit the page in the default language. The default language is indicated on the right "Document Information" panel as shown below:
Guillaume Lerouge 1.1 52
Silvia Macovei 20.8 53 image:DefaultLanguageEN.PNG
Vincent Massol 8.1 54
Silvia Macovei 20.8 55 In the "Document Translations" panel you can see the current language you are performing translations in and the alternative languages you may translate your page to. These are the languages you have previously set up in "Administration".
Guillaume Lerouge 1.1 56
Silvia Macovei 20.8 57 image:DocumentTranslations.PNG
58
59 In order to translate your document in a different language, click on one of the languages (e.g. Fr). As a result you will see the edition mode translated in that language.
60
61 image:DefaultLanguageFR.PNG
62
63 Once you save a document in one of the languages, that document becomes the original document and the language it is written in becomes the default language.
64
65 image:OriginalLanguage.PNG
66
Silvia Macovei 20.4 67 {{info}}Note that all translations of one page share the same set of XWiki objects. As a result it is impossible to have different objects (and page tags, which are objects too) in different translations for now, but it is planed in next versions.{{/info}}

Get Connected