django-easy-pdf 0.1.1

开发版本

注意：开发分支下正在开发使用WeasyPrint进行更精确渲染的新PDF渲染后端。有关更改、测试和讨论，请参阅https://github.com/nigma/django-easy-pdf/pull/34。

如果您依赖于渲染后端，并且模板将包版本固定到=0.1.1<0.2.0>。

概述

此应用程序使得在Django中渲染PDF文件变得非常简单。它可以用来创建发票、账单和其他文档，只需简单的HTML标记和CSS样式。您甚至可以嵌入图像并使用自定义字体。

该库提供基于类的视图，几乎可以替换Django的，以及用于在请求作用域之外（即使用Celery工作进程）渲染PDF的帮助函数。

快速入门

1. 将和包含在您的文件中。如果您使用Python 3，则需要安装Reportlab的最新版本和xhtml2pdf的测试版。

   $ pip install xhtml2pdf>=0.2b1

2. 将添加到。

3. 为PDF文档创建HTML模板，并添加一个将渲染它的视图

   {% extends "easy_pdf/base.html" %}
   
   {% block content %}
       <div id="content">
           <h1>Hi there!</h1>
       </div>
   {% endblock %}

   from easy_pdf.views import PDFTemplateView
   
   class HelloPDFView(PDFTemplateView):
       template_name = 'hello.html'

4. 您还可以使用混入（mixin）从Django通用视图中输出PDF。

   class PDFUserDetailView(PDFTemplateResponseMixin, DetailView):
       model = get_user_model()
       template_name = 'user_detail.html'

文档

完整文档请参阅 django-easy-pdf.readthedocs.io。

实时演示请访问 easy-pdf.herokuapp.com。安装依赖后，您可以通过从克隆的仓库运行 python demo.py 脚本或在Docker中运行 make demo 来本地运行它。

依赖项

django-easy-pdf 依赖于以下项：

• django>=1.10

• xhtml2pdf>=0.2b1

• reportlab

许可

django-easy-pdf 采用MIT许可证发布。

其他资源

• GitHub仓库 - https://github.com/nigma/django-easy-pdf

• PyPi软件包站点 - https://pypi.python.org/pypi/django-easy-pdf

• 文档 - https://django-easy-pdf.readthedocs.io/

商业支持

这个应用和许多其他应用帮助我们构建更好的软件，并专注于更快地交付高质量的项目。我们非常愿意帮助您完成下一个项目，所以请通过发送电子邮件到 en@ig.ma 与我们联系。

历史记录