在发布到github pages 时，需要本地预览效果，这时需要安装本的jekyll环境，这里说明安装过程中的主要步骤以及相应的解决办法。
Install CURL
apt-get install curl
Install RVM
gpg2 --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
curl -sSL https://get.rvm.io | bash -s stable
source rvm environment
source /home/user/.rvm/scripts/rvm
Install Ruby Dependencies
rvm requirements
Install ruby
rvm isntall 2.4.0
set Default ruby version
rvm use 2.4.0 --default
install jekyll
gem install jekyll kramdown
gem 包含在rubygem中，安装完ruby后，自然会安装
依赖安装问题：
/home/user/.rvm/rubies/ruby-2.4.0/lib/ruby/2.4.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- bundler (LoadError)
from /home/user/.rvm/rubies/ruby-2.4.0/lib/ruby/2.4.0/rubygems/core_ext/kernel_require.rb:55:in `require'
from /home/user/.rvm/gems/ruby-2.4.0/gems/jekyll-3.5.0/lib/jekyll/plugin_manager.rb:46:in `require_from_bundler'
from /home/user/.rvm/gems/ruby-2.4.0/gems/jekyll-3.5.0/exe/jekyll:9:in `<top (required)>'
from /home/user/.rvm/gems/ruby-2.4.0/bin/jekyll:22:in `load'
from /home/user/.rvm/gems/ruby-2.4.0/bin/jekyll:22:in `<main>'
from /home/user/.rvm/gems/ruby-2.4.0/bin/ruby_executable_hooks:15:in `eval'
from /home/user/.rvm/gems/ruby-2.4.0/bin/ruby_executable_hooks:15:in `<main>'
执行以下命令
gem install bundler
gem install github-pages
JavaScript 运行环境问题
Jekyll 3.4.3 | Error: Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.
安装nodejs
sudo apt-get install nodejs
问题描述
Liquid Exception: undefined method `map' for false:FalseClass Did you mean? tap in /_layouts/page.html
- 问题参考 使用jekyll新建一个主页，解决此问题
Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.
配置文件_config.yml中，使用了 plugins 的配置项，应该是用plugins替换掉gems。
调用github 无法获取token的问题
- 问题描述
GitHub Metadata: No GitHub API authentication could be found. Some fields may be missing or have incorrect data - 解决方法
JEKYLL_GITHUB_TOKEN=<your token> jekyll serve -H 172.16.42.71 - 参考资料 No GitHub API authentication” error
CentOs 安装
安装 rvm 管理 ruby
gpg2 --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
curl -sSL https://get.rvm.io | bash -s stable
NOTE: 出现错误，请按提示解决如下：
Downloading https://github.com/rvm/rvm/archive/1.29.8.tar.gz
Downloading https://github.com/rvm/rvm/releases/download/1.29.8/1.29.8.tar.gz.asc
gpg: 于 2019年05月08日 星期三 22时14分49秒 CST 创建的签名，使用 RSA，钥匙号 39499BDB
gpg: 无法检查签名：没有公钥
GPG signature verification failed for '/usr/local/rvm/archives/rvm-1.29.8.tgz' - 'https://github.com/rvm/rvm/releases/download/1.29.8/1.29.8.tar.gz.asc'! Try to install GPG v2 and then fetch the public key:
gpg2 --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
or if it fails:
command curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -
command curl -sSL https://rvm.io/pkuczynski.asc | gpg2 --import -
In case of further problems with validation please refer to https://rvm.io/rvm/security
检查rvm 版本
rvm -v
rvm 1.29.8 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
设置默认 ruby 的版本
rvm 2.4.1 --default
Using /usr/local/rvm/gems/ruby-2.4.1
- 检查一下 ruby 的版本
ruby -v
- 检查一下 gem 的版本
gem -v
安装jekyll
gem install jekyll bundler
NOTE: 安装 jekyll, 比较好的方式是同时安装 bundler，可以管理依赖
- 检查安装版本
jekyll -v
后台运行Jekyll
jekyll serve -H 172.18.217.120 -P 80 --detach
jekyll server -w # 文件发生变化时，自动重新编译