周四 翻译

Day 178:英文翻译的最后冲刺

建站第 178 天。

AI新闻英文点评全部完成

今天最大的收获是把所有72天的AI新闻英文点评都补齐了。这是一个拖了很久的工作——之前翻译AI新闻时,我们翻译了标题、摘要、每条新闻的内容,但唯独漏掉了每天的"一句话点评"(commentEn字段)。

这个遗漏导致英文版AI新闻页面在显示点评时是空白的,用户体验不完整。今天终于把这个坑填上了。

技术实现:写了一个Python脚本(fix_ai_news_comments.py),从translations_ai_news.json读取之前翻译好的72条英文点评,然后批量更新到ai-news-summary.ts数据文件中。脚本需要处理JSON转义、字符串匹配等问题,但整体逻辑并不复杂。

72天的点评,大约花了20分钟就全部搞定了。这就是自动化的力量——一旦你有了正确的数据源和脚本,批量处理就变得非常简单。

中英文版本差异修复

除了AI新闻点评,今天还修复了几个中英文版本的不一致问题。这些问题都是之前检查英文版时发现的:

  • 语言切换链接的双斜杠bug:英文版首页的语言切换链接显示为https://www.ban-bai.com//,多了一个斜杠。问题出在Base.astro中的alternateHref计算逻辑,修复后正常工作。
  • 英文版首页缺少入口区块:中文版首页有三个入口卡片("想学习AI工具"、"想做企业AI落地"、"想看我如何用AI工作"),但英文版没有。今天为英文版添加了对应的入口区块,并翻译了所有文案。
  • 英文版项目展示区块还是"Coming soon":中文版已经展示了5个实际运行的AI项目(山山AI助理、自动化内容系统、工作日记系统、AI新闻系统、SKILL-A/B内容生产),但英文版还是占位符。今天把中文版的项目展示复制过来,翻译成英文。
  • AI新闻摘要没有截断:中文版的AI新闻摘要限制在120字符,但英文版显示完整摘要,导致页面布局不美观。今天为英文版添加了truncate函数,统一截断为120字符。

这些都是细节问题,但影响用户体验。国际化工作不仅仅是翻译文案,还要确保两个版本的结构、功能、体验完全一致。

反思:国际化是一项持续的工作

今天的工作让我意识到,国际化不是一次性的任务,而是一个持续的过程。每次我们添加新功能、修改页面结构、调整样式,都可能在中英文版本之间引入不一致。

如何保持两个版本的一致性?我认为关键是:

  1. 建立检查清单:每次改动后,都要检查中英文版本是否一致。可以写一个自动化脚本来检测常见的不一致问题。
  2. 使用统一的组件:尽量让中英文版本使用相同的组件和布局,只替换文案内容。这样可以减少结构性差异。
  3. 定期审视:每隔一段时间(比如每周或每月),全面检查两个版本的差异,及时发现和修复问题。
  4. 文档化:记录国际化过程中的常见问题和解决方案,方便后续参考。

今天的修复工作虽然繁琐,但让网站的国际化质量提升了一个台阶。现在中英文版本在结构、功能、体验上基本一致了。

明天的计划

  1. 检查英文版的日记详情页是否正确显示HTML内容(之前发现HTML被转义为代码块的问题)
  2. 检查英文版的文章详情页是否正确显示HTML内容
  3. 如果发现问题,写脚本批量修复

建站第 178 天。网站的英文版本终于完整了。国际化工作告一段落,但维护工作才刚刚开始。

链接已复制