標籤:
我最近接觸到gitbook,發現它支援markdown和git,剛好把我之前在github上的筆記可以產生一本書,於是我就開始著手搗鼓gitbook,一下午的時間就弄的差不多了,說明這個東西還是挺容易的,可以看看我的書:
《LeetBook(LeetCode詳解)》。
比較建議直接在github上部署你的架構,然後再匯入gitbook。
建立一個新的倉庫
建立過程不需要我細講了把,如果不知道,看看github入門
建立一個新檔案,名為SUMMARY.md,裡面填入:
# Summary* [前言](README.md)
建立一本書
首先進入gitbook的官網:https://www.gitbook.com/
點紅色部分,用github登入
登入之後,點+NewBook
點到github,點擊Link to your Github
授權完畢然後再點到這個頁面
選擇你需要匯入的倉庫,我們用剛才建立的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看看效果
GitBook入門(用github做出第一本書)——超詳細配圖說明