Ruby x Jekyll 本地调试环境搭建
Ruby x Jekyll 本地调试环境搭建
- [Ruby.Jekyll 的安装 ](https://cloud.tencent.com/developer)
- [Ruby.Download ](https://cloud.tencent.com/developer)
- [Ruby.Init ](https://cloud.tencent.com/developer)
- [Ruby.Finish ](https://cloud.tencent.com/developer)
- [Jekyll.Install ](https://cloud.tencent.com/developer)
- [Jekyll.Installation.Issues ](https://cloud.tencent.com/developer)
- [plugins/convert.rb:32:in `<module:Jekyll>': cannot load such file -- jekyll/post (LoadError) ](https://cloud.tencent.com/developer)
- [jekyll 3.0.0 | Error: Included file '\_includes/JB/setup' not found ](https://cloud.tencent.com/developer)
- [cannot load such file -- jekyll-paginate (LoadError) ](https://cloud.tencent.com/developer)
- [Dependency Error! It looks like you don't have redcarpet or one of its ](https://cloud.tencent.com/developer)
- [其他问题 ](https://cloud.tencent.com/developer)
- [Jekyll.Run ](https://cloud.tencent.com/developer)
- [ 2015-11-15 Updated ](https://cloud.tencent.com/developer)
- [ 2015-12-11 Error: mapping values are not allowed in this context at line 3 column 18 ](https://cloud.tencent.com/developer)
- [2016-02-24 Updated ](https://cloud.tencent.com/developer)
- [2016-09-12 Updated ](https://cloud.tencent.com/developer)
- [2016-10-07 Updated ](https://cloud.tencent.com/developer)
- [2016-10-07 Error: undefined method `size' for nil:NilClass (NoMethodError) ](https://cloud.tencent.com/developer)
- [2018-01-24 关于 Jekyll 升级 ](https://cloud.tencent.com/developer)
- [2018-01-24 关于 Jekyll 3.7 的 LiveReload ](https://cloud.tencent.com/developer)
- [2018-05-26 Jekyll 3.8 的安装 ](https://cloud.tencent.com/developer)
- [2018-10-15 Updated ](https://cloud.tencent.com/developer)
- [2018-10-21 Updated ](https://cloud.tencent.com/developer)
- [2019-10-13 Updated ](https://cloud.tencent.com/developer)
- [遇到问题 `Could not locate Gemfile or .bundle/ directory` ](https://cloud.tencent.com/developer)
- [Bundle 安装非常慢 ](https://cloud.tencent.com/developer)
- [.yml 文件中设置文件忽略 ](https://cloud.tencent.com/developer)
- [参考文献 ](https://cloud.tencent.com/developer)News
我已抛弃 Jekyll 换用 NextJS.
这里是本站开源: https://github.com/szhshp/NextJS-BlogTemplate-ProjectTitan
以下内容可能已经过时, 仅供参考
Ruby.Jekyll 的安装
Ruby.Download
点击这个网址下载：http://jekyll-windows.juthilo.com/1-ruby-and-devkit/
- 下载 Ruby 和 DevKit，注意版本要相同，安装和解压对应文件
- 64b 系统建议也用 32b
- 建议设置一下环境变量，把 Ruby 放到 Path 里面
Ruby.Init
ruby dk.rb init
ruby dk.rb install经常 install 会失败，那是因为没有更新对应的 ruby list
到 DevKit 文件夹找到config.yml文件
加入以下代码，指向的是自己的 Ruby 的路径
---
- D:/Ruby22注意横杠也要写进去
低版本可能需要写两行
Ruby.Finish
安装成功的话输入以下代码可以看到版本
D:\Tools_For_Work\Projs>ruby --version
ruby 2.2.2p95 (2015-04-13 revision 50295) [i386-mingw32]Jekyll.Install
安装 Jekyll
D:\Tools_For_Work\Projs>gem install jekyll这里会有各种错误
ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why:
Unable to download data from http://ruby.taobao.org/ - bad respons
t Found 404 (http://ruby.taobao.org/specs.4.8.gz)这样是因为对应的 Ruby Source 无法找到报 404 了
只需要修改 RubySource 即可
很多时候，在安装 gem 的过程中会出现找不到资源的 error，我们需要从另外一个 gem 服务器下载安装。 通过 gem sources 命令配置源，或通过修改 Gemfile 中的 source 语句可以实现。 常用的源
适合安装大多数常见的 gem^ft 显示当前使用的 sources gem sources 添加一个 source gem sources -a url 地址 删除一个 source gem sources -r url 地址 更新 source cache gem sources -u
添加几个 Source 后重新下载
Jekyll.Installation.Issues
plugins/convert.rb:32:in `module:Jekyll(https://szhshp.orgjavascript:void(0%29/)': cannot load such file -- jekyll/post (LoadError)
这次 Deploy 的时候这个问题困扰了我好久
大多数问题都是升级引发的问题
一旦我把对应的 Proj 进行 jekyll build 的时候就报错
D:\Tools_For_Work\Projs\Github Blog>jekyll b
Configuration file: D:/Projs/Github Blog/_config.yml
D:/Projs/Github Blog/_plugins/debug.rb:13:in `<module:Jekyll>': c
annot load such file -- jekyll/post (LoadError)
from D:/Projs/Github Blog/_plugins/debug.rb:8:in `<top (r
equired)>'
from D:/Ruby22/lib/ruby/2.2.0/rubygems/core_ext/kernel_re
quire.rb:54:in `require'
from D:/Ruby22/lib/ruby/2.2.0/rubygems/core_ext/kernel_re
quire.rb:54:in `require'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:75:in `block (2 levels) in require_plugin_files'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:74:in `each'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:74:in `block in require_plugin_files'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:73:in `each'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:73:in `require_plugin_files'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/plugin_manager.rb:18:in `conscientious_require'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/site.rb:97:in `setup'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/site.rb:49:in `initialize'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/commands/build.rb:30:in `new'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/commands/build.rb:30:in `process'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/lib/
jekyll/commands/build.rb:18:in `block (2 levels) in init_with_program'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary/command.rb:220:in `call'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary/command.rb:220:in `block in execute'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary/command.rb:220:in `each'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary/command.rb:220:in `execute'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary/program.rb:42:in `go'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/mercenary-0.3.5/l
ib/mercenary.rb:19:in `program'
from D:/Ruby22/lib/ruby/gems/2.2.0/gems/jekyll-3.0.0/bin/
jekyll:17:in `<top (required)>'
from D:/Ruby22/bin/jekyll:23:in `load'
from D:/Ruby22/bin/jekyll:23:in `<main>'后来搜了一下官方 Github 中的 Issue，发现了问题所在
相关连接：
原因是我拿 V2.X 的 Proj 并且用 V3.0 的 Jekyll 来 Build 了，并且对应的这个 post 文件夹也变了，因此处理方式就是干脆把所有所有转移到 3.0 的新 Proj 算了
所以只需要使用 Jekyll 建立一个新的 Proj
jekyll new MyBlog就会在当前目录建立一个 MyBlog 的文件夹，并且里面已经有主要文件了
这个可恶的问题在 StackOverFlow 找了好久，最终还是官方的 Help Doc 比较全面
jekyll 3.0.0 | Error: Included file '_includes/JB/setup' not found
这个也是上一个问题的连带问题
V2.X 里面的某些 Post 里面引用了以前的文件，因此现在 Not Found 是很正常的
D:\Tools_For_Work\Projs\blog>jekyll s
Configuration file: D:/Projs/blog/_config.yml
Source: D:/Projs/blog
Destination: D:/Projs/blog/_site
Incremental build: disabled. Enable with --incremental
Generating……
Liquid Exception: Included file '_includes/JB/setup' not found in D:/Tools_For
_Work/Projs/blog/_posts/2015-11-11-dicksday.md/#excerpt
jekyll 3.0.0 | Error: Included file '_includes/JB/setup' not found解决方法，把以前的 Post 的格式改成新的格式
错误的文件路径已经显示在 Error Msg 里面了
cannot load such file -- jekyll-paginate (LoadError)
Gem install jekyll-paginate 就可以了
Dependency Error! It looks like you don't have redcarpet or one of its
Dependency Error: 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 n
eed to install this gem. The full error message from Ruby is: 'cannot load such
file -- redcarpet' If you run into trouble, you can find helpful resources at ht
tp://jekyllrb.com/help/!
ERROR: YOUR SITE COULD NOT BE BUILT:
------------------------------------
redcarpet一样 Gem install 对应的组件就行了
其他问题
一般官方的解答最为有效
https://github.com/jekyll/jekyll/search?utf8=%E2%9C%93&q=&type=Issues
Jekyll.Run
Proj 根目录使用jekyll b就可以 build
解决了以上问题终于可以 build 了
D:\Projs\blog>jekyll b
Configuration file: D:/Projs/blog/_config.yml
Source: D:/Projs/blog
Destination: D:/Projs/blog/_site
Incremental build: disabled. Enable with --incremental
Generating……
done in 0.557 seconds.
Auto-regeneration: disabled. Use --watch to enable.然后jekyll s开启 server，然后使用 http://localhost:4000/访问
2015-11-15 Updated
添加分页效果的时候遇到问题
提示说没有安装对应 module
Deprecation: You appear to have pagination turned on, but you haven't inc
luded the `jekyll-paginate` gem. Ensure you have `gems: [jekyll-paginate]` in yo
ur configuration file.使用 gem install 之后依然报错
原因是没有在 Config 里面配置本地的 Gem，config 中加入一行 gems 声明
gems: [jekyll-paginate]记得要配置分页细节
paginate: 12
paginate_path: "page:num"2015-12-11 Error: mapping values are not allowed in this context at line 3 column 18
写新 post 的时候遇到问题
Regenerating: 1 file(s) changed at 2015-12-11 21:19:34 Error reading file
D:/Tools_For_Work/Projs/Github Blog/_posts/2015-12-11-wrapstringincf.md: (<unkno
wn>): mapping values are not allowed in this context at line 3 column 18
……error:
Error: undefined method `each' for nil:NilClass
Error: Run jekyll build --trace for more information.跑到那篇文章里找到line 3 column 18发现对应 post 的 title 中不能含有分号(:)
删除后解决问题
2016-02-24 Updated
更简单更便捷的 Jekyll 调试环境搭建： Portable Jekyll-最便捷的 JEKYLL 安装
2016-09-12 Updated
Coding 的 Jekyll 远程调试环境搭建：Ruby x Jekyll 远程调试环境搭建
2016-10-07 Updated
Error: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://api.rubygems.org/latest_specs.4.8.gz)
Win10 中初次使用时出现问题, 原因是证书文件缺失
Solution^1:
Download the cacert.pem file from http://curl.haxx.se/ca/cacert.pem. Save this file to C:\RailsInstaller\cacert.pem. Now make ruby aware of your certificate authority bundle by setting SSL_CERT_FILE. To set this in your current command prompt session, type: set SSL_CERT_FILE=C:\RailsInstaller\cacert.pem To make this a permanent setting, add this in your control panel.
注意要设置到系统变量而不是用户变量
2016-10-07 Error: undefined method `size' for nil:NilClass (NoMethodError)
gem install时遇到错误
ERROR: Error installing jekyll:
invalid gem: package is corrupt, exception while verifying: undefined method `size' for nil:NilClass (NoMethodError)运行
gem env然后到GEM PATHS里面删除 cache 文件夹^3
2018-01-24 关于 Jekyll 升级
大版本更新查看这篇文章
小版本更新直接:
gem update jekyll2018-01-24 关于 Jekyll 3.7 的 LiveReload
一个小变化就是LiveReload, 每次修改后浏览器会自动刷新, 也算是更省事了
jekyll serve --livereload2018-05-26 Jekyll 3.8 的安装
现在 Windows 安装已经非常简单了
3 步就能将环境完全安装: https://jekyllrb.com/docs/windows/
2018-10-15 Updated
jekyll s 遇到错误
C:/Projects/_bg/ruby/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in
require': cannot load such file -- bundler (LoadError) from C:/Projects/_bg/ruby/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:inrequire' from C:/Projects/_bg/ruby/lib/ruby/gems/2.3.0/gems/jekyll-3.8.4/lib/jekyll/plugin_manager.rb:48:inrequire_from_bundler' from C:/Projects/_bg/ruby/lib/ruby/gems/2.3.0/gems/jekyll-3.8.4/exe/jekyll:11:in<top (required)>' from C:/Projects/_bg/ruby/bin/jekyll:22:inload' from C:/Projects/_bg/ruby/bin/jekyll:22:in'
解决方法很简单:
gem install bundler安装即可
2018-10-21 Updated
最近在使用一个 local gem 的时候报错:
Dependency Error: Yikes! It looks like you don't have G:/Dev/GitRepos/Coding/tmp/_plugins/xxx.rb 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 -- bcrypt' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
jekyll 3.8.2 | Error: G:/Dev/GitRepos/Coding/tmp/_plugins/xxx.rb这个 local gem 保存在 _plugins/xxx.rb 然后里面引用了一些其他的 gem, 错误信息中指明了错误的 gem 是 bcrypt, 重复执行 gem install bcrypt 无果.
最后发现是需要在根目录的 Gemfile 里面添加一句:
gem 'bcrypt'这样就可以解决问题.
2019-10-13 Updated
Jekyll 4.0 升级遇到问题, 升级 4.0 之后官方建议使用 bundle 启动 local server
gem install jekyll bundler
bundle exec jekyll serve遇到问题 Could not locate Gemfile or .bundle/ directory
你肯定是旧版本 jekyll 创建的 site
新建一个文件文件名为 Gemfile
source "https://gems.ruby-china.com"
gem "jekyll", "~> 4.0.0"
group :jekyll_plugins do
gem "jekyll-feed", "~> 0.12"
end
## Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
## and associated library.
install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
gem "tzinfo", "~> 1.2"
gem "tzinfo-data"
end
## Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?然后执行
Bundle installBundle 安装非常慢
换源, 换源! ^3
执行下方这段即可
bundle config mirror.https://rubygems.org https://gems.ruby-china.com.yml 文件中设置文件忽略
其实就是 ignore 参数, 例子:
exclude:
- Gemfile
- Gemfile.lock
- node_modules
- blog pull and debug.bat参考文献
- 常用的 Source
- Download a cacert.pem for RailsInstaller
- gem 安装时出现 undefined method `size' for nil:NilClass (NoMethodError) 的解决办法
- https://gems.ruby-china.com/ (https://szhshp.orgjavascript:void(0%29/)
腾讯云开发者
