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

來源:互聯網
上載者:User

標籤:

我最近接觸到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做出第一本書)——超詳細配圖說明

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.