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

     Note: When setting up an integration with an access token, make sure that you have the admin level permission to the necessary repo.

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.

Q&A

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:

1. Go to Authorized OAuth Apps in your GitHub account.
2. Find Crowdin OAuth App in the list and revoke its access.
3. Set up the GitHub integration in your Crowdin project again using the instructions above.

Lásd még

• Verziók kezelése