Doplnky¶

Doplnky poskytujú spôsoby prispôsobenia a automatizácie pracovného postupu prekladu. Administrátori môžu pridávať a spravovať doplnky z ponuky Operácie ↓ Doplnky každého príslušného prekladového projektu alebo komponentu. Doplnky je možné inštalovať aj v rámci celej stránky v Rozhranie na správu.

Rada

Doplnky môžete konfigurovať aj pomocou API, DEFAULT_ADDONS alebo install_addon.

Doplnky, ktoré sú nastavené na manuálne spúšťanie, je možné spustiť zo správy doplnkov alebo pomocou API. Výsledky sa zaznamenávajú do denníka aktivít doplnku.

Doplnky, ktoré vystavujú API komponentu, zobrazujú jeho základnú URL na karte API doplnku spolu s odkazom na koreň API.

Doplnky sú trvalá administratívna konfigurácia. Bežia so svojou identitou služby v rozsahu, kde sú nainštalované, namiesto opakovaného používania oprávnení administrátora, ktorý ich nakonfiguroval. To zabezpečuje, že rovnako oprávnení administrátori vidia a ukladajú rovnakú konfiguráciu a že uloženie nesúvisiacej zmeny ticho nemení vstupný rozsah doplnku. Odstránenie alebo zakázanie konfigurujúceho administrátora doplnok nevypne.

Doplnky projektu a kategórie teda zahŕňajú kompatibilné obmedzené komponenty v tomto rozsahu. Doplnok komponentu môže používať vstupy mimo svojho cieľového komponentu, keď to tento doplnok dokumentuje. Automatický preklad určuje svoje zdrojové komponenty nasledovne:

Priame akcie automatického prekladu používajú prístup používateľa ku komponentu.
Uložený doplnok automatického prekladu používa svoj trvalý administratívny rozsah. Kompatibilné komponenty v cieľovom projekte sú spôsobilé, vrátane obmedzených komponentov.
Komponenty v inom projekte sú spôsobilé, keď tento projekt prispieva do zdieľanej prekladovej pamäte. To zahŕňa obmedzené komponenty, aj keď nevytvárajú záznamy zdieľanej prekladovej pamäte; doplnok namiesto toho číta explicitne vybraný komponent ako administratívny vstup.

Obmedzené komponenty zostávajú filtrované z bežných zoznamov a priameho prístupu. Udeľte oprávnenia na správu doplnkov iba používateľom, ktorým dôverujete s úplným vstupným a účinkovým rozsahom doplnku. Pozri Rozsah tímov a Obmedzený prístup.

Udalosti, ktoré spúšťajú doplnky¶

Inštalácia doplnku¶

Spustené pri inštalácii doplnku.

Aktualizácia komponentu¶

Spustené vždy, keď dôjde k zmene v komponente, ako napríklad:

Reťazce sa zmenia v repozitári.
Reťazec sa pridá.
Nový preklad sa pridá.

Denne¶

Spustené denne, ale doplnky zvyčajne rozdeľujú dennú záťaž medzi komponenty v závislosti od BACKGROUND_TASKS.

Zmena udalosti¶

Spustené po vytvorení udalosti Zmena.

Manuálne spustenie¶

Spustené, keď sa doplnok spustí manuálne zo správy doplnkov alebo API.

Repozitár po pridaní¶

Spustené hneď po pridaní a zapísaní nového prekladu.

Repozitár po zápise¶

Spustené hneď po zapísaní zmien.

Repozitár po pushi¶

Spustené hneď po pushnutí repozitára upstream.

Repozitár po odstránení¶

Spustené hneď po odstránení prekladu.

Repozitár po aktualizácii¶

Spustené vždy, keď sa nové zmeny stiahnu z hlavného repozitára.

Repozitár pred zápisom¶

Spustené tesne pred zapísaním zmien.

Repozitár pred pushom¶

Spustené tesne pred pushnutím repozitára upstream.

Repozitár pred aktualizáciou¶

Spustené tesne pred pokusom o aktualizáciu repozitára.

Jednotka po uložení¶

Spustené hneď po uložení reťazca.

Jednotka po synchronizácii¶

Spustené po synchronizácii reťazca s VCS.

Jednotka pred vytvorením¶

Spustené hneď po uložení novo vytvoreného reťazca.

Vstavané doplnky¶

Hodnotenie kvality AI¶

ID doplnku:

weblate.ai.quality

Konfigurácia:

service

Služba hodnotenia

Dostupné voľby:¶
`anthropic`	Anthropic
`openai`	OpenAI
`mistral`	Mistral
`ollama`	Ollama
`azure-openai`	Azure OpenAI

q

Dotaz

interval

Frekvencia hodnotenia

Dostupné voľby:¶
`disabled`	Vypnuté
`daily`	Denne
`weekly`	Týždenne
`monthly`	Mesačne

on_change

Hodnotiť zmeny v prekladoch

on_update

Hodnotiť aktualizácie repozitára

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu, Denne, Zmena udalosti, Manuálne spustenie

Hodnotí existujúce preklady pomocou veľkého jazykového modelu (LLM) a zaznamenáva kontroly kvality.

Tento doplnok vyhodnocuje existujúce preklady pomocou služby LLM nakonfigurovanej v časti Automatické návrhy. Negeneruje návrhy ani nemení preklady. Vyberte Službu hodnotenia z nakonfigurovaných služieb LLM; poverenia a prepísania projektu sa znova použijú.

Dotaz vyberá reťazce pomocou bežnej syntaxe vyhľadávania. Predvolene sú vybrané preložené reťazce. Zdrojové reťazce, reťazce iba na čítanie a položky slovníka sú vylúčené. Každá požiadavka obsahuje všetky tvary množného čísla prekladu, zdrojový text, informácie o jazyku, kontext reťazca, termíny slovníka, zástupné symboly a nakonfigurované pokyny na preklad. Tieto údaje sa odosielajú vybranému poskytovateľovi.

Požiadavky zoskupujú reťazce z rovnakého prekladu v poradí súborov pomocou veľkosti dávky automatického prekladu služby (v súčasnosti 20 reťazcov pre vstavané služby LLM). Všetky tvary množného čísla reťazca zostávajú spolu. Súvisiace reťazce zdieľajú kontext, čo umožňuje hodnotiteľovi skontrolovať význam a terminológiu v rámci dávky. Dávkovanie znižuje počet požiadaviek poskytovateľa pre naplánované, manuálne a zmenou spustené behy; nevynecháva nezmenené reťazce.

Frekvencia hodnotenia je predvolene týždenne. K dispozícii sú aj denné a mesačné plány; vypnutie vypne naplánované hodnotenie. Spracovanie na pozadí musí byť povolené. Úspešné úplné spustenie začína ďalší interval. Manuálne spustenia obchádzajú interval. Povoľte Vyhodnotiť zmeny prekladu alebo Vyhodnotiť aktualizácie repozitára na dodatočné vyhodnotenie po týchto udalostiach. Inštalácia okamžite nekontaktuje poskytovateľa. Každý beh môže spôsobiť náklady u poskytovateľa, vrátane opätovného vyhodnotenia nezmenených prekladov.

Vyhodnocovanie beží v úlohách na pozadí, pričom výsledky a počty zlyhaní sa zaznamenávajú do existujúceho protokolu aktivít doplnku. Zlyhané požiadavky si zachovávajú existujúce platné zistenia a skúšajú sa znova až pri následnom behu. Vyhodnocovanie zdieľa čas ochladenia automatického prekladu služby: odpovede s obmedzením rýchlosti ho aktivujú a dávky sa preskakujú, kým je aktívny. Špecifickejšie inštalácie majú prednosť: komponent, najbližšia kategória, projekt a potom celá stránka.

Zistenia sa zobrazujú ako štandardné kontroly presnosti, plynulosti, terminológie, štýlu a formátovania. Každé zistenie obsahuje menšiu, väčšiu alebo kritickú závažnosť a vysvetlenie. Viaceré zistenia v jednej kategórii zdieľajú kontrolu, takže ignorovanie tejto kontroly ignoruje celú kategóriu pre reťazec. Existujúce filtre vyhľadávania a vyhľadávanie API fungujú, napríklad check:ai_accuracy. Príznaky prekladu, ako napríklad ignore-ai-accuracy, deaktivujú kategóriu; ignore-all-checks deaktivuje všetky kontroly.

Zmena zdroja alebo prekladu odstráni zastarané zistenia. Výsledky prijaté po zmene akéhokoľvek zdroja alebo prekladu v ich dávke sa zahodia pre celú dávku. Zlyhaná alebo nesprávne formátovaná odpoveď tiež ponechá existujúce zistenia pre celú dávku nezmenené; ostatné dávky sa môžu stále dokončiť. Neúplné behy neposúvajú naplánovaný dátum hodnotenia. Opätovné vyhodnotenie nezmeneného obsahu zachováva ignorované kategórie a úspešné vyhodnotenie odstráni kategórie, ktoré už nemajú zistenia. Odstránenie alebo rekonfigurácia doplnku vymaže jeho zistenia. Metadáta hodnotiteľa sú interné a nemožno ich upravovať prostredníctvom API; konfigurácia doplnku používa existujúce oprávnenia a validáciu Doplnky.

Automatizácia¶

Added in version 2026.10.

ID doplnku:

weblate.automation.automation

Konfigurácia:

workflow

Pracovný postup

Zadajte definíciu automatizácie ako YAML alebo JSON.

Spúšťače:

Aktualizácia komponentu, Denne, Zmena udalosti, Manuálne spustenie, Repozitár po zápise, Repozitár po pushi, Repozitár po aktualizácii

Spúšťa usporiadané prekladové operácie s podmienkami a vetvením.

Nainštalujte tento doplnok na komponent, kategóriu, projekt alebo stránku. Zdedené inštancie bežia samostatne pre každý komponent. Môže byť nainštalovaných viacero inštancií. Konfigurácia, náhľad a spustenie automatizácie vyžaduje bežné oprávnenie na správu doplnkov. Uloženie jeho konfigurácie ju nespustí.

Zadajte YAML alebo JSON do Pracovný postup. Použite Náhľad bez zmien na jeho overenie a kontrolu plánovaných akcií, potom Spustiť teraz pre skutočné vykonanie. Výsledky sa zobrazia v protokole aktivít doplnku.

Viď aj

Definícia pracovného postupu pre definíciu skriptu a referenciu.
Kuchárska kniha pre úplné príklady.
Aplikujte prekladovú pamäť pred strojovým prekladom pre prekladovú pamäť pred strojovým prekladom.

Automatický preklad¶

ID doplnku:

weblate.autotranslate.autotranslate

Konfigurácia:

mode

Režim automatického prekladu

Dostupné voľby:¶
`suggest`	Pridať ako návrh
`translate`	Pridať ako preklad
`fuzzy`	Pridať ako „Vyžaduje úpravu“
`approved`	Pridať ako schválený preklad

q

Dotaz

Prosím, majte na pamäti, že prekladom všetkých reťazcov sa zahodia všetky existujúce preklady.

auto_source

Zdroj automatických prekladov

Dostupné voľby:¶
`others`	Iné prekladové komponenty
`mt`	Strojový preklad

component

Komponent

Zadajte ID zdrojového komponentu. Pri 30 alebo viac oprávnených zdrojových komponentoch sa akceptuje aj cesta projektu/komponentu. V takom prípade operácie komponentu a projektu tiež akceptujú slug komponentu z cieľového projektu. Nechajte prázdne na použitie oprávnených komponentov z projektu každého cieľového komponentu.

engines

Nástroje strojového prekladu

threshold

Prah skóre

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu, Denne, Zmena udalosti

Automaticky prekladá reťazce pomocou strojového prekladu alebo iných komponentov.

Na ovládanie poradia prekladu použite doplnok Automatizácia so samostatnou akciou pre každý prechod. Postupujte podľa príkladu z kuchárskej knihy Aplikujte prekladovú pamäť pred strojovým prekladom, aby ste najprv použili miestnu prekladovú pamäť a do služby strojového prekladu poslali iba zostávajúce reťazce. Výber viacerých engineov tu používa Priorita služieb strojového prekladu a prekladovej pamäte; poradie inštalácie samostatných doplnkov nedefinuje postupnosť vykonávania.

Viď aj

CDN pre lokalizáciu JavaScriptu¶

Added in version 4.2.

ID doplnku:

weblate.cdn.cdnjs

Konfigurácia:

`threshold`	Prah prekladu	Percento preložených reťazcov, ktoré musia byť prítomné, aby bol preklad zahrnutý.
`css_selector`	CSS selektor	CSS selektor na detekciu lokalizovateľných prvkov.
`cookie_name`	Názov cookie jazyka	Názov cookie, ktorý ukladá preferenciu jazyka.
`files`	Extrahovať reťazce z HTML súborov	Zoznam názvov súborov v aktuálnom repozitári alebo vzdialených URL na spracovanie pre prekladateľné reťazce.

Spúšťače:

Inštalácia doplnku, Denne, Repozitár po zápise, Repozitár po odstránení, Repozitár po aktualizácii

Zverejňuje preklady do siete na doručovanie obsahu na použitie v lokalizácii JavaScriptu alebo HTML.

Dá sa použiť na lokalizáciu statických HTML stránok alebo na načítanie lokalizácie v kóde JavaScriptu.

Generuje unikátnu URL pre váš komponent, ktorú môžete zahrnúť do HTML stránok na ich lokalizáciu. Viac podrobností nájdete v Prekladanie HTML a JavaScriptu pomocou Weblate CDN.

Poznámka

Tento doplnok vyžaduje dodatočnú konfiguráciu na serveri Weblate. LOCALIZE_CDN_PATH konfiguruje, kam sa budú generované súbory zapisovať (na súborovom systéme), a LOCALIZE_CDN_URL definuje, odkiaľ sa budú servírovať (URL). Servírovanie súborov nerobí Weblate a musí sa nastaviť externe (zvyčajne pomocou služby CDN).

Tento doplnok je nakonfigurovaný na Hosted Weblate a servíruje súbory cez https://weblate-cdn.com/.

Viď aj

Prekladové súbory CDN¶

Added in version 2026.5.

ID doplnku:: weblate.cdn.files
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Aktualizácia komponentu, Repozitár po zápise, Repozitár po odstránení, Repozitár po aktualizácii

Zverejňuje prekladové súbory do siete na doručovanie obsahu.

Zverejňuje prekladové súbory bez ich konverzie do iného formátu. Súbory sa zapisujú do adresára špecifického pre doplnok CDN a servírujú sa z LOCALIZE_CDN_URL/<UUID doplnku>/. Jednosúborové preklady používajú kód jazyka a pôvodnú príponu súboru, napríklad cs.json alebo de.po. Viacsúborové preklady sa servírujú pod kódom jazyka pomocou ciest relatívnych k adresáru prekladu. Jednojazyčné komponenty zahŕňajú súbor zdrojového jazyka, zatiaľ čo dvojjazyčné komponenty zverejňujú iba súbory cieľového jazyka. Pozrite si CDN pre lokalizáciu pre usmernenia k bezpečnému servírovaniu.

Kotlin SDK CDN¶

Added in version 2026.10.

ID doplnku:

weblate.cdn.kotlin

Konfigurácia:

`maximum_age`	Maximálny vek zostavy (dni)	Ukončuje zostavy po uplynutí tohto počtu dní od ich prvej registrácie. Opätovná registrácia zostavy nepredlžuje jej vek.
`maximum_versions`	Maximálny počet zachovaných verzií	Obmedzuje počet uchovávaných zostav naprieč všetkými názvami balíčkov. Zostava je ukončená, keď sa dosiahne buď tento limit, alebo maximálny vek.

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu, Denne, Repozitár po zápise, Repozitár po odstránení, Repozitár po aktualizácii

Publikuje Android reťazcové a množné zdroje pre registrované Kotlin SDK zostavy.

Varovanie

The Kotlin SDK is available as an alpha release. No compatibility is guaranteed until the final Kotlin SDK is released. Endpoints, build metadata, CDN manifests, and generated resource formats may change without backward compatibility.

Nainštalujte Kotlin SDK CDN na komponent zdrojov reťazcov Android, aby ste publikovali preklady pre zostavy registrované Kotlin SDK. Najprv nakonfigurujte LOCALIZE_CDN_URL a LOCALIZE_CDN_PATH. Výstup CDN je verejný, vrátane prekladov zo súkromných komponentov. Manifesty vystavujú názov balíčka aplikácie a kód verzie. Súbory ARSC vystavujú názvy publikovaných zdrojov a ich odoslané ID spolu s preloženým textom. Nepovažujte nahrané mapovanie zdrojov za dôverné; povoľte publikáciu iba vtedy, keď je toto odhalenie zamýšľané. Prístup k API registrácie a stavu zostáva kontrolovaný oprávneniami.

Skopírujte konfiguráciu doplnku Gradle zo stránky konfigurácie doplnku. Obsahuje URL servera Weblate, verejnú URL CDN, slug projektu a cestu komponentu (s akoukoľvek cestou kategórie zakódovanou v URL). Nahraďte zástupný symbol tokenom API s rozsahom projektu, ktorého oprávnenia umožňujú úpravu komponentu. Správcovia projektu ho môžu vytvoriť na karte Prístup k API projektu; pozrite Prístupové tokeny pre jednotlivé projekty. Uchovávajte tento token v prostredí zostavenia, nie v aplikácii. Karta API doplnku zobrazuje základnú URL API; odošlite metadáta zostavenia na jeho koncový bod builds/. Formát požiadavky a odpovede nájdete v Zostavy Kotlin SDK.

For Gradle plugin and library setup, see Kotlin SDK for Android.

Doplnok priraďuje názvy a typy zdrojov z registrovaných zostáv k aktuálnym prekladom komponentu. Podporujú sa reťazce, množné čísla a štýlovaný text Android. Pole reťazcov a odkazy na zdroje sa negenerujú. Nepreložené položky, položky iba na čítanie a neúplné zdroje množných čísel sa vynechávajú; aplikácie si zachovávajú svoje pribalené hodnoty. Nepodporované štýlovanie spôsobí zlyhanie publikácie; predchádzajúca úspešná publikácia zostáva dostupná.

ID zdrojov musia opisovať finálnu nainštalovanú zostavu. Opätovné nahranie identického mapovania je neškodné; odlišné mapovanie pre rovnaký balíček a verziu sa zamietne. Staré zostavy dostávajú aktuálne preklady podľa názvu, vrátane po zmene zdrojového textu alebo argumentov formátovania. Správcovia zodpovedajú za kompatibilitu so starším kódom aplikácie.

Nastavenia životného cyklu¶

Maximálny vek zostavy (dni) je predvolene 365 a akceptuje 1 až 730, merané od prvej registrácie. Opakované nahrávania ho nepredlžujú.
Maximálny počet zachovaných verzií je predvolene 20 a akceptuje 1 až 100, počítané naprieč všetkými názvami balíčkov. Povolená je jedna dodatočná nepublikovaná náhrada. Nové registrácie môžu vyradiť staršie nepublikované náhrady. Publikované zostavy sa vyradia pre tento limit iba po publikovaní náhrady. Neúspešné náhrady si ponechávajú existujúce publikácie; uplynutie maximálneho veku stále platí nezávisle.

Ktorýkoľvek limit vyradí zostavu a okamžite vymaže jej metadáta. Ľahké vyradené záznamy sa odstránia pri čistení po 24 hodinách a úspešnom odstránení manifestu; ich identifikátory balíčka/verzie sa potom môžu registrovať znova. Neúspešné alebo prerušené odstránenia manifestu sa opakujú každú hodinu. Kým odstránenie neprebehne, registrácia a jej referencované artefakty sa ponechávajú a súbory môžu zostať verejne dostupné. Mapovania zdrojov sú nemenné iba kým zostávajú ich registračné záznamy.

Každý doplnok povoľuje maximálne 1000 registračných záznamov vrátane vyradených záznamov. Nové registrácie presahujúce tento limit vracajú HTTP 409, kým čistenie neuvolní kapacitu; identické opakovania zostávajú akceptované. Metadáta sú obmedzené limitom nahrávania 5 MiB a maximálnym počtom zachovaných verzií plus jedna náhrada bez samostatnej kvóty bajtov. Limity sa vynucujú počas registrácie a plánovaného čistenia.

Prekonané artefakty sa odstránia pri čistení po pevnom 24-hodinovom okne. Všetky súbory artefaktov vrátane prekonaných súborov a neúplného výstupu publikácie sa počítajú do tvrdých limitov 5 GiB a 10000 súborov na doplnok. Väčší prídavok artefaktov accommodating preložený text a viacero lokalít; nezaručuje kapacitu pre každú kombináciu lokály alebo zostavy. Zdieľané artefakty sa počítajú iba raz. Publikácie presahujúce ktorýkoľvek limit zlyhajú pred zápisom nových artefaktov a ponechávajú predchádzajúci manifest. Ani okno, ani tieto limity nie sú konfigurovateľné. Obmedzte cacheovanie manifestu ako je popísané nižšie.

Kompilácia spracováva jednu lokalitu naraz na disku. Konzervatívny odhad kódovaného textu a štýlovania na lokalitu presahujúci 64 MiB spôsobí zlyhanie publikácie.

Príprava additionally vyžaduje až 5 GiB dočasného diskového priestoru na publikačnú úlohu, oddelene od prídavku publikovaných artefaktov. Dočasné súbory obsahujú stageovaný výstup ARSC, zdieľaný verziami s identickými mapovaniami zdrojov. Ukladajú sa pod LOCALIZE_CDN_PATH. Nakonfigurujte server tak, aby odmietal prístup k .kotlin-sdk-staging ako je popísané v CDN pre lokalizáciu pred povolením tohto doplnku.

Nahradenie manifestu nasleduje commit databázy. Neúspešné alebo prerušené zápisy sa opakujú následnými publikačnými úlohami, pričom artefakty pre starý aj čakajúci manifest sú chránené kým nahradenie neprebehne.

Odinštalovanie doplnku sa okamžite pokúsi odstrániť jeho publikované súbory z zdroja CDN. Neúspešné alebo prerušené odstránenia sa opakujú každú hodinu; súbory môžu zostať verejne dostupné kým čistenie neprebehne. Odstránenie nezruší kópie už cacheované alebo stiahnuté klientmi.

Publikácia a čistenie bežia asynchrónne po registrácii zostavy, aktualizáciách komponentu, zápisoch a odstráneniach prekladov a počas denného spracovania doplnku. Zlyhania sa objavia v logu aktivity doplnku a stave registrácie. Predchádzajúce úspešné publikácie zostávajú dostupné, keď generovanie náhrady zlyhá. Ak komponent prestane používať formát zdrojov Android, hodinová údržba vyradí jeho publikácie. Normálne okno retencie artefaktov stále platí.

Kontrakt klienta CDN¶

Každé zostavenie má stabilný manifest na adrese <CDN base>/<packageName>/<versionCode>/manifest.json. Manifest verzie 1 obsahuje schemaVersion, packageName, versionCode a locales. Kľúče lokalizácie sú jazykové kódy Weblate. Každá lokalizácia obsahuje relatívnu url, sha256 a veľkosť v bajtoch size pre svoj artefakt ARSC. Vyriešte relatívne URL voči URL manifestu. Obsah artefaktov sa po zverejnení nemení. Manifest má schému JSON.

Nakonfigurujte zdroj CDN tak, aby cacheoval manifesty maximálne jednu hodinu (napríklad Cache-Control: public, max-age=3600) a súbory artefaktov s Cache-Control: public, max-age=31536000, immutable. Súbory artefaktov môžu používať application/octet-stream. Nakonfigurujte tieto hlavičky na serveri CDN. Aktualizácie prekladov a vyradenia môžu trvať až jednu hodinu, kým dosiahnu klientov. Použite Cache-Control: no-cache, keď je preferovaná okamžitá revalidácia. Pevné 24-hodinové okno retencie artefaktov presahuje životnosť cacheovania manifestu.

Kotlin SDK by malo validovať dĺžku a hash artefaktu, cacheovať úspešné sťahovania lokálne a načítať ich pomocou API resources-loader Androidu na API 30 alebo novšom. Chýbajúci manifest, chýbajúca lokalita alebo zlyhanie sťahovania musí ponechať pribalené zdroje. Vyradené manifesty vracajú 404 na zdroji; cacheované kópie môžu zostať použiteľné kým neuplynú. Hashe detegujú poškodený alebo nezhodujúci sa obsah; autentifikácia sa spolieha na HTTPS a nakonfigurovanú CDN.

Odstrániť prázdne reťazce¶

Added in version 4.4.

ID doplnku:: weblate.cleanup.blank
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Repozitár po zápise, Repozitár po aktualizácii

Odstraňuje reťazce bez prekladu zo súborov prekladov.

Použite toto, aby ste nemali žiadne prázdne reťazce v prekladových súboroch (napríklad ak vaša lokalizačná knižnica ich zobrazuje ako chýbajúce namiesto návratu na zdrojový reťazec).

Viď aj

Aktualizuje Weblate prekladové súbory aj mimo samotných prekladov?

Vyčistiť súbory prekladov¶

ID doplnku:: weblate.cleanup.generic
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Repozitár po aktualizácii, Repozitár pred zápisom

Aktualizovať všetky súbory prekladov tak, aby zodpovedali jednojazyčnému základnému súboru. Pre väčšinu formátov súborov to znamená odstránenie zastaraných kľúčov prekladu, ktoré už nie sú v základnom súbore.

Pre formáty obsahujúce dodatočný obsah okrem prekladových reťazcov (ako Súbory HTML, Súbory Windows RC alebo Formát OpenDocument) to tiež synchronizuje prekladový súbor so základným súborom.

Na jednorazové vyčistenie jedného prekladového súboru použite Vyčistiť nepoužité v Údržba repozitára na danom preklade namiesto inštalácie doplnku.

Viď aj

Aktualizuje Weblate prekladové súbory aj mimo samotných prekladov?

Pridať chýbajúce jazyky¶

ID doplnku:: weblate.consistency.languages
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Denne, Repozitár po pridaní

Zaisťuje, že konzistentná sada jazykov sa používa pre všetky komponenty v projekte.

Poznámka

Komponenty zdieľané z iných projektov sa v tomto nezohľadňujú.

Chýbajúce jazyky sa kontrolujú raz každých 24 hodín a keď sa vo Weblate pridajú nové jazyky.

Na rozdiel od väčšiny ostatných, tento doplnok ovplyvňuje celý projekt.

Rada

Automaticky preložiť novo pridané reťazce pomocou Automatický preklad.

Objavovanie komponentov¶

ID doplnku:

weblate.discovery.discovery

Konfigurácia:

`match`	Regulárny výraz na porovnanie súborov prekladov	Regulárny výraz musí definovať pomenovanú skupinu pre komponent. Pri párovaní prekladových súborov tiež definujte pomenovanú skupinu pre jazyk. Keď je nastavená maska súboru, vynechajte jazyk a namiesto toho spárujte jednojazyčný základný alebo nový základný súbor.
`file_format`	Formát súboru	Formát súboru
`name_template`	Prispôsobiť názov komponentu	Použiť syntax šablóny Django. Táto šablóna musí obsahovať {{ component }}.
`base_file_template`	Definovať názov jednojazyčného základného súboru	Nechať prázdne pre dvojjazyčné súbory prekladov. Keď je nastavené, táto šablóna musí obsahovať {{ component }}.
`new_base_template`	Definovať základný súbor pre nové preklady	Názov súboru používaný na vytváranie nových prekladov. Pre gettext vyberte .pot súbor. Táto šablóna musí obsahovať {{ component }}.
`intermediate_template`	Medzijazykový súbor	Názov súboru priebežného prekladu. Vo väčšine prípadov ide o prekladový súbor poskytnutý vývojármi a používa sa pri vytváraní skutočných zdrojových reťazcov. Táto šablóna musí obsahovať {{ component }}.
`filemask_template`	Definovať masku súboru	Nechajte prázdne na priame párovanie prekladových súborov. Ak je nastavené, objavovanie páruje jednojazyčný základný alebo nový základný súbor a používa túto šablónu ako masku súboru. Zahrňte zástupný znak jazyka a {{ component }}, napríklad locale//{{ component }}.po alebo docs/{{ component }}_.md.
`language_regex`	Jazykový filter	Regulárny výraz na filtrovanie súborov prekladov pri skenovaní masky súboru.
`copy_addons`	Klonovať doplnky z hlavného komponentu do novo vytvorených
`remove`	Odstrániť komponenty pre neexistujúce súbory

Spúšťače:

Inštalácia doplnku, Repozitár po aktualizácii

Automaticky pridáva alebo odstraňuje komponenty projektu na základe zmien súborov vo verziovom systéme.

Zhoda sa určuje pomocou regulárnych výrazov, čo umožňuje komplexnú konfiguráciu, vyžaduje si to však určité znalosti. Regulárny výraz na vyhľadanie prekladových súborov zvyčajne musí obsahovať dve pomenované skupiny na identifikáciu komponentu a jazyka. Pri vytváraní komponentov z monolingválneho základu alebo nového základného súboru vynechajte skupinu pre jazyk a namiesto toho nájdite zhodu pre tento zdrojový súbor. Všetky pomenované skupiny v regulárnom výraze sa dajú použiť ako premenné v poliach šablóny.

Požiadavky na objavovanie¶

Aby sa komponent úspešne objavil, konfigurácia musí urobiť všetko nasledujúce:

Regulárny výraz musí definovať pomenovanú skupinu component. Na vyhľadanie zhodných prekladových súborov sa vyžaduje aj pomenovaná skupina language.
Polia šablóny používané na pomenovanie alebo lokalizáciu súborov pre komponent musia obsahovať {{ component }}, aby sa vykreslená hodnota skutočne menila pre každý objavený komponent.
Pri monolingválnych formátoch musí komponent obsahovať súbor zodpovedajúci maske base_file_template a aspoň jeden prekladový súbor zodpovedajúci maske match, pokiaľ nenastavíte masku súborov (pozri nižšie).

Objavovanie komponentov bez prekladových súborov¶

Nastavte Definovať masku súboru na objavovanie komponentov iba z jednojazyčného základného alebo nového základného súboru, aj keď ešte neexistujú žiadne prekladové súbory. V tomto režime:

Nakonfigurujte Regulárny výraz na párovanie súborov prekladov tak, aby spároval jednojazyčný základný alebo nový základný súbor a vynechajte skupinu language. Zachovajte plnú kontrolu nad záchytom component, napríklad locale/(?P<component>[^/]+)\.pot alebo docs/(?P<component>[^/_]+)\.md.
Vyplňte Definovať masku súboru cestou, ktorá zahŕňa zástupný znak jazyka aj {{ component }}, napríklad locale/*/{{ component }}.po alebo docs/{{ component }}_*.md.
Pokračujte v používaní ostatných šablón názvov súborov s ľubovoľnými pomenovanými skupinami z výrazu zhody.

Pracovný príklad: `news_<lang>.md`¶

Toto je bežné rozloženie variantov jazyka založené na názve súboru:

docs/news_en.md
docs/news_cs.md
docs/guide_en.md

Použite predvoľbu Varianty jazyka založené na názve súboru ako východiskový bod, potom vyberte zodpovedajúci formát súboru a skontrolujte vyplnené hodnoty.

Regulárny výraz:

(?:(?P<path>.*/))?(?P<component>.+?)_(?P<language>[A-Za-z]{2,3}(?:[_-][A-Za-z0-9]+)*)\.(?P<extension>[^/.]+)

Názov komponentu:

{{ component }}

Objavené masky súborov:

docs/news_*.md
docs/guide_*.md

V tomto príklade sa {{ component }} rozlíši na základný názov pred jazykovou príponou, takže docs/news_en.md, docs/news_pt_BR.md a docs/news_pt-BR.md sa všetky stanú komponentom news.

Môžete použiť markup šablóny Django vo všetkých poliach názvov súborov, napríklad:

{{ component }}: Názov komponentu analyzovaný zo skupiny zhody component
{{ component|title }}: Názov súboru komponentu s veľkým začiatočným písmenom
{{ path }}: {{ component }}: Vlastná skupina zhody z regulárneho výrazu

Akonáhle kliknete na Uložiť, zobrazí sa náhľad zodpovedajúcich komponentov, kde môžete skontrolovať, či konfigurácia skutočne zodpovedá vašim potrebám:

Príklady objavovania komponentov¶

Vyššie uvedený pracovný príklad pokrýva najbežnejšie rozloženie variantov založené na názve súboru. Nasledujúce príklady ukazujú iné štruktúry repozitára, ktoré môžete zhodovať.

Jeden priečinok na jazyk¶

Jeden priečinok na jazyk obsahujúci prekladové súbory pre komponenty.

Regulárny výraz:

(?P<language>[^/.]*)/(?P<component>[^/]*)\.po

Zodpovedajúce súbory:

cs/application.po
cs/website.po
de/application.po
de/website.po

Rozloženie gettext locales¶

Bežná štruktúra na ukladanie gettext PO súborov.

Regulárny výraz:

locale/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

Zodpovedajúce súbory:

locale/cs/LC_MESSAGES/application.po
locale/cs/LC_MESSAGES/website.po
locale/de/LC_MESSAGES/application.po
locale/de/LC_MESSAGES/website.po

Zložité názvy súborov¶

S použitím tak názvu súčasti, ako aj jazyka v názve súboru.

Regulárny výraz:

src/locale/(?P<component>[^/]*)\.(?P<language>[^/.]*)\.po

Zodpovedajúce súbory:

src/locale/application.cs.po
src/locale/website.cs.po
src/locale/application.de.po
src/locale/website.de.po

Opakovaný kód jazyka¶

Použitie jazyka v ceste aj v názve súboru.

Regulárny výraz:

locale/(?P<language>[^/.]*)/(?P<component>[^/]*)/(?P=language)\.po

Zodpovedajúce súbory:

locale/cs/application/cs.po
locale/cs/website/cs.po
locale/de/application/de.po
locale/de/website/de.po

Rozdeliť Android reťazce¶

Android resource reťazce, rozdelené do niekoľkých súborov.

Regulárny výraz:

res/values-(?P<language>[^/.]*)/strings-(?P<component>[^/]*)\.xml

Zodpovedajúce súbory:

res/values-cs/strings-about.xml
res/values-cs/strings-help.xml
res/values-de/strings-about.xml
res/values-de/strings-help.xml

Zodpovedanie viacerých ciest¶

Viacmodulový Maven projekt s prekladmi Java properties.

Regulárny výraz:

(?P<originalHierarchy>.+/)(?P<component>[^/]*)/src/main/resources/ApplicationResources_(?P<language>[^/.]*)\.properties

Názov komponentu:

{{ originalHierarchy }}: {{ component }}

Zodpovedajúce súbory:

parent/module1/submodule/src/main/resources/ApplicationResources_fr.properties
parent/module1/submodule/src/main/resources/ApplicationResource_es.properties
parent/module2/src/main/resources/ApplicationResource_de.properties
parent/module2/src/main/resources/ApplicationResource_ro.properties

Rada

Doplnok na objavovanie komponentov používa Interné URL Weblate. Je to pohodlný spôsob zdieľania nastavenia VCS medzi viacerými komponentmi. Prepojené komponenty používajú lokálny repozitár hlavného komponentu nastavený vyplnením weblate://project/main-component do poľa Repozitár zdrojového kódu (v Operácie ↓ Nastavenia ↓ Systém správy verzií) každého príslušného komponentu. To šetrí čas s konfiguráciou aj systémové zdroje.

Rada

Uistite sa, že nový komponent obsahuje úplnú sadu jazykov na preklad pomocou Pridať chýbajúce jazyky.

Viď aj

Fedora Messaging¶

Added in version 5.15.

ID doplnku:

weblate.fedora_messaging.publish

Konfigurácia:

`amqp_url`	URL AMQP brokera	URL AMQP brokera, ku ktorému sa má systém pripojiť.
`topic_prefix`	Prefix témy	Voliteľný prefix, ktorý sa pridá na začiatok generovaných tém správ.
`publish_timeout`	Časový limit publikovania	Koľko sekúnd čakať na potvrdenie doručenia brokerom.
`connection_attempts`	Pokusy o pripojenie	Koľkokrát sa má skúsiť pripojiť k brokerovi.
`retry_delay`	Oneskorenie opakovania	Koľko sekúnd čakať medzi pokusmi o pripojenie.
`ca_cert`	Balík certifikátov CA (PEM)	Vložte iba bloky certifikátov PEM, každý začínajúci „—–BEGIN CERTIFICATE—–“ a končiaci „—–END CERTIFICATE—–“.
`client_key`	Súkromný kľúč klienta (PEM)	Vložte jeden blok nešifrovaného súkromného kľúča PEM. Šifrované súkromné kľúče nie sú podporované.
`client_cert`	Klientsky certifikát (PEM)	Vložte iba blok certifikátu PEM začínajúci „—–BEGIN CERTIFICATE—–“; nevkladajte výstup z „openssl x509 -text“.
`event_filter`	Udalosti zmien na spustenie	Vyberte, ktoré udalosti zmeny majú spustiť tento doplnok. Udalosti zmien na spustenie
`events`	Vybrané udalosti zmien	Vybrané udalosti zmien

Spúšťače:

Zmena udalosti

Odosielanie notifikácií do výmeny AMQP kompatibilnej s Fedora Messaging.

Fedora Messaging je publisher založený na AMQP pre všetky zmeny prebiehajúce vo Weblate. Pomocou toho môžete na zmeny vo Weblate napojiť ďalšie služby.

Téma správy¶

Všetky správy majú tému weblate.<akcia>.<projekt>.<kategória...>.<komponent>.<preklad>. Ak je nakonfigurovaný, topic_prefix sa pridá pred túto tému pomocou jednej bodky ako oddeľovača, napríklad org.fedoraproject.weblate.project_backed_up.website. Akcia je textová reprezentácia akcie malými písmenami s podčiarkovníkmi namiesto medzier, napríklad resource_updated; pozrite si Vybrané udalosti zmien pre všetky identifikátory akcií. Zvyšné časti zodpovedajú segmentom cesty objektu Weblate.

Napríklad udalosť zálohovania projektu pre projekt website používa weblate.project_backed_up.website. Zmena prekladu v projekte website, komponente frontend a českom preklade používa weblate.translation_changed.website.frontend.cs. Rovnaká zmena v komponente frontend vnútri kategórií parent a child používa weblate.translation_changed.website.parent.child.frontend.cs.

Telo správy¶

Telo pozostáva z nasledujúcich polí (za predpokladu, že sú dostupné pre udalosť):

change_id: Číselné ID zmeny
action: Podrobný názov zmeny.
timestamp: Časová pečiatka vo formáte ISO
target: Nová hodnota zmeny (napr. nový preklad reťazca)
old: Stará hodnota zmeny (napr. predchádzajúci preklad reťazca)
source: Zdrojový reťazec.
url: Absolútna URL adresa na zobrazenie súvisiaceho objektu.
author: Používateľské meno autora (môže sa líšiť od používateľa, napríklad pri prijímaní návrhov)
user: Používateľské meno vykonávajúceho
project: Slug projektu
component: Slug komponentu
translation: Kód jazyka prekladu

Hlavičky správy¶

Existujú ďalšie hlavičky, ktoré môžete využiť aj na smerovanie:

action: Podrobný názov zmeny.
project: Slug projektu
component: Slug komponentu

Príklady správ¶

Udalosť zlúčenia repozitára:

{
  "id": 1,
  "action": "Merged repository",
  "timestamp": "2017-06-15T11:30:47.325000+00:00",
  "url": "http://example.com/projects/test/test/",
  "component": "test"
}

Udalosť nového zdrojového reťazca:

{
  "id": 2,
  "action": "New source string",
  "timestamp": "2017-06-15T11:30:47.372000+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Udalosť aktualizácie zdroja:

{
  "id": 6,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.410000+00:00",
  "url": "http://example.com/projects/test/test/cs/",
  "project": "test",
  "component": "test",
  "translation": "cs"
}
{
  "id": 7,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.510000+00:00",
  "url": "http://example.com/projects/test/test/de/",
  "project": "test",
  "component": "test",
  "translation": "de"
}
{
  "id": 8,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.595000+00:00",
  "url": "http://example.com/projects/test/test/it/",
  "project": "test",
  "component": "test",
  "translation": "it"
}

Udalosť odstránenia projektu:

{
  "id": 9,
  "action": "Removed project",
  "timestamp": "2019-10-17T15:57:08.559420+00:00",
  "target": "test",
  "user": "testuser"
}

Udalosť nového prispievateľa:

{
  "id": 11,
  "action": "New contributor",
  "timestamp": "2019-10-17T15:57:08.759960+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Udalosť nového prekladu:

{
  "id": 12,
  "action": "New translation",
  "timestamp": "2019-10-17T15:57:08.772591+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "target": ["Ahoj svete!\n"],
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Viď aj

Hromadná úprava¶

ID doplnku:

weblate.flags.bulk

Konfigurácia:

q

Dotaz

state

Stav na nastavenie

Dostupné voľby:¶
`-1`	Nemeniť
`10`	Potrebuje úpravu
`11`	Vyžaduje úpravu (Vyžaduje prepísanie)
`12`	Vyžaduje úpravu (Vyžaduje kontrolu)
`20`	Preložené
`30`	Schválené

add_flags

Príznaky zdroja na pridanie — všetky jazyky

remove_flags

Príznaky zdroja na odstránenie — všetky jazyky

add_translation_flags

Príznaky prekladu na pridanie — zodpovedajúce preklady

Vzťahuje sa iba na zodpovedajúce preklady, okrem zdrojových reťazcov.

remove_translation_flags

Príznaky prekladu na odstránenie — zodpovedajúce preklady

Odstraňuje lokálne nastavené príznaky. Zdedené príznaky zostávajú v platnosti.

add_labels

Štítky na pridanie — všetky jazyky

remove_labels

Štítky na odstránenie — všetky jazyky

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu

Hromadná úprava príznakov, štítkov alebo stavov reťazcov.

Príklady:

Automaticky označiť nové reťazce¶
Vyhľadávací dopyt	`NOT has:label`
Štítky na pridanie	nedávne

Označenie všetkých reťazcov changelogu Metadátové súbory obchodu s aplikáciami ako iba na čítanie¶
Vyhľadávací dopyt	`language:en AND key:changelogs/`
Príznaky prekladu na pridanie	`read-only`

Označenie určitých reťazcov ako iba na čítanie¶
Vyhľadávací dopyt	source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" AND language:en
Príznaky prekladu na pridanie	`read-only`

Viď aj

Označiť nezmenené preklady ako „Vyžaduje prepísanie“¶

ID doplnku:: weblate.flags.same_edit
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Jednotka pred vytvorením

Vždy, keď je nový prekladateľný reťazec importovaný zo systému správy verzií (VCS) a zhoduje sa so zdrojovým reťazcom, je vo Weblate označený ako vyžadujúci prepísanie. Obzvlášť užitočné pre formáty súborov, ktoré obsahujú zdrojové reťazce pre nepreložené reťazce.

Rada

Môžete tiež sprísniť kontrolu Nezmenený preklad pridaním príznaku strict-same do Príznaky prekladu.

Viď aj

Stavy prekladu

Označiť nové zdrojové reťazce ako „Vyžaduje kontrolu“¶

ID doplnku:: weblate.flags.source_edit
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Jednotka pred vytvorením

Vždy, keď je nový zdrojový reťazec importovaný zo systému správy verzií (VCS), je vo Weblate označený ako vyžadujúci kontrolu. Týmto spôsobom môžete ľahko filtrovať a upravovať zdrojové reťazce napísané vývojármi.

Viď aj

Stavy prekladu

Označiť nové preklady ako „Vyžaduje prepísanie“¶

ID doplnku:: weblate.flags.target_edit
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Jednotka pred vytvorením

Vždy, keď je nový prekladateľný reťazec importovaný zo systému správy verzií (VCS), je vo Weblate označený ako vyžadujúci prepísanie. Týmto spôsobom môžete ľahko filtrovať a upravovať preklady vytvorené vývojármi.

Viď aj

Stavy prekladu

Označiť aktualizované preklady z repozitára ako „Vyžaduje prepísanie“¶

ID doplnku:: weblate.flags.target_repo_update
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Jednotka po synchronizácii

Vždy, keď je preklad reťazca zmenený zo systému správy verzií (VCS), je vo Weblate označený ako vyžadujúci prepísanie. Obzvlášť užitočné, ak sa súbory prekladov často aktualizujú manuálne alebo externou službou.

Viď aj

Stavy prekladu

Vyplniť reťazce iba na čítanie zdrojom¶

Added in version 4.18.

ID doplnku:: weblate.generate.fill_read_only
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Aktualizácia komponentu, Denne

Vyplňuje preklad reťazcov iba na čítanie zdrojovým reťazcom.

Generátor štatistík¶

ID doplnku:

weblate.generate.generate

Konfigurácia:

scope

Rozsah výstupu

Dostupné voľby:¶
`translation`	Jeden súbor na preklad
`component`	Jeden súbor na komponent

filename

Názov vygenerovaného súboru

template

Obsah vygenerovaného súboru

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu, Repozitár po pridaní, Repozitár po odstránení, Repozitár pred zápisom

Generuje súbor obsahujúci podrobné informácie o stave prekladu.

Môžete použiť šablónu Django v názve súboru aj v obsahu, pozrite si Značkovanie šablóny pre podrobný popis značkovania.

Napríklad generovanie súhrnného súboru pre každý preklad:

Názov vygenerovaného súboru

locale/{{ language_code }}.json

Obsah

{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

Výstup v rámci celého komponentu¶

Nastavte Rozsah výstupu na Jeden súbor na komponent, aby ste udržiavali jeden zoznam lokalít alebo súbor štatistík pre celý komponent. Predvolené Jeden súbor na preklad zachováva existujúce konfigurácie.

Výstup komponentu sa generuje pri inštalácii a zmenách konfigurácie. Aktualizuje sa pri zápisoch prekladov, pridávaní alebo odstraňovaní jazykov a znovu načítaní súborov komponentu. Zmeny metadát jazyka sa zahrnú pri nasledujúcej takejto aktualizácii alebo pri rekonfigurácii doplnku. Nezmenený výstup nevytvára nový commit.

Oba režimy podporujú premenné komponentu a projektu v názvoch súborov a obsahu. V režime komponentu obsah additionally prijíma translations, zoradené podľa kódu jazyka repozitára. Každá položka poskytuje:

language_code: kód jazyka používaný v repozitári.
language_name: anglický názov jazyka.
language_native_name: názov preložený do vlastného jazyka pomocou katalógov Weblate, s anglickým fallbackom keď nie je dostupný.
language_direction: ltr alebo rtl.
filename a url: názov súboru prekladu a URL Weblate.
is_source: či ide o zdrojový preklad komponentu.
stats: rovnaké štatistiky dostupné v režime prekladu.

Zdrojový preklad je zahrnutý. Šablóny ho môžu vylúčiť pomocou {% if not item.is_source %}. Štatistiky používajú sémantiku dokončenia Weblate. Vlastné názvy jazykov sa zachovávajú; neexistuje vyhľadávanie externých údajov o lokalite.

Napríklad vygenerujte locales.json pre webovú stránku:

[
{% for item in translations %}
  {
    "code": {{ item.language_code|json }},
    "file": {{ item.filename|json }},
    "name": {{ item.language_native_name|json }},
    "dir": {{ item.language_direction|json }}
  }{% if not forloop.last %},{% endif %}
{% endfor %}
]

Alebo vygenerujte languages.py pre aplikáciu:

names = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.language_native_name|python }},
{% endfor %}
}
completeness = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.stats.translated_percent|python }},
{% endfor %}
}

Filtre json a python serializujú kompletné hodnoty vrátane úvodzoviek reťazcov a escapovania. Nepridávajte úvodzovky okolo ich výstupu. Tiež podporujú zoznamy a slovníky; {{ translations|json }} exportuje všetky dostupné údaje. Dátumy a časy sa serializujú ako reťazce vo formáte ISO.

Viď aj

Značkovanie šablóny

Predvyplniť preklad zdrojom¶

Added in version 4.11.

ID doplnku:: weblate.generate.prefill
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Aktualizácia komponentu, Denne

Vyplňuje reťazce prekladu zdrojovým reťazcom.

Všetky nepreložené reťazce v komponente budú vyplnené zdrojovým reťazcom a označené ako vyžadujúce úpravu. Použite toto, keď nemôžete mať prázdne reťazce v súboroch prekladu. .. AUTOGENERATED START: weblate.generate.pseudolocale .. Táto sekcia je automaticky generovaná pomocou ./manage.py list_addons. Neupravujte manuálne.

Generovanie pseudolokálu¶

Added in version 4.5.

ID doplnku:

weblate.generate.pseudolocale

Konfigurácia:

`source`	Zdrojové reťazce
`target`	Cieľový preklad	Všetky reťazce v tomto preklade budú prepísané
`prefix`	Predradený statický text
`var_prefix`	Predradený premenný text
`suffix`	Pripojený statický text
`var_suffix`	Pripojený premenný text
`var_multiplier`	Násobiteľ premenného textu	Koľkokrát sa má opakovať premenný text v závislosti od dĺžky zdrojového reťazca.
`include_readonly`	Zahrnúť reťazce iba na čítanie

Spúšťače:

Inštalácia doplnku, Aktualizácia komponentu, Denne

Generuje preklad automatickým pridaním prefixu a suffixu k zdrojovým reťazcom.

Pseudolokály sú užitočné na nájdenie reťazcov, ktoré nie sú pripravené na lokalizáciu. Dosahuje sa to úpravou všetkých prekladateľných zdrojových reťazcov, aby bolo ľahké spozorovať neupravené reťazce pri spustení aplikácie v jazyku pseudolokálu.

Je tiež možné nájsť reťazce, ktorých lokalizované ekvivalenty sa nemusia zmestiť do rozloženia.

Použitie premenných častí umožňuje hľadať reťazce, ktoré sa po lokalizácii nemusia zmestiť do používateľského rozhrania – rozširuje text na základe dĺžky zdrojového reťazca. Premenné texty sa opakujú podľa dĺžky textu vynásobenej násobiteľom. Napríklad Hello world s premenným textom _ a násobiteľom 1 sa stane Hello world___________ – text sa opakuje raz za každý znak v zdrojovom reťazci.

Reťazce budú generované pomocou nasledujúceho vzoru:

Predradený statický text Predradený premenný text Zdrojový reťazec Pripojený premenný text Pripojený statický text

Rada

Môžete použiť skutočné jazyky na testovanie, ale vo Weblate sú k dispozícii špecializované pseudolokály – en_XA a ar_XB.

Rada

Tento doplnok môžete použiť na začatie prekladu do nového lokálu existujúceho alebo podobného jazyka. Po pridaní prekladu do komponentu prejdite na doplnok. Príklad: Ak máte fr a chcete začať preklad fr_CA, jednoducho nastavte fr ako zdroj, fr_CA ako cieľ a nechajte prefix a suffix prázdne.

Odinštalujte doplnok, keď máte nový preklad vyplnený, aby ste zabránili Weblate meniť preklady vykonané po kopírovaní.

Aktualizovať premennú ALL_LINGUAS v súbore „configure“¶

ID doplnku:: weblate.gettext.configure
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Denne, Repozitár po pridaní, Repozitár po odstránení

Aktualizuje premennú ALL_LINGUAS v súboroch „configure“, „configure.in“ alebo „configure.ac“, keď sa pridá alebo odstráni preklad.

Aktualizuje premennú ALL_LINGUAS v súboroch configure, configure.in alebo akomkoľvek súbore configure.ac, keď sa pridá alebo odstráni preklad.

Prispôsobiť výstup gettextu¶

Removed in version 5.13: Nahradené Parametre formátu súboru.

Aktualizovať gettext šablónu (Django)¶

Added in version 5.17.

ID doplnku:

weblate.gettext.django

Konfigurácia:

interval

Frekvencia aktualizácie

Ako často by mal doplnok aktualizovať súbor POT pri obnovení komponentu.

Dostupné voľby:¶
`daily`	Denne
`weekly`	Týždenne
`monthly`	Mesačne

normalize_header

Normalizovať hlavičku POT

Aktualizuje hlavičky gettextu a nahrádza zástupné komentáre POT.

location_mode

Umiestnenia zdroja

Vyberte, ako extrakcia zapisuje umiestnenia zdroja do súboru POT. Použite toto na zachovanie umiestnení v šablóne pri ich vynechaní z preložených súborov PO.

Dostupné voľby:¶
`file`	Použiť nastavenia formátu súboru
`keep`	Extrahovať umiestnenia do súboru POT
`omit`	Neextrahovať umiestnenia

Spúšťače:

Inštalácia doplnku, Manuálne spustenie, Repozitár po aktualizácii

Aktualizuje šablónu gettextu pomocou vstavaného príkazu makemessages v Django.

Tento doplnok aktualizuje šablónu nakonfigurovanú v Šablóna pre nové preklady. Je dostupný pre komponenty gettext PO a komponent musí definovať šablónu pre nové preklady.

Vybraná frekvencia aktualizácie sa vzťahuje na automatické behy po obnove repozitára. Inštalácia alebo opätovná konfigurácia doplnku ho spustí okamžite a manuálne spustenia zo správy doplnkov alebo API tiež obídu frekvenčný plán. Po úspešnej aktualizácii Weblate zapíše zmenenú šablónu a znovu načíta zdrojové reťazce.

Aktualizácia šablóny sama o sebe neaktualizuje prekladové súbory PO. Ponechajte nainštalovaný Aktualizovať súbory PO tak, aby zodpovedali POT (msgmerge), ak majú prekladové súbory automaticky nasledovať zmeny šablóny. Inštalačný formulár pre tento doplnok môže nainštalovať tento doplnok, ale existujúce nastavenia doplnkov túto možnosť inštalácie znova nezobrazia.

Požiadavky Django¶

Tento doplnok vyžaduje xgettext a msguniq. Spúšťa interný extrakčný wrapper Weblate pre správy Django namiesto vyvolania projektového manage.py makemessages, takže nenačítava nastavenia ani aplikácie projektu Django.

Šablóna pre nové preklady musí používať doménu django alebo djangojs. Podporované názvy šablón sú django.pot, djangojs.pot, django.po, a djangojs.po. Weblate odvodzuje zdrojový adresár z cesty šablóny a pri extrakcii preskakuje adresáre lokalizácií repozitára.

Aktualizovať súbor LINGUAS¶

ID doplnku:: weblate.gettext.linguas
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Denne, Repozitár po pridaní, Repozitár po odstránení

Aktualizuje súbor LINGUAS, keď sa pridá alebo odstráni preklad.

Aktualizovať súbor POT (Meson)¶

Added in version 5.17.

ID doplnku:

weblate.gettext.meson

Konfigurácia:

interval

Frekvencia aktualizácie

Ako často by mal doplnok aktualizovať súbor POT pri obnovení komponentu.

Dostupné voľby:¶
`daily`	Denne
`weekly`	Týždenne
`monthly`	Mesačne

normalize_header

Normalizovať hlavičku POT

Aktualizuje hlavičky gettextu a nahrádza zástupné komentáre POT.

location_mode

Umiestnenia zdroja

Vyberte, ako extrakcia zapisuje umiestnenia zdroja do súboru POT. Použite toto na zachovanie umiestnení v šablóne pri ich vynechaní z preložených súborov PO.

Dostupné voľby:¶
`file`	Použiť nastavenia formátu súboru
`keep`	Extrahovať umiestnenia do súboru POT
`omit`	Neextrahovať umiestnenia

data_dirs

Adresáre dát ITS

Adresáre relatívne k repozitáru oddelené novým riadkom, ktoré obsahujú podpriečinok its, napríklad po pre po/its. Skoršie adresáre prepisujú novšie adresáre a vstavané pravidlá.

comment_mode

Komentáre kódu

Vyberte, či má xgettext extrahovať žiadne komentáre, všetky komentáre alebo iba komentáre označené konkrétnym tagom.

Dostupné voľby:¶
`off`	Neextrahovať komentáre
`all`	Extrahovať všetky komentáre
`tagged`	Extrahovať komentáre s tagom

comment_tag

Tag komentára

Tag odovzdaný xgettextu na extrakciu komentárov pri použití režimu komentárov s tagmi.

checks

Kontroly xgettext

Ďalšie validačné kontroly xgettext na povolenie pre extrahované správy.

Dostupné voľby:¶
`ellipsis-unicode`	ellipsis-unicode
`space-ellipsis`	space-ellipsis
`quote-unicode`	quote-unicode
`bullet-unicode`	bullet-unicode

keyword

Dodatočné kľúčové slová

Dodatočné kľúčové slová oddelené novým riadkom odovzdané xgettext pomocou –keyword.

keyword_exclusive

Použiť výlučne kľúčové slová

Keď je povolené, odovzdá --keyword bez hodnoty xgettextu pred dodatočným kľúčovým slovom, čím zakáže všetky predvolené kľúčové slová, takže sa rozpozná iba vyššie uvedené kľúčové slovo.

preset

Predvoľba Meson

Vstavaná predvoľba argumentov xgettext zodpovedajúca integrácii gettextu v Mesone. Predvoľba GLib pridáva možnosti kľúčového slova a formátového príznaku používané pomocníkom gettextu v Mesone.

Dostupné voľby:¶
`glib`	GLib

Spúšťače:

Inštalácia doplnku, Manuálne spustenie, Repozitár po aktualizácii

Aktualizuje šablónu gettextu pomocou konvencií gettextu v Mesone.

Tento doplnok aktualizuje šablónu nakonfigurovanú v Šablóna pre nové preklady. Je dostupný pre komponenty gettext PO a komponent musí definovať šablónu pre nové preklady.

Požiadavky Meson¶

Tento doplnok vyžaduje xgettext; nevyvoláva Meson. Dodržiava konvencie gettextu Meson čítaním POTFILES alebo POTFILES.in z adresára gettext a odovzdaním predvoľby kľúčového slova a formátového príznaku GLib programu xgettext.

Adresár gettext je adresár obsahujúci šablónu nakonfigurovanú v Šablóna pre nové preklady. Musí obsahovať meson.build a POTFILES alebo POTFILES.in. Súbor projektu Meson meson.build musí byť prítomný v tomto adresári alebo v jednom z jeho nadradených adresárov. Ak existujú oba súbory POTFILES aj POTFILES.in, použije sa POTFILES. Priľahlý súbor POTFILES.skip vylučuje uvedené zdrojové súbory z extrakcie.

Nakonfigurujte tento doplnok z existujúceho nastavenia gettextu Meson. Vo väčšine projektov Meson je adresár gettext po/, šablóna je pomenovaná podľa domény gettext a po/meson.build volá pomocníka gettextu Meson. Použite rovnakú cestu šablóny v Šablóna pre nové preklady, napríklad po/example.pot, a uchovajte POTFILES alebo POTFILES.in vedľa tohto súboru meson.build.

Weblate nečíta zoznam zdrojových súborov z meson.build. Používa POTFILES alebo POTFILES.in, čo zodpovedá konvencii gettextu Meson. Keď projekt Meson používa nepredvolený adresár alebo doménu gettext, zrkadlite toto rozloženie v ceste šablóny komponentu.

Generovať súbory MO¶

ID doplnku:

weblate.gettext.mo

Konfigurácia:

`path`	Cesta vygenerovaného súboru MO	Ak nie je špecifikovaná, použije sa umiestnenie súboru PO.
`fuzzy`	Zahrnúť reťazce vyžadujúce úpravu	Reťazce vyžadujúce úpravu (fuzzy) zvyčajne nie sú pripravené na použitie ako preklady.

Spúšťače:

Repozitár pred zápisom

Automaticky generuje súbor MO pre každý zmenený súbor PO.

Umiestnenie vygenerovaného súboru MO možno prispôsobiť a pole preň používa Značkovanie šablóny.

Poznámka

Ak sa preklad odstráni, jeho súbor PO bude vymazaný z repozitára, ale súbor MO vygenerovaný týmto doplnkom nie. Súbor MO musí byť odstránený z upstreamu manuálne.

Aktualizovať súbory PO tak, aby zodpovedali POT (msgmerge)¶

Zmenené vo verzii 5.13: Konfigurácia Nastavenia bola presunutá do Parametre formátu súboru.

ID doplnku:: weblate.gettext.msgmerge
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Repozitár po aktualizácii

Aktualizuje všetky súbory PO (ako nakonfigurované „Maskou súboru“) tak, aby zodpovedali súboru POT (ako nakonfigurované „Šablónou pre nové preklady“) pomocou msgmerge.

Tento doplnok je nevyhnutný pri práci so súbormi PO gettextu, kde sa súbor POT (šablóna) aktualizuje novými reťazcami alebo zmenami existujúcich reťazcov. Keď sa súbor POT aktualizuje v repozitári, tento doplnok automaticky zlúči tieto zmeny do všetkých jazykových súborov PO, čím zabezpečí, že:

Nové prekladateľné reťazce sa objavia vo všetkých jazykoch
Odstránené reťazce sú označené ako zastarané
Upravené reťazce sú označené ako vyžadujúce kontrolu (fuzzy)

Väčšinu možností príkazového riadka msgmerge možno nastaviť prostredníctvom konfigurácie parametrov formátu súboru. Povoľte parameter po_remove_obsolete na odstránenie zastaraných položiek #~ pri ukladaní súborov PO.

Viď aj

Aktualizovať súbor POT (Sphinx)¶

Added in version 5.17.

ID doplnku:

weblate.gettext.sphinx

Konfigurácia:

interval

Frekvencia aktualizácie

Ako často by mal doplnok aktualizovať súbor POT pri obnovení komponentu.

Dostupné voľby:¶
`daily`	Denne
`weekly`	Týždenne
`monthly`	Mesačne

normalize_header

Normalizovať hlavičku POT

Aktualizuje hlavičky gettextu a nahrádza zástupné komentáre POT.

location_mode

Umiestnenia zdroja

Vyberte, ako extrakcia zapisuje umiestnenia zdroja do súboru POT. Použite toto na zachovanie umiestnení v šablóne pri ich vynechaní z preložených súborov PO.

Dostupné voľby:¶
`file`	Použiť nastavenia formátu súboru
`keep`	Extrahovať umiestnenia do súboru POT
`omit`	Neextrahovať umiestnenia

filter_mode

Filtrovanie

Voliteľne odstrániť reťazce, ktoré nie sú užitočné na preklad po extrakcii Sphinx.

Dostupné voľby:¶
`none`	Žiadne
`weblate_docs`	Dokumentácia Weblate

Spúšťače:

Inštalácia doplnku, Manuálne spustenie, Repozitár po aktualizácii

Aktualizuje šablónu gettextu pomocou nástroja na zostavovanie gettextu v Sphinxe bez načítania konfigurácie projektu.

Tento doplnok aktualizuje šablónu nakonfigurovanú v Šablóna pre nové preklady. Je dostupný pre komponenty gettext PO a komponent musí definovať šablónu pre nové preklady.

Požiadavky Sphinx¶

Tento doplnok vyžaduje sphinx-build, poskytovaný inštalačným doplnkom sphinx. Šablóna pre nové preklady musí byť súbor .pot pod adresárom locales. Adresár pred locales sa používa ako zdrojový adresár Sphinx a musí obsahovať conf.py.

Extrakcia používa pribalenú konfiguráciu Sphinx Weblate a nenačítava konfiguráciu projektu. Weblate spustí nástroj na zostavovanie gettextu Sphinx, normalizuje referencie zdroja na cesty relatívne k zdrojovému adresáru a skopíruje vygenerovanú šablónu späť do nakonfigurovanej cesty šablóny.

Aktualizovať súbor POT (xgettext)¶

Added in version 5.17.

ID doplnku:

weblate.gettext.xgettext

Konfigurácia:

interval

Frekvencia aktualizácie

Ako často by mal doplnok aktualizovať súbor POT pri obnovení komponentu.

Dostupné voľby:¶
`daily`	Denne
`weekly`	Týždenne
`monthly`	Mesačne

normalize_header

Normalizovať hlavičku POT

Aktualizuje hlavičky gettextu a nahrádza zástupné komentáre POT.

location_mode

Umiestnenia zdroja

Vyberte, ako extrakcia zapisuje umiestnenia zdroja do súboru POT. Použite toto na zachovanie umiestnení v šablóne pri ich vynechaní z preložených súborov PO.

Dostupné voľby:¶
`file`	Použiť nastavenia formátu súboru
`keep`	Extrahovať umiestnenia do súboru POT
`omit`	Neextrahovať umiestnenia

data_dirs

Adresáre dát ITS

Adresáre relatívne k repozitáru oddelené novým riadkom, ktoré obsahujú podpriečinok its, napríklad po pre po/its. Skoršie adresáre prepisujú novšie adresáre a vstavané pravidlá.

comment_mode

Komentáre kódu

Vyberte, či má xgettext extrahovať žiadne komentáre, všetky komentáre alebo iba komentáre označené konkrétnym tagom.

Dostupné voľby:¶
`off`	Neextrahovať komentáre
`all`	Extrahovať všetky komentáre
`tagged`	Extrahovať komentáre s tagom

comment_tag

Tag komentára

Tag odovzdaný xgettextu na extrakciu komentárov pri použití režimu komentárov s tagmi.

checks

Kontroly xgettext

Ďalšie validačné kontroly xgettext na povolenie pre extrahované správy.

Dostupné voľby:¶
`ellipsis-unicode`	ellipsis-unicode
`space-ellipsis`	space-ellipsis
`quote-unicode`	quote-unicode
`bullet-unicode`	bullet-unicode

keyword

Dodatočné kľúčové slová

Dodatočné kľúčové slová oddelené novým riadkom odovzdané xgettext pomocou –keyword.

keyword_exclusive

Použiť výlučne kľúčové slová

input_mode

Vstupný zdroj

Vyberte, či má xgettext čítať zdrojové súbory z globálnych vzorov alebo z manifestu POTFILES/POTFILES.in.

Dostupné voľby:¶
`patterns`	Vzory zdrojových súborov
`potfiles`	Manifest POTFILES

language

Jazyk xgettext

Programovací jazyk odovzdaný xgettextu, napríklad Python alebo C. Nechajte prázdne, aby xgettext skúsil určiť jazyk podľa prípony súboru.

source_patterns

Vzory zdrojových súborov

Globálne vzory relatívne k repozitáru oddelené novými riadkami pre súbory na extrakciu pomocou xgettext.

potfiles_path

Cesta k POTFILES

Cesta relatívna k repozitáru k POTFILES alebo POTFILES.in. Položky sa riešia relatívne ku koreňu repozitára. Ak je prítomný vedľa manifestu, POTFILES.skip vylučuje uvedené súbory z extrakcie.

Spúšťače:

Inštalácia doplnku, Manuálne spustenie, Repozitár po aktualizácii

Aktualizuje šablónu gettextu pomocou xgettext na vybraných zdrojových súboroch.

Tento doplnok aktualizuje šablónu nakonfigurovanú v Šablóna pre nové preklady. Je dostupný pre komponenty gettext PO a komponent musí definovať šablónu pre nové preklady.

Požiadavky xgettext¶

Tento doplnok vyžaduje xgettext. Nakonfigurujte buď vzory zdrojových súborov alebo manifest POTFILES / POTFILES.in. Vzory zdrojových súborov sú globálne vzory relatívne k repozitáru a programu xgettext sa odovzdávajú iba zodpovedajúce súbory repozitára.

Položky v POTFILES alebo POTFILES.in sa riešia relatívne ku koreňu repozitára. Musia to byť relatívne cesty, zostať vnútri repozitára a odkazovať na existujúce súbory. Prázdne riadky a riadky začínajúce na # sa ignorujú. Ak vedľa manifestu existuje súbor POTFILES.skip, jeho položky sú vylúčené z extrakcie.

Automatické behy obnovy repozitára sa preskočia, pokiaľ zmenené súbory nezodpovedajú nakonfigurovaným vzorom zdroja, nezodpovedajú súborom uvedeným v manifeste, nezmenia sledovaný manifest alebo nezmenia konfiguráciu doplnku.

Pri konfigurácii tohto doplnku začnite od nastavenia extrakcie systému zostavenia. Projekty Autotools zvyčajne uchovávajú vstupy gettext v po/POTFILES.in a možnosti, ako je doména gettext a príznaky xgettext v po/Makevars alebo súvisiacich súboroch Makefile.am. Použite režim manifestu s rovnakým súborom POTFILES.in, keď sú jeho položky jednoduché cesty zdroja relatívne k repozitáru, a skopírujte relevantné správanie extrakcie do nastavení doplnku, napríklad jazyk, extrakciu komentárov, kontroly a dodatočné kľúčové slovo.

Pre iné systémy zostavenia použite ako zdroj pravdy zoznam zdrojov alebo príkaz extrakcie, ktorý už spúšťajú. CMake, vlastné Makefiles, skripty npm alebo extrakčné skripty špecifické pre projekt často volajú xgettext priamo alebo generujú medzizoznam súborov. Nakonfigurujte vzory zdroja pre jednoduché rozloženia alebo použite režim manifestu, keď projekt udržiava jednoduchý zoznam súborov. Ak manifest systému zostavenia obsahuje transformácie alebo prefixy, ktoré nie sú cestami k súborom, preveďte ho na jednoduché cesty relatívne k repozitáru pred jeho použitím ako POTFILES.

Zmiešané formáty zdroja a pravidlá ITS¶

Nechajte Jazyk xgettext prázdne, aby ste extrahovali správy z rôznych formátov do rovnakého POT. Zahrňte všetky vstupy do vzorov zdroja alebo POTFILES, napríklad:

common/messages.py
qt/application.desktop
qt/application.policy
data/application.metainfo.xml

Položky plochy používajú natívny parser xgettext. Weblate pribaľuje pravidlá ITS pre politiky Polkit, AppStream/MetaInfo, GSettings, GTK Builder a Shared MIME Info. Tieto pravidlá sú zahrnuté v balíku Weblate, vrátne inštalácií Docker; pre tieto formáty nie sú potrebné dodatočné systémové balíky. Doplnok Aktualizovať súbor POT (Meson) používa rovnaké pravidlá.

Extrakcia nasleduje správanie upstream gettextu a ITS. Najmä extrakcia plochy zahŕňa kľúče ako Name, GenericName a Comment; pravidlá Polkit vyberajú elementy description a message bez filtrovania podľa gettext-domain. Používajte nepreložené zdroje politík: pravidlá upstream Polkit tiež vyberajú elementy nesúce xml:lang.

Pre vlastné formáty XML alebo prepisy nakonfigurujte Adresáre dát ITS. Zadajte jeden adresár relatívny k repozitáru na riadok v poradí priority. Každý musí obsahovať podpriečinok its/ s pravidlami umiestnenia .loc a pravidlami extrakcie .its. Napríklad zadajte po pre po/its/example.loc a po/its/example.its alebo . pre its/ v koreni repozitára. V konfigurácii doplnku API použite zoznam: "data_dirs": ["po", "data"].

Skoršie adresáre majú prednosť pred neskoršími, nasledované pribalenými pravidlami Weblate a systémovými pravidlami gettextu. Adresáre sa odovzdávajú cez GETTEXTDATADIRS. Nakonfigurujte ich explicitne aj pri použití Meson; Weblate nečíta data_dirs z meson.build ani nededí premennú prostredia administrátora GETTEXTDATADIRS.

Adresáre pravidiel a súbory musia zostať vnútri repozitára a nesmú byť symbolické odkazy. target pravidla umiestnenia musí pomenovať existujúci súbor .its v rovnakom adresári. DTD, deklarácie entít a externé odkazy na pravidlá nie sú podporované. Weblate validuje pravidlá lokálne pre projekt pred extrakciou a neplatné pravidlá hlási ako chyby doplnku. Zmeny, pridania alebo odstránenia v nakonfigurovaných adresároch its/ spúšťajú extrakciu aj keď sa zdrojové súbory nezmenili.

Viď aj

Pravidlá ITS GNU gettext a pravidlá umiestnenia.

Zlúčiť Git zápisy¶

ID doplnku:

weblate.git.squash

Konfigurácia:

squash

Zlučovanie zápisov

Dostupné voľby:¶
`all`	Všetky zápisy do jedného
`language`	Podľa jazyka
`file`	Podľa súboru
`author`	Podľa autora
`author-language`	Podľa autora a jazyka

append_trailers

Pripojiť trailery k správe zlúčeného zápisu

Riadky trailerov sú riadky, ktoré vyzerajú podobne ako hlavičky e-mailov podľa RFC 822, na konci inak voľnej časti správy zápisu, napríklad ‚Co-authored-by: …‘.

commit_message

Správa zápisu

Táto správa zápisu sa použije namiesto kombinovaných správ zápisov zo zlúčených zápisov.

Spúšťače:

Inštalácia doplnku, Repozitár po zápise

Zlúčiť Git zápisy pred odoslaním zmien.

Rada

Aby sa predišlo zbytočným konfliktom, odporúča sa nakonfigurovať automatické prijímanie zmien z upstreamu pomocou webhookov alebo API, pozrite Aktualizácia repozitárov.

Git zápisy možno zlúčiť pred odoslaním zmien v jednom z nasledujúcich režimov:

Všetky zápisy do jedného
Podľa jazyka
Podľa súboru
Podľa autora
Podľa autora a jazyka

Pôvodné správ zápisov sa zachovajú, ale autorstvo sa stratí, pokiaľ nie je vybrané Podľa autora alebo nie je správa zápisu prispôsobená tak, aby ho obsahovala.

Pôvodné správy zápisov možno voliteľne prepísať vlastnou správou zápisu.

Trailery (riadky zápisov ako Co-authored-by: …) možno voliteľne odstrániť z pôvodných správ zápisov a pripojiť na koniec správy zlúčeného zápisu. Tým sa tiež generuje správne uznanie Co-authored-by: pre každého prekladateľa.

Prispôsobiť výstup JSON¶

Zmenené vo verzii 5.12: Pridaná možnosť Vyhnúť sa medzerám po oddeľovačoch.

Removed in version 5.13: Nahradené Parametre formátu súboru.

Obnoviť na hlavný repozitár¶

Added in version 5.17.

ID doplnku:: weblate.hosted.reset
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Denne

Každú noc zahodí všetky zmeny v repozitári Weblate.

Formátovať súbor Java properties¶

ID doplnku:

weblate.properties.sort

Konfigurácia:

case_sensitive

Povoliť triedenie kľúčov s rozlišovaním veľkosti písmen

Spúšťače:

Repozitár pred zápisom

Formátuje a triedi súbor Java properties.

Konsoliduje nové riadky na unixové.
Formátovanie únikových sekvencií Unicode veľkými písmenami (ak sú prítomné).
Odstráni prázdne riadky a komentáre.
Triedi reťazce podľa kľúčov.
Odstráni duplicitné reťazce.

Odstránenie zastaraných komentárov¶

ID doplnku:

weblate.removal.comments

Konfigurácia:

age

Dní na uchovanie

Spúšťače:

Inštalácia doplnku, Denne

Nastaviť časový rámec pre odstránenie komentárov.

Môže to byť užitočné na odstránenie starých komentárov, ktoré mohli zastarať. Používajte opatrne, pretože starnutie komentárov neznamená, že stratili svoju dôležitosť.

Odstránenie zastaraných návrhov¶

ID doplnku:

weblate.removal.suggestions

Konfigurácia:

`age`	Dní na uchovanie
`votes`	Hranica hlasovania	Hranica pre odstránenie. Nechajte prázdne, ak sa majú návrhy odstraňovať bez ohľadu na počet hlasov. Toto pole nemá žiadny účinok, ak je hlasovanie vypnuté.

Spúšťače:

Inštalácia doplnku, Denne

Nastaviť časový rámec pre odstránenie návrhov.

Môže byť veľmi užitočné v spojení s hlasovaním o návrhoch (pozrite Recenzia kolegami) na odstránenie návrhov, ktoré nedostanú dostatok kladných hlasov v danom časovom rámci.

Aktualizovať súbory RESX¶

ID doplnku:: weblate.resx.update
Konfigurácia:: Tento doplnok nemá žiadnu konfiguráciu.
Spúšťače:: Inštalácia doplnku, Repozitár po aktualizácii

Aktualizovať všetky súbory prekladov tak, aby zodpovedali jednojazyčnému základnému hlavnému súboru. Nepoužité reťazce sa odstránia a nové sa pridajú ako kópie zdrojového reťazca.

Rada

Použite Vyčistiť súbory prekladov, ak chcete odstrániť iba zastarané kľúče prekladu.

Viď aj

Aktualizuje Weblate prekladové súbory aj mimo samotných prekladov?

Slack Webhooky¶

Added in version 5.12.

ID doplnku:

weblate.webhook.slack

Konfigurácia:

`webhook_url`	URL webhooku
`event_filter`	Udalosti zmien na spustenie	Vyberte, ktoré udalosti zmeny majú spustiť tento doplnok. Udalosti zmien na spustenie
`events`	Vybrané udalosti zmien	Vybrané udalosti zmien

Spúšťače:

Zmena udalosti

Odosielanie notifikácií do kanála Slack na základe vybraných udalostí.

Varovanie

Obsah notifikácie môže zobrazovať značky HTML. Ide o známy problém, ktorý bude čoskoro vyriešený; pozrite https://github.com/WeblateOrg/weblate/issues/15056.

Rada

Ak chcete získať URL webhooku, postupujte podľa krokov uvedených v dokumentácii Slack Incoming Webhooks

Webhook¶

Added in version 5.11.

Zmenené vo verzii 5.15: Súlad dĺžky tajomstva so špecifikáciou je teraz validovaný.

ID doplnku:

weblate.webhook.webhook

Konfigurácia:

`webhook_url`	URL webhooku
`secret`	Tajomstvo webhooku	Tajomstvo štandardných webhookov je reťazec kódovaný v base64.
`event_filter`	Udalosti zmien na spustenie	Vyberte, ktoré udalosti zmeny majú spustiť tento doplnok. Udalosti zmien na spustenie
`events`	Vybrané udalosti zmien	Vybrané udalosti zmien

Spúšťače:

Zmena udalosti

Odosielanie notifikácií externým službám na základe vybraných udalostí v súlade so špecifikáciou štandardných webhookov.

Dátová časť požiadavky vyhovuje schéme Weblate Messaging. Pole action používa názov akcie uvedený v Vybrané udalosti zmien. Popis OpenAPI možno nájsť aj na /api/docs/. Ukážka tela požiadavky:

{
   "change_id": 99,
   "action": "Translation changed",
   "timestamp": "2019-08-24T14:15:22Z",
   "target": "Nazdar svete!",
   "old": "Nazdar!",
   "source": "Hello, world",
   "url": "/translate/project-slug/component-slug/cs/?checksum=46add148a53cab6f",
   "author": "author-username",
   "user": "user-username",
   "project": "project-slug",
   "component": "component-slug",
   "translation": "cs"
}

Ukážka tela požiadavky s kategóriami:

{
   "change_id": 8910,
   "action": "Component renamed",
   "timestamp": "2025-06-11T07:15:09Z",
   "target": ["new-name"],
   "old": ["component-slug"],
   "url": "/projects/project-slug/parent-category/child-category/sub-category/component-slug/",
   "user": "testuser",
   "project": "project-slug",
   "component": "component-slug",
   "category": [
      "sub-category",
      "child-category",
      "parent-category"
   ]
}

Ukážka hlavičiek požiadavky:

{
   "webhook-id": "7f1c5477f6275a69af7b83236c20cb1a",
   "webhook-timestamp": "1748505623.044281",
   "webhook-signature": "v1,Ceo5qEr07ixe2NLpvHk3FH9bwy/WavXrAFQ/9tdO6mc="
}

webhook-signature je zoznam podpisov HMAC oddelených medzerami, generovaných pomocou reťazca secret, dátovej časti požiadavky, webhook-timestamp a webhook-id. Tým sa zabezpečuje autentickosť a integrita požiadavky webhooku.

Poskytnuté secret je reťazec kódovaný v base64 s dĺžkou medzi 24 bajtmi (192 bitov) a 64 bajtmi (512 bitov). Môže mať prefix whsec_ pre ľahšiu identifikáciu.

Na overenie požiadavky môžete použiť metódu Webhook.verify z knižnice standardwebhooks alebo implementáciu „Špecifikácie štandardných webhookov“.

Viď aj

Režim Pridať ako schválený preklad doplnku Automatický preklad vytvára schválené reťazce, keď sú pre cieľový jazyk povolené revízie. Ak nastavenia projektu alebo prispôsobenie pracovného postupu pre jazyk vypnú revízie, vytvára namiesto toho preložené reťazce. Nakonfigurovaný režim sa zachováva, vrátane doplnkov na úrovni projektu a celej stránky, ktorých ciele majú rôzne nastavenia revízií. Konfigurácia tohto režimu vyžaduje bežné oprávnenie na správu doplnkov; nevyžaduje, aby konfigurovací používateľ bol recenzentom.

Doplnok Objavovanie komponentov zastaví s chybou, ak skenovanie repozitára prekročí 100 000 ciest alebo párovanie prekladových súborov by vyžadovalo viac ako 1 000 000 porovnaní cesty s maskou. Limit porovnaní sa kontroluje pomocou počtu ciest repozitára vynásobeného počtom mások súborov. Tieto pevné limity obmedzujú spotrebu zdrojov, keď obsah repozitára určuje masky. Keď sa prekročí ktorýkoľvek limit, objavovanie nevytvára ani neodstraňuje komponenty.

Zastarané doplnky¶

Prispievatelia v komentári¶

Removed in version 2026.10: Nahradené Komentáre prispievateľov.

Existujúce inštalácie weblate.gettext.authors sa migrujú na hodnotu gettext parametra formátu súboru po_contributor_comments pre každú dotknutú PO komponentu. To zahŕňa komponenty pokryté inštaláciami na úrovni kategórie, projektu a celej stránky. Nové komponenty majú predvolene zakázané, pokiaľ ich parametre formátu súboru nie sú skopírované z inej komponenty.

Odstráňte weblate.addons.gettext.GettextAuthorComments z vlastných zoznamov WEBLATE_ADDONS a položky weblate.gettext.authors z DEFAULT_ADDONS. Namiesto toho nakonfigurujte Komentáre prispievateľov.

Prispôsobiť výstup XML¶

Added in version 4.15.

Removed in version 5.13: Nahradené Parametre formátu súboru.

Prispôsobiť výstup YAML¶

Removed in version 5.13: Nahradené Parametre formátu súboru.

Bežné parametre doplnkov¶

Nástroje strojového prekladu¶

Dostupné voľby:¶
`alibaba`	Alibaba
`aws`	Amazon Translate
`anthropic`	Anthropic
`apertium-apy`	Apertium APy
`microsoft-translator`	Azure AI Translator
`azure-openai`	Azure OpenAI
`baidu`	Baidu
`cyrtranslit`	CyrTranslit
`deepl`	DeepL
`glosbe`	Glosbe
`google-translate-api-v3`	Google Cloud Translation Advanced
`google-translate`	Google Cloud Translation Basic
`ltengine`	LTEngine
`libretranslate`	LibreTranslate
`mistral`	Mistral
`modernmt`	ModernMT
`mymemory`	MyMemory
`netease-sight`	Netease Sight
`ollama`	Ollama
`openai`	OpenAI
`sap-translation-hub`	SAP Translation Hub
`systran`	Systran
`weblate`	Weblate
`weblate-translation-memory`	Prekladová pamäť Weblate
`yandex`	Yandex
`yandex-v2`	Yandex v2
`youdao-zhiyun`	Youdao Zhiyun
`tmserver`	tmserver

Formát súboru¶

Dostupné voľby:¶
`apple-xliff`	XLIFF 1.2 s rozšíreniami Apple
`appstore`	Metadátové súbory obchodu s aplikáciami
`arb`	Súbor ARB
`aresource`	Android String Resource
`asciidoc`	Súbor AsciiDoc
`ass`	Titulkový súbor Advanced SubStation Alpha
`catkeys`	Haiku catkeys
`cmp-resource`	Compose Multiplatform Resource
`csv`	Súbor CSV
`csv-multi`	Viachodnotový súbor CSV
`csv-simple`	Jednoduchý súbor CSV
`dokuwiki`	DokuWiki textový súbor
`dtd`	Súbor DTD
`flatxml`	Plochý súbor XML
`fluent`	Súbor Fluent
`formatjs`	Súbor Format.JS JSON
`go-i18n-json`	go-i18n v1 JSON súbor
`go-i18n-json-v2`	go-i18n v2 JSON súbor
`go-i18n-toml`	go-i18n TOML súbor
`gotext`	gotext JSON súbor
`gwt`	Vlastnosti GWT
`html`	Súbor HTML
`i18next`	i18next JSON súbor v3
`i18nextv4`	i18next JSON súbor v4
`idml`	Súbor IDML
`ini`	Súbor INI
`islu`	Inno Setup INI súbor
`joomla`	Jazykový súbor Joomla
`json`	Súbor JSON
`json-nested`	Súbor s vnorenou štruktúrou JSON
`laravel`	Laravel PHP reťazce
`markdown`	Súbor Markdown
`mdx`	Súbor MDX
`mediawiki`	MediaWiki textový súbor
`mi18n-lang`	@draggable/i18n jazykový súbor
`moko-resource`	Mobile Kotlin Resource
`nextcloud-json`	Nextcloud JSON súbor
`odf`	Súbor OpenDocument
`php`	PHP reťazce
`po`	gettext PO súbor
`po-mono`	gettext PO súbor (jednojazyčný)
`poxliff`	XLIFF 1.2 s rozšíreniami gettext
`properties`	Java Properties
`rc`	Súbor RC
`resjson`	Súbor RESJSON
`resourcedictionary`	Súbor ResourceDictionary
`resx`	.NET resource súbor
`ruby-yaml`	Ruby YAML súbor
`srt`	Titulkový súbor SubRip
`ssa`	Titulkový súbor SubStation Alpha
`strings`	iOS reťazce
`stringsdict`	Súbor Stringsdict
`sub`	Titulkový súbor MicroDVD
`tbx`	Súbor TermBase eXchange
`toml`	Súbor TOML
`ts`	Prekladový súbor Qt Linguist (verzia 2)
`ts1`	Prekladový súbor Qt Linguist (verzia 1)
`txt`	Textový súbor
`webextension`	Súbor WebExtension JSON
`wxl`	WixLocalization súbor
`xliff`	Prekladový súbor XLIFF 1.2
`xliff2`	Prekladový súbor XLIFF 2.0
`xlsx`	Excel Open XML
`xwiki-fullpage`	XWiki Full Page
`xwiki-java-properties`	XWiki Java Properties
`xwiki-page-properties`	XWiki Page Properties
`yaml`	Súbor YAML

Udalosti zmien na spustenie¶

Dostupné voľby:¶
`content`	Udalosti obsahu prekladu
`all`	Všetky udalosti zmien
`custom`	Vybrané udalosti zmien

Vybrané udalosti zmien¶

Nasledujúce akcie zmien sa môžu objaviť v payloadoch notifikácií. Fedora Messaging používa stĺpec identifikátora v témach správ, zatiaľ čo payloade webhookov používajú stĺpec názvu v poli action.

Dostupné voľby:¶
ID	Identifikátor	Názov	Popis
`0`	`resource_updated`	Zdroj aktualizovaný	Prekladový súbor bol synchronizovaný so svojím repozitárom.
`1`	`translation_completed`	Preklad dokončený	Jazykový preklad sa stal úplne preloženým po individuálnej úprave. Automatický preklad, nahrávania a hromadné úpravy túto udalosť nevysielajú.
`2`	`translation_changed`	Preklad zmenený	Existujúci preklad bol upravený používateľom.
`3`	`comment_added`	Komentár pridaný	Ku reťazcu bol pridaný komentár.
`4`	`suggestion_added`	Návrh pridaný	Bol pridaný návrh prekladu.
`5`	`translation_added`	Preklad pridaný	Predtým nepreložený reťazec bol preložený používateľom.
`6`	`automatically_translated`	Automaticky preložené	Preklad bol pridaný alebo zmenený automatickým prekladom. Toto sa vysiela namiesto Pridaný preklad alebo Zmenený preklad.
`7`	`suggestion_accepted`	Návrh prijatý	Návrh prekladu bol prijatý ako preklad.
`8`	`translation_reverted`	Preklad vrátený späť	Preklad bol obnovený na skoršiu hodnotu.
`9`	`translation_uploaded`	Preklad nahraný	Preklad bol pridaný alebo zmenený nahratím prekladového súboru. Toto sa vysiela namiesto Pridaný preklad alebo Zmenený preklad.
`13`	`source_string_added`	Zdrojový reťazec pridaný	Zdrojový reťazec bol pridaný mimo aktualizácií repozitára alebo nahrávania.
`14`	`component_locked`	Komponent zamknutý	Komponent bol uzamknutý pre preklad.
`15`	`component_unlocked`	Komponent odomknutý	Komponent bol odomknutý pre preklad.
`17`	`changes_committed`	Zmeny zapísané	Čakajúce zmeny komponentu boli zapísané.
`18`	`changes_pushed`	Zmeny odoslané	Zmeny repozitára boli odoslané do hlavného repozitára.
`19`	`repository_reset`	Repozitár resetovaný	Repozitár bol resetovaný do svojho stavu v hlavnom repozitári.
`20`	`repository_merged`	Repozitár zlúčený	Zmeny v hlavnom repozitári boli zlúčené.
`21`	`repository_rebased`	Repozitár prepísaný	Zmeny repozitára boli prepísané na hlavný repozitár.
`22`	`repository_merge_failed`	Zlúčenie repozitára zlyhalo	Zlúčenie zmien z hlavného repozitára zlyhalo.
`23`	`repository_rebase_failed`	Prepis repozitára zlyhal	Prepisovanie zmien repozitára zlyhalo.
`24`	`parsing_failed`	Spracovanie zlyhalo	Weblate nemohol spracovať prekladový súbor.
`25`	`translation_removed`	Preklad odstránený	Jazykový preklad bol odstránený.
`26`	`suggestion_removed`	Návrh odstránený	Návrh prekladu bol odstránený.
`27`	`translation_replaced`	Preklad nahradený	Preklad bol zmenený operáciou vyhľadania a nahradenia. Toto sa vysiela namiesto Zmenený preklad.
`28`	`repository_push_failed`	Odoslanie repozitára zlyhalo	Odosielanie zmien repozitára do hlavného repozitára zlyhalo.
`29`	`suggestion_removed_during_cleanup`	Návrh odstránený počas čistenia	Zastaraný návrh prekladu bol odstránený počas čistenia.
`30`	`source_string_changed`	Zdrojový reťazec zmenený	Zdrojový reťazec bol upravený vo Weblate.
`31`	`string_added`	Reťazec pridaný	Nový reťazec bol pridaný vo Weblate.
`32`	`bulk_status_changed`	Hromadný stav zmenený	Stav prekladu jedného alebo viacerých reťazcov bol hromadne zmenený.
`33`	`visibility_changed`	Viditeľnosť zmenená	Viditeľnosť projektu alebo komponentu bola zmenená.
`34`	`user_added`	Používateľ pridaný	Používateľovi bol udelený prístup.
`35`	`user_removed`	Používateľ odstránený	Prístup používateľa bol odstránený.
`36`	`translation_approved`	Preklad schválený	Preklad bol schválený počas kontroly.
`37`	`marked_for_edit`	Označené na úpravu	Preklad bol označený ako vyžadujúci úpravu.
`38`	`component_removed`	Komponent odstránený	Prekladový komponent bol odstránený.
`39`	`project_removed`	Projekt odstránený	Prekladový projekt bol odstránený.
`41`	`project_renamed`	Projekt premenovaný	Prekladový projekt bol premenovaný.
`42`	`component_renamed`	Komponent premenovaný	Prekladový komponent bol premenovaný.
`43`	`moved_component`	Presunutý komponent	Komponent bol presunutý v rámci projektu.
`45`	`contributor_joined`	Prispievateľ sa pripojil	Používateľ vykonal svoj prvý príspevok k prekladu.
`46`	`announcement_posted`	Oznámenie zverejnené	Oznámenie bolo zverejnené.
`47`	`alert_triggered`	Upozornenie spustené	Upozornenie komponentu bolo spustené.
`48`	`language_added`	Jazyk pridaný	Jazykový preklad bol pridaný.
`49`	`language_requested`	Jazyk požadovaný	Používateľ požiadal o nový jazyk.
`50`	`project_created`	Projekt vytvorený	Prekladový projekt bol vytvorený.
`51`	`component_created`	Komponent vytvorený	Prekladový komponent bol vytvorený.
`52`	`user_invited`	Používateľ pozvaný	Používateľ bol pozvaný do projektu.
`53`	`repository_notification_received`	Notifikácia repozitára prijatá	Weblate dostal notifikáciu repozitára od hostiteľa kódu.
`54`	`translation_replaced_file_by_upload`	Preklad nahradený nahratým súborom	Prekladový súbor bol nahradený nahraným súborom.
`55`	`license_changed`	Licencia zmenená	Informácie o licencii projektu alebo komponentu sa zmenili.
`56`	`contributor_license_agreement_changed`	Licenčná zmluva prispievateľa zmenená	Licenčná zmluva prispievateľa bola zmenená.
`57`	`screenshot_added`	Snímka obrazovky pridaná	Snímka obrazovky bola priradená k reťazcu.
`58`	`screenshot_uploaded`	Snímka obrazovky nahraná	Obrázok snímky obrazovky bol nahraný.
`59`	`string_updated_in_the_repository`	Reťazec aktualizovaný v repozitári	Reťazec bol zmenený počas synchronizácie z repozitára.
`60`	`add-on_installed`	Doplnok nainštalovaný	Doplnok bol nainštalovaný.
`61`	`add-on_configuration_changed`	Konfigurácia doplnku zmenená	Konfigurácia doplnku bola zmenená.
`62`	`add-on_uninstalled`	Doplnok odinštalovaný	Doplnok bol odinštalovaný.
`63`	`string_removed`	Reťazec odstránený	Reťazec bol odstránený z prekladu.
`64`	`comment_removed`	Komentár odstránený	Komentár k reťazcu bol odstránený.
`65`	`comment_resolved`	Komentár vyriešený	Komentár k reťazcu bol označený ako vyriešený.
`66`	`explanation_updated`	Vysvetlenie aktualizované	Vysvetlenie pre zdrojový reťazec bolo aktualizované.
`67`	`category_removed`	Kategória odstránená	Kategória komponentu bola odstránená.
`68`	`category_renamed`	Kategória premenovaná	Kategória komponentu bola premenovaná.
`69`	`category_moved`	Kategória presunutá	Kategória komponentu bola presunutá.
`70`	`saving_string_failed`	Ukladanie reťazca zlyhalo	Weblate nemohol uložiť zmenený reťazec.
`71`	`string_added_in_the_repository`	Reťazec pridaný v repozitári	Nový reťazec bol nájdený počas synchronizácie z repozitára.
`72`	`string_updated_in_the_upload`	Reťazec aktualizovaný v nahratí	Reťazec bol zmenený počas spracovania nahraného súboru.
`73`	`string_added_in_the_upload`	Reťazec pridaný v nahratí	Nový reťazec bol nájdený počas spracovania nahraného súboru.
`74`	`translation_updated_by_source_upload`	Preklad aktualizovaný nahratím zdroja	Preklad bol synchronizovaný po nahraní zdrojového súboru.
`75`	`component_translation_completed`	Preklad komponentu dokončený	Všetky jazykové preklady v komponente sa stali úplne preloženými po individuálnej úprave. Automatický preklad, nahrávania a hromadné úpravy túto udalosť nevysielajú.
`76`	`applied_enforced_check`	Aplikovaná vynútená kontrola	Preklad bol označený ako vyžadujúci úpravu vynútenou kontrolou.
`77`	`propagated_change`	Šírená zmena	Úprava prekladu bola šírená na iný zodpovedajúci reťazec.
`78`	`file_uploaded`	Súbor nahraný	Súbor bol nahraný k prekladu.
`79`	`extra_flags_updated`	Dodatočné príznaky aktualizované	Dodatočné príznaky zdrojového reťazca boli aktualizované.
`80`	`font_uploaded`	Písmo nahrané	Písmo bolo nahrané.
`81`	`font_changed`	Písmo zmenené	Nahrané písmo bolo zmenené.
`82`	`font_removed`	Písmo odstránené	Nahrané písmo bolo odstránené.
`83`	`forced_synchronization_of_translations`	Vynútená synchronizácia prekladov	Prekladové súbory boli nútene synchronizované s repozitárom.
`84`	`forced_rescan_of_translations`	Vynútené znovuskenovanie prekladov	Prekladové súbory boli nútene znovuskenované na zmeny.
`85`	`screenshot_removed`	Snímka obrazovky odstránená	Snímka obrazovky bola odstránená.
`86`	`label_added`	Štítok pridaný	Štítok bol pridaný k reťazcu.
`87`	`label_removed`	Štítok odstránený	Štítok bol odstránený z reťazca.
`88`	`repository_cleanup`	Čistenie repozitára	Pracovný strom repozitára bol vyčistený.
`89`	`source_string_added_in_the_upload`	Zdrojový reťazec pridaný v nahratí	Zdrojový reťazec bol pridaný počas spracovania nahraného súboru.
`90`	`source_string_added_in_the_repository`	Zdrojový reťazec pridaný v repozitári	Zdrojový reťazec bol pridaný počas synchronizácie z repozitára.
`91`	`project_backed_up`	Projekt zálohovaný	Záloha projektu bola vytvorená.
`92`	`project_restored`	Projekt obnovený	Projekt bol obnovený zo zálohy.
`93`	`component_restored`	Komponent obnovený	Komponent bol obnovený zo zálohy.
`94`	`user_edit_reverted`	Úprava používateľa vrátená späť	Všetky vybrané úpravy používateľa boli vrátené späť.
`95`	`project_setting_changed`	Nastavenie projektu zmenené	Nastavenie projektu bolo zmenené.
`96`	`component_setting_changed`	Nastavenie komponentu zmenené	Nastavenie komponentu bolo zmenené.
`97`	`user_access_changed`	Prístup používateľa zmenený	Oprávnenia prístupu používateľa boli zmenené.
`98`	`workspace_created`	Pracovný priestor vytvorený	Bol vytvorený pracovný priestor.
`99`	`workspace_setting_changed`	Nastavenie pracovného priestoru zmenené	Nastavenie pracovného priestoru bolo zmenené.
`100`	`project_moved`	Projekt presunutý	Projekt bol presunutý do alebo z pracovného priestoru.
`101`	`remote_repository_updated`	Vzdialený repozitár aktualizovaný	Aktualizácia vzdialeného repozitára bola dokončená.
`102`	`remote_repository_update_failed`	Aktualizácia vzdialeného repozitára zlyhala	Aktualizácia vzdialeného repozitára zlyhala.
`103`	`alert_dismissed`	Upozornenie ignorované	Upozornenie komponentu bolo ignorované.
`104`	`alert_reopened`	Upozornenie znovu otvorené	Upozornenie komponentu bolo znovu otvorené po zmene jeho kontextu.

Prispôsobenie zoznamu doplnkov¶

Zoznam doplnkov je konfigurovaný pomocou WEBLATE_ADDONS. Ak chcete pridať ďalší doplnok, jednoducho zahrňte absolútny názov triedy do tohto nastavenia.

Písanie doplnku¶

Môžete písať aj vlastné doplnky, vytvorte podtriedu weblate.addons.base.BaseAddon na definovanie metadát doplnku a potom implementujte spätné volanie na vykonanie spracovania.

Viď aj

Vývoj doplnkov

Spúšťanie skriptov z doplnku¶

Doplnky sa dajú použiť aj na spúšťanie externých skriptov. Toto bolo predtým integrované vo Weblate, ale teraz musíte napísať nejaký kód, ktorý obalí váš skript doplnkom.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Example pre commit script."""

from __future__ import annotations

from typing import ClassVar

from django.utils.translation import gettext_lazy

from weblate.addons.events import AddonEvent
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events: ClassVar[set[AddonEvent]] = {
        AddonEvent.EVENT_PRE_COMMIT,
    }
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = gettext_lazy("Execute script before commit")
    description = gettext_lazy("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

Pokyny na inštaláciu nájdete v Vlastné kontroly kvality, doplnky, automatické návrhy a automatické opravy.

Skript sa vykonáva s aktuálnym adresárom nastaveným na koreň repozitára VCS pre daný komponent.

Okrem toho sú k dispozícii nasledujúce premenné prostredia:

WL_VCS¶: Použitý systém správy verzií.

WL_REPO¶: URL hlavného repozitára.

WL_PATH¶: Absolútna cesta k repozitáru VCS.

WL_BRANCH¶: Vetva repozitára nakonfigurovaná v aktuálnom komponente.

WL_FILEMASK¶: Maska súboru pre aktuálny komponent.

WL_TEMPLATE¶: Názov súboru šablóny pre jednojazyčné preklady (môže byť prázdny).

WL_NEW_BASE¶: Názov súboru používaného na vytváranie nových prekladov (môže byť prázdny).

WL_FILE_FORMAT¶: Formát súboru použitý v aktuálnom komponente.

WL_LANGUAGE¶: Jazyk práve spracovávaného prekladu (nie je k dispozícii pre háky na úrovni komponentu).

WL_PREVIOUS_HEAD¶: Predchádzajúci HEAD po aktualizácii (dostupné iba po spustení háku po aktualizácii).

WL_COMPONENT_SLUG¶: Slug komponentu použitý na zostavenie URL.

WL_PROJECT_SLUG¶: Slug projektu použitý na zostavenie URL.

WL_COMPONENT_NAME¶: Názov komponentu.

WL_PROJECT_NAME¶: Názov projektu.

WL_COMPONENT_URL¶: URL komponentu.

WL_ENGAGE_URL¶: URL zapojenia projektu.

Viď aj

Konfigurácia komponentu

Spracovanie repozitára po aktualizácii¶

Dá sa použiť na aktualizáciu prekladových súborov, keď sa zmení hlavný zdroj VCS. Aby ste to dosiahli, nezabudnite, že Weblate vidí iba súbory zapísané do VCS, takže musíte zmeny zapísať ako súčasť skriptu.

Napríklad s Gulpom to môžete urobiť pomocou nasledujúceho kódu:

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Spracovanie prekladov pred zápisom¶

Použite skript pred zápisom na automatickú zmenu prekladu predtým, než sa zapíše do repozitára.

Odovzdáva sa ako jeden parameter pozostávajúci z názvu súboru aktuálneho prekladu.

Protokolovanie aktivít doplnku¶

Denník aktivít doplnku sleduje vykonávanie doplnku a dá sa použiť na sledovanie aktivity doplnku.

Každá položka zaznamenáva, či je spracovanie čakajúce, úspešné, zlyhalo alebo bolo preskočené. Preskočené položky obsahujú dôvod, prečo sa doplnok nespustil, napríklad nekompatibilný komponent, žiadne relevantné zmeny alebo nakonfigurovaný plán, ktorý ešte nenastal. Úspešná položka môže stále znamenať, že doplnok skontroloval svoje vstupy, ale nenašiel nič na zmenu.

Pre doplnky s rozsahom, ktoré spracúvajú komponenty nezávisle, denník aktivít obsahuje samostatnú položku pre každý komponent.

Logy je možné po určitom časovom intervale orezať konfiguráciou ADDON_ACTIVITY_LOG_EXPIRY.

Doplnky¶

Udalosti, ktoré spúšťajú doplnky¶

Inštalácia doplnku¶

Aktualizácia komponentu¶

Denne¶

Zmena udalosti¶

Manuálne spustenie¶

Repozitár po pridaní¶

Repozitár po zápise¶

Repozitár po pushi¶

Repozitár po odstránení¶

Repozitár po aktualizácii¶

Repozitár pred zápisom¶

Repozitár pred pushom¶

Repozitár pred aktualizáciou¶

Jednotka po uložení¶

Jednotka po synchronizácii¶

Jednotka pred vytvorením¶

Vstavané doplnky¶

Hodnotenie kvality AI¶

Automatizácia¶

Automatický preklad¶

CDN pre lokalizáciu JavaScriptu¶

Prekladové súbory CDN¶

Kotlin SDK CDN¶

Nastavenia životného cyklu¶

Kontrakt klienta CDN¶

Odstrániť prázdne reťazce¶

Vyčistiť súbory prekladov¶

Pridať chýbajúce jazyky¶

Objavovanie komponentov¶

Požiadavky na objavovanie¶

Objavovanie komponentov bez prekladových súborov¶

Pracovný príklad: news_<lang>.md¶

Príklady objavovania komponentov¶

Jeden priečinok na jazyk¶

Rozloženie gettext locales¶

Zložité názvy súborov¶

Opakovaný kód jazyka¶

Rozdeliť Android reťazce¶

Zodpovedanie viacerých ciest¶

Fedora Messaging¶

Téma správy¶

Telo správy¶

Hlavičky správy¶

Príklady správ¶

Hromadná úprava¶

Označiť nezmenené preklady ako „Vyžaduje prepísanie“¶

Označiť nové zdrojové reťazce ako „Vyžaduje kontrolu“¶

Označiť nové preklady ako „Vyžaduje prepísanie“¶

Označiť aktualizované preklady z repozitára ako „Vyžaduje prepísanie“¶

Vyplniť reťazce iba na čítanie zdrojom¶

Generátor štatistík¶

Výstup v rámci celého komponentu¶

Predvyplniť preklad zdrojom¶

Generovanie pseudolokálu¶

Aktualizovať premennú ALL_LINGUAS v súbore „configure“¶

Prispôsobiť výstup gettextu¶

Aktualizovať gettext šablónu (Django)¶

Požiadavky Django¶

Aktualizovať súbor LINGUAS¶

Aktualizovať súbor POT (Meson)¶

Požiadavky Meson¶

Generovať súbory MO¶

Aktualizovať súbory PO tak, aby zodpovedali POT (msgmerge)¶

Aktualizovať súbor POT (Sphinx)¶

Požiadavky Sphinx¶

Aktualizovať súbor POT (xgettext)¶

Požiadavky xgettext¶

Zmiešané formáty zdroja a pravidlá ITS¶

Zlúčiť Git zápisy¶

Prispôsobiť výstup JSON¶

Obnoviť na hlavný repozitár¶

Formátovať súbor Java properties¶

Odstránenie zastaraných komentárov¶

Odstránenie zastaraných návrhov¶

Aktualizovať súbory RESX¶

Slack Webhooky¶

Webhook¶

Zastarané doplnky¶

Pracovný príklad: `news_<lang>.md`¶