Excalidraw 国际化优化：俄罗斯语言包深度适配实践

背景概述

Excalidraw 作为一款流行的开源白板工具，其国际化支持一直是社区关注的重点。近期在俄罗斯语言包(ru-RU)的适配过程中，发现若干核心交互组件仍存在硬编码的英文文本，这直接影响俄语用户的体验流畅度。本文将深入分析这些国际化缺口，并提出系统性的解决方案。

问题定位与分析

通过实际测试发现，当前俄罗斯语言包主要存在三类国际化问题：

1. 字体选择器组件

   • 快速搜索输入框占位文本("Quick search")
   • 场景字体分类标题("In this scene")
   • 可用字体分类标题("Available fonts")

2. 交互提示系统

   • Web嵌入功能按钮标签("Web Embed")
   • URL嵌入被拒的Toast提示("Embedding this url...")

3. 快捷键帮助文档

   • 流程图创建与导航说明
   • 图像裁剪相关操作提示
   • 画布属性控制命令

这些问题集中反映了国际化工作中的两个典型场景：组件文本硬编码和动态提示未接入i18n系统。

技术解决方案

结构化语言资源

建议采用模块化方式组织俄语文案资源：

{
  "labels": {
    "quickSearch": "Быстрый поиск",
    "fontsInScene": "В этой сцене",
    "availableFonts": "Доступные шрифты",
    "webEmbed": "Веб-вставка"
  },
  "toasts": {
    "embedNotAllowed": "Встраивание этого URL в данный момент запрещено..."
  },
  "helpShortcuts": {
    "createFlowchart": "Создать блок-схему из обычного элемента",
    "navigateFlowchart": "Навигация по блок-схеме"
  }
}

组件改造策略

1. FontPicker组件

   • 将静态文本替换为t()函数调用
   • 确保分类标题支持动态更新
   • 保留搜索框的无障碍属性

2. Toast系统

   • 建立统一的错误消息编码规范
   • 实现多语言错误消息映射
   • 保持原有样式和交互行为

3. 帮助文档

   • 重构快捷键说明为数据驱动
   • 支持按语言切换说明文本
   • 保持键盘图标等视觉元素不变

实施注意事项

1. 文本长度适配 俄语译文平均比英语长30%，需要：

   • 检查弹窗容器弹性布局
   • 验证长文本折行效果
   • 调整按钮最小宽度

2. 本地化细节

   • 专业术语一致性检查
   • 大小写规范转换
   • 标点符号本地化

3. 测试方案

   • 建立俄语专项测试用例
   • 验证RTL布局兼容性
   • 检查字体显示完整性

延伸思考

完善的国际化系统应该具备：

• 实时语言切换能力
• 译文缺失回退机制
• 翻译贡献者指南
• 自动化文案提取工具

通过本次俄罗斯语言包的深度适配，不仅解决了具体的使用问题，更为Excalidraw的国际化架构积累了宝贵经验。这种系统性的国际化改造思路，同样适用于其他语言包的优化工作。