Windows 下用 Sphinx 發(fā)布 HTML

先去文具店買紙筆

1. 買紙(Python)

位置:Python的官方網(wǎng)站
64位安裝程序
32位安裝程序
付錢:下載好以后直接運(yùn)行.exe文件安裝,那樣紙就準(zhǔn)備好了

2. 買筆(Sphinx)

位置:本機(jī)的命令行窗口

  • 在桌面左下角Windows 圖標(biāo)下右擊,點(diǎn)擊運(yùn)行,在彈出框中輸入 cmd
  • 在桌面左下角Windows 圖標(biāo)下右擊,點(diǎn)擊運(yùn)行,在彈出框中輸入 Windows PowerShell
    付錢:
    在打開的命令行窗口,直接鍵入 pip install -U Sphinx
    字母 U 和字母 S 大寫,一定要注意哇,不然這個(gè)命令是無(wú)效嘚
    店家給你備貨現(xiàn)場(chǎng):
    image.png

    到手:
    image.png

準(zhǔn)備就緒,文思泉涌

3. 打開筆蓋

在命令行界面輸入 sphinx-quickstart
啟動(dòng)之后,Sphinx 會(huì)問(wèn)你許多問(wèn)題,還會(huì)給出一些提示,大部分只需回答是(y)或否(n),少數(shù)需要鍵入項(xiàng)目名稱等,只要一一作答即可。
終于回答了所有問(wèn)題,Sphinx 會(huì)為我們創(chuàng)建一個(gè)基本的文檔結(jié)構(gòu),包括1個(gè) source 文件夾

image.png

2個(gè) makefile 的文件
image.png

4. 分章寫作

在source 文件夾里添加我們用 rst 寫好的一個(gè)個(gè)文檔

5. 編纂目錄

打開source 文件夾中的index.rst 文件,在目錄樹 toctree 里面添加我們寫的文檔信息

昭告天下

6. 出版

在命令行里輸入 make html
Sphinx 會(huì)為我們生成一個(gè) build 文件夾,里面就是發(fā)布好的 html 文件了,這樣我們的文檔就按照 toctree 的層級(jí)編纂好了

完美~

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 摘抄:http://blog.163.com/sbtaot/blog/static/128303760200982...
    cqlina閱讀 4,601評(píng)論 0 5
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,545評(píng)論 19 139
  • .bat腳本基本命令語(yǔ)法 目錄 批處理的常見命令(未列舉的命令還比較多,請(qǐng)查閱幫助信息) 1、REM 和 :: 2...
    慶慶慶慶慶閱讀 8,532評(píng)論 1 19
  • 1、去除頁(yè)眉的橫線方法兩則 在頁(yè)眉插入信息的時(shí)候經(jīng)常會(huì)在下面出現(xiàn)一條橫線,如果這條橫線影響你的視覺,這時(shí)你可以采用...
    南屋阿米佛頭閱讀 4,740評(píng)論 4 37
  • 《安濟(jì)橋》 清·饒夢(mèng)鋁 誰(shuí)到橋頭問(wèn)李春, 仙驢仙跡幻成真。 長(zhǎng)虹應(yīng)卷濤聲急, 似向殘碑說(shuō)故人。
    喜亭_bf8f閱讀 342評(píng)論 0 3

友情鏈接更多精彩內(nèi)容