Skip to main content

Allows to serve Sphinx generated docs from django.

Project description

django-docs allows to serve Sphinx generated docs directly from Django.


  • Python 2.7-3.6 for Django 1.8 - 1.11
  • Python 3.4-3.6 for Django 2.0 or higher



  1. Install django-docs package:

    pip install django-docs
  2. Add docs to INSTALLED_APPS in

  3. Add docs.urls to

    urlpatterns = [
        url(r'^docs/', include('docs.urls')),
  4. Customize configuration:

    DOCS_ROOT = os.path.join(PROJECT_PATH, '../docs/_build/html')
    DOCS_ACCESS = 'staff'


DOCS_ROOT (required)

Absolute path to the root directory of html docs generated by Sphinx (just like STATIC_ROOT / MEDIA_ROOT settings).

DOCS_ACCESS (optional)

Docs access level (public by default). Possible values:

  • public - (default) docs are visible to everyone
  • login_required - docs are visible only to authenticated users
  • staff - docs are visible only to staff users (user.is_staff == True)
  • superuser - docs are visible only to superusers (user.is_superuser == True)

Running the tests

Make sure to install test_requirements.txt first:

pip install -r test_requirements.txt
pip install -e .

You can run the tests with via:

python test


python docs/tests/

To run all tests against different versions of Django simply run:


Running the example project

Make sure to install requirements.txt first:

virtualenv env
. env/bin/activate
pip install -r test_requirements.txt
pip install -e .

You can run the example project with via:

cd example
python migrate
python runserver


Project details

Download files

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

Files for django-docs, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size django_docs-0.3.1-py3-none-any.whl (8.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-docs-0.3.1.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page