Hello! 欢迎来到小浪云!


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


一、前言

Hexo 是一个基于 NodeJS 的博客框架,能够快速搭建博客系统。它采用 Markdown(简称 MD)来解析文章内容,并在几秒内生成美观的静态网页。

推荐使用 Hexo 的三大理由:

  1. 提供了丰富的主题选择
  2. 使用 MD 解析文章,MD 是当前主流的文章格式
  3. 可以快速生成静态网页,对系统性能要求低

本文将涵盖以下内容:

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

本文的实践环境为 Ubuntu 16.04。

二、Hexo 安装

步骤1:安装 nodejs 环境

下载对应平台的安装包,访问网址:https://www.php.cn/link/ca491b18f3ec94170f37a9b561f2060c Windows 平台,可以直接使用 .msi 文件进行傻瓜式安装;如果是 Linux 系统,需要下载安装包并上传到服务器,进行后续操作。

解压并设置全局变量后,NodeJs 环境即已安装完毕。使用命令查看 NodeJs 版本:

node -v

步骤2:安装 Hexo 脚手架

所谓的“脚手架”就是安装对应的客户端,使其具备操作自身的能力。例如,Hexo 脚手架可以创建 Hexo 框架项目、新建页面、编译和发布运行 Hexo 项目。

步骤3:初始化 Hexo

使用命令进行初始化:

hexo init

步骤4:启动 Hexo

hexo s 是 hexo server 的缩写。正常启动后,在浏览器输入 http://localhost:4000/ 即可查看搭建好的 Hexo 博客,非常便捷。

三、后台模式启动 Hexo

虽然我们已经搭建好了博客,但在退出控制台后发现无法访问,这是因为启动 Hexo 的命令终止了。此时,我们需要使用后台模式来启动 Hexo。

与后台启动 NodeJs 类似,我们有两种方式可以实现后台模式启动:

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

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

3.1 使用 nohup 模式启动

nohup 启动命令如下,其中 -p 80 指定端口号:

nohup hexo server -p 80 &

停止命令:

killall hexo

3.2 使用 PM2 启动

步骤1:安装 PM2

npm install pm2 -g

步骤2:编写启动脚本

在博客根目录创建 app.js,代码如下:

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}`); });

步骤3:启动项目

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

pm2 start app.js

更多 PM2 命令:

pm2 stop all # 停止所有应用 pm2 restart all # 重启所有应用 pm2 delete all # 删除所有应用 pm2 list # 查看所有应用

3.3 总结 nohup 和 PM2 的区别

  • nohup 使用更简单
  • PM2 功能更强大,提供完善的日志信息,可以查看详细的运行情况
  • PM2 有相应的管理视图,便于多应用的管理和运行
  • PM2 可以设置多实例运行 NodeJs 程序,充分利用系统资源

四、主题更换

Hexo 的另一个优势在于它有许多主题可供选择。方法地址:https://www.php.cn/link/3fc19681d9d74f31286a182d200b9e7f

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

步骤1:下载主题

访问:https://www.php.cn/link/b0e54e59a9fb43e43620e7174d30c2d0 or download” => “Download ZIP”下载文件到本地。

步骤2:复制主题到服务器

将下载好的文件解压后,拷贝到 Hexo 的 themes 目录下。

步骤3:修改配置文件

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

theme: material-flow

继续更改根目录的 _config.yml 文件为自己的信息,比如 title,author 等,可以参照这个配置文件:

https://www.php.cn/link/6b1209c215bc00acef87a8e84a67e62f

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

https://www.php.cn/link/6fd6b19f1b2a8d3f9f402df3c5e05d30

步骤4:重启项目

到目前为止已经完成了主题的更换。如果使用 nohup,使用“killall hexo”停止,然后重新启动项目;如果使用 PM2,使用“pm2 restart all”重启项目,查看新换的主题吧。

五、构建 Hexo 分类列表页

使用 Hexo 时没有分类集合页面,需要用户自己创建,步骤如下:

步骤1:创建分类页面

步骤2:配置分类导航

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

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

将分类显示到导航的第二个,如下图:

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

步骤3:修改模板

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

<div class="article-entry" itemprop="articleBody">

替换 div 的所有内容为下面这段代码:

<div class="article-entry" itemprop="articleBody">   <%- page.content %> 

步骤4:修改样式

以“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: ' 篇文章';   } }

效果如下图:

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

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

步骤5:设置文章属性

在 MD 文件开头添加如下属性:

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

其中:

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

设置了文章分类之后,所有文章的分类就会自动显示出来了。

六、添加评论功能

本文对接的评论为畅言,畅言是 SOHU 出品的,在行业中广泛使用,例如 17173、人民网、中国新闻网等。优点是对接简单,国内的速度快,不需要 FQ;缺点是嵌套的域名需要备案。

步骤1:注册畅言账号

访问:https://www.php.cn/link/34667ff5524af31640044d93b93dc483 注册账号,按照畅言的引导注册应用,获取评论安装代码,每个应用的都不一样,其中 appid 和 conf 是独立的,复制畅言评论安装代码。

步骤2:修改主题配置

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

changyan:   on: true

步骤3:修改代码

打开文件“material-flow/layout/_partial/article.ejs”,替换代码:

<div class="article-entry" itemprop="articleBody">   <%- page.content %> 

相关阅读