Jekyll的安装和使用
这个站点使用了github提供的jekyll工具生成html静态网页。所以在本地进行调试时,最好在本地安装jekyll工具,模拟在github生成网页的效果。详细可以参考Github Help中的Using Jekyll with Pages。
ubuntu下安装jekyll
在ubuntu中使用下面的命令安装jekyll:
//jekyll是用ruby写的,所以需要先安装ruby开发环境
$ sudo apt-get install ruby
$ sudo apt-get install ruby-dev
$ sudo gem install rdoc
//安装jekyll
$ sudo gem install jekyll
在本地调试crazepony网站效果:
//进入站点源码目录,开启jekyll服务
$ cd crazepony.github.io
$ jekyll serve
开启jekyll服务之后,在站点源代码下,会生成一个名为_site的目录,该目录下就是jekyll生成的站点静态网页。并且jekyll在本地开启了一个简单的http服务,在浏览器中输入http://localhost:4000/
,就能够看到站点的效果。
windows下安装jekyll
windows下安装jekyll会遇到很多奇奇怪怪的问题,所以可能没法成功,一定要有耐心。下面是在笔者的windows 7,64位系统上配置成功的过程。
Ruby和Ruby DevKit下载地址http://rubyinstaller.org/downloads/。下载ruby 1.9.3版本以及对应的开发包DevKit,ruby 2.0会遇到很多兼容上的错误,不要使用。
- 安装上面下载的Ruby和Ruby DevKit;
- 打开Ruby DevKit安装目录下的shell,输入下面的命令安装jekyll;
$ cd c:
$ cd RubyDevKit193 //进入Ruby DevKit的安装目录
$ ruby dk.rb init
$ ruby dk.rb install
$ gem install jekyll
如果出现安装错误尝试降低jekyll的安装版本,执行以下命令
$ gem install jekyll -v 1.5.0
Portable Python下载地址http://portablepython.com/。下载python 2.7版本并且安装。
至此,在windows下的终端cmd中应该存在jekyll命令。切换到源码路径下,使用jekyll serve
命令就能够开启jekyll的服务,和ubuntu下的使用是一样的。
Jekyll的相关配置
本站点使用到的Jekyll功能或者配置。
- Pagination,博客首页多个Page的设置。
- Templates,Jekyll使用的语法,使用Liquid语法进行解析。其中jekyll配置代码高亮和内嵌gist代码都属于Jekyll语法中的内容。
Poople是一个jekyll主题模板站点,有很不错适合个人博客的模板提供。Crazepony的博客站点使用的BeiYuu的模板,最原始就应该是来自Poople中的Hyde模板。