Hugo Apéro博客全局日期格式修改及本地化设置咨询

一、全局配置文件设置（优先推荐） #

直接修改站点根目录的config.toml（若使用YAML格式则修改config.yaml），通过配置实现全局日期格式统一：

1. 启用西班牙语本地化：添加或修改语言相关配置，让Hugo加载西班牙语的月份/日期文本

   defaultContentLanguage = "es"
   languageCode = "es-ES"
   

2. 设置目标日期格式：在[params]区块下定义日期格式，支持两种需求：

   • 西班牙语格式「1 de noviembre, 2024」：

     [params]
       dateFormat = "02 de Enero, 2006"
     

     （注：Hugo采用Go语言时间布局规则，2006为年份占位符，02是两位日期，Enero会自动根据本地化配置替换为对应西班牙语月份全称）
   • 纯数字格式「01/11/2024」：

     [params]
       dateFormat = "02/01/2006"
     

二、模板文件覆盖（若全局配置不生效时） #

如果主题部分模板硬编码了日期格式，需手动覆盖对应模板文件（推荐在站点根目录的layouts下创建同名文件，避免主题更新丢失修改）：

1. 定位主题中显示日期的模板文件，常见位置：

   • 文章列表页：layouts/_default/list.html
   • 文章详情页：layouts/_default/single.html
   • 首页文章卡片：layouts/index.html 或主题特定组件模板

2. 找到模板中类似{{ .Date.Format "January 2, 2006" }}的代码，替换为读取全局配置的格式：

   {{ .Date.Format site.Params.dateFormat }}
   

   或直接写死目标格式：

   {{ .Date.Format "02 de Enero, 2006" }}
   

三、多语言本地化进阶（可选） #

若需支持多语言切换，可在站点根目录的i18n/es.toml中添加日期格式的本地化翻译：

[date.format]
  other = "02 de Enero, 2006"

之后模板中使用{{ .Date.Format (i18n "date.format") }}即可自动加载对应语言的日期格式。

四、验证修改 #

重启Hugo本地服务（执行hugo server），刷新页面即可看到日期格式已更新为目标样式。

内容的提问来源于stack exchange，提问作者Bastián Olea Herrera