skip to navigation
skip to content

Not Logged In

django-sphinxdoc 1.2.1

Easily integrate Sphinx documentation into your website.

Latest Version: 1.3.0

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. Future versions will enable comments and add RSS feeds.

Requirements

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

Installation

Just use PIP:

$ pip install django-sphinxdoc

If you want the lates development version, isntall it from Bitbucket:

$ pip install https://ssc@bitbucket.org/ssc/django-sphinxdoc
$ # or
$ hg clone ssh://hg@bitbucket.org/ssc/django-sphinxdoc
$ pip install -e django-sphinxdoc

Usage

The Documentation can be found in the docs/ directory.

Changelog for django-sphinxdoc

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 since v1.0:

Contributors since v1.1:

 
File Type Py Version Uploaded on Size
django-sphinxdoc-1.2.1.tar.gz (md5) Source 2013-12-28 398KB
django_sphinxdoc-1.2.1-py2.py3-none-any.whl (md5) Python Wheel 2.7 2013-12-28 15KB
  • Downloads (All Versions):
  • 16 downloads in the last day
  • 225 downloads in the last week
  • 1079 downloads in the last month