https://mlosun.com/tags/%E8%A7%84%E8%8C%83/Recent content in 规范 on 数字花园 | Mlosun.comHugozh-cnmlosun@qq.com (mlosun)mlosun@qq.com (mlosun)© 数字花园 | Mlosun.comSat, 29 Aug 2026 00:00:00 +0800https://mlosun.com/tech/others/front-matter-%E8%A7%84%E8%8C%83/Sat, 11 Jul 2026 00:00:00 +0800mlosun@qq.com (mlosun)https://mlosun.com/tech/others/front-matter-%E8%A7%84%E8%8C%83/<h2 id="本站约定">本站约定 </h2> <ul> <li><code>title</code> 是唯一必填字段，没有它 Hugo 无法渲染页面。</li> <li>日期使用本站自定义的 <code>created</code> / <code>updated</code> 字段，由 <code>hugo.yml</code> 的 <code>frontmatter</code> 映射到 Hugo 原生的 <code>date</code> / <code>lastmod</code>。</li> <li><code>updated</code> 一般不写——页面「最后修改」由 <code>:git</code>（最后一次 commit 时间）自动填充；手动写 <code>updated</code> 才会覆盖。</li> <li>编辑器可能对 <code>created</code> / <code>updated</code> 报 schema 错误，这是误报，勿改名（改名会破坏日期映射）。</li> <li>字段取值优先级：页面 front matter → 上级 <code>cascade</code> → <code>hugo.yml</code> 站点参数。</li> </ul> <h2 id="文章页字段">文章页字段 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">字段</th> <th scope="col">作用</th> </tr> </thead> <tbody> <tr> <td><code>title</code></td> <td><strong>必需</strong>。页面标题，Hugo 没有它无法渲染页面</td> </tr> <tr> <td><code>created</code></td> <td>创建日期，<code>YYYY-MM-DD</code>，页面显示为「创建于」</td> </tr> <tr> <td><code>tags</code></td> <td>标签数组，如 <code>[Docker, NAS]</code>，Hugo 自动生成标签页</td> </tr> <tr> <td><code>description</code></td> <td>页面描述，用于搜索结果与社交分享；不写则自动截取正文前 70 字</td> </tr> <tr> <td><code>updated</code></td> <td>手动指定更新日期；不写则由最后一次 commit 时间自动填充</td> </tr> <tr> <td><code>weight</code></td> <td>列表内排序，数字越小越靠前</td> </tr> <tr> <td><code>draft</code></td> <td><code>true</code> 则页面不构建，<code>hugo server --buildDrafts</code> 下可见</td> </tr> </tbody> </table> </div> <h2 id="oink-主题常用字段">OINK 主题常用字段 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">字段</th> <th scope="col">作用</th> </tr> </thead> <tbody> <tr> <td><code>linkTitle</code></td> <td>短标题，用于侧栏、面包屑与翻页器（正文大标题不变）</td> </tr> <tr> <td><code>icon</code></td> <td>Font Awesome 图标类（如 <code>fa-solid fa-rocket</code>），用于侧栏与栏目卡片</td> </tr> <tr> <td><code>categories</code></td> <td>分类，与 <code>tags</code> 同为 taxonomy，Hugo 自动生成分类页</td> </tr> <tr> <td><code>series</code></td> <td>系列名；<code>series_weight</code> 决定在系列中的顺序</td> </tr> <tr> <td><code>images</code></td> <td>封面图，第一项兼作社交分享卡片</td> </tr> <tr> <td><code>sidebar_enabled</code></td> <td><code>false</code> 隐藏左侧栏，独立页面常用</td> </tr> <tr> <td><code>breadcrumb</code></td> <td><code>false</code> 隐藏面包屑导航；博客分区默认关，其余默认开</td> </tr> <tr> <td><code>notoc</code></td> <td><code>true</code> 则不显示右栏页面目录</td> </tr> <tr> <td><code>pager</code></td> <td><code>false</code> 关闭本页底部上一页/下一页</td> </tr> <tr> <td><code>backlinks</code></td> <td><code>false</code> 隐藏右栏「反链」组（本站已在站点级开启）</td> </tr> <tr> <td><code>comments</code></td> <td>评论开关：站点级已关闭</td> </tr> <tr> <td><code>aliases</code></td> <td>旧路径重定向到本页，页面改名时用于保住旧评论串与外链</td> </tr> </tbody> </table> </div> <p>完整字段表见 <a href="https://oink.pgsty.com/zh/docs/write/frontmatter/">OINK Front Matter 官方文档</a>。</p>