GitHub integráció
A Crowdin GitHub-bal való integrációja a forrás- és fordítási fájlokat szinkronizálja a GitHub adattár és a Crowdin fordítási projekt között. Minden lefordított és jóváhagyott fájl automatikusan átadásra kerül, mint átviteli kérelem (pull request) a GitHub adattár l10n ágába.
GitHub és Crowdin összekapcsolása
Először nyissa meg a Projekt beállítások, Integrációk lapot a Crowdinban. Ezután két lehetősége van. Használhatja a GitHub fiókját vagy a GitHub Enterprise fiók integrációt.
A GitHub fiókon keresztül történő integráláshoz kattintson a Integráció beállítása gombra, majd engedélyezze a kapcsolatot a Crowdinnal a GitHub oldalon:
Abban az esetben, ha a szükséges adattár privát, és hozzáférése korlátozott vagy nem fér hozzá hozzá, kérje meg az adattár tulajdonosát, hogy adja meg a Hozzáférési tokent. Ezt követően illessze be a tokent a Token mezőbe, majd kattintson az Integráció beállítása gombra.
A GitHub Enterprise fiókon keresztüli integrációhoz egy hozzáférési tokent kell létrehoznia. Ügyeljen arra, hogy az összes szükséges területet kiválassza: - Nyilvános adattárak elérése vagy privát adattárak teljes ellenőrzése (attól függően, hogy milyen típusú adattárat szeretne lefordítani) - Az adattár hook-ok teljes ellenőrzése (így új fájlokat is kaphat vagy módosításokat végezhet régebben lefordítottakon is) - Frissítse az összes felhasználói adatát
Ezután illessze be a hozzáférési tokent és az Alap URL-t a megfelelő mezőkbe. A folytatáshoz kattintson az Integráció beállítása gombra.
A sikeres integráció után egy felugró párbeszédablak jelenik meg a Crowdin Projekt beállítások, Integrációk lapján. Az újonnan megjelenő felugró ablakban folytassa az integráció folyamatát, ahol kiválaszthatja a lefordítandó adattárat és az ágakat.
Azt javasoljuk, hogy az ismétlődő karakterláncok kezelésénél a Megjelenít (verziókhoz ajánlott) beállítást válassza, így az azonos karakterláncok az ágak között el lesznek rejtve.
Szolgáltatási ágak
Amikor fordítások elkészültek és a nyelvek készek a kiadásra, a Crowdin küldeni fog egy átviteli kérelmet (pull request) a fordítássokkal az Ön verziókezelő rendszerének. Minden egyes honosítás alatt lévő ághoz a Crowdin további szolgáltatási ágat hoz létre a fordítással. Nem közvetlenül a master ágba küldjük az adatokat, így először ellenőrizheti a fordításokat.
Alapértelmezés szerint l10n_ kerül hozzáadásra a létrehozott szolgáltatási ág nevéhez. Szükség esetén ez könnyedén módosítható.
Automatikusan szinkronizálni kívánt ágak
Az integráció beállításakor meglévő tárolóágakat választ ki, amelyeket hozzá kell adni a Crowdin projekthez. A GitHub jövőbeli ágaknak a Crowdinhoz történő automatikus hozzáadásához hozzon létre egy mintát az ágnevekhez. Ha egy ágnév egy bizonyos mintát követ, akkor automatikusan hozzáadódik a Crowdinhoz.
Például, hozzáadja a *feature mintát a GitHub integrációs beállításaihoz. Ebben az esetben a jövőbeni ágak, amelyek ezt a szót tartalmazzák a nevük végén, hozzáadódnak a projekthez.
Az ágnevek mintájának hozzáadásához kövesse az alábbi lépéseket:
- Kattintson a Szerkesztés elemre a GitHub integrációs szakaszban.
- A felbukkanó párbeszédpanelen kattintson a bal felső sarokban lévő Speciális beállítások megjelenítése elemre.
- Az Automatikusan szinkronizálni kívánt ágak mezőben használjon helyettesítő karaktereket, például ‘*’, ‘?’, ‘[set]’, ‘', stb, hogy a szükséges ágakat beazonosítsa.
- Kattintson a Mentés gombra.
Szinkronizálandó tartalom kiválasztása
Ahhoz, hogy az integráció működjön, meg kell adnia, hogy mely forrásfájlokat kell lefordítani, és azt hogy a Crowdin hogyan strukturálja a lefordított fájlokat az Ön adattárában. Abban az esetben, ha egy piros ikont lát felkiáltójellel a szolgáltatási ág neve mellett, ez azt jelenti, hogy nem választott ki tartalmat a szinkronizáláshoz.
Ennek két módja van: online konfigurálással, vagy manuálisan egy konfigurációs fájl létrehozásával.
Online konfigurálás
Ez a folyamat az összes verzióvezérlő rendszer (VCS) integrációja esetén azonos. Nézze meg a VCS integrációk: online konfigurációt, hogy megtudja, hogyan válasszon online tartalmat a szinkronizáláshoz.
Konfigurációs fájl létrehozása
A crowdin.yaml konfigurációs fájlt a GitHub adattár minden olyan ágában el kell helyezni, amelyet le akar fordítani, hogy a Crowdin tudja, hogy mely fájlokat kell pontosan elküldeni a fordításokhoz.
A Szinkronizálási eszközhöz hasonló szerkezettel kell rendelkeznie, de a projekt hitelesítő adatait biztonsági okokból nem szabad a fájl fejlécében tárolni. További információk: konfigurációs fájl létrehozása.
Szinkronizálás ütemezése
A szinkronizálási ütemezés beállításához – kattintson a Szerkesztés gombra, és válassza ki a frissítési intervallumot.
A szinkronizálás állapotának ellenőrzése
Az integráció beállítása után az összes kapcsolódó információ ugyanazon helyen – Projekt beállítások, Integrációk lapon, a GitHub részben kerül tárolásra.
Alapértelmezés szerint a szinkronizálás automatikusan 10 percenként történik. Ha azonnal el kell indítani – kattintson a Szinkronizálás most lehetőségre.
