前端Vuepress工具癖

丢掉烂大街的Hexo吧,用Vuepress搭建专属你的博客吧

2019-07-11  本文已影响241人  doMyselfzy

一、先来聊聊搭建博客

1.1. 什么人喜欢折腾博客

通常如果不是爱折腾或者有特别需求的普通人,一般对于搭建博客的需求其实不大,通常主要一下几类人会搭建博客自己玩玩。

对于上述几类人群,我们再细分一下,他们能够搭建博客的方式。

1.2. 简单对比一下几个吧!(不废话,直接说缺点)

1.3. 废话不多说,直接看效果

预览效果:https://domyselfzy.github.io/

首页

image

文章

image

时间线

image

关于我

image

二、正菜开始

2.1 直接开干

vuepress官网:https://vuepress.vuejs.org/zh/

如果想搭建一个简单的vuepress博客,很简单。

  1. 项目安装

    不推荐全局安装方式,因为一个新手很难把握文件层级

    # 将 VuePress 作为一个本地依赖安装
    yarn add -D vuepress # 或者:npm install -D vuepress
    
    # 新建一个 docs 文件夹
    mkdir docs
    
    # 新建一个 markdown 文件
    echo '# Hello VuePress!' > docs/README.md
    
    # 开始写作
    npx vuepress dev docs
    

    目录如下:

    image
  2. package.json配置

    需要在刚刚生成的文件夹下,找到package.json,在里面添加以下内容(如果没有自己新增)

    {
      "scripts": {
        "docs:dev": "vuepress dev docs",
        "docs:build": "vuepress build docs"
      }
    }
    
  1. 运行命令

    yarn docs:dev # 或者:npm run docs:dev
    

    在浏览器地址上输入:http://localhost:8080/

    于是你就看到以下这个页面了

    image
  2. 构建和生成静态页面

    yarn docs:build # 或者:npm run docs:build
    

至此,一个简单基于vuepress的博客就诞生了!是不是如此简单。

2.2 基于vuepress主题的搭建

肯定很多人看完第一眼感觉,靠,这么low,也好意思拿出来,就是一个白页嘛~

对 ,你说的都对 ,就是这么个白页,但是正是因为这个白页才体现它的强大。

why???

因为我们之后写博客基本都是基于markdown编写 ,所以我们之后vuepress的页面大部分情况都可以通过markdown进行布局。当然如果你是vue的高手,你也可以自己使用vue编写layout布局。

2.2.1 vuepress-theme-reco

这个主题应该是现存vuepress最好的一个主题之一,是博主午后南杂制作的一个超赞主题。

主题地址:https://vuepress-theme-reco.recoluan.com/

2.2.2 动手干

之前我们是以项目安装的方式进行构建

现在不需要了 ,直接安装主题就完了。(废弃之前的文件夹,重新指定一个新文件夹位置my-blog,可以所以指定)

# create
npx vuepress-theme-reco-cli init my-blog
# or
npm install  -g
reco-cli init my-blog

# install
cd my-blog
npm install

# run
npm run dev

# build
npm run build

安装的时候选择1.0版本

image

安装完成后目录如下:

image

基本和之前的类似 ,只是含一些主题文件对应的.md文件

这个时候文件夹是没有node_modules依赖模块,所以我们还是要按照之前的方式重新依赖一遍

yarn add -D vuepress

慢慢等待完成

image

然后,直接运行命令yarn dev直接看效果吧。

效果图:

image

这个就是主题文件运行的效果了。

三、优化篇

至此主要的工作已经全部完成了,下面你就可以定制你需要的博客了。

当然离定制化博客还是差之千里,有兴趣可以关注我的公众号,看一下我之后的文章,专门对vuepress主题进行优化。

具体效果可以参考我的博客:https://domyselfzy.coding.me/

错过时光


image
上一篇 下一篇

猜你喜欢

热点阅读