如何在网站索引上呈现Jekyll降价页面

Question

我可能错过了一些简单但我无法在本地测试Jekyll的方法.

我正在使用GitHub页面来渲染Jekyll,对于初学者我只想从一个降价页面在主index.html上渲染markdown内容 .

结构是:

的index.html

---
layout: default
---

_layouts
- 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文件中的include文件.这可以通过将index.html文件的内容更改为:

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

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

我要指出另外两件事:

1. 你可能会发现,从改变你的索引文件的扩展名.html来.md更好地工作.但重要的是:.html如果你想分页,你需要使用.根据Jekyll Pagination文档,该功能仅在命名文件时有效index.html.

2. 如果您在索引文件中所做的只是调用仅驻留在该页面上的include,那么您可以将内容直接放在索引文件中.