为什么删除yaml前端事件会阻止Jekyll将md文件转换为html

Question

我继承了一个使用jekyll将标记内容转换为html的进程。

如果我删除yaml的前端问题

---
product: Product Name
capability: testing
infotype: Overview
audience:

---

# Testing file 2

This is another testing file.

jekyll构建不转换文件。

# Testing file 2

This is another testing file.

当我在测试2文件中有了前面的内容时，在运行build --verbose时，我会在日志中看到以下内容

Rendering: user-administration/testing-file-2.md
Pre-Render Hooks: user-administration/testing-file-2.md
Rendering Markup: user-administration/testing-file-2.md
Rendering Layout: user-administration/testing-file-2.md

但是没有前面的内容，日志中就没有与测试-file-2.md相关的消息。

这个测试-file-2.md是包含元数据的其他文件集合的一部分。当元数据被删除时，它们被呈现到html网站，而不是测试文件-2.md。

是否有一种方法可以让jekyll在不使用前端的情况下构建和呈现文件？

Answer 1

Jekyll不会忽略任何文件。相反，对于每个文件，它决定该文件是否为：

• 静态文件，可以按原样复制到输出文件夹(_site)，或
• 要先处理的文件。

如果标记文件(.md)以YAML前端开始，则由克拉姆顿和液体处理：

---
---

否则，它们将被视为静态文件，并在没有处理的情况下复制到_site。

有一种解决方法可能适用于您使用include_relative；但是它可能会给客户端的编辑器带来更多的麻烦，而不是值得的，这取决于它们的工作方式。

可以在要处理的文件中包含一个静态文件。您的静态文件可能是plain-text.md

# Static text file

This is a file with no YAML frontmatter.

然后，分别创建一个带有前端的标记文件，其中包含纯文本文件。比如说，processed-text.md

---
---
{% include_relative plaintext.md %}

然后您的纯文本将被处理，并以/processed-text的形式出现在您的站点上。将文件processed-text.md看作是保存plain-text.md的一种模板。

您将希望看到include_relative，特别是要包含的文件不能在文件系统中包含的文件之上。

Answer 2

我有一个朗读，这是一个要求至少有一个在空头的事情，否则杰基尔将忽略该文件

---
---