我最近接觸到gitbook,發(fā)現(xiàn)它支持markdown和git,剛好把我之前在github上的筆記可以生成一本書,于是我就開始著手搗鼓gitbook,一下午的時間就弄的差不多了,說明這個東西還是挺容易的,可以看看我的書:
《LeetBook(LeetCode詳解)》。
比較建議直接在github上部署你的框架,然后再導(dǎo)入gitbook。
創(chuàng)建一個新的倉庫

創(chuàng)建過程不需要我細(xì)講了把,如果不知道,看看github入門

創(chuàng)建一個新文件,名為SUMMARY.md,里面填入:
# Summary
* [前言](README.md)
創(chuàng)建一本書
首先進(jìn)入gitbook的官網(wǎng):https://www.gitbook.com/

點紅色部分,用github登錄
登錄之后,點+NewBook

點到github,點擊Link to your Github

授權(quán)完畢然后再點到這個頁面

選擇你需要導(dǎo)入的倉庫,我們用剛才創(chuàng)建的testbook,然后標(biāo)題可以自己取,下面的地址只能填英文,然后點創(chuàng)建

這個頁面目前是在同步,等同步完畢后,就可以看到自己的書了。

可以點擊read

可以發(fā)現(xiàn)里面就1頁,就是我們剛才SUMMARY.md寫的內(nèi)容

增加內(nèi)容
我們退回上一步,點edit

可以看到如下界面


可以同步顯示編輯后的效果

現(xiàn)在我們就可以完成我們的書的錄入了,在目錄區(qū)點擊右鍵,可以新建一個內(nèi)容頁

然后點擊一下,會提示創(chuàng)建一個文件

然后你會發(fā)現(xiàn)在github上也多了一個文件,這就關(guān)聯(lián)起來了。

我們再看SUMMARY里面多了一個“第一頁”

我們雙擊一下,發(fā)現(xiàn)就是markdown的超鏈接,原來這就是gitbook的內(nèi)容組織方式,通過超連接把內(nèi)容和github上文件關(guān)聯(lián)起來。

我們修改一下名字,然后把他縮進(jìn)一個tab,保存看看有什么變化

可以發(fā)現(xiàn)目錄結(jié)構(gòu)變了,然后名字也變了

通過修改SUMMARY.md你可以輕松的組織你的書
書的框架
一般來說,你的書得有一個README.md和一個SUMMARY.md。
其中SUMMARY.md是最重要的,它代表了整個書的框架,也是我們主要需要修改的地方。
當(dāng)你考慮好要寫一本書,你可以先粗略的想好大概要分幾部分,對這幾部分弄一個文件夾。然后把對應(yīng)的markdown文件放進(jìn)去。

然后push到github上,然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook關(guān)聯(lián)

關(guān)于地址的獲取有個小訣竅,就是點擊文件,郵件,有個重命名,這里可以看到文件的完整地址,復(fù)制就好。

最后,可以在自己的書的主頁點擊read看看效果
