Instruktioner til oversættere

Fra GLFPD Wiki, den frie encyklopædi

(Forskelle mellem versioner)

Versionen fra 3. jan 2009 kl. 16:04

Denne guide er beregnet til nye oversættere og forklarer, skridt for skridt, hvordan man laver en opdatering af en eksisterende oversættelse eller starter en ny. Ved første øjekast kan denne guide virke lidt lang, men den besvarer mange af de spørgsmål som man typisk render ind i som ny oversætter, så prøv at komme igennem den. Oversættelser opbevares og vedligeholdes i po-filer, så guiden vil starte med en forklaring af formatet af po-filer.

Eventuelle kommentarer eller ændringsforslag sendes til dansk-gruppens e-mail-liste (dansk@dansk-gruppen.dk).

Indholdsfortegnelse

1 po-filer (Gettext)
2 Hjælpeprogrammer (poabc og podiff)
3 Oversættelsesproceduren
4 Retningslinjer og fif til oversættelsesarbejdet

po-filer (Gettext)

Internationalisering og lokalisering håndteres indenfor fri software hovedsageligt, ved hjælp af et program som hedder Gettext. Måden det fungerer på er, at alle de tekststrenge som skal bruges i et program skrives på en bestemt måde, som gør det muligt at samle dem alle sammen i en po-fil. Denne fil kan så oversættes og oversættelserne kan begefter hives tilbage og bruges i programmet. Det betyder, at alle de tekststrenge, som skal oversættes, er samlet i en enkelt fil (en po-fil) og for en oversætter er det derfor kun nødvendigt at lære hvordan denne fil ser ud, og ikke (sådan som nogle frygter) at skulle lære det programmeringssprog programmet er skrevet i.

En po-filsektion

En po-fil består af mange små sektioner af tekst (adskilt af en blank linje). Hver bid svarer til én tekststreng fra programmet. En sådan sektion har den følgende struktur:

blank linje
#  oversætterkommentarer
#. kommentarer trukket ud af kildekoden
#: reference...
#, mærker...
#| msgid "tidligere uoversatte streng"
msgid "uoversatte streng"
msgstr "oversatte streng"

Linjen som begynder med msgid er den uoversatte streng, altså den streng i programmet som programmøren har markeret til oversættelse. Linjen som begynder med msgstr er den dertil hørenden oversættelse og altså den linje, som man som oversætter skal udfylde. Alle linjerne som starter med # er kommentarer. Der er forskellige typer af kommentarer, som tjener forskellige formål. De kan kendes fra hinanden alt efter hvilket tegn som følger umiddelbart efter #.

# er en oversætterkommentar. Her kan oversætterne lave kommentarer om deres oversættelse, enten til sig selv eller til den næste oversætter af projektet. Disse er virkelig praktiske, hvis man har været nødt til at lave research til oversættelsen af en bestemt streng, for at sikre at den viden og det arbejde ikke går tabt.
#. er en programmørkommentar til oversætterne. Enhver kommentar som programmøren skriver umiddelbart før en streng, som er markeret til oversættelse, vil blive trukket ud og tilføjet po-filen sådan så programmørerne har muligheden for at forklare meningen med en bestemt streng.
#: er kildekodereferencer. Her vil stå filnavne og linjenumre, på de steder i kildekoden hvor den pågældende streng står.
#, er mærker som er tildelt den pågældende streng. Disse er som regel mærker, der beskriver hvilket programmeringssprog strengene kommer fra. Derudover kan strengene også tildeles mærket fuzzy. Dette mærke bruges enten, hvis der i forvejen var en oversættelse, men originalstrengen eller positionen af denne ændrer sig i kildekoden, i det tilfælde vil mærket være påhæftet automatisk af programmet som trækker oversættelser ud af kildekoden. Men mærket kan også bruges af oversætterne selv, til at indikerer at arbejdet med denne streng ikke er færdigt. Så længe mærket fuzzy er til stede, vil den pågældende streng ikke bliver brugt.
#| er en ny form for kommentar, som bruges til at vise den gamle originalstreng, hvis den er ændret i kildekoden. Dette er ment som en service overfor oversætteren, således at når man kommer til en fuzzy streng, så behøver man ikke at gætte på hvordan den har ændret sig, men kan med det samme se det, og derved lettere finde ud af hvordan man skal ændre sin oversættelse.

po-filhovedet

Den første streng i en po-fil, som har en msgid som er tom (""), er speciel. Denne bliver brugt som en filhoved og bruges til at indeholde forskellig information. Et filhoved bør se ud som dette her fra gedit:

# Danish translations of gedit.
# Copyright (C) 1999-2007 Free Software Foundation, Inc.
# This file is distributed under the same license as the gedit
package.
#
# Birger Langkjer <birger.langkjer@image.dk>, 1999.
# Kenneth Christiansen <kenneth@gnome.org>, 1999, 2000.
# Keld Simonsen <keld@dkuug.dk>, 2000, 01.
# Ole Laursen <olau@hardworking.dk>, 2002, 03, 04, 05, 06.
# Marie Lund <marielund@post.cybercity.dk>, 2004.
# Martin Willemoes Hansen <mwh@sysrq.dk>, 2004.
# Kenneth Nielsen <k.nielsen81@gmail.com>, 2006, 2007.
# Ask Hjorth Larsen <asklarsen@gmail.com>, 2007.
# M.P. Rommedahl <lhademmor@gmail.com>, 2008
#
# Husk at tilføje dig i credit-listen (besked id "translator_credits")
#
# Konventioner:
#
#   plugin -> udvidelsesmodul
#   snippet -> tekststump
#
msgid ""
msgstr ""
"Project-Id-Version: gedit.gnome-2-16\n"
"Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug.cgi?"
"product=gedit&component=general\n"
"POT-Creation-Date: 2009-01-01 19:23+0000\n"
"PO-Revision-Date: 2008-10-04 11:20+0200\n"
"Last-Translator: Kenneth Nielsen <k.nielsen81@gmail.com>\n"
"Language-Team: Danish <dansk@dansk-gruppen.dk>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

I kommentaren til denne specielstreng findes først noget ophavsretsinformation, her skal man som oversætter huske at opdatere årstallet således at det stadig inkluderer det år man er i. Derefter følger en liste af navne og e-mail-adresser for alle de oversættere, som har arbejdet på filen, her skal man selvfølgelig også skrive sig selv på. Dette er også et godt sted at kigge, hvis man af forskellige årsager vil kontakte sidste oversætter. Her er også en kommentar om at man skal huske at skrive sig selv på "credit"-listen, mere om det senere. Derefter følger en liste af konventioner som de forskellig oversættere har lavet for denne oversættelse, husk at bruge og opdatere denne. Efter kommentaren komme selve strengen som indeholder forskellige former for specielinformation. Der er kun 3 af linjerne som man behøver at bekymre sig om som oversætter. Man skal opdatere linjen Last-Translator med sit eget navn og e-mail, samt sikre sig at linjen Language-Team indeholder informationen Danish <dansk@dansk-gruppen.dk>, hvis den ikke gøre det i forvejen. Derudover er der linjen Plural-Forms som beskriver hvilke man flertalsformer man har på det på sprog som filen oversættes til, mere om det senere.

Flertalsformer

Når man skriver tekststrenge i et program, har man muligheden for at skrive en variabel ind i strengen, som vil blive erstattet af noget andet, f.eks. et tal eller noget andet tekst. Hvis det der bliver sat ind er et tal vil det være nødvendigt for at strengen at ændre sig alt efter hvad dette tal er. Det forklares måske nemmest med at eksempel, igen fra gedit

#: ../gedit/gedit-commands-file.c:266
#, c-format
msgid "Loading %d file..."
msgid_plural "Loading %d files..."
msgstr[0] "Indlæser %d fil..."
msgstr[1] "Indlæser %d filer..."

I denne type af strenge er der nu 2 msgid'er, en for hver af de forskellige former der er på engelsk. Herefter skal der så være en msgstr for hver af de forskellige flertalsformer der findes på dansk. Efter msgstr[0] skal stå den danske streng, som svarer til at der er nøjagtig 1 og efter msgstr[1] skal stå den streng som svarer til at der er 0 eller mere end 1. Grunden til at man har lavet det på denne måde, i stedet for bare at lave det som 2 streng, er at andre sprog har væsentligt mere indviklede regler for flertalsformer og i flere end 2 former.

VIGTIGT: Eftersom det kan variere fra sprog til sprog hvordan man laver flertalsformer er man nødt til at definere dette i filen hvis der findes sådan nogle plural-streng som denne her. Dette gøres med den linje i filhovedet som starter med Plural-Forms: og den skal for danske oversættelser have værdien nplurals=2; plural=(n != 1);. Hvis man støder på en uoversat flertalsstreng, skal man derfor sikre sig at denne linje er i filhovedet, eller får man en fejl senere når man kontrollerer filen for fejl.

Specielle entiteter i strenge

De fleste strenge indeholder blot almindelig tekst, men der er også indtil flere specielle ting som man kan støde på og som det som ny oversætter kan være svært at vide hvad man skal gøre ved. Disse er beskrevet i de følgende undersektioner.

Variable

Som tidligere nævnt kan man bruge variable i programstrenge og bruge disse til at få sat et eller andet ind i strengen. Det kan være alt lige fra tal, fil-navne eller -stier eller blot noget andet tekst. Der vil så stå en variabel, det sted i strengen hvor dette skal sættes ind. Hvordan disse variable ser ud, vil afhænge af hvilket programmeringssprog programmet er skrevet på. Det kan f.eks. være sådan nogle som %s, %d og %i. Der er for mange muligheder inden for de forskellige sprog til at skrive dem alle sammen her, så hvis man som oversætter er i tvivl om noget er en variabel må man endelig spørge. Det vigtig ved disse strenge er at man bevarer dem. Når man er færdig med strengen, skal der altid stå de samme variable som der gør i originalstrengen. Nogle gange vil det være nødvendigt at bytte rundt på rækkefølgen af disse variable og her skal man være forsigtig. Måden at gøre dette på vil varierer fra sprog til sprog og hvis man støder på problemet, er det derfor nemmere at spørge og så finder vi en løsning.

Genvejstegn

Strenge som skal have et bogstav associeret med sig, således at disse bogstaver kan komme til at fungere som genvejstegn (kendetegnet i programmer ved at der er en streg under bogstavet), håndteres i oversættelser ved at sætte et tegn foran det bogstav som skal være genvejstegn. Hvilket tegn der bliver brugt til at markere dette kan variere fra projekt til projekt, men i næsten alle GNOME-relaterede projekter bruger bundstregen "_". Et eksempel på sådan en streng kunne være "Save" i filmenuen, vist hernedenunder

msgid "_Save"
msgstr "_Gem"

På engelsk er der valgt "s" som genvejstegn og i den danske version har man valgt "g". Det er vigtigt at sørge for, at man får defineret sådan et genvejstegn, når der er et i originalstrengen. Det er også vigtigt at man tænker lidt over hvilke tegn man bruger, sådan at genvejtegnene bliver så konsistente som muligt på tværs af programmerne og at man ikke bruger det samme tegn til flere strenge i f.eks. den samme menu.

Opmærkning

I visse sammenhænge bliver de tekststrenge som skal oversættes formatteret ved hjælp af opmærkning i stil med måden man skriver hjemmesider på. Så hvis man f.eks. vil have noget tekste med fed skrifttype så skriver man <bold>fed tekst</bold>. Det sidste, som har en skråstreg i sig, er det afsluttende eller lukkende mærke. Man kan indlejre sådanne mærker, således at hvis man i en streng som er fed vil have noget til både at være med fed og på skrå kan man skrive <bold>både fed <italic>'og på skrå'</italic></bold>. Det er vigtigt at lukke indlejrede mærker på samme måde som i originalen.

Lodret stregtegn "|" (en. pipecharacter)

Hvis den samme tekststreng optræder mere end en gang i et program, vil Gettext samle det til en sektion i po-filen, som vil have flere kildekodereferencer. Selv om dette er rigtigt smart og hjælper ufattelig meget i langt størstedelen af tilfældende er der visse tilfælde hvor det ikke duer. Det kan være hvis det samme ord kan betyder mere end en ting og bruges forskellig flere steder i programmet. Det kunne (som et tænkt eksempel) være et program hvor man måler ydelse af et eller andet og samtidig kan gemme og indlæse profiler for hvordan det bliver vist. I sådan et program kunne man forestille sig at strengen "Load" bliver brugt, både i betydningen "Belastning" og i betydningen "Indlæs". Hvis strengene bliver samlet til en er det selvfølgelig ikke muligt at oversætte det til to forskellige ting. I et lang stykke tid er det blevet ordnet ved at man har hæftet et stykke kontekst på før strengen adskilt fra selv strengen med en "|" og man har så i en kommentar bedt oversætterne om kun at oversætte det efter "|". Dette ville så betyde at der nu i stedet vil være to strengen f.eks. "Noun|Load" og "Verb|Load" som skal oversættes forskelligt. Det er meget vigtigt at være opmærksom på at gøre dette rigtigt og kun oversætte det efter "|". Denne metode er imidlertid meget sårbar for fejl og man er lige nu (December 2008) i gang med at implementere en erstatning for dette system. Løst forklaret vil dette nye system betyde, at der vil komme et ekstra felt ligesom msgstr og msgid som hedder msgctxt hvor strengens kontekst vil komme til at stå, i stedet for i selve strengen. Dette vil blive forklaret nærmere når implementeringen er nået længere.

"translator-credits"-strengen

I nogle programmer findes en speciel streng med msgid "translator-credits". Denne bruges sådan, at det den bliver oversat til, indsættes i en boks med folk som har bidraget til oversættelse. Det betyder at i stedet for at oversætte den ordret skal man i stedet for indsætte en liste over folk som har bidraget til oversættelsen, samt hold- og kontakt-information. Indenfor GNOME-oversættelser bruges altid an standard måde at udforme denne på som ser ud som nedenfor:

#: ../gedit/gedit-commands-help.c:106
msgid "translator-credits"
msgstr ""
"Birger Langkjer\n"
"Keld Simonsen\n"
"Kenneth Christiansen\n"
"Marie Lund\n"
"Martin Willemoes Hansen\n"
"Ole Laursen\n"
"Kenneth Nielsen\n"
"M.P. Rommedahl\n"
"\n"
"Dansk-gruppen <dansk@dansk-gruppen.dk>\n"
"Mere info: http://www.dansk-gruppen.dk"

Som det kan ses, er det altså først en liste af navne på bidragsyderne, herefter en blank linje og til sidst to linjer med navn og kontaktinformation for holdet.

Hjælpeprogrammer (poabc og podiff)

Ud over det program man bruger til at redigere po-filen med, er der to små kommandolinjeprogrammer som bruges i løbet af et oversættelsesforløb, poabc og podiff.

poabc

poabc (ABC står for Automatic Blunder Corrector) er et program, som man kan bruge til at lede efter typiske fejl i en oversættelse, efter at man er færdig med den. Blandt de fejl som poabc kigger efter er om man har glemt strengens afsluttende punktum eller mellemrum, at man ikke har korrekt stort eller lille bogstav i starten og om man har husket genvejsbogstavstegnet hvis der er sådan et i originalen. poabc køres fra terminalen, med filen der skal tjekkes som argument

poabc gedit.po

og vil give uddata som det nedenunder.

=== Line 1127 : Hotkey assignment inconsistency ===
msgid "Simulation of (S)VCD burning"
msgstr "_Simulering af (s)vcd-brænding"

=== Line 1664 : Leading character type or case mismatch ===
msgid "Session Import Error"
msgstr "sessionsimport-fejl"

=== Line 1694 : Trailing characters or punctuation mismatch ===
msgid "Please, delete some files from the project."
msgstr "Slet nogle filer fra projektet"

Uddata ovenfor viser de mest typiske former for fejl som poabc vil rapportere i sin uddata. Desværre vil de kriterier som poabc er sat til at registrer som fejl, også nogle gange give falske positive, altså advarsler hvor der ikke er noget i vejen. Det er dog hurtigt at gennemgå uddata fra poabc og sortere de falske advarsler fra og bruge de rigtige, og brugen af poabc vil ofte fange en del fejl, selv for rutinerede oversættere. Et eksempel på en falsk fejlbesked kan se nedenfor.

=== Line 708 : Leading character type or case mismatch ===
msgid "%s only"
msgstr "kun %s"

Her har poabc taget fejl, fordi den fordi den forventer at strengen starter med et tegn, men i den danske streng er variablen rykket over til sidst og derfor starter den danske streng med et bogstav. Man kan også bede poabc om at tjekke om filens syntaks er korrekt (mere om hvordan man gør det manuelt længere nede). Dette gøre med tilvalgt m efter kommandoen

poabc m gedit.po

podiff

podiff bruges til at dokumentere de ændringer, man har lavet i en po-fil under en opdatering, på en sådan måde at det er nemt at læse korrektur på ændringer. Dansk-gruppen læser korrektur på alle oversættelser før de integreres, men for at man ikke skal læse hele oversættelsen igennem, hver gang der bliver foretaget en opdatering, gennemlæses kun de dele af filen som er blevet opdateret.

Måden podiff bruges på er som følger. Når man skal til at opdatere en oversættelse vil man først hente den fil ned man skal arbejde med. Før man går i gang med oversætterarbejdet laver man en kopi af denne fil, som skal dokumentere hvordan filen så ud før (hvilket er nødvendig fordi podiff skal dammenligne før med bagefter). Denne ubearbejdede kopi kaldes her for "gammel.po". Efter at oversættelsen er færdig og kontrolleret på alle tænkelige måder, har man en anden fil, som her kaldes for "ny.po". Med disse to filer kører man podiff på følgende måde

podiff gammel.po ny.po

Dette vil så udskrive uddata til terminalen. Eftersom man senere skal vedhæfte dette til e-mail, er det praktisk at få gemt dette uddata til en fil. Det gør man ved at videresende uddata til en, på følgende måde

podiff gammel.po ny.po > gammel_ny_diff.podiff

Uddata fra podiff vil typisk se ud på følgende måde, bemærk at et "-" foran en streng betyder at det var sådan, den så ud i "gammel.po" og et "+" foran en streng betyder, at det er sådan den ser ud i "ny.po"

 #: ../xfburn/xfburn-device-box.c:627 ../xfburn/xfburn-device-box.c:670
 msgid "Cannot access drive (it might be in use)"
-msgstr ""
+msgstr "Kan ikke tilgå drev (det er muligvis i brug)"

 #: ../xfburn/xfburn-blank-dialog.c:360
-#, fuzzy
 msgid "No disc detected in the drive."
-msgstr "Ingen disk er fundet i drevet"
+msgstr "Ingen disk er fundet i drevet."

Her ses to typiske eksempler på en opdateringsstreng. Den første er en uoversat streng som er blevet oversat. Det kan ses idet der var en tom msgstr i "gammel.po" og en dansk tekststreng i "ny.po". Den anden er en streng er en som er blevet fuzzy. Det er den, i dette her tilfælde, højst sandsynligt blevet fordi udviklerne har tilføjet et punktum til sidst i strengen. Man kan se, at det oversætteren har gjort, er at opdatere oversættelsen, sådan så den passer til denne ændring, således at oversættelsen nu også har et punktum til sidst, samt at fjerne fuzzy-mærket fra mærkekommentaren. fuzzy-mærket var blevet indsat automatisk fordi Gettext har indset at dette højst sandsynligt stadig er den gamle streng der er tale, men at den blot er blevet ændret.

Installation af poabc og podiff

Både poabc og podiff er simple eksekverbare Python-skripter og skal som sådan ikke "installeres", men blot hentes ned, gøres eksekverbare og placeres i ens $PATH.

For poabc gøres følgende (disse er kommandoer der skal køres i en kommandoskal)

wget http://www.student.dtu.dk/~ashj/translation/poabc
chmod +x poabc
sudo mv poabc /usr/local/bin/poabc

for podiff er proceduren den samme

wget http://www.student.dtu.dk/~s021749/podiff/podiff.py
chmod +x podiff.py
sudo mv podiff.py /usr/local/bin/podiff

herefter er disse to programmer tilgængelige ligesom almindelige kommandoer.

Oversættelsesproceduren

Denne sektion beskriver selve oversættelsesproceduren. Det er lavet som en nummereret punktopstilling, således at hvis man løber ind i problemer, kan man henvise til det punkt man er nået til. I det følgende vil filen gedit.po blive brugt som eksempel på den fil som skal oversættes (bemærk at filer man henter ned som regel har noget længere navne, fordi navnet også indeholder information om hvilken udviklingsgren den er en del af, men det betyder ikke noget for proceduren).

Find en oversættelse som du har lyst til at tage fat på (f.eks. gedit) og send en e-mail til dansk-gruppens e-mail-liste med emnet "Jeg går i gang med gedit". Hvis du ikke har været på listen så længe, så vent gerne lige en dags tid for at se om der er nogen som protesterer, enten fordi de allerede er i gang med den, eller fordi de selv tidligere har oversat den og godt kunne tænke sig at fortsætte med det.
Hent filen ned fra internettet.
Lav en kopi af filen sådan som den ser ud før du går i gang med at oversætte den (F.eks. med følgende kommando: cp gedit.po gedit_gammel.po)
Oversæt filen ved brug af et af de programmer som er beskrevet her, eller et andet hvis du foretrækker, og gør brug af retninglinjer og fif nedenfor.
Efter endt oversættelse, stavekontrol, poabc-check og syntakscheck (som beskrevet nedenfor) er filen klar til at blive gennemlæst. Nu laves en podiff for at dokumentere de ændringer du har lavet, f.eks. med følgende kommando: podiff gedit_gammel.po gedit.po > gedit_gammel_ny.podiff
Uddata fra podiff sendes til gennemlæsning på dansk-gruppens e-mail-liste. Det gøres ved at sende en mail til listen med emnet "gedit til gennemlæsning [antal strenge som er opdateret]", hvor uddata fra podiff både indsættes i brevkroppen og vedhæftes som fil.
Når du modtager kommentarer fra en gennemlæser gennemgår du dem, og retter din oversættelse til. Hvis der er noget som du er uenig i skriver du bare tilbage, hvorefter du og gennemlæser (og evt. andre) kan tage en diskussion om stridpunkterne. Hav lidt tålmodighed med gennemlæsningen, vi er alle samme frivillige og det er ikke sikkert at der er nogen som har tid til at lave gennemlæsningen omgående.
Når alle kommentarer fra gennemlæseren er behandlet, er oversættelsen færdig og den sendes til integration. Det gøres ved at sende en e-mail til dansk-gruppens med emnet "gedit til integrering", hvorefter en fra dansk-gruppen som har integreringsrettigheder til det pågældende projekt vil integrere den og bekræfte dette i en e-mail
Hop tilbage til 1 ;)

Retningslinjer og fif til oversættelsesarbejdet

Hentet fra "http://wiki.dansk-gruppen.dk/index.php/Instruktioner_til_overs%C3%A6ttere"