Integrácie s platformami na hosťovanie kódu¶
Weblate sa integruje so stránkami na hosťovanie kódu na niekoľkých samostatných miestach: prístup k repozitáru, prichádzajúce oznámenia a odosielanie prekladov späť. Presné nastavenie závisí od toho, či používate Hosted Weblate alebo prevádzkujete vlastnú inštanciu Weblate, a od toho, či má Weblate odosielať priamo alebo vytvárať pull alebo merge requesty.
Použite túto stránku ako kontrolný zoznam orientovaný na poskytovateľa. Jednotlivé stránky nastavení zostávajú kanonickou referenciou pre syntax nastavení.
Prehľad nastavenia¶
Udeliť Weblate prístup k repozitáru.
Pre repozitáre GitHub na Hosted Weblate použite aplikáciu Hosted Weblate z toku Weblate Pripojiť účet GitHub. Aplikácia dáva Hosted Weblate prístup k repozitáru bez nutnosti pozvať hosťovaného používateľa weblate.
Pre iné repozitáre Hosted Weblate a pre priame SSH odosielania mimo toku aplikácie GitHub pridajte hosťovaného používateľa weblate tam, kde je dostupný, pozri Prístup k repozitárom z Hosted Weblate.
Pre samoobslužné Weblate vytvorte špecializovaného používateľa na hosťovanie kódu a udeľte prístup pomocou SSH kľúča Weblate alebo HTTPS tokenu, pozri Prístup k repozitárom na stránkach na hosťovanie kódu (GitHub, GitLab, Bitbucket, Azure DevOps, …).
Nakonfigurujte Repozitár zdrojového kódu, aby Weblate mohol klonovať repozitár.
Nakonfigurujte prichádzajúce notifikácie tak, aby Weblate stiahol zmeny krátko po odoslaní (push). Webhook alebo aplikácia repozitára musí smerovať na zodpovedajúcu URL háku Weblate a projekt musí mať povolené Povoliť háky. Repozitár zdrojového kódu komponentu sa musí zhodovať s URL repozitára z obsahu webhooku; pozrite Zhodné ciele webhookov.
Rozhodnite, ako má Weblate odosielať preklady späť:
Použite Git alebo Mercurial a URL odoslania repozitára na priame odoslanie.
Použite VCS backend špecifický pre poskytovateľa, ako napríklad GitHub alebo GitLab, na vytvorenie pull alebo merge requestov. Tieto backendy potrebujú poverenia API v nastaveniach Weblate.
Voliteľne nastavte Vetva odoslania, keď má Weblate odosielať do vetvy v hlavnom repozitári namiesto použitia forku, kde je to podporované.
Odosielanie zmien z Weblate¶
Každý prekladový komponent môže mať nastavenú URL odoslania (pozri URL odoslania repozitára) a v takom prípade bude Weblate schopný odosielať zmeny do vzdialeného repozitára. Weblate je možné nakonfigurovať aj na automatické odosielanie zmien pri každom zápise; toto je predvolene povolené, pozri Odoslať pri zápise.
Ak nechcete, aby sa zmeny odosielali automaticky, môžete odosielať manuálne v Údržba repozitára alebo pomocou API cez wlc push.
V prípade, že nechcete priame odosielania Weblate, existuje podpora pre GitHub pull requesty, GitLab merge requesty, Gitea pull requesty, Pagure merge requesty, Azure DevOps pull requesty alebo Gerrit recenzné požiadavky recenzie. Tieto môžete aktivovať výberom GitHub, GitLab, Gitea, Gerrit, Azure DevOps alebo Pagure ako Systém verziovania v Konfigurácia komponentu.
Celkovo sú dostupné nasledujúce možnosti s Git, Mercurial, GitHub, GitLab, Gitea, Pagure, Azure DevOps, Gerrit, Bitbucket Data Center a Bitbucket Cloud:
Požadované nastavenie |
|||
|---|---|---|---|
Žiadne odoslanie |
prázdne |
prázdne |
|
Odoslať priamo |
SSH URL |
prázdne |
|
Odoslať do samostatnej vetvy |
SSH URL |
Názov vetvy |
|
Žiadne odoslanie |
prázdne |
prázdne |
|
Odoslať priamo |
SSH URL |
prázdne |
|
GitHub pull request z forku |
prázdne |
prázdne |
|
GitHub pull request z vetvy |
SSH URL [1] |
Názov vetvy |
|
GitLab merge request z forku |
prázdne |
prázdne |
|
GitLab merge request z vetvy |
SSH URL [1] |
Názov vetvy |
|
Gitea merge request z forku |
prázdne |
prázdne |
|
Gitea merge request z vetvy |
SSH URL [1] |
Názov vetvy |
|
Pagure merge request z forku |
prázdne |
prázdne |
|
Pagure merge request z vetvy |
SSH URL [1] |
Názov vetvy |
|
Azure DevOps pull request z forku |
prázdne |
prázdne |
|
Azure DevOps pull request z vetvy |
SSH URL [1] |
Názov vetvy |
|
Gerrit recenzia |
SSH URL |
Názov cieľovej vetvy (voliteľné) |
|
Bitbucket Data Center pull request z forku |
prázdne |
prázdne |
|
Bitbucket Data Center pull request z vetvy |
SSH URL [1] |
Názov vetvy |
|
Bitbucket Cloud pull request z forku |
prázdne |
prázdne |
|
Bitbucket Cloud pull request z vetvy |
SSH URL [1] |
Názov vetvy |
GitHub¶
Prístup k repozitáru GitHub¶
Aplikácia GitHub Hosted Weblate¶
Na Hosted Weblate je odporúčané nastavenie pripojiť aplikáciu Hosted Weblate z pracovného priestoru Weblate, kde sa nachádza váš projekt. Použite tok Pripojiť účet GitHub, nainštalujte aplikáciu na používateľa alebo organizáciu GitHub, ktorá vlastní vaše repozitáre, udeľte jej prístup k repozitárom, ktoré chcete prekladať, a importujte komponenty z pripojeného účtu GitHub.
Tok podporovaný aplikáciou používa inštalačné prístupové tokeny GitHub na klonovanie, odosielanie prekladových vetiev, vytváranie pull requestov a prijímanie prichádzajúcich oznámení. Nemusíte pozývať používateľa GitHub weblate Hosted Weblate ani konfigurovať samostatný webhook repozitára pre komponenty importované týmto spôsobom.
Používajte používateľa GitHub weblate Hosted Weblate iba vtedy, keď zámerne konfigurujete priame SSH odosielania mimo toku aplikácie GitHub, pozri Prístup k repozitárom z Hosted Weblate.
HTTPS s osobným prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
Na použitie tohto prístupu:
Vytvorte osobný prístupový token, ako je popísané v Vytvorenie prístupového tokenu pre použitie z príkazového riadku.
Zahrňte token do URL vášho repozitára:
https://username:token@github.com/owner/repo.git.
Toto je vhodné, keď začínate s Weblate alebo pracujete s jedným repozitárom.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Pre GitHub vytvorte špecializovaného používateľa, napríklad weblate-bot, a použite SSH URL GitHub pre vaše repozitáre, napríklad git@github.com:owner/repo.git.
Na Hosted Weblate používajte tento tok SSH-používateľa iba pre priame SSH odosielania mimo odporúčaného toku aplikácie Hosted Weblate.
Poznámka
Pri použití GitHub pre pull requesty, konfigurácia Vetva odoslania ovplyvňuje správanie: ak nie je nastavená, projekt sa forkuje a zmeny sa odosielajú cez fork. Ak je nastavená, zmeny sa odosielajú do hlavného repozitára a zvolenej vetvy.
Oznámenia GitHub¶
Weblate prichádza s natívnou podporou pre GitHub.
Ak používate Hosted Weblate, použite aplikáciu Hosted Weblate z toku Weblate Pripojiť účet GitHub. Používa webhooks aplikácie GitHub, takže nemusíte konfigurovať samostatný Webhook v GitHube. Komponenty importované z pripojeného účtu GitHub tiež používajú aplikáciu na prístup k repozitáru a pull requesty, bez pozvania používateľa GitHub weblate Hosted Weblate.
Stará aplikácia Hosted Weblate je zachovaná pre existujúce nastavenia iba s webhookmi. Jej doručenia používajú všeobecnú URL webhooku GitHub a sú autentifikované pomocou samostatného tajomstva webhooku nakonfigurovaného operátorom Hosted Weblate. Použite ju iba vtedy, keď potrebujete, aby stará aplikácia doručovala oznámenia GitHub do Hosted Weblate.
Pre samoobslužné Weblate zaregistrujte aplikáciu GitHub pomocou toku registrácie v aplikácii popísaného nižšie. Weblate vygeneruje manifest aplikácie, GitHub vráti poverenia a tie sa uložia do databázy - neexistuje žiadna konfigurácia založená na nastaveniach.
Registrácia aplikácie GitHub z Weblate¶
Najrýchlejší spôsob pridania aplikácie GitHub je nechať Weblate vygenerovať manifest aplikácie GitHub s predvyplnenými správnymi oprávneniami, udalosťami a URL webhooku:
Prihláste sa do Weblate s účtom, ktorý má prístup na správu.
Otvorte Spravovať → Pripojenia hosťovania kódu → Zaregistrovať aplikáciu Weblate GitHub.
Vyplňte formulár. Hostiteľ GitHub je predvolene
github.com; zmeňte ho na názov hostiteľa vášho GitHub Enterprise, ak je to potrebné. Nechajte Organizácia prázdne na registráciu aplikácie pod vaším osobným účtom, alebo zadajte slug organizácie na registráciu pod touto organizáciou.Kliknite na Pokračovať na GitHub a potvrďte na stránke GitHub Vytvoriť aplikáciu GitHub (tam môžete aplikáciu stále premenovať).
GitHub presmeruje späť na Weblate, ktoré vymení dočasný kód za ID aplikácie, súkromný kľúč, tajomstvo webhooku a slug a uloží ich do databázy. Tlačidlo Pripojiť účet GitHub je dostupné okamžite potom.
The manifest requests the permissions and event subscriptions Weblate needs
(Contents and Pull requests read/write, Metadata read-only,
Organization administration read-only, Workflows read/write, and the
Installation, Meta, Push and Repository events), and sets the
callback, setup and per-app webhook URLs automatically, so no manual GitHub App
configuration is required. GitHub delivers the Installation and
Installation repositories events to all GitHub Apps by default.
GitHub ponúka iba účty, kde môže prihlásený používateľ GitHub nainštalovať alebo požiadať o aplikáciu. Ak sa organizácia nezobrazuje počas toku inštalácie, skontrolujte rolu používateľa v organizácii a obmedzenia inštalácie aplikácie GitHub organizácie. Na GitHub.com môžu byť verejné aplikácie nainštalované na iných účtoch; súkromné aplikácie môžu byť nainštalované iba na účte, ktorý vlastní aplikáciu.
Pripojenie pracovného priestoru¶
Pripojené účty GitHub sú viazané na pracovný priestor Weblate. Používateľ s právami na správu projektu pre akýkoľvek projekt v pracovnom priestore môže pripojiť účet GitHub v tomto pracovnom priestore. Po pripojení môže každý projekt v pracovnom priestore importovať komponenty z repozitárov, ku ktorým má inštalácia aplikácie GitHub prístup. Pre účty organizácií Weblate overuje, či používateľ GitHub v čase inštalácie môže spravovať inštaláciu organizácie.
Projekty, ktoré nie sú v pracovnom priestore, nemôžu pripojiť účet GitHub prostredníctvom aplikácie GitHub.
Odstránenie pripojeného účtu GitHub tiež odinštaluje aplikáciu z GitHubu, ak ju nepoužíva žiadny iný pracovný priestor Weblate. Ak iný pracovný priestor stále používa inštaláciu, Weblate odstráni iba vybrané spojenie pracovného priestoru. Komponenty importované prostredníctvom tohto spojenia stratia prístup k svojim repozitárom. Odstránenie pracovného priestoru odinštaluje jeho pripojené účty rovnakým spôsobom.
Weblate odstráni spojenie aj vtedy, keď GitHub už nevie o inštalácii, a ponechá ho iba vtedy, keď sa GitHub nedal dosiahnuť, aby sa odstránenie mohlo opakovať.
Komponenty importované prostredníctvom toku aplikácie GitHub používajú špecializovaný VCS backend GitHub (cez aplikáciu Weblate GitHub). Používateľské rozhranie nastavení komponentu udržuje URL repozitára iba na čítanie, aby sa zabránilo presmerovaniu poverení vydaných aplikáciou na nesúvisiaci repozitár.
Migrácia existujúcich komponentov¶
Weblate hlási informačnú diagnostiku pre Git a GitHub pull request komponenty, ktoré je možné migrovať na registrovanú aplikáciu Weblate GitHub. Postupujte podľa odkazu Migrovať na aplikáciu GitHub z diagnostiky a skontrolujte všetky oprávnené komponenty v pracovnom priestore.
Pripojte alebo aktualizujte účet GitHub pre pracovný priestor, udeľte aplikácii prístup k uvedeným repozitárom a vyberte komponenty na migráciu. Weblate zmení vybrané komponenty na VCS backend GitHub (cez aplikáciu Weblate GitHub), nahradí ich adresy repozitárov kanonickými HTTPS URL na klonovanie a odstráni samostatné URL na odosielanie, pretože aplikácia autentifikuje odosielania do zdrojového repozitára.
URL webhooku aplikácie¶
Každá zaregistrovaná aplikácia Weblate GitHub má vlastnú URL webhooku obsahujúcu nepriehľadný token, ktorý jedinečne identifikuje jednu zaregistrovanú aplikáciu:
https://weblate.example.com/hooks/integrations/<webhook_token>/
Komponenty používajúce backend VCS GitHub (cez aplikáciu Weblate GitHub) sú porovnávané iba cez tento vyhradený koncový bod. Všetky všeobecné koncové body webhookov foriem ich vylučujú z porovnávania a diagnostiky odpovedí, vrátane /hooks/github/. Doručenia staršej aplikácie GitHub App odoslané na všeobecný koncový bod sa môžu zhodovať len s komponentmi používajúcimi backend VCS, ktorý nie je založený na aplikácii.
When a repository is renamed or transferred on GitHub, the Repository
event makes Weblate refresh the repositories of the connected GitHub account
and point the affected components to the new repository URL. Apps registered
before Weblate 2026.10.1 are not subscribed to this event; enable
Repository under Subscribe to events in the App
settings on GitHub.
Refreshing repositories of a connected GitHub account retargets such
components too, for example when the event was missed. Use
refresh_github_repositories to do this for all connected GitHub
accounts at once.
Ak nepoužívate aplikáciu GitHub, pridajte webhook Weblate v nastaveniach repozitára (Webhooky) na prijímanie oznámení pri každom odoslaní do repozitára GitHub, ako je znázornené na obrázku nižšie:
URL adresa payloadu pozostáva z vašej URL Weblate doplnenej o /hooks/github/, napríklad pre službu Hosted Weblate je to https://hosted.weblate.org/hooks/github/.
Ostatné hodnoty môžete ponechať na predvolených nastaveniach. Weblate dokáže spracovať oba typy obsahu a spotrebúva iba udalosť odoslanie.
GitHub pull requesty¶
Toto pridáva tenkú vrstvu nad Git používajúcu GitHub API, ktorá umožňuje odosielať zmeny prekladu ako pull requesty namiesto priameho odosielania do repozitára.
Git odosiela zmeny priamo do repozitára, zatiaľ čo backend GitHub vytvára pull requesty. Ten nie je potrebný na samotný prístup k repozitárom Git.
Na vytvorenie pull requestov vyberte GitHub ako Systém verziovania a nakonfigurujte GITHUB_CREDENTIALS. Pre GitHub.com použite api.github.com ako hostiteľa API. Token musí umožňovať Weblate čítať a zapisovať obsah repozitára a vytvárať pull requesty. Ak má Weblate forkovať súkromné repozitáre, token môže potrebovať aj prístup na správu.
If creating a pull request fails with 404 Not Found, GitHub can be refusing
API access even when the repository is readable. Weblate checks the repository’s
pull request creation policy and, for user tokens, the authenticated account.
The failure alert reports confirmed findings and provides further checks when
the cause remains unknown. Diagnostic lookup failures preserve the original
pull request error.
Check that the effective API token belongs to the intended fork owner and allows creating pull requests. For fine-grained tokens, check repository selection, resource owner, and Pull requests write permission. Also check organization restrictions and access to the source branch. For GitHub Apps, check installation access to the repositories and pull request permissions. A successful Git push does not verify API access: pushing can use a separate SSH key. The repository log includes GitHub’s request ID and permission headers when available to help investigate the failure. Accepted permission headers describe endpoint requirements, not the permissions granted to the token.
GitLab¶
Prístup k repozitáru GitLab¶
HTTPS s osobným alebo projektovým prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
Pre GitLab token potrebuje rozsah write_repository, aby mohol odosielať zmeny do repozitára. Projektový prístupový token vyžaduje rolu Developer na odosielanie.
URL musí obsahovať používateľské meno. Pre osobný prístupový token je to skutočné používateľské meno: https://user:personal_access_token@gitlab.com/example/example.git. Pre projektové prístupové tokeny to môže byť neprázdna hodnota: https://example:project_access_token@gitlab.com/example/example.git.
Poznámka
Pravidlá pre používanie projektových prístupových tokenov sa zmenili medzi vydaniami GitLab, neprázdna hodnota je aktuálna požiadavka, ale staršie verzie mali iné očakávania (názov projektu, meno bota). Ak si nie ste istí, skontrolujte dokumentáciu GitLab zodpovedajúcu vašej verzii.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Pre GitLab vytvorte špecializovaného používateľa a použite SSH URL GitLab, napríklad git@gitlab.com:group/project.git.
Pre repozitáre Hosted Weblate na GitLab pridajte hosťovaného používateľa weblate s požadovanými oprávneniami repozitára, pozri Prístup k repozitárom z Hosted Weblate.
Oznámenia GitLab¶
Weblate má podporu pre háky GitLab. Pridajte webhook projektu s cieľom na URL /hooks/gitlab/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/gitlab/.
Riešenie problémov
Skontrolujte históriu požiadaviek webhooku GitLab, či sú webhooks doručované.
Payload odpovede obsahuje informácie o zodpovedajúcich komponentoch.
GitLab merge requesty¶
Toto pridáva tenkú vrstvu nad Git používajúcu GitLab API, ktorá umožňuje odosielať zmeny prekladu ako merge requesty namiesto priameho odosielania do repozitára.
Nie je potrebné toto používať na prístup k repozitárom Git, bežný Git funguje rovnako, jediný rozdiel je v tom, ako sa spracúva odosielanie do repozitára. S Git sa zmeny odosielajú priamo do repozitára, zatiaľ čo backend GitLab vytvára merge request.
Na vytvorenie merge requestov vyberte GitLab ako Systém verziovania a nakonfigurujte GITLAB_CREDENTIALS.
Konfigurácia Vetva odoslania ovplyvňuje, kam Weblate odosiela zmeny pred otvorením merge requestu. Ak nie je nastavená, projekt sa forkuje a zmeny sa odosielajú cez fork. Ak je nastavená, zmeny sa odosielajú do hlavného repozitára a zvolenej vetvy.
Gitea, Forgejo a Codeberg¶
Prístup k repozitáru Gitea, Forgejo a Codeberg¶
HTTPS s prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Pre repozitáre Hosted Weblate na Codeberg pridajte hosťovaného používateľa weblate s požadovanými oprávneniami repozitára, pozri Prístup k repozitárom z Hosted Weblate.
Oznámenia Gitea¶
Weblate má podporu pre webhooks Gitea. Pridajte Webhook Gitea pre udalosť Udalosti odoslania s cieľom na URL /hooks/gitea/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/gitea/. Toto je možné urobiť v Webhooky pod Nastavenia repozitára.
Oznámenia Forgejo¶
Weblate má podporu pre webhooks Forgejo. Pridajte Webhook Forgejo pre udalosť Udalosti odoslania s cieľom na URL /hooks/forgejo/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/forgejo/. Toto je možné urobiť v Webhooky pod Nastavenia repozitára.
Gitea pull requesty¶
Added in version 4.12.
Toto pridáva tenkú vrstvu nad Git používajúcu Gitea API, ktorá umožňuje odosielať zmeny prekladu ako pull requesty namiesto priameho odosielania do repozitára.
Nie je potrebné toto používať na prístup k repozitárom Git, bežný Git funguje rovnako, jediný rozdiel je v tom, ako sa spracúva odosielanie do repozitára. S Git sa zmeny odosielajú priamo do repozitára, zatiaľ čo backend Gitea vytvára pull requesty.
Na vytvorenie pull requestov vyberte Gitea ako Systém verziovania a nakonfigurujte GITEA_CREDENTIALS.
Bitbucket¶
Prístup k repozitáru Bitbucket¶
HTTPS s prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Pre repozitáre Hosted Weblate na Bitbucket pridajte hosťovaného používateľa weblate s požadovanými oprávneniami repozitára, pozri Prístup k repozitárom z Hosted Weblate.
Na priame odoslanie použite Git alebo Mercurial s URL odoslania repozitára.
Oznámenia Bitbucket¶
Weblate má podporu pre webhooks Bitbucket. Pridajte webhook, ktorý sa spustí pri odoslaní repozitára, s cieľom na URL /hooks/bitbucket/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/bitbucket/.
Bitbucket Data Center pull requesty¶
Added in version 4.16.
Toto pridáva tenkú vrstvu nad Git používajúcu Bitbucket Data Center API, ktorá umožňuje odosielať zmeny prekladu ako pull requesty namiesto priameho odosielania do repozitára.
Varovanie
Toto nepodporuje Bitbucket Cloud API.
Nie je potrebné toto používať na prístup k repozitárom Git, bežný Git funguje rovnako, jediný rozdiel je v tom, ako sa spracúva odosielanie do repozitára. S Git sa zmeny odosielajú priamo do repozitára, zatiaľ čo backend Bitbucket Data Center vytvára pull request.
Na vytvorenie pull requestov vyberte Bitbucket Data Center ako Systém verziovania a nakonfigurujte BITBUCKETSERVER_CREDENTIALS.
Bitbucket Cloud pull requesty¶
Added in version 5.8.
Toto pridáva tenkú vrstvu nad Git používajúcu Bitbucket Cloud API, ktorá umožňuje odosielať zmeny prekladu ako pull requesty namiesto priameho odosielania do repozitára.
Varovanie
Toto je odlišné od Bitbucket Data Center API.
Nie je potrebné toto používať na prístup k repozitárom Git, bežný Git funguje rovnako, jediný rozdiel je v tom, ako sa spracúva odosielanie do repozitára. S Git sa zmeny odosielajú priamo do repozitára, zatiaľ čo backend Bitbucket Cloud vytvára pull request.
Na vytvorenie pull requestov vyberte Bitbucket Cloud ako Systém verziovania a nakonfigurujte BITBUCKETCLOUD_CREDENTIALS.
Azure DevOps¶
Prístup k repozitáru Azure Repos¶
HTTPS s prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
Použite HTTPS URL klonovania zobrazenú Azure Repos pre repozitár.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Použite SSH URL zobrazenú Azure Repos pre repozitár.
Oznámenia Azure Repos¶
Weblate má podporu pre webhooks Azure Repos. Pridajte webhook pre udalosť Kód odoslaný s cieľom na URL /hooks/azure/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/azure/. Toto je možné urobiť v Servisné háky pod Nastavenia projektu.
Azure DevOps pull requesty¶
Toto pridáva tenkú vrstvu nad Git používajúcu Azure DevOps API, ktorá umožňuje odosielať zmeny prekladu ako pull requesty namiesto priameho odosielania do repozitára.
Git odosiela zmeny priamo do repozitára, zatiaľ čo backend Azure DevOps vytvára pull requesty. Ten nie je potrebný na samotný prístup k repozitárom Git.
Na vytvorenie pull requestov vyberte Azure DevOps ako Systém verziovania a nakonfigurujte AZURE_DEVOPS_CREDENTIALS.
Pagure¶
Prístup k repozitáru Pagure¶
HTTPS s prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Oznámenia Pagure¶
Weblate má podporu pre háky Pagure. Pridajte webhook s cieľom na URL /hooks/pagure/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/pagure/. Toto je možné urobiť v Aktivovať Web-hooky pod Možnosti projektu:
Pagure merge requesty¶
Added in version 4.3.2.
Toto pridáva tenkú vrstvu nad Git používajúcu Pagure API, ktorá umožňuje odosielať zmeny prekladu ako merge requesty namiesto priameho odosielania do repozitára.
Nie je potrebné toto používať na prístup k repozitárom Git, bežný Git funguje rovnako, jediný rozdiel je v tom, ako sa spracúva odosielanie do repozitára. S Git sa zmeny odosielajú priamo do repozitára, zatiaľ čo backend Pagure vytvára merge request.
Na vytvorenie merge requestov vyberte Pagure ako Systém verziovania a nakonfigurujte PAGURE_CREDENTIALS.
Iné toky¶
Prístup k repozitáru Gitee¶
HTTPS s prístupovým tokenom¶
Pre jeden súkromný repozitár je prístup cez HTTPS s prístupovým tokenom zvyčajne najjednoduchším nastavením, ak poskytovateľ podporuje Git cez HTTPS. Použite používateľské meno a token požadované poskytovateľom v Repozitár zdrojového kódu.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Token potrebuje prístup na čítanie pre klonovanie a prístup na zápis pre odosielanie. Backend-y VCS špecifické pre poskytovateľa, ktoré vytvárajú pull alebo merge requesty, môžu vyžadovať samostatné poverenia API.
SSH so špecializovaným používateľom¶
Pre nastavenia s viacerými repozitármi použite SSH prístup s vyhradeným používateľom pre hosťovanie kódu pre Weblate. Pridajte verejný SSH kľúč Weblate tomuto používateľovi, udeľte mu prístup k repozitárom a použite SSH URL v Repozitár zdrojového kódu, napríklad git@example.com:group/project.git.
Nakonfigurujte URL odoslania repozitára iba vtedy, keď má Weblate odosielať zmeny priamo alebo keď zvolený pracovný postup vyžaduje URL na odosielanie, pozrite Odosielanie zmien z Weblate.
Tým sa tiež predchádza obmedzeniam poskytovateľa týkajúcim sa opätovného použitia SSH kľúča. Niektoré stránky na hosťovanie kódu umožňujú pridať verejný SSH kľúč iba raz, alebo iba jednému používateľovi či položke deploy kľúča. Udržanie SSH kľúča Weblate na vyhradenom používateľovi umožňuje udelíť tomuto používateľovi prístup k viacerým repozitárom bez opakovaného použitia kľúča na viacerých miestach.
Tým sa osobné, projektové alebo prístupové tokeny API udržia mimo URL repozitárov. Poverenia API poskytovateľa sú stále potrebné pri použití backend-u VCS špecifického pre poskytovateľa na vytvorenie pull alebo merge requestov; tieto poverenia sa konfigurujú oddelene od URL Git repozitára.
Oznámenia Gitee¶
Weblate má podporu pre webhooks Gitee. Pridajte WebHook pre udalosť Odoslanie s cieľom na URL /hooks/gitee/ vo vašej inštalácii Weblate, napríklad https://hosted.weblate.org/hooks/gitee/. Toto je možné urobiť v WebHooky pod Správa repozitára.
Gerrit recenzné požiadavky¶
Podpora Gerrit pridáva tenkú vrstvu nad Git používajúcu nástroj git-review, ktorá umožňuje odosielať zmeny prekladu ako recenzné požiadavky Gerrit namiesto priameho odosielania do repozitára.
Voliteľné nastavenie Vetva odoslania vyberá cieľovú vetvu pre recenziu Gerrit. Nechajte ho prázdne na použitie Vetva repozitára. Použite krátky názov vetvy, ako napríklad main; Weblate a git-review odosielajú recenziu na refs/for/<branch> automaticky. Možnosti odoslania Gerrit môžu byť pripojené za % v ktoromkoľvek nastavení, napríklad main%topic=l10n. Gerrit interpretuje tieto možnosti ako nakonfigurovaný účet Weblate Gerrit a aplikuje svoje vlastné oprávnenia.
Dokumentácia Gerrit obsahuje podrobnosti o konfigurácii potrebnej na nastavenie takýchto repozitárov. Pre tento backend neexistuje samostatné nastavenie poverení na hosťovanie kódu.
Poverenia Docker¶
V prípade inštalácií v Dockeri je možné poverenia API pre hosting kódu poskytnúť aj prostredníctvom premenných prostredia, pozrite Poverenia pre stránky na hosťovanie kódu.