GitHub搭建Hexo教程

Hexo简介

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

Hexo官网传送门

搭建前的准备工作

1.本地环境搭建
安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序：

• Node.js
• Git
• 如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

$ npm install -g hexo-cli

2.github环境搭建

安装git的内容跳过，不是本文章介绍范围，默认你已经安装好git并且配置好了SSH

2.1. 创建代码仓库

注意：仓库名应该为：github用户名.github.io 这个用户名使用你的GitHub帐号名称代替，这是固定写法，必须这样写。

开始搭建Hexo

1.安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

$ hexo init 
$ cd 
$ npm install

2.新建完成后，指定文件夹的目录如下：

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

3.生成静态页面

$ hexo clean
$ hexo g

4.本地运行

$ hexo server

server可简写为s

　指令功能参考官方文档

然后打开浏览器，输入地址 localhost:4000 即可在本地看到效果如图

部署到github

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

$ hexo deploy

在开始之前，您必须先在 _config.yml 中修改参数，一个正确的部署配置中至少要有 type 参数

注意： YAML依靠缩进来确定元素间的从属关系。因此，请确保每个deployer的缩进长度相同，并且使用空格缩进。

Git部署需要安装 [hexo-deployer-git]。

$ npm install hexo-deployer-git --save

修改配置。（请注意一定要缩进）

deploy:
  type: git
  repo: 
  branch: [branch]
  message: [message]

参数	描述
repo	库（Repository）地址
branch	分支名称。如果您使用的是 GitHub 或 GitCafe 的话，程序会尝试自动检测。
message	自定义提交信息 (默认为 Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %})