aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
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'