本文小編為大家詳細(xì)介紹“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”,內(nèi)容詳細(xì),步驟清晰,細(xì)節(jié)處理妥當(dāng),希望這篇“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”文章能幫助大家解決疑惑,下面跟著小編的思路慢慢深入,一起來學(xué)習(xí)新知識(shí)吧。
網(wǎng)站建設(shè)哪家好,找創(chuàng)新互聯(lián)公司!專注于網(wǎng)頁設(shè)計(jì)、網(wǎng)站建設(shè)、微信開發(fā)、微信小程序定制開發(fā)、集團(tuán)企業(yè)網(wǎng)站建設(shè)等服務(wù)項(xiàng)目。為回饋新老客戶創(chuàng)新互聯(lián)還提供了利津免費(fèi)建站歡迎大家使用!
GitBook簡介
GitBook 是一個(gè)基于 Node.js 的命令行工具,可以用來制作精美的電子書,一些互聯(lián)網(wǎng)公司甚至已經(jīng)使用 GitBook 來編寫自己的產(chǎn)品文檔和操作文檔。功能強(qiáng)大,使用方便,用過都說好。
很多人疑惑 GitBook 是不是 Git 家族的相關(guān)產(chǎn)品,其實(shí) GitBook 和 Git 的關(guān)系就像雷鋒與雷峰塔的關(guān)系一樣,沒有半毛錢關(guān)系。
GitBook 可以使用 Markdown 編輯器來編寫書籍,然后也可以使用 Github/Git 來維護(hù)和管理書籍版本,多人協(xié)同編寫等。
制作出來的電子書可以支持輸出多種文檔格式。
GitBook安裝部署在服務(wù)器上
首先根據(jù)服務(wù)器的操作系統(tǒng)下載 Node.js,下面我主要根據(jù) CentOs 系統(tǒng)進(jìn)行 Node.js 安裝演示。
準(zhǔn)備工作:
云服務(wù)器:創(chuàng)新互聯(lián)云服務(wù)器;
操作系統(tǒng):CentOs;
1、以 yum 方式安裝 Node.js。
curl -sL https://rpm.nodesource.com/setup_10.x | bash -yum install -y nodejs
接下來看看是否安裝成功。
[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)頁 gitbook serve //生成靜態(tài)網(wǎng)頁并運(yùn)行服務(wù)器 gitbook build –gitbook=2.0.1 //生成時(shí)指定gitbook的版本, 本地沒有會(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ùn)行服務(wù)器。
另外,GitBook 在服務(wù)器運(yùn)行需要開放 4000 端口。
通過配置好服務(wù)器的網(wǎng)絡(luò)之后就能通過遠(yuǎn)程訪問我們部署在服務(wù)器上的書籍了。
最后通過訪問 http://創(chuàng)新互聯(lián)服務(wù)器IP地址:4000 就可以看到自己的書籍了。
讀到這里,這篇“gitbook怎么編寫產(chǎn)品文檔并部署到云服務(wù)器中”文章已經(jīng)介紹完畢,想要掌握這篇文章的知識(shí)點(diǎn)還需要大家自己動(dòng)手實(shí)踐使用過才能領(lǐng)會(huì),如果想了解更多相關(guān)內(nèi)容的文章,歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。