AutoIT Help RUS

Русский перевод официальной справки AutoIT v3.3.18.0.

Что сделано

• Переведены все 3919 страниц справки: описания функций, параметры, возвращаемые значения, примечания.
• Переведены оглавление, индекс, примеры кода и комментарии в них, история изменений.
• Фича - кнопка переключения РУС/ENG на каждой странице, меняет перевод на оригинал в один клик.
• Примеры кода и сигнатуры функций сохранили подсветку синтаксиса, как в оригинале.
• Единый стиль и терминология по всему корпусу. Глоссарий взят из старой русской справки, спасибо AZJIO.

Как сделано

Переводить такой объём вручную не реально. Поэтому собран конвейер, который делает рутину, нейросеть отвечает за текст, а человек за контроль качества.

Этапы простыми словами:

1. Разбор. Каждую английскую страницу режем на смысловые блоки и складываем в JSON-файлы. Так текст отделён от вёрстки.

2. Словарь повторов. Около 40% текста справки это одни и те же фразы и термины. Их переводим один раз в общий словарь, и они автоматически подставляются на все страницы.

3. Перевод. Остальные блоки переводит нейросеть по строгим правилам стиля:

   • Единый глоссарий терминов (handle - дескриптор, array - массив и т.д.).
   • Деловой тон на «вы», без канцелярита («происходит» вместо «осуществляется») плюс мягкость оригинала (may - может, usually - обычно).
   • Возвращаемые значения начинаются с глагола (привычное наследие русской справки).

   Текст для перевода собирается из нескольких источников:

   • Старая русская справка AZJIO - эталон терминологии и формулировок заголовков.
   • Кодовая база - тело функции и её родной комментарий, это главный источник смысла для пользовательских функций (UDF).
   • MSDN - поиск в интернете для функций-обёрток над WinAPI.
   • Нейросеть - переводит, учитывая весь контекст.
   • Ручные правки - хранятся отдельными патчами, чтобы повторная генерация их не затёрла.

4. Сборка. Скрипт берёт английскую страницу, заменяет блоки на русские, заново раскрашивает синтаксис в примерах, чинит ссылки и оформление. На выходе - готовая русская страница.

5. Патчи вёрстки. Унификация смысловых и визуальных расхождений оригинальной справки. Например общий шаблон для таблиц, подсветка кода в теле описания.

6. Проверка. Отдельные скрипты ловят пропуски, смесь русского и английского, расхождения версий. Для прямого сравнения сделана Split-View утилита.

История

Мне стало любопытно, за какое время получится организовать систему и перевести справку из нескольких тысяч страниц.

• Основная база и логика была продумана и сделана за 3 дня.
• Ещё пара дней доводка системы и поиск проблем.
• 2 недели исправлений и больше 1000 обновлённых страниц между версиями 1.01 и 1.02.
• В остальном шлифовкой можно заниматься бесконечно.

В оригинальной справке, особенно у пользовательских функций, оформление не всегда следует шаблону. Авторы UDF не всегда внятно объясняют, что их функция делает, поэтому очень строгий перевод отпал сам собой.

Русский вариант сделан более системно, по оформлению и по шаблону описания. Киллер фича, которая снимает с меня всю ответственность - это кнопка, которая позволяет быстро увидеть оригинал страницы. В любом случае перевод в основном очень достойный, современные нейросети топчик.

Огромная благодарность автору перевода старой русской справки AZJIO, его работа взята за основу.

В этой репе не будет скриптов и инструментов для сборки. Если комьюнити будет активно, что мало вероятно в 2026 году, то по возможности будут выкладываться обновления.

Поддержка

Правки и предложения приветствуются. Отсыпать благодарности можно сюда CloudTips.

Ссылки

• Русское сообщество AutoIT
• Домашняя страница AutoIT