使用Hexo搭建Github pages

Hexo概述

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

安装

前提：安装Hexo前，必须确保已安装Node.js和Git

若果您的电脑已经安装上述应用程序，则使用npm即可完成Hexo的安装。

$ npm install -g hexo-cli

建站

安装Hexo完成后，在任意目录下建立文件夹，例如在D盘建立Hexo文件夹。进入该文件夹，执行下列命令：

$ hexo init 
$ npm install

新建完成后，Hexo文件夹中的目录如下：

|------_config.xml     #全局配置文件
|------db.json           # 静态常量
|------source             
|        |-----_posts        #你的markdown博文源文件
|------themes         #主题文件
|------scaffolds      #脚手架，也就是一个工具模板
|------scripts          #写文件的js，扩展hexo的功能
|____package.json   #应用程序的信息        

Github建库

使用Github建立一个版本库名称为username.github.io的库

#username为您Github的账号名称

配置

在Hexo文件夹下，使用如下命令克隆版本库：

$ git clone git@github.com:username/username.github.io.git

打开_config.yml文件，修改配置：

# Directory
source_dir: source
public_dir: username.github.io #编程输出目录
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:

public_dir: usernaem.github.io
#注意：冒号与参数值之间必须有空格
deploy:
    type: git
    repository: https://github.com/username/username.github.io.git
    branch: master

使用命令生成静态文件并启动服务器：

$ hexo g && hexo s

在浏览器中访问

http://127.0.0.1:4000

发布的Github Pages

安装Deployer

$ npm install hexo-deployer-git --save

使用命令：

$ hexo g && hexo d

使用浏览器访问：

http://username.github.io/

自定义域名

在source目录下创建名称为 CNAME 文件，在文件中设置域名，例如：pangypeng.com

在申请域名管理系统设置域名映射到 username.github.io