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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Alerts are listed on each respective component page as Diagnostics.

Project and workspace diagnostics overviews

Signed-in users can open the Diagnostics tab on project and workspace pages. The overview is loaded when opened and groups alerts of the same type instead of repeating them for every component.

The project overview shows project-wide findings once and lists the components affected by component-specific findings:

Project diagnostics overview with grouped findings and filters

The workspace overview groups project-wide findings by project and identifies components using both the project and component name:

Workspace diagnostics overview with grouped findings and filters

Each finding lists up to 20 affected projects or components. Additional affected objects are shown as a count. Follow a component link to see the complete diagnostic details or dismiss a diagnostic on the component page.

The summary can be filtered by active or dismissed state, severity, category, or whether the signed-in user can act on the diagnostic. Components shared into a project are listed only in the diagnostics of their owning project.

If it is missing, the component clears all current checks. Problem alerts cannot be ignored, but will disappear once the underlying problem has been fixed.

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

Dismissed diagnostics record who dismissed them, when they were dismissed, and an optional reason. A dismissal is automatically reopened when the diagnostic details or the configuration relevant to that diagnostic changes. Dismissal and reopening are both recorded in the component change history.

Warning and error notifications are sent only to subscribed project maintainers who have permission to act on the diagnostic. Informational recommendations do not send unsolicited notifications.

Custom alerts can override BaseAlert.get_dismissal_context(component, details) to include stable, JSON-serializable configuration or diagnostic inputs. Changing the returned context reopens a dismissed alert. Incidental values such as evaluation time should not be included.

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

../_images/alerts.webp

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

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

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