用sphinx將reStructuredText開源書籍轉(zhuǎn)化成其他格式
By qianghaohao
今天在github看到了一個項目，是用reStructuredTex標(biāo)記語言寫的開源書籍,，然后下載下來閱讀,，
結(jié)果發(fā)現(xiàn)下載下來的目錄里面有很多各種格式的文件,，并不能直接閱讀，需要用sphinx編譯成我們
可以閱讀的格式,，才可以看,。比如html，pdf等格式,。
一.sphinx工具簡介:
sphinx工具是一個由Grorg Brandl寫的產(chǎn)生文檔的工具，可以將reStructuredTex格式轉(zhuǎn)化成
多種格式,，如HTML,LaTex,ePub,Texinfo,manual pages,plain text等,。
二.使用sphinx編譯開源書籍項目產(chǎn)生html格式的文檔:
2.安裝Python:
安裝完后配置好paht環(huán)境變量:
3.安裝pip工具(用來下載和安裝第三方庫的工具):
然后打開命令提示符用Python運行上面保存Python文件來安裝pip:
接下來配置pip工具的環(huán)境變量:
4.用pip工具安裝sphinx:
5.進入工程目錄查看makefile，然后開始編譯:
查看工程目錄中的makefile:
我們可以看到makefile中有多個目標(biāo),，每個目標(biāo)代表一種格式,，可以編譯成多種格式，在此我編譯成了
html格式的文檔,，所以下達如下命令開始編譯:
編譯完成后會提示編譯結(jié)果輸出到了那個目錄,，在此輸出到了_build目錄:
三.編譯結(jié)果如下:
進入到_build輸出目錄，可以看到我們編譯產(chǎn)生的html文檔,，打開index.html結(jié)果如下：
本文參考資料:
|
