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

它是this Pull Request的一部分：插件配置密钥作为宝石的替代品（＃5130）

这是issue：

的结果

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

这个想法是，如果你不是来自Ruby世界，那么“宝石”并非如此   直观的术语（尽管它们就是这样）。进一步，用户   不应该关心（或看到）幕后的管道，   就事物的分配方式而言。

相反，让我们称之为“插件”，这个术语具有更广泛的含义   在Ruby生态系统之外理解，应该是   来自更传统的CMS（如WordPress）的任何用户都很熟悉   或Drupal。

在实用性方面，它只是一个结合宝石的问题   和插件数组，如果它们在我们加载配置时存在，和   更新下一个次要版本中的文档。

Answer 2

您是正确的，为了解决该问题，请执行以下步骤：

打开您的ValueError: to assemble mappings requires at least that [year, month, day] be specified: [day,month,year] is missing文件
找到以_config.yml开头的行
将gems:替换为gems

'gems'配置选项已重命名为'plugins'。

2 个答案: