*.zcml 文件是否会被国际化解析？

Question

我已经命名了实用程序，并希望标记名称以供以后 i18n 使用。这是正确的方法吗？

<utility
  name="Home"
  i18n:attributes="name"
  provides=".interfaces..."
  factory=".shortcut...." />

Answer 1

该实用程序的名称不是可翻译的消息 ID，而是内部技术 ID。您不能将其用于翻译目的。

如果您查看 zope.component.zcml，您可以看到该指令的接口包含：

class IUtilityDirective(IBasicComponentInformation):
    """Register a utility."""

    name = zope.schema.TextLine(
        title=_("Name"),
        description=_("Name of the registration.  This is used by"
                      " application code when locating a utility."),
        required=False)

如果您查看例如 http://wiki.zope.org/zope3/zcml.html 它会告诉您属性必须是 MessageID 类型才能在 ZCML 中进行翻译。

如果您有一个带有 MessageID 类型属性的 ZCML 指令，您所需要做的就是为 ZCML 文件定义一个 i18n:domain 。 ZCML 机器知道哪些属性本身是可翻译的，基于它们是正确的类型。因此，您不需要任何额外的标记来注释任何属性，就像您在 TAL 中需要的那样。

话虽如此，如果您在 Plone 中工作并使用 i18ndude 提取消息，它不会从 ZCML 文件中提取任何消息 - 只是因为 ZCML 中没有定义任何消息，该消息实际上也显示在 Plone UI 中的任何位置。

如果您有实用程序并希望为它们提供可翻译的名称，请为它们提供标题属性，例如：

from zope.i18nmessageid import MessageFactory
_ = MessageFactory('mydomain')

class MyShortCut(object):

    title = _('My shortcut')

并在 UI 中使用标题属性。

Answer 2

你不想那样做。 name 属性供应用程序使用，而不是供最终用户使用，并且需要稳定。

如果您翻译它，那么您也必须翻译代码中的所有命名查找！

可以使用 元素上的 i18n_domain="domain" 标记来翻译标题和说明。