企业官网建设流程全解析

BabelDOC 上手：一条命令把英文 PDF 翻译成双语对照版

【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC

你手头有 200 页英文论文，周五前要给团队一份中文版。用 BabelDOC 这个开源 PDF 翻译库，公式、图表、版式都保留原样，翻译走你自己的模型接口。

BabelDOC 是什么：输入 PDF，输出两个 PDF

BabelDOC（全称 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把结果存下来。想锁死自己的术语，准备一份三列的 CSV：source,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 50，BabelDOC 会按页数自动切块、分批翻译，最后再合并成完整 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恢复。
• 非中文目标语言别抱太高期望：官方支持最好的是英转中，其他方向在支持列表里但未经充分测试，排版乱了别调参数，先换方向。

资源导航

• 项目 README：README.md
• 流水线细节（解析、段落识别、样式公式、排版、生成）：docs/ImplementationDetails/
• 支持语言列表：docs/supported_languages.md
• 术语表示例：docs/example/demo_glossary.csv
• PDF 解析与重建代码：babeldoc/format/pdf/

装好环境后，先跑一遍babeldoc --help，所有参数和默认值都在里面。

【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC