/django-wkhtmltopdf

Django Wrapper to the PDF Renderer: wkhtmltopdf

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

django-wkhtmltopdf

image

Converts html to PDF

Provides a thin wrapper to the wkhtmltopdf binary from http://code.google.com/p/wkhtmltopdf/

Requirements

Install the wkhtmltopdf binary. This requires libfontconfig (on Ubuntu: sudo aptitude install libfontconfig).

Python 2.6

Installation

Run pip install django-wkhtmltopdf.

Add 'wkhtmltopdf' to INSTALLED_APPS in your settings.py.

By default it will execute the first wkhtmltopdf command found on your PATH.

If you can't add wkhtmltopdf to your PATH, you can set WKHTMLTOPDF_CMD to a specific execuatable:

e.g.: in settings.py:

WKHTMLTOPDF_CMD = '/path/to/my/wkhtmltopdf'

or alternatively as env variable:

export WKHTMLTOPDF_CMD=/path/to/my/wkhtmltopdf

You may also set WKHTMLTOPDF_CMD_OPTIONS in settings.py to a dictionary of default command-line options.

The default is:

WKHTMLTOPDF_CMD_OPTIONS = {
    'quiet': True,
}