PDFMathTranslate

PDF scientific paper translation and bilingual comparison.

📊 Retain formulas and charts.
📄 Preserve table of contents.
🌐 Support multiple translation services.

Feel free to provide feedback in issues or user group.

Installation

Require Python version >=3.8, <=3.12

pip install pdf2zh

Usage

Execute the translation command in the command line to generate the translated document example-zh.pdf and the bilingual document example-dual.pdf in the current directory. Use Google as the default translation service.

Please refer to ChatGPT for how to set environment variables.

Translate the entire document

pdf2zh example.pdf

Translate part of the document

pdf2zh example.pdf -p 1-3,5

Translate with the specified language

See Google Languages Codes, DeepL Languages Codes

pdf2zh example.pdf -li en -lo ja

Translate with DeepL/DeepLX

See DeepLX

Set ENVs to construct an endpoint like: {DEEPL_SERVER_URL}/{DEEPL_AUTH_KEY}/translate

DEEPL_SERVER_URL (Optional), e.g., export DEEPL_SERVER_URL=https://api.deepl.com
DEEPL_AUTH_KEY, e.g., export DEEPL_AUTH_KEY=xxx

pdf2zh example.pdf -s deepl

Translate with Ollama

See Ollama

Set ENVs to construct an endpoint like: {OLLAMA_HOST}/api/chat

OLLAMA_HOST (Optional), e.g., export OLLAMA_HOST=https://localhost:11434

pdf2zh example.pdf -s ollama:gemma2

Translate with OpenAI/SiliconCloud/Zhipu

See SiliconCloud, Zhipu

Set ENVs to construct an endpoint like: {OPENAI_BASE_URL}/chat/completions

OPENAI_BASE_URL (Optional), e.g., export OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY, e.g., export OPENAI_API_KEY=xxx

pdf2zh example.pdf -s openai:gpt-4o

Use regex to specify formula fonts and characters that need to be preserved

pdf2zh example.pdf -f "(CM[^RT].*|MS.*|.*Ital)" -c "(\(|\||\)|\+|=|\d|[\u0080-\ufaff])"

Preview

Acknowledgement

Document merging: PyMuPDF

Document parsing: Pdfminer.six

Document extraction: MinerU

Multi-threaded translation: MathTranslate

Layout parsing: DocLayout-YOLO

Document standard: PDF Explained, PDF Cheat Sheets

Contributors

Star History

Release files for pdf2zh 1.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pdf2zh 1.7.2
File	Size	Uploaded
pdf2zh-1.7.2.tar.gz	145.4 kB	Nov 14, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for pdf2zh 1.7.2
File	Interpreter	ABI	Platform	Reset
pdf2zh-1.7.2-py3-none-any.whl 152.9 kB Nov 14, 2024	Python 3	none	any	Details

Total release size: 298.3 kB

Release files / pdf2zh-1.7.2.tar.gz

Download URL	pdf2zh-1.7.2.tar.gz
Size	145.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`46adfd4f75fe0e1e5a925c6f1e84ba86687f3a06ae1578f96e555d9a59684ba1`
BLAKE2b-256 checksum How to use checksums	`a9d986a09a1311cf86bf011f78711a35924ed4034d350633b93239e773616381`
Upload date	Nov 14, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.1 CPython/3.11.9`

Release files / pdf2zh-1.7.2-py3-none-any.whl

Download URL	pdf2zh-1.7.2-py3-none-any.whl
Size	152.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`af9781b800ffc98a272b82a1ece7f9afccaf3c113f9e208ee1c3cec813b919d8`
BLAKE2b-256 checksum How to use checksums	`eb55c05d7c3511a40210ad794e1b42dabffc37085a242784dfd95c207dcafdc6`
Upload date	Nov 14, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.1 CPython/3.11.9`