下载并安装AEM Sites模板(Cloud Service)
本指南提供了分步说明,用于设置和配置最新的AEM Guides模板,以在云环境中生成AEM Sites页面。 按照以下步骤安装所需的包,创建和配置预设,以及生成AEM Sites。
先决条件
在继续设置之前,请确保满足以下先决条件:
-
Adobe Experience Manager (AEM) Cloud:正在运行的 AEM as a Cloud Service 实例,具有 AEM Guides 2502或更高版本。
-
所需权限:您必须具有以下权限:
- 访问 Cloud Manager 以部署包。
- 访问与您的环境关联的 Git存储库。
- 在AEM Guides中创建和修改预设的权限。
-
下载包:从软件分发门户下载以下包:
- 组件包:guides-components.all-1.x.0.zip
- 站点模板:aemg-docs-1.x.0.zip
通过云部署安装包
安装 组件包(guides-components.all-1.x.x.zip) 并执行以下步骤
-
克隆Git存储库:
-
导航到Cloud Manager左侧面板中的 存储库。
-
选择 访问存储库信息 并复制git clone命令。
-
使用提供的用户名和密码将存储库克隆到本地系统(如果需要,生成密码)。
-
-
将包添加到Maven捆绑包:
-
在本地克隆的存储库中,创建一个新的Maven捆绑包或将其添加到现有捆绑包中。
-
确保Maven项目中存在/jcr_root/apps/fmdita/install结构。
Maven项目中的
-
将下载的guides-components.all-1.x.x.zip文件放在安装文件夹中。
-
-
更新筛选器.xml:
-
打开位于父内容目录的META-INF文件夹中的filters.xml文件。
-
添加以下筛选器:filter root="/apps/fmdita" mode="merge"/
-
-
配置pom.xml: 根据您的环境要求更新pom.xml文件。
-
推送更改并运行管道:
- 将更改推送到主Git存储库。
- 导航到Cloud Manager中的 管道,并为所需的环境运行该管道。
-
验证安装: 部署完成后,组件包将安装在AEM Cloud环境中。
使用已安装的模板创建站点
-
导入站点模板:
- 转到AEM Sites页面(servername/sites.html/content)。
- 从模板中选择 创建 > 站点。
- 使用 导入 选项导入站点模板aemg-docs-1.x.x.zip。
-
选择模板: 选择 AEMG Docs 1.x.x,然后选择 下一步。
-
输入站点详细信息: 输入 站点标题 和 站点名称。
-
选择 创建。
创建AEM站点预设
-
创建新预设:
-
在AEM Guides中打开DITA映射并导航到 输出 面板。
-
选择 创建预设。
-
选择类型为 AEM Sites。
-
输入预设的名称。
-
取消选中 使用旧版组件映射 设置。
-
选择 添加 以创建预设。
-
-
配置AEM站点预设: 有两个选项可用于配置现成(OOTB)站点:
选项1:使用站点下拉列表
-
选择 站点 作为上面创建的站点(例如,AEMG文档站点)。
-
验证 发布路径 和 主题页面 模板是否自动设置为:
- 发布路径:/content/AEMG-Docs-Site/en/docs/product
- 主题页模板:“主题”页
选项2:使用站点路径
-
手动将 站点路径 设置为/content/AEMG-Docs-Site/en/docs/product。
-
验证 主题页 模板是否自动设置为主题页。
-
-
保存预设: 保存对预设所做的更改。
生成AEM Sites
-
生成站点:
- 配置预设后,为相应的DITA映射生成AEM站点。
- 生成的站点将位于以下路径:/content/AEMG-Docs-Site/en/docs/product。
-
更改默认生成路径(可选): 如果要更改网站生成的默认路径,请执行以下步骤:
-
导航到 AEM Sites。
-
在OOTB站点结构下创建新产品页面。
-
导航到 AEMG文档 > 英语 > 文档。
-
选择 主页 磁贴,然后选择 下一步。
-
输入页面的 标题 和 名称。
-
选择 创建。
-