PDFMathTranslate 保排版翻译完整指南：四步跑通你的专属工作流
PDFMathTranslate 保排版翻译完整指南四步跑通你的专属工作流【免费下载链接】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交论文前夜你急着重译一篇 30 页的期刊 PDF普通翻译工具却把公式翻成乱码、表格搅成一团。这正是 PDFMathTranslate 解决的问题用 AI 对科研 PDF 做全文翻译同时完整保留原版排版、公式和图表。下面带你一步步配好翻译服务搭出既保格式又能随时换引擎的工作流。 选型先行按使用场景挑翻译引擎这一节先定谁来翻译读完你会分清在线 API 和本地模型的关键差异后面配置一次到位。场景选什么引擎要密钥吗费用特点日常轻量使用Google / DeepL在线 APIGoogle 默认免配免费 / 按量上手最快、出结果稳离线或涉密文献Ollama本地模型不需要依赖本地硬件数据不出本机速度偏慢大批量、重质量OpenAI 系模型或多服务混用需要按调用付费用-s参数随时切换建议先用 Google 起步零配置就能看到效果后续有离线需求往同一份配置文件里加一条 Ollama 即可不用重装任何东西。 最小可用配置10 分钟译出第一份 PDF这一节给你从安装到出文件的最短路径做完你的工作目录里会有译版和双语版两个 PDF。安装程序需要 Python 3.11–3.12pip install pdf2zh默认翻译服务就是 Google不碰配置文件也能直接验证pdf2zh paper.pdf想锁定语言对或为切换引擎做准备就在~/.config/PDFMathTranslate/config.json里写一份最简配置该文件由 ConfigManager 源码 统一加载{ PDF2ZH_LANG_FROM: English, PDF2ZH_LANG_TO: Simplified Chinese, translators: [ { name: google } ] }跑完后当前目录会生成paper-mono.pdf纯译文和paper-dual.pdf双语对照。不想敲命令的话运行pdf2zh -i即可在浏览器里打开图形界面操作详见 GUI 文档⚙️ 进阶调优缓存、多服务切换、密钥安全这一节覆盖日常最会碰到的三件事省 API 费、换引擎、保护密钥每个都是一行参数或几行配置的事。开启缓存同篇文档重复翻译近乎免费译文默认会写入翻译缓存再翻同一篇或内容重叠的文档时已译内容不再调用 API。强制重译时加一个参数pdf2zh paper.pdf --ignore-cache切换到本地 Ollama 模型在配置文件translators数组里追加一条指定服务地址和模型{ name: ollama, envs: { OLLAMA_HOST: http://127.0.0.1:11434, OLLAMA_MODEL: gemma2 } }命令行加-s ollama即可生效。多个服务可以共存于同一份配置每次由-s决定用哪个比如-s openai:gpt-4o-mini还能临时指定模型。面向团队部署时保护密钥把 GUI 部署成共享服务时在配置里限定可用服务、隐藏服务端密钥避免页面上泄露{ ENABLED_SERVICES: [Google, Ollama], HIDDEN_GRADIO_DETAILS: true }再配合--authorized users.txt开启账号登录就能放心交给课题组同事使用。 效果验证四条标准验收译文这一节给出真实的前后对比拿到输出文件时按四条标准过一遍就能判断这次翻译是否达标。翻译前英文原文在 GUI 中的预览翻译后中文版本地化排版公式图表原样保留翻译过程中界面会实时刷新进度可随时查看效果验收标准公式保持原始排版样式没有被翻译成纯文本图片、表格、图号和页码位置不错位双栏布局、页眉页脚与原文页一致双语版段落顺序与原文逐段对应无跳段重复。四条都过这份配置就可以固定下来若有公式被翻直接查下面排错清单。 排错清单5 个高频问题首次运行卡在模型下载→ 连不上模型托管站 → 设置HF_ENDPOINT为镜像地址后重试。请求返回 404 / 401→BASE_URL漏写/v1或密钥失效 → 对照高级用法文档里的环境变量表逐项核对。产物 PDF 在部分阅读器里乱码→ 字体子集化兼容性问题 → 加--skip-subset-fonts重跑。同一页译文和上次一模一样→ 命中了翻译缓存 → 加--ignore-cache强制重译。个别符号仍被翻译→ 对应字体没进保留名单 → 把字体名补进-f正则里。收尾PDFMathTranslate 让保排版的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考