Диагностика компонента перевода

Показывает ошибки в настройках Weblate или в проекте перевода для любого компонента перевода. Также надстройка предлагает кое-какие инструкции по решению некоторых найденных проблем.

В настоящее время выполняются проверки на следующие проблемы:

  • Дублирование исходных строк в файлах перевода

  • Дублирование языков в переводах

  • Сбои при объединении, обновлении или при отправке исходного репозитория

  • Синтаксические ошибки в файлах перевода

  • Тарифные лимиты (смотрите раздел Выставление счетов)

  • Репозиторий содержащий слишком много исходящих или отсутствующих коммитов

  • Отсутствующие лицензии

  • Ошибки при запуске надстройки (смотреть Дополнения)

  • Неверно настроенный одноязычный или двуязычный перевод.

  • Сломанные Настройки компонента

  • Битые ссылки

  • Неиспользуемые снимки экрана

  • Неоднозначный код языка

  • Неиспользованный новый базовый файл в настройках компонента

  • Дублирование маски файлов, используемой для связанных компонентов

  • Конфликтующая настройка репозитория запросов на слияние

  • Компонент выглядит неиспользуемым (настраивается с помощью UNUSED_ALERT_DAYS)

  • Неиспользуемые языки словаря

Оповещения обновляются ежедневно или при соответствующих изменениях (например, при изменении Настройки компонента или при обновлении репозитория).

Проверки доступности веб-сайта проекта можно отключить с помощью WEBSITE_ALERTS_ENABLED, и в этом случае Weblate больше не будет генерировать предупреждения для недоступных веб-сайтов проектов.

Предупреждения перечислены на соответствующей странице компонента как Диагностика.

Обзоры диагностики проекта и рабочего пространства

Вошедшие в систему пользователи могут открыть вкладку Диагностика на страницах проекта и рабочего пространства. Обзор загружается при открытии и группирует предупреждения одного типа вместо их повторения для каждого компонента.

Обзор проекта показывает общепроектные результаты один раз и перечисляет компоненты, затронутые специфическими для компонентов результатами:

Обзор диагностики проекта со сгруппированными результатами и фильтрами

Обзор рабочего пространства группирует общепроектные результаты по проектам и идентифицирует компоненты, используя как имя проекта, так и имя компонента:

Обзор диагностики рабочего пространства со сгруппированными результатами и фильтрами

Каждый результат перечисляет до 20 затронутых проектов или компонентов. Дополнительные затронутые объекты отображаются в виде количества. Перейдите по ссылке на компонент, чтобы увидеть полные сведения о диагностике, или отклоните диагностику на странице компонента.

Сводку можно отфильтровать по состоянию (активно или отклонено), серьёзности, категории или по тому, может ли вошедший в систему пользователь повлиять на диагностику. Компоненты, переданные в общий доступ в проекте, перечисляются только в диагностике их владельца проекта.

Если она отсутствует, компонент очищает все текущие проверки. Проблемные предупреждения нельзя игнорировать, но они исчезнут, как только основная проблема будет устранена.

Информационные предупреждения и предупреждения используются для руководства по улучшению локализации сообществом. Их можно скрыть, и они делают вкладку Диагностика видимой, но они не указывают на проблему компонента в списках.

Отклонённая диагностика записывает, кто её отклонил, когда она была отклонена и необязательную причину. Отклонение автоматически открывается заново, когда изменяются детали диагностики или конфигурация, относящаяся к этой диагностике. Отклонение и повторное открытие фиксируются в истории изменений компонента.

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

Пользовательские предупреждения могут переопределять BaseAlert.get_dismissal_context(component, details) для включения стабильной, сериализуемой в JSON конфигурации или диагностических входных данных. Изменение возвращаемого контекста повторно открывает отклонённое предупреждение. Случайные значения, такие как время оценки, не должны включаться.

Компонент с дубликатами исходных строк и языков выглядит вот так:

../_images/alerts.webp

Конфликтующая настройка репозитория

Это предупреждение отображается, когда несколько компонентов Git настроены на отправку в один и тот же репозиторий и ветку отправки без того, чтобы все они извлекали из этой ветки. Это включает рабочие процессы с запросами на извлечение или слияние, а также прямые отправки в отдельную ветку отправки. Такая настройка может перезаписать общую ветку.

Чтобы решить эту проблему, либо настройте другую Ветку для отправки для каждого компонента, либо используйте общий репозиторий между компонентами с помощью URL-адреса репозитория weblate://project/component.