使用 Data 文件构建可配置站点

Hugo 的数据文件如同智慧的容器，让配置与内容和谐共舞。

在 Hugo 中，data 目录提供集中管理站点配置的方式。你可以使用 YAML、JSON 或 TOML 文件存储导航菜单、作者信息以及第三方服务参数，并在模板中通过 site.Data 访问。借助这种模式，内容与配置得以彻底分离，前端展示逻辑可以在不触动文章的情况下独立演进。当站点规模不断扩大或团队协作时，数据文件提供了统一的入口，便于快速调整结构化信息。进一步的做法是将这些文件与外部 API 同步，使站点在构建时自动获取最新数据，实现自动化更新。通过版本控制跟踪这些配置，还能在回滚时迅速恢复旧状态，维持整体稳定性。

数据文件格式

Hugo 支持多种格式的数据文件：

YAML: .yaml 或 .yml 扩展名
JSON: .json 扩展名
TOML: .toml 扩展名

文件放置在 data/ 目录下，可以创建子目录组织结构。

常见用途

数据文件适用于存储：

导航菜单配置
作者和贡献者信息
第三方服务参数（API 密钥等）
站点元数据
多语言翻译键值

模板访问

在 Hugo 模板中，通过 .Site.Data 访问数据文件：

<!-- 访问 data/authors.yaml -->
{{ range .Site.Data.authors }}
  <h2>{{ .name }}</h2>
  <p>{{ .bio }}</p>
{{ end }}

<!-- 访问嵌套数据 -->
{{ .Site.Data.navigation.main }}

最佳实践

使用数据文件管理术语表和导航配置。例如，data/glossary.yaml 存储技术术语的中英文对照：

AI Agent: 智能体
API Gateway: API 网关
CI/CD: 持续集成/持续部署

在模板中，可以通过数据文件动态生成术语解释。

总结

数据文件是 Hugo 数据驱动架构的核心，通过集中管理配置信息，提升了站点的可维护性和扩展性。