【转】使用GitHub和Hexo搭建免费静态Blog

原文出处：http://wsgzao.github.io/post/hexo-guide/

前言

习惯自己写Blog的朋友一定不会陌生Wordpress，或许也曾在新浪博客和QQ空间留过脚印，但静心认真思考一下，似乎我们又总是向往更加简单自由的写作方式。GitHub给我们提供了一个无限的空间，我们需要珍惜使用，而Hexo的出现从某种意义上来说代替了Jekyll，让我们可以更专注于写作本身。本文主要介绍自己的实践心得并不断完善内容，衍生知识和原理推荐大家认真阅读官网的手册，其它推荐参考内容链接在文中也会标注出来。

阮一峰 - 喜欢写Blog的人，会经历三个阶段

第一阶段，刚接触Blog，觉得很新鲜，试着选择一个免费空间来写。
第二阶段，发现免费空间限制太多，就自己购买域名和空间，搭建独立博客。
第三阶段，觉得独立博客的管理太麻烦，最好在保留控制权的前提下，让别人来管，自己只负责写文章。

更新历史

2015年03月22日 - 更新Windows下Hexo 3.0安装和升级，感谢 @机智的阿卡林酱
2015年03月10日 - 增加Hexo 3.0降级 2.8
2014年12月19日 - 完善内容
2014年12月09日 - 更新Hexo配置修改部分
2014年06月19日 - 更新全部基础架构，待完善配置修改部分
2014年06月17日 - 更新部分Hexo建站过程，待完善
2014年05月29日 - 撰写初稿

阅读原文 -  http://wsgzao.github.io/post/hexo-guide/

扩展阅读

• Hexo Docs -  http://hexo.io/docs/
• HelloDog Index -  http://wsgzao.github.io/index/#Hexo

准备工作

注意 本文主要针对 Windows平台和 Hexo 3.x

了解Hexo

A fast, simple & powerful blog framework

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。
hexo.io

安装GIT

GitHub Windows

简单可依赖，安装完成后依据提示操作即可，So Easy

安装Node.JS

Node.JS

注意 安装完成后添加Path环境变量，使 npm命令生效

1

;C:\Program Files\nodejs\node_modules\npm

安装Hexo

配置好 GitHub家目录后，双击桌面上的 Git Shell，输入 npm命令即可安装

1      
2

npm install -g hexo-cli      
npm install hexo --save

http://hexo.io/zh-cn/docs/

Hexo初始化配置

创建Hexo文件夹

安装完成后，根据自己喜好建立目录（如 E:\kuaipan\GitHub\hexo），进入 Git Shell切换到该路径下 E:\kuaipan\GitHub\hexo执行以下指令

1

hexo init

安装Hexo插件

1      
2      
3      
4      
5      
6      
7      
8      
9      
10      
11      
12      
13

npm install hexo-generator-index --save      
npm install hexo-generator-archive --save      
npm install hexo-generator-category --save      
npm install hexo-generator-tag --save      
npm install hexo-server --save      
npm install hexo-deployer-git --save      
npm install hexo-deployer-heroku --save      
npm install hexo-deployer-rsync --save      
npm install hexo-deployer-openshift --save      
npm install [email protected] --save      
npm install [email protected] --save      
npm install hexo-generator-feed@1 --save      
npm install hexo-generator-sitemap@1 --save

本地查看效果

继续执行以下命令，成功后可登录 localhost:4000查看效果

1

hexo server

Hexo简写命令

1      
2      
3

hexo n #new      
hexo g #generate      
hexo s #server

部署静态网页到GitHub

注册设置GitHub

1. 登录 GitHub，注册自定义用户名如 wsgzao
2. 在主页右下角创建 New repository，name必须和用户名一致如 wsgzao.github.io
3. 首次创建耐心等待10分钟左右审核，之后即可访问静态主页如 http://wsgzao.github.io

同步内容至GitHub

1. 下载 GitHub Windows
2. 设置 Local path如 E:\快盘\GitHub\
3. 运行 Git Shell切换到如 E:\快盘\GitHub\hexo路径下
4. 执行 hexo g命令生成 public文件夹
5. 把生成的内容全部拷贝到 Local path或其子目录
6. 运行 GitHub确认修改信息后执行右上角的 Sync同步
7. 最后访问主页观察效果

https://pages.github.com/

域名和DNS

域名推荐

GoDaddy makes registering Domain Names fast, simple, and affordable.
【推荐理由】两个字“靠谱”，支持支付宝，附优惠码链接

http://www.godaddy.com/
http://www.gdcodecoupon.com/

DNS推荐

致力于为您提供最稳定、最安全的域名解析服务
【推荐理由】依然是两个字“靠谱”，感谢他们一直以来对于公益的坚持

https://www.dnspod.cn/

设置CNAME

1. 在Github的网站目录下创建 CNAME文件
2. 填写自己的域名如 hellodog.com，保存结束
3. 登录DNSPod，先添加域名，然后添加记录，设置如下

Hexo配置修改

告诉自己为什么要选择Hexo

知识储备

1.勤学勤练Markdown

本地+云端备份数据是一种习惯

• Markdown学习路径 -  http://wsgzao.github.io/post/markdown/

2.使用性感的文本编辑器

工欲善其事必先利其器

• Notepad2
• Sublime Text

http://wsgzao.github.io/post/windows/#文本编辑器

Hexo主题

选择主题建议遵循 KISS原则

• Hexo Themes -  http://hexo.io/themes/
• Pacman -  http://wsgzao.github.io/post/hexo-pacman/
• Jacman -  http://wsgzao.github.io/post/hexo-jacman/

常见问题

1.修改配置文件时注意 YAML语法，参数 冒号:后一定要留 空格
2.中文乱码请修改文件编码格式为 UTF-8

如何迁移至Hexo

http://hexo.io/zh-cn/docs/migration.html

Hexo 2.X 升级 3.0

1.做好相关配置文件和文章的备份
2.做任何修改前不要忘记第一件事备份

https://github.com/hexojs/hexo/wiki/Migrating-from-2.x-to-3.0

Hexo 3.0 降级 2.X

http://sandylaw.tk/2015/03/07/hexo3to2/

推荐阅读

• 如何搭建一个独立博客——简明Github Pages与Hexo教程
• Zippera hexo系列教程
• 前端工程精粹 | 张云龙
• Hexo 3.0 静态博客使用指南