BabelDOC 上手指南3 条命令翻译 PDF公式、表格、排版全保留【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC你手里有一份几十页的英文论文想读中文版可一丢给网页翻译公式全变乱码、表格散架、排版面目全非。开源项目 BabelDOC 就是冲着这个痛点来的它把 PDF 里的文字抽出来交给大模型翻译再把译文按原始位置排回去公式、表格原样保留顺手还能生成一份中英双语对照版。论文读不动翻译一翻全乱做研究、看技术文档的人都有过这种经历想快速扫读一篇英文 PDF翻译插件把文字翻了但数学公式、坐标轴、表格结构全被打散读起来比读英文还费劲。BabelDOC 想解决的就是既要翻得懂、又要保住排版这件事。它不是把 PDF 拍平成纯文本再翻译而是先保留文档结构再把译文原位移回去复杂公式也能照常阅读。装好就能跑安装与第一条翻译命令一键安装推荐用uv装一条命令搞定需要 Python 3.12uv tool install --python 3.12 BabelDOC装完跑一句babeldoc --help能正常输出说明环境没问题。首跑翻译翻译单个 PDF把模型和 key 填上即可babeldoc --openai --openai-model gpt-4o-mini --openai-api-key 你的key --files example.pdf要一次翻多个文件把--files多写几次就行。默认会同时产出双语对照版和纯译文版两个 PDF落在当前目录可用--output指定到别处。它能帮你扛下哪几件事公式和表格不丢原位回填译文普通翻译工具把 PDF 拍平成文本结构和位置全丢。BabelDOC 是先做文档布局分析认出哪些是正文、哪些是公式和表格再把译文按原来的坐标填回去所以翻出来的文档看着还是同一份文件只是文字换了。这套排版逻辑可以在 docs/ImplementationDetails/Typesetting/Typesetting.md 里看到实现细节。中英对照一眼看双栏生成它默认会生成一份左右分栏的双语 PDF左栏原文、右栏译文对照学习、逐句核对都方便。想只要双语版或只要纯译文版用--no-dual/--no-mono控制输出哪种即可。术语自己说了算自定义术语表专业文档里同一个词译法飘忽读起来很出戏。BabelDOC 支持喂一份 CSV 术语表列名source、target可选tgt_lng翻译时会优先照你的译法走。功能实现在 babeldoc/glossary.py示例可参考 docs/example/demo_glossary.csv。翻出来的 PDF 长这样下面是一份带公式的英文论文经 BabelDOC 翻译后的双语对照效果左侧保留英文原文与公式图表右侧是中文译文公式、表格和排版基本原样保留。想调得更顺手几个常用进阶配置大文档切块翻译页数多的 PDF 容易超时或爆内存。加--max-pages-per-part 50让它自动切成若干块翻译、再拼回完整文档单块大小自己定。扫描件 PDF 的 OCR 补救扫描件本质是图片里的字直接翻会漏内容。对白底黑字的扫描文档可以开--ocr-workaround它会在译文下方垫白块盖住原文并把文字统一转成黑字。注意这招只对白底黑字有效。换翻译引擎OpenAI 兼容接口随便接它只认 OpenAI 兼容接口但兼容范围很宽官方 API、各种中转、本地 Ollama 都能接改--openai-base-url和--openai-api-key就行本地模型 key 随便填个值也行。翻译器逻辑在 babeldoc/translator/ 里。目前主要优化了英文到中文其他语种对没做充分测试可查 docs/supported_languages.md。新手最容易踩的几个坑接口只认 OpenAI 兼容Bing、Google 这类传统翻译引擎没有针对性优化别硬接优先选 LLM 模型如gpt-4o-mini、deepseek-chat、glm-4-flash。语言对要认准默认--lang-in en、--lang-out zh其他组合可能翻得不稳建议先拿英译中试水。特殊 PDF 打不开个别结构特殊的文档翻译后兼容性差先加--enhance-compatibility等价于跳过清洗、译文页前置、关闭富文本翻译再试。key 别忘填--openai-api-key空着会直接报鉴权错误这是新手最容易漏的参数。路径尽量用绝对路径传相对路径有时定位不到文件建议给全路径。它到底适合谁用啃英文论文的学生 / 研究者边对照边读公式图表不丢最对路。读外文技术文档的工程师术语表 双语对照能快速过一遍资料。想自托管、可离线部署的团队提供离线资源包--generate-offline-assets/--restore-offline-assets内网环境也能跑。不太适合只想要一句话纯文本翻译的场景——它更偏文档级、重排版纯文本需求用轻量工具更快。写在最后BabelDOC 把PDF 翻译 保排版 双语对照这件事做成了几条命令的事公式和表格都不怕。先拿一份简单的 PDF 跑通第一条命令熟悉参数后再上复杂文档你会越用越顺。现在就装一个试试【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 BabelDOC 上手指南：3 条命令翻译 PDF，公式、表格、排版全保留
BabelDOC 上手指南3 条命令翻译 PDF公式、表格、排版全保留【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC你手里有一份几十页的英文论文想读中文版可一丢给网页翻译公式全变乱码、表格散架、排版面目全非。开源项目 BabelDOC 就是冲着这个痛点来的它把 PDF 里的文字抽出来交给大模型翻译再把译文按原始位置排回去公式、表格原样保留顺手还能生成一份中英双语对照版。论文读不动翻译一翻全乱做研究、看技术文档的人都有过这种经历想快速扫读一篇英文 PDF翻译插件把文字翻了但数学公式、坐标轴、表格结构全被打散读起来比读英文还费劲。BabelDOC 想解决的就是既要翻得懂、又要保住排版这件事。它不是把 PDF 拍平成纯文本再翻译而是先保留文档结构再把译文原位移回去复杂公式也能照常阅读。装好就能跑安装与第一条翻译命令一键安装推荐用uv装一条命令搞定需要 Python 3.12uv tool install --python 3.12 BabelDOC装完跑一句babeldoc --help能正常输出说明环境没问题。首跑翻译翻译单个 PDF把模型和 key 填上即可babeldoc --openai --openai-model gpt-4o-mini --openai-api-key 你的key --files example.pdf要一次翻多个文件把--files多写几次就行。默认会同时产出双语对照版和纯译文版两个 PDF落在当前目录可用--output指定到别处。它能帮你扛下哪几件事公式和表格不丢原位回填译文普通翻译工具把 PDF 拍平成文本结构和位置全丢。BabelDOC 是先做文档布局分析认出哪些是正文、哪些是公式和表格再把译文按原来的坐标填回去所以翻出来的文档看着还是同一份文件只是文字换了。这套排版逻辑可以在 docs/ImplementationDetails/Typesetting/Typesetting.md 里看到实现细节。中英对照一眼看双栏生成它默认会生成一份左右分栏的双语 PDF左栏原文、右栏译文对照学习、逐句核对都方便。想只要双语版或只要纯译文版用--no-dual/--no-mono控制输出哪种即可。术语自己说了算自定义术语表专业文档里同一个词译法飘忽读起来很出戏。BabelDOC 支持喂一份 CSV 术语表列名source、target可选tgt_lng翻译时会优先照你的译法走。功能实现在 babeldoc/glossary.py示例可参考 docs/example/demo_glossary.csv。翻出来的 PDF 长这样下面是一份带公式的英文论文经 BabelDOC 翻译后的双语对照效果左侧保留英文原文与公式图表右侧是中文译文公式、表格和排版基本原样保留。想调得更顺手几个常用进阶配置大文档切块翻译页数多的 PDF 容易超时或爆内存。加--max-pages-per-part 50让它自动切成若干块翻译、再拼回完整文档单块大小自己定。扫描件 PDF 的 OCR 补救扫描件本质是图片里的字直接翻会漏内容。对白底黑字的扫描文档可以开--ocr-workaround它会在译文下方垫白块盖住原文并把文字统一转成黑字。注意这招只对白底黑字有效。换翻译引擎OpenAI 兼容接口随便接它只认 OpenAI 兼容接口但兼容范围很宽官方 API、各种中转、本地 Ollama 都能接改--openai-base-url和--openai-api-key就行本地模型 key 随便填个值也行。翻译器逻辑在 babeldoc/translator/ 里。目前主要优化了英文到中文其他语种对没做充分测试可查 docs/supported_languages.md。新手最容易踩的几个坑接口只认 OpenAI 兼容Bing、Google 这类传统翻译引擎没有针对性优化别硬接优先选 LLM 模型如gpt-4o-mini、deepseek-chat、glm-4-flash。语言对要认准默认--lang-in en、--lang-out zh其他组合可能翻得不稳建议先拿英译中试水。特殊 PDF 打不开个别结构特殊的文档翻译后兼容性差先加--enhance-compatibility等价于跳过清洗、译文页前置、关闭富文本翻译再试。key 别忘填--openai-api-key空着会直接报鉴权错误这是新手最容易漏的参数。路径尽量用绝对路径传相对路径有时定位不到文件建议给全路径。它到底适合谁用啃英文论文的学生 / 研究者边对照边读公式图表不丢最对路。读外文技术文档的工程师术语表 双语对照能快速过一遍资料。想自托管、可离线部署的团队提供离线资源包--generate-offline-assets/--restore-offline-assets内网环境也能跑。不太适合只想要一句话纯文本翻译的场景——它更偏文档级、重排版纯文本需求用轻量工具更快。写在最后BabelDOC 把PDF 翻译 保排版 双语对照这件事做成了几条命令的事公式和表格都不怕。先拿一份简单的 PDF 跑通第一条命令熟悉参数后再上复杂文档你会越用越顺。现在就装一个试试【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考