# Översättningsguide för &kturtle;

Som du vet är en unik egenskap hos programspråket &logo; att &logo;-kommandon kan översättas till ditt eget språk. Det gör det enklare för ett barn att förstå kommandona. Det finns tre filer att översätta för ett nytt språk: först filen med nyckelord (eller kommandon), därefter filen logo-highlight-style och till sist exemplen.

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

Kommandofilerna finns i `kdeedu/kturtle/src/data/keywords/`. Varje fil heter `logokeywords.kod.xml`, där kod är ISO-koden för ditt land (observera att detta måste vara en giltig ISO-kod).

- Kopiera filen `logokeywords.en_US.xml` genom att byta 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.

- 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

Filerna för syntaxfärgläggning finns i `kdeedu/kturtle/src/data/highlightstyles/`. Varje fil heter `logohighlightstyle.kod.xml`, där kod är ISO-koden för ditt land (observera att detta måste vara en giltig ISO-kod). Observera att landskoden här måste vara samma som i filen `logokeywords` och i exempelkatalogen.

- Kopiera filen `logohighlightstyle.en_US.xml` genom att byta 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

Exemplen finns i &kturtle;s källkod under katalogen `kdeedu/kturtle/examples`.

- Skapa en katalog med ISO-koden för ditt språk som namn.

- Kopiera de engelska exemplen i katalogen och byt namn på filerna med översättningen till ditt språk. Det gör det möjligt för användare att enkelt och snabbt förstå vad exemplen handlar om.

- Titta i `kturtle/src/data/keywords/` efter filen som motsvarar ditt språk. Filen måste vara klar innan exemplen översätts. Ersätt alla engelska kommandon i filen med de översatta kommandona.

- 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.