編譯ceph官網文檔，輸出爲pdf格式

###編譯過程：

以ubuntu系統爲例：

• 在ceph源碼根目錄/home/ceph-master執行./admin/build-doc。根據提示安裝全部須要的依賴包，如: python-dev python-pip python-virtualenv doxygen ditaa ant 或者 python-devel python-pip python-virtualenv doxygen ditaa ant libxml-devel libxslt-devel

• 安裝好python pip後，安裝shpinx: 執行pip install -U Sphinx

• 爲了使用pdflatex命令，須要安裝texlive（時間較長）： sudo apt-get install texlive

• 在doc目錄，執行： git clone https://github.com/baloo/sphinx-ditaa

• 修改doc目錄下的conf.py文件：

import sys
sys.path.append(os.path.abspath('sphinx-ditaa'))
sys.path.append(os.path.abspath('sphinx-ditaa/sphinxext'))

extensions = [ 
    'sphinx.ext.autodoc',
    'sphinx.ext.graphviz',
    'sphinx.ext.todo',
    'ext.ditaa',
    'breathe',
    ]

• 安裝breathe： pip install breathe

• ditaa（http://ditaa.sourceforge.net/）和 ant（http://ant.apache.org ）是基於java的，和其餘依賴包不同。 ant下載後，將bin加入PATH變量便可。ditaa後面說。

• 在ceph-master/dddd目錄下生成 tex 文件： sphinx-build -b latex ./doc ./dddd

若是沒有問題，你能夠在dddd目錄下看到Ceph.tex文件。

• 由 tex 文件轉換爲pdf文件： pdflatex Ceph.tex 中途若是卡住，按回車跳過便可。

###說明：

1. 若是pdflatex遇到`picins.sty' not found問題，參考：http://my.oschina.net/itfanr/blog/479470

2. 若是發現ditaa沒有在_images目錄下自動生成png圖片，能夠手動經過ditaa來生成：

for name in  `ls  /home/ceph-master/dddd/_images/`;do  java -jar ditaa0_9.jar /home/ceph-master/dddd/_images/$name;done