5分鐘站點生成神器——Docusaurus

為什麼要使用Docusaurus

Docusaurus 是 Facebook 專門為開源專案開發者提供的一款易於維護的靜態網站建立工具，使用 Markdown 即可更新網站。構建一個帶有主頁、文件、API、幫助以及部落格頁面的靜態網站，只需5分鐘。

Docusaurus 是一個靜態站點生成器。它構建了一個具有快速客戶端導航的單頁應用程式，利用React的全部功能使您的站點具有互動性。它提供開箱即用的文件功能，但可用於建立任何型別的網站（個人網站、產品、部落格、營銷登入頁面等）。

透過本教程中，你將從頭開始構建自己的應用，分別使用Docusaurus CLI 和 雲開發平臺

Docusaurus-CLI 快速搭建專案

一、搭建本地開發環境

• Docusaurus 需要 Node.js版本 >= 14 或以上（可以透過執行檢查node -v）。您可以使用nvm在安裝的單臺機器上管理多個 Node 版本。安裝 Node.js 時，建議您選中所有與依賴項相關的核取方塊。

• npm 包管理器 因為我們通常都會使用Docusaurus 提供的腳手架搭建專案結構，所以要下載並安裝 npm 包。本指南使用 npm 客戶端命令列介面，該介面預設安裝在 Node.js。要檢查你是否安裝了 npm 客戶端，請在終端視窗中執行 npm -v 。

• Docusaurus 本質上是一組 npm包。

二、建立新的初始應用

• 安裝 Docusaurus 最簡單的方法是使用命令列工具來幫助您搭建 Docusaurus 骨架網站。您可以在新的空儲存庫或現有儲存庫中的任何位置執行此命令，它將建立一個包含腳手架檔案的新目錄。

npx create-docusaurus@latest my-website classic

• 新建完成後，指定資料夾的目錄如下：

my-website
├── blog
│   ├── 2019-05-28-hola.md
│   ├── 2019-05-29-hello-world.md
│   └── 2020-05-30-welcome.md
├── docs
│   ├── doc1.md
│   ├── doc2.md
│   ├── doc3.md
│   └── mdx.md
├── src
│   ├── css
│   │   └── custom.css
│   └── pages
│       ├── styles.module.css
│       └── index.js
├── static
│   └── img
├── docusaurus.config.js
├── package.json
├── README.md
├── sidebars.js
└── yarn.lock

三、啟動應用伺服器

進入工作區目錄，並啟動這個應用。

cd my-website
npm run start

npm run start 命令會構建本應用、啟動開發伺服器、監聽原始檔，並且當那些檔案發生變化時重新構建本應用，

也會開啟瀏覽器，並訪問 。

你會發現本應用正執行在瀏覽器中。

參考文獻：https://docusaurus.io/

雲平臺一鍵部署Docusaurus

一、建立環境

想要一鍵部署Docusaurus，需要以下賬號和服務：

• Github賬號 ()，
• 阿里雲賬號，並使用阿里雲賬號登入雲開發平臺 ()，為保證最好的使用體驗，請使用Chrome瀏覽器。開通OSS服務。
• 未開通阿里雲OSS的使用者，點選連結 (product/open?code=oss)開通OSS服務。OSS開通免費，有一定的免費額度，超過額度之後按量付費。

二、建立Docusaurus應用

• 建立前端應用。開啟快速開始 app，找到 Docusaurus 點選建立「建立應用」按鈕。

• 雲資源訪問授權。如果您之前沒有使用過雲開發平臺，會出現雲資源授權管理的選項，往下拉出現直至同意授權的字樣，點選「同意授權」後出現授權成功，點選進入「下一步」。

• 繫結Github賬號。授權完成後選擇來源倉庫為Github，按照提示點選去繫結，繫結GitHub帳號，登入後並點選Authorize Aliyunworkben允許雲開發平臺構建、釋出你的GitHub程式碼為可訪問的網站。

• 選擇fork好的“Docusaurus”程式碼倉庫。選擇第一步中的程式碼倉庫，主幹分支，並點選下一步。主幹分支一般指的是程式碼的master或main等分支。

填寫基本資訊，完成建立。填寫基本資訊並點選「完成」。成功後進入到應用詳情和部署介面。

三、在日常環境部署

• 一鍵進行應用部署。在應用詳情頁面點選日常環境的「部署」按鈕進行一鍵部署，部署狀態變成綠色已部署以後可以點選訪問部署網站檢視效果。

• 訪問Docusaurus網站。日常環境的測試域名也是可以訪問的，點選訪問已部署網站按鈕會出現一個彈出，點選彈出上的立即訪問就能夠訪問已經部署好的站點了。在部署完成後，可以繼續本地編碼，並將程式碼push到應用的“基本資訊”中對應的程式碼倉庫內。

多端應用一鍵上雲

現如今身處在隨時會到來新狀況的大環境下，做好自己便是在不安中樹立了一顆屹立不倒的松樹。作為開發者們每天都要面臨新的程式碼、應用，保持隨時學習的狀態和能力也可讓自己多一份安穩。阿里云云開發平臺的初衷是為每一位開發者提供免費、便捷的雲上研發工作平臺，透過學習與實操演練兩種模式，從入門到精通快速上手Serverless和雲開發技術。0門檻全雲端開發、隨時隨地線上協同、業界領先Serverless架構、行業應用一件初始化等特性也透過每次的實踐伴隨著你、我。

雲原生應用、主機應用部署、前端應用部署三大板塊的提供，供開發者們找到最合適自己神器，令開發工作事半功倍。其中滿足IoT語音技能、小程式、H5應用等開發者低門檻應用開發的需求；也支援程式碼編譯部署到ECS主機伺服器的場景，幫助使用者管理傳統主機應用的能力；讓前後端應用能夠更高效地協同。平臺將持續與開發者一起共同成長，幫忙開發者更好、更快以及更低成本的開發，多端的應用更加快速的上雲。

【特別活動】雲開發2週年，0門檻部署上線4款熱門遊戲，遊戲暢玩還有AirPods耳機、筋膜槍等8種獎品任你挑啦，立即參與：activities/bday