gitbook配置

1、是什麼

明確一點Git 與 GitBook 就像雷鋒和雷峯塔徹底沒有一點關係。

實際上，GitBook 是 一 個 基 於 Node.js 的 命 令 行 工 具 ， 支 持 Markdown 和 AsciiDoc 兩種語法格式，能夠輸出 HTML、PDF、eBook等格式的電 子書。因此我更喜歡把 GitBook 定義爲文檔格式轉換工具。目前使用的搭配是 GitBook + Typora + Git。

 

2、如何搭建 GitBook 環境？

由於GitBook 是基於 Node.js，因此咱們首先須要安裝 Node.js

1、安裝 Node.js 

下載地址：https://nodejs.org/en/download/

LTS 版本是一個支持 NodeJS 老版本特性的特殊新版本，Current 版本屬於

一個全新的新版本。若是你的NodeJS 應用使用的比較老的 SDK 開發，LTS 版

本能讓你平滑升級到新版本。

若是你的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 的超連接中

 

二、未完待續

　　....