跳转到主要内容

Hugo

2 篇

  • 修复 Git 提交时间无法显示

    发布于 其他 389 字 1 分钟

    Hugo故障排查

    问题现象 文章页面底部的"最后更新"时间始终不显示，检查 Hugo 模板发现 .GitInfo 和 .Lastmod 均为空值。 原因 当文件路径包含中文等非 ASCII 字符时（如 content/docs/实践笔记/Docker 重启策略详解.md），Git 默认会对路径做转义处理，导致 Hugo 的 Git 集成无法正确匹配文件路径，.GitInfo 返回 nil，.Lastmod 随之失效。 这是 Hugo 的已知问题，umlauts（ä、ö、ü）等路径也会触发。 解决方案 本地开发 在 …

    问题现象 文章页面底部的"最后更新"时间始终不显示，检查 Hugo 模板发现 .GitInfo 和 .Lastmod 均为空值。 原因 当文件路径包含中文等非 ASCII 字符时（如 content/docs/实践笔记/Docker 重启策略详解.md），Git 默认会对路径做转义处理，导致 Hugo 的 Git 集成无法正确匹配文件路径，.GitInfo 返回 nil，.Lastmod 随之失效。 这是 Hugo 的已知问题，umlauts（ä、ö、ü）等路径也会触发。 解决方案 本地开发 在 …

  • Front Matter 规范

    发布于 其他 805 字 2 分钟

    Hugo规范

    本站约定 title 是唯一必填字段，没有它 Hugo 无法渲染页面。 日期使用本站自定义的 created / updated 字段，由 hugo.yml 的 frontmatter 映射到 Hugo 原生的 date / lastmod。 updated 一般不写——页面「最后修改」由 :git（最后一次 commit 时间）自动填充；手动写 updated 才会覆盖。 编辑器可能对 created / updated 报 schema 错误，这是误报，勿改名（改名会破坏日期映射）。 字段取 …

    本站约定 title 是唯一必填字段，没有它 Hugo 无法渲染页面。 日期使用本站自定义的 created / updated 字段，由 hugo.yml 的 frontmatter 映射到 Hugo 原生的 date / lastmod。 updated 一般不写——页面「最后修改」由 :git（最后一次 commit 时间）自动填充；手动写 updated 才会覆盖。 编辑器可能对 created / updated 报 schema 错误，这是误报，勿改名（改名会破坏日期映射）。 字段取 …