如何用PDFMathTranslate完美翻译学术论文？保留公式排版的AI神器全指南 🚀

PDFMathTranslate 是一款基于AI的开源工具，能完整保留PDF学术论文的排版格式（包括公式、图表、目录），实现全文双语翻译。支持Google/DeepL/Ollama/OpenAI等翻译服务，提供CLI、GUI和Docker三种使用方式，让科研工作者轻松搞定外文文献阅读！

📌 为什么选择PDFMathTranslate？

✅ 核心优势

• 排版无损：数学公式、图表位置、字体样式1:1还原
• AI翻译：集成主流翻译API，专业术语翻译更精准
• 多端可用：命令行高效处理+图形界面可视化操作
• 完全免费：开源代码无广告，本地部署保护隐私

📸 翻译效果对比

▲ 翻译前：全英文PDF论文

▲ 翻译后：中英双语对照，公式和排版完全保留

⚡ 3分钟快速上手

📥 安装方式（任选一种）

1️⃣ 小白首选：Windows免安装版

1. 下载解压后双击pdf2zh.exe
2. 首次运行自动下载基础模型（需联网）
3. 拖拽PDF文件到窗口即可开始翻译

2️⃣ 开发者推荐：Python命令行

# 方式1：UV快速安装（推荐）
pip install uv
uv tool install --python 3.12 pdf2zh

# 方式2：传统PIP安装
pip install pdf2zh

3️⃣ 服务器部署：Docker容器

# 拉取镜像
docker pull byaidu/pdf2zh
# 启动服务（默认7860端口）
docker run -d -p 7860:7860 byaidu/pdf2zh

🖥️ 图形界面使用教程

▲ GUI模式：拖拽文件→选择语言→一键翻译，全程可视化操作

💻 高级使用技巧

🚀 命令行高效处理

# 基础翻译（默认生成双语PDF）
pdf2zh input.pdf

# 指定翻译服务和目标语言
pdf2zh research.pdf -s deepl -t zh

# 批量处理多文件
for file in *.pdf; do pdf2zh "$file"; done

⚙️ 常用参数配置

参数	功能说明	示例
-s	选择翻译服务	-s ollama（本地大模型）
-t	目标语言	-t ja（翻译成日语）
-i	启动图形界面	pdf2zh -i
-o	自定义输出路径	-o ./translated/

📝 命令行操作图解

▲ 中文参数说明：清晰标注各选项功能

🔧 常见问题解决

📡 网络连接问题

若模型下载缓慢，设置国内镜像源：

# Windows
set HF_ENDPOINT=https://hf-mirror.com

# Linux/Mac
export HF_ENDPOINT=https://hf-mirror.com

🖨️ 排版异常修复

• 问题：公式显示乱码
  解决：安装MiKTeX获取完整字体支持

• 问题：翻译后文件过大
  解决：添加--compress参数启用PDF压缩

📚 进阶学习资源

📖 官方文档

• 完整用户手册
• API接口开发指南
• 高级配置教程

🔍 实用场景示例

• 文献管理：配合Zotero批量翻译英文文献
• 论文写作：翻译后直接保留引用格式
• 学习笔记：双语对照便于理解专业概念

🤝 参与项目贡献

PDFMathTranslate是开源项目，欢迎通过以下方式参与：

• 提交代码：修复bug或开发新功能
• 反馈问题：在Issues中报告使用困难
• 翻译文档：帮助国际化适配更多语言

▲ 项目生态：多模块协作实现完整PDF翻译流程

💡 提示：完整参数说明可通过 pdf2zh --help 查看，或查看详细使用文档获取更多技巧！