GitHub integráció

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.

GitHub és Crowdin összekapcsolása

Két lehetőség közül választhat. Használhatja a GitHub fiókját vagy a GitHub Enterprise fiókját.

GitHub fiók csatlakoztatása

1. 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.

   

2. 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.

GitHub Enterprise fiók csatlakoztatása

1. 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:

   • repo – Privát adattárak teljes kontrollja
   • admin:repo_hook – Adattár hook-ok teljes kontrollja

2. 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.

   

3. 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.

   

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 könnyen módosítható.

Szinkronizálási beállítások

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.

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. 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:

1. Kattintson a Szerkesztés elemre a GitHub integrációs szakaszban.
2. A felugró párbeszédablakban görgessen le az Automatikusan szinkronizálni kívánt ágak lehetőségig.
3. 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.
4. Kattintson a Mentés gombra.

Alapértelmezett konfigurációs fájl neve

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.

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á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.

Fordítások feltöltése az adattárból

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.

Lásd még

• Verziók kezelése