# Übersetzerhandbuch für &kturtle;

Das Besondere an der &logo;-Sprache ist bekanntlich die Übersetzung der Befehle in Ihre eigene Sprache. Damit können Kinder die Befehle einfacher verstehen. Für eine neue Sprache müssen Sie drei Dateien übersetzen, erstens die Schlüsselwortdatei (mit den Befehlen), dann die Logostildatei für Hervorhebungen und als letztes die Beispiele.

## Erstellen Sie einen Ordner für die übersetzten Dateien

Zuerst müssen Sie einen Ordner für die übersetzten Dateien erstellen, mit dem Namen `kde-i18n/code/data/kdeedu/kturtle/` in Ihrem KDE CVS Ordner, dabei ist code Ihr Ländercode (der ISO-Code mit 2 oder 4 Buchstaben).

Kopieren Sie die Datei `Makefile.am` von `kdeedu/kturtle/data/` in diesen Ordner. Öffnen Sie die Datei mit Ihrem Lieblingseditor, ersetzen Sie jedes en_US darin mit Ihrem Ländercode (dem oben genannten) und speichern Sie die Datei.

## Wie die &logo; Schlüsselworte (Befehle) übersetzt werden

- Kopieren Sie die Datei `logokeywords.en_US.xml` von `kdeedu/kturtle/data/` in den gerade erstellten Ordner und ändern Sie den Namen in `logokeywords.code.xml`, dabei ist code Ihr Ländercode (der ISO-Code mit 2 oder 4 Buchstaben).

- Übersetzen Sie den Inhalt der `keyword` Markierung (d. h. die Information zwischen `keyword` und `keyword`) möglichst in Ihre eigene Sprache. Übersetzen Sie außerdem auch den Inhalt der `alias` Markierung, (d. h. die Information zwischen `alias` und `alias`). Dies ist die Abkürzung für das Schlüsselwort.

  Übersetzen Sie zum Beispiel while in: `keyword`solange`keyword`

  Bitte übersetzen Sie nichts anderes und insbesondere nicht die englischen Worte in `command name="english_word"`, diese Worte dürfen nicht übersetzt werden.

  Wichtig: Ändern Sie nicht die Reihenfolge der Einträge in dieser Datei, das ist notwendig für Rafael Beccar's Programm zur automatischen Übersetzung.

- Speichern Sie Ihre Datei als UTF-8 (in &kate; mit Speichern unter ... und stellen Sie dann utf8 im Auswahlfeld rechts oben neben dem Ordnernamen ein).

- Geben Sie Ihre Datei ins CVS ein (fügen Sie den Dateinamen in `Makefile.am` ein) oder schicken Sie die Datei einfach an Anne-Marie.

- Für zusätzliche Informationen und Fragen wenden Sie sich bitte an Anne-Marie Mahfouf annemarie.mahfouf@free.fr.

## Wie die Syntax-Hervorhebungsdateien übersetzt werden

Die Übersetzung von `logohighlightstyle.en_US.xml` ist mit Rafael Beccar's Programm in `kdeedu/kturtle/data/` sehr einfach. Lesen Sie dazu die README-Datei in diesem Ordner.

Für Alle, die das im letzten Absatz erwähnte Perl-Programm nicht verwenden wollen, hier die Anweisungen zur Übersetzung von Hand:

- Kopieren Sie die Datei `logohighlightstyle.en_US.xml` von `kdeedu/kturtle/data/` in den gerade für die übersetzte Schlüsselwortdatei erstellten Ordner und ändern Sie den Namen in `logohighlightstyle.code.xml`, dabei ist code Ihr Ländercode (der ISO-Code mit 2 oder 4 Buchstaben).

- Zeile 4 der Datei lautet `language name="en_US"` ...: Ändern Sie en_US in den ISO-Code Ihres Landes (2 oder 4 Buchstaben).

- Übersetzen Sie den Inhalt der `item` Markierung (d. h. die Information zwischen `item` und `item`) möglichst in Ihre eigene Sprache. Dieser Inhalt muss dem Schlüsselwort in der `logokeyword`-Datei entsprechen. Übersetzen Sie zum Beispiel while in: `item`solange`item` mit einem Leerzeichen am Anfang und am Ende. Bitte übersetzen Sie sonst nichts.

- Speichern Sie Ihre Datei als UTF-8 (in &kate; mit Speichern unter ... und stellen Sie dann utf8 im Auswahlfeld rechts oben neben dem Ordnernamen ein).

- Geben Sie Ihre Datei ins CVS ein (fügen Sie den Dateinamen in `Makefile.am` ein) oder schicken Sie die Datei einfach an Anne-Marie.

- Für zusätzliche Informationen und Fragen wenden Sie sich bitte an Anne-Marie Mahfouf annemarie.mahfouf@free.fr.

## Wie die Beispiele übersetzt werden

Auch diese Aufgabe ist mit Rafael Beccar's Programm in `kdeedu/kturtle/data/` sehr leicht. Lesen Sie dazu die README-Datei in diesem Ordner, da die Beispiele nach der automatischen Übersetzung noch bearbeitet werden müssen.

Wenn Sie alle Anweisungen aus der README-Datei des Script-Ordners ausgeführt haben, sind Sie mit Ihrer Arbeit fast fertig. Vergessen Sie nicht, die übersetzten Beispiele zu testen, da sich leicht Fehler einschleichen. Fügen Sie außerdem die Namen der neuen Dateien in `Makefile.am` im Ordner `kde-i18n/code/data/kdeedu/kturtle/` ein. Für die niederländische `Makefile.am` muss das so aussehen:

    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)

Jetzt folgt eine Beschreibung, wie Sie die Beispiele ohne Rafael's Perl-Programme übersetzen können:

- Kopieren Sie die englischen Beispieldateien von `kdeedu/kturtle/data/` in den Ordner mit den übersetzten Schlüsselwort- und Syntax-Hervorhebungsdateien. Übersetzen Sie die Dateinamen in Ihre Sprache, damit der Benutzer einfach und schnell den Inhalt der Beispiele erkennt.

- Übersetzten Sie die Schlüsselworte in den Beispielen mit den Schlüsselworten Ihrer Sprache aus der Datei `Logokeywords.xml`. Diese Datei muss vor der Übersetzung der Beispiele erstellt werden.

- Speichern Sie Ihre Datei als UTF-8 (in &kate; mit Speichern unter ... und stellen Sie dann utf8 im Auswahlfeld rechts oben neben dem Ordnernamen ein).

- Geben Sie Ihre Datei ins CVS ein (fügen Sie den Dateinamen in `Makefile.am` ein) oder schicken Sie die Datei einfach an Anne-Marie.

- Für zusätzliche Informationen und Fragen wenden Sie sich bitte an Anne-Marie Mahfouf annemarie.mahfouf@free.fr.

- Zusätzlich können Sie auch eigene Beispiele in diesen Ordner einfügen.