快速鏈接:
.
👉👉👉 個(gè)人博客筆記導(dǎo)讀目錄(全部) 👈👈👈

文章目錄

• • • • 背景
      • 環(huán)境搭建-安裝Sphinx工具
      • 創(chuàng)建一個(gè)項(xiàng)目
      • 編譯項(xiàng)目

關(guān)鍵詞:Sphinx, readthedocs, reStructuredText

背景

在當(dāng)下一些主流的開(kāi)源社區(qū)、公司公開(kāi)或非公開(kāi)的項(xiàng)目，都采用了Sphinx+readthedocs方案。這種編寫(xiě)文檔的方式，每一個(gè)開(kāi)發(fā)者都可以參與，都可以提交自己的文檔…
寫(xiě)文檔就像寫(xiě)代碼一樣，可以多人協(xié)助

環(huán)境搭建-安裝Sphinx工具

環(huán)境要求: ubuntu, 已安裝過(guò)python3,make,git等工具, 如果沒(méi)有安裝過(guò)，可以使用下列命令進(jìn)行安裝：

sudo apt install git
sudo apt install make
sudo apt install python3
sudo apt install python3-pip

接下來(lái)就是安裝Sphinx及其依賴(lài)了：

pip3 install -U Sphinx
pip3 install sphinx-autobuild
pip3 install sphinx_rtd_theme
pip3 install recommonmark
pip3 install sphinx_markdown_tables

安裝換成此后

test@test-21:~/workspace$ sphinx- sphinx-apidoc sphinx-autobuild sphinx-autogen sphinx-build sphinx-quickstart

創(chuàng)建一個(gè)項(xiàng)目

使用sphinx-quickstart命令可快速創(chuàng)建一個(gè)項(xiàng)目

項(xiàng)目創(chuàng)建后，自動(dòng)生成如下文件：

編譯項(xiàng)目

敲擊make html即可完成編譯

編譯后，用瀏覽器打開(kāi)build/html/index.html，即可看到漂亮的界面了：

補(bǔ)充知識(shí)：

• make html // 編譯，輸出html
• make singlehtml //編譯，生成單個(gè)html
• make latexpdf //編譯，生成pdf文件

總結(jié)

以上是生活随笔為你收集整理的[How TO]-如何使用Sphinx编写漂亮的文档的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。