Home/Tech Writing/translate-pdf
T

translate-pdf

by @wshuyiv
4.2(33)

Translate PDF documents into any language while preserving original structure, layout, and style. AI Agent Skill to improve work efficiency and automation capabilities.

pdf-processingdocument-translationocrnatural-language-processing-(nlp)file-conversionGitHub
Installation
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf
compare_arrows

Before / After Comparison

1
Before

When translating PDF documents, manual copy-pasting is extremely time-consuming and easily damages the original layout and style. Extensive reformatting is required after translation.

After

Automatically translates PDF documents into the specified language, while perfectly preserving the original structure and style. Significantly improves document translation efficiency and quality.

SKILL.md

PDF Translation

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

Workflow

Step 1: Extract texts

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:

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

Save as translations.json next to input PDF.

Step 3: Apply translations

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

Font options:

FontLanguage
helvLatin (English, Spanish, Portuguese, French, German, etc.)
china-ssSimplified Chinese
china-tsTraditional Chinese
japanJapanese
koreaKorean

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

User Reviews (0)

Write a Review

Effect
Usability
Docs
Compatibility

No reviews yet

Statistics

Installs708
Rating4.2 / 5.0
Version
Updated2026年5月23日
Comparisons1

User Rating

4.2(33)
5
18%
4
52%
3
27%
2
3%
1
0%

Rate this Skill

0.0

Compatible Platforms

🔧Claude Code
🔧OpenClaw
🔧OpenCode
🔧Codex
🔧Gemini CLI
🔧GitHub Copilot
🔧Amp
🔧Kimi CLI

Timeline

Created2026年3月16日
Last Updated2026年5月23日