github - 如何在站点索引上呈现 Jekyll Markdown 页面

Question

我可能错过了一些简单的东西，但我无法在本地测试 Jekyll。

我正在使用 GitHub 页面来渲染 Jekyll，对于初学者来说，我只想从一个 Markdown 页面渲染主 index.html 上的 Markdown 内容。

结构为:

Index.html

---
layout: default
---

_布局
- 默认.html

//html stuff..
<section>

{{page.content}}

</section>

在根文件夹中，我有一个名为 content.md 的页面，我希望为 {{page.content}} 渲染布局，但液体标签部分是空白。

如何渲染 content.md？

示例:https://github.com/wycks/wordpress-gears-jekyll

Answer 1

这里发生了一些事情。

1. 在您的 _layouts/default.html 文件(以及任何其他 _layouts 目录文件)中，而不是:

   {{ page.content }}
   

   您需要使用:

   {{ content }}
   

2. Jekyll 只允许您包含站点根级 _includes 目录中的文件。因此，您需要将 content.md 从根目录移动到该目录(如果尚不存在，则将其创建)。

3. 最后，您需要实际从 index.html 文件调用包含文件。这可以通过将 index.html 文件的内容更改为:

   ---
   layout: default
   ---
   
   {% include content.md %}
   

这将设置您正在寻找的行为。

<小时/>

我想指出另外两件事:

1. 您可能会发现将索引文件的扩展名从 .html 更改为 .md 效果更好。但重要的是:如果您想要分页，则需要使用 .html。根据 Jekyll Pagination documentation ，该功能仅在文件名为 index.html 时才有效。

2. 如果您在索引文件中所做的只是调用仅驻留在该页面上的包含，那么您可能只需将内容直接放入索引文件中即可。