Hexo and GitHub Pages as a blogging platform

这里记录下如何结合 HexoGitHub Pages 来写博客。 Hexo 允许你用 markdown 写作,最后生成静态的 HTML 内容。 Github Pages 允许你提交静态的网站,它帮你托管。 二者结合,正好完成从写作到托管一整套博客流程。

以当前我的博客为例。我注册了两个源码库:blogtylerlong.github.io。 第一个源码库用来写作 markdown, 第二个用来托管最终的博客网站。

  • 为什么要用两个源码库? 为什么不用一个源码库的两个分支呢? 因为第二个源码库的内容都是自动生成的,不想它和自己写作的内容混在一起。
  • 另外注意第二个源码库的名称,正好是我的博客的地址。Github 会很智能地托管这个代码库的内容为博客网站的内容。

Hexo 是基于 Node.js 的博客引擎。Node.js 的安装配置以及 Hexo 的安装配置不写了,网上能找到相关资料。下面开始主要的流程:

新建博客:

1
2
3
4
5
6
hexo init blog && cd blog
git init
git add .
git commit -a -m "Initial commit"
git remote add origin git@github.com:tylerlong/blog.git
git push -u origin master

修改 _config.yml 文件:

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: github
  repository: git@github.com:tylerlong/tylerlong.github.io.git
  branch: master

修改 .gitignore 文件,添加:

1
2
public/
.deploy/

新建文章:

1
hexo new "Hexo and GitHub Pages"

生成文件的地址在 source/_posts/hexo-and-github-pages.md,撰写文章内容。

发布博客:

1
2
hexo generate
hexo deploy

浏览博客内容: http://tylerlong.github.io/