mirror of
https://github.com/ceph/ceph
synced 2024-12-14 15:35:45 +00:00
eadc771d27
http://tracker.ceph.com/issues/14070 Fixes: #14070 Signed-off-by: Nathan Cutler <ncutler@suse.com>
67 lines
1.6 KiB
ReStructuredText
67 lines
1.6 KiB
ReStructuredText
Building Ceph Documentation
|
|
===========================
|
|
|
|
Ceph utilizes Python's Sphinx documentation tool. For details on
|
|
the Sphinx documentation tool, refer to `The Sphinx Documentation Tool <http://sphinx.pocoo.org/>`_.
|
|
|
|
To build the Ceph documentation set, you must:
|
|
|
|
1. Clone the Ceph repository
|
|
2. Install the required tools
|
|
3. Build the documents
|
|
|
|
Clone the Ceph Repository
|
|
-------------------------
|
|
|
|
To clone the Ceph repository, you must have ``git`` installed
|
|
on 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.
|
|
|
|
|
|
Install the Required Tools
|
|
--------------------------
|
|
|
|
To build the Ceph documentation, the following packages are required on
|
|
Ubuntu 14.04:
|
|
|
|
- ``python-dev``
|
|
- ``python-pip``
|
|
- ``python-virtualenv``
|
|
- ``libxml2-dev``
|
|
- ``libxslt-dev``
|
|
- ``doxygen``
|
|
- ``ditaa``
|
|
- ``graphviz``
|
|
- ``ant``
|
|
- ``cython``
|
|
- ``librbd-dev``
|
|
|
|
Execute ``apt-get install`` for each dependency that isn't installed
|
|
on your host.::
|
|
|
|
sudo apt-get install python-dev python-pip python-virtualenv libxml2-dev libxslt-dev doxygen ditaa graphviz ant cython librbd-dev
|
|
|
|
|
|
|
|
Build the Documents
|
|
-------------------
|
|
|
|
Once you have installed all the dependencies, execute the build::
|
|
|
|
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 documentation
|
|
in HTML and manpage formats respectively.
|