epub-translate

Extract translatable text from EPUBs and rebuild translated EPUBs via JSON workflow.

Updated Jan 17, 2026

Search Tags:#translation #epub #ai-assisted #batch-translation #code-preservation #ncx

Ready to run

npx skills add https://github.com/lDuang/mcp-skill-registry --skill epub-translate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: epub-translate
Source: https://github.com/lDuang/mcp-skill-registry/tree/main/skill/epub-translator-toolkit
Command: npx skills add https://github.com/lDuang/mcp-skill-registry --skill epub-translate

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

AI-assisted EPUB translation toolkit automates extraction of translatable text from EPUB files while preserving code blocks, enabling clean translation without altering code and preserving navigation references.

Core Features & Use Cases

Export: extract text from EPUB leaf blocks (<p>, <h1>..., <li>) into a structured JSON with code placeholders.
Translate: support progressive batch translation via a JSON workflow with progress tracking and safe code placeholder handling.
Build: inject translations back into the EPUB while preserving inline elements, NCX navigation, and encoding normalization for a valid EPUB.
Use Case: translating software documentation or technical ebooks that include embedded code blocks and cross-references.

Quick Start

Run the export phase to generate translations.json, batch translate using the provided scripts, and then run the build phase to produce the translated EPUB.

Frequently Asked Questions about epub-translate

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

FAQPage Schema

How do I translate an EPUB book while preserving embedded code blocks?▼

AI-assisted EPUB translation automates text extraction from leaf blocks like paragraphs and headers into a structured JSON file. It uses code placeholders to protect formatting, ensuring your technical EPUB translation separates prose from structural elements safely.

What is the best way to batch translate technical EPUB files?▼

AI-assisted EPUB translation supports progressive batch translation via a JSON workflow with progress tracking. This allows you to process large technical documentation in chunks, resuming safely while maintaining safe code placeholder handling throughout the batch translation lifecycle.

Does AI EPUB translation maintain NCX navigation and inline elements?▼

Yes, EPUB translation maintains NCX navigation and inline elements. The build phase injects translations back into the EPUB while preserving these structural components, handling NCX files and encoding normalization to ensure a valid final EPUB output.

Can I use scripts to automate EPUB text extraction for translation?▼

Yes, scripts automate EPUB text extraction. The export phase extracts text from leaf blocks into a structured JSON file with code placeholders, providing the exact input needed to automate your AI-assisted translation workflow.

Do I need beautifulsoup4 to process EPUB translation workflows?▼

Yes, beautifulsoup4 is required to process EPUB translation workflows. This dependency parses EPUB HTML structure, extracts translatable text from leaf blocks, and injects translated content back during the build phase.