Hugo 配置记录

记录我在用 Hugo 搭建博客时常用的一些命令,踩到的坑,解决方法等

最后修改于:

常用命令

  • hugo new site SITE_NAME 生成静态博客项目
  • hugo server 启动本地服务器,加上 -D 可以渲染 draft=true 的文章
  • hugo new post/new-content.mdpost 下新建一篇文章
  • hugo 生成站点静态文件(public 和 resources 目录)
  • hugo list drafts/expired/future 列出草稿/过期/未来的文件

踩坑记

  • 使用主题 Event 时, 文章必须放在 content/**post**/ 目录下, 否则 Home 页不会展示文章链接, 文章内也不会展示目录
  • 使用主题 Zzo 时, 要创建 Archive 页(类似 Event 中的 Home 页), 需要创建文件 content/archive/_index.md(参考 How to automatically generate archive page content #47)
  • 使用主题 Zzo 时, 在 GigHub Actions 配置中必须启用 Hugo extended 模式, 否则构建会失败(参考Hugo setup)

参考链接

Licensed under CC BY-NC-SA 4.0
最后更新于 2022/11/05 22:22 CST
本文总阅读量 次 本文总访客量 人 本站总访问量 次 本站总访客数
发表了20篇文章 · 总计32.36k字
本博客已稳定运行
使用 Hugo 构建
主题 StackJimmy 设计