Django-simpleadmindoc is a tool that helps creating documentation for editors and administrators of django based website.
Simpleadmindoc is based on and produces documents for Sphinx.
Main features:
djangoadmin
Sphinx domain allows autodocumenting models,djangoadmin
also allows referencing models and fields inside documentation while taking care of using verbose names,docgenapp
django management command allows fast creating of skeleton documentation for applications inside website.
Goal of simpleadmindoc is to make writing of documentation for editors and administrators fast, flexible and easy.
.. djangoadmin:model:: books.Article
Reference models :djangoadmin:model:`books.Article` or attributes
:djangoadmin:attribute:`books.Article.headline`.
djangoadmin:model
directive in first line will autodocument all available fields in Article
model that is in the books
app.
References in second line will be replaced with verbose names and linked to respective model / attribute.
Add djangoadmin domain to sphinx coniguration (
conf.py
):extensions = ["simpleadmindoc.ext.djangoadmindoc"]
Configure sphinx so it have have access to django website. Add website directory to
sys.path
and setup environment variableDJANGO_SETTINGS_MODULE
:import sys, os sys.path.insert(0, os.path.abspath('../..')) sys.path.insert(0, os.path.abspath('..')) os.environ['DJANGO_SETTINGS_MODULE'] = 'example.settings'
- Add simpleadmindoc to your settings INSTALLED_APPS.
Small example application is included.
- Sphinx 1.0.1
http://readthedocs.org/docs/simpleadmindoc/en/latest/
Fork + pull. Report issues: https://github.com/bmihelac/django-simpleadmindoc/issues