从 Liquid 和 Markdown 而不是 HTML 生成 Jekyll 页面答案

【问题标题】：Generating Jekyll Pages from Liquid and Markdown instead of HTML从 Liquid 和 Markdown 而不是 HTML 生成 Jekyll 页面
【发布时间】：2013-03-08 17:31:33
【问题描述】：

我正在使用来自 Jekyll 的文档插件部分 (https://github.com/mojombo/jekyll/wiki/Plugins#generators) 的示例生成器的略微修改版本，我很好奇是否有任何方法可以解析液体/降价文件而不是纯 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

非常感谢， - 基思

【问题讨论】：

标签： ruby markdown jekyll liquid

【解决方案1】：

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

我要问的问题是这样的：

我需要插件来完成此操作吗？
如果是这样，我是否需要Jekyll docs 中讨论的正式生成器插件？
或者我应该继承、猴子补丁还是以其他方式更改内置生成器的行为？

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

【讨论】：