Integrace
    1. Phrase
    2. Phrase Strings
    3. Integrace

    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 za účelem synchronizace lokalizačních souborů mezi Phrase a GitHub.

    Ve výchozím nastavení jsou úložiště připojena pomocí GitHub OAuth App. Podporovány jsou také osobní přístupové tokeny, které jsou určeny především 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.

      • Podporuje připojení uživatelského účtu Strings k více organizacím GitHub. V konfiguraci integrace vyberte, která organizace GitHub se má synchronizovat. Počet organizací, které lze připojit, není nijak pevně omezen.

    • 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

        • Požadavky na stažení: Č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ů:

    1. V hlavní navigaci klikněte na Automatizace, poté na Synchronizace úložišť.

      Případně na stránce Integrace přejděte dolů na Synchronizace úložišť a klikněte na Nastavení.

      Otevře se stránka Synchronizace úložišť. Seznam Synchronizace úložišť zobrazuje pouze projekty, ke kterým má prohlížející uživatel přístup.

    2. Klikněte na Přidat synchronizaci/GitHub.

      Otevře se okno nastavení Synchronizace GitHub.

    3. Vyberte projekt ze seznamu v rozevírací nabídce.

    4. 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

        Poskytněte osobní token pro přístup k úložišti s rozsahem API.

        Při použití osobního tokenu pro přístup závisí přístup k úložišti na uživateli GitHub, který token vytvořil.

      • Samostatně hostovaná relace

        Poskytněte koncový bod API pro vlastní hostování 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 být použita 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: „Úložiště vyžaduje ověřené (podepsané) commity.“

    5. Pokud používáte aplikaci GitHub, vyberte Connected GitHub organization z rozevíracího seznamu. Seznam úložišť se načte na základě tohoto výběru.

    6. Vyberte GitHub repository z rozevíracího seznamu.

    7. Vyberte Repository branch z rozevíracího seznamu, ze kterého chcete importovat (push) a exportovat (pull). Toto je obvykle hlavní větev (master).

    8. Volitelně zadejte název větve pro pull request. Pokud ji ponecháte prázdnou, vytvoří se větev s výchozí hodnotou phrase-translations.

    9. Kliknutím na Validate Configuration zajistíte, že nastavení ověřování a konfigurační soubor jsou správné.

    10. Volitelně vyberte možnost Import behavior, která určí, kdy se nové nebo aktualizované soubory automaticky importují do projektu.

    11. Klikněte na Uložit.

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

    12. (Volitelné) Kliknutím na pencil icon přejmenujete integraci.

    Import souborů

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

    Postup importu souborů:

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

      Jazykové soubory (definované jako položky zdroje odeslání 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 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 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 configuration. Možnosti pull (např. parametr include_empty_translations) jsou stejné jako pro koncový bod API locales download.

    Postup stahování souborů:

    1. Na stránce Repo Syncs vyberte projekt a klikněte na Stáhnout Sync Export.

      Zobrazí se okno Stáhnout.

    2. Do pole PR branch zadejte cílovou větev.

      Nejnovější soubory v úložišti budou staženy jako nová žádost o sloučení do požadované větve.

    3. Jakmile jsou soubory staženy, lze žádost o sloučení 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 klienta 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 kontaktujte technickou podporu Phrase a k žádosti o podporu přiložte konfigurační soubor .phrase.yml.

    Historie

    Synchronizace úložišť uchovávají historii posledních importů a stahování pro každý projekt Phrase Strings.

    Zobrazení historie:

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

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

    Byl pro vás tento článek užitečný?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.