РУССКАЯ ЛОКАЛИЗАЦИЯ ZYGOR GUIDES VIEWER FOREVER
Дата: 6 ноября 2026 г.

Перевод уже подключён в установленной папке аддона.
В русском клиенте (ruRU) выполните /reload или перезапустите игру.
Для других языков сохраняется исходный текст.

Что переведено
- Основной интерфейс, настройки, сообщения и подсказки.
- Видимые названия 443 руководств и разделов; внутренние пути сохранены.
- Все 6 759 обнаруженных строк инструкций и описаний руководств.
- Дополнительные подписи меню, аукциона, подбора снаряжения и талантов.
- Поиск руководств поддерживает русский текст без учёта регистра;
  английские названия также остаются доступными для поиска.

Основной интерфейс и частые инструкции переведены вручную. Для остального
использован автоматический перевод Argos en_ru 1.9 с сохранением чисел,
координат, выражений и разметки. Частые инструкции уточнены отдельными
шаблонами; названия рецептов и термины вынесены в словари.
Автоматические фразы могут звучать неестественно; отдельные нестандартные
имена могут отличаться от имён в клиенте. Это не сплошная ручная редактура.
Имена заданий и NPC по ID продолжают поступать из исходных словарей аддона
и клиента. Тексты игровых заданий отдельно не переписывались.

Проверки
- Полное покрытие обнаруженных строк и заголовков.
- Сохранность и порядок чисел, координат, команд, выражений и разметки.
- Параметры форматирования основного интерфейса.
- Синтаксис 47 файлов в Lua 5.1.5.
- Загрузка ruRU/enUS, резервный английский текст и обработка цветов.
- Работа реальных функций поиска руководств на русском и английском.
- В самом клиенте WoW проверка ещё не выполнялась.

Где находятся файлы
Localization/UI_ruRU.lua           — интерфейс и настройки
Localization/Guides_ruRU.lua       — подсказки и описания руководств
Localization/GuideTitles_ruRU.lua  — видимые названия
Localization/DisplayText.lua      — вывод названий и русский регистр

Исходные версии изменённых файлов сохранены в .localization-backup
в корне аддона. Подпапки соответствуют исходным путям, кроме двух файлов:
  .localization-backup/Localization.xml -> Localization/Localization.xml
  .localization-backup/Core_ruRU.lua   -> Localization/Core_ruRU.lua
Сохранения персонажа и настройки в WTF не изменялись.
Обновление аддона может перезаписать локализацию: сохраняйте эту папку.

Редактирование и повторная сборка
Выполнять из корня аддона:
  python3 tools/localization/build_reviewed_templates.py
  python3 tools/localization/build_ru.py
  python3 tools/localization/build_guides_ru.py
  python3 tools/localization/build_titles_ru.py

Ручные переводы в *.ruRU.tsv имеют приоритет над machine.ruRU.json.
recipes.ruRU.tsv содержит названия создаваемых предметов.
postedit_terms.ruRU.tsv уточняет оставшиеся английские термины в подсказках.
Для обычной сборки сеть и модель перевода не нужны.

После обновления исходных руководств:
  python3 tools/localization/inventory_guides.py
  python3 tools/localization/prepare_mt.py
Затем перевести новые ключи и пересобрать словари.
ui_extra_inventory.json фиксирует дополнительные строки меню и настроек;
его следует сверять при обновлении соответствующих исходных файлов.

Проверка требует именно Lua 5.1: исходный аддон использует синтаксис,
который современные версии Lua могут отвергать.
  LUA=/путь/к/lua5.1 LUAC=/путь/к/luac5.1 python3 tools/localization/validate_ru.py
  LUAC=/путь/к/luac5.1 python3 tools/localization/validate_guides.py
  /путь/к/lua5.1 tools/localization/test_load.lua

Необязательное повторение машинного перевода:
translate_remaining.py требует Python с ctranslate2 и sentencepiece,
а также распакованную модель translate-en_ru-1_9.argosmodel.
Модель и эти пакеты не нужны для работы самого аддона.
Источник модели: https://argos-net.com/v1/translate-en_ru-1_9.argosmodel
