xwiki开发者指南-国际化应用程序

教程

• 国际化一个表单教程

在XWiki页面使用propertie

• 创建一个页面，由键/值对组成
• 在该页面中输入所有的键/值对(使用wiki编辑)。例如： greeting=hello welcome=Welcome withparams=I can {0} pass {1} {2} params too using the Java MessageFormat syntax
• 为你想要的所有翻译做同样的事情。 要启用多国语言，你需要到管理员页面，并设置MultiLingual为true，并在Languages字段列出你希望使用的不同语言。
• 通过在页面添加TranslationDocumentClass对象类型来告诉XWiki你的页面是翻译页面。
• 在页面你可以使用{{translation}}宏或者使用本地化服务脚本(查看Localization module文档)。例子： 用wiki语法： {{translation key="key"/}} 用脚本(下面例子用Velocity)：

旧的方式

XWiki 4.3以前，需要在管理员页面注册一个Document Resource Bundle，选择"Localization"然后在"Internationalization Document Bundles"字段，你可以指定多个页面，以逗号分隔。

当创建"Internationalization Document Bundles"，你应该避免用包含空格的名字命名。例如，一个名为Main.My Messages文档会生产问题，你应该使用Main.MyMessages。

或者你还可以在xwiki.cfg的xwiki.documentBundles指定Internationalization Document Bundles列表。

XWiki对象国际化

这目前还没实现(查看XWIKI-69)。有2个解决方法，你可以使用：

• 有几个对象，用于每个语言，用一个语言字段来决定使用哪个对象(例如在一个Class Sheet，基于当前语言)： doc.getObject('Your.Class', 'lang', context.language') ## Will select the object whose 'lang' property is set to the current language
• 使用Velocity脚本，例如： #if ($context.language == "fr") French texts #else Default texts #end

使用静态资源包

• 暂停XWIki实例
• 从WEB-INF/lib/xwiki-*oldcore-*.jar文件提取对应语言的ApplicationResources*.properties文件，把他们放在WEB-INF/classes目录
• 编辑文件，添加或者修改键值对
• 在你的文档，使用以下key来获取相关联的值：$services.localization.render("key")

这将从资源包对应的当前语言获得值。

如果你正在写一个扩展JAR，希望拥有静态的翻译资源，你可以把他们放在位于你扩展JAR的根目录下一个ApplicationResources*.properties文件，他们将会被Localization module提取。查看Localization module了解更多信息。