【转】使用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 hexo-renderer-marked@0.2 --save npm install hexo-renderer-stylus@0.2 --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，先添加域名，然后添加记录，设置如下

主机记录 记录类型 线路类型 记录值 MX优先级 TTL

@	CNAME	默认	wsgzao.github.io.	-	10
www	CNAME	默认	wsgzao.github.io.	-	10

---

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 静态博客使用指南