Hugo 项目语言设置和 Meta 信息优化说明

执行日期

2026-01-28

修改内容

1. 语言默认设置优化

修改文件: config\_default\hugo.yaml

• 修改前: defaultContentLanguage: zh
• 修改后: defaultContentLanguage: zh-cn
• 说明: 统一语言代码为 zh-cn,与 languages.yaml 中的设置保持一致

修改文件: config\_default\languages.yaml

• 修改前: zh:
• 修改后: zh-cn:
• 说明: 将中文语言代码从 zh 改为 zh-cn,确保与默认语言设置一致

2. Meta 信息补全

为以下文章添加了完整的 meta 信息,包括:

• description: 页面描述
• keywords: 关键词数组
• author: 作者信息
• 规范化的日期格式 (使用 ISO 8601 格式,带时区 +08:00)
• 补充缺失的 tags 和 categories

修改的文章:

1. content\posts\越剧.md

   • 添加 description: “越剧相关内容汇总”
   • 添加 keywords: [“越剧”, “戏曲”, “传统艺术”, “兴趣”]
   • 添加 author: “Frida”
   • 规范化日期格式: 2026-01-27T12:00:00+08:00
   • 添加 draft: false
   • 补充 tags: [“兴趣”, “戏曲”]

2. content\posts\my-first-post.md

   • 添加 description: “欢迎来到我的新博客,这是我使用 Hugo 搭建的第一个站点”
   • 添加 keywords: [“Hugo”, “博客”, “第一篇文章”, “Markdown”]
   • 添加 author: “Frida”
   • 添加 tags: [“Hugo”, “博客”]
   • 添加 categories: [“教程”]

3. content\posts\test.md

   • 修改 title: “测试” → “短代码测试”
   • 优化 description: “Hugo Narrow 主题中所有可用的短代码示例和使用说明”
   • 添加 keywords: [“Hugo”, “短代码”, “shortcode”, “教程”]
   • 添加 author: “Frida”
   • 规范化日期格式: 2025-12-26T12:00:00+08:00
   • 扩展 tags: [“shortcode”, “Hugo”, “教程”]
   • 扩展 categories: [“shortcode”, “文档”]

4. content\about.md

   • 修改 title: “About” → “关于”
   • 将整个内容翻译为中文
   • 添加 description: “关于本站和 Hugo Narrow 主题的介绍”
   • 添加 keywords: [“Hugo”, “关于”, “博客”, “Hugo Narrow”]
   • 添加 author: “Frida”
   • 添加 draft: false
   • 规范化日期格式: 2022-01-25T14:00:00+08:00
   • 更新内容为 Hugo Narrow 主题相关信息

Meta 信息标准

为确保所有页面都能正确渲染和被搜索引擎索引,建议所有文章的 front matter 包含以下字段:

---
title: "文章标题"                    # 必需
date: 2026-01-28T12:00:00+08:00    # 必需,ISO 8601 格式
draft: false                        # 必需,是否为草稿
description: "文章简短描述"         # 推荐,用于 SEO
keywords: ["关键词1", "关键词2"]   # 推荐,用于 SEO
author: "作者名"                    # 推荐
tags: ["标签1", "标签2"]           # 可选
categories: ["分类1"]               # 可选
thumbnail: ""                       # 可选,文章缩略图
---

验证步骤

修改完成后,建议执行以下验证:

1. 运行 hugo server 查看网站是否正常启动
2. 检查首页默认显示的语言是否为中文
3. 验证各个页面的 meta 标签是否正确生成
4. 检查文章列表页面是否正常显示
5. 测试搜索引擎预览效果

注意事项

1. 所有已有的 .zh-cn.md 后缀的中文文件保持不变
2. 日期格式统一使用 ISO 8601 标准,包含时区信息 (+08:00)
3. keywords 和 tags 建议使用中文,有助于中文搜索引擎优化
4. description 字段控制在 150-160 字符以内,对 SEO 更友好

后续建议

1. 为其他尚未优化的文章添加完整的 meta 信息
2. 考虑为主要页面添加 Open Graph 和 Twitter Card 信息
3. 定期检查并更新过时的内容
4. 建立文章模板 (archetypes) 确保新文章自动包含所有必需字段