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řístupové 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řístupový 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
  - 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ě, pro připojení úložiště postupujte podle těchto kroků:

Na stránce Integrace přejděte dolů na Synchronizace úložiště a klikněte na Konfigurovat.

Otevře se stránka Synchronizace úložišť.
Klikněte na Přidat synchronizaci/GitHub.

Otevře se okno nastavení synchronizace GitHub.
Vyberte projekt ze seznamu.
Vyberte metodu ověřování:
- Aplikace GitHub (doporučeno)
  
  Pokud aplikace GitHub ještě není nainstalována, klikněte na Ověřit. Ověřování se provádí jednou a lze jej znovu použít pro více synchronizací úložišť.
  
  Pokud je aplikace GitHub již nainstalována, klikněte na Spravovat instalaci a dokončete 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.
Vyberte úložiště GitHub ze seznamu.
Vyberte větev úložiště ze seznamu, ze které chcete importovat (push) a exportovat (pull). Obvykle se jedná o hlavní větev.
Volitelně zadejte název větve pro požadavek na stažení (pull request). Pokud ji necháte prázdnou, vytvoří se větev s výchozí hodnotou phrase-translations.
Klikněte na Ověřit konfiguraci a ujistěte se, že nastavení ověřování a konfigurační soubor jsou správné.
Volitelně Vybrat možnost importu pro určení, kdy se nové nebo aktualizované soubory automaticky importují do projektu.
Klikněte na Uložit.

Projekt je nyní připojen k vybranému úložišti GitHub a přidán do seznamu.
(Volitelné) Kliknout na ikonu tužky pro přejmenování integrace.

Import souborů

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

Pro import souborů:

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

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

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

Poznámka

V případě problémů při importu 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 pull správně nakonfigurovány v konfiguračním souboru .phrase.yml konfigurace. Možnosti stažení (např. parametr include_empty_translations) jsou stejné jako pro koncový bod stáhnout kódy jazyků API.

Pro stažení souborů:

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

Zobrazí se okno Stáhnout.
Do pole PR větev zadejte cílovou větev.

Nejnovější soubory v úložišti budou staženy jako nový požadavek na sloučení (pull request) do požadované větve.
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 klienta CLI 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 <3>.

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