Verziók kezelése

Maintain an agile localization process and avoid translation delays for added texts or new product features. Integrate your project branches with Crowdin and allow translators to immediately access all new texts.

Ágak

When several people are working on product development, branches help to manage different versions of the content. If you have a continuous project you can add project branches to Crowdin and allow translators to translate the texts right in parallel with development to avoid deployment delays.

Branch in Crowdin looks like a regular folder marked with a special icon and has specific behavior for duplicated strings.
The example of a files structure in the version control system (VCS) and Crowdin:

Branch Creation

Note! First files you upload to Crowdin project must contain all the original strings and should be placed in the corresponding branch. For all article examples a branch with original texts is named Master.

There are few ways to add branches to Crowdin: - Integrate Crowdin projects with GitLab, GitHub, or Bitbucket. It’s a recommended option, as branches selected for localization in your version control system (VCS) will be created in Crowdin automatically - Use CLI or API to add new branches - Create branches manually by going to Project Settings > Files > New Version Branch

Ág létrehozása API segítségével

Az API segítségével történő ág létrehozásához használja az Add Directory módszert az is_branch=1 paraméterrel:

POST https://api.crowdin.com/api/project/{project-identifier}/add-directory?key={project-key}&name={branch_name}&is_branch=1

Add File, Update File, Upload Translations és a többi, fájlokat és könyvtárakat módosító módszerek a branch={branch_name} paraméterrel működnek.

Ágak kezelése CLI segítségével

Nincs szükség különleges parancs futtatására verzió ágak létrehozására, ha a szinkronizálási eszközt használja. A fájlok feltöltése közben a verzió-ág automatikusan létrejön. Példa a forrásfájlok/fordítások feltöltésére egy megadott verzió-ágba:

$ crowdin upload sources -b branch_name

$ crowdin upload translations -b branch_name

Ismétlődések

Mivel az ágak ugyanazon termék különböző verziói, az azokban található honosítandó tartalom általában megismétlődik. Annak érdekében, hogy a fordítók a különböző verziókat következetesen fordítsák és a további fordítási költségeket elkerülje, van egy speciális opciónk, amely lehetővé teszi, hogy az egyes verziók közötti ismétlődéseket elrejtse. Ha ezt a lehetőséget választja, csak azokat az eredeti karakterláncokat kell lefordítani, amelyeket először feltöltött a rendszerbe. Az összes ismétlődő karakterlánc automatikusan megkapja az eredeti karakterlánc fordítását.

Ismétlődések

Javasolt munkafolyamat

Annak érdekében, hogy a verziók zökkenőmentesen működjenek a Crowdin projektjénél, a következő munkafolyamatot javasoljuk: 1. Upload your project files to Crowdin project using one of the methods available. 1. Go to Project Settings > Translations > Duplicates and choose the option recommended for versions.

The screenshot below visualizes how the workflow works in practice. All texts from Master, Branch 1 and Branch 2 are transferred to the translation server immediately after they appear, even though the branches are not merged to the Master branch yet.

Fordítások exportálása

Az összes verzió-ágból származó fordítások egy ZIP archívumba kerülnek, ha azokat a webes felületen keresztül töltik le. Use the synchronization tool or API to download the translations for each branch individually.

Fordítások exportálása API segítségével

A megadott verzió-ág fordításának exportálásához:

GET https://api.crowdin.com/api/project/{project-identifier}/export?key={project-key}&branch={branch_name}

A megadott verzió-ág fordításainak letöltéséhez:

GET https://api.crowdin.com/api/project/{project-identifier}/download/{package}.zip?key={project-key}&branch={branch_name}
Fordítások exportálása CLI segítségével

A megadott verzió-ág fordításainak letöltéséhez:

$ crowdin download -b branch_name

Ágak egyesítése

The Master branch will contain new texts from the Feature branches as soon as they are merged. While synchronizing with Crowdin, all of the texts in the Master branch are populated with translations from the appropriate branch.

After synchronization of the updated Master branch with Crowdin, the Feature branch can be removed from Crowdin. All translations stored in the Master branch will remain.

Branch Translation Verification

You can verify translations on production using only Feature branch before changes are merged with your Master branch. Such Test Deploy gives you an option of quick revert to the original Master branch version if needed.

Lásd még

Hasznos volt ez a cikk?