github创建博客——windows平台下github+jekyll本地环境搭建

在您想要用jekyll搭建一个博客时，想必您肯定了解了git以及github。如果从零开始的话，建议先学一下git以及github入门。

什么是jekyll？

关于jekyll的定义，百度上是这样说的：jekyll是一个简单的免费的Blog生成工具，类似WordPress。但是和WordPress又有很大的不同，原因是jekyll只是一个生成静态网页的工具，不需要数据库支持。但是可以配合第三方服务,例如Disqus。最关键的是jekyll可以免费部署在Github上，而且可以绑定自己的域名。

要想更具体了解jekyll的话，可以到jekyll官网。

下面来说搭建过程。

下载并安装Ruby

Ruby的安装下载可以参考一下菜鸟教程。我安装的是这个：

菜鸟教程上的安装步骤很详细，这里就不再赘述了。安装完成后，也无需安装RubyGems等的工具了，因为用RubyInstaller安装了Ruby都有gems，因此不需要安装其它的东西。

安装完成后，在cmd命令行中输入ruby -v ,若显示ruby的版本信息，则证明安装成功。

安装jekyll

使用gem安装jekyll。按照上面步骤安装好了Ruby后，打开cmd命令框，输入以下命令：

gem install jekyll

这样所有的jekyll的gem依赖包都会被下载下来。

安装 jekyll-paginate ：

gem install jekyll-paginate

在所有安装完成后，提示报一个错误（这里没有截图，大体意思就是提示我没有安装bundler。最后提示这样jekyll  | Error: bundler：）。安装bundler：

gem install bundler

安装完成后，在cmd命令行中输入 jekyll -v ，若显示jekyll的版本信息，则证明安装成功。

修改Ruby的gem源

网上有很多教程建议基础安装完成后，都要通过gem命令将官方源改为淘宝镜像或ruby China，因为默认的官方源是国外的，自我感觉应该是网速限制，获取信息慢。并且要注意的是，现在淘宝源已经停止维护，所以要改为ruby china （网址为： http://gems.ruby-china.org）。

具体步骤：

windows系统进入cmd命令行目录，查看当前使用的source，输入：

gem sources

一般默认的都会是https://rubygems.org。现在我们要删除该源，输入：

gem source -r url //注：此处的url是通过gem source查看的source的url

注意：url必须写全，比如最后的“/”不能丢掉。

现在，我们来添加ruby china的地址，输入：

gem source -a http://gems.ruby-china.org

然后，更新源的缓存，输入：

gem source -u

这样，就完成了ruby的gem源的修改。

最后，再输入 gem sources 检查以下是否成功修改。若url是ruby china的网址，即修改成功。

创建一个博客

好了，以上步骤完成后，我们就可以来创建一个博客测试以下啦~ 您可以从github上fork一个jekyll的现成的模板项目，也可以简单的来测试一下。下面我们创建一个简单的博客，看看是否能成功创建并运行。

比如我在E盘创建一个：打开cmd，命令行切换到E盘，然后输入

jekyll new blog  //注：该处的blog是创建的博客的名称，可以随便更改.

若命令行最后出现类似New jekyll site installed in E:/blog 这样的语句，证明创建博客成功。

接下来就该开启jekyll内置服务器，运行一下我们刚新创建的博客了。

命令行切换到刚新创建的博客目录下: cd blog

然后，输入命令：

jekyll serve

这样就会启动一个地址为http://localhost:4000的服务器。

最后，打开浏览器，输入：http://localhost:4000访问服务器，成功就会出现博客首页。

注意：如果把jekyll serve换为jekyll serve --watch,效果是一样的，只不过加了 --watch,在修改博客页面内容的时候服务器会同步更新，就不用重启服务了，直接刷新浏览器看效果就可以。（还未测试，暂时加上，后期测试）

从远程克隆jekyll模板在本地运行

网上有很多jekyll的博客模板，而且做的很好，我们可以fork到我们的github上，然后再克隆到我们本地的仓库中，模板我们就可以直接拿过来用了。但是，你会发现，当从远程克隆下jekyll模板后，cmd到该jekyll博客的目录下，进行jekyll serve启动服务时，就会报错，我是这样修改的：

在仓库下，找到名为Gemfile的文件，编辑器打开后，将里面的所有内容都注释掉，这样里面就相当于什么都没有了。先别关这个文件，还记得我们刚创建的那个blog的博客嘛，打开windows资源管理器，找到blog这个文件夹进入，找到Gemfile，全选并复制，最后粘贴到我们之前打开的Gemfile注释掉的内容下边，保存，关闭文件。

cmd到我们克隆的博客模板下，输入 jekyll serve 运行。

总结的有很多不完整的地方，后期有问题还会再改。如果您在搭建过程中有什么问题，欢迎留言，我们一起讨论^ .^。