本地化指南.docVIP

Localization Guide 本地化指南 译者：王娜 原文档名称：Pentaho_Internationalization_Guide_1.0.0.RC2.pdf December 12, 2005 Copyright ? 2005 Pentaho Corporation. Redistribution permitted. All trademarks are the property of their respective owners. For the latest information, please visit our web site at 介绍 这个指南将帮助你将英文版的 Pentaho BI 平台翻译成其他语言。你需要预配置的安装包和一个文本编辑器。用户接口和日志文件的所有消息均存放在文本文件中。这些文本文件的名字均以 .properties 为后缀，位于很多文件夹中。为支持一种新的语言，你需要为你的语言创建 .properties 文件。这些文件的命名是有标准的，我们已经为几种语言创建好了文件。 开始 1. 首先访问 /discussion 上的 Internationalization 论坛，看看是否有其他人已经开始进行你的语言上的翻译了。 2. 如果你想翻译成 French，German，Spanish，Italian，Portuguese 或 Chinese，我们已经为你创建好了.properties 文件。如果你想翻译成其他语言，发送 email 到communityconnection@ 或在 Pentaho 论坛上发帖。 3. 从 SourceForge 下载名为 pentaho_demox. x.x.x.zip 的预配置安装包的 或更高版本。确保你知道如何运行 demo 网页，portal 页面和 samples。帮助信息请查看Getting Started Guide 和论坛信息。 4. 在预配置安装包和 pentaho-solutions 目录中寻找后缀为 .properties 的文件，你会看到如下类似信息： *.properties (English) *_perties (French) *_perties (German) *_perties (Italian) *_perties (Spanish) *_perties (Portugese) *_perties (Chinese) 5. 如果你的语言不在列表中，或你想创建某种语言的特定版本，例如 French Canadian，请联系 communityconnection@，我们将提供相应帮助。 标准语言和国家代码的列表请参考以下网页： 语言代码：/pub/ietf/http/related/iso639.txt 国家代码：http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html 一般概念 向用户显示的所有文本信息均存储在 .properties 文件中。每当平台需要一块文本，就加载适当的 .properties 文件，从中读取必需的文本。对于系统支持的每种语言，都有 .properties 文件。两个字符的语言代码和两个字符的国家代码（可选）附加在基本的文件名上，以标识文件的本地版本。例如： perties: messages 文件的默认英语版本 messages_perties: messages 文件的 French 版本 messages_perties: messages 文件的 German 版本 messages_fr_CA.properties: messages 文件的 French Canadian 版本 当用户发出一个请求后，平台探测那个用户的国家和语言，并定位文件的正确语言版本。在运行时读取 .properties 文件，并不编译进平台。这使得执行翻译和查看结果是一个很简单的过程。 命名约定的完整解释请参考本文最后，其他资源一节中的参考文献。 翻译Samples 开始翻译平台的最轻松方式是翻译 samples。预配置安装包的 pentahosolutions 目录包含运行 sample solutions 的所有必需文件。用户可以看见 .properties 文件中的所有文本，他们均该被翻译。这些文件的根目录是： pentaho-demo/pentaho-solutions/ 这张图显示了 samples 的标准位置，以及 .properties 文件的默认和 French 版本。在这个实例中，当一个英语用户请求 samples 目录下的 index.xml 文件时，平台会在此目录下寻找 perties 文件。当一个 Fre