Blowfish主题中如何显示文章创建与修改日期

在技术文档和博客写作中，内容的时效性至关重要。Blowfish作为一款优秀的Hugo主题，提供了完善的日期显示功能，能够同时展示文章的创建时间和最后修改时间，这对技术类内容的读者具有重要参考价值。

日期显示机制解析

Blowfish主题通过两个独立的配置参数控制日期显示：

1. showDate：控制是否显示文章创建日期
2. showDateUpdated：控制是否显示文章最后修改日期

这两个参数都位于主题配置文件的article部分。当同时启用时，页面会先显示创建日期，后跟修改日期，形成完整的时间线信息。

实现原理

主题底层通过Hugo的页面变量获取日期信息：

• 创建日期从Front Matter的date字段获取
• 修改日期优先从Front Matter的lastmod字段获取，若无则自动使用Git的最后修改时间

这种设计既保证了灵活性（允许手动指定修改时间），又提供了自动化方案（Git集成）。

配置建议

对于技术文档站点，推荐同时启用两个日期显示：

article:
  showDate: true
  showDateUpdated: true

在文章Front Matter中，可以这样设置日期信息：

date: 2025-05-10
lastmod: 2025-05-15

显示效果优化

Blowfish默认会以本地化格式显示日期，如"2025年5月15日"。如需自定义格式，可以通过Hugo的日期格式化功能进行调整。

对于频繁更新的技术文档，显示修改日期能有效提醒读者内容的最新状态，避免基于过时信息做出决策。这种设计特别适合API文档、教程类内容和技术规范说明。

注意事项

1. 确保Hugo版本支持lastmod自动检测
2. 在团队协作环境中，Git提交记录会影响自动lastmod检测
3. 静态站点生成后，日期信息会被固化，不会动态更新

通过合理配置Blowfish的日期显示功能，可以显著提升技术文档的专业性和实用性，为用户提供更准确的内容时效参考。