You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

使用Jekyll Minima主题,编辑index.md添加首页内容是否正确?

回答:修改index.md是为Jekyll首页添加内容的正确方式

绝对没错!直接在index.md的YAML配置块(就是那对---之间的内容)下方添加自定义内容,就是不修改主题前提下为首页加内容的最优解,你完全没遗漏什么。

我来帮你拆解下那个注释的意思:

  • Minima主题默认的index.md是空的,因为它的默认home布局会自动拉取并展示你的所有博客文章。
  • 注释里说的“Edit theme's home layout instead”,是给那些想要彻底重构首页结构的人准备的——比如你想完全去掉文章列表、或者改布局的整体排版逻辑,那才需要去覆盖主题的home布局文件。但你的需求只是添加内容,根本不需要动布局文件。

结合你的目录结构来看,你已经有自己的_layouts/home.html(相当于覆盖了主题的默认布局),这也没关系:只要你的自定义home.html里保留了{{ content }}这个标记,Jekyll就会把你在index.md里写的内容插入到这个标记的位置,完美融合到布局里。

举个简单的例子,你可以这么写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
---

# 欢迎来到我的个人站点 🎉

这是我用Jekyll + Minima搭建的静态博客,在这里我会分享技术笔记和生活感悟~

---

### 我的最新文章

这样渲染后,首页就会先显示你写的欢迎内容,再展示布局里的文章列表(如果你的home.html保留了这部分逻辑)。

放心大胆地在index.md里加内容吧,这完全符合Jekyll的最佳实践!

内容的提问来源于stack exchange,提问作者Adam Matan

火山引擎 最新活动