django-admin2/docs/README
Gregor Müllegger 2b268eb089 Setting up autodoc for the docs.
For this to work you need to install sphinx in your virtualenv. It's added to
the requirements.txt so just run: pip install -r requirements.txt
2013-05-29 10:44:22 +02:00

20 lines
775 B
Text

The documentation in this tree is in plain text files and can be viewed using
any text file viewer.
It uses ReST (reStructuredText) [1], and the Sphinx documentation system [2].
This allows it to be built into other forms for easier viewing and browsing.
To create an HTML version of the docs:
* Create a virtualenv and activate it.
* Install all dependencies from requirements.txt inot the virtualenv using
``pip install -r requirements.txt`` (this will also install Sphinx).
* In this docs/ directory, type ``make html`` (or ``make.bat html`` on
Windows) at a shell prompt while the virtualenv is active.
The documentation in _build/html/index.html can then be viewed in a web browser.
[1] http://docutils.sourceforge.net/rst.html
[2] http://sphinx.pocoo.org/