全部指南
指南

检查多语言 JSON 与 XLIFF:缺失文案、占位符及 RTL 审核

发现缺失译文与命名参数不匹配,检查已标注的原文回退及 RTL 预览,再从修改后的项目重新生成 JSON 与 XLIFF,无需翻译 API。

快速开始

让 AI 助手帮你完成

将这段提示粘贴到你正在使用的 AI 助手中:

使用 Localization QA Studio 审核我已确认的多语言目录。保留稳定键名、事实及准确命名占位符,区分缺失译文与已标注的原文回退,检查 RTL 和扩展预览,将不支持的框架格式留待实际运行时检查。应用已审核修改,下载修改后的项目,在新目录重新生成 JSON、XLIFF 与问题清单。核对准确导出值,记录剩余语言及布局审核。不调用翻译 API,不上传 TMS,不发布应用。

Localization QA Studio 校验什么?

Localization QA Studio v1.0.0 审核嵌套字符串目录及 {name} 等简单命名占位符,生成可编辑审核界面、多语言 JSON、XLIFF 2.0 交接文件、问题清单与扩展伪文案。单独内容包价格为 US$4.99;Python 3.10 及以上标准库生成器离线运行,无需翻译 API、TMS 账号或依赖安装。

它不会自动翻译,也不认证语言质量。复数对象、ICU 语法、字面花括号转义及框架特定格式,需要使用实际框架工具并审核。预览只呈现已提供的页面键顺序,不复现应用的完整布局或路由。

保留应用的键名、事实与消息格式

明确源语言、目标受众、框架及已确认产品术语。实际应用审核应覆盖导航、校验、空内容/加载状态、无障碍标签、账号控件及下载消息。本地项目支持 2–12 个语言对象和 1–12 个页面分组;目录使用嵌套字符串叶子,不接受数组或复数对象。改编目录前阅读 references/input.md。

消息路径使用 JSON Pointer 转义。稳定技术键名不是需要翻译的正文。支持的命名参数必须保留准确名称,其位置可按语法调整。重复参数按集合比较,因此仍应检查重复使用及最终运行时格式。

运行四语言示例,检查三项问题

在完整安装目录使用新输出文件夹运行以下命令,再打开 language-room/index.html。虚构 Atlas 项目包含 13 条英文原文、中文/德文/阿拉伯文目标练习及四个页面预览。初始三项问题含义不同,不等于三条翻译失败,也不是语言质量评分。

原始练习中不同的审核任务
语言与键问题审核操作
zh-CN · /hero/action 按钮缺少目标条目审核并补充行动文案;原文回退不是译文
de · /trip/body 正文缺少 {name} 参数在审核后的德文中恢复准确命名参数
de · /hero/action 按钮字符预算警告先检查实际容纳情况,再决定是否缩短
python3 scripts/build-localization.py --input examples/project.json --output ./language-room

应用修改,并与原文回退区分

选择中文和 /hero/action 消息。预览最初显示英文按钮,并标记 SOURCE FALLBACK。填写已审核目标文案,选择 Apply edit。练习可用“发现下一段旅程”,它是创作候选,并非认证译文。当前预览与所选语言 JSON 应显示填写的目标值;不要把回退原文复制进目录,再称为已完成翻译。

选择德文和 /trip/body,审核保留 {name} 的修正,例如下面的候选。支持的参数集合准确匹配后,占位符错误会消失。/hero/action 的独立长度警告可以保留;不要只为使问题数归零就删掉有用词语。结构有效不证明语言正确。

Hallo {name}, deine Reisenotizen sind bereit.

用 RTL 与扩展文案检查布局

选择阿拉伯文,检查实际从右向左预览、消息顺序及四个页面。尝试消息搜索与 Expanded preview。扩展文案保留原文占位符并拉长文字,并非另一种语言或译文。字符预算统计 Unicode 码点,不是实际字形宽度。

在目标应用检查窄屏重排、200% 文字缩放、字体、逻辑间距、焦点顺序及混合方向值。使用实际发布框架测试本地化日期、数字、货币、复数分支、页面标题与语言路由。审核界面示意稿不能证明这些集成结果。

从修改后的项目重新生成实现文件

下载 edited-project.json,在新目录执行以下命令。实时的所选语言 JSON 下载包含内存中修改,但静态 Original report、XLIFF 及其他已生成链接仍描述原始构建,直到重新生成。保留两份交付,以便审核者比较。

  • 将修改后的嵌套 JSON 与 messages/zh-CN.json、messages/de.json 对照。解析目标 .xlf 文件,检查源/目标语言及对应单元。缺失目标在 JSON 中保持缺失,在 XLIFF 中没有 target,不会悄悄填为英文。
  • 重新检查 report.json、findings.csv、pseudo/en-XA.json 中的占位符及 delivery-manifest.json 哈希。只修复练习中的两项错误后,独立德文长度警告仍需检查实际容纳情况。
python3 scripts/build-localization.py --input edited-project.json --output ./language-room-revised

交付审核后的目录,并明确应用集成状态

交付修改后的项目、嵌套多语言 JSON、各目标语言 XLIFF 2.0、报告、问题清单、伪目录、交接说明及清单。记录语言审核状态、术语决定及不支持的格式。已有输出文件夹受保护。框架集成、上传 TMS、发送订阅邮件及公开发布页面属于独立操作。

全部指南