跳转到主要内容

将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 如果路径是相对的,它将从 INSTANCEHOME{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),将在所有部署执行后调用。适配器将按此列表的顺序调用。

用法

当网站准备部署时,转到 网站设置 -> 静态部署 -> 部署 选项卡。选择 部署网站的静态版本 复选框并按 保存 按钮。部署可能需要几秒钟或几分钟(取决于网站大小和服务器性能)。

作者 & 联系方式

作者:
  • Igor Kupczyński <igor.kupczynski@stxnext.pl>

  • Radosław Jankiewicz <radoslaw.jankiewicz@stxnext.pl>

  • Wojciech Lichota <wojciech.lichota@stxnext.pl>

  • Sebastian Kalinowski <sebastian.kalinowski@stxnext.pl>

http://stxnext.pl/open-source/files/stx-next-logo

STX Next Sp. z o.o.

http://stxnext.pl

info@stxnext.pl

变更日志

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

由以下提供支持