Hugo.io页面能否使用多个YAML文件？自定义菜单页配置求助

核心问题梳理 #

你基于Hugo+GitHub Pages搭配Arcana主题搭建站点，希望新增一个和主题自带landingpage.yml功能完全一致的自定义YAML页面（命名为test.yml），但复制/data/homepage.yml为test.yml、在content目录创建test.md配置菜单后，既没看到预期的菜单项，点击也无法加载test.yml的内容。

分步排查与解决方案 #

1. 修正test.md的Front Matter配置 #

Arcana主题的自定义落地页需要在Markdown文件的Front Matter中明确指定数据文件和渲染布局，确保你的test.md内容符合以下结构：

---
title: "Test Page"
menu: main
weight: 2 # 控制菜单位置，数值越小越靠前
dataFile: test # 对应/data目录下的test.yml文件名，不要加.yml后缀
layout: landingpage # 必须使用主题的landingpage布局，才能复用原落地页的渲染逻辑
---

关键提示：dataFile和layout这两个字段是核心，缺失或配置错误会导致无法加载YAML内容或使用错误模板渲染。

2. 校验test.yml的格式与结构 #

确保test.yml的字段结构和原homepage.yml完全一致，比如原文件中的sections、hero、buttons等层级字段不能缺失或格式错误。可以用本地工具校验YAML语法，比如执行：

yamllint /path/to/your/site/data/test.yml

如果没有安装yamllint，也可以直接对照原homepage.yml逐行检查缩进、字段名是否一致。

3. 检查主题模板的动态加载逻辑 #

部分主题的landingpage布局可能是硬编码加载homepage.yml，而非动态读取配置的dataFile。你需要打开主题目录下的layouts/landingpage/single.html（或类似路径），查看是否存在类似代码：

{{ $data := .Site.Data.homepage }}

如果是硬编码的homepage，则需要修改为：

{{ $data := index .Site.Data .Params.dataFile }}

这样模板就能根据test.md中配置的dataFile字段动态加载对应的YAML文件。

4. 用调试命令验证执行过程 #

使用你已有的调试命令重启服务：

hugo server --debug --verbose -F --disableFastRender

启动后重点查看控制台日志：

• 是否有Successfully loaded data from data/test.yml类的日志，确认YAML文件被正确加载
• 是否有Building page for /test/类的日志，确认test.md页面被正常构建
• 是否有模板渲染错误提示，比如error calling index: index of untyped nil，这类错误通常是dataFile配置错误或YAML文件不存在导致的

5. 清理缓存重新构建 #

Hugo的缓存可能会导致修改不生效，建议删除站点根目录下的public和resources目录，再重新执行构建命令。

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