Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

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

About

Quickly create help for modules in Django admin

Resources

License

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.