基於Vue的極簡生成器 — Vuepress

哈哈哈hh 發表於 2022-06-01
Vue

為什麼要使用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開通免費,有一定的免費額度,超過額度之後按量付費。

file

二、建立vuepress應用

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

file

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

file

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

file

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

file

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

file

三、在日常環境部署

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

file

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

file

阿里雲開發平臺多端應用

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

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

file



來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/70003733/viewspace-2898398/,如需轉載,請註明出處,否則將追究法律責任。