搭建博客(Github+Hexo+文章管理)

今天刚申请了个域名,就迫不及待的建了个人博客。下面是建立过程:

1. 新建自己的 Github Page

在自己的 Github 上新建一个 repository,取名yourusername.github.ioREADMEgitignore文件不用添加,所有选择默认即可。建好之后,是一个空的仓库,后面会用来保存生成的博客网页。

2. 安装 Hexo

由于 Hexo 这个博客框架更新很快,网上的很多相关博客其实都已经过时,所以还是参考 Hexo 官网的教程为准。

主要命令如下:

1
2
3
4
npm install hexo-cli -g
hexo init blog
cd blog
npm install

除此之外,还需要修改blog文件夹下的_config.yml配置文件,关联之前创建的仓库。命令如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
// 修改前
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type:

// 修改后
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/yourusername/yourusername.github.io.git
branch: master

typerepobranch之前一定要有两个空格,否则会报错。

为了能够识别git,还需要安装hexo-deployer-git包,命令如下:

1
npm install hexo-deployer-git --save

到此就可以本地写博客,并且可以发布到https://github.com/yourusername/yourusername.github.io网页上了。

3. 博客文章管理

除了上班的闲暇时间写写东西外,回家的时候可能也会写点,这时候就遇到了文章的同步问题。既然 Hexo 生成的博客网页可以存放在 github 上,那博客的文章为什么不能呢?所以新建一个仓库,取名blog,专门用来存放博客的源文件。

但是有个问题,就是有些文件是我们在生成博客网页的时候自动生成的。这些其实没有必要同步,而且每次都会重新生成,容易引起冲突。所以我们需要添加一个.gitignore文件,内容如下:

1
2
3
4
5
6
7
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/

当在新机器上写博客时,只需要把源文件 clone 下来,输入命令npm install即可。

4. 安装 maupassant 主题

1
2
3
4
5
6
7
8
9
10
cd blog
git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
npm install hexo-renderer-jade --save
npm install -g cnpm --registry=https://registry.npm.taobao.org # 使用taobao源的cnpm代替官方的npm
cnpm install hexo-renderer-sass --save # 安装hexo-renderer-sass插件
# 修改blog目录下,而不是主题目录下的_config.yml
theme: landscape->theme: maupassant

hexo g
hexo s

参考链接