Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Easily integrate Sphinx documentation into your website.

Project Description

This Django application allows you to integrate any Sphinx documentation directly into your Django powered website instead of just serving the static files.

Django-sphinxdoc can handle multiple Sphinx projects and offers a Haystack powered search.


This app requires Django >= 1.8, Sphinx >= 1.0 and Haystack >= 2.1.


Just use PIP:

$ pip install django-sphinxdoc

If you want the latest development version, install it from Bitbucket with:

$ pip install


$ hg clone ssh://
$ pip install -e django-sphinxdoc


The documentation can be found in the docs/ directory or at

Changelog for django-sphinxdoc

v1.5.1 – 2016-12-07:

  • [FIX] Fix last release

v1.5.0 – 2016-12-07:

  • [CHANGE] Minimal supported Django version is 1.8
  • [NEW] Tests with pytest and tox
  • [FIX] Refactorings and clean-ups

v1.4.2 – 2016-10-26:

  • [CHANGE] Replaced string URLs with URL objects. Django no longer supports strings.

v1.4.1 – 2016-09-18:

  • [CHANGE] Removed support for Django < 1.6
  • [CHANGE] Added migrations to ease future upgrades.
  • [CHANGE] Updated README.txt with link to online documentation.
  • [NEW] Setting SPHINXDOC_BASE_TEMPLATE in allows overriding of the base template used for documentation.
  • [FIX] UnicodeDecodeError when editing or creating a new project.

v1.4 – 2014-12-14:

  • [NEW] Support for Python 3 (3.3 and above)

v1.3 – 2014-03-05:

  • [NEW] Projects can now be protected authentication.

v1.2.1 – 2013-12-20:

  • [NEW] Option --all to update docs for all projects
  • [NEW] Filters for the project admin
  • [FIX] Titles for generated domain indexes

v1.2 – 2013-08-11:

  • [NEW] I18n and l10n for Spanish and Basque, by Ales Zabala Alava
  • [CHANGE] Use class-based views, by Josiah Klassen
  • [CHANGE] Migration to Haystack 2, by Andres Riancho
  • [FIX] Inclusion of search index template in package, by Mike Shantz

v1.1 – 2012-04-19:

  • [NEW] Support static and download files.
  • [NEW] Additional context to search view so that project information is available in the template.
  • [CHANGE] Updated some templates
  • [FIX] Fixed a bug with the updatedoc command and ~ in paths.
  • [FIX] Include all module index files.
  • [FIX] Improved indexing behaviour
  • [FIX] Improved behaviour when building the docs.

v1.0.0 – 2010-09-11:

  • [NEW] Documentation can be searched via Haystack. The new management command updatedoc imports the JSON files into the database and updates Haystack’s search index.
  • [CHANGE] Renamed App to Project.

v0.3.2 – 2010-03-14:

  • [FIX] Fixed a bug in

v0.3.1 – 2010-03-11:

  • [CHANGE] Repackaging

v0.3 – 2010-01-06:

  • [NEW] Views for images, sources and object inventory

v0.2 – 2009-12-30:

  • [NEW] Documentation, general index and module index work
  • [NEW] Basic documentation written

v0.1 – 2009-12-19:

  • [NEW] Initial release


The primary author of django-sphinxdoc is Stefan Scherfke, who may be found online at


Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_sphinxdoc-1.5.1-py2.py3-none-any.whl (22.1 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Dec 7, 2016
django-sphinxdoc-1.5.1.tar.gz (413.5 kB) Copy SHA256 Checksum SHA256 Source Dec 7, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting