月更 技术博客 CXX优先 Zola 2026-06-04T00:00:00+00:00 https://suchaharcan.github.io/tags/zola/atom.xml 2026-06-04T00:00:00+00:00 2026-06-04T00:00:00+00:00 Suchaharcan https://suchaharcan.github.io/03Share_blog/zola-build-deploy-circle/ <h2 id="shu-ju-liu-xiang-mo-ban-xi-jie">数据流向 模板细节</h2> <p>分页 和 时间排序 必须选一个； 一、 彻底搞懂 paginator 与 section在 Zola 中，section 和 paginator 是两个最核心的上下文对象，它们决定了数据如何流向模板。1. 什么是 section.pages？是什么：它代表当前目录（Section）下包含的所有文章（Pages）的集合（一个数组）。判定与生效机制：结构判定：无论是单文件 hello.md，还是文件夹包裹的 hello/index.md，只要它们躺在 content/01Write_blog/ 目录下，Zola 就会把它们识别为该目录的 Page。致命的过滤判定（为什么你之前会失踪）：Zola 默认是按照时间（Date）对 section.pages 进行排序的。如果你的 .md 文件中：没有写 date 字段。或者 date 格式不规范。或者你没有在 _index.md 中显式指定 sort_by = “date”。Zola 在渲染 section.pages 时，可能会因为排序混乱或未发布（如误识别为草稿），导致计算出的 section.pages | length 变成 0。2. 什么是 paginator.pages？是什么：它是当前分页切片后的文章集合（比如第 1 页的 10 篇文章）。判定与生效机制：它不会自动产生。只有当你在该目录的 _index.md 中，显式地配置了 paginate_by = 数字 时，Zola 才会实例化 paginator 对象。一旦开启，section.pages 的控制权就会移交给 paginator.pages。📊 它们在模板中的各自作用对象属性存在条件主要作用section.pages只要目录下有有效文章就有值用来不分页地一次性循环输出所有文章。paginator.pages必须在 _index.md 中配置 paginate_by用来做翻页导航（上一页/下一页），只展示当前页内容。</p> <p>在 Zola 中，section.pages 默认只能抓取到当前目录下直属的文章。 比如，你的归档页面在 content/archives/_index.md，如果你把博客都放在 content/01Write_blog/ 下，由于它们是平级（兄弟）关系，或者是完全独立的树枝，archives 页面去读取 section.pages 时，拿到的结果必然是空的（长度为 0），因此它什么都渲染不出来。</p> <h2 id="bu-chong">补充</h2> <p>后面要 抓取 补充 主题开发者 的文档信息 ；</p> <p>常见媒体的样式写法整理</p>