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

我最近接觸到gitbook,發(fā)現(xiàn)它支持markdown和git,剛好把我之前在github上的筆記可以生成一本書,于是我就開始著手搗鼓gitbook,一下午的時間就弄的差不多了,說明這個東西還是挺容易的,可以看看我的書:
《LeetBook(LeetCode詳解)》

比較建議直接在github上部署你的框架,然后再導(dǎo)入gitbook。

創(chuàng)建一個新的倉庫

Alt text
Alt text

創(chuàng)建過程不需要我細(xì)講了把,如果不知道,看看github入門

Alt text
Alt text

創(chuàng)建一個新文件,名為SUMMARY.md,里面填入:

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

創(chuàng)建一本書

首先進(jìn)入gitbook的官網(wǎng):https://www.gitbook.com/

Alt text
Alt text

點紅色部分,用github登錄

登錄之后,點+NewBook

Alt text
Alt text

點到github,點擊Link to your Github

Alt text
Alt text

授權(quán)完畢然后再點到這個頁面

Alt text
Alt text

選擇你需要導(dǎo)入的倉庫,我們用剛才創(chuàng)建的testbook,然后標(biāo)題可以自己取,下面的地址只能填英文,然后點創(chuàng)建

Alt text
Alt text

這個頁面目前是在同步,等同步完畢后,就可以看到自己的書了。

Alt text
Alt text

可以點擊read

Alt text
Alt text

可以發(fā)現(xiàn)里面就1頁,就是我們剛才SUMMARY.md寫的內(nèi)容

Alt text
Alt text

增加內(nèi)容

我們退回上一步,點edit

Alt text
Alt text

可以看到如下界面

Alt text
Alt text

我們點開
Alt text
Alt text

可以同步顯示編輯后的效果

Alt text
Alt text

現(xiàn)在我們就可以完成我們的書的錄入了,在目錄區(qū)點擊右鍵,可以新建一個內(nèi)容頁

Alt text
Alt text

然后點擊一下,會提示創(chuàng)建一個文件

Alt text
Alt text

然后你會發(fā)現(xiàn)在github上也多了一個文件,這就關(guān)聯(lián)起來了。

Alt text
Alt text

我們再看SUMMARY里面多了一個“第一頁”

Alt text
Alt text

我們雙擊一下,發(fā)現(xiàn)就是markdown的超鏈接,原來這就是gitbook的內(nèi)容組織方式,通過超連接把內(nèi)容和github上文件關(guān)聯(lián)起來。

Alt text
Alt text

我們修改一下名字,然后把他縮進(jìn)一個tab,保存看看有什么變化

Alt text
Alt text

可以發(fā)現(xiàn)目錄結(jié)構(gòu)變了,然后名字也變了

Alt text
Alt text

通過修改SUMMARY.md你可以輕松的組織你的書

書的框架

一般來說,你的書得有一個README.md和一個SUMMARY.md。
其中SUMMARY.md是最重要的,它代表了整個書的框架,也是我們主要需要修改的地方。

當(dāng)你考慮好要寫一本書,你可以先粗略的想好大概要分幾部分,對這幾部分弄一個文件夾。然后把對應(yīng)的markdown文件放進(jìn)去。

Alt text
Alt text

然后push到github上,然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook關(guān)聯(lián)

Alt text
Alt text

關(guān)于地址的獲取有個小訣竅,就是點擊文件,郵件,有個重命名,這里可以看到文件的完整地址,復(fù)制就好。

Alt text
Alt text

最后,可以在自己的書的主頁點擊read看看效果

Alt text
Alt text
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,247評論 6 543
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,520評論 3 429
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,362評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,805評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 72,541評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,896評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,887評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 43,062評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,608評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 41,356評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,555評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,077評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,769評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,175評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,489評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,289評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 48,516評論 2 379

推薦閱讀更多精彩內(nèi)容