这是一篇关于Hexo搭建个人博客的教程。就算你是新手、按照步骤也能搭建、大佬勿喷！！！自己在搭建的过程中也遇到了一些问题。如果你也想搭建的就按照下面的教程一步一步来、就能搭建好。后续在博客中会更新。。。(样式要更好)。

搭建博客也花了一定的时间、然后把搭建的步骤以及一些方法写出来、算是作为自己的第一篇博客吧！下面我们就开始吧！

前言：什么是 Hexo(https://hexo.io/zh-cn/docs/)，Hexo]是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。因此我们可以通过Hexo+Github搭建博客并且部署到服务器上。

Hexo官网
1、基本环境的搭建

搭建博客之前我们先要安装需要的环境、这里以Windows系统作为演示、其他系统类似。
首先、需要安装 Node.js(http://nodejs.cn/download/) 和 Git(https://git-scm.com/downloads)，大家尽量去下载.exe扩展名的可执行文件，这样的好处是一键安装、省去了一些配置。安装版本也可以安装最新的版本。如果有问题卸载安装旧版。

Node.js

安装完成之后、打开CMD

验证Node.js的方法
node -v
npm -v
输入后能够显示版本说明安装成功、如图：

Git官网

下载速度可能很慢。Winddows用户可以前往 淘宝 Git for Windows(https://npm.taobao.org/mirrors/git-for-windows/) 镜像 下载 git 安装包。
验证Git的方法(CMD中输入)
git –verion
同样输入后能够显示版本说明安装成功。

2、博客搭建

安装Hexo

通过npm命令安装Hexo(CMD中输入)

npm install -g hexo-cli

之后是一些常用的Hexo命令、更详细的参考官方文档(https://hexo.io/zh-cn/docs/commands)

init

hexo init [folder]

创建Hexo网站、folder为文件名、如图

hexo init zykj

这样就代表创建成功。但是发现npm报警告(注意:在windows环境，所以可以忽略这个警告、如果是其他系统、可以通过查阅资料解决。)

Hexo的目录结构：

|– _config.yml
|– package.json
|– scaffolds
|– source
|– _posts
|– public
|– themes
|– .gitignore

_config.yml：网站的全局配置文件，设置包括网站标题、副标题、作者、关键字和描述信息等。
package.json：框架的基本参数信息和它所依赖的插件，在 npm 安装时使用 –save 保存进去。
scaffolds：本意是 “脚手架” 的意思，这里引申为模板文件夹。当你 hexo new [layout(布局)] [title] 的时候，Hexo 会根据该文件夹下的对应文件进行初始化构建。
source：正如其名，source 文件夹存储一些直接来自用户的文件，它很重要，如果不出意外你的文章就是保存在这个文件夹下（_posts）。_posts 目录下的md文件，会被编译成 html 文件，放到 public 文件夹下。
public：参考 source 文件夹，在初始化后是没有 public 文件夹的，除非 hexo g 编译生成静态文件后，public 文件夹会自动生成。使用 hexo clean 清除 db.json 和 public 文件夹下的所有文件。
themes：主题文件夹，存储主题。主题可以在 Github 上 clone。
.gitignore：.gitignore 文件作用是声明不被 git 记录的文件，hexo init 也会产生一个 .gitignore：文件，可以先删除或者直接编辑，对hexo不会有影响。

打开_config.yml文件、找到以下的地方、需要自己配置的几个地方：

Site

title: 网站标题 //网站标题
subtitle: 副标题 //副标题
description: 描述信息 //描述信息
keywords: 关键字 //关键字
author: 作者 //作者
language: zh-CN //语言 可以在 /themes/landscape/languages 找到支持的语言
timezone: Asia/Shanghai //时区 Asia/Shanghai

之后的命令一定要cd到文件夹(博客根目录)中进行操作！！！

这里可以先安装npm install cheerio@0.22.0 –save,在后面使用主题可能会报错，所以先安装这个。

clean

hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

server
hexo server
或(简写)
hexo s

启动服务器。默认访问的网址： http://localhost:4000/ , 还可以带参数。

-p, –port ：重设端口
-s, –static：只使用静态文件
-l, –log：启动日记记录，使用覆盖记录格式

启动成功如图：

generate
hexo generate
或(简写)
hexo g

生成静态文件。

deploy
hexo deploy
或(简写)
hexo d

部署网站。同样可以接参数。

-g, –generate：部署之前预先生成静态文件 。

-m,–message:

这里与后面部署到Github/Gitee上结合使用。

new

hexo new [title]

新建一篇文章。title为文章名。
例子：hexo new “blog”

创建的md文件在 /source/_posts/blog.md 中、一样可以接参数。

-p, –path：自定义新文章的路径
|-r, –replace：如果存在同名文章，将其替换
-s, –slug：文章的 Slug，作为新文章的文件名和发布后的 URL

一个基本的步骤：
hexo new “blog”

hexo clean

hexo s(用于本地调试)

hexo g

hexo d

到这里、你应该了解如何在本地搭建Hexo博客了。接下来是主题美化。

3、主题美化

使用主题可以让我们的博客更加的好看。所以我们选择下载自己喜欢的主题。

Hexo默认使用的是landscape官方主题、我们可以通过下载其他主题进行更换。
1、通过官方主题网站(https://hexo.io/themes/)可以找到主题。
2、直接在Github中搜索hexo-theme相关的内容。

下载主题

git clone Github主题地址 themes/文件名

例如我想下载 Butterfly 主题、只需要git clone https://github.com/jerryc127/hexo-theme-butterfly themes/Butterfly 就可以了。

下载完成之后配置_config.yml、改成上面的那个文件名。

Extensions

Plugins: https://hexo.io/plugins/

Themes: https://hexo.io/themes/

theme: Butterfly

这里介绍我喜欢的几个主题、当然也可以自己去找:
Butterfly(https://github.com/jerryc127/hexo-theme-butterfly): 现在正在使用的主题、页面、个性化都很好、集成了很多插件。

matery(https://github.com/blinkfox/hexo-theme-matery): 一个基于材料设计和响应式设计而成的全面、美观的Hexo主题。

更多关于主题的可以点击上述链接进入官网进行详细的了解。

4、博客部署

博客已经搭建好了、如何部署到Web上呢？

Github提供了Github Pages，Github Pages是Github免费给开发者提供的一款托管个人网站的产品，目前只能托管静态内容，我们使用Hexo搭建的就是静态博客， 所以非常适合用来搭博客。
当然还用Gitee Pages，就不作过多的介绍了。这里使用Github(Github速度太慢、Coding没弄好、所以还是使用Gitee)。

简单介绍一些步骤及命令。(如果没有账号可以先去注册、这里直接讲创建仓库)

步骤很简单，创建仓库、如图：

配置SSH-Key

在Cmd中输入以下内容

git config –global user.name “你的用户名”

git config –global user.email “你的邮箱@example.com”

ssh-keygen -t rsa -C “你的邮箱e@example.com”

然后找到生成的秘钥：位置在 C:/Users/你电脑的用户名/.ssh
用记事本打开id_rsa.pub复制里面的内容

进入 https://github.com/settings/keys 点击New SSH Key把之前复制的内容粘贴到这里就可以了。

安装部署插件

npm install hexo-deployer-git –save

安装完成之后在_config.yml中配置：

deploy:
type: git
repo: 你创建仓库的位置
branch: master

如图：

配置完成之后通过hexo d就可以部署到Github上了。

Github网站地址：

Gitee网址：

5、其他

Hexo博客搭建完成了、主题也美化了、接下来就介绍几个常用的Hexo插件！

Valine 评论功能

无后端的评论功能。

官方教程：https://valine.js.org/quickstart.html

效果如图：

在线音乐播放器、支持一些平台的歌单播放。

官方教程：https://github.com/MoePlayer/hexo-tag-aplayer

效果如图：

显示番剧：想看、在看、已看功能。

官方教程：https://github.com/HCLonely/hexo-bilibili-bangumi

很可爱的Live2D！
Live2D Widget：https://github.com/stevenjoezhang/live2d-widget
Live2D demo：https://github.com/fghrsh/live2d_demo

效果如图：

到这里、Hexo搭建博客到这里就结束了、更多功能可以查阅官方文档。