根据自定义模板创建映射 id225VF0808MP

您可以创建自定义的映射模板,并使用它们创建DITA映射以及映射模板中引用的主题模板和映射模板

您可以从自定义的映射模板中引用其他映射模板和主题模板。 引用的映射模板可以引用各种映射模板、主题模板、主题、映射、图像、视频和其他资源。 自定义的映射模板可以帮助您非常轻松地复制映射模板和整个引用的文件夹结构。 这些自定义模板对于创建和重新创建具有递归结构和引用的多个映射特别有用。

NOTE
主题模板不是递归创建的。 只生成直接位于映射模板中的主题模板,而主题模板中的任何主题模板都只是在父项中直接引用。

创建自定义模板

AEM Guides允许您从dita-templates文件夹创建自定义映射和主题。 您可以使用这些自定义模板来创建映射和主题。 您还可以与作者共享这些模板,他们可以使用这些模板创建自己的文件。 使用这些模板,您可以允许作者保留模板文件夹中特定资源的单独副本。

NOTE
任何仅在中引用和维护的资源都必须保留在templates文件夹之外。

可通过以下方式创建映射和主题模板:

Assets UI中的模板 templates-assets-ui

主题模板

执行以下步骤可创建主题模板:

  1. 在​ Assets UI ​中,导航到dita-templates文件夹。

    {width="800"}

  2. 单击​ 主题 ​文件夹以将其打开。单击​ 创建> DITA模板

  3. 在Blueprint页面上,选择​ 主题,然后单击​ 下一步。

  4. 在“属性”页面上,指定主题模板​ 标题

  5. 指定文件​ 名称

    note note
    NOTE
    文件名必须具有.dita扩展名。
  6. \(可选\)添加说明。

  7. 单击​ 创建。此时将显示主题模板创建消息。 然后,您可以打开主题模板并对其进行编辑。

映射模板

执行以下步骤可创建映射模板:

  1. 在​ Assets UI ​中,导航到dita-templates文件夹。

  2. 单击​ 映射 ​文件夹以将其打开。

  3. 单击​ 创建> DITA模板。

    {width="300"}

  4. 在Blueprint页面上,选择​ 映射 ​并单击​ 下一步

  5. 在“属性”页面上,指定映射模板​ 标题

  6. 指定文件​ 名称

    note note
    NOTE
    文件名必须具有.ditamap扩展名。
  7. (可选\)添加说明。单击​ 创建。 出现“map template created(已创建映射模板)”消息。 然后,您可以打开映射模板并对其进行编辑。 您可以在映射模板中添加对主题模板、映射模板以及其他资源的引用。

“选项”菜单 options-menu

要创建映射或主题模板,请执行以下步骤:

  1. 选择当前模板文件夹中的​ Map ​或​ Topic ​文件夹。 例如,dita-templates 文件夹。

  2. 从​ 选项 ​菜单中,选择​ 创建映射模板 ​或​ 创建主题模板

    将打开​ 创建新映射模板 ​或​ 创建新主题模板 ​对话框。

  3. 输入新模板的标题和名称。

  4. 从​ 模板 ​下拉列表中选择要创建的模板类型。

出现“map template created(已创建映射模板)”消息。 您可以将模板添加到全局或文件夹级别的配置文件中。 然后,新模板会出现在主题或映射创建过程中,您可以使用它来创建映射或主题。

管理员还可以创建一个文件夹,并将其配置为可在其中创建和保存模板的文件夹。

根据您的设置,了解如何配置自定义DITA模板文件夹路径:

Cloud Service
了解如何在Cloud Service安装和配置指南中配置自定义DITA模板文件夹路径
内部部署软件
了解如何在On-premise Installation and Configuration指南中配置自定义DITA模板文件夹路径

传递模板中定义的标题

如果要将模板内使用的主题或映射的标题传递到使用该模板创建的DITA映射,请在标题周围使用大括号。

示例

<pubtitle>
   <mainpubtitle outputclass="booktitle">
   {title}
   </mainpubtitle>
   <subtitle>Subtitle</subtitle>
</pubtitle>

The resultant DITA map with title "Rootmap1" will look like as follows:
<pubtitle>
   <mainpubtitle outputclass="booktitle">Rootmap1
   </mainpubtitle>
   <subtitle>Subtitle</subtitle>
</pubtitle>
NOTE
只有第一个出现的花括号会被替换为标题。

如果您不在标题周围使用大括号,则仅会选取生成的DITA映射的第一个元素,并且不会从模板中选取标题的嵌套,其将如下所示:

<pubtitle> Rootmap1 </pubtitle>
NOTE
也可以使用文本周围的大括号将其嵌套结构从自定义模板传递到DITA映射。

示例

<title>
    <sub>
        <b>{title}</b>
    </sub>
</title>

使用映射模板创建新映射

NOTE
映射模板必须配置并可由管理员进行创作。 有关更多详细信息,请参阅安装和配置Adobe Experience Manager Guidesas a Cloud Service中的​ 配置创作模板 ​部分。

执行以下步骤以使用自定义映射模板创建映射:

  1. 在​ Assets UI中, ​导航到要创建映射的文件夹。

  2. 单击​ 创建> DITA映射

  3. 在Blueprint页面上,选择要使用的映射模板并单击​ 下一步。 例如,如果您已创建映射模板“test-template”,请选择它。

  4. 在“属性”页面上,指定映射​ 标题

  5. 指定文件​ 名称

    note note
    NOTE
    文件名必须具有.ditamap扩展名。
  6. 单击​ 创建。此时将显示映射创建消息。

映射会生成在模板文件夹中引用的所有资源。 地图中引用的某些资源类型如下所示:

  • 如果映射包含对主题模板的引用,则会在文件夹中创建主题模板的副本,其层次结构与dita-templates文件夹中主题文件夹中的层次结构相同。

  • 如果映射包含对映射模板的引用,则会在文件夹中创建映射模板的副本,其层次结构与dita-templates文件夹中的映射文件夹相同。

  • 如果映射包含对dita-templates/topicsdita-templates/maps文件夹外部的主题或映射的泛型引用,则仅引用该泛型引用,并且不创建任何副本。

    note note
    NOTE
    dita-templates/topicsdita-templates/maps是指南中的默认路径,可以对其进行配置。

    如果映射模板中有主题模板键定义,则会创建一个新键\(因此是新主题\),并在映射中引用该键。

  • 如果在文件夹的同一级别创建另一个映射或主题,则新创建的资源的名称将附加0、1、2等。 您可以选择打开映射进行编辑,或将映射文件保存到存储库中。

父主题:​使用映射编辑器

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178