Gitbook教程(小白入坑gitbook全過程)

# 前言

最近想找一個記筆記的軟件,試了幾款都覺得差點意思,后來看到別人用gitbook寫的筆記就想試試,接觸以后發(fā)現很多大佬講的其實不適合我這種啥都不懂的人板丽,于是我就想自己寫一遍文章,再加上一直想寫篇博客玩趁尼,于是就有了這篇埃碱,我的第一篇博客。

[TOC]

Gitbook的安裝

node.js的安裝

gitbook是一個基于Node.js的命令行工具酥泞,所以要先安裝Node.js(下載地址:https://nodejs.org/en/砚殿,找到對應平臺的版本安裝即可)。

Node.js都會默認安裝npm(node包管理工具)芝囤,所以不需要單獨安裝npm似炎,打開命令行辛萍,執(zhí)行以下命令安裝GitBook:

npm install -g gitbook-cli

如果提示npm不是內部會外部命令,可以cd到node.js的安裝目錄在執(zhí)行或將npm的目錄添加到系統變量path中羡藐。

編輯工具的安裝

這里給大家介紹兩個編輯工具:gitbook editer和typora

gitbook editor

這個編輯工具對新手來說是個不錯的選擇贩毕,它集成了gitbook,git仆嗦,Markdown等功能辉阶,可以將書籍同步到gitbook.com網站和github。但是gitbook editor的注冊和登錄需要翻墻欧啤,而且這東西的官網進不去睛藻,所以還下不到启上。

這里給大家分享一下這個工具邢隧,會翻墻的可以嘗試一下這個工具

https://pan.baidu.com/s/1LEf2b9QwIRNgsoXJVBV90g

提取碼:vtpv

typora

這個工具是我目前在使用的,推薦這個也沒有啥特別的原因冈在,就是我自己感覺挺好用的

下載地址:https://www.typora.io/

直接進官網下載對應平臺的版本就可以了

Gitbook的使用

創(chuàng)建筆記文件夾

在你想要的位置新建一個文件夾倒慧,然后打開命令行,cd到這個文件夾下包券。

接著執(zhí)行以下命令

gitbook init

執(zhí)行完后纫谅,文件夾里會多兩個文件


在這里插入圖片描述

README.md(書籍的介紹在這個文件里)

SUMMARY.md(書籍的目錄結構在這里配置)

寫目錄

后面我介紹了一個生成目錄的插件,所以不一定要自己弄目錄溅固,但這里還是說下怎么寫

上面說到SUMMRAY.md文件就是整個文件夾的目錄付秕,寫目錄其實就是編輯這個文件,剛打開時這個文件里什么都沒有侍郭,我先在給他編寫一下:


在這里插入圖片描述

在給大家看看源代碼

# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一節(jié)](part1/1.md)
    * [第二節(jié)](part1/2.md)
    * [第三節(jié)](part1/3.md)
    * [第四節(jié)](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

大家可以復制源代碼過去試一下

簡單給大家說一下語法:中括號里是這個目錄的名字询吴,小括號里是路徑。

寫完目錄后再次執(zhí)行gitbook init Gitbook會查找SUMMARY.md中描述的目錄和文件亮元,如果沒有則會創(chuàng)建猛计。上面的目錄運行后是這樣的

在這里插入圖片描述

寫筆記

在這里給大家介紹一些typora比較常用的功能

各級標題

在typora中使用crtl + 1~6可以創(chuàng)建1-6級標題,1級最大爆捞,6級最小奉瘤。同時typora的大綱會顯示所有標題,如圖:


在這里插入圖片描述

表格

可以在段落--->表格中插入表格煮甥,或者按快捷鍵crtl+T

代碼塊

這個功能用的很頻繁盗温,可以在段落--->代碼塊中插入,也可以使用快捷鍵(```+空格)

專注模式和打字機模式

打字機模式就是讓當前輸入行保持在屏幕中間成肘,專注模式就是輸入行正常顏色卖局,其他行變灰,可以在視圖中打開

源代碼模式

源代碼模式就是展示Markdown的文件本來的樣子艇劫,如圖


這個模式會展示出Markdown文件的標識符

插入圖片

這個不多說吼驶,在格式--->圖像里惩激,快捷鍵crtl+shift+i

插入鏈接

用兩個尖括號括起來就行,如下:

<www.baidu.com>

更換主題

直接點主題就好蟹演,typora內置了6個主題风钻,值得一提的是typora的主題是css格式,所以會css的小伙伴可以自己寫主題酒请,或者調整已有的主題

內容目錄

就是你們在本文上面看到的那個目錄骡技,簡單點說就是把大綱放到了文章里,在段落--->內容目錄里可以找到(有標題時才能用)

常見的格式

就比如加粗羞反,斜體布朦,下劃線什么的。在格式里有昼窗,快捷鍵如下:


我的使用方法

其實單個md文件可以存儲很多筆記是趴,我現在是把一塊筆記存在一個md文件里,有一定規(guī)模后再裝文件夾澄惊,然后放在gitbook中唆途,再使用我介紹的插件生成目錄。

插件的使用方法

在gitbook中有很多有用的插件掸驱,但是使用起來會有一點麻煩肛搬,這里給大家講解一下怎么用。

gitbook的插件大部分都在npm上毕贼,可以訪問npm官網查看搜索插件https://www.npmjs.com/

這里用一個自動生成目錄的插件給大家介紹使用方法

名字叫:gitbook-plugin-summary

  1. 首先打開你筆記文件夾下的book.json文件温赔,沒有就自己創(chuàng)建一個

  2. 將以下代碼復制進去

    {
      "plugins": ["summary"]
    }
    
  3. 打開命令行,在這個文件夾中執(zhí)行命令gitbook install安裝插件

  4. 執(zhí)行命令gitbook serve然后在查看的時候就會發(fā)現鬼癣,之前明明沒有寫目錄陶贼,現在卻有了目錄

大家想要用別的插件可以直接去npm上找,都有使用方法的

生成電子書

寫完后我們可以執(zhí)行gitbook serve來預覽這本書扣溺,執(zhí)行后會把Markdown格式的文檔轉換為html格式骇窍,最后提示"Serving book on http://localhost:4000"此時用瀏覽器打開" http://localhost:4000"即可預覽書本

如圖:


在這里插入圖片描述

執(zhí)行完后你的筆記文件夾里會多一個_book文件夾,里面是轉化后的html文件

筆記的同步

同步單個的md文件

對于單個的md文件锥余,我建議同步到石墨文檔腹纳,可以在網頁版,桌面版驱犹,移動版三個版本上查看和編輯嘲恍。操作方法就是打開然后帶入就行了。當然雄驹,在博客上發(fā)布也不失為一種好的同步方法佃牛。

同步整個筆記文件

可以使用git同步到github,由于我對git不太熟悉医舆,就不誤導大家了俘侠,大家可以去網上找找

最后象缀,這是我第一次寫博客,而且我從接觸gitbook到寫完這篇博客只有短短三天爷速,如果有哪里不對央星,請各位指正

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市惫东,隨后出現的幾起案子莉给,更是在濱河造成了極大的恐慌,老刑警劉巖廉沮,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件颓遏,死亡現場離奇詭異,居然都是意外死亡滞时,警方通過查閱死者的電腦和手機叁幢,發(fā)現死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來漂洋,“玉大人遥皂,你說我怎么就攤上這事」羝” “怎么了?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵弟孟,是天一觀的道長贝咙。 經常有香客問我,道長拂募,這世上最難降的妖魔是什么庭猩? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮陈症,結果婚禮上蔼水,老公的妹妹穿的比我還像新娘。我一直安慰自己录肯,他們只是感情好趴腋,可當我...
    茶點故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著论咏,像睡著了一般优炬。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上厅贪,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天蠢护,我揣著相機與錄音,去河邊找鬼养涮。 笑死葵硕,一個胖子當著我的面吹牛眉抬,可吹牛的內容都是我干的。 我是一名探鬼主播懈凹,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼吐辙,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了蘸劈?” 一聲冷哼從身側響起昏苏,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎威沫,沒想到半個月后贤惯,有當地人在樹林里發(fā)現了一具尸體,經...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡棒掠,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年孵构,在試婚紗的時候發(fā)現自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片烟很。...
    茶點故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡颈墅,死狀恐怖,靈堂內的尸體忽然破棺而出雾袱,到底是詐尸還是另有隱情恤筛,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布芹橡,位于F島的核電站毒坛,受9級特大地震影響,放射性物質發(fā)生泄漏林说。R本人自食惡果不足惜煎殷,卻給世界環(huán)境...
    茶點故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望腿箩。 院中可真熱鬧豪直,春花似錦、人聲如沸珠移。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽剑梳。三九已至唆貌,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間垢乙,已是汗流浹背锨咙。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留追逮,地道東北人酪刀。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓粹舵,卻偏偏與公主長得像,于是被迫代替她去往敵國和親骂倘。 傳聞我的和親對象是個殘疾皇子眼滤,可洞房花燭夜當晚...
    茶點故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內容