文件AEM GuidesAEM Guides 文件

下載並安裝AEM Sites範本

最後更新： 2026年4月28日

建立對象：

  • Experienced
  • Admin

本指南提供逐步指示，說明如何設定並設定最新的AEM Guides範本，以在雲端環境中產生AEM Sites頁面。 請依照下列步驟安裝所需的套件、建立和設定預設集，以及產生AEM Sites。

先決條件

下列標籤會根據您的Experience Manager Guides設定提供必要必要條件：Cloud Service或內部部署。

Cloud Service

  • 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
內部部署

  • Adobe Experience Manager (AEM)：​已安裝​Service Pack 21、20和19及​ AEM 4.6.0 ​或更新版本的​ AEM Guides 6.5 ​的執行中執行個體。

  • 必要的許可權：請確定擁有下列許可權：

    • 存取​ 軟體發佈入口網站 ​以下載必要的封裝
    • 存取​ CRX封裝管理員 ​以在AEM中安裝封裝。
    • 在AEM Guides中建立和修改預設集的許可權。

  • 下載封裝：從​ 軟體發佈入口網站 ​下載下列封裝：

    • 元件套件： on-prem-guides-components.all-1.x.0.zip
    • Sites套件： aemg-docs.all-1.x.0.zip

套件安裝

下列標籤會根據您的Experience Manager Guides設定，提供套件安裝的指示： Cloud Service或內部部署。

Cloud Service

安裝​ 元件套件(guides-components.all-1.x.x.zip) ​並執行下列步驟

  1. 複製Git存放庫：

    1. 導覽至Cloud Manager左側面板中的​存放庫。

    2. 選取​ 存取存放庫資訊 ​並複製Git Clone命令。

      選取存取存放庫資訊 {align="left" width="350"}

    3. 使用提供的使用者名稱和密碼將存放庫複製到本機系統（必要時產生密碼）。

  2. 將套件新增至Maven套件組合：

    1. 在您的本機複製存放庫中，建立新的Maven套件組合或新增到現有的套件組合中。

    2. 請確定Maven專案中存在結構/jcr_root/apps/fmdita/安裝。

      Maven專案中的結構 {align="left" width="650"}

    3. 將下載的guides-components.all-1.x.x.zip檔案放入安裝資料夾中。

  3. 更新篩選器.xml：

    1. 開啟位於上層內容目錄META-INF資料夾中的filters.xml檔案。

    2. 新增下列篩選器：篩選器根=/apps/fmdita mode=merge/

      新增篩選器 {align="left" width="650"}

  4. 設定pom.xml：​根據您的環境需求更新pom.xml檔案。

  5. 推送變更並執行管道：

    1. 將變更推送至主要Git存放庫。
    2. 導覽至Cloud Manager中的​管道，然後針對所需的環境執行管道。

  6. 確認安裝：​部署完成後，元件套件將會安裝在AEM Cloud環境中。

內部部署

  1. 安裝元件封裝：

    1. 瀏覽至​CRX封裝管理員。
    2. 上傳並安裝on-prem-guides-components.all-1.x.0.zip套件。

  2. 安裝Sites封裝：​使用CRX封裝管理員上傳並安裝aemg-docs.all-1.x.0.zip封裝。

使用已安裝的範本建立網站（適用於Cloud Service）

  1. 匯入網站範本：

    1. 前往AEM Sites頁面(servername/sites.html/content)。
    2. 從範本中選取​建立 > 網站。
    3. 使用​ 匯入 ​選項匯入網站範本aemg-docs-1.x.x.zip。

  2. 選取範本：​選取​AEMG Docs 1.x.x，然後選取​下一步。

  3. 輸入網站詳細資料：​輸入​ 網站標題 ​和​網站名稱。

    建立網站 {align="left" width="350"}

  4. 選取「建立」。

建立AEM網站預設集

  1. 建立新的預設集：

    1. 在AEM Guides中開啟DITA map並導覽至​ 輸出 ​面板。

    2. 選取​建立預設集。

    3. 選取型別為​AEM Sites。

    4. 輸入預設集名稱。

    5. 取消勾選​ 使用舊版元件對應 ​設定。

    6. 選取​ 新增 ​以建立預設集。

      建立新的AEM網站預設集 {align="left" width="350"}

  2. 設定AEM網站預設集：​有兩個選項可設定現成可用的網站(OOTB)：

    選項1：使用網站下拉式清單

    1. 選取​ 網站 ​作為上面建立的網站（例如AEMG檔案網站）。

    2. 驗證​ 發佈路徑 ​和​ 主題頁面 ​範本是否自動設定為：

      • 發佈路徑： Cloud Service： /content/AEMG-Docs-Site/en/docs/product以及內部部署： aemg-docs/en/docs/product1
      • 主題頁面範本：主題頁面

      使用網站下拉式清單來設定AEM網站 {align="left" width="350"}

    選項2：使用網站路徑

    1. 手動將​ 網站路徑 ​設為Cloud Service的/content/AEMG-Docs-Site/en/docs/product和內部部署的/content/aemg-docs/en/docs/product1。

    2. 確認​ 主題頁面 ​範本已自動設定為主題頁面。

      若為Cloud Service：

      使用網站路徑設定AEM網站 {align="left" width="650"}

      針對內部部署：

      使用網站路徑 {align="left" width="350"}

  3. 儲存預設集：​儲存對預設集所做的變更。

產生AEM Sites

  1. 產生網站：

    1. 設定預設集後，為對應的DITA map產生AEM網站。
    2. 產生的網站將可在以下路徑使用： /content/AEMG-Docs-Site/en/docs/product （適用於Cloud Service）和/content/aemg-docs/en/docs/product1 （適用於On-Premise）。

  2. 變更預設產生路徑（選用）：​若要變更網站產生的預設路徑，請執行下列步驟：

    1. 導覽至​AEM Sites。

    2. 在OOTB網站結構下建立新產品頁面。

    3. 導覽至​AEMG檔案 > 英文 > 檔案。

      建立頁面 {align="left" width="650"}

    4. 選取​ 首頁 ​圖磚，然後選取​下一步。

      選取主圖磚 {align="left" width="650"}

    5. 輸入頁面的​ 標題 ​和​名稱。

    6. 選取「建立」。

NOTE
針對Cloud Service設定，請確保所有設定在部署到生產環境之前都在非生產環境中測試。

如需詳細資訊，請參閱正式部署至AEM as a Cloud Service檔案。
recommendation-more-help
experience-manager-guides-help-product-guide