云開(kāi)發(fā) Docsify 文檔部署

簡(jiǎn)單介紹一下：

云開(kāi)發(fā)：云開(kāi)發(fā)（CloudBase）是一款云端一體化的產(chǎn)品方案 ，采用 serverless 架構(gòu)，免環(huán)境搭建等運(yùn)維事務(wù) ，支持一云多端，助力快速構(gòu)建小程序、Web應(yīng)用、移動(dòng)應(yīng)用。

云開(kāi)發(fā)靜態(tài)網(wǎng)站托管支持通過(guò)云開(kāi)發(fā)SDK調(diào)用服務(wù)端資源如：云函數(shù)、云存儲(chǔ)、云數(shù)據(jù)庫(kù)等，從而將靜態(tài)網(wǎng)站擴(kuò)展為全棧網(wǎng)站

docsify：docsify動(dòng)態(tài)生成文檔網(wǎng)站。與GitBook不同，它不生成靜態(tài)html文件。相反，它聰明地加載和分析您的Markdown文件，并將它們顯示為一個(gè)網(wǎng)站。要開(kāi)始使用它，只需創(chuàng)建一個(gè)index.html和在靜態(tài)網(wǎng)站托管頁(yè)面上部署它.

接下來(lái)我們分三步進(jìn)行：搭建環(huán)境→創(chuàng)建項(xiàng)目→部署

搭建環(huán)境

1.安裝Node.js 和 npm

通過(guò) node -v 命令查看本機(jī)是否安裝，如果沒(méi)有安裝，參考node.js安裝指南 根據(jù)電腦系統(tǒng)環(huán)境進(jìn)行安裝

2.安裝cloudbase/cli

npm install -g @cloudbase/cli

3.安裝docsify-cli

npm i docsify-cli -g

4.測(cè)試安裝是否成功

cloudbase -v
docsify -v

如果看到輸出版本號(hào)，說(shuō)明已經(jīng)安裝成功。

創(chuàng)建項(xiàng)目

初始化這個(gè)項(xiàng)目

docsify init docs

初始化完成后，您可以修改/docs/README.md文件內(nèi)容，然后在本地運(yùn)行

運(yùn)行本地服務(wù)器

docsify serve docs

運(yùn)行成功后，打開(kāi)瀏覽器，訪問(wèn) localhost:3000

部署

創(chuàng)建云開(kāi)發(fā)環(huán)境

訪問(wèn)騰訊云云開(kāi)發(fā)控制臺(tái)，新建【按量計(jì)費(fèi)云開(kāi)發(fā)環(huán)境】，記住云開(kāi)發(fā)環(huán)境ID，我們需要用到云開(kāi)發(fā)網(wǎng)站托管服務(wù)，目前只有按量計(jì)費(fèi)的環(huán)境才支持靜態(tài)托管。

進(jìn)入網(wǎng)站托管控制頁(yè)，開(kāi)通靜態(tài)網(wǎng)站托管服務(wù)

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

登入

tcb login

這個(gè)時(shí)候會(huì)提醒你需要在網(wǎng)頁(yè)中授權(quán)，在彈出的頁(yè)面確認(rèn)授權(quán)

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

執(zhí)行命令上傳文件，記得將這里的 EnvID 替換為你自己的環(huán)境的環(huán)境 ID

tcb hosting:deploy ./ -e EnvID

稍等片刻，文件就上傳好了

查看靜態(tài)網(wǎng)站域名和狀態(tài)

 tcb hosting:detail -e envId 

這個(gè)時(shí)候你會(huì)看到靜態(tài)網(wǎng)站域名，打開(kāi)瀏覽器訪問(wèn)就可以了

這個(gè)時(shí)候你可以訪問(wèn)云開(kāi)發(fā)控制臺(tái)，查看上傳的文件

點(diǎn)擊設(shè)置，就可以看到剛才控制臺(tái)輸出的默認(rèn)域名，當(dāng)然你也可以添加自己的域名

小結(jié)

部署過(guò)程中用到的環(huán)境ID envId ，可以在 云開(kāi)發(fā)控制臺(tái) 查看，docsify的基本使用可以到其官網(wǎng)查看

如果在操作過(guò)程中遇到問(wèn)題，可以評(píng)論留下你的問(wèn)題