mirror of
https://github.com/WeblateOrg/weblate.git
synced 2026-07-30 10:22:52 +08:00
74004cfb4b
Warn when a gettext PO component is configured as monolingual but imports empty source text from regular PO/POT files. Use existing MD5 indexes for the diagnostic query so the daily alert remains cheap. Fixes #20210
65 lines
2.4 KiB
ReStructuredText
Vendored
65 lines
2.4 KiB
ReStructuredText
Vendored
.. _alerts:
|
|
|
|
Translation component diagnostics
|
|
=================================
|
|
|
|
Shows errors in the Weblate configuration or the translation project for any given translation component.
|
|
Guidance on how to address found issues is also offered.
|
|
|
|
Currently the following is covered:
|
|
|
|
* Duplicated source strings in translation files
|
|
* Duplicated languages within translations
|
|
* Merge, update, or push failures in the repository
|
|
* Parse errors in the translation files
|
|
* Billing limits (see :ref:`billing`)
|
|
* Repository containing too many outgoing or missing commits
|
|
* Missing licenses
|
|
* Errors when running add-on (see :doc:`/admin/addons`)
|
|
* Misconfigured monolingual or bilingual translation.
|
|
* Broken :ref:`component`
|
|
* Broken URLs
|
|
* Unused screenshots
|
|
* Ambiguous language code
|
|
* Unused new base in component settings
|
|
* Duplicate file mask used for linked components
|
|
* Conflicting merge request repository setup
|
|
* Component seems unused (configurable by :setting:`UNUSED_ALERT_DAYS`)
|
|
* Unused glossary languages
|
|
|
|
The alerts are updated daily, or on related change (for example when
|
|
:ref:`component` is changed or when repository is updated).
|
|
|
|
Project website availability checks can be disabled using
|
|
:setting:`WEBSITE_ALERTS_ENABLED`, in which case Weblate will no longer
|
|
generate alerts for unreachable project websites.
|
|
|
|
Alerts are listed on each respective component page as
|
|
:guilabel:`Diagnostics`.
|
|
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.
|
|
|
|
Information and warning alerts are used for guidance on improving community
|
|
localization. These can be dismissed and make the
|
|
:guilabel:`Diagnostics` tab visible, but they do not indicate a
|
|
component problem in listings.
|
|
|
|
A component with both duplicated strings and languages looks like this:
|
|
|
|
.. image:: /screenshots/alerts.webp
|
|
|
|
Conflicting repository setup
|
|
----------------------------
|
|
|
|
This alert is shown when multiple Git components are configured to push to the
|
|
same repository and push branch without all of them pulling from that branch.
|
|
This includes pull or merge request workflows, and direct pushes to a separate
|
|
push branch. Such a setup can overwrite the shared branch.
|
|
|
|
To resolve this, either configure a different :guilabel:`Push branch` for each
|
|
component or share the repository between components using a
|
|
``weblate://project/component`` repository URL.
|
|
|
|
.. seealso::
|
|
|
|
:ref:`production-certs`
|
