Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Quickly create help for modules in Django admin
Python Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
example
simpleadmindoc
.gitignore
LICENSE
README.rst
setup.py

README.rst

django-simpleadmindoc 0.4.0

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:

  1. djangoadmin Sphinx domain allows autodocumenting models,
  2. djangoadmin also allows referencing models and fields inside documentation while taking care of using verbose names,
  3. 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.

Usage

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

Configuration

  1. Add djangoadmin domain to sphinx coniguration (conf.py):

    extensions = ["simpleadmindoc.ext.djangoadmindoc"]
    
  2. Configure sphinx so it have have access to django website. Add website directory to sys.path and setup environment variable DJANGO_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'
    
  3. Add simpleadmindoc to your settings INSTALLED_APPS.

Example application

Small example application is included.

Requirements

  • Sphinx 1.0.1

Documentation

http://readthedocs.org/docs/simpleadmindoc/en/latest/

Contribute

Fork + pull. Report issues: https://github.com/bmihelac/django-simpleadmindoc/issues

Something went wrong with that request. Please try again.