doc-html-translate Документация (RU)

Быстрое чтение книг локально и бесплатный перевод в Chrome

Конвертируйте EPUB/PDF и другие форматы в локальные HTML-страницы, затем читайте в Chrome и переводите встроенным переводчиком браузера.

Рекомендуемый сценарий (бесплатно)

Самый удобный ежедневный путь:

  • Открыть файл приложением или запустить обычную команду
  • Открытие сгенерированного index в Chrome
  • Перевод страницы на нужный язык через встроенный перевод Chrome
doc-html-translate.exe "book.epub" # или # doc-html-translate.exe "book.pdf"

Плюсы: без API-ключа, без платных вызовов, максимально быстрый старт.

Быстрый старт

Сборка

go build -o build/doc-html-translate.exe ./cmd/doc-html-translate

Запуск

doc-html-translate.exe "book.epub" doc-html-translate.exe -notranslate "book.epub" # явный режим без перевода doc-html-translate.exe -src en -dst ru "book.epub" doc-html-translate.exe -google "book.epub" doc-html-translate.exe -ollama "book.epub"

Поддерживаемые форматы

EPUB, PDF, TXT, Markdown, FB2, RTF, HTML, MOBI, AZW3.

MOBI и AZW3: требуется установленный Calibre. Файлы с DRM не поддерживаются.

Дополнительные внешние инструменты

Приложение работает сразу для EPUB, TXT, FB2, RTF, HTML, Markdown. Установите эти инструменты для полной поддержки PDF-изображений и дополнительных форматов.

ИнструментНазначениеНужен дляКак установить
pdftotext
(Xpdf / Poppler)
Качественное извлечение текста из PDF — лучше справляется со сложными шрифтами, лигатурами, многоколоночным макетом PDF-файлы — необязательно, при отсутствии используется встроенный fallback xpdfreader.com → «Xpdf tools»
или уже входит в Git for Windows
ffmpeg Конвертирует JPEG 2000 изображения (.jpx) из PDF в JPEG — браузеры не поддерживают JPEG 2000 PDF-файлы с изображениями в формате JPEG2000 (распространено в коммерческих PDF) gyan.dev/ffmpeg → «release essentials»
или winget install ffmpeg
Calibre Конвертирует MOBI / AZW3 в EPUB перед обработкой Обязателен для поддержки форматов MOBI и AZW3 calibre-ebook.com

Без pdftotext: используется встроенный Go-ридер PDF (чуть ниже качество). Без ffmpeg: изображения JPEG2000 в PDF не будут видны в браузере. Без Calibre: файлы MOBI/AZW3 не открываются.

Основные флаги

ФлагПо умолчаниюОписание
-notranslatefalseТолько конвертация, без перевода
-noopenfalseНе открывать браузер автоматически
-googlefalseПеревод через Google Cloud Translation API
-ollamafalseЛокальный перевод Ollama
-split5000Разбивка страниц по символам, 0 отключает
-folderemptyПапка для результата
-srcenЯзык источника
-dstruЯзык перевода
-forcefalseПересобрать даже при готовом output

Скачивание приложения