# babeldoc-pdf-translate

babeldoc-pdf-translate translates PDF files while preserving the original visual layout using a local BabelDOC engine, custom glossaries, and bilingual output.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: reliable-ly0411
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/reliable-ly0411/babeldoc-pdf-translate
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 40 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/babeldoc-pdf-translate

## What it does

The plugin coordinates layout-preserving document translation by sending parsed page elements to your selected translation model. It relies on a local BabelDOC pipeline to reconstruct the final document, keeping graphics, code snippets, and mathematical formulas in place.

You can generate either a monolingual target document or a bilingual comparison layout. The package includes CLI validation scripts, runtime check utilities, and job templates that let you pin exact glossary definitions via CSV.

Without a locally deployed BabelDOC runtime and a working Python setup, the plugin cannot compile documents: the archive supplies only agent workflows and integration scripts.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install babeldoc-pdf-translate@awesome-codex-plugins
```

## When to use it
- translate technical PDFs without breaking layout geometry or formulas
- generate side-by-side or alternating bilingual comparison documents
- enforce domain-specific terminology rules from a custom CSV glossary
- process a restricted page range instead of an entire multi-page paper

## Example prompts
- Translate pages 2 to 5 of `paper.pdf` into German with alternating bilingual layout.
- Draft a translation job for `manual.pdf` using terminology pairs from `terms.csv`.
- Run layout validation and translate the first two table pages of `spec.pdf`.

## Similar
- [translate-pdf](https://affpapa.org/en/nevibecode/skills/translate-pdf.md) — skill · 1200 installs
- [translate-book-parallel](https://affpapa.org/en/nevibecode/skills/translate-book-parallel.md) — skill · 1300 installs
- [pdf-to-html](https://affpapa.org/en/nevibecode/skills/pdf-to-html.md) — skill · 529 installs
- [translate-book](https://affpapa.org/en/nevibecode/skills/translate-book.md) — skill · 2100 installs
- [baoyu-translate](https://affpapa.org/en/nevibecode/skills/baoyu-translate.md) — skill · 26300 installs
- [blog-translate](https://affpapa.org/en/nevibecode/skills/blog-translate.md) — skill · 2500 installs

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
