Show Menu
主題×

頁面匯出器

AEM可讓您將頁面匯出為完整的網頁,包括影像 .js .css 檔案。
在設定後,您會以URL中的取代,從瀏覽器 html 請求 export.zip 頁面匯出。 這會產生封存(zip)檔案,其中包含以html格式呈現的頁面,以及參考的資產。 頁面中的所有路徑(例如,到映像的路徑)都會被重寫,以指向歸檔檔案中包含的檔案或伺服器上的資源。 然後,可從您的瀏覽器下載封存(zip)檔案。
! 視您的瀏覽器和設定而定,下載內容會是:
  • 檔案( <page-name>.export.zip )
  • 資料夾( <page-name> ); 有效地擴展了歸檔檔案

匯出頁面

下列步驟說明如何匯出頁面,並假設您的網站存在匯出設定範本。 設定範本會定義匯出頁面的方式,且是您網站專屬的。 要建立配置模板,請參 閱為站點建立頁導出器配置
若要匯出頁面:
  1. 導覽至所需頁面,選取頁面,然後開啟「屬 」對話方塊。
  2. 選擇「高 」頁籤。
  3. 展開「 導出 」欄位以選擇配置模板。 選取您網站的必要範本,然後使用「確定」 確認
  4. 選擇 「保存並關閉 」以關閉頁面屬性對話框。
  5. 請求要匯出的頁面,在URL中 html export.zip 代字尾。
    例如:
    • localhost:4502/content/we-retail/language-masters/en.html
    存取方式:
    • localhost:4502/content/we-retail/language-masters/en.export.zip
  6. 將存檔檔案下載到檔案系統。
  7. 在您的檔案系統中,視需要解壓縮檔案。 展開後,會有與選取頁面同名的檔案夾。 此資料夾包含:
    • 子資料夾 content ,它是反映儲存庫中頁面路徑的一系列子資料夾的根
    • 在此結構中,有選定頁面的html檔案( <page-name>.html )
    • 其他資源( .js 檔案、 .css 檔案、影像等) 是根據匯出範本中的設定所定位
  8. 在瀏覽器中開啟頁面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中,導覽至所需頁面。
  2. 在節點 jcr:content 上建立屬性:
    • Name : cq:exportTemplate
    • Type : String
    • Value : 範本路徑; 例如: /etc/contentsync/templates/mysite

頁面導出器配置節點

模板由節點結構組成。 每個節點都有 type 一個屬性,可定義zip檔案建立過程中的特定操作。 有關type屬性的詳細資訊,請參閱「內容同步框架」頁中的「配置類型概述」部分。
以下節點可用於構建導出配置模板:
  • page 頁面節點用於將頁面html複製到zip檔案。 它具有以下特點:
    • 是強制節點。
    • 位於下方 /etc/contentsync/templates/<sitename>
    • 其名稱為 page
    • 其節點類型為 nt:unstructured
    page 點具有以下屬性:
    • type 值一起設定的屬性 pages
    • 它沒有屬性, path 因為目前頁面路徑會動態複製至設定。
    • 其他屬性在Content Sync框架的「配置類型概述」部分中介紹。
  • rewrite 重寫節點定義如何在導出的頁面中重寫連結。 重寫的連結可以指向包含在zip檔案中的檔案或指向伺服器上的資源。
    請參閱「內容同步」頁面,以取得節點的完整說 rewrite 明。
  • design 設計節點用於複製用於導出頁面的設計。 它具有以下特點:
    • 是可選的。
    • 位於下方 /etc/contentsync/templates/<sitename>
    • 其名稱為 design
    • 其節點類型為 nt:unstructured
    design 點具有以下屬性:
    • type 置為值的屬性 copy
    • 它沒有屬性, path 因為目前頁面路徑會動態複製至設定。
  • generic 一般節點可用來將clientlibs .js或。css檔案等資源複製至zip檔案。 它具有以下特點:
    • 是可選的。
    • 位於下方 /etc/contentsync/templates/<sitename>
    • 沒有特定名稱。
    • 其節點類型為 nt:unstructured
    • 具有Content type Sync框架 type 的「配置類型概述」部分中定義的屬性和任何相關屬性。
    例如,以下配置節點將文 mysite.clientlibs.js 件複製到zip檔案:
    "mysite.clientlibs.js": {
        "extension": "js",
        "type": "clientlib",
        "path": "/etc/designs/mysite/clientlibs",
        "jcr:primaryType": "nt:unstructured"
    }
    
    
實作自訂設定
您也可以使用自訂設定。
為符合某些特定需求,您可能需要實作自訂屬 type 性: 若要這麼做,請參閱「內容同步」頁面中的「實作自訂更新處理常式」區段。

以程式設計方式匯出頁面

若要以程式設計方式匯出頁面,您可以使 用PageExporter OSGI服務。 此服務可讓您:
  • 匯出頁面並寫入HTTP servlet回應。
  • 匯出頁面,並將zip檔案儲存在特定位置。
綁定到選擇器和擴展 export 名的Servlet使 zip 用PageExporter服務。

疑難排解

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