c16cd04cf6
blueprint sphinx-doc-cleanup bug 944385 - Fix formatting and markup issues that produce error messages - Update TOC lists for missing/new files - Fix a few links - Update instructions with dependencies for building the documentation - Updated base on review comments from oubiwann to fix trailing whitespace in modified files Change-Id: I589152bfab9c543d2b11fa8bed2344259aa90675
56 lines
932 B
ReStructuredText
56 lines
932 B
ReStructuredText
=================
|
|
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
|
|
specifically so that it can load the nova modules.
|
|
|
|
::
|
|
|
|
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!
|