使用 hexo + github 快速搭建个人博客

2016-03-06

为什么选择 hexo 来搭建个人博客

  • 免费 - GitHub
  • 快速 - Node运行环境、前端个人站点首选
  • 简洁 - MarkDown
  • 轻量 - 全部静态文件
  • 支持导入WordPress等博客

前提准备

  • node.js   hexo需要用到的语言环境
  • git   静态网页上传到服务器需要用到的版本控制工具
  • hexo   静态网页生成工具

本文主要讲述 hexo 的配置,详情参考 官方文档

配置 hexo

1. 安装 hexo

sudo npm install -g hexo

备注：若安装太慢，可先执行

npm --registry https://registry.npm.taobao.org install express

再执行

sudo npm install -g hexo

2. 新建一个文件夹,进入当前目录

hexo init //初始化

hexo g //生成

hexo s //启动服务, 默认打开 http://localhost:4000/

hexo server -p 5000 //切换端口命令

3. 连接 gitHub

3.1 本地建立仓库 username.github.io

3.2 修改 _config.yml

1
2
3
4
deploy:
  type: 'git'
  repository: git@github.com:username/username.github.io.git
  branch: master

3.3 安装hexo-deployer-git

npm install hexo-deployer-git --save

3.4 hexo clean //清理项目缓存

3.5 hexo g // 重新生成

3.6 hexo d //部署

3.7 测试是否连接成功：打开下面链接，两者内容显示则连接成功

http://localhost:4000/

https://username.github.io/

3.8 更新主题

3.8.1 直接下载源码使用，下载好后，放到 /themes 文件夹里面

3.8.2 _config.yml 里面： theme: xxx

参考代码

参考模板：

1
2
3
git clone https://github.com/iissnan/hexo-theme-next
git clone https://github.com/litten/hexo-theme-yilia.git
git clone https://github.com/Kaijun/hexo-theme-huxblog.git

4. 提交代码

hexo d

如果出现页面刷新不过来问题，执行下面操作

1
2
3
hexo c
hexo g
hexo d
CATALOG