原文链接 https://demon7452.github.io/2015/10/28/%E5%9C%A8Fedora%E4%B8%AD%E4%BD%BF%E7%94%A8jekyll.html
注：以下为加速网络访问所做的原文缓存，经过重新格式化，可能存在格式方面的问题，或偶有遗漏信息，请以原文为准。
安装ruby，RubyGems 和 jekyll
#使用yum安装，这一般不会碰到问题
$ sudo yum install ruby
#ruby-devel可能不会默认安装，可以使用如下命令更新ruby-devel
$ sudo yum install ruby-devel
#安装ruby的过程中会自动安装RubyGems,可以使用如下命令更新RubyGems
$ gem update --system
#安装 jekyll
$ sudo gem install jekyll
#安装过程中可能碰到如下问题
#问题一：
[dev3@localhost ~]$ gem update --system
ERROR: While executing gem ... (Gem::RemoteFetcher::FetchError)
Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://api.rubygems.org/specs.4.8.gz)
#问题二：
[dev3@localhost ~]$ sudo gem install jekyll
Fetching: ffi-1.9.10.gem (100%)
Building native extensions. This could take a while...
ERROR: Error installing jekyll:
ERROR: Failed to build gem native extension.
/usr/bin/ruby -r ./siteconf20151028-8562-rmel60.rb extconf.rb
mkmf.rb can't find header files for ruby at /usr/share/include/ruby.h
extconf failed, exit code 1
Gem files will remain installed in /usr/local/share/gems/gems/ffi-1.9.10 for inspection.
Results logged to /usr/local/lib64/gems/ruby/ffi-1.9.10/gem_make.out
问题解决：
问题一：Gem::RemoteFetcher::FetchError
ERROR: While executing gem ... (Gem::RemoteFetcher::FetchError)
Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://api.rubygems.org/specs.4.8.gz)
#问题原因应该是https://rubygems.org/无法访问，需要将https改为http,解决过程如下
#查看gem sources
$ gem sources --list
*** CURRENT SOURCES ***
https://rubygems.org/
#将http://rubygems.org/加入sources
$ gem sources --add http://rubygems.org/
#将https://rubygems.org/移出sources
$ gem sources --remove https://rubygems.org/
#ok,问题应该解决了。
问题二：ERROR: Failed to build gem native extension.
Fetching: ffi-1.9.10.gem (100%)
Building native extensions. This could take a while...
ERROR: Error installing jekyll:
ERROR: Failed to build gem native extension.
/usr/bin/ruby -r ./siteconf20151028-8562-rmel60.rb extconf.rb
mkmf.rb can't find header files for ruby at /usr/share/include/ruby.h
extconf failed, exit code 1
Gem files will remain installed in /usr/local/share/gems/gems/ffi-1.9.10 for inspection.
Results logged to /usr/local/lib64/gems/ruby/ffi-1.9.10/gem_make.out
//这个错误是因为ruby-devel没有安装，使用如下命令应该就能解决了。
$ sudo yum install ruby-devel
运行 jekyll server 时碰到的错误
#错误描述：
Deprecation: You appear to have pagination turned on, but you haven't included the `jekyll-paginate` gem. Ensure you have `gems: [jekyll-paginate]` in your configuration file.
#解决方法：
$ gem install jekyll-paginate
#错误描述：
Yikes! It looks like you don't have redcarpet or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- redcarpet'
#解决方法：
$ gem install redcarpet
#错误描述：
Yikes! It looks like you don't have pygments or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- pygments'
#解决方法：
$ gem install pygments.rb
#总结：
#类似依赖不存在的话，https://rubygems.org/ 查找的该依赖，然后下载安装。
关于在windows中使用jekyll的说明
在Windows中安装jekyll可以参考文档Windows上安装Jekyll 在运行 jekyll server 时我碰到的问题
问题一：
Conversion error: Jekyll::Converters::Markdown encountered an error while conv
erting '_posts/技术/2014-09-12-Linux-Problems.md':
Failed to get header.
出现该问题的原因是：在windows中jekyll使用的python版本不对，安装的 python 必须是2.7版本。 详细的说明可以参见Failed to get header." 部分原文： This error seems to be caused because of a component of jekyll that uses Python, not Ruby, and only works with Python 2.7 but not versions 3.+. See https://github.com/jekyll/jekyll/issues/1181
Python 2.7 is pre-installed by default on Linux and Mac OS X but not Windows. Go to https://www.python.org/downloads/ and download the latest 2.7 version (not 3+) and install making sure the Add to PATH option is selected.
This fixed the issue for me.
问题二:
jekyll 3.0.1 | Error: Permission denied - bind(2) for 127.0.0.1:4000
#解决方法：说明端口被占有，不知为何，打开_config.yml 在最后加入一行 port: 5001 (其他也可)问题解决。
参考文档
1.RubyGems官方说明文档 2.RubyGems jekyll 3.jekyll 官方说明文档