GitHub (Strings)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Tip

Informace o integraci GitHub v Phrase TMS naleznete v GitHub (TMS).

Phrase Strings se integruje s úložišti GitHub pro synchronizaci lokalizačních souborů mezi Phrase a GitHub.

Ve výchozím nastavení jsou úložiště připojena pomocí GitHub OAuth App. Osobní přístup tokeny jsou také podporovány a jsou určeny hlavně pro self-hosted instance nebo prostředí, kde není instalace OAuth App možná.

Předpoklady

Konfigurační soubor .phrase.yml configuration musí být přítomen v kořenovém adresáři větve, která má být monitorována. Soubor definuje, které soubory chcete importovat (pull) nebo exportovat (push) z úložiště.
Úložiště vyžaduje přístup pro čtení i zápis.
Nesprávně definované konfigurační soubory mohou způsobit chyby. Ujistěte se, že soubor obsahuje alespoň jeden cíl pro push a pull, správné formáty souborů a správné nastavení parametru update_translations.
GitHub OAuth App:
- GitHub OAuth App musí být nainstalována v organizaci nebo uživatelském účtu GitHub, kterému úložiště patří.
- Úložiště musí být zahrnuto v instalaci OAuth App.
- V cílové organizaci nebo uživatelském účtu jsou vyžadována oprávnění k instalaci nebo autorizaci GitHub Apps.
GitHub přístup token:
- Klasické tokeny
  
  Vyžaduje rozsah repo (public_repo při synchronizaci s veřejným úložištěm)
- Tokeny s jemným nastavením oprávnění
  
  Vyžaduje následující oprávnění:
  - Obsah: Čtení a zápis
  - Žádosti o sloučení (Pull requests): Čtení a zápis
- Ujistěte se, že nastavení úložiště nevyžaduje podepsané revize.
Pokud je v GitHubu povoleno SSO, musí být povoleno i pro přístupový token.
Větev phrase_translations nelze ochránit.

Poznámka

Z důvodu kontinuálního vylepšování nemusí uživatelské rozhraní vypadat stejně jako na videu.

Připojit úložiště

Jakmile je konfigurační soubor na svém místě, připojte úložiště podle následujících kroků:

Na stránce Integrace přejděte dolů na Repo Sync a klikněte na Konfigurovat.

Otevře se stránka Repo Syncs.
Klikněte na přidat synchronizaci/GitHub.

Otevře se okno nastavení synchronizace GitHub.
Vybrat projekt ze seznamu.
Vybrat metodu ověřování:
- GitHub App (doporučeno)
  
  Pokud ještě není GitHub App nainstalována, klikněte na ověřování. Ověřování se provádí jednou a lze jej znovu použít pro více synchronizací úložiště.
  
  Pokud je GitHub App již nainstalována, klikněte na Spravovat instalaci a Dokončit instalaci aplikace pro cílovou organizaci nebo uživatelský účet. Přístup k úložišti se spravuje na úrovni organizace nebo uživatelského účtu a není vázán na jednotlivého uživatele GitHub.
- Osobní přístupový token
  
  Zadejte osobní token pro přístup k úložišti s rozsahem API.
  
  Při použití osobního přístupového tokenu závisí přístup k úložišti na uživateli GitHub, který token vytvořil.
- Samostatně hostovaná relace
  
  Zadejte vlastní koncový bod API GitHub a osobní token pro přístup k úložišti s rozsahem API.
Vybrat úložiště GitHub ze seznamu.
Vybrat větev úložiště ze seznamu, ze kterého se má provést import (push) a export (pull). Obvykle se jedná o hlavní větev.
Volitelně zadejte název větve pro požadavek na stažení (pull request). Pokud zůstane prázdný, vytvoří se větev s výchozí hodnotou phrase-translations.
Klikněte na Ověřit konfiguraci, abyste zajistili, že ověřování nastavení a konfigurační soubor jsou správné.
Volitelně Vybrat možnost import behavior pro určení, kdy jsou nové nebo aktualizované soubory automaticky importovány do projekt.
Klikněte na Uložit.

projekt je nyní připojen k vybranému úložiště GitHub a přidán do seznam.
(Volitelné) Kliknutím na ikonu tužky přejmenujete integrace.

import soubory

Zajistěte, aby byly příkazy push správně nakonfigurovány v konfiguračním souboru .phrase.yml configuration. Možnosti push jsou stejné jako pro koncový bod API uploads.

Pro import soubory:

Na stránce Repo Syncs Vybrat projekt a kliknout na import .

Soubory jazyk (definované jako zdroj push položky v konfiguračním souboru) jsou importovány do projekt.

Musí být přítomen výchozí kód jazyka.

Poznámka

V případě problémů při import použít klient CLI k otestování konfiguračního souboru .phrase.yml lokálně a ke kontrole chybových zpráv.

V případě potřeby kontaktujte technickou podporu Phrase a k žádosti o podporu přiložte konfigurační soubor .phrase.yml.

Stáhnout soubory

Zajistěte, aby byly příkazy push správně nakonfigurovány v konfiguračním souboru .phrase.yml configuration. Možnosti pull (např. parametr include_empty_translations) jsou stejné jako pro koncový bod API locales stáhnout.

Pro stáhnout soubory:

Na stránce Repo Syncs Vybrat projekt a kliknout na Stáhnout .

Zobrazí se okno Stáhnout.
Zadejte cíl větev do pole PR větev.

Nejnovější soubory v úložiště budou staženy jako nový požadavek na sloučení (pull request) do požadované větev.
Jakmile jsou soubory staženy, pull request lze sloučit nebo zavřít v úložišti a větev lze smazat.

Poznámka

V případě problémů při stahování použijte CLI klient k otestování konfiguračního souboru .phrase.yml lokálně a zkontrolujte případné chybové zprávy.

V případě potřeby kontaktujte technickou podporu Phrase a k žádosti o podporu přiložte konfigurační soubor .phrase.yml.

Historie

Synchronizace úložiště uchovávají historii posledních importů a stažení pro každý projekt Phrase Strings.

Zobrazení historie:

Na stránce Repo Syncs vyberte projekt a klikněte na History .

Zobrazí se historie importů a stažení pro daný projekt. Záznamy o stažení v historii obsahují odkaz na odpovídající merge request.