云開發(fā) Gitbook 電子書部署

云開發(fā)靜態(tài)托管是云開發(fā)提供的靜態(tài)網(wǎng)站托管的能力，靜態(tài)資源（HTML、CSS、JavaScript、字體等）的分發(fā)由騰訊云對(duì)象存儲(chǔ) COS 和擁有多個(gè)邊緣網(wǎng)點(diǎn)的騰訊云 CDN 提供支持

GitBook 是一個(gè)開源的電子書生成工具，可以很方便的幫助你生成簡潔大方的電子書，當(dāng)然，云開發(fā)現(xiàn)在也已經(jīng)支持 GitBook 的部署啦～現(xiàn)在你可以在云開發(fā)上部署你的電子書啦～

系統(tǒng)依賴

在進(jìn)行后續(xù)的內(nèi)容前，請(qǐng)先確保你的電腦中安裝了 Node.js 運(yùn)行環(huán)境。如果沒有安裝，可以訪問 nodejs.org 下載安裝。

安裝云開發(fā) cli 工具 和 Gitbook

執(zhí)行如下命令，安裝云開發(fā) cli 工具以及 Gitbook

npm i -g @cloudbase/cli gitbook-cli

本地初始化一個(gè) gitbook 電子書項(xiàng)目

首先，我們創(chuàng)建一個(gè) gitbook 電子書項(xiàng)目,執(zhí)行如下命令來創(chuàng)建一個(gè)電子書

gitbook init book

這樣，我們就在 book 目錄中創(chuàng)建了一個(gè)新的電子書。

可以執(zhí)行命令預(yù)覽一下他

cd book
gitbook serve

啟動(dòng)成功后， 打開瀏覽器的 localhost:4000 ，可以看到我們剛剛新建的電子書

這樣，就說明我們完成了項(xiàng)目的初始化操作。

創(chuàng)建一個(gè)云開發(fā)環(huán)境

完成了本地的 Gitbook 創(chuàng)建，接下來我們來創(chuàng)建一個(gè)云開發(fā)環(huán)境，用來部署 Gitbook 。打開騰訊云控制臺(tái)，在產(chǎn)品中找到云開發(fā)

進(jìn)入到云開發(fā)的管理控制臺(tái)，點(diǎn)擊新建環(huán)境，新建一個(gè)環(huán)境來進(jìn)行部署

新建一個(gè)環(huán)境，名為 docs，并選擇按量計(jì)費(fèi)，開通環(huán)境

在開通環(huán)境以后， 記住你的環(huán)境 ID，這個(gè) ID 后續(xù)我們會(huì)用到。

創(chuàng)建完成后，點(diǎn)擊環(huán)境，進(jìn)入到環(huán)境的管理頁面。點(diǎn)擊左側(cè)菜單欄中的「靜態(tài)網(wǎng)站」

并在靜態(tài)網(wǎng)站頁面開通功能

當(dāng)你看到這樣的界面時(shí)，就說明已經(jīng)開通好了。

你現(xiàn)在可以通過上傳文件手動(dòng)上傳一個(gè)文件測試，稍后，我們將會(huì)用云開發(fā) Cli 來完成上傳。

初始化云開發(fā) Cli

完成了云開發(fā)環(huán)境的配置后， 我們需要初始化一下云開發(fā) cli ，從而實(shí)現(xiàn)借助 cli 來上傳頁面（當(dāng)然， 也可以通過網(wǎng)頁端直接上傳，但 Gitbook 如果文檔頁面較多，還是使用 Cli 上傳更簡單）

在命令行輸入如下代碼

tcb login

會(huì)提醒你需要在網(wǎng)頁中授權(quán)

在彈出的頁面確認(rèn)授權(quán)

確認(rèn)授權(quán)后，你會(huì)看到控制臺(tái)輸出相應(yīng)的命令

部署

這樣，你的云開發(fā) cli 就初始化好了。 接下來，就可以進(jìn)入到最后一個(gè)環(huán)節(jié)，上傳部署 Gitbook 了。

部署 Gitbook

接下來，我們來構(gòu)建 Gitbook 的 HTML ，來進(jìn)行部署，Gitbook 默認(rèn)會(huì)將 HTML 生成在 _book 目錄。我們可以將這個(gè)目錄下的文件進(jìn)行上傳和部署,執(zhí)行如下命令（記得將 envId 替換為你自己的環(huán)境ID）

gitbook build
cd _book
tcb hosting:deploy ./ -e envId

訪問

點(diǎn)擊設(shè)置，進(jìn)入設(shè)置頁面，可以找到默認(rèn)的的域名，點(diǎn)擊域名，就可以看到你剛剛部署的環(huán)境啦。

比如，我的部署以后是這樣的

這樣，就說明你的部署完成啦～

One More Thing

只需簡單的幾步，你就可以輕松實(shí)現(xiàn)將 Gitbook 部署到云開發(fā)上，無需再忍受 Github Pages 的龜速啦！還不快遷移？

不僅如此，如果你是一個(gè)自動(dòng)化愛好者， 還可以試著把云開發(fā) Cli 配置到你的 CI 環(huán)境中，實(shí)現(xiàn)自動(dòng)部署哦～