VCS-integrationer: Opsætning online

For at få Versionskontrolsystemintegrationen til at fungere, skal du angive, hvilke kildefiler, som skal oversættes, samt hvordan Crowdin skal strukturere oversatte filer i dit depot.

Grenopsætning

Opsæt den valgte gren til at angive stien til kildefiler samt oversatte filer. For at åbne Grenopsætningsdialogboksen, klik på Redigér Opsætning.

Derefter kan du oprette en opsætning eller indlæse en opsætningsfil fra dit depot.

Indlæsning af en Opsætning

Har du allerede en opsætningsfil gemt i dit depot, kan du vælge denne fil ved at følge disse trin:

1. Klik på Flere.
2. Vælg fra rullelisten Indlæs Opsætning.
3. Angiv navnet på opsætningsfilen fra dit lager.
4. Klik på Fortsæt.

Derefter kan du benytte denne opsætning som den er, eller du kan foretage ændringer, som så gemmes i denne opsætningsfil.

Oprettelse af en Opsætning

I dialogen Grenopsætning kan du oprette en opsætning til brug for integrationen.

For at gøre dette, navngiv opsætningsfilen og klik på Fortsæt.

Vælg derefter kildenfilstien og stien til oversatte filer vha. mønstre og pladsholdere som angivet og forklaret nedenfor.

Når du har opsat og gemt opsætning for den valgte fil, gemmes opsætningsfilen i roden af oversættelsesgrenen i dit depot.

Mønstre

* (stjerne)

Repræsenterer alle tegn i et fil- eller mappenavn. Angives en “*.json”, vil den indeholde alle filer, såsom “messages.json”, “about_us.json”, og alt af filtypen “.json”.

*** (dobbeltstjerne)

Matcher enhver streng rekursivt (inkl. undermapper). Bemærk, at *** kan benyttes i både kilde- og oversættelsesmønstre. Ved brug af *** i oversættelsesmønsteret vil det altid indeholde understier fra kilden til en bestemt fil. Der kan f.eks. benyttes kilden: ‘/da/*.po’ for rekursivt at uploade alle *.po-filer til Crowdin. Oversættelsesmønsteret vil være ‘/%two_letters_code%/\/%original_file_name%’.

? (spørgsmålstegn)

Matcher ethvert enkelttegn.

[set]

Matcher ethvert enkelttegn i et sæt. Opfører sig nøjagtig som tegnsæt i Regexp, herunder negation ([^a-z]).

\ (omvendt skråstreg)

Escaper det næste metategn.

Pladsholdere

Benyt pladsholdere til at fasslå, hvor oversatte filer blive placeret, og hvorledes de vil blive navngivet:

Navn	Beskrivelse
%language%	Sprognavn (f.eks. Dansk)
%two_letters_code%	Sprogkode ISO 639-1 (dvs. UK)
%three_letters_code%	Sprogkode ISO 639-2/T (dvs. ukr)
%locale%	Landestandard (f.eks. uk-UA)
%locale_with_underscore%	Landestandard (f.eks. uk_UA)
%original_file_name%	Oprindeligt filnavn
%android_code%	Android Landestandard-ID benyttes ved navngivning af "værdier"-mapper
%osx_code%	OS X-landestandard-ID benyttet ved navngivning af ".lproj"-mapper
%original_path%	Benyt overordnede mappers navne i Crowdin-projektet til at generere filstien i det resulterende bundt
%file_extension%	Oprindeligt filtypenavn
%file_name%	Filnavn uden fiíltypeangivelse

Avancerede Indstillinger

Ignorering af filer

Er der filer, som ikke skal oversættes, benyttes valgmuligheden Ignoreret Mønster, og Crowdin vil ikke uploade specificerede filer til oversættelse.

Sprogtilknytning

Du kan benytte tilpassede sprogkoder udover dem, som er defineret af Crowdin, ved at opsætte sprog-mapping. Dette vil bidrage til at bevare en ensartet struktur i eksporterede oversættelsesfiler. Du kan tilknytte så mange sprog, som du behøver.

Følg disse trin for at tilføje sprogmapping:

1. Åbn afsnittet Sprog-mapping.
2. Vælg det passennde sprog og variabel.
3. Tilføj tilpasset kode.
4. Klik på Tilføj mapping for at tilføje en anden tilpasset kode.
5. Klik på Gem.

Opsætning af regneark

Definér strukturen af din fil i feltet Matrix. Oplist værdierne i den krævede rækkefølge vha. kommaer:

• identifikator — kolonnen indeholder kildestrengens unikke identifikator
• source_phrase — denne kolonne indeholder den egentlige tekst, der skal oversættes
• source_or_translation — Crowdin bør betragte teksterne i denne kolonne som kildestrenge til oversættelse og erstatte disse med de oversatte tekster, når resultatfilen downloades
• translation — de resulterende oversættelser placeres i denne kolonne
• context — enhver kontekstuel information, der hjælper oversættere med bedre at forstå kildetekstbetydningen
• max_length — definerer maks. længde på den oversatte tekst

Hvis et regneark indeholder oversættelserne for alle målsprog, kan du bruge indstillingen Flersproget regneark. Angiv også sekvensen af kolonner med oversættelser i den gemte Matrix, f.eks.: identifier,source_phrase,context,da,uk,ge (Sprogkoder).

Ønsker du ikke teksten i den første række oversat, så afkryds punktet Importér første linje som overskrift.

Opsætning af XML-filer

Oversæt indhold	Definerer, om tekster placeret mellem tags skal oversættes
Oversæt attributter	Definerer, om tags-attributter skal oversættes
Indholdssegmentering	Definerer, om lange tekster skal opdeles i kortere tekstsegmenter. Vigtigt! Denne indstilling umuliggør upload af eksisterende oversættelser til XML-filer, når den er aktiveret.
Oversætbare elementer	Dette er en matrix af strenge, hvori hvert element er XPaths tilet DOM-element, der skal importeres. Eksempelsti: /sti/til/node eller /sti/til/attribut[@attr]

Yderligere parametre

Flge. parametre kan ikke opsættes online:

• preserve_hierarchy - gemmer mappestrukturen i Crowdin
• dest - giver mulighed for at angive et filnavn i Crowdin
• type - giver mulighed for at angive en filtype i Crowdin
• update_option - beholder oversættelser og beholder/fjerner godkendelser fra de ændrede strenge under filopdateringen
• commit_message - ekstra commit-besked, der kan omfatte Git-tags
• export_languages - eksportér oversættelser for de angivne sprog

Når du gemmer online-opsætningen, oprettes en crowdin.yaml-fil i den opsatte gren. Du kan redigere denne fil manuelt for at tilføje de ønskede parametre. Læs mere om opsætningsfilen.

Gemme opsætning

Klik på Gem for at forhåndsvise den oprettede opsætnong.

Klik på Tilføj Filfilter, hvis du har forskellige filgrupper med forskellige opsætninger.

Er der flere grene i projektet, som deler samme opsætning, og for hvilke forskellige, filtre ønskes anvendt, så vælg Anvend filtre til alle oversættelige grene.

Klik på Gem for at gemme den oprettede opsætnong.

Efter at have gemt filtreringen, startes upload af lokaliserbare filer til Crowdin.

Se også

• GitHub-integration
• Bitbucket-integration
• Opsætningsfil