标签： 开源项目
-
在为 A Tour of Go 多语言项目新增阿拉伯语版本时，我第一次真正处理 RTL（从右到左）语言。翻译本身仍沿用既有 TranslationUnit、Quality Check、Course SEO 和 Locale Surface Review 流程，但 RTL 很快暴露了桌面双栏重叠、移动端编辑器被压窄、课程导航方向语义变化、代码区必须保持 LTR 等问题。最终通过调整共享布局、响应式规则和浏览器回归测试完成阿拉伯语正式上线，并在排查 PageUp/PageDown 快捷键时进一步确认了一个可在官方 go.dev/tour 复现的上游焦点问题。整门阿拉伯语实际投入约 7 小时，相比普通 LTR 语言多出的时间，主要来自首个 RTL locale 的一次性基础设施建设。
-
记录 A Tour of Go 多语言翻译项目第一次系统开展站外推广的过程。除了 go.dev、搜索引擎和 GitHub 之外，实际尝试了 Go Weekly、Golang News、Reddit r/golang、DEV Community 和 Go Forum，并记录了投稿、社区活跃度、积分限制、审核机制、内容发布和外链策略。也进一步明确了后续推广思路：不单纯为了 SEO 堆链接，而是优先进入 Go 开发者真实活跃的社区，并逐步为不同语言版本寻找对应的本地开发者渠道。
-
A Tour of Go 历史上的多个社区翻译项目，曾经投入大量时间和人力，最后仍因为上游变化、部署失效、维护者更替、基础设施和长期投入等因素逐渐停止维护甚至离线。基于这些历史经验，我开始重新思考一个免费、多语言社区项目怎样才能长期存在。除了广告之外，这次项目正式加入了 Support 功能，为中文和国际用户提供不同的自愿支持方式。Support 的重点不是改变项目的免费和开放属性，而是为翻译更新、上游同步、Production、基础设施和长期维护增加一种可持续可能，同时继续优先保证社区项目能够被更多开发者发现、使用和长期维护。
-
在 A Tour of Go 多语言翻译项目中，广告接入没有直接将 AdSense 代码写入公开源码，而是沿用已有的生产配置注入机制，实现从 AdSense 专用配置到通用 HTML 注入架构的重构。 本次调整新增独立 TOUR_AD_HTML 注入链路，将广告内容通过 systemd 环境变量提供，由 Go 服务读取并渲染到 HTML 。公开源码和发布包只保留注入位置，不包含具体广告平台配置。 通过这一设计，项目实现了广告逻辑与具体平台解耦，同时保持源码公开、生产配置独立的架构，为未来更换广告平台或扩展其他 HTML 注入场景提供基础。
-
在 A Tour of Go 多语言翻译项目中，最初版本主要完成左侧课程正文的简体中文翻译，但右侧 Playground 示例代码仍然保留英文注释。 对于编程教程而言，课程正文和代码示例是一个完整学习单元。如果代码注释仍然是英文，即使代码可以正常运行，整体学习体验仍然不完整。 本次更新将 Playground Example 纳入统一翻译体系，作为独立 TranslationUnit 管理。项目通过 Go scanner 识别真实注释，只开放普通自然语言注释参与翻译，同时保护代码、字符串、布局以及机器语义内容，确保翻译后仍然保持合法 Go source。 最终，右侧 Playground 示例代码注释也完成中文本地化，实现从课程正文到代码示例的完整学习体验。
-
在 A Tour of Go 多语言翻译项目中，最初的自动化流程主要关注结构完整性和页面可发布性，例如 present 解析、代码保护、链接校验以及页面渲染验证。 随着翻译规模扩大，仅依靠自动验证已经无法完全保证译文质量。因此，项目进一步引入 Translation Quality Review，将翻译质量检查正式加入发布流程。 本次更新建立了独立的质量评审阶段，通过 A/B/C/D 四级质量评级、Review evidence 和 Promotion gate，对候选译文进行质量控制，使自动翻译流程从“结构正确”进一步提升到“质量可控”。
-
A Tour of Go 多语言翻译项目最初以固定版本的 Go 官方源码为基础完成简体中文翻译。随着课程内容持续演进，仅保存当前译文已经无法满足长期维护需求。 本次更新为项目引入 upstream 同步机制，通过记录官方源码基线 commit、检测 source revision 变化、标记 stale 翻译单元、重新生成翻译批次，并经过 validation、Translation Quality Review 与 promotion 流程，最终生成新的 production release。 此次实践使 go-tour-i18n 从一次性的课程翻译项目，进一步演变为具备持续同步能力的多语言维护系统。
-
本文记录 go-tour-i18n 项目翻译 A Tour of Go methods/16 页面时，对左侧教学代码注释翻译策略的完整校准过程。第一次翻译因代码块注释被译成中文而触发现有结构校验失败，随后项目通过全量审计确定：右侧可运行示例继续保持官方原样，左侧教学代码中的自然语言注释则应在安全边界内翻译。为此，项目新增了预格式化 Go 代码扫描、非注释代码逐字保护、注释内 Go 标识符保护、人工 candidate 独立校验，以及斜体、粗体和行内代码结构检查。最终 methods/16 在第二次尝试中通过自动校验、人工润色和浏览器预览，并沉淀了一批 methods 与 interfaces 相关术语。
-
本文记录 go-tour-i18n 项目使用 GLM-5.2 翻译 A Tour of Go generics/1 页面时的完整校准过程。一个看似简单的泛型页面先后经历网络权限失败、保护 Token 重复、legacy present 行内代码边界合并、Token 顺序交换等问题，最终通过中文提示词统一、Token 类型元数据和确定性空格规范化，在第五次尝试中通过自动校验，并完成人工润色、术语沉淀和浏览器预览。文章同时说明，当前项目仍处于代表页面校准阶段，尚未进入批量翻译。