Hexo的安装记录

参考文献：
hexo中文文档
http://opiece.me/2015/04/09/hexo-guide/
http://blog.csdn.net/jzooo/article/details/46781805
http://blog.csdn.net/xuezhisdc/article/details/53130328

博主环境：Windows8.1

1. 前置条件—— 安装Git、Node.js

参考 hexo中文文档概述篇，没什么要补充的。

2. 安装Hexo

第一步：

前置条件满足后，即Git、Node.js安装完成后，即可使用npm 安装 Hexo。
（npm是Git下的命令。若出现命令无法执行，检查下环境变量PATH。）

$ npm install -g hexo-cli

安装完成后的界面如下图：

图2-1 npm install -g hexo-cli

第二步：设置初始环境

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。这个指定的文件夹就是以后的工作目录。我将它放在了G:\Hexo 路径下。

$ hexo init 
$ hexo init G:\Hexo     #我将它放在了G:\Hexo 路径下。

安装完成后的界面如下图：

图2-2 hexo init

第三步：安装依赖

切换到安装的指定文件夹中，安装依赖文件，命令如下：

$ cd 
$ npm install
#这里建议在安装一些组件，防止后续的一些问题的出现
npm install hexo-server --save
npm install hexo-admin --save
npm install hexo-generator-archive --save
npm install hexo-generator-feed --save
npm install hexo-generator-search --save
npm install hexo-generator-tag --save
npm install hexo-deployer-git --save
npm install hexo-generator-sitemap --save

$ npm install 这个命令应该是用来安装一些Node.js 模块。我命令执行的结果如下：

图2-3 npm install

看警告提示，大意是“跳过可选依赖：…………”，命令应该是已经执行成功了，这个WARN 警告可以忽视。

此时已经安装完成了。完成后的指定文件夹下的目录内容如下：
用dir命令查看

图2-4 dir

图2-5 GUI界面

文件目录说明

参见 Hexo中文文档建站

_config.yml

网站的配置信息，可以配置大部分的参数

package.json

应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装，您可以自由移除。

package.json
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^3.0.0",
    "hexo-generator-archive": "^0.1.0",
    "hexo-generator-category": "^0.1.0",
    "hexo-generator-index": "^0.1.0",
    "hexo-generator-tag": "^0.1.0",
    "hexo-renderer-ejs": "^0.1.0",
    "hexo-renderer-stylus": "^0.2.0",
    "hexo-renderer-marked": "^0.2.4",
    "hexo-server": "^0.1.2"
  }
}

scaffolds

模版文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的markdown文件中默认填充的内容。例如，如果您修改scaffold/post.md中的Front-matter内容，那么每次新建一篇文章时都会包含这个修改。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

主题文件夹。Hexo 会根据主题来生成静态页面。

本地预览Hexo博客

第一次使用hexo，在本地创建服务器使用。

hexo generate    # 生成静态页面
hexo s           # 开启本地服务器

图4-1 hexo s

打开浏览器，输入URL：localhost:4000（或127.0.0.1:4000），即可在本地预览，如下：

图4-2 本地预览

按【CTRL + C】后，即可停止本地服务器：

图4-3 关闭本地服务器

将hexo博客部署到github上

Github 准备

首先你要先有一个Github 账号，可以直接去注册一个账号。
注册完成之后，登录，创建一个新的存储仓库：new repositories

图5-1 新建仓库

点击新建仓库之后，界面如下：
注意：箭头所指部分填写仓库名，仓库名格式应该为：用户名.github.io

图5-2 仓库命名

图5-3 协议选择

将hexo部署到Github上

修改配置文件blog/_config.yml，修改deploy项的内容（在文件末尾）。修改方式有两种。

第一种：

利用SSH链接协议，如下所示：

# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: [email protected]:XavierRoot/XavierRoot.github.io.git
  branch: master

第二种：

利用http协议，如下所示：

# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/XavierRoot/XavierRoot.github.io.git
  branch: master

注意：type: git中的冒号后面是有空格的。
输入下面的命令将hexo博客部署到github中：

hexo clean     # 清空静态页面
hexo generate  # 生成静态页面
hexo deploy    # 上传到仓库

打开网页，输入URL：http://Github用户名.github.io，即可打开博客。

还有一种部署到Github上的方法，参见：最简单的Hexo搭建博客教程
大致说下基本思路：就是下载一个Github客户端，然后Clone下来你刚创建的仓库。再将hexo中的public文件夹下的所有东西全部粘贴到你刚刚Clone下来的仓库中，通过Github客户端提交上去，完成部署。
感兴趣的朋友可以自行尝试。

到这里，基本的安装就结束了，但是hexo还有很多的功能尚未接触，也将在接下来使用过程中，一点点的去学习，与大家共同进步。