Hugo编译网站时未生成对应文件问题求助

以下是针对FAQ板块未被编译的具体排查和解决建议：

• 检查FAQ页面的Front Matter配置
  确保FAQ对应的Markdown文件头部有正确的Front Matter，必须包含title字段，同时确认draft字段未设为true——Hugo默认不会编译标记为草稿的内容。如果需要编译草稿，执行编译命令时加上参数：hugo --buildDrafts。

• 验证站点配置文件
  打开config.toml（或config.yaml/config.json），检查是否存在disableKinds配置项，确保其中没有包含page或其他会限制FAQ页面生成的选项；同时确认contentDir指向的目录与你的内容目录一致，避免FAQ所在目录未被Hugo扫描到。

• 检查布局模板是否存在
  Hugo需要对应的模板才能生成页面，确认主题的layouts目录下存在匹配的模板：比如FAQ页面如果属于faq类型，需要有layouts/faq/single.html；如果没有类型指定，需确保layouts/_default/single.html存在，否则Hugo无法生成该页面。

• 查看详细编译日志
  执行hugo -v命令获取详细编译日志，日志中会明确显示每个内容文件的处理状态，包括是否被跳过、跳过原因（如模板缺失、Front Matter错误等），根据日志信息快速定位问题。

• 检查文件命名与格式
  确保FAQ的Markdown文件后缀为.md，文件名使用小写字母、数字和连字符，避免特殊字符或空格，防止Hugo无法识别该文件。

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