Diagnostika prekladových komponentov

Zobrazuje chyby v konfigurácii Weblate alebo prekladovom projekte pre akúkoľvek danú prekladovú súčasť. Ponúka sa aj návod, ako riešiť nájdené problémy.

V súčasnosti sú pokryté nasledujúce:

  • Duplicitné zdrojové reťazce v prekladových súboroch

  • Duplicitné jazyky v prekladoch

  • Zlyhania zlúčenia, aktualizácie alebo odoslania (push) v repozitári

  • Chyby parsovania v prekladových súboroch

  • Limity fakturácie (pozri Fakturácia)

  • Repozitár obsahujúci príliš veľa odchádzajúcich alebo chýbajúcich zápisov

  • Chýbajúce licencie

  • Chyby pri spúšťaní doplnku (pozri Doplnky)

  • Nesprávne nakonfigurovaný jednojazyčný alebo dvojjazyčný preklad.

  • Pokazená Konfigurácia komponentu

  • Pokazené URL

  • Nepoužité snímky obrazovky

  • Nejasný kód jazyka

  • Nepoužitý nový základ v nastaveniach súčasti

  • Duplicitná maska súboru použitá pre prepojené súčasti

  • Konfliktné nastavenie repozitára pre žiadosť o zlúčenie

  • Súčasť sa zdá byť nepoužitá (konfigurovateľné pomocou UNUSED_ALERT_DAYS)

  • Nepoužité jazyky slovníka

Upozornenia sa aktualizujú denne alebo pri súvisiacej zmene (napríklad keď sa zmení Konfigurácia komponentu alebo keď sa aktualizuje repozitár).

Kontroly dostupnosti webovej stránky projektu môžu byť vypnuté pomocou WEBSITE_ALERTS_ENABLED, v takom prípade Weblate už nebude generovať upozornenia pre nedostupné webové stránky projektov.

Upozornenia sú uvedené na stránke každej príslušnej súčasti ako Diagnostika.

Prehľady diagnostiky projektu a pracovného priestoru

Prihlásení používatelia môžu otvoriť kartu Diagnostika na stránkach projektu a pracovného priestoru. Prehľad sa načíta pri otvorení a zoskupuje upozornenia rovnakého typu namiesto ich opakovania pre každú súčasť.

Prehľad projektu zobrazuje celoprojektové zistenia raz a uvádza súčasti ovplyvnené zisteniami špecifickými pre súčasti:

Prehľad diagnostiky projektu so zoskupenými zisteniami a filtrami

Prehľad pracovného priestoru zoskupuje celoprojektové zistenia podľa projektu a identifikuje súčasti pomocou názvu projektu aj súčasti:

Prehľad diagnostiky pracovného priestoru so zoskupenými zisteniami a filtrami

Každé zistenie uvádza až 20 ovplyvnených projektov alebo súčastí. Ďalšie ovplyvnené objekty sa zobrazujú ako počet. Kliknutím na odkaz súčasti zobrazíte úplné podrobnosti diagnostiky alebo zamietnete diagnostiku na stránke súčasti.

Súhrn možno filtrovať podľa aktívneho alebo zamietnutého stavu, závažnosti, kategórie alebo toho, či prihlásený používateľ môže konať na základe diagnostiky. Súčasti zdieľané do projektu sú uvedené iba v diagnostike ich vlastníckeho projektu.

Ak chýba, súčasť vymaže všetky aktuálne kontroly. Upozornenia na problémy nemožno ignorovať, ale zmiznú po oprave základného problému.

Informačné a varovné upozornenia sa používajú na usmernenie pri zlepšovaní komunitnej lokalizácie. Tieto možno zamietnuť a spraviť kartu Diagnostika viditeľnou, ale neoznačujú problém súčasti v zoznamoch.

Zamietnuté diagnostiky zaznamenávajú, kto ich zamietol, kedy boli zamietnuté a voliteľný dôvod. Zamietnutie sa automaticky znovu otvorí, keď sa zmenia podrobnosti diagnostiky alebo konfigurácia relevantná pre danú diagnostiku. Zamietnutie aj znovu otvorenie sa zaznamenávajú do histórie zmien súčasti.

Varovné a chybové oznámenia sa posielajú iba prihláseným správcom projektu, ktorí majú oprávnenie konať na základe diagnostiky. Informačné odporúčania neposielajú nevyžiadané oznámenia.

Vlastné upozornenia môžu prepísať BaseAlert.get_dismissal_context(component, details) tak, aby zahrnuli stabilné, JSON-serializovateľné konfiguračné alebo diagnostické vstupy. Zmena vráteného kontextu znovu otvorí zamietnuté upozornenie. Náhodné hodnoty, ako je čas vyhodnotenia, by nemali byť zahrnuté.

Súčasť s duplicitnými reťazcami aj jazykmi vyzerá takto:

../_images/alerts.webp

Konfliktné nastavenie repozitára

Toto upozornenie sa zobrazí, keď je viacero Git komponentov nakonfigurovaných na odosielanie do toho istého repozitára a vetvy odosielania bez toho, aby všetky z nich sťahovali z tejto vetvy. Zahŕňa to pracovné postupy pull alebo merge request a priame odosielania do samostatnej vetvy odosielania. Takéto nastavenie môže prepísať zdieľanú vetvu.

Na vyriešenie tohto buď nakonfigurujte inú Vetvu na odoslanie pre každú súčasť alebo zdieľajte repozitár medzi súčasťami pomocou URL repozitára weblate://project/component.