跳转到主要内容

将Plone内容视图下载为PDF

项目描述

描述

aws.pdfbook 是一个适用于Plone 3或Plone 4的组件,允许将内容渲染为PDF进行下载。它支持默认内容类型。第三方内容类型作者和集成者可以通过专门的Zope 3命名视图添加对个人内容类型的支持。

下载文件夹或主题/集合时,所有子内容都包含在PDF文档中,但不递归。

要求

应安装以下软件

  • 已测试与Plone 3.x、Plone 4.0、Plone 4.1兼容。

  • htmldoc (必需)

  • recode (可选)

安装

实例范围

在你的 buildout.cfg 文件中

[buildout]
...
eggs =
  ...
  aws.pdfbook

我们假设

  • 网站字符集为 utf-8

  • 服务器下载缓冲区为 40000 字节。

否则,你可以通过以下方式在您的 zope.confbuildout.cfg 中更改这些默认值

[instance]
recipe = plone.recipe.zope2instance
...
zope-conf-additional =
  ...
  <product-config aws.pdfbook>
  # Your site charset (default: utf-8)
  site-charset utf-8
  # The download buffer bytes size (default: 40000)
  download-buffer-size 40000
  </product-config>
  ...

Plone 网站

在您的 Plone 网站中,转到“网站设置”页面,然后单击“添加/删除产品”链接。

选择 aws.pdfbok(勾选复选框)并单击“安装”按钮。

尽快转到 PDF 书 配置面板,并根据您的系统设置和布局偏好进行配置。

更具体地说,您可以更改默认的 pdfbook 选项。有关各种可用选项的文档,请参阅pdfbook 文档

如果您想在页眉中使用徽标,只需在“徽标路径”字段中设置获取徽标的路径即可。不要在 htmldoc 选项中设置 –logo 选项,这是由系统完成的。但您可以使用 –webpage 选项。

其他设置

强烈建议在您的视觉编辑器偏好中启用与 UID 的链接。否则,图像可能在主题打印中不显示。

开发者

在 ZMI 中自定义默认模板

在 ZMI 中打开您的 Plone 网站,然后是 portal_view_customization 对象。

单击一个链接 printlayout,该链接适合您想要定制的内容项的界面。

按您喜欢的样子更改模板...

为您的内容类型添加模板

假设您有一个实现 myproduct.interfaces.IMyContentType 接口的个人内容类型,您必须添加一个如下所示的视图

<browser:page
   name="printlayout"
   for="myproduct.interfaces.IMyContentType"
   layer="aws.pdfbook.interfaces.IAWSPDFBookLayer"
   permission="zope.Public"
   template="templates/mycontenttype.pt"
   />

保留以下属性,如下所示

  • name="printlayout"

  • layer="aws.pdfbook.interfaces.IAWSPDFBookLayer"

  • permission="zope.Public"

标准内容类型的示例在 browser/transformers.zcml 配置和相关文件中提供。

否则,aws.pdfbook 提供了一个默认模板,该模板可能与纸张布局不匹配。

如果个人或第三方内容类型的默认布局很糟糕,您可以在配置面板中将该内容类型列入黑名单。

贡献者

此组件的 GitHub 存储库为 git@github.com:collective/aws.pdfbook.git。

开发套件包含适用于最新 Plone 稳定版本的 buildout.cfg

请记住在 docs/HISTORY.txt 文件中记录您的更改。

支持

请使用http://plone.org/products/aws.pdfbook/issues 上的跟踪器。

鸣谢

http://www.materis.com/template/imgs_fr/logo.gif

变更日志

1.1 (2014-02-26)

  • 在 pdf 中保留 &、< 和 > 字符。 [vincentfretin]

  • 将 Unicode 的破折号替换为简单的 ASCII 破折号。之前在 PDF 中破折号字符被替换为‘?’。[vincentfretin]

  • 添加了‘logo’属性,允许我们在标题中使用 htmldoc 标志选项。[thomasdesvenain]

  • 巴西语翻译。[lepri]

1.0.3 (2013-08-27)

  • 修复了发布版本。

1.0.2 (2013-08-27)

  • 修复了获取图像比例。[thomasdesvenain]

  • Plone 4.3 兼容性。[thomasdesvenain]

1.0.1 (2011-12-22)

  • 在 PDF 中导出 FSImage。[vincentfretin]

  • 修复了 Windows 单引号和‘…’字符的转码。[vincentfretin]

  • 将 atevent.pt 与最新的事件视图模板 Products.CMFPlone 中的 event_view.pt 同步,以确保消息正确翻译。[vincentfretin]

  • 如果 img 标签没有 src 属性,则避免在转换时发生站点错误…[thomasdesvenain]

1.0.0 (2011-09-22)

  • 如果用户没有查看权限,则不会导出图像。[thomasdesvenain]

  • 图像导出适用于带尺寸的引用图像。图像以正确的大小打印。[thomasdesvenain]

  • 禁用门户工厂中的导出链接。[thomasdesvenain]

  • 避免视图小部件 kss 更新失败。[thomasdesvenain]

  • 图像导出适用于图像自定义类型和 blob 图像。因此,现在在 Plone 4 下图像导出工作。[thomasdesvenain]

  • Plone 4.1 兼容性。[thomasdesvenain]

1.0.0b1

  • 国际化并添加了法语翻译 [glenfant]

  • 单元测试 [glenfant]

  • 清理了来自 Products.PDFBook 的无用代码 [glenfant]

1.0.0a1

  • 初始发布 [glenfant]

项目详情


下载文件

下载适用于您平台文件的文件。如果您不确定选择哪个,请了解有关 安装软件包 的更多信息。

源分布

aws.pdfbook-1.1.zip (49.2 kB 查看散列)

上传时间

支持者

AWSAWS云计算和安全赞助商DatadogDatadog监控FastlyFastlyCDNGoogleGoogle下载分析MicrosoftMicrosoftPSF赞助商PingdomPingdom监控SentrySentry错误日志StatusPageStatusPage状态页