aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJames Turnbull <james@jamesturnbull.org>2012-02-24 02:29:59 -0800
committerJames Turnbull <james@jamesturnbull.org>2012-02-24 02:29:59 -0800
commit33d4528bc771ff0ef9bceda50e96f13bfaf685f3 (patch)
tree2557ebf17e99556a812397d45a07fa57d0a7b733 /README.md
parent6cf05d70a87cd33955670d43f14f28067f90379e (diff)
parentf1c26baeddb539d5eecdb8cb8d41eb723f5205e2 (diff)
downloaddjango-wkhtmltopdf-33d4528bc771ff0ef9bceda50e96f13bfaf685f3.tar.gz
django-wkhtmltopdf-33d4528bc771ff0ef9bceda50e96f13bfaf685f3.tar.bz2
django-wkhtmltopdf-33d4528bc771ff0ef9bceda50e96f13bfaf685f3.zip
Merge pull request #1 from incuna/develop
Merge in Develop branch
Diffstat (limited to 'README.md')
-rw-r--r--README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..219d4e1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+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](http://code.google.com/p/wkhtmltopdf/) binary.
+This requires libfontconfig (on Ububtu: `sudo aptitude install libfontconfig`).
+
+
+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'