PDFMathTranslate
pdf2zh 1.8.0
English | 简体中文
PDF scientific paper translation and bilingual comparison.
Feel free to provide feedback in GitHub Issues, Telegram Group or QQ Group.
You can try our public service online without installation.
You can try our demo on HuggingFace without installation. Note that the computing resources of the demo are limited, so please avoid abusing them.
We provide three methods for using this project: Commandline, GUI, and Docker.
Python installed (3.8 <= version <= 3.12)
Install our package:
pip install pdf2zhExecute translation, files generated in current working directory:
pdf2zh document.pdfPython installed (3.8 <= version <= 3.12)
Install our package:
pip install pdf2zhStart using in browser:
pdf2zh -iIf your browswer has not been started automatically, goto
http://localhost:7860/
See documentation for GUI for more details.
Pull and run:
docker pull byaidu/pdf2zh
docker run -d -p 7860:7860 byaidu/pdf2zhOpen in browser:
http://localhost:7860/
For docker deployment on cloud service:
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 working directory. Use Google as the default translation service.
In the following table, we list all advanced options for reference:
| Option | Function | Example |
|---|---|---|
| files | Local files | pdf2zh ~/local.pdf |
| links | Online files | pdf2zh http://arxiv.org/paper.pdf |
-i |
Enter GUI | pdf2zh -i |
-p |
Partial document translation | pdf2zh example.pdf -p 1 |
-li |
Source language | pdf2zh example.pdf -li en |
-lo |
Target language | pdf2zh example.pdf -lo zh |
-s |
Translation service | pdf2zh example.pdf -s deepl |
-t |
Multi-threads | pdf2zh example.pdf -t 1 |
-o |
Output dir | pdf2zh example.pdf -o output |
-f, -c
|
Exceptions | pdf2zh example.pdf -f "(MS.*)" |
Some services require setting environmental variables.
Entire document
pdf2zh example.pdfPart of the document
pdf2zh example.pdf -p 1-3,5See Google Languages Codes, DeepL Languages Codes
pdf2zh example.pdf -li en -lo jaDeepL
See DeepL
Set ENVs to construct an endpoint like: {DEEPL_SERVER_URL}/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 deeplDeepLX
See DeepLX
Set ENVs to construct an endpoint like: {DEEPL_SERVER_URL}/translate
DEEPLX_SERVER_URL (Optional), e.g., export DEEPLX_SERVER_URL=https://api.deeplx.org
DEEPLX_AUTH_KEY, e.g., export DEEPLX_AUTH_KEY=xxx
pdf2zh example.pdf -s deeplxOllama
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:gemma2LLM with OpenAI compatible schemas (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-4oAzure
See Azure Text Translation
Following ENVs are required:
AZURE_APIKEY, e.g., export AZURE_APIKEY=xxx
AZURE_ENDPOINT, e.g, export AZURE_ENDPOINT=https://api.translator.azure.cn/
AZURE_REGION, e.g., export AZURE_REGION=chinaeast2
pdf2zh example.pdf -s azureTencent Machine Translation
See Tencent Machine Translation
Following ENVs are required:
TENCENT_SECRET_ID, e.g., export TENCENT_SECRET_ID=AKIDxxx
TENCENT_SECRET_KEY, e.g, export TENCENT_SECRET_KEY=xxx
pdf2zh example.pdf -s tencentUse regex to specify formula fonts and characters that need to be preserved:
pdf2zh example.pdf -f "(CM[^RT].*|MS.*|.*Ital)" -c "((|||)|+|=|d|[u0080-ufaff])"Use -t to specify how many threads to use in translation:
pdf2zh example.pdf -t 1Parse layout with PaddleX, PaperMage, SAM2
Fix page rotation, table of contents, format of list
Fix pixel formula in old paper
Support multiple language with Noto Font, Ubuntu Font
Retry except KeyboardInterrupt
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
