基於Vue的極簡生成器 — Vuepress

為什麼要使用Vuepress

VuePress由兩部分組成:一個極簡的靜態站點生成器，帶有一個vue支援的主題系統和Plugin API，以及一個為編寫技術文件而最佳化的預設主題。建立它是為了支援Vue自己的子專案的文件需求。

由VuePress生成的每個頁面都有自己的預渲染靜態HTML，提供了良好的載入效能和seo友好。然而，一旦頁面被載入，Vue將接管靜態內容並將其轉換為完整的單頁應用程式(Single-Page Application, SPA)。當使用者在站點中導航時，會根據需要獲取額外的頁面。

透過本教程中，你將從頭開始構建自己的應用，分別使用 create-vuepress-site 生成器 和 雲開發平臺

create-vuepress-site 生成器 快速搭建專案

一、搭建本地開發環境

• 需要NodeJS 10。您可以使用n、nvm或nvm-windows 在同一臺機器上管理多個版本的Node。 要了解如何安裝 Node.js，參閱nodejs.org。 如果你不確定系統中正在執行的 Node.js 版本是什麼，請在終端視窗中執行node -v。

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

• 你可以使用 create-vuepress-site 生成器 來建立專案，生成應用和庫程式碼，以及執行各種持續開發任務，比如測試、打包和部署。

二、建立新的初始應用

• 要想建立一個新的初始應用專案，請執行：

npx create-vuepress-site [optionalDirectoryName]

該命令將以互動方式詢問詳細資訊以配置您的 VuePress 站點的後設資料，例如：

• 專案名
• 描述
• 維護者電子郵件
• 維護者姓名
• 儲存庫 URL

docs完成此操作後，將在當前目錄下的目錄（或自定義目錄名稱，如果透過）中建立一個腳手架文件站點。

三、啟動應用伺服器

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

cd docs
npm install
npm run dev

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

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

參考文獻：

雲開發平臺一鍵部署vuepress

作為vuepress開發者的你，雲開發平臺為你提供了一站式，全雲端的開發平臺，讓你可以開啟瀏覽器就完成開發，除錯，上線，同時雲開發平臺底層呼叫的是阿里雲集團Serverless產品，可以實現低門檻開發，部署，除錯，降低開發上手成本，讓vuepress應用可以一鍵快速部署！

一、建立環境

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

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

二、建立vuepress應用

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

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

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

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

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

三、在日常環境部署

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

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

阿里雲開發平臺多端應用

在平臺中擁有熱門開源應用的中心，以此去為每一位開發者的開發之路保駕護航。目前共涵蓋多個領域，不乏像vuepress.js、React、Nuxt.js、Next.js、AntDesign等熱門必備的框架，也包含了內容管理平臺Hexo、Docusaurus、vuepressPress、Sapper等。提供給您了一個免費、便捷的雲上研發工作平臺，透過學習與實操演練兩種模式，從入門到精通快速上手Serverless和雲開發技術。0門檻全雲端開發、隨時隨地線上協同、業界領先Serverless架構、行業應用一件初始化等特性也同步在每一次的實踐。

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