GitHub (Strings)

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

Tip

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

Předpoklady

Konfigurační soubor .phrase.yml musí být v kořeni sledované větve. Soubor definuje, které soubory chcete import (pull) nebo stáhnout (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 push a jeden pull cíl, správné formáty souborů a správné nastavení parametru update_translations.
Přístupový token GitHub:
- Klasické tokeny
  
  Vyžaduje rozsah repo (public_repo při synchronizaci s veřejným úložištěm)
- Jemnozrnné tokeny
  
  Vyžaduje následující oprávnění:
  - Obsah: Pro čtení a zápis
  - Pull requesty: Pro čtení a zápis
Pokud je v GitHubu povoleno SSO, musí být povoleno i pro přístupový token.
Větev phrase_translations nelze ochránit.
Nastavení úložiště nevyžaduje podepsané revize.

Poznámka

Kvůli neustálému vylepšování nemusí být uživatel rozhraní stejné jako ve videu.

Připojit repozitáře

Jakmile je konfigurační soubor na místě, můžete úložiště připojit takto:

Na stránce Integrace přejděte dolů ke konektoru Synchronizace GitHub 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 z rozevíracího seznamu.
Případně vyberte samostatně hostovanou instanci a poskytněte samoobslužný koncový bod API GitHub.
Zadejte osobní přístupový token repozitáře s rozsahem API.
Z rozevíracího seznamu vyberte úložiště GitHub.
Z rozevíracího seznamu vyberte větev úložiště pro import (push) a stažení (pull). Toto je obvykle hlavní větev.
Kliknutím na tlačítko Ověřit konfiguraci zkontrolujte správnost přístupového tokenu a konfiguračního souboru.
Případně vyberte Auto import pro import souborů s každou revizí do vybrané větve GitHub.
Klikněte na Uložit.

Projekt je nyní připojen k vybranému úložišti GitHub a přidán do seznamu.

Importovat soubory

Zkontrolujte, zda jsou push příkazy správně nakonfigurovány v konfiguračním souboru .phrase.yml. Možnosti push jsou stejné jako u koncového bodu uploads API.

Pro import souborů:

Na stránce Synchronizace úložiště vyberte projekt a klikněte na Import .

Do projektu jsou importovány soubory jazyků (definované jako push zdroje v konfiguračním souboru).

Musí být nastaven výchozí kód jazyka.

Poznámka

V případě problémů při importu použijte klienta CLI k testování místního konfiguračního souboru .phrase.yml a kontrole chybových zpráv.

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

Stáhnout soubory

Zkontrolujte, zda jsou pull příkazy správně nakonfigurovány v konfiguračním souboru .phrase.yml. Pull options (např. parametr include_empty_translations) jsou stejné jako pro koncový bod API locales download.

Chcete-li stáhnout soubory:

Na stránce Synchronizace úložiště vyberte projekt a klikněte na Stáhnout .

Poslední soubory jazyků v úložišti jsou exportovány jako nový pull request.
Po stažení souborů lze pull request sloučit nebo zavřít v úložišti a větev odstranit.

Poznámka

V případě problémů při exportu použijte klienta CLI k testování místního konfiguračního souboru .phrase.yml a kontrole chybových zpráv.

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

Historie

Repo synchronizace udržuje historii nejnovějších importů a exportů pro každý projekt Phrase Strings.

Pro zobrazení historie:

Na stránce Synchronizace úložiště vyberte projekt a klikněte na History .

Zobrazena historie importu a stáhnout projektu. Stáhnout záznamy v historii obsahují odkaz na odpovídající požadavek sloučit.