什么是vuePress
vuePress是以vue驅動的主題系統的簡約靜態網站生成工具（擁有自己的默認主題）。
veuPress由vue,vue-router,webpack驅動的單頁面應用，每個markdonw文件都使用markdonw-it編譯為html文件，然后作為vue組件的模板來處理。
VuePress 有很多優點：
安裝vuePress
全局安裝
在此方式中，只是要項目根目錄創建了一個README.md文件，直接執行訪問的就是此文件
npm install -g vuepress# 創建一個 markdown 文件echo '# Hello VuePress' > README.md# 開始編寫文檔vuepress dev# 構建vuepress build
在已有項目中安裝
# 安裝為本地依賴項npm install -D vuepress# 創建一個 docs 目錄mkdir docs# 創建一個 markdown 文件echo '# Hello VuePress' > docs/README.md# 開始編寫文檔npx vuepress dev docs
還可以在package.json中添加js腳本，官網方式不好寫，我們直接用常用的方式
{ "scripts": { "start": "vuepress dev docs",//運行 "build": "vuepress build docs"http://打包 }}使用vuePress搭建靜態博客
接下來就是配置了，我會直接把我的配置文件貼上來，我們先看結構
博客結構
博客結構分為主頁，導航欄，側邊欄
在.docs目錄下新建一個.vuePress文件，在此注意，搭建博客過程中所有的配置文件以及內容文件、主題等都放在此目錄中
在.vuePress文件夾下新建三個文件,public用來放圖片等靜態文件，theme中放到博客用到的主題，config.js中存放所有的配置
.vuePress ---public ---theme ---config.js
在.docs文件夾下新建幾個模塊文件夾，比如我的就分為學習筆記、問題記錄、關于我等,每個文件夾下再新建md文件
vuePress會自動把README.md設置為導航的主頁，所以如果我們需要主頁就先建README.md,再新建first.md,seconde.md等文件作為側邊欄要顯示的文件
.docs ---.vuePress ---about ---README.md ---first.md ---seconde.md ---study ---problem
具體配置
最重要的config.js配置
在此值得注意的是，主題配置不只是簡單的樣式配置等，其中包括導航與側邊欄部分的配置，此處配置參見官網導航欄”默認主題配置“
module.exports = { //網站標題 title: '霍夢林的個人博客', // 主頁描述 description: 'Just playing around', // 要部署的倉庫名字 base: '/', dest: './docs/.vuepress/dist', // 主題配置 themeConfig: { // 導航配置 nav: [ // text為導航欄顯示文字，link為路徑，即文件夾名字，注意不要丟了名字前后的'/' {text: 'Home', link: '/'}, {text: 'About', link: '/about/'}, {text: 'Problem', link: '/problem/'}, {text: 'Study', link: '/study/'}, {text: 'CSDN', link: 'http://blog.csdn.net/weixin_38318244/'}, {text: 'Github', link: 'https://github.com/momo-0902'} ], // 側邊欄配置,側邊欄組，不同（導航）頁面對應不同的側邊欄 // 以對象形式配置，前邊的key為nav處的路徑,后邊提供一個數組作為此側邊欄中的子標題 sidebar: { '/problem/': [ // ''空字符串代表主頁，顯示README.md中的內容 '', ['201709', '201709'],//使用數組為側邊欄起別名，前邊是md名稱，后邊是鏈接顯示的文字 ['201710', '201710'], ], '/study/': [ '', ['axios', '1.axios'], ['document', '2.document'], ] }, // 這是嵌套標題鏈接，自動顯示當前激活（導航）頁面標題的鏈接，即顯示深度（h1-h6的深度） sidebarDepth: 1 }}網站主頁配置，即.docs下README.md的配置
---// 使用默認主題home: true // 主頁頭像heroImage: /me.jpg// '開始學習'快捷按鈕actionText: Get Started →// 快捷按鈕跳轉路徑actionLink: /about/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 momo---[[toc]]:tada: :100:啦啦啦德瑪西亞啦啦啦啦擼啊擼啊<!--  -->這里使用了 markdown 的拓展 `[[toc]]`## 這里是momo的博客### 項目中遇到的問題### 學習筆記### csdn### github[關于我](/about/)
theme主題配置
項目中只是把vuePress所有的主題配置都拷貝到了本項目中，項目結構如下：
theme ---styles ---theme.styl ---code.styl ---Home.vue ---Layout.vue ---until.js
打包部署
構建
// 此處構建生成路徑為./docs/.vuepress/dist,由config.js中配置： dest: ‘./docs/.vuepress/dist', vuepress build docs
導航到構建輸出目錄
// config.js中dest配置的輸出目錄是哪此處就cd進入哪，所有的git操作（包含初始，添加，提交等）都在此目錄下 cd docs/.vuepress/distgit init git add -A git commit -m ‘deploy'
推到你的倉庫
如果是部署到<username>.github.io的主頁上
git push origin master
這時可能出現問題
fatal: ‘origin' does not appear to be a git repository
以及fatal: Could not read from remote repository.
解決辦法： 執行git remote add origin git@github.com:<USERNAME>/<REPO>.git
如果是部署到分支上
git push -f git@github.com:<USERNAME>/<REPO>.git master:gh-pages(git push -f git@github.com:momo-0902/wiki.git master:gh-pages)
可在package.json中配置腳本運行
npm start 運行項目
npm run build 打包
npm run deploy 部署
以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持武林網。
新聞熱點
疑難解答
