使用Github Pages搭建个人Blog

使用Github Pages搭建个人Blog

关于使用Github Pages搭建个人Blog的文章网络上到处都是，下面仅记录下简单的流程和搭建过程中遇到的一些坑

创建项目主页

这里直接使用了GithubPages向导中提供的方法

这样整个网站内容都在master分支下

http:// username .github.io/就是你的个人主页的地址了

jekyll模板的使用

随后我们需要创建用于jekyll的网站结构，关于jekyll的更多内容可以参见这里

为了方便所以就先找个jekyll模版用下先

这里我使用的是这个Cayman Theme,结构样式都比较简单，方便之后基于这个搞自己的模版

下载模版放到git目录下即可

本地环境搭建

Ruby环境搭建

jekyll基于Ruby开发，所以需要一个Ruby环境来提供本地测试

Mac OS 已自带Ruby环境(新版Ruby自带gem)

所以Ruby和gem安装这步就省了

windows下安装可以参见这里

安装Bundle

由于国内网络的问题gem基本上是挂掉的

所以使用gem前还是替换淘宝镜像先

gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/

然后执行下面的命令(需要管理员权限):

gem install bundle

页面初始化

bundle使用前需要创建Gemfile文件来定义gem源和插件依赖

模板中通常都会有这个文件，所以使用模板的话，这步通常可以省略

不过要确认下模板中的Gemfile的source是否是淘宝镜像，不是需要替换成 https://ruby.taobao.org/

这里是我的Gemfile文件的内容，

source 'https://ruby.taobao.org/'
gem 'jekyll'
gem 'jekyll-paginate'
gem 'kramdown'
gem 'pygments.rb'

模版Cayman Theme中使用的markdown解释器是redcarpet，

貌似自5月1日以后，github就不再支持这个解释器了，所以这里替换了github默认的解释器kramdown

然后执行

bundle install

来安装相应的依赖 (jekyll也一并安装了)

本地测试

编译并启动本地服务

bundle exec jekyll serve

默认预览地址 http://127.0.0.1:4000/

发布

本地测试通过后 提交分支即可