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).