如何用Github+jekyll搭建个人免费博客

如何用Github+jekyll搭建个人免费博客

网上众多github+jekyll的博客基本都是基于Mac和Linux系统的，对于Windows的讲解较少，而且实际操作过程中问题众多，很多的答案没有解，只能一点一点的搜索相似的解答。花了大约一天的时间，终于将博客搭建完成，现将具体的步骤讲解如下：

安装平台：win7 64位
整个搭建步骤分为两个方面：1，申请一个 Github 账户，新建一个 repository，并生成 GitHub Pages.
2，利用 jekyll 模板将 GitHub Pages 对应的 repository 界面优化成博客界面

申请Github 账户

可参考：
https://www.jianshu.com/p/abf485c20e3e
需要注意的是，最后有一步不同：

选择【choose a theme】后会选择一个主题，然后依次点击，最终自动生成一个连接

该 repository 会保存在一个XXX.github.io的本地文件中，这个文件夹就是以后我们放博客文章的地方

设置Jekyll模板

Jekyll是一个静态站点生成工具，不需要数据库的支持，通过markdown编写静态文件，生成html页面，并且可以先在本地查看效果，满意之后再提交到Github上，最终在博客主页上看到结果。由于Jekyll是基于Ruby开发的，所以，要想在本地构建一个Jekyll的测试环境，需要具有Ruby的开发和运行环境。下载与本地环境相符的Ruby和RubyDevKit。
具体步骤如下：
1、下载Ruby和RubyDevKit安装包
下载网址：安装包，版本选择有要求，Ruby的版本2.2.0~2.3.0之间，过低导致后续安装包依赖不通过，过高采用MSYS2而不支持DevKit，RubyDevKit的版本选择64位的。我选择的安装包是：

Ruby：Ruby 2.3.0 (x64)

保持默认的路径 C:\Ruby200-x64， 因为安装包明确提出 “请不要使用带有空格的文件夹 (如： Program Files)”
勾选 “Add Ruby executables to your PATH”，这样执行程序会被自动添加至 PATH 而避免不必要的头疼
最后利用命令ruby -v检查是否安装成功

RubyDevKit：DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

运行安装包并解压缩至某文件夹，如 C:\DevKit
在C:\DevKit内运行ruby dk.rb init来初始化来创建 config.yml 文件。
打开config.yml 文件，于末尾添加新的一行 - C:\Ruby23-x64，保存文件并退出。

$ ruby dk.rb init
添加- C:\Ruby23-x64
$ ruby dk.rb install
rubygems 参考[8]
安装之后我们就可以在本地预览测试我们的博客，不用每次都提交到github上

2、安装jekyll
jekyll源

$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/ #修改jekyll源：
$ gem sources -l
*** CURRENT SOURCES ***
https://gems.ruby-china.org
# 请确保只有 gems.ruby-china.org
$ gem install rails #此步和下步为了确保后续gem install rdiscount的安装
$ bundle config mirror.https://rubygems.org https://gems.ruby-china.org 
$ gem install bundle
$ gem install jekyll 
$ gem install rdiscount #Jekyll默认的markdown解析器maruku对中文支持不够完善,所以果断换成RDiscount解析器

3、显示 jekyll 界面
下载 jekyll模板，也可以clone到本地，将其放入 repository 内，然后定位到该文件夹内：

$ jekyll serve
打开浏览器，地址栏输入：
 localhost:4000 即可打开博客预览

[1]： https://www.jianshu.com/p/abf485c20e3e
[2]：http://blog.csdn.net/on_1y/article/details/19259435 -> 介绍详细工作机制
[3]：https://stackoverflow.com/questions/17655806/error-when-installing-ruby-on-rails-failed-to-build-gem-native-extension ->Error when installing Ruby on Rails: “Failed to build gem native extension”
[4]：http://blog.csdn.net/chenleicpp/article/details/45147839 ->前面挺好，后面太简略，发现问题进行不下去
[5]：http://blog.csdn.net/u014015972/article/details/50497254
[6]：https://juejin.im/entry/58eb2b9f2f301e00624d8027
[7]：https://segmentfault.com/a/1190000012468796 ->各版本搭建jekyll
[8]：https://www.jianshu.com/p/88e3474cef72
[9]：http://blog.csdn.net/strugglm/article/details/76577726
[10]：https://rubygems.org/pages/download ->安装rubygems
[11]：http://blog.csdn.net/hitwhylz/article/details/42646197 ->绑定域名