gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中

本文小編為大家詳細(xì)介紹“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”，內(nèi)容詳細(xì)，步驟清晰，細(xì)節(jié)處理妥當(dāng)，希望這篇“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”文章能幫助大家解決疑惑，下面跟著小編的思路慢慢深入，一起來(lái)學(xué)習(xí)新知識(shí)吧。

GitBook簡(jiǎn)介

GitBook 是一個(gè)基于 Node.js 的命令行工具，可以用來(lái)制作精美的電子書，一些互聯(lián)網(wǎng)公司甚至已經(jīng)使用 GitBook 來(lái)編寫自己的產(chǎn)品文檔和操作文檔。功能強(qiáng)大，使用方便，用過(guò)都說(shuō)好。

很多人疑惑 GitBook 是不是 Git 家族的相關(guān)產(chǎn)品，其實(shí) GitBook 和 Git 的關(guān)系就像雷鋒與雷峰塔的關(guān)系一樣，沒(méi)有半毛錢關(guān)系。

GitBook 可以使用 Markdown 編輯器來(lái)編寫書籍，然后也可以使用 Github/Git 來(lái)維護(hù)和管理書籍版本，多人協(xié)同編寫等。

制作出來(lái)的電子書可以支持輸出多種文檔格式。

GitBook安裝部署在服務(wù)器上

首先根據(jù)服務(wù)器的操作系統(tǒng)下載 Node.js，下面我主要根據(jù) CentOs 系統(tǒng)進(jìn)行 Node.js 安裝演示。

準(zhǔn)備工作：

云服務(wù)器：億速云云服務(wù)器；

操作系統(tǒng)：CentOs；
1、以 yum 方式安裝 Node.js。

curl -sL https://rpm.nodesource.com/setup_10.x | bash -yum install -y nodejs

接下來(lái)看看是否安裝成功。

[root@localhost /]# node -v
v12.16.0
[root@localhost /]# npm -v
6.13.4

2、安裝 GitBook。

全局安裝：npm install gitbook-cli -g 這個(gè)執(zhí)行完畢之后，gitbook -v 可以查看到gitbook版本，就表示安裝成功。

GitBook 有如下命令，常用到的有前面6個(gè)：

gitbook init //初始化目錄文件
gitbook help //列出gitbook所有的命令
gitbook –help //輸出gitbook-cli的幫助信息
gitbook build //生成靜態(tài)網(wǎng)頁(yè)
gitbook serve //生成靜態(tài)網(wǎng)頁(yè)并運(yùn)行服務(wù)器
gitbook build –gitbook=2.0.1 //生成時(shí)指定gitbook的版本, 本地沒(méi)有會(huì)先下載
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出遠(yuǎn)程可用的gitbook版本
gitbook fetch 標(biāo)簽/版本號(hào) //安裝對(duì)應(yīng)的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸載對(duì)應(yīng)的gitbook版本
gitbook build –log=debug //指定log的級(jí)別
gitbook builid –debug //輸出錯(cuò)誤信息

創(chuàng)建 GitBook 電子書

進(jìn)入想要?jiǎng)?chuàng)建電子書的目錄執(zhí)行 gitbook init 命令。

等待執(zhí)行完成之后會(huì)在目錄下生成 README.md 文件和 SUMMARY.md 文件，這兩個(gè)文件可以使用 Markdown 編輯器進(jìn)行編寫。SUMMARY.md 文件里面主要寫章節(jié)目錄信息，README.md 文件里面主要寫書籍內(nèi)容。

發(fā)布電子書
書籍編寫完成之后 使用上面提到的 gitbook serve 命令將書籍生成靜態(tài)網(wǎng)頁(yè)并運(yùn)行服務(wù)器。

另外，GitBook 在服務(wù)器運(yùn)行需要開放 4000 端口。

通過(guò)配置好服務(wù)器的網(wǎng)絡(luò)之后就能通過(guò)遠(yuǎn)程訪問(wèn)我們部署在服務(wù)器上的書籍了。

最后通過(guò)訪問(wèn) http://億速云服務(wù)器IP地址:4000 就可以看到自己的書籍了。

讀到這里，這篇“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”文章已經(jīng)介紹完畢，想要掌握這篇文章的知識(shí)點(diǎn)還需要大家自己動(dòng)手實(shí)踐使用過(guò)才能領(lǐng)會(huì)，如果想了解更多相關(guān)內(nèi)容的文章，歡迎關(guān)注億速云行業(yè)資訊頻道。