天天看點

習慣用 Docsify 做文檔?沒問題!滿足你

Docsify 是一個漂亮的動态生成文檔的工具。如果隻是需要快速的搭建一個小型的文檔網站,或者不想因為生成的一堆 .html 檔案“污染” commit 記錄,隻需要建立一個 index.html 就可以開始寫文檔而且直接部署在雲開發靜态托管上。

雲開發(CloudBase)是一款雲端一體化的産品方案 ,采用 serverless 架構,免環境搭建等運維事務 ,支援一雲多端,助力快速建構小程式、Web應用、移動應用。

雲開發靜态網站托管支援通過雲開發SDK調用服務端資源如:雲函數、雲存儲、雲資料庫等,進而将靜态網站擴充為全棧網站。

無論是騰訊雲·雲開發使用者,還是小程式·雲開發使用者,隻要開通按量付費,即可享有雲開發靜态網站托管服務。

Let's Go

接下來我們分三步進行:搭建環境→建立項目→部署

搭建環境

1.安裝Node.js 和 npm

通過 node -v 指令檢視本機是否安裝,如果沒有安裝,參考node.js安裝指南 根據電腦系統環境進行安裝

2.安裝cloudbase/cli

npm install -g @cloudbase/cli

3.安裝docsify-cli

npm i docsify-cli -g

4.測試安裝是否成功

cloudbase -v

docsify -v

如果看到輸出版本号,說明已經安裝成功。

建立項目

初始化這個項目

docsify init docs

初始化完成後,你可以修改 /docs/README.md 檔案内容,然後在本地運作

運作本地伺服器

docsify serve docs

運作成功後,打開浏覽器,通路 localhost:3000

部署

建立雲開發環境

通路騰訊雲雲開發控制台,建立【按量計費雲開發環境】,記住雲開發環境ID,我們需要用到雲開發網站托管服務,目前隻有按量計費的環境才支援靜态托管。

進入網站托管控制頁,開通靜态網站托管服務

當你看到這樣的界面時,就說明已經開通好了。

登入

tcb login

這個時候會提醒你需要在網頁中授權,在彈出的頁面确認授權

确認授權後,你會看到控制台輸出相應的指令

執行指令上傳檔案,記得将這裡的 EnvID 替換為你自己的環境的環境 ID

tcb hosting:deploy ./ -e EnvID

稍等片刻,檔案就上傳好了

檢視靜态網站域名和狀态

tcb hosting:detail -e envId

這個時候你會看到靜态網站域名,打開浏覽器通路就可以了

這個時候你可以通路雲開發控制台,檢視上傳的檔案

點選設定,就可以看到剛才控制台輸出的預設域名,當然你也可以添加自己的域名

小結

部署過程中用到的環境ID envId ,可以在 雲開發控制台 檢視,docsify的基本使用可以到其官網檢視

如果在操作過程中遇到問題,可以評論留下你的問題

One More Thing

雲開發CloudBase全新更新,支援小程式開發、Web和APP多端應用開發!更有9.9元雲開發靜态網站托管包年贊助計劃!還等什麼?快來體驗吧!

公衆号:騰訊雲雲開發

騰訊雲雲開發:https://cloudbase.net

雲開發控制台:https://console.cloud.tencent.com/tcb?from=12304

更多精彩

掃描二維碼了解更多

繼續閱讀