使用GitHub和Hexo搭建免费静态播客

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

扩展阅读

Hexo Docs - http://hexo.io/docs/

准备工作

注意 本文主要针对平台windowsHexo 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命令生效。新版已经会自动配置Path

安装Hexo

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

1
2
npm install hexo-cli -g
npm install hexo --save

Hexo初始化配置

创建Hexo文件夹

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
hexo init

#安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm install

#新建完成后,指定文件夹的目录如下
.
├── _config.yml
├── package.json
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts
└── themes

安装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
4
hexo n #生成文章,或者source\_posts手动编辑
hexo s #本地发布预览效果
hexo g #生成public静态文件
最后我选择手动同步更新至GitHub

部署静态网页到GitHub

注册设置GitHub

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

    同步内容至GitHub

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

Hexo主题

选择自己喜欢的主题
Hexo Themes - http://hexo.io/themes/
Themes Wiki - https://github.com/hexojs/hexo/wiki/Themes

常见问题

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

如何迁移至Hexo

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