使用hexo + github搭建blog

日 14 一月 2018

最近使用jekyll烦了,经常出现博客编译出问题,打算试下hexo,结果很不错,所以直接换成了hexo,这里写个blog留作记录。

1. 安装环境

hexo是本地先编译成功后,再上传到github上,和jekyll不一样(github内部支持)。

这里只介绍linux环境,在windows直接下载软件包安装就行。

安装nodejs, hexo:

sudo apt install nodejs-legacy
sudo npm install hexo -g
# 配置git方式部署
sudo npm install hexo-deployer-git --save

这里可以考虑使用USTC加速下载软件包:

# 编辑 ~/.npmrc
registry=http://npmreg.mirrors.ustc.edu.cn/

2. 配置环境

在github上新建项目,xxx.github.io或者blog,其中xxx是你的用户名。

开启hs-pages功能:在settings里有副标题:GitHub Pages,点击一下Automatic page generator即可。

新建一个文件夹,命名和项目名相同,然后:

sudo hexo init

修改_config.conf,可以参考这个网站

分类可能看不到,解决办法:

> sudo hexo new page categories
# 在source/categories/index.md里date下添加:
type: "categories"
comments: false

3. 添加文章

在source/_post目录下放置文章,命名titleName.md,

里面的文章开头添加:

---
title: titleName
date: xxxx-xx-xx
categories: xxxx
---

可能会需要配置用户信息,user.email和user.name

最后执行:

sudo hexo g
sudo hexo d

输入用户名和密码即可。


hexo对公式的支持有点问题,需要安装插件:

sudo npm install hexo-math --save
# 在blog文件夹中执行:
sudo hexo math install
# 在_config.yml中添加:
mathjax: true

在相应文章的开头添加mathjax: true

blogroll