1、什么是 Hexo？
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。
2、准备工作
2.1 安装Git
Mac 用户您在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。
安装 Git
Windows：下载并安装 git.
Mac：使用 Homebrew, MacPorts ：brew install git 或下载 安装程序 安装。
Linux (Ubuntu, Debian)：sudo apt-get install git-core
Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core
Windows 用户由于众所周知的原因，从上面的链接下载git for windows最好挂上一个代理，否则下载速度十分缓慢。也可以参考这个页面，收录了存储于百度云的下载地址。
2.2安装 Node.js
安装 Node.js 的最佳方式是使用 nvm。
cURL:
$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh
Wget:
$ wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh
安装完成后，重启终端并执行下列命令即可安装 Node.js。
$ nvm install stable
或者您也可以下载 安装程序 来安装。
Windows 用户
对于windows用户来说，建议使用安装程序进行安装。安装时，请勾选Add to PATH选项。另外，您也可以使用Git Bash，这是git for windows自带的一组程序，提供了Linux风格的shell，在该环境下，您可以直接用上面提到的命令来安装Node.js。打开它的方法很简单，在任意位置单击右键，选择“Git Bash Here”即可。由于Hexo的很多操作都涉及到命令行，您可以考虑始终使用Git Bash来进行操作。
3、安装hexo
执行以下命令：
$ npm install -g hexo-cli
安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm install
新建完成后，指定文件夹的目录如下：
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
接下来要做的就是修改配置文件了，在根目录下找到文件：_config.yml
安装自己的需要进行修改，一般修改下网站标题，作者就可以了
# Site
title: Fenpho //网站标题
subtitle: //网站副标题
description://网站描述
author: fenpho//网站作者
language: zh-CN//语言
timezone://时区
# URL
and root as '/child/'
url: https://fenpho.github.io/ //网站链接
root: / //网站根目录
permalink: :year/:month/:day/:title/ //时间格式
具体的修改方法可以参考官网：Hexo
4、本地预览
- 生成静态文件
$ hexo generate //也可以使用缩写 : $ hexo g - 启动服务器
默认情况下，访问网址为：http://localhost:4000/。
$ hexo server
运行网上面的命令后，打开浏览器输入http://localhost:4000/即可看到页面了，有木有很激动
5、选取主题
接下来你需要做进一步的网站美化工作，到官网去选取一个喜欢的主题吧！我采用了一个叫做TKL的主题：
确定需要使用的主体之后，打开主题的官网下载安装主题即可：
-
右键点击根目录，选择git bash
- 运行如下命令（去主题的github页面找类似下面的命令）
$ git clone https://github.com/SuperKieran/TKL.git themes/tkl
命令中的后面的tkl为存储的目录名字，可以随便修改 - 更新主题相关文件
cd themes/cafe
git pull
- 使用主题
修改根目录下的博客配置文件_config.yml主题属性 theme 为cafe. - 配置主题，这个需要根据不同主题的说明来配置，也可以不配置
好了，主题安装好了，此时需要使用如下命令：
hexo clean && hexo g
hexo server
完成后刷新页面看一下吧
7、添加文章
创建一条博文，运行下面的命令，或者直接新建一个Markdown文件，新建文件需要手动添加文章头部（注意目录source/_posts）
hexo new "your-post-name"
如果想要在新建的同时生成对应的文件夹，用于存放文档的资源文件，如图片，音视频等：将配置文件中的post_asset_folder的值从false改为true即可
post_asset_folder: true
8、文章分类
- 在根目录下scaffolds/post.md中，添加一行categories:（同理可应用在page.md和photo.md）
---
title: {{ title }}
date: {{ date }}
categories:
---
- 在文章的开头配置
---
layout: post
title: 标题
date: 2017-05-26 09:00
author: "Fenpho"
categories:
- 目录名字
tags:
- 标签1
- 标签2
---
- 第三步：配置博客首页归档展示样式。修改主题的配置文件themes目录下对应的主题下面的_config.yml中:
# 博客首页展示文本/访问路径/自定义归档名称
menu:
home: /
essay: /categories/随笔
write: /categories/写作
about: /about
9、添加文章置顶功能
原理：在Hexo生成首页HTML时，将top值高的文章排在前面，达到置顶功能。修改Hexo文件夹下的node_modules/hexo-generator-index/lib/generator.js，在生成文章之前进行文章top值排序。
需添加的代码：
posts.data = posts.data.sort(function(a, b) {
if(a.top && b.top) { // 两篇文章top都有定义
if(a.top == b.top) return b.date - a.date; // 若top值一样则按照文章日期降序排
else return b.top - a.top; // 否则按照top值降序排
}
else if(a.top && !b.top) {
// 以下是只有一篇文章top有定义，那么将有top的排在前面
return -1;
}
else if(!a.top && b.top) {
return 1;
}
else return b.date - a.date; // 都没定义按照文章日期降序排
});
其中涉及Javascript的比较函数：
cmp(var a, var b) {
return a - b; // 升序，降序的话就 b - a
}
修改完成后，只需要在需要置顶的文章上面加上top值，将会根据top值大小来选择置顶顺序top值越大越靠前。需要注意的是，这个文件不是主题的一部分，也不是Git管理的，备份的时候比较容易忽略。
以下是最终的generator.js
'use strict';
var pagination = require('hexo-pagination');
module.exports = function(locals){
var config = this.config;
var posts = locals.posts;
posts.data = posts.data.sort(function(a, b) {
if(a.top && b.top) {
if(a.top == b.top) return b.date - a.date;
else return b.top - a.top;
}
else if(a.top && !b.top) {
return -1;
}
else if(!a.top && b.top) {
return 1;
}
else return b.date - a.date;
});
var paginationDir = config.pagination_dir || 'page';
return pagination('', posts, {
perPage: config.index_generator.per_page,
layout: ['index', 'archive'],
format: paginationDir + '/%d/',
data: {
__index: true
}
});
};
10、部署到GitHub
10.1 在 GitHub 上的操作
-
新建一个 Repository
在 Repository name 下填写 yourname.github.io,Description (optional) 下填写一些简单的描述（不写也没有关系），如图所示：
-
创建成功之后，进入仓库的设置（点击setting）界面如下图所示：
找到pages选项，选择master branch作为主页
image.png
简单两步 yourname.github.io 这个域名就配置成功了。
10.2、本地操作
- 为 Hexo 安装 Git 插件
安装 hexo-deployer-git，否则会报 ERROR Deployer not found: git 的错误。
npm install hexo-deployer-git --save
修改你的 _config.yml 配置文件，在结尾处加上如下内容：
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:fenpho/fenpho.github.io.git
branch: master
注意repo中的地址为你自己新建的仓库的路径
- 生成静态文件和部署：
hexo g & d
最后出现如下提示就代表成功啦！
INFO Deploy done: git
the end！
