“宝石”配置选项已重命名为“插件”。

Question

当我使用最新版本jekyll并启动其服务器时，下面将显示某些警告。

$ jekyll serve
Configuration file: /Users/ishida/git/gipcompany.github.io/_config.yml
       Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.

我想以下内容gems应替换为plugins，然后警告不会出现，但是我不确定我的猜测是正确的，因为我找不到任何官方文档。我的猜测是正确的吗？

$ cat _config.yml
(omit)
gems:
  - jekyll-feed

Answer 1

您的猜测是正确的，gems现在是关键plugins。

在其中jekyll/lib/jekyll/configuration.rb可以找到：

def backwards_compatibilize
   ...
   renamed_key "gems", "plugins", config

它是此Pull Request的一部分 ：plugins config键，可替代gems（＃5130）

这是此问题的结果：

您如何将gems config指令重命名为具有完全向后兼容性的插件？

想法是，如果您不是来自Ruby世界，那么“宝石”并不是一个非常直观的术语（即使那是真正的含义）。此外，就事物的分布方式而言，用户不必关心（或看到）幕后管道。

取而代之的是，我们将其称为关键“插件”，这个术语在Ruby生态系统之外具有更广泛的理解，并且是来自更传统的CMS（如WordPress或Drupal）的任何用户都应该熟悉的术语。

从实用性的角度来看，合并gem和plugins数组（如果它们在我们加载配置时存在）和在下一个较小版本中更新文档只是一个问题。