使用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/
发布
本地测试通过后 提交分支即可
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。