Hexo已经看腻了,来手把手教你使用VuePress搭建个人博客

前端之家收集整理的这篇文章主要介绍了Hexo已经看腻了,来手把手教你使用VuePress搭建个人博客前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

VuePress

vuepress是尤大大4月12日发布的一个全新的基于vue的静态网站生成器,实际上就是一个vue的spa应用,内置webpack,可以用来写文档。

一个基于 Vue SSR 的静态站生成器,本来的目的是爽爽的写文档,但是我发现用来撸一个人博客也非常不错。

上手搭建

你可以跟着文档上的例子自己玩一玩,不过由于VuePress的文档也是用VuePress来实现的,所以我取巧直接拿中的docs目录拿来玩耍。

1.首先安装VuePress到全局

npm install -g vuepress

2.然后把VuePress仓库克隆到你的电脑

git clone

在docs文件中执行(请确保你的 Node.js 版本 >= 8)

当你看到这一行就说明已经成功了:

下面我们打开

发现真的打开了vuepress文档:

下面的工作就是数据的替换了,但我们应该先看一下docs的目录结构:

配置文件 ├─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的中指定home:true,并加上一些其他的元数据。

我们先看看根目录下的README,md:

实在看不懂,有比我更详细的配置说明。

导航配置

导航配置文件在.vuepress/config.js中

在导航配置文件中nav是控制导航栏链接的,你可以把它改成自己的博客目录。

剩下的默认主题配置官方文档都有很详细的文档说明这里就不在啰嗦了。

更改默认主题

你可以在.vuepress/目录下创建一个override.styl文件

vuepress提供四个可更改的颜色:

主题色 $textColor = #2c3e50 // 文字颜色 $borderColor = #eaecef // 边框颜色 $codeBgColor = #282c34 // 代码背景颜色

我把它改成了这样:

侧边栏的实现

由于评论区里问的人较多,所以在这里更新一下,其实我就算在这里写的再详细也不如大家去看官方文档。

侧边栏的配置也在.vuepress/config.js中:

侧边栏名称 collapsable: true,// 可折叠 children: [ '/blog/JavaScript/学会了ES6,就不会写出那样的代码',// 你的md文件地址 ] },{ title: 'CSS',collapsable: true,children: [ '/blog/CSS/搞懂Z-index的所有细节',] },{ title: 'HTTP',children: [ '/blog/HTTP/认识HTTP-Cookie和Session篇',]

对应的文档结构:

博客目录 │ ├─CSS │ ├─HTTP │ └─JavaScript

我的博客nofollow" target="_blank" href="http://brownhu.site/">brownhu

部署

在配置好你博客之后,命令行执行:

Vuepress build

当你看到这一行就说明成功了:

Success! Generated static files in vuepress.

将打包好的vuepress目录上传到你的github仓库,和github page配合,就可以配置好你的博客网站了。

猜你在找的Vue相关文章