Experience Manager Guides和Edge Delivery Services

開啟Experience Manager Guides範本範本存放庫aem-guides-boilerplate。

使用此範本建立新的存放庫。 瞭解從範本建立存放庫。 確定存放庫可見性已設定為​公用，以便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"}

透過AEM程式碼同步🔗區段從連線GitHub至Adobe重複步驟2和3，以授權存放庫。

瀏覽至AEM程式碼同步頁面，並選取​安裝。

AEM Code Sync​會監視存放庫變更，並確保將更新正確推送至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金鑰。 若要支援2026.11.0版Experience Manager Guides as a Cloud Service中推出的未發佈功能，此金鑰為必要專案。 此外，如果內容大小超過100個檔案，則需要金鑰才能將內容發佈到EDS。

• 驗證認證：​根據選取的Git帳戶型別提供認證：

  • GitHub：​輸入從您的GitHub OAuth應用程式取得的​ 使用者端識別碼* 和​使用者端密碼*。 如需詳細資訊，請參閱建立新的OAuth應用程式。
  • GitLab：​請輸入為您的GitLab帳戶產生的​Access Token*。

（僅限GitHub）選取​ 登入 ​以進行驗證。 對於GitLab，不需要登入，因為存取權杖是用於驗證。

{width="650"}

選取「儲存」。 對於GitHub，在成功驗證後，儲存​選項即可使用。

在Map主控台中開啟地圖。

在​ 輸出預設集 ​索引標籤中，選取​ + ​以建立新的輸出預設集。

在​ 新輸出預設集 ​對話方塊中，提供下列詳細資料：

• 型別：選取​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"}

認可變更並重新產生輸出。