BabelDOCPDF 翻译工具如何最快跑通你的第一份双语 PDF【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个 PDF 翻译工具它保留原文版式、公式和图片位置把英文文档翻成目标语言并额外产出一份原文与译文对照的双语 PDF。从 80 页英文论文说起你拿到一份 80 页的英文论文明天要交中文笔记。截图贴 Word排版乱成一锅粥丢进在线翻译器公式位置全丢、版面像被拆开重排。BabelDOC 走的是另一条路先解析 PDF 的结构把每个文本段交给 LLM 翻译再把译文嵌回原来的坐标位置最后连公式、图片、分栏一起原样保留。最终你会拿到一份译文 PDF 和一份双语对照 PDF版式几乎没动。五分钟上手环境三行要求Python 3.10 以上低于 3.14Linux / macOS / Windows 都行首次运行要联网下载模型和字体推荐用 uv 装uv 是快速 Python 包管理器一句话装好工具uv tool install --python 3.12 BabelDOC # 一行装好装完直接能跑 babeldoc --help # 能打出帮助就算装成功了不想装工具、想从源码跑也行git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC uv run babeldoc --help # 在项目目录里直接运行第一次翻译只需告诉它用哪个模型、翻哪个文件babeldoc --openai --openai-model gpt-4o-mini \ --openai-base-url https://api.openai.com/v1 \ --openai-api-key sk-xxx --files example.pdf跑完去输出目录默认当前目录找example.zh.mono.pdf译文单语版。example.zh.dual.pdf是双语对照版。文件名带目标语言代码默认就是zh。它帮你解决了哪几个麻烦版式保留译文嵌回原位置不重排文档传统做法把 PDF 转成 Word 再翻译版面基本报废。BabelDOC 内部维护一套中间表示层可以理解为 PDF 的结构化线稿记着每个文本块在哪、什么字体、什么颜色翻译后把译文填回原坐标放不下就自动缩字号、换行。原文、公式、图片的位置都不动。几百页不炸内存分片、限速、缓存三件套长文档跑挂多半是内存或 API 限流。三个开关管这件事参数作用什么时候用--max-pages-per-part 50把文件按页数切成小块翻译完事自动合并文档超过百页--pool-max-workers 4内部任务线程池大小默认等于 QPS 值内存吃紧时调小--qps 4每秒最多发多少次翻译请求默认 4接口限流被卡时调小另外同一句文本翻过一次就存在本地缓存里重跑不重复花钱。扫描版 PDF 翻译开关白块盖原文黑字出译文扫描件没法直接提取文字--ocr-workaroundOCR 补偿就是为它准备的在译文下方垫一块白矩形盖住原文全部文字强制黑色前提是你的扫描件白底黑字。不想自己判断时用--auto-enable-ocr-workaround让程序自动检测扫描页超过八成才开启 OCR 处理。反过来确定是纯文本 PDF 时加--skip-scanned-detection省掉检测环节提速。学术论文、扫描版、批量任务怎么配学术论文术语表 表格翻译 无水印一组参数搞定参数值说明--glossary-files./terms.csvCSV 两列source,target命中术语会写进翻译提示词--translate-table-text开实验性功能翻表格里的文字--watermark-output-modeno_watermark输出不带水印的译文 PDF术语表默认是自动提取的加--save-auto-extracted-glossary可以把提取结果存成 CSV下次直接复用。跑完得到的译文版式和原文一致公式一个没少。扫描版文档参数值说明--ocr-workaround开白块盖原文、强制黑字适合白底黑字扫描件--auto-enable-ocr-workaround开不确定是不是扫描件时交给它自动判断效果接近版式保留的原文只是原文区域被译文区接管了。批量任务文件多时别堆命令行参数写个 TOML 配置文件更清爽[babeldoc] files [/abs/path/paper1.pdf, /abs/path/paper2.pdf] lang-in en lang-out zh-CN qps 8 max-pages-per-part 50 glossary-files /abs/path/terms.csv然后babeldoc --config config.toml一条命令跑整批。配置文件里所有参数和命令行同名官方示例在 README 里。排错速查四个高频故障的修复症状原因修复babeldoc: command not founduv tool install的路径没进 PATH或你走的是源码安装源码方式统一用uv run babeldoc ...运行翻译到一半内存爆掉大文档一次性全装进内存加--max-pages-per-part 50分片处理扫描版译文对不上位置扫描件默认走文本链路提取不到字加--ocr-workaround开补偿模式重跑同一份文件想省钱缓存命中会跳过翻译缓存就在~/.cache/babeldoc清掉重跑即可已知局限来自 README作者和参考文献区可能被合并成一段、不支持装饰线条和首字下沉、超大页面会被跳过。下一步看什么BabelDOC 的价值一句话版式不动译文原位嵌入双语对照直接产出。术语表管住专业词分片管住大文件缓存管住重复花费。处理原理逐阶段拆解docs/ImplementationDetails/支持的语言和代码对照docs/supported_languages.md踩到怪问题时加--debug中间结果会导出到~/.cache/babeldoc/working方便定位是哪一步出的错【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考