VuePress
vuepress是尤大大4月12日發(fā)布的一個全新的基于vue的靜態(tài)網(wǎng)站生成器，實際上就是一個vue的spa應用，內(nèi)置webpack，可以用來寫文檔。
一個基于 Vue SSR 的靜態(tài)站生成器，本來的目的是爽爽的寫文檔，但是我發(fā)現(xiàn)用來擼一個人博客也非常不錯。
這是VuePress的官方文檔
上手搭建
你可以跟著文檔上的例子自己玩一玩，不過由于VuePress的文檔也是用VuePress來實現(xiàn)的，所以我取巧直接拿VuePress倉庫中的docs目錄拿來玩耍。
1.首先安裝VuePress到全局
npm install -g vuepress
2.然后把VuePress倉庫克隆到你的電腦
git clone git@github.com:docschina/vuepress.git
在docs文件中執(zhí)行（請確保你的 Node.js 版本 >= 8）
cd vuepress cd docs vuepress dev
當你看到這一行就說明已經(jīng)成功了：
VuePress dev server listening at http://localhost:8080/
下面我們打開http://localhost:8080/
發(fā)現(xiàn)真的打開了vuepress文檔：
下面的工作就是數(shù)據(jù)的替換了，但我們應該先看一下docs的目錄結(jié)構(gòu)：
├─.vuepress │ ├─components │ └─public │ └─icons │ └─config.js // 配置文件 ├─config // Vuepress文檔的配置參考內(nèi)容 ├─default-theme-config // Vuepress文檔的默認主題配置內(nèi)容 ├─guide // Vuepress文檔的指南內(nèi)容 └─zh // 中文文檔目錄 ├─config ├─default-theme-config └─guide └─README.md // 首頁配置文件
文檔分成了兩部分，中文文檔在/zh/目錄下，英文文檔在根目錄下。
其實目錄里面的東西都挺好看懂的，首先guide 、default-theme-config、config 這三個目錄中的都是Vuepress文檔的主要內(nèi)容，從中文文檔里也可以看到只有這三個目錄被替換了。
首頁配置
默認主題提供了一個主頁布局，要使用它，需要在你的根目錄 README.md 的 YAML front matter 中指定 home：true，并加上一些其他的元數(shù)據(jù)。
我們先看看根目錄下的README,md：
home: true // 是否使用Vuepress默認主題 heroImage: /hero.png // 首頁的圖片 actionText: Get Started → // 按鈕的文字 actionLink: /guide/ // 按鈕跳轉(zhuǎn)的目錄 features: // 首頁三個特性 - title: Simplicity First details: Minimal setup with markdown-centered project structure helps you focus on writing. - title: Vue-Powered details: Enjoy the dev experience of Vue + webpack, use Vue components in markdown, and develop custom themes with Vue. - title: Performant details: VuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded. footer: MIT Licensed | Copyright © 2018-present Evan You // 頁尾
實在看不懂，官網(wǎng)有比我更詳細的配置說明。
導航配置
導航配置文件在.vuepress/config.js中
在導航配置文件中nav是控制導航欄鏈接的，你可以把它改成自己的博客目錄。
nav: [
{
text: 'Guide',
link: '/guide/',
},
{
text: 'Config Reference',
link: '/config/'
},
{
text: 'Default Theme Config',
link: '/default-theme-config/'
}
]剩下的默認主題配置官方文檔都有很詳細的文檔說明這里就不在啰嗦了。
更改默認主題色
你可以在.vuepress/目錄下創(chuàng)建一個override.styl文件。
vuepress提供四個可更改的顏色：
$accentColor = #3eaf7c // 主題色 $textColor = #2c3e50 // 文字顏色 $borderColor = #eaecef // 邊框顏色 $codeBgColor = #282c34 // 代碼背景顏色
我把它改成了這樣：
側(cè)邊欄的實現(xiàn)
由于評論區(qū)里問的人較多，所以在這里更新一下，其實我就算在這里寫的再詳細也不如大家去看官方文檔。
側(cè)邊欄的配置也在.vuepress/config.js中：
sidebar: [
{
title: 'JavaScript', // 側(cè)邊欄名稱
collapsable: true, // 可折疊
children: [
'/blog/JavaScript/學會了ES6，就不會寫出那樣的代碼', // 你的md文件地址
]
},
{
title: 'CSS',
collapsable: true,
children: [
'/blog/CSS/搞懂Z-index的所有細節(jié)',
]
},
{
title: 'HTTP',
collapsable: true,
children: [
'/blog/HTTP/認識HTTP-Cookie和Session篇',
]
},
]對應的文檔結(jié)構(gòu)：
├─blog // docs目錄下新建一個博客目錄 │ ├─CSS │ ├─HTTP │ └─JavaScript
我的博客：brownhu
部署
在配置好你博客之后，命令行執(zhí)行：
Vuepress build
當你看到這一行就說明成功了：
Success! Generated static files in vuepress.
將打包好的vuepress目錄上傳到你的github倉庫，和github page配合，就可以配置好你的博客網(wǎng)站了。
聲明：本網(wǎng)頁內(nèi)容旨在傳播知識，若有侵權(quán)等問題請及時與本網(wǎng)聯(lián)系，我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com
Copyright ? 2019-2025 51dongshi.com 版權(quán)所有
違法及侵權(quán)請聯(lián)系：TEL:177 7030 7066 E-MAIL:11247931@qq.com 本站由北京市萬商天勤律師事務所王興未律師提供法律服務
