dinlo
60 lines
7.5 KiB
Markdown
60 lines
7.5 KiB
Markdown
### 📝 Описание программ
|
||
|
||
#### 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:
|
||
```bash
|
||
pip install pyinstaller
|
||
```
|
||
|
||
#### Шаг 2: Компиляция «Группового переводчика» (PRO Translator)
|
||
Перейдите в папку, где лежит ваш скрипт (например, `pro_translator.py`). Выполните следующую команду:
|
||
|
||
```bash
|
||
pyinstaller --noconsole --onefile pro_translator.py
|
||
```
|
||
* **`--noconsole`** (или `-w`) — скрывает черное окно командной строки, чтобы открывался только красивый графический интерфейс.
|
||
* **`--onefile`** (или `-F`) — упаковывает все библиотеки, зависимости и сам Python в один единственный `.exe` файл (его будет удобно переносить).
|
||
|
||
#### Шаг 3: Компиляция «Быстрого переводчика» (Modern Translator)
|
||
Так как этот скрипт использует нестандартную библиотеку отрисовки интерфейса (`customtkinter`), PyInstaller'у нужно явно указать, чтобы он захватил её графические ассеты. Выполните команду:
|
||
|
||
```bash
|
||
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` (выдавать предупреждение "Неизвестный издатель"). Это абсолютно нормальная реакция системы на программы без платной цифровой подписи разработчика. Просто нажмите "Подробнее" -> "Выполнить в любом случае" или добавьте файл в исключения. |