使用Hexo搭建我的博客的终极资料

1、前言

Hexo 是一个基于 NodeJs 博客框架,能够快速的帮咱们搭建一个博客系统,Hexo使用的是Markdown(下文简称MD)解析文章的,在几秒内便可利用靓丽的主体生成静态网页。javascript

<!--more-->java

推荐使用 Hexo 有三大理由:node

  • 有大量的主题可供人们选择
  • 使用MD解析文章,MD是如今主流的文章格式
  • 能够快速的生成静态网页,对于系统性能要求低

本文将包含的内容:linux

  • Hexo安装
  • 后台模式启动Hexo
  • Hexo主题更换
  • 构建Hexo分类列表页
  • 添加评论功能
  • 使用Hexo-Admin插件更方便的发布文章

本文实践环境:git

  • Ubuntu 16.04

2、Hexo安装

Setp1:安装NodeJs环境

  • 下载对应平台的安装包

输入网址:https://nodejs.org/en/download/ 找到对应的平台进行下载,若是是Windows平台能够直接使用xxx.msi进行傻瓜式的安装便可,若是是Linux系统,须要下载安装包,而后上传到对应的服务器,等待后续的操做。github

  • 解压
tar -xvf node-v8.11.4-linux-x64.tar.xz
  • 设置全局变量
sudo ln /用户Node解压包地址/bin/node /usr/local/bin/node

sudo ln /用户Node解压包地址/bin/node /usr/local/bin/npmnpm

进行如上配置以后,nodejs环境已经安装好了,使用命令查看nodejs版本浏览器

node -v

Setp2:安装Hexo脚手架

npm install hexo-cli -g

所谓的“脚手架”也就是安装对应的客户端,使它具有操做本身的能力。这样说可能有点绕,好比说Hexo脚手架的做用就能够建立Hexo框架的项目,新建页面,编译Hexo项目,发布运行Hexo项目对,脚手架是让其拥有操做自身的能力。服务器

Setp3:初始化Hexo

使用命令:微信

hexo init blog

cd blog

npm install

Setp4:启动Hexo

hexo s

hexo s是hexo server的缩写,正常启动以后,在浏览器输入:http://localhost:4000/

这时候就能看到咱们已经搭好的Hexo博客了,是否是很方便。

3、后台模式启动Hexo

上面咱们已经博客搭好了,可是退出控制台以后发现访问不了了,这是由于启动Hexo访问的命令终止了,这个时候咱们须要使用后台模式来启动Hexo了。

和后台启动NodeJs同样,咱们有两种方式能够实现后台模式启动:

  1. 使用Linux自己自带的nohup命令启动;
  2. 使用第三方守护线程的方式启动,好比PM2;

下来咱们分别来实现以上两种方式。

3.1 使用nohup模式启动

  • nohup启动命令:
nohup hexo s -p 80 &

exit

其中“-p 80”是指定端口号。

  • 中止命令:
killall hexo

3.2 使用PM2启动

Setp1:安装PM2

npm i pm2 -g

Setp2:编写启动脚本

建立app.js,放在博客根目录,代码以下:

//run
const { exec } = require('child_process')
exec('hexo server -p 80',(error, stdout, stderr) => {
        if(error){
                console.log('exec error: ${error}')
                return
        }
        console.log('stdout: ${stdout}');
        console.log('stderr: ${stderr}');
})

Setp3:启动项目

进入博客根目录,输入命令:

pm2 start app.js

更多pm2命令

pm2 stop all #中止全部应用
pm2 restart all #重启全部应用
pm2 delete all #删除全部应用
pm2 list #查看全部应用

3.3 总结

nohup和pm2的区别:

  • nohup比pm2使用更简单
  • pm2功能比nohup更强大,有完善的日志信息,能够查看详细的运行状况
  • pm2有相应的管理视图,能够方便多应用的管理和运行
  • pm2能够设置多实例运行nodejs程序,能够充分利用系统资源

4、主题更换

Hexo另外一个强大之处,在于它有不少的主题可使用,方法地址:https://hexo.io/themes/

选择你喜欢的主题,以“MaterialFlow”为例,更换步骤以下:

Setp1:下载主题

访问:https://github.com/stkevintan... 点击Clone or download => Download ZIP 下载文件到本地。

Setp2:复制主题到服务器

把下载好的文件进行解压以后,拷贝到Hexothemes目录下。

Setp3:修改配置文件

找到Hexo根目录的_config.yml修改:

theme: landscape

theme: material-flow

继续更改根目录的_config.yml文件为本身的信息,好比title,author等,能够参照这个配置文件:

https://github.com/stkevintan...

而主题material-flow下也有一个_config.yml文件,这个文件是配置使用的过程的,好比分类,标签的名称顺序等,查找配置文件:

https://github.com/stkevintan...

Setp4:重启项目

到目前为止已经完成了主题的更换,若是你是使用的nohup就是用“killall hexo”中止,在启动项目便可,若是使用pm2就是用“pm2 restart all”,查看新换的主题吧。

5、构建Hexo分类列表页

使用Hexo是没有分类集合页面的,须要用户本身建立,步骤以下:

Setp1:建立分类页面

hexo new page "categories"

Setp2:配置分类导航

打开主题内的_config.yml,注意不是根目录的_config.yml,配置以下:

menu:
  - name: 首页
    slug: home
    url: /
  - name: 分类
    slug: categories
    url: /categories

把分类显示到导航的第二个,以下图:

Setp3:修改模板

打开文件layout/_partial/article.ejs,找到

<div class="article-entry" itemprop="articleBody">替换div的全部内容为下面这段代码:

<div class="article-entry" itemprop="articleBody">
    <% if (page.type === "tags") { %>
        <div class="tag-cloud">
            <div class="tag-cloud-title">
                <%- _p('counter.tag_cloud', site.tags.length) %>
            </div>
            <div class="tag-cloud-tags">
                <%- tagcloud({
                    min_font: 12,
                    max_font: 30,
                    amount: 200,
                    color: true,
                    start_color: '#ccc',
                    end_color: '#111'
                    }) %>
            </div>
        </div>
        <% } else if (page.type === 'categories') { %>
            <div class="category-all-page">
                <div class="category-all-title">
                    <%- _p('所有分类', site.categories.length) %>
                </div>
                <div class="category-all">
                    <%- list_categories() %>
                </div>
            </div>
            <% } else { %>
                <% if (post.excerpt && index){ %>
                    <%- post.excerpt %>
                        <% } else { %>
                            <%- post.content %>
                                <% } %>
                                    <% } %>
</div>

Setp4:修改样式

以“material-flow”主题为例,打开文件“themes/material-flow/source/less/_article.less”添加下面样式,到文件最底部:

/*tag-cloud*/
.tag-cloud {
  text-align: center;
  margin-top: 50px;
}
.tag-cloud a {
  display: inline-block;
  margin: 10px;
}
.tag-cloud-title {
  font-weight: 700;
  font-size: 24px;
}
.tag-cloud-tags {
  margin-top: 15px;
  a {
    display: inline-block;
    text-decoration: none;
    font-weight: normal;
    font-size: 10px;
    color: #fff;
    line-height: normal;
    padding: 5px 5px 5px 10px;
    position: relative;
    border-radius: 0 5px 5px 0;
    font-family: Menlo, Monaco, "Andale Mono", "lucida console", "Courier New", monospace;
    &:hover {
      opacity: 0.8;
    }
    &:before {
      content: " ";
      width: 0;
      height: 0;
      position: absolute;
      top: 0;
      left: -18px;
      border: 9px solid transparent;
    }
    &:after {
      content: " ";
      width: 4px;
      height: 4px;
      background-color: #fff;
      border-radius: 4px;
      box-shadow: 0 0 0 1px rgba(0, 0, 0, .3);
      position: absolute;
      top: 7px;
      left: 2px;
    }
  }
  a.color1 {
    background: #FF945C;
    &:before {
      border-right-color: #FF945C;
    }
  }
  a.color2 {
    background: #F5C7B7;
    &:before {
      border-right-color: #F5C7B7;
    }
  }
  a.color3 {
    background: #BA8F6C;
    &:before {
      border-right-color: #BA8F6C;
    }
  }
  a.color4 {
    background: #CFB7C4;
    &:before {
      border-right-color: #CFB7C4;
    }
  }
  a.color5 {
    background: #7B5D5F;
    &:before {
      border-right-color: #7B5D5F;
    }
  }
}

/*category-all-page*/
.category-all-page {
  margin-top: 50px;
  .category-all-title {
    font-weight: 700;
    font-size: 24px;
    text-align: center;
  }
  .category-list-item:after {
    content: '';
    clear: both;
    display: table;
  }
  .category-list-count {
    float: right;
    margin-left: 5px;
  }
  .category-list-count:before {
    content: '一共 ';
  }
  .category-list-count:after {
    content: ' 篇文章';
  }
}

效果以下图:

如上的配置设置完以后,还差一步给文章设置了分类以后,才会显示出来。

Setp5:设置文章属性

添加以下属性在MD的开头:

---
title: RabbitMQ在Ubuntu上的环境搭建
date: 2018-06-02
tag: "rabbitmq"
categories:
  - [Java]
  - [MQ]
---

其中:

  • title 文章标题
  • date 文章发布日期
  • tag 文章标签
  • categories 文章分类,多个独立的分类使用上面代码的格式

设置了文章分类以后,全部文章的分类就会自动显示出来了。

6、添加评论功能

本文对接的评论为畅言,畅言微微SOHU出品的,在行业里面使用的很普遍,好比17173,人民网,中国新闻网等调用的畅言,优势是对接简单,国内的速度快,不须要FQ,缺点是嵌套的域名须要备案。

Setp1:注册畅言帐号

访问:https://changyan.kuaizhan.com/ 注册帐号,安装畅言的引导注册应用,获取评论安装代码,每一个应用的都不同,其中appid和conf是独立的,复制畅言评论安装代码。

Setp2:修改主题配置

找到主题下的_config.yml在底部添加:

changyan:
  on: true

Setp3:修改代码

打开文件“material-flowlayout_partialarticle.ejs”替换代码:

<% if (post.comments && config.disqus_shortname){ %>
        <section id="comments">
            <div id="disqus_thread"></div>
        </section>
    <% } %>

为:

<% if (post.comments && theme.changyan.on){ %>
    <%- partial('comments/changyan', {
    }) %>
<% } %>

修改完以后,重启项目。

评论效果以下:

7、使用Hexo-Admin更方便的发布文章

使用Hexo快是快,可是有一个问题,就是每次发布文章都要手动发布到服务器上,而且还要进行服务器重启,是一件很麻烦的事情,那么有没有简单的方法,能够直接经过后台进行文章录入和发布呢?

这就是Hexo-Admin插件的做用,让你能够直接经过后台管理和新增文章,真是太爽了,下来一块儿来看看实现步骤吧。

Setp1:安装Hexo-Admin插件

npm install --save hexo-admin

Setp2:启动插件

通过上面安装已经挖完成了hexo-admin的安装了,这个时候只须要重启项目,访问http://localhost/admin/ 就能够看到管理后台了,以下图:

Setp3:设置密码

咱们发现第一次登陆是没有密码的,这可不行,接下来咱们要设置一个密码,点击管理后台的Settings,以下图:

设置密码1

进入页面以后,输入用户名、密码,保存生成的帐号信息复制到根目录下的_config.yml文件最底下,配置帐号信息,以下图:

设置密码2

重启服务,这个时候,咱们从新访问http://localhost/admin/ 发现生效了,咱们只有输入正常的用户名或者密码才能进入系统。

文章的添加和修改和简书很像,这里就不过多描述了,更多使用的细节用户本身慢慢研究吧。

8、总结

到目前为止,咱们已经把整个博客系统搭建起来了,包括和用户的互动留言,若是须要打赏功能的话,在article.ejs文章下面贴上本身的微信或支付宝的二维码便可,固然还有很赞的博客搜索功能,也是Hexo也是直接支持的,不用用户过多的配置,就这样这个博客系统已经搭建完毕了。

相关文章
相关标签/搜索