# 前言
最近想找一個記筆記的軟件,試了幾款都覺得差點意思,后來看到別人用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
這個工具是我目前在使用的,推薦這個也沒有啥特別的原因冈在,就是我自己感覺挺好用的
直接進官網下載對應平臺的版本就可以了
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
插入鏈接
用兩個尖括號括起來就行,如下:
更換主題
直接點主題就好蟹演,typora內置了6個主題风钻,值得一提的是typora的主題是css格式,所以會css的小伙伴可以自己寫主題酒请,或者調整已有的主題
內容目錄
就是你們在本文上面看到的那個目錄骡技,簡單點說就是把大綱放到了文章里,在段落--->內容目錄里可以找到(有標題時才能用)
常見的格式
就比如加粗羞反,斜體布朦,下劃線什么的。在格式里有昼窗,快捷鍵如下:
我的使用方法
其實單個md文件可以存儲很多筆記是趴,我現在是把一塊筆記存在一個md文件里,有一定規(guī)模后再裝文件夾澄惊,然后放在gitbook中唆途,再使用我介紹的插件生成目錄。
插件的使用方法
在gitbook中有很多有用的插件掸驱,但是使用起來會有一點麻煩肛搬,這里給大家講解一下怎么用。
gitbook的插件大部分都在npm上毕贼,可以訪問npm官網查看搜索插件https://www.npmjs.com/
這里用一個自動生成目錄的插件給大家介紹使用方法
首先打開你筆記文件夾下的book.json文件温赔,沒有就自己創(chuàng)建一個
-
將以下代碼復制進去
{ "plugins": ["summary"] }
打開命令行,在這個文件夾中執(zhí)行命令
gitbook install
安裝插件執(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到寫完這篇博客只有短短三天爷速,如果有哪里不對央星,請各位指正