File: README.rst

package info (click to toggle)
django-wkhtmltopdf 3.3.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 192 kB
  • sloc: python: 791; makefile: 7
file content (69 lines) | stat: -rw-r--r-- 1,859 bytes parent folder | download | duplicates (3)
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.