Jekyll 插件中的 "priority" 标志应该如何工作？
How is the "priority" flag in Jekyll plugins supposed to work?
我目前正在尝试为 Jekyll 开发一个有助于使用 Cloudinary for responsive images. Current source is in my Github repo 的插件，我稍后会把它变成 gem when/if 它可以工作。
这个插件有两个特点：
- 用于定义像
{% cloudinary [preset] path/to/img.jpg [attr="value"] %} 这样的 Cloudinary 图像的 Liquid 标签
- a 转换器可选择自动将图像的标准 Markdown/Kramdown 语法转换为此 Liquid 标签：
{:caption="caption text"} 变为 {% cloudinary path/to/img.jpg alt="alt text" caption="caption text" %}
目前，这两个功能都按预期工作，但它们不是 "chained"。如果我在我的 Markdown 中使用 Liquid 标签，它会被评估。如果我放一张标准的 Markdown 图片，它会被转换成 {% cloudinary … %} Liquid 标签，但是这个标签不会被评估。
我怀疑这两个功能的顺序 运行 不正确，所以我想确保在评估 Liquid 标签之前执行转换器。
但是我还不明白如何使用priority flag。
如果我取消注释 the priority :normal line in my plugin 和 运行 bundle exec jekyll serve，我会收到此错误：
$ bundle exec jekyll serve
Configuration file: /Users/nhoizey/Dropbox/Personnel/Devs/nicolas-hoizey.com/_config.yml
jekyll 3.1.6 | Error: undefined method `priority' for Jekyll::CloudinaryTag:Class
Did you mean? print
有什么想法吗？
编辑（7 月 11 日）：
我现在把它拆分成插件。
转换器仍在我站点的 _plugins 文件夹中：https://github.com/nhoizey/nicolas-hoizey.com/blob/52c92a38410e133890eea6044a033cb20344b971/_plugins/cloudinaryfy.rb#L26
Jekyll 不会抱怨这个 "priority" 标志。
Liquid 标签现在是一个真正的自治插件 gem，名为 jekyll-cloudinary：https://nhoizey.github.io/jekyll-cloudinary/
如果我在这个插件中放置 "priority" 标志，我仍然得到错误：
$ bundle exec jekyll serve bundler: failed to load command: jekyll (/usr/local/bin/jekyll)
Bundler::GemRequireError: There was an error while trying to load the gem 'jekyll-cloudinary'.
Gem Load Error is: undefined method `priority' for Jekyll::Cloudinary::CloudinaryTag:Class
Did you mean? print
Backtrace for gem load error is:
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:5:in `<class:CloudinaryTag>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:4:in `<module:Cloudinary>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:2:in `<module:Jekyll>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:1:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll-cloudinary.rb:1:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll-cloudinary.rb:1:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:86:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:86:in `block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `block in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler.rb:102:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/bin/jekyll:9:in `<top (required)>'
/usr/local/bin/jekyll:22:in `load'
/usr/local/bin/jekyll:22:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:63:in `load'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:63:in `kernel_load'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:24:in `run'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli.rb:304:in `exec'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/command.rb:27:in `run'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/invocation.rb:126:in `invoke_command'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor.rb:359:in `dispatch'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/base.rb:440:in `start'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli.rb:11:in `start'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/exe/bundle:27:in `block in <top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/friendly_errors.rb:98:in `with_friendly_errors'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/exe/bundle:19:in `<top (required)>'
/usr/local/bin/bundle:22:in `load'
/usr/local/bin/bundle:22:in `<main>'
Bundler Error Backtrace:
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:89:in `rescue in block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:85:in `block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `block in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler.rb:102:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/bin/jekyll:9:in `<top (required)>'
/usr/local/bin/jekyll:22:in `load'
/usr/local/bin/jekyll:22:in `<top (required)>'
为什么它适用于一个插件而不适用于另一个？
如何确保 cloudinarify 转换器插件 运行 在 jekyll-cloudinary Liquid 标签被解释之前？
priority 标志是为 Jekyll::Plugin 的子类引入的，目的是让插件作者能够明确地向 Jekyll 提供排序信息。当实例化一个新的 Jekyll::Site 时，插件子类被实例化并按优先级排序。如果你想让你的 cloudfoundry 插件成为 运行 before 或 after 另一个插件，你修改它的优先级，这样它就会在处理方面先于其他插件。
这仅对 Jekyll::Plugin 的子类有效，其中包括 Jekyll::Converter 和 Jekyll::Generator。这就是为什么它适用于您的转换器，但不适用于您的 Liquid::Tag – 液体标签没有优先级的想法，因为它们不竞争。
例如，以具有 类别生成器插件 和 站点地图插件 的站点为例。站点地图插件作者希望确保任何生成的页面都出现在站点地图中（所有内容都应该在站点地图中！），因此设置 priority :low。类别生成器插件作者可能希望确保它在任何其他生成器（例如站点地图生成器）之前 运行s，因此它设置 priority :high。这确保了类别生成器插件 运行 在站点地图插件之前，这样编译的站点地图中就有类别页面。
默认优先级为:normal。按优先级降序排列，有：
:highest:high:normal:low:lowest
我目前正在尝试为 Jekyll 开发一个有助于使用 Cloudinary for responsive images. Current source is in my Github repo 的插件，我稍后会把它变成 gem when/if 它可以工作。
这个插件有两个特点：
- 用于定义像
{% cloudinary [preset] path/to/img.jpg [attr="value"] %} 这样的 Cloudinary 图像的 Liquid 标签
- a 转换器可选择自动将图像的标准 Markdown/Kramdown 语法转换为此 Liquid 标签：
{:caption="caption text"}变为{% cloudinary path/to/img.jpg alt="alt text" caption="caption text" %}
目前，这两个功能都按预期工作，但它们不是 "chained"。如果我在我的 Markdown 中使用 Liquid 标签，它会被评估。如果我放一张标准的 Markdown 图片，它会被转换成 {% cloudinary … %} Liquid 标签，但是这个标签不会被评估。
我怀疑这两个功能的顺序 运行 不正确，所以我想确保在评估 Liquid 标签之前执行转换器。
但是我还不明白如何使用priority flag。
如果我取消注释 the priority :normal line in my plugin 和 运行 bundle exec jekyll serve，我会收到此错误：
$ bundle exec jekyll serve
Configuration file: /Users/nhoizey/Dropbox/Personnel/Devs/nicolas-hoizey.com/_config.yml
jekyll 3.1.6 | Error: undefined method `priority' for Jekyll::CloudinaryTag:Class
Did you mean? print
有什么想法吗？
编辑（7 月 11 日）：
我现在把它拆分成插件。
转换器仍在我站点的 _plugins 文件夹中：https://github.com/nhoizey/nicolas-hoizey.com/blob/52c92a38410e133890eea6044a033cb20344b971/_plugins/cloudinaryfy.rb#L26
Jekyll 不会抱怨这个 "priority" 标志。
Liquid 标签现在是一个真正的自治插件 gem，名为 jekyll-cloudinary：https://nhoizey.github.io/jekyll-cloudinary/
如果我在这个插件中放置 "priority" 标志，我仍然得到错误：
$ bundle exec jekyll serve bundler: failed to load command: jekyll (/usr/local/bin/jekyll)
Bundler::GemRequireError: There was an error while trying to load the gem 'jekyll-cloudinary'.
Gem Load Error is: undefined method `priority' for Jekyll::Cloudinary::CloudinaryTag:Class
Did you mean? print
Backtrace for gem load error is:
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:5:in `<class:CloudinaryTag>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:4:in `<module:Cloudinary>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:2:in `<module:Jekyll>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll/cloudinary.rb:1:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll-cloudinary.rb:1:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-cloudinary-1.2.2/lib/jekyll-cloudinary.rb:1:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:86:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:86:in `block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `block in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler.rb:102:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/bin/jekyll:9:in `<top (required)>'
/usr/local/bin/jekyll:22:in `load'
/usr/local/bin/jekyll:22:in `<top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:63:in `load'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:63:in `kernel_load'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli/exec.rb:24:in `run'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli.rb:304:in `exec'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/command.rb:27:in `run'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/invocation.rb:126:in `invoke_command'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor.rb:359:in `dispatch'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/vendor/thor/lib/thor/base.rb:440:in `start'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/cli.rb:11:in `start'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/exe/bundle:27:in `block in <top (required)>'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/friendly_errors.rb:98:in `with_friendly_errors'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/exe/bundle:19:in `<top (required)>'
/usr/local/bin/bundle:22:in `load'
/usr/local/bin/bundle:22:in `<main>'
Bundler Error Backtrace:
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:89:in `rescue in block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:85:in `block (2 levels) in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:81:in `block in require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `each'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler/runtime.rb:70:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/bundler-1.12.5/lib/bundler.rb:102:in `require'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
/usr/local/lib/ruby/gems/2.3.0/gems/jekyll-3.1.6/bin/jekyll:9:in `<top (required)>'
/usr/local/bin/jekyll:22:in `load'
/usr/local/bin/jekyll:22:in `<top (required)>'
为什么它适用于一个插件而不适用于另一个？
如何确保 cloudinarify 转换器插件 运行 在 jekyll-cloudinary Liquid 标签被解释之前？
priority 标志是为 Jekyll::Plugin 的子类引入的，目的是让插件作者能够明确地向 Jekyll 提供排序信息。当实例化一个新的 Jekyll::Site 时，插件子类被实例化并按优先级排序。如果你想让你的 cloudfoundry 插件成为 运行 before 或 after 另一个插件，你修改它的优先级，这样它就会在处理方面先于其他插件。
这仅对 Jekyll::Plugin 的子类有效，其中包括 Jekyll::Converter 和 Jekyll::Generator。这就是为什么它适用于您的转换器，但不适用于您的 Liquid::Tag – 液体标签没有优先级的想法，因为它们不竞争。
例如，以具有 类别生成器插件 和 站点地图插件 的站点为例。站点地图插件作者希望确保任何生成的页面都出现在站点地图中（所有内容都应该在站点地图中！），因此设置 priority :low。类别生成器插件作者可能希望确保它在任何其他生成器（例如站点地图生成器）之前 运行s，因此它设置 priority :high。这确保了类别生成器插件 运行 在站点地图插件之前，这样编译的站点地图中就有类别页面。
默认优先级为:normal。按优先级降序排列，有：
:highest:high:normal:low:lowest