【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除
背景
上篇 blog
【Ubuntu】【Hugo】搭建私人博客：搜索功能配置
分析了搜索功能的配置，以及搜索功能关键的索引文件 index.json，下面继续分析下一个功能项（首页板块功能）
搭建私人博客
首先来看下当前首页的情况
可以看到，首页空空如也，只有欢迎信息，只有进入到全部分类，才能看到编辑了的文章
OK，先来分析首页的渲染机制，首页内容一般是 Hugo 的内容组织机制（Hugo 本身默认行为，通用性）和主题配置共同作用的结果（主题行为，特殊性）
首先，首页 Homepage 是一个特殊的 section，其首页模板是 layouts/index.html （不过 PaperMod 并没有使用 index.html 作为其首页模板内容，这个后面再分析），Hugo 本身不会自动决定哪些文章要显示在首页，这完全由用户写的模板，或者使用的主题决定
默认情况下，Hugo 只渲染 content/ 下的叶子 Bundle 或特定内容到首页（当然，这些叶子 Bundle 也需要模板配合用户设置进行实现），Hugo 首页一般只会显示
content/index.md（首页专用）- Leaf Bundle（具体的文章）
- Branch Bundle（某一板块）
hugo.toml中配置的菜单项[[menu.main]]
关于 Page Bundle 的内容，之前 blog 【Ubuntu】【Hugo】搭建私人博客：Page Bundle 已经介绍过，Leaf Bundle 和 Branch Bundle 都是 Page Bundle 的子集
下面来说下 Leaf Bundle，关于 Leaf Bundle 的官方描述如下 https://gohugo.io/content-management/page-bundles/#leaf-bundles
在 Hugo 中，Leaf Bundle 是一个文件夹，里面可以包含其他资源文件（比如图片，附件，额外的 Markdown 文件等），也可以不包含，但必须包含一个 index.md 文件 ，另外，也不能包含其他子文件夹（即不能再有子 bundle），因为 Leaf Bundle 已经是叶子了，没有后代，就好比一棵树，branch 枝干可以继续分叉，但 leaf 叶子是末端，不能再长出新的，示例如下
bash
content/
├── about
│ └── index.md
├── posts
│ ├── my-post
│ │ ├── content-1.md
│ │ ├── content-2.md
│ │ ├── image-1.jpg
│ │ ├── image-2.png
│ │ └── index.md
│ └── my-other-post
│ └── index.md
└── another-section
├── foo.md
└── not-a-leaf-bundle
├── bar.md
└── another-leaf-bundle
└── index.md在这里，总共有 4 个 Leaf Bundles：
about：有index.md，无子目录my-post：有index.md+ 其他资源my-other-post：只有index.mdanother-leaf-bundle：有index.md，且无子目录
另外，关于 Bundle 中的资源，比如在 my-post 这个 Leaf Bundle 中，除了 index.md，还有
content-1.md，content-2.md等被 Hugo 视为 page 类型资源（page 资源不会单独生成网页，但可以通过.Resources在模板中被调用）image-1.jpg，image-2.png等被视为 image 类型资源，同样可以通过.Resources进行访问
可以看到，这些额外的 .md 文件不会被 Hugo 单独渲染成独立页面，只是属于该 Bundle 下的附属资源
总结几个 Leaf Bundle 的特点
- Leaf Bundle = 文件夹 +
index.md - 不能包含子 Bundle（即其子文件夹里不能还有
index.md） - 可以放在
content/目录下的任意深度（比如content/a/b/c/index.md也是合法的 Leaf Bundle） - 里面的非
index.md文件都属于资源，不是独立页面
OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog
【Ubuntu】【Hugo】首页板块配置：Branch Bundle