PDFMathTranslate 技术文档

【免费下载链接】PDFMathTranslate PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/Docker 项目地址: https://gitcode.com/Byaidu/PDFMathTranslate

1. 安装指南

1.1 系统要求

• Python 3.10-3.12（推荐3.12）
• Windows/Linux/macOS系统

1.2 安装方式

方法一：UV安装（推荐）

pip install uv
uv tool install --python 3.12 pdf2zh

方法二：Windows可执行文件

1. 从[发布页面]下载pdf2zh-version-win64.zip
2. 解压后双击pdf2zh.exe运行

方法三：Docker安装

docker pull byaidu/pdf2zh
docker run -d -p 7860:7860 byaidu/pdf2zh

方法四：Python包安装

pip install pdf2zh

2. 使用说明

2.1 基础使用

pdf2zh document.pdf

命令执行后会在当前目录生成：

• 单语翻译文档：example-mono.pdf
• 双语对照文档：example-dual.pdf

2.2 图形界面(GUI)

pdf2zh -i

浏览器将自动打开http://localhost:7860/

2.3 高级选项

选项	功能说明	示例
-i	启动图形界面	pdf2zh -i
-o	指定输出目录	pdf2zh doc.pdf -o ~/out
-s	选择翻译服务	pdf2zh doc.pdf -s google
-l	目标语言设置	pdf2zh doc.pdf -l zh

3. API文档

3.1 核心API

from pdf2zh import Translator

# 初始化翻译器
translator = Translator(service="google", target_lang="zh")

# 执行翻译
result = translator.translate_file("input.pdf", output_dir="output")

3.2 配置参数

参数名	类型	说明
service	str	翻译服务(google/deepl等)
target_lang	str	目标语言代码(zh/en/ja等)
keep_layout	bool	是否保留原格式(默认True)
dual_page	bool	是否生成双语对照(默认True)

4. 项目安装方式详解

4.1 Windows系统

1. 安装VC++运行库(vc_redist.x64.exe)
2. 下载预编译的Windows版zip包
3. 解压后直接运行pdf2zh.exe

4.2 Linux/macOS

推荐使用Python虚拟环境：

python -m venv venv
source venv/bin/activate
pip install pdf2zh

4.3 常见问题解决

如遇模型下载问题，可设置环境变量：

export HF_ENDPOINT=https://hf-mirror.com

4.4 云服务部署

支持以下云平台一键部署：

• Heroku
• Render
• Zeabur
• Sealos
• Koyeb

使用对应平台的部署按钮即可完成部署。

【免费下载链接】PDFMathTranslate PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/Docker 项目地址: https://gitcode.com/Byaidu/PDFMathTranslate