识别要翻译的内容

翻译规则可识别要翻译的内容，这些内容适用于翻译项目中包含或排除的页面、组件和资产。 当页面或资产被翻译时，AEM会提取此内容，以便将其发送到翻译服务。

页面和资产在JCR存储库中以节点表示。 提取的内容是节点的一个或多个属性值。 翻译规则可识别包含要提取内容的属性。

翻译规则以XML格式表示，并存储在以下可能的位置：

• /libs/settings/translation/rules/translation_rules.xml
• /apps/settings/translation/rules/translation_rules.xml
• /conf/global/settings/translation/rules/translation_rules.xml

该文件适用于所有翻译项目。

规则包括以下信息：

• 应用规则的节点的路径。 该规则也适用于该节点的子项。
• 包含要翻译内容的节点属性的名称。 该属性可以特定于特定资源类型或所有资源类型。

例如，您可以创建一个规则，以将作者添加的内容翻译为页面上的所有AEM Foundation文本组件。 规则可以识别/content节点和foundation/components/text组件的text属性。

添加了一个console，用于配置翻译规则。 UI中的定义将为您填充文件。

有关AEM中内容翻译功能的概述，请参阅多语言站点的内容翻译。

页面、组件和资产的规则语法

规则是一个node元素，其中包含一个或多个子元素property和零个或多个子元素node:

<node path="content path">
          <property name="property name" [translate="false"]/>
          <node resourceType="component path" >
               <property name="property name" [translate="false"]/>
          </node>
</node>

每个node元素都具有以下特征：

• path属性包含应用规则的分支的根节点的路径。

• 子property元素标识要转换的所有资源类型的节点属性：

  • name属性包含属性名称。
  • 如果属性未翻译，则可选的translate属性等于false。 默认情况下，值为true。 此属性在覆盖以前的规则时很有用。

• 子node元素标识要针对特定资源类型转换的节点属性：

  • resourceType属性包含解析到实现资源类型的组件的路径。
  • 子property元素标识要转换的节点属性。 此节点的使用方式与节点规则的子property元素相同。

以下示例规则会导致对/content节点下所有页面转换所有text属性的内容。 该规则对于存储text属性中内容的任何组件（如基础文本组件和基础图像组件）都有效。

<node path="/content">
          <property name="text"/>
</node>

以下示例将转换所有text属性的内容，还转换基础图像组件的其他属性。 如果其他组件具有同名属性，则规则不会应用到这些属性。

<node path="/content">
      <property name="text"/>
      <node resourceType="foundation/components/textimage">
         <property name="image/alt"/>
         <property name="image/jcr:description"/>
         <property name="image/jcr:title"/>
      </node>
</node>

从页面提取资产的规则语法

使用以下规则语法来包含在组件中嵌入或从组件中引用的资产：

<assetNode resourceType="path to component" assetReferenceAttribute="property that stores asset"/>

每个assetNode元素具有以下特征：

• 一个resourceType属性，它等于解析到该组件的路径。
• 一个assetReferenceAttribute属性，该属性等于存储资产二进制文件（用于嵌入资产）或引用资产路径的属性名称。

以下示例从基础图像组件中提取图像：

<assetNode resourceType="foundation/components/image" assetReferenceAttribute="fileReference"/>

覆盖规则

translation_rules.xml文件由具有多个子node元素的nodelist元素组成。 AEM从上到下读取节点列表。 当多个规则定向同一节点时，将使用文件中较低的规则。 例如，以下规则会导致除页面的/content/mysite/en分支之外，text属性中的所有内容都被翻译：

<nodelist>
     <node path="/content”>
           <property name="text" />
     </node>
     <node path=“/content/mysite/en”>
          <property name=“text” translate=“false" />
     </node> 
<nodelist>

筛选属性

您可以使用filter元素筛选具有特定属性的节点。

例如，以下规则会导致除将属性draft设置为true的节点之外，所有属性中的内容都被翻译。text

<nodelist>
    <node path="/content”>
     <filter>
   <node containsProperty="draft" propertyValue="true" />
     </filter>
        <property name="text" />
    </node>
<nodelist>

翻译规则UI

控制台也可用于配置翻译规则。

要访问它，请执行以下操作：

1. 导航到​工具，然后导航到​常规。

   

2. 选择​翻译配置。

   

在此，您可以​添加上下文。 这允许您添加路径。

然后，您需要选择上下文，然后单击​编辑。 这将打开翻译规则编辑器。

您可以通过UI更改以下4个属性：isDeep、inherit、translate和updateDestinationLanguage。

​​isDeep此属性适用于节点过滤器，默认为true。它会检查节点（或其祖先）是否在筛选器中包含具有指定属性值的属性。 如果为false，则仅在当前节点进行检查。

例如，即使父节点的属性draftOnly设置为true来标记草稿内容，子节点也会被添加到翻译作业中。 此处isDeep开始发挥作用，并检查父节点是否将属性draftOnly设置为true并排除这些子节点。

在编辑器中，可以在​过滤器​选项卡中选中/取消选中​Is Deep。

以下示例显示了在UI中未选中​Is Deep​时生成的xml:

 <filter>
    <node containsProperty="draftOnly" isDeep="false" propertyValue="true"/>
</filter>

​​inherit（继承）这适用于属性。默认情况下，每个属性都会继承，但如果您希望某些属性不会在子项上继承，则可以将该属性标记为false，以便该属性仅应用于该特定节点。

在UI中，您可以选中/取消选中​属性​选项卡中的​Inherit。

​​translate属性仅用于指定是否翻译属性。

在UI中，您可以选中/取消选中​属性​选项卡中的​Translate。

​​updateDestinationLanguage此属性用于没有文本但没有语言代码的属性，例如jcr:language。用户不是在翻译文本，而是在语言区域设置从源到目标。 此类属性不会发送以进行翻译。

在UI中，您可以选中/取消选中​属性​选项卡中的​Translate，但是对于具有语言代码作为值的特定属性，可以选中/取消选中。

为了帮助阐明updateDestinationLanguage和translate之间的差异，以下是仅包含两个规则的上下文的简单示例：

xml的结果将如下所示：

<property inherit="true" name="text" translate="true" updateDestinationLanguage="false"/>
<property inherit="true" name="jcr:language" translate="false" updateDestinationLanguage="true"/>

手动编辑规则文件

随AEM一起安装的translation_rules.xml文件包含一组默认的翻译规则。 您可以编辑文件以支持翻译项目的要求。 例如，您可以添加规则，以便对自定义组件的内容进行翻译。

如果编辑translation_rules.xml文件，请将备份副本保留在内容包中。 安装AEM Service Pack或重新安装某些AEM包可将当前translation_rules.xml文件替换为原始文件。 要在这种情况下恢复规则，您可以安装包含备份副本的包。

翻译规则文件示例

<nodelist>
    <!-- translation rules for Geometrixx Demo site (example) -->
    <node path="/content/geometrixx">
        <!-- list all node properties that should be translated -->
        <property name="jcr:title" /> <!-- translation workflows running on content saved in /content/geometrixx, will extract jcr:title values independent of the component. -->
        <property name="jcr:description" />
        <node resourceType ="foundation/components/image"> <!-- translation workflows running on content saved in /content/geometrixx, will extract alternateText values only for Image component. -->
            <property name="alternateText"/>
        </node>
        <node resourceType ="geometrixx/components/title">
            <property name="richText"/>
            <property name="jcr:title" translate="false"/> <!-- translation workflows running on content saved in /content/geometrixx, will not extract jcr:title for Title component, but instead use richText. -->
        </node>
        <node pathContains="/cq:annotations">
            <property name="text" translate="false"/> <!-- translation workflows running on content saved in /content/geometrixx, will not extract text if part of cq:annotations node. -->
        </node>
    </node>
    <!-- translation rules for Geometrixx Outdoors site (example) -->
    <node path="/content/geometrixx-outdoors">
        <node resourceType ="foundation/components/image">
            <property name="alternateText"/>
            <property name="jcr:title" />
        </node>
        <node resourceType ="geometrixx-outdoors/components/title">
            <property name="richText"/>
        </node>
    </node>
    <!-- translation rules for ASSETS (example) -->
    <node path="/content/dam">
        <!-- configure list of metadata properties here -->
        <property name="dc:title" />
        <property name="dc:description" />
    </node>
    <!-- translation rules for extracting ASSETS from SITES content, configure all components that embed or reference assets -->
    <assetNode resourceType="foundation/components/image" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="foundation/components/video" assetReferenceAttribute="asset"/>
    <assetNode resourceType="foundation/components/download" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="foundation/components/mobileimage" assetReferenceAttribute="fileReference"/>
    <assetNode resourceType="wcm/foundation/components/image" assetReferenceAttribute="fileReference"/>
</nodelist>