BabelDOC PDF 翻译完整上手指南【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个开源的 PDF 翻译工具把带公式和排版的 PDF 文档译成中英双语对照版。它主要面向要读外文论文、技术手册的人也适合想批量翻译文档、又不想打乱原文件格式的用户。整条流程跑在命令行里配一个 OpenAI 兼容的翻译模型就能出结果。项目名片它是什么一个 PDF 翻译库兼命令行工具。输入原始 PDF输出「原文译文」双语对照 PDF 和一份纯译文 PDF。能做什么自动解析版面、切分段落、给公式和表格留占位再逐段交给大模型翻译最后把译文排版回填进新 PDF。适合谁要长期读外文文献的研究者、学生以及需要批量本地翻译文档的团队。文档在本机处理不上传到第三方服务器。与同类工具的区别它把「解析—翻译—渲染」拆成可插拔管线中间产物统一为一份中间层表示IL方便接不同的翻译模型和渲染后端而不是一次性黑盒转换。安装与环境环境要求只有两条Python 3.10–3.13以及一个可用的 OpenAI 兼容 API本地模型如 Ollama 也可以。用 PyPI 安装最省事推荐固定 3.12uv tool install --python 3.12 BabelDOC babeldoc --help想从源码跑就换成这两行clone 后即插即用git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC uv run babeldoc --help装好能打印出参数列表就说明环境通了。第一次运行首次翻译走最短路径四步出结果。指定文档用--files传 PDF 路径一次可传多个。接翻译模型加--openai配上--openai-model、--openai-base-url、--openai-api-key。确认语言默认就是英译中中文文档翻译时可加--lang-in zh --lang-out en。收结果运行结束后当前目录或--output指定目录会多出双语版和纯译文版两个 PDF。一条命令打包前三步babeldoc --files 论文.pdf \ --openai --openai-model gpt-4o-mini \ --openai-base-url https://api.openai.com/v1 \ --openai-api-key 你的密钥效率进阶术语表导入步骤准备一个 CSV列名为source,target,tgt_lng用--glossary-files传入。命中词会被强制写进提示词保证专业词译法统一。样例见 docs/example/demo_glossary.csv。大文件分页处理--max-pages-per-part把长文档拆成若干块翻译再自动合并确定不是扫描件时加--skip-scanned-detection跳过检测提速。复杂排版兼容出兼容性问题时先试--enhance-compatibility它一次性开启跳过清理、译文优先、关闭富文本翻译三项。双语版的页面排列可用--use-alternating-pages-dual调整。复用译文省额度默认走翻译缓存相同内容不重复计费想强制重译加--ignore-cache。踩坑排障译文顺序错乱、部分段落缺失原因是某些 PDF 阅读器不兼容清理后的结构。加--enhance-compatibility即可缓解。整体处理偏慢通常是逐页做扫描件检测、并发受限。非扫描件加--skip-scanned-detection并适当调高--qps放开请求并发。扫描件翻译质量差彩色或带阴影的扫描图会偏离「白底黑字」假设。纯白底黑字文档可开--ocr-workaround用白块盖住原字并强制译文为黑色。延伸资源完整文档入口docs/各阶段实现细节docs/ImplementationDetails/支持的语言表docs/supported_languages.md版面/公式/表格示例 XMLexamples/术语表样例docs/example/demo_glossary.csv贡献与开发规范docs/CONTRIBUTING.md从一条命令到一份双语对照 PDFBabelDOC 的价值就在于把解析、翻译、渲染串成一条能落地的本地管线。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
BabelDOC PDF 翻译完整上手指南
BabelDOC PDF 翻译完整上手指南【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个开源的 PDF 翻译工具把带公式和排版的 PDF 文档译成中英双语对照版。它主要面向要读外文论文、技术手册的人也适合想批量翻译文档、又不想打乱原文件格式的用户。整条流程跑在命令行里配一个 OpenAI 兼容的翻译模型就能出结果。项目名片它是什么一个 PDF 翻译库兼命令行工具。输入原始 PDF输出「原文译文」双语对照 PDF 和一份纯译文 PDF。能做什么自动解析版面、切分段落、给公式和表格留占位再逐段交给大模型翻译最后把译文排版回填进新 PDF。适合谁要长期读外文文献的研究者、学生以及需要批量本地翻译文档的团队。文档在本机处理不上传到第三方服务器。与同类工具的区别它把「解析—翻译—渲染」拆成可插拔管线中间产物统一为一份中间层表示IL方便接不同的翻译模型和渲染后端而不是一次性黑盒转换。安装与环境环境要求只有两条Python 3.10–3.13以及一个可用的 OpenAI 兼容 API本地模型如 Ollama 也可以。用 PyPI 安装最省事推荐固定 3.12uv tool install --python 3.12 BabelDOC babeldoc --help想从源码跑就换成这两行clone 后即插即用git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC uv run babeldoc --help装好能打印出参数列表就说明环境通了。第一次运行首次翻译走最短路径四步出结果。指定文档用--files传 PDF 路径一次可传多个。接翻译模型加--openai配上--openai-model、--openai-base-url、--openai-api-key。确认语言默认就是英译中中文文档翻译时可加--lang-in zh --lang-out en。收结果运行结束后当前目录或--output指定目录会多出双语版和纯译文版两个 PDF。一条命令打包前三步babeldoc --files 论文.pdf \ --openai --openai-model gpt-4o-mini \ --openai-base-url https://api.openai.com/v1 \ --openai-api-key 你的密钥效率进阶术语表导入步骤准备一个 CSV列名为source,target,tgt_lng用--glossary-files传入。命中词会被强制写进提示词保证专业词译法统一。样例见 docs/example/demo_glossary.csv。大文件分页处理--max-pages-per-part把长文档拆成若干块翻译再自动合并确定不是扫描件时加--skip-scanned-detection跳过检测提速。复杂排版兼容出兼容性问题时先试--enhance-compatibility它一次性开启跳过清理、译文优先、关闭富文本翻译三项。双语版的页面排列可用--use-alternating-pages-dual调整。复用译文省额度默认走翻译缓存相同内容不重复计费想强制重译加--ignore-cache。踩坑排障译文顺序错乱、部分段落缺失原因是某些 PDF 阅读器不兼容清理后的结构。加--enhance-compatibility即可缓解。整体处理偏慢通常是逐页做扫描件检测、并发受限。非扫描件加--skip-scanned-detection并适当调高--qps放开请求并发。扫描件翻译质量差彩色或带阴影的扫描图会偏离「白底黑字」假设。纯白底黑字文档可开--ocr-workaround用白块盖住原字并强制译文为黑色。延伸资源完整文档入口docs/各阶段实现细节docs/ImplementationDetails/支持的语言表docs/supported_languages.md版面/公式/表格示例 XMLexamples/术语表样例docs/example/demo_glossary.csv贡献与开发规范docs/CONTRIBUTING.md从一条命令到一份双语对照 PDFBabelDOC 的价值就在于把解析、翻译、渲染串成一条能落地的本地管线。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
