如何在新版的gitbook上寫自己的書

2021-09-13 18:33:54 字數 1716 閱讀 5491

之前為了學習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...