前端时间我学习了下happypeter老师的GitHub课程,他最后提到了GitHub创建博客的方法,不过仅仅只是粗略了讲了下,并没有提到jekyll的任何内容。但我抱着仅有的好奇心,看了几篇关于jekyll的博客之后进行了jekyll的初步尝试,得到一些经验与各位交流下,希望能为新手提供部分参考。

创建GitHub博客项目

搭建jekyll平台环境

Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录,其中包含原始文本格式的文档,通过 Markdown (或者 Textile) 以及 Liquid转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上,也就是说,你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站,而且是完全免费的。

下面的在window上(我使用的是win10)主要步骤(参考自一位印度大神Madhur Ahuja的博客)。

  1. 安装Ruby,

使用rubyinstall安装:下载地址 http://rubyinstaller.org/downloads/

  1. 安装DEVELOPMENT KIT,

根据自己的系统版本选选择,我下的是DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe,下载地址同上 在cmd或powershell上运行ruby dk.rb init进行初始化,然后运行ruby dk.rb install安装

  1. 安装jekyll

终于来到核心步骤,使用gem安装jekyll,运行gem install jekyll即可进行安装,但是这里有个Madhur Ahuja没有提到的坑——gem使用的是asw服务器在国内会出现fetchError也就是连接不到服务器,所以下载不了。不过有gem使用经验的人(如使用gem下载sass或rails的过程中也会出现这一问题),早就有了解决办法——使用淘宝团队的ruby镜像服务器来替代

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

使用jekyll开始博客项目

在安装完jekyll后就可以开始建博客项目了,在你的工作目录下运行jekyll new yourBlogName 自动生成了一个博客项目,然后切换的yourBlogName目录下运行jekyll serve就可以启动jekyll自带的服务器测试博客了,测试地址为localhost:4000/

然后你就可以在_post目录下新建md文档写博客了,有关jekyll配置文件可以参考jekyll的文档,中文版见 http://jekyll.bootcss.com/docs/