# Översättningsguide för &kturtle;

Som du förmodligen redan vet, är det unika kännetecknet med programspråket &logo; att &logo;-kommandon ofta översätts till programmerarens språk. Det tar bort en barriär för att förstå programmeringens grunder för många elever. När &kturtle; översätts till ett nytt språk måste ytterligare några filer översättas i förutom de vanliga strängarna och dokumentationen. Dock skapas det mesta automatiskt av Rafael Beccars skript. Skripten finns i `kdeedu/kturtle/scripts`, och filerna som behöver översättas finns i `kdeedu/kturtle/data`. I dessa kataloger hittar du också README-filer som innehåller instruktioner om hur de används eller översätts.

## Skapa en katalog som ska innehålla de översatta filerna

Först måste du skapa en katalog där de översatta filerna ska lagras. Skapa en katalog som heter `kde-i18n/kod/data/kdeedu/kturtle/` i din KDE CVS-katalog, där kod är din landskod (2 eller 4 bokstävers ISO-kod).

Kopiera filen `Makefile.am` från `kdeedu/kturtle/data/` till den här katalogen. Öppna den med din favoriteditor, ersätt alla förekomster av en_US i filen med din landskod (den som används ovan), och spara filen.

## Hur &logo;-nyckelord (kommandon) ska översättas

- Kopiera filen `logokeywords.en_US.xml` från `kdeedu/kturtle/data/` till katalogen du just har skapat, och byt namn på den till `logokeywords.kod.xml`, där kod är din landskod (2 eller 4 bokstävers ISO-kod).

- Översätt innehållet i taggen `keyword` till ditt eget språk (dvs. informationen mellan `keyword` och `keyword`) när det är möjligt, och innehållet i taggen `alias` (dvs. informationen mellan `alias` och `alias`). Deras innehåll hör ihop på så sätt att alias är en förkortning av keyword.

  Översätt till exempel while i `keyword`while`keyword`

  Var snäll översätt inte något annat och översätt inte engelska ord i `command name="engelskt_ord"`. De måste förbli på engelska.

  Till sist: ändra inte ordningen i filen, eftersom den behövs av Rafael Beccars skript för att skapa automatiska översättningar.

- Spara filen som UTF-8 (använd Spara som... i &kate; och byt till utf8 i rutan till höger om filnamnet).

- Arkivera filen (lägg till ditt filnamn i `Makefile.am`) eller skicka den till Anne-Marie.

- Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf annemarie.mahfouf@free.fr för mer information.

## Hur filerna för syntaxfärgläggning ska översättas

Att översätta `logohighlightstyle.en_US.xml` är en lätt match när Rafael Beccars skript i `kdeedu/kturtle/data/` används. Försäkra dig om att du läser README-filen i den katalogen.

För att fungera för alla de som inte vill använda välsignelsen med perl-skripten som nämns i föregående stycke, beskrivs det gammalmodiga sättet att göra det här:

- Kopiera filen `logohighlightstyle.en_US.xml` från `kdeedu/kturtle/data/` till katalogen du skapade för att lagra den översatta nyckelordsfilen, och byt namn på den till `logohighlightstyle.kod.xml`, där kod är din landskod (2 eller 4 bokstävers ISO-kod).

- På rad 4 i filen finns `language name="en_US"`..., här ändrar du en_US till ISO-koden för ditt språk (2 eller 4 bokstäver).

- Översätt innehållet i taggen `item` till ditt eget språk (dvs. informationen mellan `item` och `item`). Innehållet måste stämma med filen `logokeyword`. Översätt till exempel while i `item` while `item` och lämna mellanslagen som de är (ett i början och ett i slutet). Var snäll och översätt ingenting annat.

- Spara filen som UTF-8 (använd Spara som... i &kate; och byt till utf8 i rutan till höger om filnamnet).

- Arkivera filen (lägg till ditt filnamn i `Makefile.am`) eller skicka den till Anne-Marie.

- Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf annemarie.mahfouf@free.fr för mer information.

## Hur exemplen ska översättas

Återigen förenklas uppgiften en hel del av Rafael Beccars skript i `kdeedu/kturtle/data/`. Försäkra dig om att du läser README-filen i den katalogen, eftersom ett visst arbete fortfarande måste göras efter Logo-exempelfilerna har översatts automatiskt.

Efter du följt instruktionerna som ges i README-filen som finns i katalogen scripts, är du nu nästan färdig. Glöm inte att testa den översatta Logo-exempelkoden du skapade, eftersom det är mycket vanligt att ett fel smyger sig in. Försäkra dig också om att `Makefile.am` i `kde-i18n/kod/data/kdeedu/kturtle/` uppdateras enligt de nya filerna. För holländska ska `Makefile.am` se ut så här:

    txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
    bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
    kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
    txtdir = $(kde_datadir)/kturtle/examples/nl

    xml_DATA = logohighlightstyle.nl.xml
    xmldir = $(kde_datadir)/katepart/syntax

    keywords_DATA = logokeywords.nl.xml
    keywordsdir = $(kde_datadir)/kturtle/data
    EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)

Här är en beskrivning av hur översättningen görs UTAN att använda Rafaels perl-skript:

- Kopiera de engelska exemplen från `kdeedu/kturtle/data/` till katalogen som används för att lagra de översatta nyckelorden och filerna för syntaxfärgläggning. Översätt filnamnen på exemplen i din katalog: Det gör det möjligt för användare att enkelt och snabbt förstå vad exemplen handlar om.

- Översätt nyckelorden i exemplen, med de i `logokeywords.xml` till ditt språk. Nyckelordsfilen måste vara gjord först, innan exemplen översätts.

- Spara filen som UTF-8 (använd Spara som... i &kate; och byt till utf8 i rutan till höger om filnamnet).

- Arkivera katalogen (lägg till en `Makefile.am` i den) eller skicka den till Anne-Marie.

- Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf, annemarie.mahfouf@free.fr för mer information.

- Till sist, om du vill, kan du lägga till egna exempel i katalogen.