Jekyll, minima：在主页上使用 markdown

Question

问题

我正在使用Jekyll 和Minima 主题构建一个静态站点。我编辑index.md更改了主页，但我在文件顶部看到一条奇怪的评论：

---
# You don't need to edit this file, it's empty on purpose.
# Edit theme's home layout instead if you wanna make some changes
# See: https://jekyllrb.com/docs/themes/#overriding-theme-defaults
layout: home
---

在--- 下方添加内容有效。显然我不是想改变主题，只是在主页上添加一些内容。我错过了什么吗？

目录结构

index.md
_layouts
├── default.html
├── home.html
├── page.html
└── post.html

我的问题

更改 index.md 是向 Jekyll 主页添加内容的正确方法吗？

Answer 1

刚开始使用 Jekyll 的人看到（几乎）空的 index.md 文件可能会感到困惑。这里的关键是要知道它使用的是主布局，位于_layouts/home.html 并且是代码所在的位置。

上面的注释只是说如果你想对主页做一些更改，请参考布局文件，而不是在那个文件中构建主页结构。

如果您在第二个--- 下方添加内容，它将显示在主页上，因为_layouts/home.html 中包含{{ content }}。

总结一下，如果您只是添加一些内容并且对模板放置的位置感到满意，那么您无需更改任何内容，如果您希望内容出现在其他任何地方或更改结构，请编辑模板 home.html 文件。