标签： 上游同步
-
在排查 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 中文版项目进入代码实现后的阶段成果。通过调查六个现有翻译项目，项目最终没有复制整个 golang/website，而是从固定上游提交中提取可独立运行的 Tour 最小源码闭包，并建立文件级来源追踪。在完成英文基线、示例代码运行链路和 7 / 101 / 92 / 1 结构验证后，项目进一步为 101 个课程页面建立机器可读目录、页面级源哈希、持久 page_id、候选译文结构校验和上游变化预览机制。目前 101 个简体中文页面仍全部处于 pending，正式翻译尚未开始。