如何在模板文件中包含元数据？

Question

我有一个通过 erb 过滤模板文件的系统。 使用约定优于配置，输出文件在镜像输入文件的文件层次结构中创建。 许多文件具有相同的名称，我可以使用目录来区分它们。

该计划一直有效，直到我需要将附加信息与每个文件关联起来。 因此，我在每个目录中使用元数据创建了一个 YAML 文件。 现在我有约定和配置。 恶心。

然后我了解了 Webby，以及它在每个模板文件顶部包含 YAML 元数据部分的方式。 它们看起来像这样：

---
title: Baxter the Dog
filter: textile
---
All the best little blogs use Webby.

如果我可以实现这样的标头，我就可以放弃我的层次结构和单独的 YAML 文件。 Webby 实现非常通用，实现了一个新的 MetaFile 类，将标题与“真实文本”分开，但它似乎比我需要的更复杂。

将元数据放在 erb 注释中似乎不错——它将被 erb 自动忽略，但我不确定如何访问注释数据。

<%#
title: Baxter the Dog
%>

有没有办法访问erb评论？ 或者也许有不同的方法？ 我的很多模板都会执行大量 erb 操作，但如果可以使其余部分变得更容易，我可以在单独的步骤中运行 erb。

Answer 1

如果您也将内容转储为 YAML 怎么样？ 据推测，元数据只是转储到 YAML 的哈希值。 您可以将内容作为字符串附加到同一文件中的第二个 YAML 文档中：-

---
title: Baxter the Dog
filter: textile
--- |
Content line 1
Content line 2
Content line 3

转储就像这样简单：-

File.open('file.txt', 'w') do |output|
  YAML.dump(metadata, output)
  YAML.dump(content, output)
end

加载就像这样简单：-

File.open('file.txt') do |input|
  stream = YAML.load_stream(input)
  metadata, content = stream.documents
end

请注意，管道字符出现在 YAML 以便保留内容字符串中的换行符。