GitBook入門(用github作出第一本書)——超詳細配圖說明

我最近接觸到gitbook,發現它支持markdown和git,恰好把我以前在github上的筆記能夠生成一本書,因而我就開始着手搗鼓gitbook,一下午的時間就弄的差很少了,說明這個東西仍是挺容易的,能夠看看個人書:
《LeetBook(LeetCode詳解)》git

比較建議直接在github上部署你的框架,而後再導入gitbook。github

建立一個新的倉庫

Alt text

建立過程不須要我細講了把,若是不知道,看看github入門markdown

Alt text

建立一個新文件,名爲SUMMARY.md,裏面填入:框架

# Summary
* [前言](README.md)

建立一本書

首先進入gitbook的官網:https://www.gitbook.com/.net

Alt text

點紅色部分,用github登陸code

登陸以後,點+NewBookblog

Alt text

點到github,點擊Link to your Github部署

Alt text

受權完畢而後再點到這個頁面get

Alt text

選擇你須要導入的倉庫,咱們用剛纔建立的testbook,而後標題能夠本身取,下面的地址只能填英文,而後點建立同步

Alt text

這個頁面目前是在同步,等同步完畢後,就能夠看到本身的書了。

Alt text

能夠點擊read

Alt text

能夠發現裏面就1頁,就是咱們剛纔SUMMARY.md寫的內容

Alt text

增長內容

咱們退回上一步,點edit

Alt text

能夠看到以下界面

Alt text

咱們點開Alt text

能夠同步顯示編輯後的效果

Alt text

如今咱們就能夠完成咱們的書的錄入了,在目錄區點擊右鍵,能夠新建一個內容頁

Alt text

而後點擊一下,會提示建立一個文件

Alt text

而後你會發如今github上也多了一個文件,這就關聯起來了。

Alt text

咱們再看SUMMARY裏面多了一個「第一頁」

Alt text

咱們雙擊一下,發現就是markdown的超連接,原來這就是gitbook的內容組織方式,經過超鏈接把內容和github上文件關聯起來。

Alt text

咱們修改一下名字,而後把他縮進一個tab,保存看看有什麼變化

Alt text

能夠發現目錄結構變了,而後名字也變了

Alt text

經過修改SUMMARY.md你能夠輕鬆的組織你的書

書的框架

通常來講,你的書得有一個README.md和一個SUMMARY.md。
其中SUMMARY.md是最重要的,它表明了整個書的框架,也是咱們主要須要修改的地方。

當你考慮好要寫一本書,你能夠先粗略的想好大概要分幾部分,對這幾部分弄一個文件夾。而後把對應的markdown文件放進去。

Alt text

而後push到github上,而後再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook關聯

Alt text

關於地址的獲取有個小訣竅,就是點擊文件,郵件,有個重命名,這裏能夠看到文件的完整地址,複製就好。

Alt text

最後,能夠在本身的書的主頁點擊read看看效果

Alt text

相關文章
相關標籤/搜索