之前為了學習qt當中的qmake,就去看qt的官方文件,但qt的官方文件都是英文的,而自己本身英文較差,就一咬牙決定不如就把qmake的使用文件翻譯一下吧。這樣即可以加深對文件的理解,也可以留著自己以後查閱,順便也可以將自己的文件放在網上給想要的人進行查閱。於是就開始查詢相關的工具,幾經輾轉找到了gitbook這個**。然後了解其使用方法,但不巧的是**正處於改版時間,網上找到的教程基本全是針對舊版的,而新版的**許多功能上還沒有完善,這個折磨了我好久。
繼續查閱我還要哪些工具,於是我還要學習markdown,git以及github的使用。於是學起來。。。。而關於文字編輯器的使用又陷入了糾結。。。再vscode和sublime之間徘徊,最後還是發現vscode更適合我一些(這裡並不是說sublime不好)。vscode中可以很方便的預覽文件,以及糾正語法錯誤。
做完上面的這些你就可以在本地使用vscode編寫自己的文件,並將文件同步到github。下面介紹如何將文件同步到gitbook上,並生成一本書。下面就開始吧。。。
對了這裡還要提一下,gitbook可以新增乙個.gitbook.ymal的檔案檔案的使用方法可以查閱gitbook的**文件。
這裡我們先建立乙個gitbook賬號,這裡推薦直接使用自己的github賬號登陸gitbook。我們按照gitbook的**文件中的步驟建立乙個organization,然後再在organization下建立乙個space。
然後按照**文件建立和github上的倉儲進行關聯。
按照提示關聯自己所需要的倉儲就好。
gitbook官方文件對.gitbook.yaml文件的模板如下所示。該檔案需要放在你github倉儲的根目錄下,然後通過該文件的設定,使用相對路徑指定gitbook下的根目錄。這裡給出我翻譯的書qmake-learn其倉儲位置是github qmake-learn
# root directory to locate the content
# default is the root directory of the repository.
root: ./
# files to use as summary/readme.
# (relative to directory)
structure:
readme: readme.md
summary: summary.md
# redirect urls to specific files (relative to the directory)
redirects:
previous/page: new-folder/page.md
這裡給出我翻譯的書qmake-learn其倉儲位置是github qmake-learn。其實gitbook中也提供了一些其他的服務和設定。比如將你所寫的書的**繫結到自己的網域名稱當中。自定義書的logo,更改書的**。具體的使用方法可以看一下**文件,以及自己摸索一下。
這裡還要說一下,由於gitbook是國外的**要像流暢的在上面寫書,還是要。。。。。不過瀏覽文件沒什麼問題。
如何在新版Edge上安裝和解除安裝Chrome主題
宣告 本文由程式設計驛站內容合作夥伴 cnbeta授權發布。微軟終於發布了基於chromium的新版edge瀏覽器,從已經上線的dev和canary通道版本來看各項效果均優於預期。在基於chromium之後新版edge獲得了諸多功能改進,其中之一就是可以訪問chrome web store,從豐富的...
如何在Zynq 7000上燒寫PL Image
在zynq 7000上程式設計pl大致有3種方法 1.用fsbl,將bitstream整合到boot.bin中 2.用u boot命令 3.在linux下用xdevcfg驅動。步驟 1.去掉bitstream的檔案頭 用fsbl燒寫pl images沒有什麼好說的,用xilinx sdk的creat...
如何在Zynq 7000上燒寫PL Image
在zynq 7000上程式設計pl大致有3種方法 用fsbl,將bitstream整合到boot.bin中 用u boot命令 在linux下用xdevcfg驅動。去掉bitstream的檔案頭 用fsbl燒寫pl images沒有什麼好說的,用xilinx sdk的create boot imag...