系列: A Tour of Go 多语言翻译项目
A Tour of Go 多语言翻译项目
本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验,到生产发布与后续维护的实际开发过程。
项目入口:
✅ 简体中文:A Tour of Go 简体中文版
✅ 日语:A Tour of Go 日语版
✅ 德语:A Tour of Go 德语版
✅ 法语:A Tour of Go 法语版
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n
当前已上线简体中文、日语、德语和法语版本。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。
-
完成 A Tour of Go 西班牙语 es-ES 首次 Production 上线后,我没有停在“能上线”这一步,而是继续根据真实失败 evidence 收敛新增 locale 的生产流程。本文记录这次连续处理的 6 类问题:Cloudflare API 瞬态失败容错、首次 Production 公网验收去重、finalization 自动化、current-live locale 状态来源统一、Google/Bing 搜索引擎提交收口,以及 Locale Surface Review A gate 的 freshness scope 优化。最终目标不是让流程越来越复杂,而是让每一门新语言踩过的坑,都变成下一门语言可以直接复用的标准能力。
-
在 A Tour of Go 意大利语站首次 Production 过程中,站点部署、源站和 Cloudflare DNS 都正常,但公网验收却连续遭遇 curl 28、curl 97 等网络瞬态失败。最终没有继续堆叠更复杂的 SOCKS、超时和重试逻辑,而是把正式公网 machine acceptance 直接迁到 zgocloud 执行,让 105 个 sitemap URL、CDN Cache、HTML Identity 和 Socket Boundary 等检查稳定通过。本文记录这次从跨境 SOCKS 链路到 zgocloud direct 的调整过程,以及 bounded retry、fail closed、保留 Production 现场并正式 resume 等实践经验。
-
在 A Tour of Go 意大利语站首次 Production 中,Machine Acceptance 已经通过,但 Headless Chrome 却连续在 / 和 /tour/ 报出 page did not render。进一步排查发现,同一台 ThinkPad 对这两个页面连续 20 次 curl 请求全部返回 HTTP 200,问题并不在普通公网访问,而在 browser acceptance 对 document.readyState == “complete” 的依赖过强。最终将 render readiness 调整为 interactive 或 complete 加有效 body 内容,并允许最多 3 次独立 navigation,同时继续让正式语义检查保持单次、fail closed。修改后 Production Browser Acceptance 顺利通过。
-
在 A Tour of Go 意大利语站点上线后,我重新整理了 Google Search Console 与 Bing Webmaster Tools 的搜索引擎收口流程。Google 侧完成站点验证并提交 sitemap.xml 后,Bing 可以复用已有的 Google Search Console 账号授权,通过手动 Import 快速导入新的 locale 站点及 sitemap。本文记录 it-IT 从 GSC 成功发现 105 个页面,到 Bing 导入站点并识别 105 个 URL、0 错误、0 警告的完整过程,并明确“账号连接可复用,但新站点仍需手动导入”的边界。
-
在 A Tour of Go 多语言站点上线过程中,我开始将 IndexNow 纳入搜索引擎收口流程。实测中,新 Key 首次提交可能返回 HTTP 202,等待验证后才转为 200;更令人困惑的是,即使接口早已返回 200,Bing Webmaster Tools 仍长期显示 Get Started。经过多轮独立 Key、不同子域名、Bing direct endpoint 等测试后,第二天后台终于开始出现 Self 提交记录。与此同时,开启 Cloudflare Crawler Hints 后,英文、日语、德语站很快出现大量来源为 Cloudflare 的 IndexNow 记录。本文记录完整排查过程、直接提交与 Cloudflare Crawler Hints 的实际差异,以及最终将一次性全站 IndexNow bootstrap 标准化为 Go CLI 的实现思路。
