BabelDOC 上手一条命令把英文 PDF 翻译成双语对照版【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC你手头有 200 页英文论文周五前要给团队一份中文版。用 BabelDOC 这个开源 PDF 翻译库公式、图表、版式都保留原样翻译走你自己的模型接口。BabelDOC 是什么输入 PDF输出两个 PDFBabelDOC全称 Yet Another Document Translator读入英文 PDF输出一份纯中文 PDF 加一份中英同页对照的双语 PDF。它是库也是命令行工具翻译后端接任意 OpenAI 兼容接口。官方文档里说 CLI 偏调试用途但日常翻译直接用它没问题。目前主要精力投在英文翻中文上其他语言方向能跑但官方没怎么测过。最小上手路径装好就跑第一条命令安装一行验证一下uv tool install --python 3.12 BabelDOC babeldoc --help翻译也是一条命令。这里用本地 Ollama 举例本地模型时 API key 随便填一个值即可babeldoc --openai \ --openai-base-url http://localhost:11434/v1 \ --openai-api-key a \ --openai-model qwen2.5:14b \ --files paper.pdf --output out/GPT、GLM、DeepSeek 也都能接换个 base-url 和模型名就行。跑完out/下多出两个 PDF中文版和对照版。三个核心能力双语对照默认就输出一次跑完得两份文件不用额外配置。只想要一份时加--no-dual不出对照版或--no-mono不出单语版对照版默认带水印用--watermark-output-mode no_watermark去掉both则水印版和无水印版一起给。公式、图片、表格不进翻译模型流水线先做版面识别docvision 模块标出公式、图片区域再把文字段落送去翻译translator 模块。文档里公式有固定字体特征时可以用--formular-font-pattern显式指定表格文字翻译还是实验功能默认关闭用--translate-table-text打开。术语表自动提取 CSV 锁定默认会自动提取高频术语保证全文翻译一致可用--save-auto-extracted-glossary把结果存下来。想锁死自己的术语准备一份三列的 CSVsource,target,tgt_lng例如Transformer,变换器,zh-CN然后用--glossary-files terms.csv指过去。场景化用法先用 --pages 试翻前 10 页200 页的论文正式翻之前加--pages 1-10先验证公式排版和版式。满意了去掉这个参数跑全量不满意先调模型或术语别浪费整本的 token。大文档用 --max-pages-per-part 分块长文档容易内存吃紧加--max-pages-per-part 50BabelDOC 会按页数自动切块、分批翻译最后再合并成完整 PDF不用你手动拼文件。扫描件加 --ocr-workaround 兜底白底黑字的扫描版 PDF加--ocr-workaround它会在译文下面垫白色色块盖住原文并强制文字为黑色输出可读的双语文档。彩色底图或照片类扫描不适用。跑之前先看这 3 个坑 ⚠️阅读器显示乱或打不开先试--enhance-compatibility它等价于同时开启--skip-clean、--dual-translate-first、--disable-rich-text-translate注意--skip-clean会让文件体积变大。第一次运行很慢首次会下载版面模型和字体资产。离线机器可以先在联网机器上--generate-offline-assets打包再到目标机--restore-offline-assets恢复。非中文目标语言别抱太高期望官方支持最好的是英转中其他方向在支持列表里但未经充分测试排版乱了别调参数先换方向。资源导航项目 READMEREADME.md流水线细节解析、段落识别、样式公式、排版、生成docs/ImplementationDetails/支持语言列表docs/supported_languages.md术语表示例docs/example/demo_glossary.csvPDF 解析与重建代码babeldoc/format/pdf/装好环境后先跑一遍babeldoc --help所有参数和默认值都在里面。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/18 15:30:11 · 阅读 1.2k BabelDOC 上手：一条命令把英文 PDF 翻译成双语对照版
BabelDOC 上手一条命令把英文 PDF 翻译成双语对照版【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC你手头有 200 页英文论文周五前要给团队一份中文版。用 BabelDOC 这个开源 PDF 翻译库公式、图表、版式都保留原样翻译走你自己的模型接口。BabelDOC 是什么输入 PDF输出两个 PDFBabelDOC全称 Yet Another Document Translator读入英文 PDF输出一份纯中文 PDF 加一份中英同页对照的双语 PDF。它是库也是命令行工具翻译后端接任意 OpenAI 兼容接口。官方文档里说 CLI 偏调试用途但日常翻译直接用它没问题。目前主要精力投在英文翻中文上其他语言方向能跑但官方没怎么测过。最小上手路径装好就跑第一条命令安装一行验证一下uv tool install --python 3.12 BabelDOC babeldoc --help翻译也是一条命令。这里用本地 Ollama 举例本地模型时 API key 随便填一个值即可babeldoc --openai \ --openai-base-url http://localhost:11434/v1 \ --openai-api-key a \ --openai-model qwen2.5:14b \ --files paper.pdf --output out/GPT、GLM、DeepSeek 也都能接换个 base-url 和模型名就行。跑完out/下多出两个 PDF中文版和对照版。三个核心能力双语对照默认就输出一次跑完得两份文件不用额外配置。只想要一份时加--no-dual不出对照版或--no-mono不出单语版对照版默认带水印用--watermark-output-mode no_watermark去掉both则水印版和无水印版一起给。公式、图片、表格不进翻译模型流水线先做版面识别docvision 模块标出公式、图片区域再把文字段落送去翻译translator 模块。文档里公式有固定字体特征时可以用--formular-font-pattern显式指定表格文字翻译还是实验功能默认关闭用--translate-table-text打开。术语表自动提取 CSV 锁定默认会自动提取高频术语保证全文翻译一致可用--save-auto-extracted-glossary把结果存下来。想锁死自己的术语准备一份三列的 CSVsource,target,tgt_lng例如Transformer,变换器,zh-CN然后用--glossary-files terms.csv指过去。场景化用法先用 --pages 试翻前 10 页200 页的论文正式翻之前加--pages 1-10先验证公式排版和版式。满意了去掉这个参数跑全量不满意先调模型或术语别浪费整本的 token。大文档用 --max-pages-per-part 分块长文档容易内存吃紧加--max-pages-per-part 50BabelDOC 会按页数自动切块、分批翻译最后再合并成完整 PDF不用你手动拼文件。扫描件加 --ocr-workaround 兜底白底黑字的扫描版 PDF加--ocr-workaround它会在译文下面垫白色色块盖住原文并强制文字为黑色输出可读的双语文档。彩色底图或照片类扫描不适用。跑之前先看这 3 个坑 ⚠️阅读器显示乱或打不开先试--enhance-compatibility它等价于同时开启--skip-clean、--dual-translate-first、--disable-rich-text-translate注意--skip-clean会让文件体积变大。第一次运行很慢首次会下载版面模型和字体资产。离线机器可以先在联网机器上--generate-offline-assets打包再到目标机--restore-offline-assets恢复。非中文目标语言别抱太高期望官方支持最好的是英转中其他方向在支持列表里但未经充分测试排版乱了别调参数先换方向。资源导航项目 READMEREADME.md流水线细节解析、段落识别、样式公式、排版、生成docs/ImplementationDetails/支持语言列表docs/supported_languages.md术语表示例docs/example/demo_glossary.csvPDF 解析与重建代码babeldoc/format/pdf/装好环境后先跑一遍babeldoc --help所有参数和默认值都在里面。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考