aboutsummaryrefslogtreecommitdiffstats
path: root/docs/settings.rst
diff options
context:
space:
mode:
authorSimon Law <simon.law@ecometrica.com>2012-07-25 15:40:01 -0400
committerSimon Law <simon.law@ecometrica.com>2012-07-25 15:40:01 -0400
commit85daece4ed63036ef9906d795c5e1cbe38253800 (patch)
tree0e3a6f7385434a14f138fc4c241f316379a7afb8 /docs/settings.rst
parent0abefd41b70b4e8afefb61d725a88f9728625fbf (diff)
downloaddjango-wkhtmltopdf-85daece4ed63036ef9906d795c5e1cbe38253800.tar.gz
django-wkhtmltopdf-85daece4ed63036ef9906d795c5e1cbe38253800.tar.bz2
django-wkhtmltopdf-85daece4ed63036ef9906d795c5e1cbe38253800.zip
Documentation updates for new and updated behaviour.
Diffstat (limited to 'docs/settings.rst')
-rw-r--r--docs/settings.rst69
1 files changed, 69 insertions, 0 deletions
diff --git a/docs/settings.rst b/docs/settings.rst
new file mode 100644
index 0000000..7b5116a
--- /dev/null
+++ b/docs/settings.rst
@@ -0,0 +1,69 @@
+Settings
+========
+
+Available settings
+------------------
+
+Here's a full list of available settings,
+in alphabetical order,
+and their default values.
+
+WKHTMLTOPDF_CMD
+~~~~~~~~~~~~~~~
+
+Default: ``'wkhtmltopdf'``
+
+The name of the ``wkhtmltopdf`` binary.
+
+If there are no path components,
+this app will look for the binary using the default OS paths.
+
+WKHTMLTOPDF_CMD_OPTIONS
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Default: ``{'quiet': True}``
+
+A dictionary of command-line arguments to pass to the ``wkhtmltopdf``
+binary.
+Keys are the name of the flag and values are arguments for the flag.
+
+To pass a simple flag,
+for example:
+``wkhtmltopdf --disable-javascript``:
+
+.. code-block:: python
+
+ WKHTMLTOPDF_CMD_OPTIONS = {'disable-javascript': True}
+
+To pass a flag with an argument,
+for example:
+``wkhtmltopdf --title 'TPS Report'``:
+
+.. code-block:: python
+
+ WKHTMLTOPDF_CMD_OPTIONS = {'title': 'TPS Report'}
+
+
+WKHTMLTOPDF_DEBUG
+~~~~~~~~~~~~~~~~~
+
+Default: same as :py:data:`settings.DEBUG`
+
+A boolean that turns on/off debug mode.
+
+WKHTMLTOPDF_ENV
+~~~~~~~~~~~~~~~
+
+Default: ``None``
+
+An optional dictionary of environment variables to override,
+when running the ``wkhtmltopdf`` binary.
+Keys are the name of the environment variable.
+
+A common use of this is to set the ``DISPLAY`` environment variable
+to another X server,
+when using ``wkhtmltopdf --use-xserver``:
+
+.. code-block:: python
+
+ WKHTMLTOPDF_ENV = {'DISPLAY': ':2'}