markdown - 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 文件。