Wiki source code of InternationalizingApplications
Version 2.1 by NatoIne on 2007/11/26
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | 1 Writing Internationalized XWiki Applications | ||
| 2 | |||
| 3 | #toc("" "" "") | ||
| 4 | |||
| 5 | 1.1 Using the static Resource Bundles | ||
| 6 | |||
| 7 | * Stop your XWiki instance | ||
| 8 | * Unjar the ~~WEB-INF/lib/xwiki-core-\*.jar~~ file in ~~WEB-INF/classes~~ and remove it from ~~WEB-INF/lib~~ | ||
| 9 | * Edit the ~~WEB-INF/classes/ApplicationResources*.properties~~ Resource Bundle files by adding the key/value pairs you need for your application. | ||
| 10 | * In your document, use the following to get the value associated with a key: | ||
| 11 | |||
| 12 | {code} | ||
| 13 | $msg.get("key") | ||
| 14 | {code} | ||
| 15 | |||
| 16 | This will get the value from the Resource Bundle corresponding to the current language you are using in XWiki. | ||
| 17 | |||
| 18 | #info("sometimes the xwiki-core- file doesn't exist and you have to unjar xwiki.jar instead") | ||
| 19 | |||
| 20 | 1.1 Using properties located in XWiki pages | ||
| 21 | |||
| 22 | #warning("The features described below are only available in XWiki 1.0 Beta 4 and above. The ability to parametrize the resource string is available only in XWiki 1.0 Beta 5 and above.") | ||
| 23 | |||
| 24 | * Create a page that will host your key/value pairs. | ||
| 25 | * Enter all the key/value pairs in that page (use the wiki editor). For example: | ||
| 26 | |||
| 27 | {code} | ||
| 28 | greeting=hello | ||
| 29 | welcome=Welcome | ||
| 30 | withparams=I can {0} pass {1} {2} params too using the Java MessageFormat syntax | ||
| 31 | {code} | ||
| 32 | |||
| 33 | * Do the same for all the translations you want. | ||
| 34 | |||
| 35 | #info("To enable multiple languages you'll need to go to the Administration page and set MultiLingual to true and list the different languages you wish to use in the Languages field.") | ||
| 36 | |||
| 37 | * Tell XWiki that your page is a Document Bundle by going to the Administration page, selecting the Advanced tab and entering it in the "Internationalization Document Bundles" field. You can specify several pages, separated by commas. | ||
| 38 | |||
| 39 | * Alternatively you can also specify the list of Internationalization Document Bundles in ~~xwiki.cfg~~ under the key ~~xwiki.documentBundles~~. | ||
| 40 | |||
| 41 | * On the page where you want to use the internationalized message, use: | ||
| 42 | |||
| 43 | {code} | ||
| 44 | $msg.get("key") | ||
| 45 | $msg.get("key", ["param1", "param2", ...]) | ||
| 46 | {code} | ||
| 47 | |||
| 48 | where ~~key~~ is the key for the message to retrieve. Parameters can also be passed as is shown in the second syntax above. |
