A GitHub adattár integrációval szinkronizálja a forrás- és fordítási fájlokat a GitHub adattára és a Crowdin fordítási projektje 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.
Két lehetőség közül választhat. Használhatja a GitHub fiókját vagy a GitHub Enterprise fiókját.
Nyissa meg a Projekt beállítások, Integrációk lapot a Crowdinban, majd kattintson az Integráció beállítása lehetőségre, hogy a GitHub fiókján keresztül integrálja.
Ezután 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 a kívánt területeket válassza ki:
admin:repo_hook – Adattár hook-ok teljes kontrollja
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 felugró párbeszédablakban válassza ki a lefordítandó adattárát és ágakat. Ajánlatos az Ismétlődő karakterláncok megjelenítését a Megjelenít (verziókhoz ajánlott) módosítani, így az azonos karakterláncok elrejtésre kerülnek az ágak között. Tudjon meg többet az Ismétlődő karakterláncokról.
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 könnyen módosítható.
Alapértelmezés szerint a források nem kerülnek átküldésre a fordításokkal az adattárba. Ugyanakkor, ha a Crowdin projektben forrásszöveg-ellenőrzést végez, és szeretné a Crowdin forrásfájljaiban elvégzett módosításokat visszaküldeni az adattárába, kattintson a Szerkesztés elemre, válassza a Források küldése lehetőséget az integráció beállításaiban, majd kattintson a Mentés elemre.
Előfordulhatnak olyan esetek, amikor a fordítások adattárba való küldését átmenetileg le kell tiltani. Ebben az esetben kattintson a Szerkesztés elemre, törölje a Fordítások küldése elemet az integráció beállításaiban, majd kattintson a Mentés elemre. Ha újra készen áll a szinkronizálni a fordításokat az adattárával, válassza a Fordítások küldése elemet, majd kattintson a Mentés gombra.
A szinkronizálás automatikusan óránként történik. Ha szükséges, módosíthatja a frissítési időközt az integráció beállításai alatt. A szinkronizálási ütemterv konfigurálásához – kattintson a Szerkesztés elemre, görgessen le a Szinkronizálási ütemterv elemhez, állítsa be a kívánt intervallumot, és kattintson a <Mentés gombra.
A szinkronizálási beállításoktól függetlenül, az adattárában lévő forrásfájlokon végrehajtott változtatások 10 percenként továbbra is szinkronizálásra kerülnek a Crowdinnal.
Az integráció beállításakor meglévő tárolóágakat választ ki, amelyeket hozzá kell adni a Crowdin projekthez. Ahhoz, hogy a GitHub adattárból automatikusan hozzáadja a jövőbeli ágakat a Crowdinba, hozzon létre egy mintát az ágnevekhez az integráció beállításaiban.
Például, ha egy *feature mintát ad hozzá a GitHub integrációs beállításaiban. Ebben az esetben a jövőbeni ágak, amelyek ezt a szót tartalmazzák a címü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:
crowdin.yml
az alapértelmezett fájlnév az automatikusan szinkronizált ágakhoz. Az alapértelmezett beállítások megváltoztatásához kattintson a Szerkesztés elemre, az Alapértelmezett konfigurációs fájlnév mezőben adja meg az előnyben részesített nevet az integráció beállításaiban, majd kattintson a Mentés gombra.
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.
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.
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.
Az integráció beállítása után az összes kapcsolódó információt a rendszer ugyanazon a helyen – a Projekt beállítások, Integrációk fül, GitHub szakaszban tárolja. Alapértelmezés szerint a szinkronizálás automatikusan óránként történik. Ha azonnal el kell indítania a szinkronizálást – kattintson a Szinkr. most lehetőségre.
Alapértelmezés szerint az adattárban tárolt fordításokat csak az első szinkronizálás során tölti fel a Crowdin. A fordítások Crowdinba való manuális feltöltéséhez kattintson a legördülőben a Szinkr. most gombra, majd kattintson a Fordítások feltöltése lehetőségre. Az integráció feltölti a meglévő fordításokat a Crowdin projektbe.
Q: What should I do if my repository becomes a part of the GitHub organization? A: To continue using GitHub integration in Crowdin, follow these steps: