do.translate-pdf

Translate PDF documents into a target language while preserving layout, styling, colors, and positions.

6|3|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/dull-bird/DeepOrbit --skill do-translate-pdf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: do.translate-pdf
Source: https://github.com/dull-bird/DeepOrbit/tree/main/skills/do.translate-pdf
Command: npx skills add https://github.com/dull-bird/DeepOrbit --skill do-translate-pdf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf, and includes scripts (resource) components.

What problem does it solve?

Translate PDF documents into another language without breaking their original structure, layout, colors, and styling so that translated files remain visually identical to the source.

Core Features & Use Cases

  • Accurate text extraction: Extract all unique text spans from a PDF for review and translation mapping.
  • Layout-preserving replacement: Remove original text with transparent redaction and insert translated text at the same positions with configurable fonts and color preservation.
  • CJK support and font selection: Built-in adjustments and font options for Simplified/Traditional Chinese, Japanese, and Korean to maintain readability and fit.
  • Use Case: Localize research papers, brochures, or reports where visual fidelity matters, such as conference proceedings or marketing PDFs.

Quick Start

Translate the file input.pdf to Simplified Chinese while preserving layout, styling, and fonts and save the result as input_ZH.pdf.

Frequently Asked Questions about do.translate-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate a PDF while preserving the original layout and styling?

To translate a PDF while preserving layout, this Skill extracts text spans, applies transparent redaction to remove original text, and inserts translated text at the same positions using a translations JSON mapping. It maintains original styling, colors, and visual fidelity for documents like research papers and brochures.

Does pymupdf support CJK font selection for PDF document translation?

Yes, pymupdf supports CJK font selection for PDF document translation. This Skill includes built-in adjustments and font options for Simplified Chinese, Traditional Chinese, Japanese, and Korean to ensure translated text maintains readability and fits the original layout positions.

What is the best way to extract unique text spans from a PDF for translation mapping?

The best way to extract unique text spans from a PDF for translation mapping is using this Skill's text extraction feature. It identifies all unique text spans within the document, allowing you to review them and generate a translations JSON mapping for layout-preserving replacement.

Can I localize research papers and technical reports without breaking their visual structure?

Yes, you can localize research papers and technical reports without breaking their visual structure. This Skill performs layout-preserving replacement by inserting translated text at original positions with configurable fonts and color preservation, ensuring the translated file remains visually identical to the source.

Do I need a translations JSON file to process multilingual PDF workflows?

Yes, you need a user-provided translations JSON mapping to process multilingual PDF workflows. This mapping pairs extracted source text spans with their target language equivalents, enabling the Skill to replace original text while preserving positions, styling, and colors.