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)
Nedostupné služby hodnotenia AI a odporúčania na konfiguráciu Hodnotenie kvality AI, keď je dostupná služba LLM
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
Zakázaná správa reťazcov v lokálnych glosároch alebo glosároch obsahujúcich terminológiu
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.
Diagnostika chýb doplnku odkazuje na stránku Konfigurácia zodpovedajúcej inštalácie pre používateľov, ktorí ju môžu spravovať, vrátane doplnkov zdedených z kategórie, projektu alebo konfigurácie stránky. Pri hodnotení kvality AI nedostupná služba vytvorí diagnostiku chyby; zlyhania požiadaviek poskytovateľa zostávajú v protokole aktivít doplnku.
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 pracovného priestoru zoskupuje celoprojektové zistenia podľa projektu a identifikuje súčasti pomocou názvu projektu aj súčasti:
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, komponent vymaže všetky aktuálne kontroly. Upozornenia zmiznú, keď sa základná podmienka vyrieši.
Informačné a varovné upozornenia sa používajú ako usmernenie na zlepšenie lokalizácie komunity. Spravujú kartu Diagnostika viditeľnou, ale neindikujú problém komponentu v zoznamoch.
Zamietnutie je dostupné pre vybrané diagnostiky, bez ohľadu na závažnosť. Udržiavatelia môžu zamietnuť varovania o nepoužívaných komponentoch a jazykoch slovníka, keď sú tieto zámerne zachované. Podozrenie na nesprávnu konfiguráciu formátu súborov pre monolingválne alebo bilingválne súbory je možné zamietnuť aj vtedy, keď je konfigurácia správna. Prevádzkové zlyhania a požadovaná konfigurácia sa musia stále vyriešiť.
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.
Zamietnutia nepoužívaných komponentov pretrvávajú počas denných kontrol a znovu sa otvoria, ak sa zmení UNUSED_ALERT_DAYS. Toto nastavenie nastavte na 0, aby ste vypli kontrolu v celej inštancii. Ak aktivita vyrieši diagnostiku, neskoršie obdobie nečinnosti môže vygenerovať novú diagnostiku. Zamietnutia nepoužívaných jazykov slovníka sa znovu otvoria, keď sa zmenia postihnuté jazyky. Zamietnutia diagnostiky formátu súborov sa znovu otvoria, keď sa zmení relevantný formát, parametre formátu, základný súbor alebo zdrojový jazyk.
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:
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.