1、gitbook介紹
GitBook是一個命令行工具(和Node.js庫),用於使用GitHub / Git和Markdown(或AsciiDoc)構建精美的書籍;gitbook 的默認語法就是markdown,能夠很好的展現你的內容,並且排版都不需要你擔心,在此基礎上,會自動生成目錄、父子級、划分列表,讓你把所有的精力都放在內容,還可以直接部署在互聯網上;markdown文件的格式為.md,可通過文本編輯器直接打開和編輯,常用Typora軟件來編輯;
Typora下載地址:https://www.typora.io/
2、gitbook linux環境安裝部署
2.1、nodejs安裝部署
1)下載
wget http://cdn.npm.taobao.org/dist/node/v10.16.0/node-v10.16.0-linux-x64.tar.xz
2)解壓
tar -xvf node-v10.16.0-linux-x64.tar.xz
3)重命名
mv node-v10.16.0-linux-x64 nodejs
4)移動到/usr/local目錄
mv nodejs /usr/local
5)建立軟鏈接(為node和npm建立軟鏈接,確保node和npm命令能直接使用)
ln -s /usr/local/nodejs/bin/node /usr/bin/node
ln -s /usr/local/nodejs/bin/npm /usr/bin/npm
6)安裝驗證
node -v
成功安裝可顯示nodejs版本號;
2.2、gitbook安裝
1)安裝gitbook-cli
npm install gitbook-cli -g
2)建立軟鏈接(為gitbook建立軟鏈接)
ln -s /usr/local/nodejs/bin/gitbook /usr/bin/gitbook
3)安裝驗證
gitbook -V
安裝成功,輸出gitbook版本號;
2.3、gitbook初始化編譯啟動
1)新建目錄gitbook,用於存放gitbook文件
mkdir gitbook
2)初始化gitbook
進入gitbook目錄,執行初始化命令:
gitbook init
執行結果:
warn: no summary file in this book info: create README.md info: create SUMMARY.md info: initialization is finished
自動在gitbook目錄下生成README.md文件和SUMMARY.md文件;
3)啟動gitbook
執行啟動命令:
gitbook serve
gitbook啟動后,會生成瀏覽器訪問的地址,可通過瀏覽器訪問gitbook內容,默認為:http://localhost:4000
2.4、瀏覽器訪問gitbook
在瀏覽器輸入地址:http://localhost:4000,localhost可更改為服務器的IP地址,下面為添加相關目錄后顯示的內容;
gitbook相關操作,詳見下一篇:gitboo操作