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

  1. Udeliť Weblate prístup k repozitáru.

  2. Nakonfigurujte Repozitár zdrojového kódu, aby Weblate mohol klonovať repozitár.

  3. 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.

  4. 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.

  5. 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

Systém verziovania

URL odoslania repozitára

Vetva odoslania

Žiadne odoslanie

Git

prázdne

prázdne

Odoslať priamo

Git

SSH URL

prázdne

Odoslať do samostatnej vetvy

Git

SSH URL

Názov vetvy

Žiadne odoslanie

Mercurial

prázdne

prázdne

Odoslať priamo

Mercurial

SSH URL

prázdne

GitHub pull request z forku

GitHub pull requesty

prázdne

prázdne

GitHub pull request z vetvy

GitHub pull requesty

SSH URL [1]

Názov vetvy

GitLab merge request z forku

GitLab merge requesty

prázdne

prázdne

GitLab merge request z vetvy

GitLab merge requesty

SSH URL [1]

Názov vetvy

Gitea merge request z forku

Gitea pull requesty

prázdne

prázdne

Gitea merge request z vetvy

Gitea pull requesty

SSH URL [1]

Názov vetvy

Pagure merge request z forku

Pagure merge requesty

prázdne

prázdne

Pagure merge request z vetvy

Pagure merge requesty

SSH URL [1]

Názov vetvy

Azure DevOps pull request z forku

Azure DevOps pull requesty

prázdne

prázdne

Azure DevOps pull request z vetvy

Azure DevOps pull requesty

SSH URL [1]

Názov vetvy

Gerrit recenzia

Gerrit recenzné požiadavky

SSH URL

Názov cieľovej vetvy (voliteľné)

Bitbucket Data Center pull request z forku

Bitbucket Data Center pull requesty

prázdne

prázdne

Bitbucket Data Center pull request z vetvy

Bitbucket Data Center pull requesty

SSH URL [1]

Názov vetvy

Bitbucket Cloud pull request z forku

Bitbucket Cloud pull requesty

prázdne

prázdne

Bitbucket Cloud pull request z vetvy

Bitbucket Cloud pull requesty

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:

  1. Vytvorte osobný prístupový token, ako je popísané v Vytvorenie prístupového tokenu pre použitie z príkazového riadku.

  2. 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:

  1. Prihláste sa do Weblate s účtom, ktorý má prístup na správu.

  2. Otvorte Spravovať → Pripojenia hosťovania kódu → Zaregistrovať aplikáciu Weblate GitHub.

  3. 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.

  4. 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ť).

  5. 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:

../_images/github-settings.png

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

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/.

../_images/bitbucket-settings.png

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:

../_images/pagure-webhook.png

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.