用github寫開源書籍


用github寫書籍


創建一個新的倉庫
創建新文件,SUMMARY.md
創建一個新文件,名爲SUMMARY.md,裏面填入:
# Summary* [前言](README.md)
  • 1
  • 2
  • 1
  • 2
創建一本書
首先進入gitbook的官網:https://www.gitbook.com/
點紅色部分,用github登錄
登錄之後,點+NewBook(或在右上角+NEW,頁面稍有改版)

這個頁面目前是在同步,等同步完畢後,就可以看到自己的書了(不是什麼原因這裏會一直是這個界面不會跳轉,但其實收到了通知郵件已經創建好了,打開主頁刷新就可以看到)。
點擊edit,可以發現裏面就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看看效果

原理和博客綁定域名是一樣的

鏈接:http://blog.csdn.net/lan842632/article/details/52846689



個人學習筆記,不當之處還請指正。
----------不定期更新------------

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章