# Brug af &kbabel;

## Indledning

Sædvanligvis skrives programbeskeder og dokumentation på engelsk. Ved brug af et sæt omgivelser lavet af værktøjer og biblioteker er det imidlertid muligt at få dine foretrukne programmer, at tale dit indfødte ikke-engelske sprog. Denne tilpasningsprocessen til et bestemt sprog kaldes lokalisering. Lokaliseringsprocessen inkluderer at oversætte programmets brugerflade og dokumentation til de forskellige sprog, som brugerne har brug for og, i visse lande og områder at få inddata og uddata til at tilpasse sig til bestemte konventioner. &kbabel; er et værktøj, der hjælper dig i internationaliseringsprocessen med at få et programs brugerflade til at tale mange sprog.

Hvert program der er forberedt til internationalisering, gør en eller flere besked-katalog-filer tilgængelige for oversættelse. Endelsen for disse filer er `.pot`. POT er en forkortelse for Portable Object Template (overførbar objekt skabelon).

Hver oversæter tager en kopi af POT-filen og begynder at oversætte beskederne. Derved bliver filen til en PO-fil - 'Portable Object' og repræsenterer kun et sprog.

Hver oversætter tager en kopi af en af disse POT-skabeloner og giver sig til at udfylde de blanke felter: hver besked bliver oversat til det ønskede sprog. Filen der indeholder den oversatte tekst refereres til som en PO-fil (Portable Object).

Når alle beskederne er blevet oversat kompileres denne PO-fil til et maskinlæsbart binært format, kendt som en MO (Machine Object)-fil. Disse filer som gemmes med en `.mo` endelse, virker som en database for at minimere den tid det tager for programmerne at slå hver oversat besked op.

Der er et oplagt spørgsmål i luften. Behøver jeg at vide hvad der er indeni en PO-fil selv når jeg har &kbabel;? Svaret er desværre ja.. Der er situationer hvor et beskedkatalog bliver korrupt og skal ordnes manuelt. De fleste af disse problemer er de ubehagelige CVS-konflikter som opstår når en oversættelsesprocessen bliver koordineret af et cvs-system (concurrent version system, se CVS-dokumentation). &kbabel; kan ikke hjælpe dig meget hvis dette sker så der er behov for en teksteditor, og noget kendskab til PO-filer. Lad os se hvordan en PO-fil er lavet.

PO-filer består af par af beskeder—en msgid og en msgstr. msgid er tekst på engelsk og msgstr er teksten oversat til det aktuelle sprog. Teksten der følger med hver msgid og msgstr er indelukket i C-lignende dobbelt-citationstegn Et eksempel taget fra en PO-fil for &noatun;, er `msgid "Open a Playlist"`

Tomme linjer og linjer der begynder med `#` bliver ignorerede. Linjer der starter med et # repræsenterer kommentarer og er en nyttig måde at give en bemærkning med detaljer om filen som denne besked skal bruges i og, i tilfælde af programmørerne, til at sørge for ekstra kommentarer der kan hjælpe med oversættelsen. &kbabel; viser disse kommentarlinjer for hver besked.

I mange tilfælde er det første msgid-msgstr par i PO-filen en falsk indgang (der optræder som PO-fil overskrift) der indeholder forskellige oplysninger om de oversatte PO-fil, såsom programmets navn, oversættelsesdato, oversætternavn og så videre.

Nylige udgaver af &GNU; gettext tilføje endnu en nyttig i18n-egenskab der hedder flertalsformer. Engelsk bruger kun ental og én flertalsform for navneord, ⪚ 1 fil og 10 filer. Dette får mange udviklere til at tro at verden er så enkel og de kan bruge beskeder som Ønsker du at slette %1 file(r)?, hvor `%1` angiver et antal filer der skal slettes. Men dette er fundamentalt forkert. For Slovakisk oversættelse har du brug for 3 forskellige former af beskeden. Dette tal er forskelligt for forskellige sprog og selv når det er det samme, ⪚ bruger Tjekkisk også 3 former, kan reglen der afgør hvilken form der bruges være meget forskellig.

Flertalsformer i PO-filer er her for at hjælpe. Uheldigvis kan &kde;-udviklerne ikke lide flertalsform-implementeringen i &GNU; gettext og de introducerer derfor deres eget format og håndtering for dem.

## Editor

Her er et skærmbillede af &kbabel;. Af behagelighedsgrunde har &kbabel; væktøjslinjer der gør mange operationer hurtigere og, for brugere der har travlt, er der mange tastaturgenvej. Hovedvinduet er opdelt i fire dele.

Oppe til venstre er der et redigeringsfelt der kun er læsbar og indeholder det aktuelle msgid-felt fra den åbnede PO-fil og dens engelske tekst.

Nede til venstre er der et redigeringsfelt der indeholder msgstr-feltet relateret til den viste msgid. Her kan du redigere den oversatte tekst.

Oppe til højre er den del af vinduet der er et kommentar-panel hvor du kan se kommentarerne der er tilføjet til den indgang der bliver redigeret for øjeblikket.

Den kan bruges til:

- at finde ud af hvordan den aktuelle besked behandles af programmet (c-formateret eller simpel)

- i nogle tilfælde at læse hjælpsomme kommentarer tilføjet af programmets udvikler for at hjælpe oversætterne med deres arbejde—for eksempel, kan der være tekniske vink (brugt meget fint i LyX-projektet)

- når du har brug for at vide fra hvilken fil den aktuelle besked kommer, fordi du ønsker at rapportere en stavefejl i den originale engelske streng.

Skærmbillede af &kbabel; Skærmbillede af &kbabel;

Editor-vinduet (i nederste højre hjørne) er den mest sofistikerede del af &kbabel;'s hoved-vindue. Dens størrelse kan justeres ved at flytte opdelingslinjerne mellem den og kommentarruden. (panelet for oven til højre). Editor-vinduet har to fanebladspaneler—et til at gemme søge-information, det andet til sammenhængs-information. Sammenhængsinformationen indeholder en rullevisning med de 4 tidligere og de 4 næste indgange relativt til den aktuelle indgang—i virkeligheden en slags lille 'øjebliksbillede' af PO-filen. Når der oversættes er det meget almindeligt for strengene at de er relaterede til efterfølgende og tidligere beskeder, så sammenhængspanelet er nyttigt for at kigge på de nære beskeder for at få en indikation om, hvordan den aktuelle besked bedst kan oversættes. Dialog-grænseflade-oversættelse er et godt eksempel eller kontroller med deres tilknyttede tekst og "hvad er dette"-beskeder.

### Flere &kbabel;-egenskaber

Hvert msgid kan være i en af tre tilstande:

uoversat

- der er ingen nogen oversæt tekst tilknyttet denne msgstr

fuzzy

- `msgmerge` har forsøgt at matche en oversat streng ved at kigge i resten af PO-fil-indgangene. Dette virker ikke perfekt og man skal redigere den oversatte tekst så den passer til den aktuelle engelske tekst.

oversat

- msgid er den fuldstændigt oversatte udgave af msgstr

Den aktuelle indgangs tilstand indikeres af to LED'er. Afhængig af dine indstillinger kan disse være i statuslinjen eller over det oversatte strengs redigeringsfelt. Farverne på begge kan tilrettes (for at reflektere dine visuelle krav og din smag). Læs venligst Indstillinger sektionen for at se hvordan man kan justere dette.

## Avanceret oversættelse

Nu har du en idé om hvordan man oversætter en PO-fil. I dette afsnit vil vil følge standard-måden at oversætte en ny PO-fil, vedbrug af &kbabel;'s avancerede egenskaber. Vi antager du allerede har åbnet en skabelon POT-fil og gemt den som PO-fil.

### Navigation i PO-fil

&kbabel; lader dig navigere nemt gennem filen følgende tilstanden af de forskellige oversættelser. Den uoversatte/fuzzy-status blev allerede introduceret. En besked kan være markeret som forkert som et resultat af efterprøvningstjek eller efterprøvning gjort af `msgfmt`. Og &kbabel; understøtter naturligvis historikken af besøgte beskeder med Fremad/ Tilbage ligesom &konqueror;.

Alle kommandoer til navigation er i Kør-menuen.

Page Up | Gå til tidligere besked
Page Down | Gå til næste besked
&Ctrl;Page Up | Gå til forrige fuzzy besked.
&Ctrl;Page Down | Gå til næste fuzzy besked
&Alt;Page Up | Gå til forrige uoversatte besked.
&Alt;Page Down | Gå til næste uoversatte besked.
&Shift;Page Up | Gå til forrige besked med fejl
&Shift;Page Down | Gå til næste besked med fejl
&Ctrl;&Shift;Page Up | Gå til forrige fuzzy eller ikke oversatte besked
&Ctrl;&Shift;Page Down | Gå til næste fuzzy eller ikke oversatte besked

### Smart redigering

Smart redigering betyder at editoren vil hjælpe dig med nemt at rediger oversættelsen, mens den tager hensyn til det specielle ved PO-formatet. Den vil escape rigtigt når det er nødvendigt.

Den understøtter også mere end en tilstand for indsætning af linjeslut. Dette er meget nyttigt på grund af den måde gettext håndterer linjeslut. Den ignorerer dem simpelthen. (Du kan tænke på det som om al teksten i msgstr er en enkelt linje.) Hvis du ønsker at indsætte en rigtig linjeslut, skal du indsætte `\n`. Men de fleste iversættere er ikke klar over, at en nu linje i msgstr ikke tilføjer et mellemrum mellem linjerne. Dette kan nemt løses ved at tilføje et mellemrum ved slutningen af hver linje. Men det er også nemt at glemme, så smart redigering gør dette automatisk for dig.

Tabellen nedenfor opsummerer egenskaberne for smart redigering.

Tab | Indsæt \t
" | Indsæt \"
Enter | Hvis det sidste tegn før markøren ikke er et mellemrum, indsættes et mellemrum. Derpå startes en ny linje.
&Ctrl;Enter | Start en ny linje uden yderligere overvejelser
&Shift;Enter | Indsæt \n og start en ny linje

Hvis du ønsker at se hvor der er mellemrum, kan du slå Fremhæv baggrund til og/eller Markér hvidt med punkter i indstillingsdialogen under fanebladet Redigér Udseende.

### Automatisk oversættelse

Som et første trin i at starte en ny oversættelse, tilbyder &kbabel; en funktion for automatisk at udfylde beskeder med oversættelser af ældre oversættelser. Vælg Værktøjer Grov oversættelse og så vil &kbabel; præsentere følgende dialog:

Dialog for grov oversættelse

I dialogen, skal du angive hvad der skal oversættes og vælge kilderne for de gamle oversættelser.

Foroven i Hvad der skal oversættes-rammen er tre afkrydsningsfelter (Ikke oversatte indgange, Fuzzy indgange , Oversatte indgange) til at angive hvilken slags beskeder du ønsker at oversætte. Ikke oversatte og fuzzy indgange er naturlige valg for automatisk oversættelse, men du kan også ændre allerede oversatte beskeder.

Den nøjagtige matchning for msgid'er vil altid blive brugt til grov oversættelse. Du kan imidlertid tilføje flere strategier, &ie; Tillad fuzzy oversættelse (langsomt) og Tillad enkeltords-oversættelse. Begge disse yderligere strategier skal være understøttet af de kilder der bruges (se nedenfor). Der er ingen specifikation af hvad fuzzy oversættelse betyder, men formålet er ret klart. Enkelt-ords-oversættelse er kun passende for nogle sprog. &kbabel; vil forsøge at oversætte hvert ord i msgid separat og så putte de oversatte ord (eller udtryk) i samme rækkefølge i msgstr .

Som kilde for grov oversættelse, kan en vilkårlig ordbogsmodul der er tilstede bruges. Der er en liste af Brug ikke-moduler og Brug-moduler. Modulerne bruges i den rækkefølge de er i Brug-listen. Første modul bliver spurgt om en oversættelse. Hvis den ikke findes, spørges næste modul i listen og så videre. Du kan bruge knapperne med pile til at flytte moduler mellem listerne. Glem ikke at ændre rækkefølgen til at passe til dine behov ved Flyt op og Flyt ned-knapperne.

Normalt vil &kbabel; markere hver groft oversat besked som fuzzy, fordi den antager at enhver automatisk oversættelse skal gennemses af en oversætter. Hvis du er 100% sikker på at den automatiske oversættelse vil være korrekt, eller du alligevel vil gennemse oversættelsen, tilladerMarkér ændrede indgange som dig at slå denne automatiske fuzzy-markering fra, men du vil skulle bekræfte dette.

Når du har sat alle valgmuligheder til at passe dine behov, trykker du på Start for automatisk at oversætte beskeder. Du kan følge fremskridtslinjen, og hvis det skal være, kan du bruge Stop-knappen.

### Efterprøv din oversættelse

Alle laver fejl en gang imellem. Så &kbabel; understøtter et antal tjek for typiske problemer i oversættelser. Disse tjek (ikke syntaks-tjek) kan basalt set udføres på to måder.

Tjek kan udføres ved hver ændring af den oversatte tekst. Disse kaldes automatiske tjek og de kan slås til i &kbabel;'s indstillingsdialog. Automatisk tjekning af syntaks er mulig hver gang filen gemmes.

De automatiske tjek kan gøre &kbabel; langsom. Hvis du har en langsommere computer, kan du slå de automatiske tjek far og kun bruge den anden mulighed. Du kan starte alle slags tjek fra Værktøjer Validering. Så udføres tjek på alle beskeder i filen og de forkerte markeres som fejl.

Tjek syntaks

- Dette kalder på `msgfmt` for at tjekke gyldigheden af PO-filen som set af gettext-pakken. Den vil vise resultatet af kommandoen og markere forkerte msgstr'er.

Tjek argumenter

- Ukorrekte oversættelser kan få programmer til at bryde sammen. De farligste dele af oversættelserne er argumenterne, ⪚ til printf-lignende funktioner. Dette tjek sammenligner antal og typer af argumenterne i msgid og msgstr. De skal matche.

Tjek genvejstaster

- &GUI;-tekst indeholder almindeligvis acceleratorer, &ie; bogstaver der kan bruges til hurtig adgang til &GUI;-elementer fra tastaturet. Disse angives ved specielle tegn, ⪚ & i &kde;. Typiske krav til oversættelsen er at oversat tekst også skal indeholde acceleratorer. Dette tjek vil bemærke dette problem for dig. Accelerator-tegnet kan angives i Indstillinger på Diverse-fanebladet.

Kig efter oversæt sammenhængsinfo

- Du vil formodentlig kun behøve dette for &kde;-oversættelse. Noget af teksten er for almindelig og skal oversættes forskelligt i forskellige sammenhænge. I &kde; er sammenhæng beskrevet i begyndelsen af msgid efter den specielle sekvens `:_`. Men hvis en oversætter ikke er klar over denne konvention og forsøger også at oversætte sammenhængsinformationen, så vil dette tjek prøve at finde disse. Hvis det finder oversat sammenhængsinformation, bør du fjerne den.

Tjek flertalsformer

- Hvis msgid er angivet som en flertalsform, skal oversættelsen indeholde det rigtige antal oversættelser adskilt af `\n`. Det rigtige antal afhænger af sproget der oversættes til og er angivet under Identitet-fanebladet i Indstillinger-dialogen. Dette er kun implementeret for &kde; for øjeblikket.

Tjek ligninger

- Ligninger er et specielt format i msgid typisk brugt i .desktop-filer. Og fordi dine oversættelser vil blive flettet tilbage til disse filer, skal msgstr også bruge dette specielle format. Det betyder at oversættelsen skal starte (indtil den første forekomst af `=` med en samme tekst som den oprindelige besked, ⪚ `Name=`.

### Stavekontrol af oversættelsen

Som altid er det meget vigtigt at udføre stavekontrol på dine oversættelser før dine resultater bruges. På den måde kan du finde trykfejl og andre problemer i din oversættelse. &kbabel; bruger &kde;'s standardbibliotek til stavekontrol og dets standardindstilling kan findes i &kbabel;'s indstillingsdialog. Stavekontrollen selv kan findes i Værktøjer Stavning -undermenuen. Du kan bruge et antal tilstande til stavekontrol:

Stavekontrol...

- Dette er et generisk kald af en dialog, hvor du kan vælge stavekontrollens tilstand og sætte en standardtilstand. Dette startes med &Ctrl;I .

Tjek alt...

- Stavekontrol af alle beskeder i filen.

Tjek fra markørens position...

- Start stavekontrol ved positionen i den aktuelle besked og gå fremad mod enden af filen.

Tjek denne...

- Stavekontrol kun af denne besked.

Tjek markeret tekst...

- Hvis der er en markeret tekst i msgstr-editoren, er denne valgmulighed tilstede og den vil kun udføre stavekontrol på denne tekst.

### Oversættelse af &XML;, HTML, ...

Opmarkeringssprog bruges stadig mere i &GUI;. &kde;-projektet bruger også PO-filer til at oversætte DocBook dokumentationsfiler (som også er et opmarkeringssprog). &kbabel; indeholder en hel del funktionalitet til at understøtte denne tendens.

Her vil vi kun beskrive funktioner relateret til mærker brugt til selve opmarkeringen. Det andet problem introduceret bed brugen af opmarkeringssprog er oversættelse af længere tekster. Dette problem behandles ved diff-egenskaben beskrevet i det følgende afsnit.

Den aktuelle udgave af &kbabel; er i stand til at finde ud af hvilke mærker der bruges i msgid og give nem adgang til dem ved brug af følgende handlinger fra Redigér:

Indsæt næste mærke

- Dette indsættet næste mærke fundet i msgid i oversættelsen. &kbabel; finder mærket der skal indsættes ved at tælle antallet af mærker fra begyndelsen af oversættelsen.

Redigér Indsæt mærke

- Denne undermenu indeholder alle de forskellige opmarkeringsmærker fundet i den originale engelske streng. Ved at vælge en af dem kan du indsætte den ved den aktuelle position i den oversatte tekst.

### Vis forskellen

Som vi allerede har sagt indeholder nye programmer, i forsøget på at være brugervenlige, en masse længere beskrivende tekster, inkluderende opmarkeringer. Hvis en udvikler ændrer en del af tekst, vil &GNU; gettext-system i de bedste tilfælde, beholde den gamle oversættelse og markere den som fuzzy. (I de værste tilfælde vil du miste oversættelsen fuldstændigt, afhængig af hvor meget tekst der er ændret). Dette virker o.k., hvis en msgid er kort, fordi du så hurtigt kan finde ændringerne. Men hvis teksten er lang nok, vil du skulle kæmpe for at finde ud af hvad der er blevet ændret (For eksempel, kan det være en meget lille ændring lavet af korrekturlæserne.)

For at hjælpe, kan &kbabel; blive bedt om at slå op i den oprindelige msgid og vise forskellen. Ændringerne vises grafisk i vinduet for den Originale streng. Den nøjagtige metode kan sættes i &kbabel;'s indstillingsdialog. Værktøjer Diff Vis Diff vil vise de forskelle der er fundet. For at se den aktuelle tekst uden at være blandet med den tidligere bruges Værktøjer Diff Vis original tekst .

Du kan slå automatisk opslag af forskelle til og fra ved at vælge Værktøjer Diff Diff-tilstand . Når diff-tilstanden er til, starter forskelssøgningen når du går til en ny besked.

Som altid kan du bruge forskellige kilder til at finde den gamle version af teksten, der alle sættes i &kbabel;'s indstillingsdialog:

Oversættelsesdatabase

- Du kan bruge oversættelsesdatabasen til opslag af forskelle. Vi anbefaler stærkt at automatisk gemning af nyligt oversatte beskeder i oversættelsesdatabasen er slået til i Oversættelsesdatabasens indstillingsdialog. Denne tilstand kan slås til ved Brug beskeder fra oversættelsesdatabase.

Træ af de gamle filer

- Dette vil kun blive brugt hvis søgning i oversættelsesdatabasen er slået fra. Ved at sætte Basismappe for diff-filer kan du navigere &kbabel; til den fil der skal bruges til forskellen. Den tager den relative sti af den åbnede fil og bruger denne relative sti i mappen der er angivet her. Hvis der er en tilsvarende fil, vil den blive brugt. For at bruge denne metode, må du lave en kopi af gamle filer før hver opdatering.

Manuelt valgt fil

- Hvis foregående mulighed ikke virker rigtigt, kan du altid sæt forskelsfilen manuelt ved at vælge Værktøjer Diff Åbn fil for Diff.

Forskelsopslag er ikke altid akkurate, fordi PO-filen ikke indeholder nogen reference til den originale besked.

## Flertalsformer

Idet flertalsformer er et ret kompliceret problem, bruger vi et helt afsnit til deres understøttelse i &kbabel;.

&kbabel; kan kun læse &GNU; flertalsformer, men kan ikke redigere dem. Den understøtter kun &kde;'s udgave af flertalsformer for øjeblikket.

Hvert sprog, som &kde; bliver oversat til, må have et rigtigt antal flertalsformer sat. Dette gøres ved at oversætte en indgang i `kdelibs.po`. Antallet sættes ved at vælge navnet på et sprog, som bruger det samme antal regelsæt for at finde den rigtige flertalsform. Den opdaterede liste af mulige værdier kan findes i kdelibs kildekode, i filen `kdecore/klocale.cpp`.

&kde;'s flertalsformer er angivet som kommentar `_:` der indeholder `%n`-argumentet. Dette argument bruges så i beskeden selv og det kontrollerer hvilken flertalsform i dit sprog der skal bruges afhængig af reglerne for dit sprog.

Oversættelsen af en flertalsformbesked skal have et specielt format. Den skal indeholde det rigtige antal oversættelser (en for hver flertalsform) adskilt af et linjeskift `\n`. For eksempel vil Markerede %n filer oversat til slovakisk vil være:

    Vybraný %n súbor\n
    Vybrané %n súbory\n
    Vybraných %n súborov

For at tjekke om din oversættelse indeholder det rigtige antal flertalsformer, bruges Værktøjer Validering Tjek flertalsformer (kun KDE) -menuen.