用途
translate-pdf 用于翻译 PDF 文档，在翻译文本内容的同时保留原始结构、布局与样式，包括颜色、背景和位置。适用于用户希望将 PDF 翻译为其他语言且需要保持原有版式的场景。
主要能力
- 提取 PDF 中的文本内容，并列出所有唯一的文本字符串供审阅。
- 通过 JSON 映射文件将原文逐条替换为目标语言译文。
- 应用翻译后生成新的 PDF，保留原有结构、颜色与背景样式。
- 支持多种字体，覆盖不同语言：
| 字体 | 语言 |
|---|---|
| helv | 拉丁语系（英语、西班牙语、葡萄牙语、法语、德语等） |
| china-ss | 简体中文 |
| china-ts | 繁体中文 |
| japan | 日文 |
| korea | 韩文 |
使用方式
工作流程分为三步。
第 1 步：提取文本
python {skill_path}/scripts/extract_texts.py <input.pdf>
审阅输出，查看 PDF 中所有唯一的文本字符串。
第 2 步：创建翻译映射
将每条文本翻译为目标语言，创建 JSON 文件：
{
"Original Text 1": "Translated 1",
"Original Text 2": "Translated 2"
}
保存为 translations.json，放在输入 PDF 旁边。
第 3 步：应用翻译
python {skill_path}/scripts/translate_pdf.py <input.pdf> translations.json <output.pdf> --font <fontname>
字体选项见上文表格。
输出命名
追加语言后缀：filename_EN.pdf、filename_ZH.pdf、filename_JA.pdf。
适用场景
- 需要将 PDF 文档翻译为其他语言，同时保持原有版式、颜色和背景不变。
- 需要按语言分别输出文件（如英文版、中文版、日文版）的翻译任务。
限制与提示
- 翻译映射需由使用者自行创建，工具本身不提供自动翻译。
- 专有名词、缩写和技术术语在适当情况下应保持不变。
- CJK 字体会自动缩放至 90% 以获得更好的适配效果。
- 使用透明填充以保留原始背景颜色。
- 关于收费、价格、平台支持范围等信息，资料暂未提供。