docpad - Docpad 的@getBlock 是做什么的？

Question

这是一个简单的问题，我很难找到答案。我刚刚开始使用docpad建立一个网站。我在 HTML5 Boilerplate 框架中遇到了以下行:

<%- @getBlock('styles').add(["/style.css"]).toHTML() %>

有谁知道这是做什么的吗？端点是它输出以下html:

<link rel="stylesheet" href="/style.css" />

但我不确定这里到底发生了什么，以及为什么这个简单的 css 链接是以这种方式生成的。

任何照明都将不胜感激。

更新

玩了一下之后，@getBlock 的作用似乎是输出某个 html 代码块。在这种情况下，样式似乎指定了代码。如果这是正确的，那么很高兴知道 Docpad 中还有哪些其他 block ，或者这个 @getBlock 函数(？)来自的任何其他框架......

Answer 1

这里是 DocPad 的创始人。

正确，getBlock 是可供您使用的内置模板帮助程序的一部分。有几个 block 可用，包括脚本、样式和元。这些的目的是允许插件和其他模板安全地注入(inject) block 的内容并与之交互。

这样的例子可以是:

• 仅将特定脚本添加到一个模板的 header
• 缩小您使用的所有脚本，甚至将它们连接到一个文件中
• 为某些插件注入(inject)新脚本等

我们正在非常努力地改进文档和支持系统，因此很抱歉这些内容之前不清楚 - 但我们正在尽力而为!