Building Ceph Documentation

Ceph utilizes Python’s Sphinx documentation tool. For details onthe Sphinx documentation tool, refer to The Sphinx Documentation Tool.

To build the Ceph documentation set, you must:

Clone the Ceph Repository

To clone the Ceph repository, you must have git installedon your local host. To install git, execute:

sudo apt-get install git

To clone the Ceph repository, execute:

git clone git://github.com/ceph/ceph

You should have a full copy of the Ceph repository.

To build the Ceph documentation, some dependencies are required.To know what packages are needed, you can launch this command:

cd ceph
admin/build-doc

If dependencies are missing, the command above will failwith a message that suggests you a command to install allmissing dependencies.

Once you have installed all the dependencies, execute the build (thesame command as above):

cd ceph
admin/build-doc

Once you build the documentation set, you may navigate to the source directory to view it:

cd build-doc/output

There should be an html directory and a man directory containing documentationin HTML and manpage formats respectively.

Once you build the documentation, as described above, you can demo the rendered documentsby running serve-doc:

cd ceph
admin/serve-doc

This will serve the build-doc/output/html directory over port 8080 viaPython’s SimpleHTTPServer module.