在从AEM Guides生成的AEM Sites页面中启用上下文内容变量(CCVAR)

Last update: Wed Jan 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

用户
管理员

上下文内容变量(CCVAR)是一种ACS Commons功能，它允许作者直接在其创作的文本中使用动态内容变量。虽然CCVAR在AEM Sites中经常使用，但本文介绍如何通过使用在AEM Guides 中创作的内容生成的页面，主要通过使用DITA映射中定义的关键字来实现类似功能。

什么是上下文内容变量(CCVAR)？

CCVAR允许作者将动态变量插入其内容，这些变量在运行时根据上下文解析。例如，像((page_properties.pageTitle))这样的变量可以在内容呈现期间动态提取页面标题。

如何在从AEM Guides生成的AEM Sites页面中启用CCVAR？

考虑到AEM Guides被用作所有内容(包括AEM Sites、PDF或HTML5)的源，要在从AEM Guides生成的页面上启用CCVAR，您需要使用关键字来定义CCVAR名称。要在指南中执行此操作，请使用<keydef>元素在DITA映射中定义关键字。这些关键字可以对应于动态值（或CCVAR名称），从而允许您在DITA主题中引用它们。

先决条件

在继续操作之前，请确保满足以下先决条件：

已安装AEM ACS Commons：
- 确保您的AEM实例上安装了ACS AEM Commons。使用CCVAR时需要具备此权限。
上下文内容变量配置：
- 使用官方文档在AEM中完成 上下文内容变量 的设置。这包括：
  - 正在启用属性聚合。
  - 正在配置HTML重写(如果使用HTML输出)。
  - 正在配置JSON重写（如果使用JSON输出）。

在AEM Guides中启用CCVAR的步骤

1.在DITA映射中定义关键字

在AEM Guides中，使用DITA映射中的<keydef>元素定义关键字，以使其与CCVAR相对应。
例如：

  <keydef keys="product">
    <topicmeta>
      <keywords>
        <keyword>((page_properties.pageTitle))</keyword>
      </keywords>
    </topicmeta>
  </keydef>

keys属性（在此示例中为product）将用于在DITA主题中引用此变量。

2.在DITA主题中使用关键字

在主题中，无论在何处使用CCVar，都使用关键字。
例如：

  <p>This is the title of the product: <keyword keyref="product"/> </p>

keyref属性指向<keydef>元素（product，本例中为）中定义的keys值。
在输出生成期间，关键字将被相应的CCVar值替换。

3.生成输出

生成AEM Sites的输出时，关键词引用将被解析为相应的动态值。
例如：
- 如果((page_properties.pageTitle))解析为My Product，则将显示输出：

   This is the title of the product: My Product.

示例用例

假设您要动态地将页面的语言插入到DITA主题中。下面介绍了如何实现此目标：

在DITA映射中定义关键字：

   <keydef keys="pageLanguage">
     <topicmeta>
       <keywords>
         <keyword>((inherited_page_properties.jcr:language))</keyword>
       </keywords>
     </topicmeta>
   </keydef>

引用DITA主题中的关键字：

   <p>The title of this page is: <keyword keyref="pageLanguage"/>.</p>

生成的输出：

如果((inherited_page_properties.jcr:language))解析为en，则将显示输出：

     The language of this page is: en.

资源

有关 上下文内容变量 的更多详细信息，请参阅官方文档：
AEM Commons中的上下文内容变量

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178