# Oversættelsesguide for &kturtle;

Som du formodentlig allerede véd, er det entydige kendetegn ved programsproget &logo; at &logo;-kommandoer ofte oversættes til programmørens sprog. Det fjerner en barriere for at forstå basal programmering for mange elever. Når &kturtle; oversættes til et nyt sprog skal yderligere nogle filer oversættes foruden de almindelige strenge og dokumentationen. Dog laves det meste automatisk af Rafael Beccars script. Scripten findes i `kdeedu/kturtle/scripts`, og filerne som skal oversættes findes i `kdeedu/kturtle/data`. I disse mapper finder du også README-filer som indeholder instruktioner om hvordan de bruges eller oversættes.

## Oprettelse af en mappe til at indeholde de oversatte filer

Først må du lave en mappe til at opbevare de oversatte filer. Lav en mappe der hedder `kde-i18n/kode/data/kdeedu/kturtle/` i din KDE SVN-mappe, hvor kode er dit lands kode (2 eller 4 bogstavs ISO-kode)

Kopiér `Makefile.am`-filen fra `kdeedu/kturtle/data/` til denne mappe. Åbn den ved at bruge din foretrukne teksteditor, erstat alle forekomster af en_US i filen med din landekode (den der blev brugt ovenfor), og gem filen.

## Hvordan &logo;-nøgleord oversættes (kommandoer)

- Kopiér filen `logokeywords.en_US.xml` fra `kdeedu/kturtle/data/` til den mappe du lige lavede, og omdøb den til `logokeywords.kode.xml` hvor codeer dit lands kode (2 eller 4 bogstavs ISO-kode)

- Oversæt indholdet af `keyword`-mærket (&ie; informationen mellem `keyword` og `keyword`) til dit sprog når det er muligt. Oversæt også indholdet af `alias`-mærket, (&ie; informationen mellem `alias` og `alias`). Disse bruges som genveje for nøgleordet.

  For eksempel oversæt while i: `keyword`while`keyword`

  Oversæt venligst ikke nogetsomhelst andet og oversæt ikke engelske ord i `command name="english_word"`. Disse skal forblive på engelsk.

  Tilsidst: ændr ikke rækkefølgen i filen, eftersom den behøves af Rafael Beccars script til at oprette automatiske oversættelser.

- Gem din fil som utf-8 (i &kate; bruges Gem som... og der skiftes til utf8 i feltet til højre for filnavnet)

- Indsend din fil (tilføj dit filnavn til `Makefile.am`) eller send den til Anne-Marie.

- Hvis du er i tvivl, så kontakt venligst Anne-Marie Mahfouf annemarie.mahfouf@free.fr for mere information.

## Hvordan syntaksfremhævningsfilerne oversættes

At oversætte `logohighlightstyle.en_US.xml` er nemt når Rafael Beccars script i `kdeedu/kturtle/data/` bruges. Sørg for at du læser README-filen i denne mappe.

For at virke for alle de som ikke vil bruge velsignelsen med perl-scriptet som blev nævnt i foregående paragraf, beskrives den gammeldags måde at gøre dette:

- Kopiér filen `logohighlightstyle.en_US.xml` fra `kdeedu/kturtle/data/` til den mappe du lavede til at opbevare den oversatte nøgleordsfil, og omdøb den til `logohighlightstyle.code.xml` hvor code er dit lands kode (2 eller 4 bogstaver ISO-kode)

- I linje 4 i filen, er der et `language name="en_US"`...: her ændrer du en_US til dit sprogs ISO kode (2 eller 4 bogstaver).

- Oversæt til dit eget sprog indholdet af `item` mærket (&ie; information mellem `punktet` og `punktet`). Dette indhold skal matche logokeyword-filen. For eksempel oversættes while i: `punktet` while `punktet` og mellemrummene efterlades som de er (et i begyndelsen og et i slutningen). Oversæt venligst ikke noget andet.

- Gem din fil som utf-8 (i &kate; bruges Gem som... og der skiftes til utf8 i feltet til højre for filnavnet)

- Indsend din fil (tilføj dit filnavn til `Makefile.am`) eller send den til Anne-Marie.

- Hvis du er i tvivl, så kontakt venligst Anne-Marie Mahfouf annemarie.mahfouf@free.fr for mere information.

## Hvordan eksempler skal oversættes

Igen, denne opgave forenkles en hel del af Rafael Beccars script i `kdeedu/kturtle/data/`. Sørg for at du læser README-filen i den mappe, eftersom et vist arbejde stadigvæk skal gøres efter Logo-eksempelfilerne er oversat automatisk.

Efter du fulgte instruktionerne som gives i README-filen som er i mappen scripts, er du nu næsten færdig. Glem ikke at teste den oversatte Logo-eksempelkode du oprettede, eftersom det er meget almindeligt at en fejl sniger sig ind. Sørg også for at `Makefile.am` i `kde-i18n/kod/data/kdeedu/kturtle/` opdateres ifølge de nye filer. For hollandsk skal `Makefile.am` se sådan her ud:

    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)

Her er en beskrivelse af hvordan oversættelsen laves UDEN at bruge Rafaels perl-script:

- Kopiér de engelske eksempler `kdeedu/kturtle/data/`til denne mappe og omdøb filerne med dit sprogs oversættelse. Dette vil tillade brugere nemt og hurtigt at forstå hvad eksemplet drejer sig om.

- Oversat nøgleord i eksemplerne, ved at bruge dem i `logokeywords.xml` for dit sprog. Nøgleordsfilen skal først være færdig, før eksemplerne oversættes.

- Gem din fil som UTF-8 (i &kate;, bruges Gem som... og der skiftes til utf8 i feltet til højre for filnavnet)

- Indsend sin mappe (tilføj en `Makefile.am` indeni) eller send den til Anne-Marie.

- Hvis du er i tvivl, så kontakt venligst Anne-Marie Mahfouf annemarie.mahfouf@free.fr for mere information.

- Endelig kan du, hvis du ønsker det, tilføje dine egne eksempler i denne mappe.