1、是什麼node
明確一點Git 與 GitBook 就像雷鋒和雷峯塔徹底沒有一點關係。git
實際上,GitBook 是 一 個 基 於 Node.js 的 命 令 行 工 具 , 支 持 Markdown 和 AsciiDoc 兩種語法格式,能夠輸出 HTML、PDF、eBook等格式的電 子書。因此我更喜歡把 GitBook 定義爲文檔格式轉換工具。目前使用的搭配是 GitBook + Typora + Git。npm
2、如何搭建 GitBook 環境?windows
由於GitBook 是基於 Node.js,因此咱們首先須要安裝 Node.js瀏覽器
1、安裝 Node.js bash
下載地址:https://nodejs.org/en/download/markdown
LTS 版本是一個支持 NodeJS 老版本特性的特殊新版本,Current 版本屬於工具
一個全新的新版本。若是你的NodeJS 應用使用的比較老的 SDK 開發,LTS 版spa
本能讓你平滑升級到新版本。命令行
若是你的NdoeJS 應用使用的是全新的 SDK 開發選擇 Current 版本便可。
2、windows 安裝
安裝結束以後使用cmd 控制檯輸入node -v 出現版本號則成功、
若是命令沒法找到。則須要配置環境變量。
1、配置環境變量
將node.js 的路徑加入環境變量,重啓控制檯從新輸出 node -v 便可
4、mac 安裝
1、雙擊安裝程序安裝
以下:
2、顯示程序將會安裝的位置
一直點擊繼續到最後爲
3、在終端中輸入命令
node –v
npm –v
以下:
若展現如上說明node 安裝成功
4、若 node-v 提示爲失敗
- bash: node: command not found
須要配置環境變量了步驟以下
進入,finder 右鍵選擇」前往文件夾」以下
進入etc
文件夾中找到「profile」文件,此文件鎖定能夠複製一份出來加上如下語句:
export NODE_HOME=" node 安裝路徑(bin 路徑的父級路徑)"
export PATH=$PATH:$NODE_HOME/bin
步驟2 中已有 node 安裝路徑爲/usr/local/bin/node因此我本身這邊增長語句以下:
export NODE_HOME="/usr/local" export
PATH=$PATH:$NODE_HOME/bin
ps:( 若是不記得 node 的安裝路徑,能夠打開終端,輸入 which node便可找出node 安裝路徑 )
改完profile 副本文件保存爲不帶後綴的文件,名字亦爲profile 便可覆蓋原來的 profile,環境變量配置好了就能夠按照步驟 3 來驗證了。
2、安裝 gitBook
打開命令行,執行npm install -g gitbook-cli
Gitbook-cli 不能有空格
安裝完成
檢驗:
Gitbook -v
無錯誤便可
3、GitBook 如何使用
1、配置
一、建立一個文件夾名爲 mybook(名字能夠隨便取)
二、在控制檯上找到這個文件夾並輸入gitbook init
安裝成功以後,目錄下會出現兩個文件。
三、將此文件夾拖拽到 VSCode 中就能夠進行吧編輯
SUMMARY.md 爲目錄超連接文檔,語法格式爲:markdown 格式。
小括號內爲超連接
四、點擊此按鈕爲預覽
五、編輯成功以後再 cmd 中運行 gitbook serve
瀏覽器訪問如上地址
六、若是遇到以下問題
請關閉殺毒軟件別問我爲何
運行成功以後爲
七、若是要寫文檔則須要新建一個 .md 文檔將其路徑添加到對應的
SUMMARY.md 的超連接中
二、未完待續
....