Skip to content

wanderijames/django-sendpdf

Repository files navigation

Sendpdf

Sendpdf is a simple Django app that can be used to generate PDF documents from html templates.

It can handle images and css very well. The generated PDF can then be displayed in the browser for printing and saving.

Alternatively, one can send the PDF to one or many email addresses.

Has been tested with Django 3+. Versions prior to 2.0.0 has been tested with Django==1.9.

Detailed documentation is in the official page.

Checkout the latest code in the repo wanderijames/django-sendpdf and use docker and docker compose to test its functionality.

Quick start

  1. Install django-sendpdf:
$ pip install django-sendpdf
  1. Install wkhtmltopdf:
  • Debian/Ubuntu:
$ sudo apt-get install wkhtmltopdf

Warning! Version in debian/ubuntu repos have reduced functionality (because it compiled without the wkhtmltopdf QT patches), such as adding outlines, headers, footers, TOC etc. To use this options you should install static binary from wkhtmltopdf site or you can use this script.

  • Windows and other options: check wkhtmltopdf homepage for binary installers
  1. Add "sendpdf" to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = (
        ...
        'sendpdf',
    )
  2. In your Django settings add the location of wkhtmltopdf, default location is /usr/local/bin/wkhtmltox/bin/wkhtmltopdf, like this:

    WKTHMLTOPDF_PATH = "/usr/local/bin/wkhtmltopdf"
  3. Include the sendpdf URLconf in your project urls.py like this:

    path(r'^sendpdf/', include('sendpdf.urls', namespace='sendpdf')),
  4. Run python manage.py runserver to see some demos:

    Template example

    View PDF inline

    Dewnload PDF

    Send PDF

About

Sendpdf is a simple Django app that can be used to generate PDF documents from html templates.

Resources

License

Stars

Watchers

Forks

Packages

No packages published