---
id: ssh2-translate-pdf
name: "translate-pdf"
url: https://skills.yangsir.net/skill/ssh2-translate-pdf
author: wshuyi
domain: writing
tags: ["pdf-processing", "document-translation", "ocr", "natural-language-processing-(nlp)", "file-conversion"]
install_count: 708
rating: 4.20 (33 reviews)
github: https://github.com/wshuyi/translate-pdf-skill
---

# translate-pdf

> 将PDF文档翻译成任何语言，同时保留原始结构、布局和样式。，AI Agent Skill，提升工作效率和自动化能力

**Stats**: 708 installs · 4.2/5 (33 reviews)

## Before / After 对比

### 翻译PDF文档，保留原始结构与样式

## Readme

# PDF Translation

Translate PDF text while preserving structure, colors, and background styling.

## Workflow

### Step 1: Extract texts

```bash
python {skill_path}/scripts/extract_texts.py <input.pdf>
```

Review output to see all unique text strings in the PDF.

### Step 2: Create translation mapping

Translate each text to target language. Create JSON file:

```json
{
  "Original Text 1": "Translated 1",
  "Original Text 2": "Translated 2"
}
```

Save as `translations.json` next to input PDF.

### Step 3: Apply translations

```bash
python {skill_path}/scripts/translate_pdf.py <input.pdf> translations.json <output.pdf> --font <fontname>
```

**Font options:**
| Font | Language |
|------|----------|
| `helv` | Latin (English, Spanish, Portuguese, French, German, etc.) |
| `china-ss` | Simplified Chinese |
| `china-ts` | Traditional Chinese |
| `japan` | Japanese |
| `korea` | Korean |

## Output naming

Append language suffix: `filename_EN.pdf`, `filename_ZH.pdf`, `filename_JA.pdf`

## Tips

- Keep proper nouns, abbreviations, technical terms unchanged when appropriate
- CJK fonts auto-scale to 90% for better fit
- Use transparent fill to preserve original background colors


---
*Source: https://skills.yangsir.net/skill/ssh2-translate-pdf*
*Markdown mirror: https://skills.yangsir.net/api/skill/ssh2-translate-pdf/markdown*