Hugo网站本地正常显示但GitHub Pages部分内容缺失求助

• 检查活动文件的front matter配置
  确认content/event/下两个活动文件的关键字段：

  • draft：如果设为true，Hugo默认部署时不会构建该内容，而本地预览可能默认包含草稿。需改为false或在构建时添加--buildDrafts参数。
  • date/end_date/publishDate：若活动日期在未来，Hugo默认不会构建（--buildFuture=false），但本地blogdown预览可能开启了该参数。需在部署构建命令中添加--buildFuture，或调整活动日期。

• 核对GitHub Action的构建参数
  查看部署用的hugo.yml文件，确认：

  • Hugo构建命令是否包含--buildFuture或--buildDrafts，确保和本地预览的构建参数一致。
  • Action使用的Hugo版本与本地hugo version输出的版本一致，版本差异可能导致渲染逻辑不同。

• 排查主题的筛选逻辑

  • 查看主题中“近期及待办讲座”板块的模板代码，确认是否有数量限制（比如只取前1条）或日期筛选规则，本地和部署环境的系统时间差可能影响筛选结果。
  • 检查主题配置文件（如config/_default/params.toml）中是否有活动显示数量的配置项。

• 本地模拟生产构建验证
  在本地执行hugo --minify命令生成生产环境文件，查看public目录下的活动页面是否完整。如果本地生产构建也缺失内容，说明问题出在本地配置而非部署环节。

内容的提问来源于stack exchange，提问作者Grant Foster