-
Edice Business a Enterprise
S dotazy ohledně licencí se obraťte na prodejní oddělení.
Větvení se používá při správě verzí softwaru. Kopie souborů projektu nazývané větve umožňují týmům pracovat na paralelních verzích projektu současně se zachováním neupravené kopie. Eliminujete tak riziko náhodného přepsání změn v projektových souborech jinými uživateli.
Hlavní projekt se zkopíruje při vytvoření nové větve se změnami provedenými pouze v této větvi. Po dokončení změn je větev sloučena zpět do hlavního projektu. Lze pracovat na více větvích současně a po sloučení je lze odstranit. Tagy z existující větve budou zkopírovány do nové.
Omezení
-
Všechny role kromě Překladatele a Hosta mají přístup do zobrazení .
-
Sloučení nelze vrátit zpět a větve nelze obnovit.
-
Zakázky vytvořené v určité větvi nejsou viditelné v hlavním projektu a naopak. Při sloučení větve do hlavního projektu dojde ke ztrátě otevřených zakázek.
-
Sestavy v zobrazení
odrážejí pouze stav aktivní větve. Sloučením větve do hlavního projektu se aktualizují hlavní sestavy projektu. -
Zobrazení
obsahuje pouze aktivity v aktivní větvi. Aktivity ve větvích nejsou viditelné v hlavním projektu a naopak. Aktivity ve větvi se při sloučení do hlavního projektu ztratí. -
Synchronizaci pro GitHub lze použít pouze v hlavním projektu, nikoli ve větvích.
-
Komentáře ve větvi nejsou viditelné v hlavním projektu a naopak.
-
vytvořené ve větvi nejsou viditelné v hlavním projektu a naopak. Při sloučení větve do hlavního projektu se všechny otevřené objednávky v ní ztratí.
-
Překladatelé nemohou být omezeni na určité větve, ale mají oprávnění pracovat na určitých lokálních nastaveních. Překladatelé by měli být poučeni, jak pracovat s větvemi.
Větvení je povoleno na záložce
v s volbou chránit hlavní větev před změnami.Pokud je zapnuta, na obrazovce projektu se zobrazí nabídky větví, kde lze vybrat pracovní větve. Chcete-li zadat větev v CLI, použijte parametr
--větev
:
--branch <branch_name>
Větve jsou uvedeny v zobrazení
, kde jsou uvedeny informace o vytvoření a sloučení. Větve lze také odstranit nebo sloučit a vytvořit pro ně zakázky ze zobrazení .Pro výpis všech větví pro projekt přes API nebo CLI spusťte:
$ seznam frázových větví <project_id>
Chcete-li větev odstranit pomocí API nebo CLI, spusťte:
$ 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, přes API nebo v CLI.
Větev vytvoříte v překladovém editoru takto:
-
Na stránce
vyberte kartu . -
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.
Větev vytvoříte pomocí API nebo CPI:
$ phrase branchs create --project_id <project_id> --data <data>
Pro vytvoření větve při odesílání překladů spusťte:
$ phrase push --branch <branch_name>
Po provedení změn může být větev sloučena zpět do hlavního překladu za účelem začlenění nových překladů.
Během slučování se na hlavní větev vztahují pouze změny následujících zdrojů:
-
Locale
-
Klíčů
-
Překlady
Změny dalších zdrojů, jako jsou aktivity, zakázky a objednávky, se nepoužijí.
Konflikty
Ke konfliktu dochází, když se zdroj (překlad, klíč nebo kód jazyka) změní v hlavním projektu mezi vytvořením větve a jejím sloučením zpět do hlavního projektu. Například překlady a nastavení klíčů (např. plurálních tvarů) se mohly po vytvoření větve v hlavním projektu změnit a hodnoty ve větvi se tak mohly lišit od hodnot v hlavním projektu.
Chcete-li větev sloučit, postupujte takto:
-
V zobrazení Porovnat a sloučit.
projektu vyberte větev pro sloučení a klikněte na tlačítkoOtevře se stránka
. Informace o překladech, které mají být během sloučení změněny, získáte kliknutím na buňky. -
V případě konfliktů vyberte strategii slučování:
-
Chcete-li konfliktní změny odmítnout a zachovat stávající překlady, vyberte možnost
. -
Vyberte
a nahraďte stávající překlad změnami z větve.
-
-
Klikněte na Sloučit větev.
Větev je sloučena s hlavním projektem.
Pro sloučení větve pomocí API nebo CPI spusťte:
$ phrase branches merge \
--project_id <project_id> \
--name <name> \
--data '{"strategy":"use_master"}' \
--access_token <token>
-
use_branch
řeší konflikty použitím změn z větve, a pokud není zadáno, je výchozí. -
use_master
řeší konflikty odmítnutím změn z větve.
Při použití CLI zadejte větev, kterou chcete odeslat nebo vytáhnout s parametrem --větev
.
$ phrase push --branch <branch_name> $ phrase pull --branch <branch_name>
Pokud zadaná větev v projektu neexistuje, klient ji vytvoří.
Použijte --use-local-branch-name
k odesílání a tažení pomocí názvu větve aktivní větve git:
$ phrase push --use-local-branch-name $ phrase pull --use-local-branch-name
Všechny koncové body API, které přijímají argument projektu, podporují také parametr --větev
pro provedení akce na určité větvi projektu:
$ phrase upload create <project_id> \ --branch <branch_name> --file /path/to/my/file.json \ --file-format json \ --locale-id abcd1234cdef1234abcd1234cdef1234 \ --tags awesome-feature,needs-proofreading \ --locale-mapping "{"en": "2"}" \ --format-options "{"foo": "bar"}"