xhtml2pdf-legacy 3.0.38

关于

xhtml2pdf 是一个使用ReportLab工具包、HTML5lib和pyPdf的html2pdf转换器。它支持HTML 5和CSS 2.1（以及一些CSS 3）。由于它是用纯Python编写的，因此它是跨平台的。

此工具的主要好处是，具有像HTML和CSS这样的Web技能的用户能够快速生成PDF模板，而无需学习新技术。

要求

1. Reportlab工具包 2.2+

2. html5lib 0.11.1+

3. pyPdf 1.11+（可选）

   所有要求均列在 requirements.txt 文件中。

开发环境

Python、virtualenv及其依赖项

1. 安装Python 2.6.x或2.7.x。安装步骤取决于您的操作系统。

2. 安装Pip，Python包安装程序

   sudo easy_install pip

   有关 pip 的更多信息，请参阅 http://www.pip-installer.org/。

3. 我建议在开发中使用 virtualenv。为每个项目拥有独立的环境非常棒，可以将多个项目的依赖项分开

   sudo pip install virtualenv

   有关 virtualenv 的更多信息，请参阅 http://www.virtualenv.org/

4. 为项目创建 virtualenv。这可以位于项目目录中，但不能位于版本控制之下

   virtualenv --distribute xhtml2pdfenv

5. 激活您的 virtualenv

   source xhtml2pdfenv/bin/activate

   稍后要取消激活，请使用

   deactivate

6. 下一步将是根据 requirements.txt 文件安装/升级依赖项

   pip install -r requirements.txt

7. 运行测试以检查您的配置

   nosetests --with-coverage

   您应该有成功状态的日志

   Ran 35 tests in 0.322s
   
   OK

Python 集成

有关如何将 xhtml2pdf 集成到 Python 程序中的简单示例，可以在以下位置找到：test/simple.py

贡献

该软件的开发在 github 上进行，主要分支目前在 https://github.com/chrisglass/xhtml2pdf

欢迎以任何格式贡献，但使用 github 的拉取请求系统是首选，因为它使审查和集成更加容易。

运行测试

有两个不同的测试套件可用于断言 xhtml2pdf 工作可靠

1. 单元测试。单元测试框架目前是最基本的，但每天都在改进（欢迎贡献）。它们应按照 Python 的 unittest 模块预期的方式运行，即

   nosetests --with-coverage (or your personal favorite)

2. 功能测试。多亏了 mawe42 的超级酷的工作，一个完整的功能测试套件位于 testrender/。

联系

• IRC：freenode 上的 #xhtml2pdf

• 邮件列表：xhtml2pdf@googlegroups.com

• Google group：http://groups.google.com/group/xhtml2pdf

维护者：Chris Glass <tribaal@gmail.com>

许可协议

版权 2010 Dirk Holtwick，holtwick.it

根据 Apache 许可证第 2.0 版（“许可证”）；除非您遵守许可证，否则不得使用此文件。您可以在以下位置获得许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或经书面同意，否则根据许可证分发的软件按“原样”分发的，不提供任何形式的保证或条件，无论是明示的还是暗示的。有关许可证的具体语言规定权限和限制，请参阅许可证。