說明

通過Gitbook我們能快速的編寫自己的電子書，方便將零散的知識整理成體系化的知識。本文介紹從0開始搭建自己的電子書并發布，以及gitbook的使用技巧，如果沒有發布到公網的需求可以不看ng相關章節

安裝

windows的安裝更為簡單，自行百度即可。

在本地把gitbook生成的html發布到服務器nginx，公網也能訪問，為什么還要在服務器安裝gitbook？ 因為之前沒有用nginx做web服務器，直接將md文件傳到服務器，通過 gitbook serve 命令生成一個預覽的網址 。 后面想做個好看的介紹和跳轉到3個版塊的首頁，所以還是裝了個ng做導航

nodeJS安裝

注意版本不要太高，之前用16版本報錯 TypeError [ERR_INVALID_ARG_TYPE]: The “data” argument must

wget https://nodejs.org/dist/latest-v12.x/node-v12.22.12-linux-x64.tar.gz // 下載tar xf node-v12.22.12-linux-x64.tar.gz // 解壓mv node-v12.22.12-linux-x64 node //改名 ln -s /opt/node/bin/npm /usr/local/bin/ //軟連 ln -s /opt/node/bin/node /usr/local/bin/ node -v //查看

gitbook安裝

npm install -g cnpm --registry=https://registry.npm.taobao.org //修改node源npm install -g gitbook-cli ln -s /opt/node/bin/gitbook /usr/local/bin/

到這里就可以使用gitbook，是在本機windows上和服務器上都安裝了gitbook

Nginx安裝

沒有 分享到網上需求的可以省略這一步， gitbook自己的publish功能總是報網絡錯誤， 可能是限制了， 所以自己100多塊買了個云服務器，進行發布。

# 安裝依賴 yum -y install gcc zlib zlib-devel pcre-devel openssl openssl-devel lrzsz #centos8 安裝nginx1.12報錯 :: ‘struct crypt_data’ has no member named ‘current_salt’ #換成centOS7解決 wget http://nginx.org/download/nginx-1.19.9.tar.gz tar -zxvf nginx-1.19.9.tar.gz cd /nginx-1.19.9 #執行配置 ./configure # 編譯安裝(默認安裝在/usr/local/nginx) make make install

常用命令

測試配置文件：/usr/local/nginx/sbin/nginx -t 啟動命令：/usr/local/nginx/sbin/nginx 停止命令：/usr/local/nginx/sbin/nginx -s stop/quit 重啟命令：/usr/local/nginx/sbin/nginx -s reload 查看進程命令：ps -ef | grep nginx 平滑重啟：kill -HUP [Nginx主進程號(即ps命令查到的PID)]

gitbook常用操作

書籍初始化

執行gitbook init后就初始化了書籍， gitbook serve預覽

自動生成的SUMMARY.md和README.md是兩個必須的文件。 不能改文件名，也不能刪可以編輯里面的內容。

README.md是書的前言 也就是打開時默認展示的內容，SUMMARY.md是書的目錄，打開后展示在左邊，章節沒有對應的md文件時就算目錄里寫了也不會展示。 可以通過安裝插件在寫目錄時自動新建對的md文件

SUMMARY.md中就可以導航到對應的章節，目錄很多的話可以加文件夾區分

# Summary* [簡介](README.md) * 第一章 項目說明* [第一節 項目架構](項目架構.md)* [第二節 數據建模](數據建模.md)* [第三節 數倉規范](數倉規范.md) * 第二章 平臺搭建* [第一節 CDH搭建](CDH搭建.md) ...... * 第五章 項目問題記錄

書籍編寫

gitbook是使用的markdown語法，常見的語法網上資料很多，不在贅述。 推薦用Typora進行編寫。

這里分享幾個自己遇到的問題

? 圖片大小 和位置下面的方法都會導致，預覽是沒問題，打包后文字都擠在了一起

<img src="images\1需求分析.png" alt="1需求分析" align=left style="zoom: 57%;" /> 或者 <img src="images\1需求分析.png" alt="1需求分析" align=left height="500" width="500" />

解決方法： 直接插入圖片不加屬性， 大小通過看圖軟件調整

發布

局域網內部分享，生成預覽連接即可，端口可以修改

gitbook serve --lrport 35288 --port 4001

網上分享

gitbook自帶的發布功能總是出現網絡問題，不推薦使用

這里采取的策略是，通過gitbook build生成靜態文件（默認在_book目錄），傳到ng對應目錄即可

插件

查閱文章 https://www.jianshu.com/p/09bf890ec8f6

總結

以上是生活随笔為你收集整理的gitbook搭建在线书籍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。