我最近接觸到gitbook,發現它支持markdown和git,恰好把我以前在github上的筆記能夠生成一本書,因而我就開始着手搗鼓gitbook,一下午的時間就弄的差很少了,說明這個東西仍是挺容易的,能夠看看個人書:
《LeetBook(LeetCode詳解)》。git
比較建議直接在github上部署你的框架,而後再導入gitbook。github
建立過程不須要我細講了把,若是不知道,看看github入門markdown
建立一個新文件,名爲SUMMARY.md,裏面填入:框架
# Summary * [前言](README.md)
首先進入gitbook的官網:https://www.gitbook.com/.net
點紅色部分,用github登陸code
登陸以後,點+NewBookblog
點到github,點擊Link to your Github部署
受權完畢而後再點到這個頁面get
選擇你須要導入的倉庫,咱們用剛纔建立的testbook,而後標題能夠本身取,下面的地址只能填英文,而後點建立同步
這個頁面目前是在同步,等同步完畢後,就能夠看到本身的書了。
能夠點擊read
能夠發現裏面就1頁,就是咱們剛纔SUMMARY.md寫的內容
咱們退回上一步,點edit
能夠看到以下界面
咱們點開
能夠同步顯示編輯後的效果
如今咱們就能夠完成咱們的書的錄入了,在目錄區點擊右鍵,能夠新建一個內容頁
而後點擊一下,會提示建立一個文件
而後你會發如今github上也多了一個文件,這就關聯起來了。
咱們再看SUMMARY裏面多了一個「第一頁」
咱們雙擊一下,發現就是markdown的超連接,原來這就是gitbook的內容組織方式,經過超鏈接把內容和github上文件關聯起來。
咱們修改一下名字,而後把他縮進一個tab,保存看看有什麼變化
能夠發現目錄結構變了,而後名字也變了
經過修改SUMMARY.md你能夠輕鬆的組織你的書
通常來講,你的書得有一個README.md和一個SUMMARY.md。
其中SUMMARY.md是最重要的,它表明了整個書的框架,也是咱們主要須要修改的地方。
當你考慮好要寫一本書,你能夠先粗略的想好大概要分幾部分,對這幾部分弄一個文件夾。而後把對應的markdown文件放進去。
而後push到github上,而後再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook關聯
關於地址的獲取有個小訣竅,就是點擊文件,郵件,有個重命名,這裏能夠看到文件的完整地址,複製就好。
最後,能夠在本身的書的主頁點擊read看看效果