# 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 lokaliseringsprocessen 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æ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 meddelelser er blevet oversat så kompileres PO-filen til et maskindlæsbart binært format, som er kendt som en MO-fil (Machine Object, maskinobjekt). Disse filer, som opbevares med filendelsen `.mo`, fungerer som en database for at minimere tiden det tager for programmet at slå hver oversat meddelelse op.

Et spørgsmål trænger sig på: behøver jeg at vide hvad der findes inde i en PO-fil selvom jeg har &kbabel;? Svaret er, uden tvivl, ja. Der findes situationer hvor en meddelelsemappe kan være fejlagtig, og skal rettes i hånden. De fleste af disse problemer er de hadede CVS- eller SVN-konflikter som opstår når en oversættelsesproces koordineres med et versionshåndteringssystem såsom CVS eller Subversion (SVN). &kbabel; kan ikke hjælpe dig særlig meget hvis et sådant problem opstår, så en teksteditor og en vis kundskab om PO-filer behøves. Lad os se hvordan en PO-fil er opbygget.

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.

En nyttig funktion kaldes flertalsformer. Engelsk bruger kun en entals- og en flertalsform af substantiver, f.eks. 1 file og 10 files. Det gør at mange udviklere tror at verden er så enkel, og at de kan bruge meddelelser såsom Do you want to delete %1 file(s)?, hvor `%1` angiver antal filer som skal fjernes. Men dette er i grunden fejlagtigt. For oversættelse til slovakisk behøves tre forskellige former for meddelelsen. Dette antal er forskelligt for forskellige sprog og selvom det er det samme, som f.eks. for tjekkisk hvor tre former også bruges, så kan reglerne for at vælge formen som skal bruges være meget forskellige. Flertalsformer i PO-filer er til for at hjælpe til med det.

&kde;-udviklerne har valgt en anden implementering af flertalsformer end &GNU; gettext, og introducerede sit eget format for at håndtere dem. Det planlægges at bruge &GNU;-gettext flertalsformer i &kde; version 4.

## Editor

Her er et skærmaftryk af &kbabel;

Skærmbillede af &kbabel; 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.

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 i 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 &GNU;'s 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 oversat 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 stavekontrol af oversættelsen udføres inden resultatet bruges. På den måde kan man finde stavefejl og andre problemer med oversættelsen. &kbabel; bruger &kde;'s standardbibliotek for stavekontrol, og standardindstillingen findes i indstillingsdialogen for projektet. Stavekontrollen selv findes i undermenuen Værktøjer Stavning. Du kan bruge et antal forskellige varianter af 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;.

Dette afsnittet handler om &kde;'s flertalsformer (for at være præcis, i &kde; version 3). Fra &kbabel; version 1.11 (KDE 3.5) og fremad, skal &kbabel; også kunne læse, redigere og gemme &GNU;-gettext pluralformer.

Hvert sprog, som &kde; bliver oversat til, må have et rigtigt antal flertalsformer sat. Dette gøres ved at oversætte en specifik indgang i `tdelibs.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 tdelibs kildekode, i filen `tdecore/tdelocale.cpp`.

&GNU;-gettext tillader at antal og type af flertalsformer defineres med en formel, og at indstille formlen uafhængigt for hver PO-fil. &kde; kan kun definere antallet og typen af flertalsformer en gang i tdelibs.

&kde;'s flertalsformer er angivet som kommentar `_n:` (inklusive efterfølgende mellemrum) 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 flertalsform-meddelelse skal have et særligt format. Den skal indeholde det rette antal oversættelser (en for hver flertalsform) adskilt af et nylinje-tegn `\n`, uden noget `_n:` (også uden mellemrum). For eksempel, skal _n: Selected 1 file\nSelected %n files oversat til slovakisk 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.