Hugo：自定义标签标题
内容提要
本文介绍了如何在Hugo网站中自定义中文标签标题。通过修改主题文件和使用Python脚本，可以将标签名保持为英文，同时在页面上显示中文标题。具体步骤包括创建标签目录、编辑_index.md文件和调整HTML模板代码，以实现标签的正确显示。
延伸解读
为何要区分标签名与标签标题
文章指出，Hugo 中直接使用中文标签会导致 URL 中出现百分号编码（如 %E5%8D%9A%E5%AE%A2），影响链接可读性。通过将标签名保持为英文（用于链接），并在 _index.md 中定义中文标题，页面显示中文而链接保持简洁。这种分离既满足了显示需求，又避免了 URL 混乱，是中文网站常见的处理方式。
修改主题模板的关键步骤
文章以 hugo-theme-jane 为例，说明需要修改两处模板：文章页的标签列表（layouts/post/single.html）和标签云页面（layouts/_default/terms.html）。将模板中的 $name 或 $tagName 替换为 .LinkTitle，即可让页面显示标签标题而非标签名。不同主题的模板路径可能不同，但思路一致：找到输出标签名称的位置，改用 LinkTitle。
用脚本自动化创建标签标题文件
手动为每个标签创建 _index.md 并填写标题较为繁琐。文章提供了一个 Python 脚本，通过命令行参数指定目录、标签名和标签标题，自动生成对应的 _index.md 文件，并可选地执行 git add 和 git commit。这能减少重复劳动，尤其适合标签数量较多的站点。脚本依赖 Python 3，作者使用 3.12.4 版本。
改动后的检查与重定向提醒
文章建议在修改前后分别构建网站进行对比，以确认标签链接和显示效果符合预期。如果链接结构发生变化（例如从中文标签改为英文标签），旧链接可能失效，需要考虑设置重定向。作者本人因改动较多而忽略了此步骤，但读者若在意 SEO 或用户体验，应予以处理。
Q&A
如何在Hugo中自定义标签标题？
在Hugo中自定义标签标题需要创建标签目录，编辑_index.md文件以定义标签标题，并修改HTML模板代码以显示标签标题而非标签名。
为什么要在Hugo中使用英文标签名而中文标题？
使用英文标签名可以避免链接中出现无法识别的字符，同时在页面上显示中文标题以提高可读性。
如何使用Python脚本自动化创建标签标题文件？
可以编写一个Python脚本，接受目录、标签名和标签标题作为参数，自动创建相应的_index.md文件并写入标题内容。
在Hugo中修改HTML模板代码的具体步骤是什么？
需要找到相关的HTML模板文件，修改标签显示部分的代码，将标签名替换为标签标题，然后保存更改。
如何确保修改后的网站效果正确？
在修改后需要构建网站并进行本地预览，以对比修改前后的效果，确保标签标题正确显示。
如果链接有变化，如何处理旧链接的重定向？
如果修改导致链接变化，需要设置重定向规则，以确保旧链接仍然可以访问到相应的内容。
