頁面匯出工具

AEM可讓您將頁面匯出為完整的網頁,包括影像、 .js.css 檔案。

設定後,您會以取代 html with export.zip 中。 這會產生封存(zip)檔案,其中包含以html格式呈現的頁面,以及參照的資產。 頁面中的所有路徑(例如,到影像的路徑)都會被重寫,以指向包含在存檔中的檔案,或指向伺服器上的資源。 然後,您就可以從瀏覽器下載封存(zip)檔案。

注意

視您的瀏覽器和設定而定,下載會是:

  • 存檔檔案(<page-name>.export.zip)
  • 資料夾(<page-name>);有效地擴展了歸檔檔案

匯出頁面

下列步驟說明如何匯出頁面,並假設您的網站有匯出範本。 匯出範本會定義頁面的匯出方式,且是您網站專屬的。 若要建立匯出範本,請參閱 為您的網站建立頁面匯出工具組態 區段。

要導出頁面,請執行以下操作:

  1. 導覽至 網站 控制台。

  2. 選取頁面,然後開啟 屬性 對話框。

  3. 選取 進階 標籤。

  4. 展開 匯出 欄位來選取匯出範本。
    選取網站所需的範本,然後使用 確定.

  5. 選擇 儲存並關閉 以關閉頁面屬性對話方塊。

  6. 請求要匯出的頁面,取代尾碼 html with export.zip 中。

    例如:

    • localhost:4502/content/we-retail/language-masters/en.html

    可透過下列方式存取:

    • localhost:4502/content/we-retail/language-masters/en.export
  7. 將存檔檔案下載到檔案系統。

  8. 在您的檔案系統中,視需要解壓縮檔案。 展開後,會出現與所選頁面同名的資料夾。 此資料夾包含:

    • 子資料夾 content,這是反映存放庫中頁面路徑的一系列子資料夾的根目錄

      • 在此結構中,會有選定頁面的html檔案(<page-name>.html)
    • 其他資源(.js 檔案, .css 檔案、影像等) 是根據匯出範本中的設定來定位

  9. 開啟頁面html檔案(<unzip-dir>/<path>/<to>/<page>/<page-path>.html)以檢查呈現。

為您的網站建立頁面匯出工具組態

頁面匯出器以 內容同步架構. 中可用的設定 頁面屬性 對話方塊是匯出範本,用於定義頁面所需的相依性。

觸發頁面匯出時,會參考匯出範本,並動態套用頁面路徑和設計路徑。 然後會使用標準的「內容同步」功能來建立zip檔案。

現成可用的AEM安裝包含下方的預設範本 /etc/contentsync/templates/default.

  • 若儲存庫中找不到匯出範本,此範本即為後援範本。

  • default 範本會顯示如何設定頁面匯出,因此可作為新匯出範本的基礎。

  • 若要以JSON格式檢視瀏覽器中範本的節點結構,請要求下列URL:
    http://localhost:4502/etc/contentsync/templates/default.json

建立新頁面匯出器範本最簡單的方法是:

  • 複製 default 範本,

  • 為您的網站指派合適的新名稱,

  • 然後進行必要的更新。

若要建立全新範本:

  1. CRXDE Lite,請在下方建立節點 /etc/contentsync/templates:

    • Name:與您的網站相稱的名稱;例如, <mysite>. 選擇頁面導出器模板時,該名稱將出現在頁面屬性對話框中。

    • Type: nt:unstructured

  2. 在範本節點下方,在此處呼叫 mysite,請使用下述設定節點建立節點結構。

為頁面啟用頁面匯出工具範本

設定範本後,您必須讓範本可供使用:

  1. 在CRXDE中,導覽至 /content 分支。 這可以是個別頁面,或子樹的根頁面。

  2. jcr:content 頁面的節點建立屬性:

    • Name: cq:exportTemplate
    • Type: String
    • Value:範本路徑;例如: /etc/contentsync/templates/mysite

頁面導出器配置節點

範本由節點結構組成,因為它使用 內容同步架構. 每個節點都有 type 定義zip檔案建立程式中特定動作的屬性。

以下節點可用來建立匯出範本:

  • page
    頁面節點可用來將頁面html複製到zip檔案。 其特點如下:

    • 是強制節點。
    • 位於下方 /etc/contentsync/templates/<mysite>.
    • 使用屬性定義 Name設為 page.
    • 節點類型為 nt:unstructured

    page 節點具有以下屬性:

    • A type 以值設定的屬性 pages.

    • 沒有 path 屬性,因為目前頁面路徑會動態複製到設定。

  • rewrite
    重寫節點定義如何在匯出的頁面中重寫連結。 重寫的連結可以指向zip檔案中包含的檔案或指向伺服器上的資源。

  • design
    設計節點用於複製用於導出頁面的設計。 其特點如下:

    • 為選用。
    • 位於下方 /etc/contentsync/templates/<mysite>.
    • 使用屬性定義 Name 設為 design.
    • 節點類型為 nt:unstructured.

    design 節點具有以下屬性:

    • A type 屬性設為值 copy.

    • 沒有 path 屬性,因為目前頁面路徑會動態複製到設定。

  • generic
    一般節點可用來複製clientlibs等資源
    .js.css 檔案。 其特點如下:

    • 為選用。
    • 位於下方 /etc/contentsync/templates/<mysite>.
    • 沒有特定名稱。
    • 節點類型為 nt:unstructured.
    • type 屬性與 type 相關屬性。

    例如,下列設定節點會複製 mysite.clientlibs.js 檔案到zip檔案:

    "mysite.clientlibs.js": {
        "extension": "js",
        "type": "clientlib",
        "path": "/etc/designs/mysite/clientlibs",
        "jcr:primaryType": "nt:unstructured"
    }
    

實作自訂設定

您也可以進行自訂設定。

為了符合某些特定需求,您可能需要實作 自訂更新處理常式.

以程式設計方式匯出頁面

若要以程式設計方式匯出頁面,您可以使用 PageExporter OSGI服務。 此服務可讓您:

  • 匯出頁面並寫入HTTP servlet回應。
  • 匯出頁面並在特定位置儲存zip檔案。

系結至 export 選取器和 zip 擴充功能使用PageExporter服務。

疑難排解

如果您在下載zip檔案時遇到問題,可以刪除 /var/contentsync 節點,並再次傳送匯出請求。

本頁內容