PDFMathTranslate 多语言翻译快速上手：一条命令把英文 PDF 翻成越南语
【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate
想把一份英文 PDF 直接翻成越南语发给客户？开源 PDF 翻译工具 PDFMathTranslate 的多语言翻译能力就是为此而生：一条命令加个语言参数就能完成，公式和排版都原样保留。
第一次上手：一条命令完成多语言翻译
最短的命令长这样：pdf2zh example.pdf -lo vi
就这一条。-lo指定目标语言，vi是越南语的语言代码，换成th、id、ms就能翻泰语、印尼语、马来语等东南亚语种。-li指定源语言，默认按英文处理，所以大多数场景不用写它；如果原文是日语、法语，再补上-li ja这样的参数就行。不喜欢命令行？执行pdf2zh -i会直接打开图形界面，翻译语言同样可以在界面上选。
内置语言不够用时：扩展小众语言的两条路线
主流语言开箱即用，但碰上小众语种、或者对译文措辞有特别要求时，有两条路可走：
| 路线 | 做法 | 适合谁 |
|---|---|---|
| 改源码里的语言列表 | 在语言枚举定义处加一个新语言选项 | 开发者、有长期需求的人 |
自定义--prompt提示词 | 把完整翻译指令写进 prompt 文件，再用--prompt参数指过去 | 普通用户、一次性的翻译任务 |
走第二条路线不用碰代码：提示词文件里写好你希望模型遵守的指令（比如"输出地道越南语，保留专业术语"），工具会自动把语言代码和待译文本填进模板。临时想加个说法，改改 prompt 文件比重开源码快得多。
它如何把语言代码变成翻译指令？
内部流程可以类比成"点菜上菜"。
语言代码映射，相当于把订单翻译成后厨黑话。你写zh，但不同翻译服务认的"方言"不一样，工具在 pdf2zh/translator.py 里用lang_map先把它转成各服务认可的zh-CN或zh-Hans，你只管填代码，不用操心每个服务怎么说话。
指令模板拼接，相当于服务员把订单套进固定话术。默认模板大致是"你是一个专业翻译引擎，请把下面文本翻译成{目标语言}，公式标记保持不变"——模板里的占位符会自动填进你的语言代码和原文，模型拿到完整指令才开始"做菜"。
公式排版靠"给食材编号"保住的。原文里的每个公式先被替换成带编号的占位符，模板明确告诉模型这些标记不许动；翻译完再把编号换回原位，公式和版面就都待在了该在的地方。
常见坑与避坑清单：PDF翻译报错快查
-pr短参数已经被移除了。老教程里常见的缩写在新版本里不认，必须写完整形式--prompt。照着旧文档敲完报"unrecognized arguments"，十有八九是踩了这个坑。
默认不指定源语言。不写-li时按英文原文处理。拿日语 PDF 翻越南语却忘了加-li ja，译文很容易跑偏——只要原文不是英文，就把源语言明确写上。
小众语言可以"先英后目标语"两步走。模型直接从一种小众语言翻到另一种小众语言时质量不稳定，拆成两步通常更靠谱：先翻成英文，再从英文翻到目标语言，两次命令串起来即可。
更多参数和服务配置细节，可以翻 docs/ 下的官方文档。
工具本身是模块化设计的，语言列表、指令模板、翻译服务都拆开存放，想补一个新语言通常只需改一行定义——缺的语言提个 PR 给社区，大家就能一起用上。
【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
