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. Vagyis nem közvetlenül a master ágba küldjük, hogy esélye legyen a fordítások ellenőrzésére, valamint hogy az alkalmazása biztonságban legyen.
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ó.
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.
A szinkronizálás állapotának ellenőrzése
Az integráció beállításának befejezése után a Projekt beállítások, * Integrációk* fülön az integrációra vonatkozó összes információ tárolásra kerül. Alapértelmezés szerint a szinkronizálás automatikusan 10 percenként történik. Abban az esetben, ha azonnali indításra van szükség, kattintson a Szinkr. indítása gombra.
