2013-08-08 10:34:06 -04:00
|
|
|
=================
|
|
|
|
|
Building the docs
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
Sphinx_
|
|
|
|
|
You'll need sphinx (the python one) and if you are
|
|
|
|
|
using the virtualenv you'll need to install it in the virtualenv
|
2013-09-17 10:57:47 +03:00
|
|
|
specifically so that it can load the manila modules.
|
2013-08-08 10:34:06 -04:00
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
pip install Sphinx
|
|
|
|
|
|
|
|
|
|
Graphviz_
|
|
|
|
|
Some of the diagrams are generated using the ``dot`` language
|
|
|
|
|
from Graphviz.
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
sudo apt-get install graphviz
|
|
|
|
|
|
|
|
|
|
.. _Sphinx: http://sphinx.pocoo.org
|
|
|
|
|
|
|
|
|
|
.. _Graphviz: http://www.graphviz.org/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Use `make`
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
Just type make::
|
|
|
|
|
|
|
|
|
|
% make
|
|
|
|
|
|
|
|
|
|
Look in the Makefile for more targets.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Manually
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
1. Generate the code.rst file so that Sphinx will pull in our docstrings::
|
|
|
|
|
|
|
|
|
|
% ./generate_autodoc_index.sh > source/code.rst
|
|
|
|
|
|
|
|
|
|
2. Run `sphinx_build`::
|
|
|
|
|
|
|
|
|
|
% sphinx-build -b html source build/html
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The docs have been built
|
|
|
|
|
========================
|
|
|
|
|
|
|
|
|
|
Check out the `build` directory to find them. Yay!
|
