Jekyll,minima:在主页上使用 markdown

Jekyll, minima: Using markdown for the homepage

问题

我正在使用 Jekyll and the 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 主页添加内容的正确方法吗?

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

上面的说明只是说,如果要对首页做一些改动,请参考布局文件,而不是在该文件中构建首页结构。

如果您在第二个 --- 下面添加内容,它将显示在主页上,因为 _layouts/home.html 中有 {{ content }}

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