jsl10n 1.1

Zope / Plone 的 Javascript 本地化
==========================================
jsl10n.js 提供一个名为“translate”的函数，它至少需要 3 个
参数：
- i18n 域；
- 属性“msgid”和“默认”设置为翻译 ID 和默认值的对象数组
；
- 一个回调函数，将使用单个对象参数调用，该参数具有
将翻译 ID 映射到翻译字符串的属性，一旦它们被
检索到。除此之外，还有 2 个可选参数：
- 一个布尔值，当设置为“真”时，将导致
每次页面加载时检索翻译；
- 一个布尔值，当设置为“真”时，会导致调试消息
打印到 Javascript 控制台。
该函数使用 AJAX 调用视图“translate.js”，该视图返回
给回调函数的 JSON 对象。如果 JSON 调用失败，
仍然会触发回调并返回默认值。应
实施后备措施。

示例用法
-------------
required_translations = [
{'msgid':'my_message',
'default':'Hello world!'}
];
translate('domain', required_translations,
function (translations) {
alert(translations['my_message']);
}
);



- 任何缓存都应在“translate.js”的缓存键中使用 GET 变量。
- 这些字符串不会被 i18ndude 提取，因此如果它们没有
出现在代码库的其他地方（在模板或 Python 代码中），它们将不会
自动添加到 POT 文件中。
- 由于 POT 文件是自动管理的，如果手动将字符串添加到
POT 文件中，它们将在下次更新时被删除。对此有两种
可能的解决方案：
1）定义一个手动管理的新域；
2) 在代码库的某处创建一个虚拟模板文件，该文件从未
实际调用，但包含 Javascript 中专门使用的所有 msgid 和默认值
；
3) 在从不渲染的部分中包含相关模板部分的翻译
，例如：

<tal:comment tal:replace="nothing">
<span i18n:translate="my_message">Hello world!</span>
< /tal:comment>

依赖
------------
simplejson_
.. _simplejson: http://pypi.python.org/pypi/simplejson/

安装
============

没有构建
----------------
将此包安装在您的系统路径包或
Zope 实例的 lib/python 目录中。您可以使用 easy_install 或
通过 setup.py 脚本执行此操作。您还需要以同样的
方式安装 plone.keyring。

安装软件包后，它需要在您的 Zope 实例中注册。
这可以通过将带有
以下内容的 jsl10n-configure.zcml 文件放入 etc/package-includes 目录中来完成::

<include package="jsl10n" />

或者，您可以将该行添加到 configure.zcml 中
已注册 的包或 产品。

With buildout
------------- Eggs =
jsl10n
zcml = jsl10n

版权所有
=========
版权所有 2010 Isotoma Limited

在 Apache 许可证 2.0 版（“许可证”）下获得许可；
除非遵守许可，否则您不得使用此文件。
您可以在以下网址获取许可证的副本

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则
根据许可分发的软件均按“原样”分发，
不附带任何形式的保证或条件，或者明示或暗示。
有关许可下的特定语言管理权限和
限制，请参阅许可。