translator/readme.md

📝 Описание программ

1. «Быстрый переводчик» (Modern Translator)

Современное настольное приложение для молниеносного перевода текста. Отлично подходит для ручной работы, тестирования переводов или общения. Построено на базе библиотеки CustomTkinter, благодаря чему имеет стильный дизайн, скругленные элементы и автоматически подстраивается под темную или светлую тему вашей операционной системы.

Главные функции:

• Интеллектуальное автоопределение языка: Программа сама понимает, на каком языке написан исходный текст.
• Обход лимитов Google: Если вставить огромный текст, программа незаметно для пользователя разобьет его на части (по 4800 символов), переведет каждую с безопасным таймаутом и склеит обратно. Никаких блокировок от Google!
• Управление с клавиатуры: Нажатие Enter мгновенно запускает перевод, а Shift + Enter делает перенос строки.
• Удобные инструменты: Кнопка «Скопировать» для быстрого переноса результата в буфер обмена, кнопка «Очистить» для мгновенного сброса окон и «Сохранить» для экспорта перевода в .txt файл.
• Асинхронность: Интерфейс не зависает во время ожидания ответа от серверов.

2. «Групповой локализатор кода» (PRO Translator)

Мощный инструмент для массового автоматического перевода проектов (исходного кода). Программа сама сканирует папки, находит файлы исходного кода (Python, QML, JS и др.) и переводит только читаемый текст, не ломая архитектуру программы.

Главные функции:

• Умный парсинг кода: Использует лексический анализ (tokenize для Python) и регулярные выражения, чтобы извлекать текст только из кавычек и комментариев, полностью игнорируя системный код (циклы, переменные, функции).
• Умный фильтр технических строк: Защищает от перевода системные ключи, пути к файлам (assets/logo.png) и переменные (camelCase, snake_case). Переводятся только осмысленные фразы или иероглифы.
• Восстановление плейсхолдеров: Автоматически чинит переменные форматирования (например, возвращает % s обратно в %s), которые часто портит Google Переводчик.
• Безопасность (Бэкапы): Автоматически создает резервные копии оригинальных файлов с расширением .bak перед любыми изменениями.
• Фильтр исходного языка: Позволяет указать, что переводить нужно только с китайского или японского, пропуская английский текст.
• Детальная статистика: Визуальный прогресс-бар и журнал логов (Log) в реальном времени показывают, какой файл сейчас обрабатывается и сколько всего переведено.

---

⚙️ Инструкция по компиляции в .exe

Для превращения .py скриптов в .exe мы будем использовать самую популярную библиотеку — PyInstaller.

Шаг 1: Подготовка

Откройте терминал (командную строку cmd или PowerShell) и установите PyInstaller:

pip install pyinstaller

Шаг 2: Компиляция «Группового переводчика» (PRO Translator)

Перейдите в папку, где лежит ваш скрипт (например, pro_translator.py). Выполните следующую команду:

pyinstaller --noconsole --onefile pro_translator.py

• --noconsole (или -w) — скрывает черное окно командной строки, чтобы открывался только красивый графический интерфейс.
• --onefile (или -F) — упаковывает все библиотеки, зависимости и сам Python в один единственный .exe файл (его будет удобно переносить).

Шаг 3: Компиляция «Быстрого переводчика» (Modern Translator)

Так как этот скрипт использует нестандартную библиотеку отрисовки интерфейса (customtkinter), PyInstaller'у нужно явно указать, чтобы он захватил её графические ассеты. Выполните команду:

pyinstaller --noconsole --onefile --collect-all customtkinter modern_translator.py

• --collect-all customtkinter — гарантирует, что шрифты и темы CustomTkinter будут корректно встроены в .exe.

Шаг 4: Где найти готовые программы?

После того как консоль закончит работу (это может занять 1–3 минуты), в вашей папке со скриптами появятся новые папки: build и dist.

1. Зайдите в папку dist.
2. Именно там лежат ваши готовые modern_translator.exe и pro_translator.exe.
3. Теперь эти файлы можно копировать, переносить на флешке и запускать на других компьютерах с Windows. Папки build и файлы .spec можно удалить, они нужны были только для сборки.

💡 Важное замечание про Антивирусы: Windows Defender или другие антивирусы иногда могут ругаться на .exe файлы, созданные через PyInstaller (выдавать предупреждение "Неизвестный издатель"). Это абсолютно нормальная реакция системы на программы без платной цифровой подписи разработчика. Просто нажмите "Подробнее" -> "Выполнить в любом случае" или добавьте файл в исключения.