2017-07-15 13 views
2

當我使用最新的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. 

我想下面gemsplugins被替換,然後警告不會顯示出來,但我不相信我的猜測是正確的,因爲我找不到任何官方文件。我的猜測是正確的?

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

回答

3

你的猜測是正確的,現在gems關鍵是plugins

jekyll/lib/jekyll/configuration.rb你可以找到:

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

這是this Pull Request的一部分:插件配置密鑰作爲替代寶石(#5130)

正是這issue的結果:

你覺得如何將gems config指令重命名爲插件, 完全向後兼容?

這個想法是,如果你不是來自Ruby世界,「寶石」並不是一個非常直觀的術語(儘管這就是它們)。此外,用戶 不應該關心(或看到)幕後管道, 就分配情況而言。

取而代之的是,我們所說的關鍵「插件」,它具有紅寶石的生態系統以外更廣闊的 理解的術語,一個應該是 熟悉從更傳統的CMS未來像WordPress 或Drupal的任何用戶。

在實用性方面,它會僅僅是寶石結合 和插件陣列的事情,如果他們存在,當我們載入配置,並 更新,在未來次要版本的文檔。