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ště.
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 konkrétní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.
Pokud cílové úložiště vyžaduje ověřené (podepsané) commity, měla by se použít metoda ověřování pomocí aplikace GitHub. Commity odeslané pomocí osobního přístupového tokenu nejsou podepsané, takže synchronizace selže s následující chybou: „The repository requires verified (signed) commits.“
Vyberte úložiště GitHub ze seznamu.
Vyberte větev úložiště ze seznamu, ze které se má provádět import (push) a export (pull). Obvykle se jedná o hlavní větev.
Volitelně zadejte název větve pro pull request. Pokud zůstane prázdný, vytvoří se větev s výchozí hodnotou phrase-translations.
Kliknout na Validate Configuration pro zajištění správnosti nastavení ověřování a konfiguračního souboru.
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é) Kliknout na pencil icon pro přejmenování integrace.

import souborů

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

Pro import souborů:

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

Jazykové soubory (definované jako zdrojové položky push 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 importu použít klient CLI k otestování konfiguračního souboru .phrase.yml lokálně a ke kontrole případných chybových zpráv.

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

Stáhnout soubory

Zajistit, aby příkazy pull byly správně nakonfigurovány v konfiguračním souboru .phrase.yml nastavení. Možnosti pull (např. parametr include_empty_translations) jsou stejné jako pro koncový bod stáhnout kód jazyka API.

Pro stažení souborů:

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

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

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

Poznámka

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

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

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 Synchronizace úložiště Vybrat projekt a klikněte na Historie .

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