标签： Go
-
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。
-
在 A Tour of Go 多语言站点接入 Google AdSense 后，课程页虽然存在大片视觉空白，但普通展示广告始终没有出现。本文从 Auto Ads 配置、adsbygoogle.js 加载状态以及官方 A Tour of Go 的 DOM / layout 结构入手，分析为什么“页面看起来有空白”并不等于“Google 认为这里存在可插入广告的位置”。最终将问题范围收敛到 A Tour of Go 特殊的左右分栏和交互式页面结构，并引出后续一个更重要的架构选择：是否值得为了 AdSense 放弃原有 SPA。
-
在 go-tour-i18n 多语言翻译项目中，最初计划让 ChatGPT 完成翻译后直接写入 GitHub 仓库。实际验证后发现，当前会话环境中的 GitHub 写入、commit、push 流程不适合作为稳定依赖。因此项目调整为：ChatGPT 负责读取 GitHub 输入并生成 raw-responses artifact，本地环境通过新增的 retranslation import 命令完成导入、process、validation、review 和 Git 操作。本文记录这次翻译交付流程调整，以及 AI 与工程环境职责重新划分的实践经验。
-
在 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 从一次性的课程翻译项目，进一步演变为具备持续同步能力的多语言维护系统。
-
在 A Tour of Go 多语言项目的 Playground 浏览器直连代理稳定运行后，继续补齐第三方调用身份识别。根据 Go Playground 官方对第三方服务的使用说明，在 ZgoCloud Nginx 的 /compile 与 /fmt 转发请求中统一增加项目级唯一 User-Agent go-tour-i18n/1.0 (+https://github.com/shuijingwan/go-tour-i18n)，避免绑定具体语言或服务器。完成 Nginx 配置检查及 Compile、Format、CORS、方法限制等生产回归后，又向 golang-dev 公开邮件列表发送使用告知，使当前 Playground 调用链在保持正常运行的同时具备稳定、可识别且适合未来多语言扩展的项目身份。
-
为 A Tour of Go 简体中文生产站接入 Google Analytics 4 与百度统计。本文记录从审计现有 TOUR_ANALYTICS 注入机制、补齐首页统计入口，到使用 systemd EnvironmentFile 管理生产统计代码、重新生成并发布 production release，以及处理 EdgeOne 旧 HTML 缓存的完整过程。最终通过源站、公网页面和浏览器网络请求三层验证，确认 GA4 g/collect 返回 HTTP 204、百度统计 hm.gif 返回 HTTP 200，两套统计系统均已完成真实数据上报。