使用gitbook快速把md文件轉成html

學習pyqt的最大的障礙就是沒有中文文檔。

在筆者不懈努力下發現寶藏了。pyqt5的中文手冊下載

這個鏈接指向的是一個github地址。筆者將他下載下來之後呢,發現都是md文件。很討厭每次都是用md軟件打開幫助文檔,所以,就想着怎麼將md轉換成成常用的幫助文檔類型,比如html。於是有了此篇博文。

使用gitbook快速把md文件轉成html

安裝

npm i gitbook gitbook-cli -g 

創建目錄.md文件

簡單說就是將所有的要轉換的md文件都放在doc文件夾下面。在跟doc文件夾同級的位置新建一個如help.md的文件,該文件內容格式大致如下:

# pyqt5中文手冊

* [一級標題](text1.md)
* [一級標題](doc/text1.md)
    * [二級標題(doc/text/text1.md)
    	*[三級標題](..) 

類似以上的內容
例如你在* [一級標題](doc/text1.md)這裏後面的引用地址寫了doc/text1.md,最終運行命令後,會生成一個doc目錄,doc目錄裏會創建1個text.md, 而且這個一級標題會指向這裏。

生成md文件

如果我們自己要新建一個幫助手冊,那麼這個步驟要看下,否則可省略

gitbook init

這個命令會生成相應的md的文件,然後在相應的文件裏,寫你的內容即可

md轉html

gitbook build

生成一個_doc目錄,打開就可以看到你html文件了。

 

 

 

發佈了176 篇原創文章 · 獲贊 45 · 訪問量 23萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章