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:

  1. Kattintson a Szerkesztés elemre a GitHub integrációs szakaszban.
  2. A felbukkanó párbeszédpanelen kattintson a bal felső sarokban lévő Speciális beállítások megjelenítése elemre.
  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.

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.

github szinkronizálás ideje

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.

github szinkronizálás most

Lásd még

Hasznos volt ez a cikk?