将Plone网站部署为静态文件。
项目描述
概述
stxnext.staticdeployment 是一个将Plone网站部署为静态文件的工具。它支持Plone 3和Plone 4(包括使用Diazo主题的网站)。
安装
编辑buildout.cfg并在实例部分追加 stxnext.staticdeployment 到eggs和zcml参数
[instance] eggs = ... stxnext.staticdeployment zcml = ... stxnext.staticdeployment
实例必须重新构建和重启
./bin/buildout ./bin/instance stop ./bin/instance start
此产品还必须在Plone网站上安装。要执行此操作,请转到 网站设置 -> 添加/删除产品,选择 stxnext.staticdeployment 旁边的复选框,然后单击 安装 按钮。
配置
配置存储在INI文件中。默认配置包含在包中,但可以通过在 ${buildout:directory}/etc 文件夹中创建自定义的 staticdeployment.ini 文件来轻松覆盖。
存储在INI文件中
由网站开发者创建
可由多个网站使用
默认配置(包含在egg中)
默认配置可以通过 ${buildout:directory}/etc/staticdeployment.ini 文件覆盖
staticdeployment.ini 参数
- deployment-directory(字符串)
部署网站的位置。路径可以是相对的或绝对的。默认:./plone-static 如果路径是相对的,它将从
{buildout:directory}/var/instance)- 层接口 (字符串)
默认值: zope.publisher.interfaces.browser.IDefaultBrowserLayer
- 默认皮肤名称 (字符串)
部署时使用的皮肤。默认: Sunburst 主题
- deploy-plonesite (布尔值)
如果启用,主页也将作为 index.html 部署在 deployment-directory 的根目录下。默认: true
- deploy-registry-files (布尔值)
部署注册文件 (CSS, JS, KSS)?默认: true
- make-links-relative (布尔值)
使所有链接为相对链接(否则将为绝对链接)。默认: false
- add-index (布尔值)
将 index.html 添加到所有链接(应具有 index.html)。
- page-types (列表)
应部署的页面类型。例如: ATDocument, ATFolder
- file-types (列表)
应部署的文件类型。例如: ATBlob
- skinstool-files (列表)
应部署的附加文件(来自 plone_skins 工具)。例如: plone_images/favicon.ico
- additional-files (列表)
其他要部署的文件。例如: sitemap.xml.gz
- additional-pages (列表)
其他应部署的页面。例如: sitemap
- deployable-review-states (列表)
只有列在此处的审查状态的页面将被部署。默认: 已发布
- path-filter (字符串)
一个选项,用于仅部署给定路径下的内容。默认: 空字符串
- deployment-steps (列表)
可选的命名适配器列表(IPloneSiteRoot, IDeploymentStep),将在所有部署执行后调用。适配器将按此列表的顺序调用。
用法
当网站准备部署时,转到 网站设置 -> 静态部署 -> 部署 选项卡。选择 部署网站的静态版本 复选框并按 保存 按钮。部署可能需要几秒钟或几分钟(取决于网站大小和服务器性能)。
变更日志
1.1 (2013-08-20)
始终在相对于 $INSTANCE_HOME 的同一位置生成静态文件夹 [erral]
增加对部署步骤的日志记录 [erral]
针对单个对象部署选项的修复 [erral]
选项以部署给定路径下的所有内容。 [erral]
额外的 DeploymentSteps 现在根据配置文件中的开发者声明的顺序执行 [erral]
现在基于 portal_type 而不是 meta_type 搜索内容类型 [erral]
支持 Dexterity 对象和基于 plone.namedfile 的 blob [erral]
使用 lxml 解析链接代替 [vangheem]
1.0.4 (2013-03-27)
自动转换 /RSS 视图 [vangheem]
修复使用 plone.scale 图像缩放 [vangheem]
更多与 diazo 相关的修复 [vangheem]
创建一个假的请求,以便 diazo 规则可以利用路径变量。 [vangheem]
正确处理图像扩展名 [vangheem]
1.0.3 (2013-03-25)
更好的 Unicode 处理 [vangheem]
确保不要将HTML转换为CSS和JS资源 [vangheem]
修复diazo支持 [vangheem]
修复检索plone.resource文件 [vangheem]
修复在CSS中尝试解析数据图像 [vangheemj]
修复在CSS中使用相对路径 [vangheem]
修复缺少porltets的bug(感谢Alessandro Ruocco)
1.0.2 (12.07.2012)
修复提取图像缩放名称的bug
修复转换图像链接的方法
1.0.1 (03.07.2012)
修复Plone 4.1上Products.CMFCore的问题
1.0.0 (23.05.2012)
代码重构
与Plone 3的兼容性
创建测试
添加生成相对路径的可能性
早期变更历史:https://github.com/stxnext/stxnext.staticdeployment/blob/refactoring/docs/OLD_HISTORY.txt
stxnext.staticdeployment-1.1.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 68f2353d674cbd94da5b8028e6d7943add76e9ee51d2f3b58794c7a9b2085857 |
|
MD5 | ae22be9a2ccafd7d2ae1494b149da8a5 |
|
BLAKE2b-256 | 25574a57665114f7ffb4780da46807f923eb5e1638f7fd26119a830bf6682450 |