Shopify 知识库 · 指南
主题国际化：店面文本与编辑器文本
Shopify 主题国际化：区分 Storefront locale 与 Schema locale 两类文件、翻译键与商家内容，避免只翻译店面或编辑器一侧。
主题有两类不同的界面读者：顾客阅读店面，商家使用主题编辑器。两类文本分别管理，不能只因为键名相似就放进同一份翻译文件。
两套翻译各自服务谁
| 文件类别 | 谁会看到 | 典型内容 | 引用方式 |
|---|---|---|---|
| Storefront locale | 店铺顾客 | 按钮、错误提示、导航和无障碍文本 | Liquid 的 t 过滤器 |
| Schema locale | 主题编辑者 | 分区名称、设置标签和帮助文字 | Schema 中的 t: 翻译引用 |
默认语言是英语时，常见文件名分别是 en.default.json 和 en.default.schema.json；默认语言是项目选择，不是所有主题必须固定为英语。店面翻译、Schema 翻译。
从配置示例追踪文本
标题分区示例中的名称与标签属于 Schema 翻译。输入框里由商家填写的标题属于内容值，不能仅通过翻译输入框的标签就完成内容翻译。
处理一个页面时，先列出固定界面文案、商家配置文本和商品或文章内容，再分别确定来源。不要假定页面上的所有字都来自主题 locale 文件。
检查清单
- 检查引用的键在对应文件中存在，层级和拼写一致。
- 分别切换店面语言与编辑器语言，观察两种界面。
- 检查缺失键、长文案、标点和特殊字符。
- 合并翻译键时保留已有内容，不用示例 JSON 覆盖整份文件。
- 让错误信息、按钮文字和无障碍描述一起参与核验。
文件大小不能用来判断 locale 文件的职责；locale 文件是 JSON，不能夹带 HTML 注释。