技术博客翻译（Hex4C59 / translations）

Front matter 模板

使用 TOML（+++ … +++），字段必须与列表页读取的参数一致。下列块可直接复制后填空（勿在 TOML 内写 # 注释，以免个别环境不兼容）。

+++
title = ""
date = 2025-03-25T12:00:00+08:00
lastmod = 2025-03-25T12:00:00+08:00
draft = true
author = "Hex4C59"
description = ""
summary = ""
tags = []
categories = ["Translations"]
topics = []
translation_category = ""
original_title = ""
original_url = ""
original_author = ""
original_date = ""
original_site = ""
ShowToc = true
+++

必填：original_title、original_url、original_author、original_date、original_site、description、date、translation_category；topics 至少一项便于筛选。

自动分类与主题推断

翻译新文章时，必须自主完成分类和主题的确定，无需向用户逐一确认。按以下流程执行。

分类推断流程（translation_category）

1. 分析原文：通读原文标题、副标题、各小节标题和核心关键词，判断文章所属技术领域。
2. 匹配已有分类：将分析结果与下方参考表对照。若原文主题明确落入某一分类的适用范围，直接使用该值。
3. 创建新分类（仅当已有分类均不贴切时）：
   • 取一个 2-4 个中文字 的简短名称，面向读者可理解，避免与已有分类语义重复。
   • 检查 assets/css/extended/translations.css 中是否已有对应 [data-category="新值"] 规则。
   • 若无，在该文件的分类颜色规则区域末尾追加一条，格式参考 reference.md 中的色板。
   • CSS 已有默认回退色，新分类即使暂无专属颜色也不会显示异常，但建议尽量补上以保持视觉一致。

分类参考表（可扩展）

此表不是封闭集合——只要现有值不贴切，就应创建新分类。

主题推断流程（topics）

1. 提取关键词：从原文中识别 3-6 个核心技术主题词（技术栈、方法论、工具名等）。
2. 复用已有主题：运行 rg "topics" content/translations/ --no-filename 查看所有已有 topics 值，优先复用已存在的拼写，保持筛选聚合一致性。
3. 命名规范：小写英文，多词用连字符连接（如 claude-code、responsive-design）；避免过于宽泛（如 coding）或过于狭窄（如 css-grid-gap-bug）。
4. 数量：3-6 个为宜，不超过 8 个。

说明：original_date 可能未在列表卡片展示，但必须写在 front matter；正文开头「译文信息」块向读者展示原文发布日与翻译日（见下节）。

正文开头的译文信息块

紧接 front matter 之后、正文第一段之前插入（链接用真实 original_url，列表与元数据保持一致）：

> **译文信息**  
> - 原文：[在此填写与 `original_title` 或站点名一致的链接文字](https://example.com/original-post)  
> - 作者：与 `original_author` 一致  
> - 原文发布：与 `original_date` 一致  
> - 翻译发布：与 front matter `date` 一致（若后文修订可写：「最新修订见页面元数据中的更新日期。」）

若原文含 License / 转载条款，在译文信息块下方或文末增加 「转载与版权」 小节，逐条说明（默认策略见 reference.md）。

翻译规则

1. 语言：正文使用 简体中文；专有名词（产品、API、库名、论文名、公司名、标准名等）保留英文；必要时首次出现可用「中文（English）」，后文统一为一种形式。
2. 代码：代码块内代码不翻译；不擅自改写标识符与命令；保留语言标签与缩进；仅当用户明确要求时才译代码注释。
3. 图表：优先使用 原作者图表（下载放入同 bundle 或引用原图稳定 URL）；图下可用斜体说明，并标明引用自原文。
4. 链接：外链 URL 保持可访问；锚文本可中文化；指向原文站内路径的链接保持原文 URL。
5. 结构：标题层级与原文对应；列表、表格、引用块与原文信息等价。
6. 译注：歧义、文化梗或技术背景用简短括号或脚注说明，避免长篇发挥。
7. 语气：与原文正式程度大致相当；不擅自改变技术论断与数据。
8. 长文可选：文末可加「术语对照」小节（见 reference.md）。

发布前检查

• 路径为 content/translations/<slug>/index.md，资源在同目录。
• draft：校对完成前为 true，发布前改为 false。
• original_url 在浏览器中可打开；original_author、original_title、original_date、original_site 已核对。
• date / lastmod 与「译文信息」中的翻译/修订叙述一致。
• description 非空；topics 3-6 项且与已有文章拼写一致；translation_category 已按推断流程确定（新分类需同步 CSS）。
• 专有名词与代码块符合「翻译规则」。
• 本地执行 hugo 构建无报错，列表页 /translations/ 卡片展示正常。

附加资源

• 专有名词示例、版权默认策略、主题命名习惯：reference.md