AEM允许您将页面导出为包含图像、.js和.css文件的完整网页。
配置导出后,您只需在浏览器中请求一个页面,方法是在URL中将html
替换为export.zip
,然后即可获取一个zip文件下载,其中包含以html格式呈现的页面和引用的资产。 页面中的所有路径(例如图像路径)都将被重写,以指向zip文件中包含的文件或服务器上的资源。
以下步骤描述如何导出页面,并假定您的站点存在导出配置模板。 配置模板可定义页面的导出方式,并特定于您的网站。 要创建配置模板,请参阅为您的站点创建页面导出器配置一节。
要导出页面,请执行以下操作:
在浏览器中,打开页面。 例如:
http://localhost:4502/content/geometrixx/en/products/triangle.html
打开页面属性对话框,选择Advanced选项卡并展开Export字段集。
单击放大镜图标,然后选择配置模板。 选择geometrixx模板,因为它是Geometrixx站点的默认模板。 单击确定。
单击确定以关闭页面属性对话框。
在URL中将html
替换为export.zip
来请求页面。
将<page-name>.export.zip
文件下载到您的文件系统。
在文件系统中,解压缩文件:
<page-name>.html
)位于<unzip-dir>/<page-path>
下方<unzip-dir>/etc
以下,有些位于<unzip-dir>/<page-path>
以下。在浏览器中打开页面html文件(<unzip-dir>/<page-path>.html
)以检查渲染。
页面导出器基于内容同步框架。 页面属性对话框中可用的配置是配置模板。 它们为页面定义了所有必需的依赖项。 触发页面导出时,将使用配置模板,并且页面路径和设计路径都会动态应用于配置。 然后,可使用标准的内容同步功能创建zip文件。
AEM嵌入了一些模板,包括:
默认值为/etc/contentsync/templates/default
。 此模板:
专用于Geometrixx站点的/etc/contentsync/templates/geometrixx
。 此模板可用作创建新模板的示例。
要创建页面导出器配置模板,请执行以下操作:
在CRXDE Lite中,创建/etc/contentsync/templates
下的节点:
mysite
。 选择页面导出器模板时,该名称会显示在页面属性对话框中。nt:unstructured
在模板节点(此处称为mysite
)下,使用下面描述的配置节点创建节点结构。
配置模板包含在节点结构中。 每个节点都有一个type
属性,该属性定义了在zip文件创建过程中执行的特定操作。 有关type属性的更多详细信息,请参阅内容同步框架页面中的配置类型概述一节。
以下节点可用于构建导出配置模板:
页面 节点页面节点用于将页面html复制到zip文件。具有以下特点:
/etc/contentsync/templates/<sitename>
下。page
。nt:unstructured
page
节点具有以下属性:
设置了值pages
的type
属性。
它没有path
属性,因为当前页面路径是动态复制到配置的。
其他属性在内容同步框架的配置类型概述部分中有介绍。
rewrite node重写节点定义链接在导出的页面中如何重写。重写的链接可以指向zip文件中包含的文件,也可以指向服务器上的资源。
有关rewrite
节点的完整说明,请参阅“内容同步”页面。
设计 节点设计节点用于复制用于导出页面的设计。具有以下特点:
/etc/contentsync/templates/<sitename>
下。design
。nt:unstructured
。design
节点具有以下属性:
将type
属性设置为值copy
。
它没有path
属性,因为当前页面路径是动态复制到配置的。
通用 节点通用节点用于将clientlibs .js或.css文件等资源复制到zip文件。具有以下特点:
/etc/contentsync/templates/<sitename>
下。nt:unstructured
。type
属性和任何type
相关属性,这些属性在内容同步框架的配置类型概述部分中定义。例如,以下配置节点将geometrixx clientlibs .js文件复制到zip文件:
"geometrixx.clientlibs.js": {
"extension": "js",
"type": "clientlib",
"path": "/etc/designs/geometrixx/clientlibs",
"jcr:primaryType": "nt:unstructured"
}
Geometrixx页面导出配置模板可向您显示如何配置页面导出。 要以json格式查看浏览器中模板的节点结构,请请求以下URL:
http://localhost:4502/etc/contentsync/templates/geometrixx.-1.json
实施自定义配置
如您在节点结构中所注意的, Geometrixx页面导出配置模板具有一个logo
节点,该节点的type
属性设置为image
。 这是一种特殊的配置类型,已创建此类型以将图像徽标复制到zip文件。 要满足某些特定要求,您可能需要实施自定义type
属性:为此,请参阅“内容同步”页面中的实施自定义更新处理程序一节。
要以编程方式导出页面,您可以使用PageExporter OSGI服务。 此服务允许您:
绑定到export
选择器和zip
扩展的Servlet使用PageExporter服务。
如果您在下载zip文件时遇到问题,可以删除存储库中的/var/contentsync
节点,然后再次发送导出请求。