Důležité
Od 10. prosince 2025 je nové větvení ve výchozím nastavení povoleno pro všechny nové zákazníky.
Stávající zákazníci se mohou přihlásit k novému modelu větvení výběrem Přepnout na nové větvení na kartě projektu.
Starší větvení bude zrušeno k 1. červnu 2026.
Větvení se používá v řízení verzí softwaru. Kopie projektových souborů nazývané větve umožňují týmům pracovat na paralelních verzích projektu současně, přičemž si zachovávají neupravenou kopii. To eliminuje riziko náhodného přepsání změn ostatních v projektových souborech.
Hlavní projekt je zkopírován, když je vytvořena nová větev, přičemž změny se provádějí pouze v této větvi. Když jsou změny dokončeny, větev je sloučena zpět do hlavního projektu. Na více větvích lze pracovat současně a po sloučení jsou větve automaticky smazány. Sloučené větve zůstávají k dispozici na kartě pro zjednodušené sledování historie. Štítky z existující větve jsou zkopírovány do nové větve.
Omezení
-
Všechny role kromě překladatele a hosta mají přístup k zobrazení .
-
Sloučení nelze vrátit zpět a větve nelze obnovit.
-
Práce vytvořené ve specifické větvi nejsou viditelné v hlavním projektu a naopak. Když je větev sloučena do hlavního projektu, jakékoli otevřené úkoly v ní jsou ztraceny.
-
Zprávy ve výhledu odrážejí pouze stav aktivní větve. Sloučení větve do hlavního projektu aktualizuje zprávy hlavního projektu.
-
Výhled obsahuje pouze aktivity v aktivní větvi. Aktivity ve větvích nejsou viditelné v hlavním projektu a naopak. Aktivity ve větvi jsou ztraceny při jejím sloučení do hlavního projektu.
-
GitHub Sync může být použit pouze na hlavním projektu a ne na větvích.
-
Komentáře vytvořené ve větvi nejsou viditelné v hlavním projektu a naopak.
-
vytvořené ve větvi nejsou viditelné v hlavním projektu a naopak. Když je větev sloučena do hlavního projektu, jakékoli otevřené objednávky v ní jsou ztraceny.
-
Překladatelé nemohou být omezeni na specifické větve, ale mají povolení pracovat na specifických lokalizacích. Překladatelé by měli být instruováni, jak pracovat s větvemi.
Větvení je povoleno na kartě v s možností chránit hlavní větev před změnami.
Když je povoleno, na obrazovce projektu se zobrazuje nabídka větví , kde lze vybrat pracovní větve. Pro specifikaci větve v CLI použijte parametr
--branch:
--branch <branch_name>
Větve jsou uvedeny na kartě projektu, kde jsou prezentovány informace o vytváření a sloučení. Větve mohou být také smazány nebo sloučeny a úkoly vytvořeny pro tuto větev z karty .
Tip
Klikněte na Přepnout na nové větvení v záložce , abyste získali přístup k novému rozhraní a funkcím větvení.
Chcete-li vypsat všechny větve projektu pomocí API nebo CLI, spusťte:
$ phrase branches list --project_id <project_id> # např. $ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>
Chcete-li odstranit větev pomocí API nebo CLI, spusťte:
$ phrase branches delete --project_id <project_id> --name <branch_name> # např. $ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>
Role správce, projektového manažera a vývojáře mohou vytvářet nové větve v překladovém editoru, pomocí API nebo v CLI.
Chcete-li vytvořit větev v překladovém editoru, postupujte podle těchto kroků:
-
Na stránce vyberte záložku .
-
Klikněte na Vytvořit větev.
Otevře se okno .
-
Zadejte název větve.
-
Klikněte na Vytvořit větev.
Nová větev je přidána do seznamu.
Chcete-li vytvořit větev pomocí API nebo CPI, spusťte:
$ phrase branches create --project_id <project_id> --data <data>
Chcete-li vytvořit větev při odesílání překladů, spusťte:
$ fráze push --větev <název_větve>
Po provedení změn ve větvi může být sloučena zpět do hlavního překladu, aby se zahrnuly nové překlady.
Pouze změny v následujících zdrojích jsou během sloučení aplikovány na hlavní větev:
-
Kódy jazyků
-
Klíče
-
Překlady
Změny v jiných zdrojích, jako jsou Aktivity, Práce a Objednávky, nejsou aplikovány.
Konflikty
Konflikt nastává, když se zdroj (překlad, klíč nebo kód jazyka) změnil jak v hlavním projektu, tak ve větvi mezi okamžikem, kdy byla větev vytvořena, a kdy byla sloučena zpět do hlavního projektu. Například, překlady a nastavení klíčů (například množné tvary) se mohou změnit v hlavním projektu po vytvoření větve, což způsobí, že hodnoty ve větvi se liší od těch v hlavním projektu.
Pro sloučení větve postupujte podle těchto kroků:
-
Z pohledu projektu vyberte větev pro sloučení a klikněte na Porovnat a sloučit.
Otevře se stránka . Informace o překladech, které mají být upraveny během sloučení, lze získat kliknutím do buněk.
-
Pokud dojde ke konfliktům, vyberte strategii sloučení:
-
Vyberte , abyste odmítli konfliktní změny a zachovali stávající překlady.
-
Vyberte , abyste nahradili stávající překlady změnami z větve.
-
-
Klikněte na Sloučit větev.
Větev je sloučena do hlavního projektu.
Pro sloučení větve pomocí API nebo CPI spusťte:
$ phrase větve sloučit \\
--project_id <project_id> \\
--name <name> \\
--data '{"strategy":"use_main"}' \
--access_token <token>
-
použít_větevřeší konflikty aplikováním změn z větve a pokud není specifikováno, je výchozí. -
použít_hlavnířeší konflikty odmítnutím změn z větve.použít_masterje také podporováno.
Při použití CLI specifikujte větev, ze které chcete provést push nebo pull, pomocí parametru --branch.
$ fráze push --větev <název_větve> $ phrase pull --branch <branch_name>
Pokud zadaná větev neexistuje v projektu, klient ji vytvoří.
Použijte --use-local-branch-name pro provedení push a pull pomocí názvu větve aktivní git větve:
$ phrase push --use-local-branch-name $ phrase pull --use-local-branch-name
Všechny API koncové body, které přijímají argument projektu, také podporují parametr --branch pro provedení akce na konkrétní větvi projektu:
$ phrase upload create <project_id> \\
--branch <branch_name>
--file /path/to/my/file.json \
--file-format json \\
--locale-id abcd1234cdef1234abcd1234cdef1234 \
--tagy úžasná-funkce, potřebuje-korekturu \
--locale-mapping "{"en": "2"}" \
--možnosti-formátu "{"foo": "bar"}"
Důležité
Od 10. prosince 2025 je nové větvení ve výchozím nastavení povoleno pro všechny nové zákazníky.
Stávající zákazníci se mohou přihlásit k novému modelu větvení výběrem Přepnout na nové větvení na kartě projektu.
Nový zážitek z větvení představuje přepracovanou architekturu pro zlepšení výkonu, stability a flexibility a rozšířené možnosti správy verzí. Umožňuje týmům pracovat na více verzích jejich obsahu paralelně, udržovat dlouhotrvající větve aktuální a efektivněji sloučit změny.
Nové funkce zahrnují:
-
Víceúrovňové (stohované) větve
Větve mohou být vytvářeny z jakékoli jiné větve, nejen z hlavní větve. Podporováno je až 5 úrovní větví.
-
Synchronizace změn mezi větvemi
Dlouhotrvající větve mohou být zastaralé, jak se změny hromadí v jejich základních větvích. Nové větvení zavádí schopnost synchronizace, která pomáhá předcházet nekonzistencím.
Větve, které zůstávají nesloučené více než 30 dní od jejich vytvoření, se počítají mezi Strings spravovaná slova.
Role správce, projektového manažera, designéra a vývojáře mohou vytvářet nové větve na kartě , prostřednictvím API nebo v CLI.
Chcete-li vytvořit větev z uživatelského rozhraní, postupujte podle těchto kroků:
-
Na stránce vyberte záložku .
-
Klikněte na Vytvořit větev.
Otevře se okno .
-
Zadejte název větve.
-
Vyberte ze seznamu existujících větví.
-
Klikněte na Vytvořit.
Nová větev je přidána do seznamu.
Chcete-li vytvořit větev pomocí API nebo CPI, spusťte:
$ phrase branches create --project_id <project_id> --data <data>
Chcete-li vytvořit větev při odesílání překladů, spusťte:
$ fráze push --větev <název_větve>
Synchronizace zajišťuje, že pracovní větev zůstává v souladu s nejnovějšími změnami z větve, ze které pochází. Tímto způsobem mohou překladatelé pracovat s aktualizovanou verzí obsahu také v dlouhodobých projektech.
Chcete-li synchronizovat větev s její základní větví, postupujte podle těchto kroků:
-
Na kartě klikněte na Synchronizovat se základní větví vedle požadované větve.
Stránka se zobrazí s informacemi o jakýchkoli konfliktech a změnách, které mají být synchronizovány se základní větví.
-
Klikněte na jakoukoli z detekovaných změn, abyste ji zkontrolovali před synchronizací.
Zobrazí se tabulka s podrobnostmi o vybrané změně.
-
Vyberte Synchronizovat a potvrďte, abyste použili změny.
Změny jsou přidány do základní větve a stávají se viditelnými v překladovém editoru. Informace o poslední synchronizaci se zobrazují ve sloupci na kartě .
Synchronizaci větve lze také provést prostřednictvím API spuštěním tohoto příkazu CLI:
$ phrase branches sync \
--project_id <project_id> \\
--name <branch_name> \
--data '{"strategy":"use_main"}' \
--access_token <token>
-
použít_větevřeší konflikty aplikováním změn z větve a pokud není specifikováno, je výchozí. -
použít_hlavnířeší konflikty tím, že odmítá změny z větve a odkazuje na základní větev. Při práci s vrstvenými větvemi není základní větev nutně skutečnou hlavní projektovou větví.
Po dokončení překladu nebo práce specifické pro verzi ve větvi lze jakékoli změny sloučit do základní větve. Jakmile jsou všechny změny sloučeny v řetězci, může být vrchní větev sloučena do hlavní větve.
Po úspěšném sloučení je sloučená větev automaticky smazána a objevuje se na kartě pro sledování historie.
Změny následujících zdrojů jsou aplikovány na základní větev během sloučení:
-
Kódy jazyků
-
Klíče
-
Překlady
Změny v jiných zdrojích, jako jsou Aktivity, Práce a Objednávky, nejsou aplikovány.
Větev s aktivními vedlejšími větvemi nemůže být sloučena, dokud nejsou vedlejší větve nejprve smazány nebo sloučeny.
Konflikty
Konflikt nastává, když se zdroj (překlad, klíč nebo kód jazyka) změnil jak v aktuální větvi, tak v její základní větvi po vytvoření větve nebo poslední synchronizaci. Konflikty mohou nastat na jakékoli úrovni zásobníku větví, nejen při sloučení do hlavní větve.
Pro sloučení větve postupujte podle těchto kroků:
-
Na záložce projektu klikněte na Sloučit se základní větví vedle požadované větve.
Otevře se stránka . Informace o překladech, které mají být upraveny během sloučení, lze získat kliknutím do buněk.
-
Pokud dojde ke konfliktům, vyberte strategii sloučení:
-
Vyberte , abyste odmítli konfliktní změny a zachovali stávající překlady.
-
Vyberte , abyste nahradili stávající překlady změnami z větve.
-
-
Klikněte na Sloučit a potvrďte, abyste aplikovali změny.
Větev je sloučena se základní větví a automaticky smazána. Chcete-li zkontrolovat historii sloučených větví, otevřete záložku na stránce .
Pro sloučení větve pomocí API nebo CPI spusťte:
$ phrase větve sloučit \\
--project_id <project_id> \\
--name <name> \\
--data '{"strategy":"use_main"}' \
--access_token <token>
-
použít_větevřeší konflikty aplikováním změn z větve a pokud není specifikováno, je výchozí. -
použít_hlavnířeší konflikty odmítnutím změn z větve.použít_masterje také podporováno.
Akce sloučit také automaticky maže sloučenou větev.
Při použití CLI specifikujte větev, ze které chcete provést push nebo pull, pomocí parametru --branch.
$ fráze push --větev <název_větve> $ phrase pull --branch <branch_name>
Pokud zadaná větev neexistuje v projektu, klient ji vytvoří.
Použijte --use-local-branch-name pro provedení push a pull pomocí názvu větve aktivní git větve:
$ phrase push --use-local-branch-name $ phrase pull --use-local-branch-name
Všechny API koncové body, které přijímají argument projektu, také podporují parametr --branch pro provedení akce na konkrétní větvi projektu:
$ phrase upload create <project_id> \\
--branch <branch_name>
--file /path/to/my/file.json \
--file-format json \\
--locale-id abcd1234cdef1234abcd1234cdef1234 \
--tagy úžasná-funkce, potřebuje-korekturu \
--locale-mapping "{"en": "2"}" \
--možnosti-formátu "{"foo": "bar"}"