ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

BabelDOC PDF 翻译实战:3 步把英文论文变成中英双语版

BabelDOC PDF 翻译实战:3 步把英文论文变成中英双语版 BabelDOC PDF 翻译实战3 步把英文论文变成中英双语版【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个开源的 PDF 翻译库能按原始版式把英文 PDF 翻译成中英双语 PDF公式、表格和图片位置基本保持不变。如果你经常读英文论文又希望译文和原文左右对照着看下面几步就能跑通你的第一份翻译结果。安装 BabelDOC 的 2 步方法安装只需要两件事先装uv一个 Python 包管理工具再用它装 BabelDOC。按uv官方文档安装它并把uv加入PATH。执行下面的命令安装 BabelDOC要求 Python 3.12uv tool install --python 3.12 BabelDOC运行babeldoc --help能看到选项列表就说明安装成功。不想装环境也可以直接从源码跑uv run babeldoc --help效果一样详见 README.md 的 Install from Source 一节。一条命令翻译你的第一份 PDF命令行入口定义在 babeldoc/main.py所有选项都通过参数传递。翻译一份 PDF 需要四样东西翻译服务开关、模型、服务地址、你的文件。准备一个英文 PDF 文件以及一个 OpenAI 兼容 API 的base-url和api-key本地 Ollama 之类的模型api-key随便填一个值即可。在 PDF 所在目录运行babeldoc --openai --openai-model gpt-4o-mini --openai-base-url 你的API地址 --openai-api-key 你的key --files paper.pdf等终端进度走完。过程中它会自动做版面分析、段落识别、术语抽取和重排版第一次运行还会下载字体等资产稍慢属正常。文件较大时建议用绝对路径多份文件可以重复传--files。验证结果输出里的双语 PDF 长什么样默认情况下BabelDOC 会同时产出两种 PDF双语版dual左右两栏原文和译文并排适合对照阅读纯译文版mono只保留译文版式接近原书打开双语版检查三处即可确认质量标题和正文是否对齐原栏目、公式是否保持原样、图表下方说明文字是否跟着移动。如果不想要其中一种输出加--no-dual或--no-mono。项目目前主打英文转中文其他语言组合的支持情况见 docs/supported_languages.md。翻译后 3 个常见需求的最快做法只翻译指定页用--pages传页码表达式支持逗号分隔和区间比如--pages 1,2,1-表示第 1 页、第 2 页和倒数第 1 页之后。配合--only-include-translated-page输出里就只包含你指定的那些页。大文件拆分翻译几百页的文档可以加--max-pages-per-part 50BabelDOC 会按页数自动拆分翻译完成后再合并回一个文件中途某部分失败也更好重试。强制统一术语译法翻译默认会自动抽取术语表如果你有固定译法准备一个 CSVsource、target两列格式参考 docs/example/demo_glossary.csv用--glossary-files 术语表.csv传入。命中术语的那一段翻译提示里会带上这个词表让模型按你的译法输出。换翻译后端和离线环境部署后端方面BabelDOC 只接 OpenAI 兼容接口所以换模型或换服务商只需要改--openai-base-url和--openai-api-key不需要动代码本地模型也是同理。完全离线或内网机器可以用资产包在有网的机器上执行babeldoc --generate-offline-assets 输出目录生成 zip再在目标机器上用--restore-offline-assets 包文件恢复字体和模型都齐全结果与在线环境一致。更多参数水印、扫描件处理、公式识别模式等按主题分组列在 README.md 的 Advanced Options 里也可以用--config加载一个 TOML 配置文件代替长命令行。到这里你已经能独立完成从安装到出图的全流程。想深入看版面分析和重排版的实现可以从babeldoc/format/pdf/document_il/目录读起需要源码时执行git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC即可。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进