为AEM Guides自定义现有AEM站点模板
本指南提供了分步说明，用于自定义现有AEM站点模板以与AEM Guides一起使用以从DITA映射和主题生成AEM Sites。
如果您使用的是现成的AEM Guides (AEMG Docs)模板，则配置和组件已经就位，可以按原样使用它们来发布AEM Guides内容。 但是，如果您要将现有的AEM Sites模板与自定义品牌结合使用来发布AEM Guides内容，请按照以下步骤使您的站点模板与AEM Guides渲染要求保持一致。
先决条件
-
您拥有对AEM模板的适当权限和访问权限。
-
您了解AEM可编辑模板和AEM站点结构。
-
您已有使用可编辑模板构建的现有站点层次结构。
-
您现有项目中至少有两个模板：
- 文档容器页面模板，用于将DITA映射呈现为文档根。
- 主题页模板 用于呈现各个DITA主题页。
模板命名注意事项
模板名称将因项目设置而异。 例如，在OOTB AEMG文档配置中：
-
文档容器页面： /conf/AEMG-Docs-Site/settings/wcm/templates/kb-content
-
主题页面： /conf/AEMG-Docs-Site/settings/wcm/templates/topic-content
自定义： 自定义过程包含两个主要步骤：
- 模板设置：标识并配置两个模板（容器和主题）。
- 渲染指南组件：嵌入必需的AEM Guides组件以启用目录、导航和元数据显示等功能。
模板设置
从AEM站点中选择并配置两个可编辑的模板。
文档容器页面模板
文档容器页面模板用于创建呈现DITA映射内容的产品文档容器页面。
-
它用作一组特定文档（例如，产品手册或指南）的入口点或主页。
-
将id="category-page"属性添加到模板初始节点的jcr:content。 这可确保AEM Guides会自动将从此模板创建的所有页面视为文档容器。
-
添加具有必需属性的文本组件： text="$category.html$"。
-
通常包括导航元素，例如指向文档中的部分或主题的链接。
-
它可以进行自定义以包含品牌、页眉、页脚和其他设计元素。
示例用例：
如果您有产品手册的DITA映射，则文档容器页面模板将为该手册生成主页，显示概述和各个主题的链接。
主题页面模板
-
主题页面模板 用于创建单个 DITA主题 的页面。
-
DITA映射中的每个主题都使用此模板呈现为单独的页面。
-
包含具有强制属性 文本组件： text="$topic.content$"。
-
在站点生成期间，此占位符将替换为DITA主题的实际内容。
- 文本组件通常置于 Container组件 中，以确保布局和样式正确。
- 可以自定义以包含所有主题页面中一致的页眉、页脚和导航元素。
示例用例：
如果您有有关“安装说明”的DITA主题，则主题页面模板将生成一个显示该主题内容的页面。
容器组件：
在同一模板的结构中添加相同的（容器和文本组件）：
呈现自定义模板中的指南组件
要启用核心AEM Guides组件功能（如目录、页面重定向、导航和元数据显示），您需要在自定义模板中包含特定的AEM Guides组件。 必须将这些组件显式添加到相应的可编辑模板（文档容器页面或主题页面），以确保在站点生成和运行时提供所需的功能。
有关组件及其使用情况的列表，请参阅下表：
组件用例
-
重定向组件(childredirect)： 将此组件添加到文档容器页面模板，以便从DITA映射生成的产品主页自动重定向到第一个主题页面。 如果您的文档容器页面设计为具有自定义组件和布局的独立主页，则不需要此组件。
-
目录(guidessidenavigation)： 将此项添加到主题页面模板，以随主题内容呈现可导航的目录。 TOC派生自DITA映射，并帮助用户在同级主题之间导航。
启用Guides客户端库
默认情况下，AEM Guides组件包中提供的客户端库(clientlibs)不会应用于自定义模板。 要启用它们，请执行以下操作：
-
编辑模板：
-
在 编辑器模式 中打开 产品页。
-
选择 编辑模板 (这将打开类似conf/settings/wcm/templates/structure.html的URL)。
-
-
更新页面策略：
-
转到 页面信息 按钮，然后选择 页面策略。
-
添加以下客户端库：
- 客户端库
- 客户端库JavaScript页头
-
-
保存更改： 添加所需的客户端库后保存模板。
