VuePress
vuepress是尤大大4月12日發布的一個全新的基于vue的靜態網站生成器，實際上就是一個vue的spa應用，內置webpack，可以用來寫文檔。
一個基于 Vue SSR 的靜態站生成器，本來的目的是爽爽的寫文檔，但是我發現用來擼一個人博客也非常不錯。
上手搭建
你可以跟著文檔上的例子自己玩一玩，不過由于VuePress的文檔也是用VuePress來實現的，所以我取巧直接拿VuePress倉庫中的docs目錄拿來玩耍。
1.首先安裝VuePress到全局
npm install -g vuepress
2.然后把VuePress倉庫克隆到你的電腦
git clone git@github.com:docschina/vuepress.git
在docs文件中執行（請確保你的 Node.js 版本 >= 8）
cd vuepresscd docsvuepress dev
當你看到這一行就說明已經成功了：
VuePress dev server listening at http://localhost:8080/
下面我們打開http://localhost:8080/
發現真的打開了vuepress文檔：
下面的工作就是數據的替換了，但我們應該先看一下docs的目錄結構：
├─.vuepress│ ├─components│ └─public│ └─icons│ └─config.js // 配置文件├─config // Vuepress文檔的配置參考內容├─default-theme-config // Vuepress文檔的默認主題配置內容├─guide // Vuepress文檔的指南內容└─zh // 中文文檔目錄 ├─config ├─default-theme-config └─guide└─README.md // 首頁配置文件
文檔分成了兩部分，中文文檔在/zh/目錄下，英文文檔在根目錄下。
其實目錄里面的東西都挺好看懂的，首先guide 、default-theme-config、config 這三個目錄中的都是Vuepress文檔的主要內容，從中文文檔里也可以看到只有這三個目錄被替換了。
首頁配置
默認主題提供了一個主頁布局，要使用它，需要在你的根目錄 README.md 的 YAML front matter 中指定 home：true，并加上一些其他的元數據。
我們先看看根目錄下的README,md：
home: true // 是否使用Vuepress默認主題heroImage: /hero.png // 首頁的圖片actionText: Get Started → // 按鈕的文字actionLink: /guide/ // 按鈕跳轉的目錄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 // 頁尾
實在看不懂，官網有比我更詳細的配置說明。
導航配置
導航配置文件在.vuepress/config.js中
在導航配置文件中nav是控制導航欄鏈接的，你可以把它改成自己的博客目錄。
nav: [ { text: 'Guide', link: '/guide/', }, { text: 'Config Reference', link: '/config/' }, { text: 'Default Theme Config', link: '/default-theme-config/' }]剩下的默認主題配置官方文檔都有很詳細的文檔說明這里就不在 主站蜘蛛池模板： 香格里拉县| 浦城县| 二连浩特市| 尼勒克县| 集贤县| 泌阳县| 海阳市| 涟源市| 东兰县| 迭部县| 瑞安市| 东源县| 嘉义市| 白银市| 交城县| 招远市| 滦平县| 化州市| 文登市| 镇康县| 合肥市| 若尔盖县| 湛江市| 徐汇区| 黄浦区| 肇东市| 武川县| 元谋县| 富宁县| 红河县| 洛隆县| 铜川市| 手机| 若尔盖县| 芜湖县| 湛江市| 罗城| 雅江县| 麦盖提县| 政和县| 长兴县|