介紹
VuePress 是一個以 Markdown 為中心的靜態(tài)網(wǎng)站生成器。你可以使用 Markdown在新窗口打開 來書寫內(nèi)容（如文檔胸囱、博客等）嗡髓，然后 VuePress 會幫助你生成一個靜態(tài)網(wǎng)站來展示它們。
VuePress 誕生的初衷是為了支持 Vue.js 及其子項目的文檔需求业汰，但是現(xiàn)在它已經(jīng)在幫助大量用戶構(gòu)建他們的文檔伙窃、博客和其他靜態(tài)網(wǎng)站。
依賴環(huán)境（優(yōu)先檢查样漆，否則后續(xù)會報錯）
手動安裝
? 步驟 1: 創(chuàng)建并進入一個新目錄
mkdir blog
cd blog
- 步驟 2: 初始化項目
git init
npm init //這個時候會出現(xiàn)一堆選項为障，沒有特殊要求直接回車默認(rèn)就行
- 步驟 3: 將 VuePress 安裝為本地依賴
npm install -D vuepress@next @vuepress/client@next vue
-
步驟 4: 在
package.json中添加一些 script
{
"scripts": {
"dev": "vuepress dev docs",
"build": "vuepress build docs"
}
}
Untitled
-
步驟 5: 將默認(rèn)的臨時目錄和緩存目錄添加到
.gitignore文件中
echo 'node_modules' >> .gitignore
echo '.temp' >> .gitignore
echo '.cache' >> .gitignore
- 步驟 6: 創(chuàng)建你的第一篇文檔
mkdir docs
echo '# Hello VuePress' > docs/README.md
稍微解釋一下：為什么是README.md文件？vuepress默認(rèn)認(rèn)為一個目錄的默認(rèn)文檔是index.md或者README.md放祟，既然這是網(wǎng)站首頁鳍怨，那就是要去尋找當(dāng)前目錄下的index.md或者README.md，你可以嘗試把README.md改成index.md是一樣的效果舞竿，但是改成doc1.md就會報404
? 步驟 7: 在本地啟動服務(wù)器來開發(fā)你的文檔網(wǎng)站
npm run dev
