ruby - 从 Liquid 和 Markdown 而不是 HTML 生成 Jekyll 页面

Question

我使用的是来自 Jekyll 的文档插件部分 (https://github.com/mojombo/jekyll/wiki/Plugins#generators) 的示例生成器的略微修改版本，我很好奇是否有任何方法可以解析 liquid/markdown 文件而不是纯 HTML 文件来自示例？

注意这一行:

self.read_yaml(File.join(base, '_layouts'), 'category_index.html')

该类别 index.html 文件是将在生成的文件中使用的目标文件。我的目标是能够将一个对象从我的 _config 文件传递​​到我的生成器，然后我可以使用它从 .markdown 文件构建一堆页面。有谁知道这是否可能或对实现此目标有任何建议？我查看了用于在内部解析 markdown 的 Kramdown 库，如果必须的话，我不反对自己调用它，只是不确定我是否比我需要做的更深入一些本应如此简单的事情。我的生成器创建的 Page 对象的 API 在这里:http://ruby-doc.org/gems/docs/j/jekyll-0.12.0/Jekyll/Page.html

非常感谢，- 基思

Answer 1

您可以在生成器中从几乎任何您想要的数据源生成几乎任何您想要的格式，因为您正在直接编写 Ruby 并具有对 Jekyll 对象模型的完全访问权限。例如，这是我前几天晚上组装的发电机 fetches GitHub commits during jekyll build .

我要问的问题是:

1. 我需要插件来实现吗？
2. 如果是这样，我是否需要像 Jekyll docs 中讨论的正式生成器插件？ ？
3. 或者我应该子类化、猴子补丁或以其他方式改变内置生成器的行为？

此外，Markdown 和 HTML 文件在这种情况下(您控制 100% 生成的内容)之间的差异大多是名义上的。 read_yaml IIRC 实际上会从两者中读取前面的内容，所以这应该不是问题。