Installation¶
djohno is available for install from PyPI:
pip install djohno
Once it’s in your virtualenv, add it to your INSTALLED_APPS
:
INSTALLED_APPS = (
...
'djohno',
)
Note
It’s important to make sure djohno
is listed after all other
apps which have templates you care about, since djohno includes
some templates that aren’t scoped to a djohno
subdirectory
(namely, 403.html
, 404.html
, 500.html
). You should have
other apps (or perhaps templates in TEMPLATE_DIRS
) which
provide those templates, so ensure those apps are listed before
djohno
. If you’re using templates for 403.html
et al in
TEMPLATE_DIRS
, make sure
'django.template.loaders.filesystem.Loader'
is listed before
'django.template.loaders.app_directories.Loader'
in your
TEMPLATE_DIRS
setting.
Once you’ve added djohno
to your INSTALLED_APPS
, add djohno to
your urls.py
:
urlpatterns = patterns(
'',
...
url(r'^djohno/', include('djohno.urls')),
)
Finally, you’ll need to deploy djohno’s static files, with:
python manage.py collectstatic
Usage¶
Once installed, simply visit djohno/
in your browser, and try the
links to the 403, 404, 500 and mail integration pages.
Supported Python and Django versions¶
Currently, djohno supports Django 1.4, 1.5, 1.6 and 1.7. Djohno follows Django’s lead in the versions of Python it supports (i.e. with Django 1.5 and above, djohno will support Python 3).