标签: Go
-
在 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,两套统计系统均已完成真实数据上报。
-
A Tour of Go 简体中文站正式上线后,我发现原生产域名 go-tour.shuijingwanwq.com 与既有 /tour/ 路径存在语义重复。此前曾评估直接移除 /tour/,但由于涉及路由、静态资源、模板和既有验证链路,最终放弃这一方案,改为将生产域名迁移至更具扩展性的 go-dev.shuijingwanwq.com。本文完整记录 Cloudflare DNS、腾讯云 EdgeOne、HTTPS、同路径 301、OneinStack、Nginx、Let’s Encrypt、静态资源 404 修正及旧源站清理过程,并通过新页面 200、静态资源 200、旧域名 301 完成最终验收。
-
A Tour of Go 多语言翻译项目完成 zh-CN 第一阶段正式上线。本文记录从 103/103 个课程页面完成翻译与验收,到 production release、systemd、Nginx、EdgeOne 和 HTTPS 正式部署的全过程,并重点复盘 glibc 版本不兼容、OneinStack 静态资源规则导致 CSS/JS 404、play.golang.org 无法访问、切换 go.dev Playground、release 权限导致 systemd 203/EXEC,以及 Nginx PID 与 systemd 管理脱节等生产问题。最终课程页面、远程运行、代码格式化和 /socket 安全约束均通过公网及浏览器验收,zh-CN 版本正式上线。
-
A Tour of Go 多语言翻译项目的简体中文 zh-CN 已完成 103/103 个正式课程页面、7/7 个 article metadata 和公共 UI 本地化。在完成生产环境安全运行服务后,本阶段进一步实现了确定性的 production publish:可生成包含独立 Tour binary、完整 _content、release.json 和 SHA256SUMS 的生产发布包。最终本地人工验收确认 185 个文件完整性校验通过,103/103 页面及 7/7 lesson 正常,Run 与 Format 可通过远程 Go Playground 工作,同时生产环境 /socket 保持关闭。至此,项目已具备正式部署条件,下一阶段进入实际生产环境部署。
-
记录 A Tour of Go 多语言翻译项目在简体中文 103/103 页面全部 ready 后的完整发布前验收过程。项目首先补齐完整语言正式投影与本地预览能力,将 103 个 canonical candidate 重新组装为 7 个 .article,并完成 103/103 HTTP 页面级验收;随后又在准备博客截图时发现 present.Doc.Title 和 present.Doc.Subtitle 未进入原有翻译模型,最终新增独立的课程元数据本地化层,实现 7/7 标题与副标题完整中文化。至此,课程正文、课程元数据和公共 UI 三层 zh-CN 本地化全部闭合,下一阶段将进入 production publish。
