DIV CSS 佈局教程網

一、什麼是Sphinx？

Sphinx 是種令人可以輕松撰寫出明智/優美的文檔工具, 由 Georg Brandl 在BSD 許可證下創造.

Sphinx 已在支持是 the 新版Python 文檔的生成, 也成為Python項目首選的文檔工具,同時也對 C/C++ 工程有很好的支持; 進一步的,也將對其它開發語言進行特殊支持. 當然,本站就是使用 Sphnix 從新結構化文本中架構而成!

Sphnix還在繼續開發. 下列特性工作良好,並在Python官方文檔中有“體現”:

• 豐富的輸出格式: Html (包括M$幫助), LaTeX (為PDF輸出), manual pages(man), 純文本
• 完備的交叉引用: 語義化的標簽,並對 函式,類,引文,術語以及類似片段消息可以自動化鏈接
• 明晰的分層結構: 輕松定義文檔樹,並自動化鏈接同級/父級/下級文章
• 美觀的自動索引: 可自動生成美觀的模塊索引
• 精確的語法高亮: 基於 Pygments 自動生成語法高亮
• 開放的擴展: 支持代碼塊的自動測試,自動包含Python 的模塊自述文檔,等等
• Sphinx 使用新結構化文本 作為標記語言,因而直接享受了來自Docutils 為 reStructuredText 提供的多種工具和能力!

二、安裝Sphinx

本次測試安裝環境：debian5

1）安裝Python

python：http://www.Python.org/download/

2）安裝setuptools

setuptools下載地址

Windows安裝方法：

直接下載對應python版本的setuptools exe安裝文件，安裝即可http://pypi.Python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe#md5=57e1e64f6b7c7f1d2eddfc9746bbaf20

Mac OS X, Linux安裝方法：

下載對應版本setuptools文件，我的Python版本是2.6.6

wget http://pypi.Python.org/packages/2.6/s/setuptools/setuptools-0.6c11-py2.6.egg#md5=bfa92100bd772d5a213eedd356d64086

安裝setuptools

sh setuptools-0.6c11-py2.6.egg

現在就可以使用easy_install命令了。

3）安裝Sphinx

easy_install -U Sphinx

安裝完成，enjoy it!