1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
django-wkhtmltopdf
==================
.. image:: https://badge.fury.io/py/django-wkhtmltopdf.png
:target: http://badge.fury.io/py/django-wkhtmltopdf
:alt: Latest version
.. image:: https://travis-ci.org/incuna/django-wkhtmltopdf.png?branch=master
:target: https://travis-ci.org/incuna/django-wkhtmltopdf
:alt: Travis-CI
.. image:: https://img.shields.io/pypi/dm/django-wkhtmltopdf.svg
:target: https://badge.fury.io/py/django-wkhtmltopdf
:alt: Number of PyPI downloads on a month
Converts HTML to PDF
--------------------
Provides Django views to wrap the HTML to PDF conversion of the `wkhtmltopdf <http://wkhtmltopdf.org>`_ binary.
Requirements
------------
Install the `wkhtmltopdf static binary <http://wkhtmltopdf.org/downloads.html>`_.
This requires libfontconfig (on Ubuntu: ``sudo aptitude install libfontconfig``).
Python 2.6+ and 3.3+ are supported.
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 executable:
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,
}
Documentation
-------------
Documentation is available at http://django-wkhtmltopdf.readthedocs.org/en/latest/.
License
-------
BSD-2-Clause licensed. See the bundled `LICENSE <https://github.com/incuna/django-wkhtmltopdf/blob/master/LICENSE>`_ file for more details.
|
