# translate-pdf

Переводит текст в PDF на другой язык, сохраняя структуру, цвета и фоны. Пригодится, когда нужно отдать документ на другом языке, а не пересобирать его заново.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 установок · ★ 24
- Автор: wshuyi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshuyi/translate-pdf-skill/tree/HEAD/skills/translate-pdf/SKILL.md
- Обновлён: 2026-01-01
- HTML: https://affpapa.org/nevibecode/skills/translate-pdf

## Что делает

Скилл работает в три шага. Сначала `scripts/extract_texts.py` вытаскивает из PDF все уникальные строки, потом вы переводите их и складываете в `translations.json` рядом с исходником, а `scripts/translate_pdf.py` подставляет перевод обратно в документ. Цвета, фоны и позиции блоков остаются на месте.

Шрифт задаётся флагом `--font`: `helv` для латиницы, `china-ss` и `china-ts` для упрощённого и традиционного китайского, `japan` для японского, `korea` для корейского. Если целевой язык — китайский, японский или корейский, шрифт нужно указать обязательно, иначе символы просто не отрисуются. Для CJK-шрифтов размер автоматически уменьшается до 90%, чтобы текст влезал в исходные блоки.

Готовый файл получает суффикс языка: `filename_EN.pdf`, `filename_ZH.pdf`, `filename_JA.pdf`. Имена собственные, аббревиатуры и технические термины скилл не трогает — их можно оставить как есть при составлении словаря. Нужен Python и заполненный `translations.json`: без него второй скрипт запускать нечем.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/translate-pdf/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/translate-pdf/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/translate-pdf/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/translate-pdf/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wshuyi/translate-pdf-skill translate-pdf
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/translate-pdf/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/wshuyi/translate-pdf-skill --path skills/translate-pdf
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/translate-pdf/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add wshuyi/translate-pdf-skill --skill translate-pdf -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshuyi/translate-pdf-skill/tree/HEAD/skills/translate-pdf/SKILL.md

## Когда брать
- перевести инструкцию или договор на английский, не ломая вёрстку
- сделать китайскую версию презентации из готового PDF
- подготовить японский перевод документа с сохранением цветов и фонов
- собрать словарь строк из PDF и подставить перевод обратно
- получить копию файла с суффиксом языка рядом с исходником

## Примеры запросов агенту
- переведи этот PDF на английский, вёрстку сохрани
- сделай китайскую версию `report.pdf` шрифтом china-ss
- извлеки тексты из `manual.pdf` и подготовь файл переводов

## Похожие
- [translate-book](https://affpapa.org/nevibecode/skills/translate-book.md) — скилл · 1800 установок
- [pdf](https://affpapa.org/nevibecode/skills/nexu-io-pdf.md) — скилл · 3000 установок
- [pdf-to-html](https://affpapa.org/nevibecode/skills/pdf-to-html.md) — скилл · 458 установок
- [pdf-generator](https://affpapa.org/nevibecode/skills/pdf-generator.md) — скилл · 916 установок
- [k2f-fillable-pdf](https://affpapa.org/nevibecode/skills/k2f-fillable-pdf.md) — скилл · 623 установки
- [pdf-to-docx](https://affpapa.org/nevibecode/skills/pdf-to-docx.md) — скилл · 6000 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md