jekyll-docs 未安装在 macOS 上答案

【问题标题】：jekyll-docs not installing on macOSjekyll-docs 未安装在 macOS 上
【发布时间】：2017-01-11 09:00:48
【问题描述】：

如果您有兴趣随时随地浏览这些文档，请安装 jekyll-docs gem 并在终端中运行 jekyll docs。

当我尝试在运行 macOS Sierra 的 MacBook Air 上安装 jekyll-docs 时，遇到了以下问题：

sunqingyaos-MacBook-Air:myblog sunqingyao$ jekyll docs
You must install the 'jekyll-docs' gem to use the 'jekyll docs' command. 
sunqingyaos-MacBook-Air:myblog sunqingyao$ sudo gem install jekyll-docs
Successfully installed jekyll-docs-3.3.0
Parsing documentation for jekyll-docs-3.3.0
1 gem installed
sunqingyaos-MacBook-Air:myblog sunqingyao$ jekyll docs
You must install the 'jekyll-docs' gem to use the 'jekyll docs' command. 
sunqingyaos-MacBook-Air:myblog sunqingyao$

如您所见，rubygems 告诉我它有successfully installed jekyll-docs-3.3.0，而jekyll docs 一直在下降。我重启了终端，还是不行。

【问题讨论】：

我会亲自将它添加到您的 gem 文件 gem 'jekyll-docs', '3.3.0' 然后执行 bundle install?如果已安装，请尝试运行 jekyll _3.3.0_ docs
您还需要确保您使用的是 Jekyll 3.3.0。
@Alan 是的，我将jekyll 3.3.1 与jekyll-docs 3.3.0 一起使用，这可能导致了这个问题。现在的问题是我正在使用其他依赖于jekyll (= 3.3.1) 的宝石（github-pages (= 114)），所以我无法降级 jekyll :(
如果你使用 gem 方法，你可以试试 bundle update 但这会更新到最新版本
@Alan 用bundle update 更新了所有内容，仍然出现上述错误，无论我运行jekyll docs 还是bundle install jekyll docs

标签： ruby macos rubygems jekyll

【解决方案1】：

有同样的问题。

就我而言，我有两个 jekyll 宝石：

sergpank$ gem list jekyll

*** LOCAL GEMS ***

jekyll (3.4.0, 3.3.1)
jekyll-docs (3.3.1)
jekyll-feed (0.8.0)
jekyll-sass-converter (1.5.0)
jekyll-watch (1.5.0)

我只是卸载了 3.4.0（因为没有 jekyll-docs-3.4.0）：

sergpank$ gem uninstall jekyll -v 3.4.0
Successfully uninstalled jekyll-3.4.0

---------------------------------------

sergpank$ gem list jekyll

*** LOCAL GEMS ***

jekyll (3.3.1)
jekyll-docs (3.3.1)
jekyll-feed (0.8.0)
jekyll-sass-converter (1.5.0)
jekyll-watch (1.5.0)

jekyll docs 成功启动后！

【讨论】：

看起来问题在于安装的 Jekyll 版本号高于您安装的 Jekyll 文档版本。（我想 Jekyll 文档和 Jekyll 有匹配的版本号，以表明正在记录的 Jekyll 版本。）这应该是公认的答案 :)