Skip to main content

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.

Requirements

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

Installation

Just use PIP:

$ pip install django-sphinxdoc

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

$ pip install https://ssc@bitbucket.org/sscherfke/django-sphinxdoc

or

$ hg clone ssh://hg@bitbucket.org/sscherfke/django-sphinxdoc
$ pip install -e django-sphinxdoc

Usage

The documentation can be found in the docs/ directory or at http://django-sphinxdoc.readthedocs.io/en/latest/.

Changelog for django-sphinxdoc

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 settings.py 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

  • [NEW] Setting: SPHINXDOC_CACHE_MINUTES

  • [NEW] Setting: SPHINXDOC_BUILD_DIR

  • [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 setup.py.

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

Authors

The primary author of django-sphinxdoc is Stefan Scherfke, who may be found online at http://stefan.sofa-rockers.org/.

Contributors:

Download files

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

Source Distribution

django-sphinxdoc-1.4.2.tar.gz (411.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_sphinxdoc-1.4.2-py2.py3-none-any.whl (19.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file django-sphinxdoc-1.4.2.tar.gz.

File metadata

File hashes

Hashes for django-sphinxdoc-1.4.2.tar.gz
Algorithm Hash digest
SHA256 e84136873ac4440eedfe05037e63b7cca0d70df1076e50f0d7f2986d2b1fcc1e
MD5 9160a715bc54495f7af57e068911319b
BLAKE2b-256 078cdb638153a87d4c0f77da421aeac9274355310d57709c37afec76d972be52

See more details on using hashes here.

File details

Details for the file django_sphinxdoc-1.4.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_sphinxdoc-1.4.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b0979dd23f9efeb08a94c7107836de338c109d8f88401bd650a408c04a1e9c86
MD5 698c968a04eed16e850b9869cc85846a
BLAKE2b-256 6772a3ab5b49f1be5b2d11e9f782a57a39ab98056d767ee28ce464a713818171

See more details on using hashes here.

Release history Release notifications | RSS feed

2.0.0

2 files

1.5.1

2 files

1.5.0

2 files

This release

1.4.2 This release

2 files

1.4.1

2 files

1.4.0

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0

2 files

1.1

1 file

1.0

1 file

0.3.2

1 file

0.3.1

1 file

0.2

0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page