BabelDOC 快速上手一份命令把英文 PDF 变成双语对照译文【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC手里有一份英文论文 PDF想快速看懂或者要把外文资料交给团队时保留原文作对照BabelDOC 就是干这件事的 PDF 翻译工具它解析 PDF 排版调用大模型翻译正文公式、表格、参考文献这类结构也会处理最后输出一份上下对照的双语 PDF——上面是原文下面是对应译文版式基本不动。场景一一条命令装好 BabelDOC这一步会下载 BabelDOC 及其依赖并注册babeldoc命令之后在任何目录都能直接调用。推荐用 uv 安装同时指定 Python 3.12 运行环境uv tool install --python 3.12 BabelDOC装完跑一次babeldoc --help能列出全部参数。如果你要改代码、做二次开发则从源码安装更合适git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC后进入目录用uv run babeldoc --help直接跑仓库里的版本。场景二跑出第一份双语 PDF这一步会完整翻译 example.pdf先解析版式再把英文段落逐段送进翻译服务最后在原文下方排上译文。最简命令只需要三个参数——文件路径、源语言、目标语言默认就是 en 到 zh不写也可以babeldoc --files example.pdf --lang-in en --lang-out zh运行需要能访问翻译服务。BabelDOC 接的是 OpenAI 兼容接口四个参数指定即可--openai开启、--openai-model填模型名如gpt-4o-mini、--openai-base-url填接口地址、--openai-api-key填密钥。任何兼容该协议的模型服务都能接不限于 OpenAI 官方。翻译完成后输出目录里会得到一份双语 PDF原文和译文逐段对齐方便边读边对照。场景三只翻译指定页面或一次处理多个文件论文有 80 页但你只关心前 5 页的正文--pages参数控制翻译范围语法支持单页、区间和省略写法比如1,3,5指定页、3-5区间、1-从第 1 页到结尾、-3前 3 页babeldoc --files example.pdf --pages 1,3,5反过来手头有好几份文档要一起翻就把--files重复使用每个文件写一次其余参数共享babeldoc --files doc1.pdf --files doc2.pdf --files doc3.pdf场景四表格、公式和模型选择前面几节覆盖了大多数情况这一节讲几个按需才用的开关。表格文字默认不翻译表格内容。报告类文档表格多的话可以加--translate-table-text打开。官方标注这是实验性功能排版可能有瑕疵建议先小范围试。公式正文里的数学公式会被识别并原样保留不参与翻译所以公式密集的论文可以放心整篇跑。术语表专业文档可以用--glossary-files挂一个 CSV 术语表仓库里 docs/example/demo_glossary.csv 有示例格式命中的术语会强制按表中译法输出。另外 BabelDOC 默认会自动抽取文档术语保持一致性不需要时可以关掉。模型怎么选日常阅读用轻量模型如gpt-4o-mini速度和质量都够用交付级文档换成更强的模型如gpt-4。同一套参数换模型名就行。长文档页数很多时可以用--max-pages-per-part把文档切块翻译降低单次失败的影响范围。更多参数的含义都写在babeldoc --help里原理细节可以参考 docs/ImplementationDetails/ 下的解析、排版等文档。避坑清单这几个问题最常被踩扫描件先确认能提取文字。BabelDOC 翻译的是 PDF 里的文本层纯扫描图需要你先做 OCR或至少跑一次小规模测试确认提取正常。API 四件套缺一不可。--openai标志、模型名、base-url、api-key 少一个都会直接报错先把这四个配通再谈参数调优。实验性开关先试后上。--translate-table-text、--ocr-workaround等标注 experimental 的参数正式翻译前先在一两个文件上验证输出。长文档留个工作目录。用--working-dir指定中间产物位置失败重跑时能直接复用已翻译的缓存不用从零开始。翻译质量看术语而非全文。先翻一两页重点核对专业术语是否一致再决定要不要上术语表比整篇翻完再返工省事得多。下一步把最常用的组合存成 shell 历史或写成小脚本下次打开终端就能直接翻。装好之后拿你手上任意一份英文 PDF 跑一遍场景二的命令看第一份双语对照输出比读十篇教程都直观。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考