不同的材料集可能包含类似的信息,需要在特定位置进行定制。 键允许您在使用DITA时包含变量信息。

您可以选择用于本课程的示例文件在文件keys.zip中提供。

启用键

  1. 上传提供的示例文件集。

    a.加载压缩文件。

    b.刷新AEM环境。

    c.选择要提取的文件。

    选择Zip

    d.单击顶部工具栏中的​ 提取存档

    工具栏

    e.在对话框中,选择要提取的文件的特定位置,例如名为“密钥”的文件夹。

    f.单击​ 下一步

    g.跳过任何冲突,因为以前从未上传过的内容不存在这些冲突。

    h.选择屏幕右上方的​ 提取

  2. 提取完成后,单击​ 转到目标文件夹

    确认

将键解析为引用的值

要正确使用密钥,用户首选项必须将特定映射引用为根映射。 此映射内部是键的集合,这些键在主题组中分组在一起。 打开映射和主题将键解析为此映射引用的值。

  1. 指定根映射。

    a.在“按键”屏幕中,打开地图。

    b.配置用户首选项。

    c.单击顶部工具栏上的​ 用户首选项 ​图标。

    顶部工具栏

    d.单击键图标以指定将用于解析键的​ 根映射

    e.选中任何所需的Assets对应的复选框。

    Assets下拉列表

    f.单击​ 选择

    g. 保存 ​用户首选项。

  2. 导航到​ 映射视图

  3. 打开指定的映射。

键已解析。

手动添加新键盘

  1. 使用指定的根映射打开映射。

  2. 选择一个键。

    键下拉列表

  3. 插入新键盘。

    a.在地图中的有效位置单击。

    b.选择顶部工具栏上的​ Keydef ​图标。

    Keydef工具栏

    c.在“插入Keydef”对话框中,为键输入对您创建的定义有意义的唯一值。

    d.单击​ 插入

  4. 在keydef中添加topicmeta。

    a.单击顶部工具栏上的​ 插入元素 ​图标。

    Keydef工具栏

    b.在插入元素对话框中,搜索并选择“topicmeta”。

  5. 在topicmeta中添加关键字。

    a.单击顶部工具栏上的​ 插入元素 ​图标。

    Keydef工具栏

    b.在“插入元素”对话框中,搜索并选择“关键字”。

  6. 在topicmeta中添加关键字。

    a.单击顶部工具栏上的​ 插入元素 ​图标。

    Keydef工具栏

    b.在​ 插入元素 ​对话框中,搜索并选择“关键字”

  7. 在关键字中键入keydef的值。

在地图中,您的keydef现在应如下所示:

Keydef已完成

将keydef配置为代码片段

片段是小型内容片段,可在文档项目的各种主题中重复使用。 您可以配置单个密钥作为代码片段,而不是手动生成每个密钥文件。

  1. 在映射中选择keydef元素。

  2. 在上下文菜单中,单击​ 创建代码片段

  3. 在新代码片段对话框中,添加标题和描述。
    您可能还希望从内容中删除现有的键或关键字定义。

  4. 单击​ 创建

  5. 在左侧面板上,选择​ 代码片段

  6. 将您刚刚创建的代码片段从“代码片段”面板拖放到地图中。

  7. 根据需要使用内容属性更新keydef。
    保存并刷新后,此组密钥将可供已定义包含相同根映射的映射的任何用户使用。

recommendation-more-help
5d77304e-09c3-49ad-9381-b66e7cbd5f86