BabelDOC 快速上手3 条命令把英文论文变成中英对照 PDF【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个开源的文档翻译工具。给它一份英文 PDF它会还你一份原文与译文左右并列的中英对照 PDF 和一份纯译文 PDF版式、公式、图表尽量原样保留。照下文三条命令走一遍从安装到出成品。效果预览中英双语对照 PDF 长什么样先看成品。每一页的左右两栏分别是英文原文和中文译文公式保持公式的样子图表不漂移动图版的双语对照效果可以感受一下阅读顺序快速开始安装与首次运行第一步装工具。用 uv 一条命令完成没有 uv 的话先按官方提示装好并配置 PATHuv tool install --python 3.12 BabelDOC第二步接上模型跑文件。它对接的是 OpenAI 兼容接口官方 API、DeepSeek、Ollama 本地模型都能填babeldoc --files /绝对路径/paper.pdf --openai --openai-model gpt-4o-mini --openai-base-url https://api.openai.com/v1 --openai-api-key sk-你的key跑完后当前目录或--output指定的目录会多出两个新文件双语版原页与译页并排就是你要的 PDF 中英对照版单语版纯译文适合不想左右分屏的场景想跟最新源码的走克隆安装git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC uv run babeldoc --help首次运行会自动下载字体和版面分析模型需要联网断网环境的解法在下一步去哪一节。它怎么工作从解析到排版的八段流水线一句话版把 PDF 版面切成正文、公式、表格、图形等区域只把纯文本送进大模型公式符号原样放行最后按原文的字体字号重新拼出对照页面。中间靠一层中间表示衔接解析结果先落成结构化数据翻译和排版各自取用管线是插件式的模型、OCR、渲染器都能换。各阶段怎么找段落、怎么识别公式、怎么做排版docs/ImplementationDetails/ 分阶段各写了一篇解析与排版代码集中在 babeldoc/format/pdf/document_il/。参数速查日常真正用得上的 10 个参数作用什么时候用--pages 1,3,5-8只翻指定页花小钱先验证前几页--files可多次追加输入文件一次批量处理多份 PDF--lang-in/--lang-out源/目标语言默认 en→zh论文不是英文时--no-dual/--no-mono跳过双语版 / 单语版只留一种输出省生成时间--max-pages-per-part 30长文分批翻译再自动合并百页文档防中途失败--glossary-files terms.csv载入术语表专有名词译法要统一--qps 2限流默认 4 次/秒API 配额紧张时调低--output输出目录默认当前目录想把产物集中放一处--enhance-compatibility兼容性组合开关阅读器打不开、偏色时--ocr-workaround垫白底块、强制黑字扫描件翻译术语表 CSV 三列source,target,tgt_lng样例见 docs/example/demo_glossary.csv。翻译时命中的术语会被强制写进提示词专名译法就稳了。真实场景三种最常见用法场景 1先试读几页再全量。babeldoc --files paper.pdf --pages 1-5 --openai --openai-model gpt-4o-mini --openai-base-url https://api.openai.com/v1 --openai-api-key sk-你的key预期结果只出前 5 页的对照版版面没问题再跑全文费用可控。场景 2长论文分批 术语统一。babeldoc --files paper.pdf --max-pages-per-part 30 --glossary-files terms.csv --openai --openai-model gpt-4o-mini --openai-base-url https://api.openai.com/v1 --openai-api-key sk-你的key预期结果90 页自动拆成 3 批翻译结尾自动合并回一个 PDF中途挂了重跑也只补缺的页。场景 3只要纯译文方便手机读或打印。babeldoc --files paper.pdf --no-dual --output ./out --openai --openai-model gpt-4o-mini --openai-base-url https://api.openai.com/v1 --openai-api-key sk-你的key预期结果./out里只有单语译文 PDF没有左右分屏。避坑清单5 个高频症状对应解法译文叠字、鬼画符→ 是扫描件加--ocr-workaround前提是白底黑字。某些阅读器打不开或偏色→ 先加--enhance-compatibility代价是文件体积变大。中途报限流、请求被拒→ 调低--qps翻译带缓存修好重跑不会重复烧 API。Ollama 本地模型连接报错→ 本地服务不校验 key--openai-api-key a随便填一个即可。重跑结果不对→ 检查是不是误带了--ignore-cache它会强制全部重翻。诚实的局限它做不到什么作者区和参考文献可能被并成一段。这是 README 里 Known Issues 承认的问题还有横线分隔符、首字下沉不支持超大页会被跳过。其他语言方向未经充分打磨。官方口径是 CLI 主要用于调试除 en→zh 外的组合建议先用--pages抽几页验证。翻译只对接 OpenAI 兼容模型Bing、Google 这类传统翻译引擎不在支持范围。下一步去哪离线资产包、Python API 与社区项目想要 Web 界面和更多翻译服务可以看基于 BabelDOC 的社区自部署项目 PDFMathTranslate-next要把翻译嵌进自己的脚本或 Zotero 工作流用 Python 调high_level.do_translate_async_stream官方标注为内部 API按不稳定对待。docs/supported_languages.md 列了全部受支持的语言没有外网的实验室机器先在联网机器上跑babeldoc --generate-offline-assets ./assets打出离线资产包再在目标机用--restore-offline-assets恢复。命令跑完、对照 PDF 打开的那一刻读论文的速度基本就回到母语速度了。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考