PDFMathTranslatepdf2zh入门指南2 条命令翻译 PDF 论文公式与排版完整保留【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate第一次跑 PDFMathTranslate 的学生最担心三件事Python 版本对不对、首跑会不会卡住、翻完的东西排版还完不完整。这篇指南按先核对 → 再执行 → 后确认的顺序走一遍最短路径然后给出不同场景的用法、常用参数和排错命令。工具名pdf2zh装完就是两条命令的事一条翻译出中文 PDF公式、双栏、图注一个不动。跑通之前的三项核对执行前花 1 分钟确认这三点能避开绝大多数首次失败核对项要求依据Python 版本3.11或3.123.10/3.13都不行pyproject.toml 声明3.11,3.13网络首次运行需从 Hugging Face 下载版面模型wybxc/DocLayout-YOLO-DocStructBench-onnx断网会一直停在加载界面README.md依赖不用手装pip install会带 onnxruntime、pdfminer 等全部依赖pyproject.toml⚠️ 顺带一提命令行方式没有硬性网络要求但 GUI 首次加载模型时同样走下载建议先确保模型能拉下来。最短安装路径两条命令出结果pip install pdf2zh pdf2zh paper.pdf第一条装工具第二条翻译paper.pdf。默认走 Google 翻译无需任何密钥。✅ 跑完后当前目录多出两个文件paper-mono.pdf纯中文译文paper-dual.pdf中英对照版首跑会比之后慢不少那是模型在下载属正常现象。翻译效果如下左侧原文、右侧译文逐页对齐图 1 的编号与脚注都在原位按场景查用法场景命令说明只翻指定页pdf2zh paper.pdf -p 1-3,5只处理第 1–3 页和第 5 页页码用逗号分隔多段整目录批量pdf2zh --dir /path/to/papers/递归翻目录里全部 PDF结果落在当前目录图形界面pdf2zh -i启动后浏览器打开http://localhost:7860/界面里选服务、选页、实时预览Docker 部署docker pull byaidu/pdf2zh然后docker run -d -p 7860:7860 byaidu/pdf2zh同样是 7860 端口的 Web 界面适合不想装 Python 环境的人接入 Claude Desktoppdf2zh --mcp以 MCP 服务方式注册配置见 docs/ADVANCED.mdGUI 界面长这样翻译前可先预览它做了什么三句话说清pdf2zh先用 DocLayout-YOLO 的 ONNX 模型逐页检测公式、图片、表格、目录等元素。只有文字块会被送进你选的翻译服务默认 Google其余元素一律不碰。翻译完的文本按原字体、原位置写回所以版式漂移很小公式天然完好。细节可翻 pdf2zh/doclayout.py。常用参数速查参数作用例子-s切换翻译服务冒号后接模型名-s deepl、-s openai:gpt-4o-mini-li/-lo源语言 / 目标语言-li en -lo zh-t翻译线程数默认 4-t 8-o输出目录缺省当前目录-o results/--ignore-cache忽略翻译缓存强制重翻pdf2zh a.pdf --ignore-cache--prompt加载自定义 LLM 提示词文件--prompt my.txt--config加载 JSON 配置文件--config my.json完整参数表在 docs/ADVANCED.md。踩坑排查现象扫描版 PDF 翻不动输出是空的。原因文件是纯图片扫描件没有文本层而pdf2zh解析的是文本层。解决先 OCR 出文本层再投入翻译。现象首跑卡在模型下载不动。原因部分地区访问 Hugging Face 受限。解决运行前设镜像——Windows cmd 用set HF_ENDPOINThttps://hf-mirror.comPowerShell 用$env:HF_ENDPOINT https://hf-mirror.com。现象-s deepl后报鉴权错误。原因DEEPL_AUTH_KEY、OPENAI_API_KEY等环境变量没提前设置。解决各服务对应的变量名在 docs/ADVANCED.md 的环境变量表里查设完再执行。想让PDF 翻中文且保住排版装pdf2zh跑两条命令即可交付参数细节与环境变量对照请查官方文档 docs/ADVANCED.md。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
PDFMathTranslate（pdf2zh）入门指南：2 条命令翻译 PDF 论文，公式与排版完整保留
PDFMathTranslatepdf2zh入门指南2 条命令翻译 PDF 论文公式与排版完整保留【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate第一次跑 PDFMathTranslate 的学生最担心三件事Python 版本对不对、首跑会不会卡住、翻完的东西排版还完不完整。这篇指南按先核对 → 再执行 → 后确认的顺序走一遍最短路径然后给出不同场景的用法、常用参数和排错命令。工具名pdf2zh装完就是两条命令的事一条翻译出中文 PDF公式、双栏、图注一个不动。跑通之前的三项核对执行前花 1 分钟确认这三点能避开绝大多数首次失败核对项要求依据Python 版本3.11或3.123.10/3.13都不行pyproject.toml 声明3.11,3.13网络首次运行需从 Hugging Face 下载版面模型wybxc/DocLayout-YOLO-DocStructBench-onnx断网会一直停在加载界面README.md依赖不用手装pip install会带 onnxruntime、pdfminer 等全部依赖pyproject.toml⚠️ 顺带一提命令行方式没有硬性网络要求但 GUI 首次加载模型时同样走下载建议先确保模型能拉下来。最短安装路径两条命令出结果pip install pdf2zh pdf2zh paper.pdf第一条装工具第二条翻译paper.pdf。默认走 Google 翻译无需任何密钥。✅ 跑完后当前目录多出两个文件paper-mono.pdf纯中文译文paper-dual.pdf中英对照版首跑会比之后慢不少那是模型在下载属正常现象。翻译效果如下左侧原文、右侧译文逐页对齐图 1 的编号与脚注都在原位按场景查用法场景命令说明只翻指定页pdf2zh paper.pdf -p 1-3,5只处理第 1–3 页和第 5 页页码用逗号分隔多段整目录批量pdf2zh --dir /path/to/papers/递归翻目录里全部 PDF结果落在当前目录图形界面pdf2zh -i启动后浏览器打开http://localhost:7860/界面里选服务、选页、实时预览Docker 部署docker pull byaidu/pdf2zh然后docker run -d -p 7860:7860 byaidu/pdf2zh同样是 7860 端口的 Web 界面适合不想装 Python 环境的人接入 Claude Desktoppdf2zh --mcp以 MCP 服务方式注册配置见 docs/ADVANCED.mdGUI 界面长这样翻译前可先预览它做了什么三句话说清pdf2zh先用 DocLayout-YOLO 的 ONNX 模型逐页检测公式、图片、表格、目录等元素。只有文字块会被送进你选的翻译服务默认 Google其余元素一律不碰。翻译完的文本按原字体、原位置写回所以版式漂移很小公式天然完好。细节可翻 pdf2zh/doclayout.py。常用参数速查参数作用例子-s切换翻译服务冒号后接模型名-s deepl、-s openai:gpt-4o-mini-li/-lo源语言 / 目标语言-li en -lo zh-t翻译线程数默认 4-t 8-o输出目录缺省当前目录-o results/--ignore-cache忽略翻译缓存强制重翻pdf2zh a.pdf --ignore-cache--prompt加载自定义 LLM 提示词文件--prompt my.txt--config加载 JSON 配置文件--config my.json完整参数表在 docs/ADVANCED.md。踩坑排查现象扫描版 PDF 翻不动输出是空的。原因文件是纯图片扫描件没有文本层而pdf2zh解析的是文本层。解决先 OCR 出文本层再投入翻译。现象首跑卡在模型下载不动。原因部分地区访问 Hugging Face 受限。解决运行前设镜像——Windows cmd 用set HF_ENDPOINThttps://hf-mirror.comPowerShell 用$env:HF_ENDPOINT https://hf-mirror.com。现象-s deepl后报鉴权错误。原因DEEPL_AUTH_KEY、OPENAI_API_KEY等环境变量没提前设置。解决各服务对应的变量名在 docs/ADVANCED.md 的环境变量表里查设完再执行。想让PDF 翻中文且保住排版装pdf2zh跑两条命令即可交付参数细节与环境变量对照请查官方文档 docs/ADVANCED.md。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
