translate-pdf

将PDF文档翻译成任何语言，同时保留原始结构、布局和样式（颜色、背景、位置）。当用户想要：(1) 将PDF翻译成其他语言，(2) 将PDF从一种语言转换成另一种语言，(3) 创建PDF文档的翻译版本时使用。触发词：“翻译PDF”、“PDF翻译”、“把PDF翻译成”、“将此PDF翻译成中文/英文/日语”、“翻译成中文/英文”

SKILL.md

--- frontmatter

name: translate-pdf
description: |
  Translate PDF documents to any language while preserving original structure, layout, and styling (colors, backgrounds, positions).
  Use when user wants to: (1) translate a PDF to another language, (2) convert PDF from one language to another, (3) create translated version of PDF document.
  Triggers: "translate PDF", "PDF翻译", "把PDF翻译成", "translate this PDF to Chinese/English/Japanese", "翻译成中文/英文"

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