非英语小工具

本开发人员指南中的大多数示例都是用英语编写的。本文档介绍了可供对创建非英语小工具感兴趣的用户使用的资源。

目录

1. 从何处可以找到非英语小工具？
2. 编写非英语小工具

从何处可以找到非英语小工具？

小工具最有用的特性之一就是其源代码是公开的。只需查看其他小工具的实现方式即可了解很多关于小工具开发的信息。

要查找以特定语言编写的小工具，请按照您的国家/地区和语言使用偏好来过滤 iGoogle 内容目录。您可以使用内容目录中的“更多语言”菜单来实现此操作，也可以在网址中指定语言和国家/地区代码。例如，要查看日语小工具，请使用以下网址：

http://www.google.com/ig/directory?gl=JP&hl=ja&root=/ig&dpos=top 

国家/地区代码的参数是 gl，语言代码的参数是 hl。在该示例中，日本的国家/地区代码是 JP，日语的语言代码是 ja（按照惯例，语言代码需小写，而国家/地区代码需大写，但这并不是绝对的要求）。如果您只提供国家/地区代码或语言代码，则目录的内容会略有不同。为了获取最具体的结果，请同时提供国家/地区代码和语言代码。

过滤目录是查找以特定语言编写的小工具的好方法，但不会只返回以目标语言编写的小工具。严格来讲，小工具并不是按语言标记的。小工具 API 包括 <Locale> 标签，但这是可选的。目录会按受欢迎程度显示特定区域的小工具。例如，如果您显示区域“日本/日语”的目录，您会看到大多数是日语小工具，但您也能看到在该区域常用的非日语小工具。

从 iGoogle 内容目录，您可以向您的 iGoogle 页面添加小工具。添加到 iGoogle 上后，您可以通过点击其在开发人员小工具中的链接来查看其源代码。请注意，非自定义小工具（例如，仅显示供稿的小工具）不列入开发人员小工具中。

编写非英语小工具

小工具对非英语语言使用 UTF-8 编码。小工具 API 支持对 XML 属性值进行 UTF-8 编码以及在 <Content> 部分中进行 UTF-8 编码。如果您的 Content 类型设置为 html，则 UTF-8 将明确设置为默认的编码。您不应尝试自己进行设置。

如果您创建了一个支持多种语言的小工具，则翻译的消息字符串位于称为消息包的外部 XML 文件中。必须明确地以 UTF-8 格式保存包含小工具支持的每个区域的翻译字符串的消息包。

请参阅“国际化”以获取有关如何创建多语言小工具的详细信息。

返回页首