GitBook 是一個基于 Node.js 的命令行工具址愿,支持 Markdown 和 AsciiDoc 兩種語法格式该镣,可以輸出 HTML、PDF响谓、eBook 等格式的電子書损合。
因?yàn)橹С謒arkdown所以書寫起來很舒服而且結(jié)合各種插件以及git一起使用,可以快速娘纷,舒適的打造一個屬于自己的在線電子書網(wǎng)站嫁审。
搭建gitbook首先要安裝node環(huán)境
安裝好node后,使用node -v
命令查看是否安裝成功
接著全局安裝gitbook-cli
npm install -g gitbook-cli
安裝成功后赖晶,就會多了一個 gitbook
命令(如果沒有土居,請確認(rèn)上面的命令是否加了 -g
)。
接著在電腦中找一個心儀的目錄嬉探,創(chuàng)建一個文件夾擦耀,在文件夾下執(zhí)行命令
gitbook init
執(zhí)行完成后,目錄中會多兩個文件 README.md 和 SUMMARY.md
作用分別是
- README.md —— 書籍的簡介
- SUMMARY.md —— 書籍的目錄
SUMMARY.md的配置方法
# 目錄
* [前言](README.md)
* [章節(jié)名稱](相對路徑)
* [第1節(jié)](相對路徑)
* [第2節(jié)](相對路徑)
* [第3節(jié)](相對路徑)
* [第4節(jié)](相對路徑)
* [第二章](相對路徑)
* [第三章](相對路徑)
書寫完書籍內(nèi)容涩堤,配置好目錄以后眷蜓,在命令行中,再次執(zhí)行命令
gitbook init
重新生成一下目錄和文件
然后執(zhí)行命令
gitbook serve --port [指定端口默認(rèn)4000]
啟動服務(wù)胎围,預(yù)覽書籍吁系,執(zhí)行命令后會對 Markdown 格式的文檔進(jìn)行轉(zhuǎn)換,默認(rèn)轉(zhuǎn)換為 html 格式白魂,最后提示 Serving book on [http://localhost:4000](http://localhost:4000/)
代表服務(wù)啟動完成汽纤,在瀏覽器訪問即可預(yù)覽
如果當(dāng)前書籍寫完了,想要發(fā)布到自己的網(wǎng)站的話福荸,也可以使用命令輸出成html文件使用
gitbook build [書籍路徑] [輸出路徑]
最后搭配git一起使用時蕴坪,只需要在書籍根目錄下執(zhí)行
git init
創(chuàng)建一個git倉庫,然后就愉快的拉取-書寫-提交
循環(huán)即可了。
別忘了在提交的時候忽略掉module文件夾背传,不然每次提交拉取的時候會很痛苦....