开始学习Jekyll,由于英文不好,光是部署Jekyll环境就遇到了很多问题,一一记录下来,希望能帮助到其它人少走一些弯路。
在学习安装和部署Jekyll的过程中,我也遇到了一些非常好的帖子,推荐一下,也帮助了我很多.
一步步在GitHub上创建博客主页
好了,现在开始,可能部分内容与上面帖子里面有重复,为了详细记录并快速帮助新手,建议先看看上面的帖子。
准备工作
笔者机子环境:windows7 64位
-
进入http://rubyinstaller.org/downloads/下载Ruby和DevKit并安装,因为运行Jekyll需要他们的支持,DevKit请大家选择自己的版本,分64位和32位两个版本
> 请注意:两者的安装目录,不得出现空格,比如Program Files这种目录是不能有的,建议是装在盘的根目录。 -
Ruby装完后,打开系统的命令行,开始那里打“cmd”回车后,进入到Ruby的安装目录,比如笔者是装在“D:\Ruby200-x64”,那么就用命令行进入目录中 输入“ruby –v”,如果如下图所示,则Ruby安装成功,版本号和相关日期不一定一样,视你安装的ruby版本所定如果输入ruby命令,无效,则需要注意是否配置了环境变量,如下图:
-
RubyDevKit安装
下载DevKit之后是一个压缩格式7z,解压完成之后(建议解压在c盘根目录),用cmd进入到刚才解压的目录下,运行下面命令,该命令会在Devkit根目录下生成config.yml。
$ruby dk.rb init
config.yml文件实际上是检测系统安装的ruby的位置并记录在这个文件中,以便稍后使用。但上面的命令只针对使用rubyinstall安装的ruby有效,如果是其他方式安装的话,需要手动修改config.yml。我生成的config.yml文件内容如下:(注意路径用的是linux的斜杠方向)
# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#
---
- C:/Ruby193 (检查该目录是否存在或者正确)
最后,执行如下命令,执行安装:
$ruby setup.rb
如果没有setup.rb的话,执行:
$ruby dk.rb install
然后输入命令“gem -v” 就会显示安装的gem版本号,就证明成功,简单来说,就是运行Jekyll需要gem,gem需要ruby。 -
安装好gem之后,由于国内网络问题(你懂得),我们需要更换gem的源/容器镜像,只需要执行一下命令:
这个命令的意思是增加淘宝镜像,删除自带的镜像,命令执行完成之后,可以执行该命令查看:$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org
我在这一步遇到了一个问题,耽搁了比较久的时间,就是添加淘宝镜像的过程中一直报错:SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://rubygems.global.ssl.fastly.net/quick/Marshal.4.8/jekyll-1.3.0.gemspec.rz)$ gem sources -l
ERROR: Possible alternatives: jekyll ,这个错误说签名证书错误,于是我们需要下载新的认证证书:http://curl.haxx.se/ca/cacert.pem,然后把cacert.pem移动到Ruby里面的bin目录下,配置证书环境变量:,然后重启,再进行安装即可。 - 安装jekyll,输入命令即可:gem install jekyll,如果正确切换了淘宝镜像,这一步应该比较是会顺利完成。
- 到此为止,整个本地Jekyll环境就配好了,接下来就是git jekyll模版,进行jekyll本地开发测试了。