标签： Go
-
在为 A Tour of Go 多语言项目新增阿拉伯语版本时，我第一次真正处理 RTL（从右到左）语言。翻译本身仍沿用既有 TranslationUnit、Quality Check、Course SEO 和 Locale Surface Review 流程，但 RTL 很快暴露了桌面双栏重叠、移动端编辑器被压窄、课程导航方向语义变化、代码区必须保持 LTR 等问题。最终通过调整共享布局、响应式规则和浏览器回归测试完成阿拉伯语正式上线，并在排查 PageUp/PageDown 快捷键时进一步确认了一个可在官方 go.dev/tour 复现的上游焦点问题。整门阿拉伯语实际投入约 7 小时，相比普通 LTR 语言多出的时间，主要来自首个 RTL locale 的一次性基础设施建设。
-
Go 官方将我维护的法语、德语、韩语和简体中文 A Tour of Go 翻译站加入官方网站后，我再次同步了 golang/website 上游。一次看似普通的 upstream sync，很快暴露出 10 个正式语言站重复发布、CDN 清除、Production 验收和长时间运行可观测性的问题。本文记录如何把这些步骤逐步收敛为一个 –all-live 命令，同时保留 shared assets 验证、deploy、CDN purge、machine/browser acceptance、bounded retry 和 fail-closed 等正式 Production gate，并通过一次真实的 curl exit 28 → recovered → PASS 验证流程的容错能力。
-
记录我从邮件申请无人回复，到转向 GitHub Issue，再到处理广告、Tour 与 /doc、/blog 的链接边界、统一 feedback tracker，最终让简体中文、法语、德语、韩语 4 个 A Tour of Go 翻译站正式进入 Go 官方 Go local 列表的完整过程。这次收录不仅意味着获得了 go.dev 的官方入口和高质量反向链接，也让我开始用真实数据评估“无广告 Tour ↔ 官方入口”这笔长期交换是否值得。
-
A Tour of Go 多语言翻译项目在连续上线 nl-NL、pt-BR 和 tr-TR 后，正式社区语言版本已达到 10 个。本文集中复盘这一阶段继续暴露并解决的工程细节，包括 Production 浏览器验收的 zgocloud 网络链路、SOCKS 隧道生命周期、Quality Check revision lineage、Locale Surface Review 审核包导出、HTML Entity 导致的 Validator 误判，以及 Playground 长输出和 GitHub README 自动投影等优化。
-
在 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 意大利语站首次 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 意大利语站首次 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 西班牙语 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 的 SPA SEO 问题早已存在：对用户来说，103 个课程 URL 明明对应不同内容，但 Google Search Console 曾将多个页面判断为“重复网页，用户未选定规范网页”。这一次在继续优化 AdSense 的过程中，我最终决定为全部 103 个正式课程页生成独立 Prerender HTML，让服务器首次响应就直接包含本页标题、正文、Go 示例源码、canonical 和 description，同时继续保留 Angular SPA、CodeMirror 与 Playground。本文记录了为什么 SEO 与广告上下文理解共同推动了这次 Prerender 实现，以及如何让每个课程 URL 真正拥有独立页面身份。
-
在排查 A Tour of Go 展示广告始终不出现的问题时，一个看似直接的方案是放弃 SPA，让每一节课程都通过完整页面刷新来简化 AdSense、统计和 SEO。但进一步对比后发现，最大的代价并不是一次性的前端改造，而是长期偏离 golang/website 上游架构，持续增加同步与维护成本。本文结合官方 A Tour of Go 的 SPA 导航、上游 _content/tour/ 目录以及项目自身的 upstream baseline 管理方式，对“保留 SPA”与“放弃 SPA”进行完整权衡，并最终确定：让广告适配 A Tour of Go，而不是为了广告重新设计 A Tour of Go。