aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
authorGeorge Hickman <george@ghickman.co.uk>2012-03-20 17:26:25 +0000
committerGeorge Hickman <george@ghickman.co.uk>2012-03-20 17:26:49 +0000
commitd3a3522cea3cf553ddf2f9345b01b548ddd6cf0c (patch)
tree58b720625f8e56466c7c498a81bbe1891a7bae59 /README.rst
parentdef2d8ddd05ae0b8526f8fa1ee80beea01006619 (diff)
downloaddjango-wkhtmltopdf-d3a3522cea3cf553ddf2f9345b01b548ddd6cf0c.tar.gz
django-wkhtmltopdf-d3a3522cea3cf553ddf2f9345b01b548ddd6cf0c.tar.bz2
django-wkhtmltopdf-d3a3522cea3cf553ddf2f9345b01b548ddd6cf0c.zip
Make the docs rest
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..8e978fe
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,34 @@
+django-wkhtmltopdf
+==================
+
+
+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 Ububtu: ``sudo aptitude install libfontconfig``).
+
+.. _wkhtmltopdf: http://code.google.com/p/wkhtmltopdf/downloads/list
+
+
+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'