GitLab-integration

Integration med GitLab synker kilde- og oversættelsesfiler mellem GitLab-repo’et og oversættelsesprojektet i Enterprise. Alle oversatte og godkendte filer bliver automatisk pushed som en fletteanmodning til l10n-grenen i GitLab-repo’et.

Tilslutning af GitLab med Enterprise

There are two possible options you can choose from. You can either use your GitLab account or GitLab Enterprise account.

Connecting GitLab Account

  1. Åbn Enterprise-projektet og gå til Applikationer > System.
  2. Klik på GitLab på integrationslisten.
  3. Click Set Up Integration to integrate via your GitLab account.
  4. Godkend dernæst via GitLab forbindelsen til Enterprise.

Connecting GitLab Enterprise Account

  1. For at integrere via en GitLab Enterprise-konto skal et adgangstoken oprettes. Make sure to select the required scope:

    • api – Tildeler fuld læse-/skriveadgang til API’en, herunder alle grupper og projekter samt container- og pakkeregistrene
  2. Klik på GitLab Enterprise på integrationslisten.
  3. Indsæt derefter din adgangs-token og Basis-URL i de respektive felter. Klik på Opsæt Integration for at fortsætte.

Selecting Repository

I pop-up dialog vælges ens depot samt de grene, som skal oversættes. Det anbefales at skifte Dubletstrenge til Vis indenfor versionsgrene, så identiske strenge vil være skjult grenene imellem. Indeholder kildefilerne strenge med åbenbare identifikatorer (nøgler), er det bedre at anvende en striks version af indstillingen. I andre tilfælde kan en almindelig bruges.

Læs mere om Dubletstrenge.

Når der arbejdes med private integrationer (f.eks. integrationer med selvhostede VCS), skal der føjes dedikerede Enterprise IP-adresser til hvidlisten for at sikre, at den fungerer korrekt og samtidig forbliver sikker.

Læs mere om IP-adresser.

Tjenestegrene

Når oversættelser er færdige, og sprogene er klar til idriftsættelse, sender Enterprise en pull request med oversættelser til versionsstyringssystemet. For hver gren, der er under lokalisering, opretter Enterprise en yderligere tjenestegren med oversættelser. We don’t commit directly to the master branch so that you can verify translations first.

Som standard føjes l10n_ til det oprettede tjenestegrensnavn. If necessary, you can easily change it.

Synchronization Settings

By default, sources are not pushed to the repo with translations. Udføres der imidlertid kildetekstændringer i Enterprise-projektet, og ønskes ændringerne i kildefiler Enterprise pushed til repoet, så klik på Redigér, vælg Push Kilder i integrationsindstillingerne og klik på Gem.

There are cases when it’s necessary to disable translations from being pushed to the repo temporarily. I dette tilfælde, så klik på Redigér, ryd Synktidsplan i integrationsindstillingerne, og klik på Gem. Når alt er klar til synk af oversættelser med depotet, så vælg Synktidsplanog klik på Gem.

The synchronization is processed every hour automatically. If necessary, you can change the update interval in the integration settings. To configure the synchronization schedule – click Edit, scroll down to the Sync Schedule, set the preferred interval, and click Save.

Uafhængigt af synkindstillingerne vil kildefilændringer i repo stadig blive synket med Enterprise hvert 10. minut.

Grene at auto-synke

Når integration opsættes, vælges de eksisterende repo-grene, som skal føjes til Enterprise-projektet. For automatisk at føje fremtidige grene fra GitLab til Enterprise, så opret et mønster for grennavnene i integrationsindstillingerne.

Du kan f.eks. tilføje en mønster *funktion i GitLab-Integrationsindstillingerne. Fremtidige grene, som indeholder dette ord i slutningen af titlen, vil i så fald blive føjet til projektet.

For at tilføje et mønster for grennavne, så følg disse trin:

  1. Klik på Redigér i GitLab-integrationsafsnittet.
  2. I den viste dialog rulles ned til Grene til Automatisk Synk.
  3. I feltet Grene til Automatisk Synk kan jokertegn benyttes som selektorer, såsom ‘*’, ‘?’, ‘[set]’, ‘' mv. for at identificere de relevante grene.
  4. Klik på Gem.

Standard opsætningsfilnavn

crowdin.yml is the default file name that is used for automatically synchronized branches. To change the default settings, click Edit, specify the preferred name in the Default configuration file name field in the integration settings, and click Save.

Valg af indhold til synkning

For at få integrationen til at fungere, skal der angives, hvilke kildefiler, som skal oversættes, samt hvordan Enterprise skal strukturere oversatte filer i repo’et. If you see a red icon with an exclamatory mark next to the service branch name, it means that you didn’t select content for synchronization.

Dette kan gøre på to måder: Online eller manuel oprettelse af en opsætningsfil.

Onlineopsætning

Denne procedure er den samme for alle integrationer med versionsstyringssystemer (VCS). Tjek VCS-integrationer: Onlineopsætning for at få mere at vide om, hvordan der vælges indhold til onlinesynkning.

Oprettelse af opsætningsfil

Opsætningsfilen crowdin.yml skal gemmes i GitLab-repo’et sammen med hver enkelte gren, som skal oversættes, således at Enterprise ved, hvilke specifikke filer, som skal sendes til oversættelser.

Filen skal have samme struktur som krævet til CLI, dog bør projektakkreditiverne bør af sikkerhedsårsager ikke gemmes i fil-headeren.

Læs mere om oprettelse af opsætningsfil.

Brug af flere depoter i ét projekt

When working with a multiplatform product that has versions for different operating systems, you might want to connect multiple repositories that contain source files for each operating system. In this case, localization resources (e.g., TMs, Glossaries) and translations could be used more efficiently, reducing the time needed for project localization.

To add another repository, follow these steps:

  1. Åbn Enterprise-projektet og gå til Applikationer > System.
  2. Klik på GitLab på integrationslisten.
  3. Click Add Repository.
  4. Configure the integration with the new repository according to your needs and preferences.

Kontrol af Synkroniseringsstatus

Når integration er opsat, lagres alle relaterede oplysninger på samme sted – Applikationer > System > GitLab-afsnittet.

Når integrationen er forbundet, kan indstillingerne kun opdateres af projektmedlemmet, der har opsat den. Alle projektadministratorer, undtagen personen, der opsatte integrationen, vil se knappen Redigér deaktiveret med flg. meddelelse, når markøren placeres over den: Integration er opsat af {Full Name}.

Som standard behandles synk automatisk hvert 60. minut. Ved behov for at synke straks, så klik på Synk nu. Ved behov for kun at synke én gren separat, klik alternativt på den relevante gren og vælg Synk gren.

GitLab synk nu

Uploading Translations from Repo

Som standard uploades de oversættelser, som er gemt i repo’et, kun til Enterprise under den første synkning. For at uploade oversættelser til Enterprise manuelt, så klik på ved siden af Synk nu-knappen og klik på Upload Oversættelser. Integrationen vil uploade eksisterende oversættelser til Enterprise-projektet.

Sp&Sv

Q: Jeg har en applikations-build opsat til at blive udløst af hver commit. Da hver oversættelsesfil comittes af Crowdin separat, hvordan undgås så unødvendige program-builds udløst af disse commits?
A: Da VCS-integrationer i Crowdin bruger API til at comitte filer, men ikke Git, comittes hver fil separat.

Her er et par anbefalinger, som kan hjælpe med at løse lign. situationer:

Se også

Var denne artikel nyttig?