學習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文件了。