GitHub (Strings)

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

Tip

Pro informace o integraci GitHubu v Phrase TMS se odkazujte na GitHub (TMS).

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

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

Požadavky

Soubor .phrase.yml konfigurace musí být přítomen v kořenovém adresáři větve, která má být sledová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:
- Aplikace GitHub OAuth musí být nainstalována v organizaci nebo účtu GitHub, který vlastní úložiště.
- Úložiště musí být zahrnuto v instalaci aplikace OAuth.
- Oprávnění k instalaci nebo autorizaci aplikací GitHub jsou vyžadována v cílové organizaci nebo účtu.
GitHub access token:
- Klasické tokeny
  
  Vyžaduje rozsah repo (public_repo, pokud se synchronizuje s veřejným úložištěm)
- Tokeny s jemným řízením
  
  Vyžaduje následující oprávnění:
  - Obsah: Číst a zapisovat
  - Žádosti o stažení: Číst a zapisovat
- 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 Repo Sync a klikněte na Konfigurovat.

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

Otevře se okno nastavení GitHub sync.
Vyberte projekt ze seznamu.
Vyberte metodu ověřování:
- GitHub App (doporučeno)
  
  Pokud GitHub App ještě není nainstalována, klikněte Ověřit. Ověření se provádí jednou a může být znovu použito pro více synchronizací úložiště.
  
  Pokud je GitHub App již nainstalována, klikněte Spravovat instalaci, abyste dokončili instalaci aplikace pro cílovou organizaci nebo účet. Přístup k úložišti je spravován na úrovni organizace nebo uživatelského účtu a není vázán na jednotlivého uživatele GitHubu.
- Osobní přístupový token
  
  Poskytněte 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 GitHubu, který token vytvořil.
- Samostatně hostovaná relace
  
  Poskytněte GitHub samostatně hostovaný API koncový bod a osobní token pro přístup k úložišti s rozsahem API.
Vyberte úložiště GitHub z rozbalovacího seznamu.
Vyberte větev úložiště z rozbalovacího seznamu pro import (push) a export (pull). To je obvykle hlavní větev.
Volitelně poskytněte název větve pro žádost o sloučení. Pokud zůstane prázdné, bude vytvořena větev s výchozí hodnotou phrase-translations.
Klikněte na Ověřit konfiguraci, abyste zajistili, že nastavení ověřování a konfigurační soubor jsou správné.
Volitelně vyberte možnost chování importu, abyste určili, kdy budou nové nebo aktualizované soubory automaticky importovány 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.

Importovat soubory

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

Pro import souborů:

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

Jazykové soubory (definované jako zdroje 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žijte klienta CLI k testování konfiguračního souboru .phrase.yml lokálně a zkontrolujte jakékoliv chybové zprávy.

Pokud je to nutné, kontaktujte technickou podporu Phrase a přiložte konfigurační soubor .phrase.yml k žádosti o podporu.

Exportovat soubory

Ujistěte se, že příkazy pull jsou správně nakonfigurovány v konfiguračním souboru .phrase.yml konfigurace. Možnosti pull (např. parametr include_empty_translations) jsou stejné jako pro API koncový bod stáhnout jazyky.

Pro export souborů:

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

Zobrazí se okno Export.
Uveďte cílovou větev v poli PR branch.

Nejnovější soubory v úložišti budou exportovány jako nový pull request do požadované větve.
Jakmile jsou soubory exportovány, může být pull request sloučen nebo uzavřen v úložišti a větev může být smazána.

Poznámka

V případě problémů při exportu použijte klienta CLI k testování konfiguračního souboru .phrase.yml lokálně a zkontrolujte jakékoliv chybové zprávy.

Pokud je to nutné, kontaktujte technickou podporu Phrase a přiložte konfigurační soubor .phrase.yml k žádosti o podporu.

Historie

Repo syncs uchovávají historii posledních importů a exportů pro každý projekt Phrase Strings.

Pro zobrazení historie:

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

Historie importu a exportu pro projekt je prezentována. Exportované položky v historii zahrnují odkaz na odpovídající žádost o sloučení.