使用HEXO搭建github个人网站

HEXO,是一款基于Node.js的轻量的静态博客框架,利用它可以在github上快速构建个人的静态博客。下面就将我自己的构建博客的过程分享给大家。

1 安装环境

1.1 安装node.js

由于HEXO是基于node.js的静态框架,我们首先要安装node环境。在node.js官网进行下载安装.

1.2 安装git及申请github账号

关于git的安装以及github账号的创建,可自行百度或者在官网的指引下操作,此处省略。

1.3安装HEXO

接下来利用npm安装HEXO

1
$ npm install -g hexo

1.4 建立本地博客目录

安装好HEXO后,建立一个文件夹。

1
$ hexo init <fileName>

生成的目录结构,及各目录文件作用:

scaffolds 脚手架,也就是一个工具模板
scripts 写文件的js,扩展hexo的功能
source 存放博客正文内容
source/_drafts 草稿箱
source/_posts 文件箱
themes 存放皮肤的目录
themes/landscape 默认的皮肤
_config.yml 全局的配置文件
db.json 静态常量

然后进入到该文件夹中,执行下面操作:

1
$ npm install

生成静态页面(hexo\public\目录):执行下面命令后,会在本地生成一个public目录。该目录下生成的文件,即为之后上传到github上并用于发布的静态文件。

1
$ hexo generate

本地发布:执行下面命令后,会在启动本地服务,访问localhost:4000,即可看到博客的页面。

1
$ hexo server

2 配置Github

如何将静态博客利用github进行部署呢?下面来看下操作步骤。

2.1 在Github上建立个人Repository

建立reponsity过程可参考Github Pages.

2.2 配置_config.yml文件

在_config.yml文件末尾,配置如下内容。其中,reposity对应的url为上一步在Github上建立的reposity地址。

deploy:
type: git
repository: https://github.com/username/reposityname.github.io.git
branch: master

配置完成后,执行如下命令:

1
$ hexo deploy

因为我建立的reposity名字为cqu2008,所以我就直接在浏览器中访问 http://jiaochunxiao.github.io/

3 建站过程中的一些问题

3.1 本地发布失败

本地发布,执行 hexo server 失败。解决方案: 执行如下命令。

1
$ npm install hexo-server --save

执行完此命令后,再执行

1
$ hexo server

即可看到博客的效果。

3.2 Github部署失败

执行下面命令:

1
$ hexo deploy

会出现: Deployer not found: git
此时执行如下命令:

1
$ npm install hexo-deployer-git --save

此时再去执行,hexo deploy ,就可以成功部署了。

3.3 部署步骤

配置后_config.yml后,通用的三条部署命令(好比是大象装冰箱,一共分三步):

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy

3.4 常用命令

1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本