Experience Manager Guides和Edge Delivery Services

打开Experience Manager Guides样板模板存储库aem-guides-boilerplate。

使用此模板创建新存储库。 了解从模板创建存储库。 确保将存储库可见性设置为​Public，以便EDS可以访问该存储库。

在GitHub上，导航到左侧边栏并选择​开发人员设置。

在左侧边栏中，选择​OAuth应用程序。

选择​新建OAuth应用程序。

{width="650"}

通过提供以下强制性详细信息注册您的应用程序：

• 应用程序名称：输入EDS存储库的名称
• 主页URL：输入Experience Manager Guides实例的URL。 （有关示例URL格式，请参阅创建新的GitHub应用程序部分的步骤4）。
• 授权回调URL：与主页URL相同

选择​ 启用设备流 ​选项，然后选择​ 注册应用程序 ​以完成注册。

{width="650"}

在GitHub存储库中，打开fstab.yaml文件。

使用以下格式更新url值：

https://guides.adobe.com/eds-workers/<account type>/<git acc domain>/<git username>/<git repo>/<branch>/<root folder>

下表介绍了URL中的每个字段：

例如，如果您的GitHub用户名是my-username，存储库名称为my-eds-repo，则fstab.yaml文件将显示如下：

mountpoints:
  /:
    url: https://guides.adobe.com/eds-workers/github/github.com/my-username/my-eds-repo/main/docs
    type: markup

{width="650"}

重复步骤2和3，从通过AEM代码同步部分将GitHub连接到Adobe以授权存储库。

导航到AEM代码同步页面，然后选择​安装。

AEM代码同步​监视存储库更改并确保将更新正确推送到GitHub。

在下一页上，授予对您创建的存储库的访问权限。 选择​仅选择存储库，然后从下拉列表中选择您的存储库。

{width="350"}

选择​安装并授权。

您将被重定向到GitHub设置页面。

查看源代码详细信息并选择​下一步。

在​ 内容源 ​页面上，配置以下设置：

• 内容源类型：​选择​其他（自带标记）。
• 内容源URL：​查看fstab.yaml文件中配置为装入点URL的URL。 如果您尚未更新文件中的URL，可以在此处更新它。
• 文件扩展名：​将默认.html后缀更改为.htm。

确保已选择​使用其他内容源。

在​ 用户 ​页面上，根据需要添加用户，然后选择​下一步。

查看配置摘要并选择​保存。

成功注册后，将显示确认页面。 您可以从此页面复制并保存您网站的​ 预览 ​和​实时 URL。

转到​Workspace设置 > 发布配置文件。

选择​ + ​图标以创建新的发布配置文件并提供以下详细信息：

• 服务器类型*：​从下拉列表中选择​Git （Edge Delivery服务）。

• 名称*：​输入发布配置文件的名称。

• Git帐户类型*：​从下拉列表中选择​ GitHub ​或​GitLab，具体取决于您的Git存储库提供程序。

• 实例URL*：​输入GitHub或GitLab实例的URL，例如https://github.com或https://gitlab.com。

• 存储库名称*：​输入GitHub或GitLab存储库的名称。

• 用户名*：​输入您的GitHub或GitLab用户名。

• 分支名称：​设置为main（默认）。

• 根文件夹*：​设置为docs（默认）。

• 站点所有者（仅​GitLab）：​输入Edge Delivery Services站点的所有者。

• 站点存储库（仅​GitLab）：​输入与Edge Delivery Services站点关联的存储库名称。

• HLX API密钥：​输入用于EDS配置的HLX API密钥。 要支持Experience Manager Guides as a Cloud Service 2026.11.0版本中引入的未发布功能，需要此密钥。 此外，如果内容大小超过100个文件，则需要密钥才能将内容发布到EDS。

• 身份验证凭据：​提供基于所选Git帐户类型的凭据：

  • GitHub：​输入从您的GitHub OAuth应用程序获得的​ 客户端ID* 和​客户端密钥*。 有关详细信息，请参阅创建新的OAuth应用程序。
  • GitLab：​输入为您的GitLab帐户生成的​Access token*。

（仅限GitHub）选择​ 登录 ​以进行身份验证。 对于GitLab，无需登录，因为访问令牌将用于身份验证。

{width="650"}

选择​保存。 对于GitHub，在成功进行身份验证后，保存​选项可用。

在地图控制台中打开您的地图。

在​ 输出预设 ​选项卡中，选择​ + ​以创建新的输出预设。

在​ 新建输出预设 ​对话框中，提供以下详细信息：

• 类型：选择​Edge Delivery服务
• 名称：提供此预设的名称

选择​添加。

{width="650"}

打开新创建的EDS输出预设，并配置以下字段：

• 条件筛选：​选择​ 无 ​生成输出而不进行筛选，或选择​ 使用DITAVAL ​应用条件筛选。

• 发布子文件夹：​输入在其中发布输出的子文件夹的名称。 子文件夹在存储库的根文件夹下创建，其名称显示在指向已发布内容的EDS链接中。 例如，如果根文件夹为docs，而发布子文件夹为product-guide，则内容将发布到docs/contents/product-guide。

• 发布配置文件：​选择在上一部分中配置的GitHub或GitLab发布配置文件。

  {width="650"}

选择​保存，然后选择​生成输出。

转到您的GitHub存储库并打开blocks文件夹。

选择​ 痕迹导航 ​块。

{width="650"}

打开css文件并更新文本颜色。

将更改提交到GitHub。

刷新实时网站以查看更新。

打开主题文件并选择标记元素中的文本。

在以下屏幕截图中，选择了example标记中的内容。
{width="650"}

要配置example标记中的文本，请执行以下操作：

• 导航到​内容属性。
• 添加outputclass属性。
• 将其值设置为example eds-force-block。
• 选择​添加。
  {width="650"}

保存并重新生成输出。

在blocks目录中创建一个与outputclass同名的新文件夹。 了解将文件添加到存储库。

{width="650"}

添加必需的css和可选的js文件。

{width="650"}

提交更改并重新生成输出。