Translate Book

# Translate Book

Use this when someone wants an entire book or long document translated, not a paragraph.

## 1. Collect parameters
Ask for the file path if it is missing. Also take the target language, how many sub-agents to run at once (default 8), and any custom instructions such as tone or names to keep.

## 2. Convert to chunks
Convert the file to Markdown and split it into numbered chunks in a temp folder. For academic PDFs with math, tables, or columns, extract with a layout-aware parser first if one is installed, then chunk the Markdown.

## 3. Build a glossary
Sample the first chunk, the last chunk, and three from the middle. List proper nouns and recurring domain terms (people, places, organizations, concepts) with one chosen translation each, and save the glossary. If a glossary already exists, keep it: the user may have edited it by hand.

## 4. Translate in parallel
Give every chunk its own sub-agent with a fresh context. Each one receives its chunk, the target language, the glossary terms that appear in that chunk, short read-only excerpts of the neighboring chunks, and the custom instructions. It writes only the translation to a matching output file. Run in batches of the chosen size and wait for each batch to finish.

After each batch, merge any new terms the sub-agents reported back into the glossary so later chunks stay consistent.

## 5. Verify
Check that every source chunk has a non-empty output. Retry missing chunks once each. Report any that still fail.

## 6. Rebuild
Translate the book title, merge the chunks in order, and build the formats the user wants: HTML, DOCX, EPUB, or PDF.

## 7. Report
List the output files, the chunk count, any retries, and anything that needs a human look.

Adapted from @deusyu's approach: https://github.com/deusyu/translate-book