Eigene KTouch-Lektionen schreiben

Diese Tutorial ist für KTouch Version 1.7.1 (unter KDE 4.2.3) geschrieben.

Eingebauter Editor

KTouch bringt einen eingebauten Editor mit um eigene Lektionen zu erstellen, oder bestehende zu verändern. Dazu über das Hauptmenü "Datei" > "Lektion bearbeiten ..." anklicken und dann "Eine neue Lektion erstellen" oder "Aktuelle Lektion bearbeiten" auswählen. Es öffnet sich der Lektionseditor:

Der Editor ist selbsterklärend. Bei dem Titel sollten die Konventionen beachtet werden. Das Kommentar kann frei vergeben werden.

Bei den Stufen sollte jedoch beachtet werden, dass das Feld "Neue Zeichen in dieser Stufe" genau nur die Zeichen enthalten sollte, die in dieser Stufe neu hinzukommen. Das sind dann auch die Zeichen, die beim Lernfortschritt auf der Tastatur aufleuchten. Eine genauere Beschreibung der Stufe erfolgt ein Feld tiefer. Unglücklicherweise wird als Bezeichner der Stufe das Feld "Neue Zeichen in dieser Stufe" gewählt, anstatt die Beschreibung (siehe Stufenauswahl links im Bild). Vielleicht ändert sich das in zukünftigen KTouch Versionen.

Zum Schluss lässt sich die Lektion über das Diskettensymbol (unten rechts im Bild) speichern. Als Ziel sollte das KTouch-Benutzerverzeichnis gewählt werden. Dann taucht auch die neue Lektion automatisch unter den Standardlektionen auf. Bei der Wahl des Dateinamen sind weitere Konventionen zu beachten.

Texteditor

Die Funktionen des eingebauten Editors sind sehr eingeschränkt. Soll z.B. die Reihenfolge von mehreren Stufen (engl. Levels) gleichzeitig verändert werden, oder größere Teile von einer bereits bestehenden Lektion in die neue übernommen werden, so geht dies schneller, wenn man die Lektion mit einem normalen Texteditor bearbeitet.

Da die Lektionen in Form einer XML-Datei gespeichert werden, lassen sie sich mit jedem beliebigen Texteditor öffnen. Dennoch sollte man unter Windows lieber ​Notepad++ anstatt des einfachen Notepad verwenden, da die Lektionen den Zeilenumbruch in der UNIX-Konvention (CR) darstellen und Notepad nur die Windows-Konvention (CR+LF) kennt.

Tools

Neben der Möglichkeit Lektionen von Hand einzutippen, gibt es noch Tools, die teilweise ganze Lektionen nach einem bestimmten Muster generieren:

• SortWords

Konventionen

Damit die neuen KTouch-Lekionen auch auf der Neo-Webseite in ktouch/lectures veröffentlicht werden können, sollten folgende Konventionen eingehalten werden.

Titel

Der Titel einer Lektion hat folgendem Muster zu entsprechen:

Deutsch (Neo<VERSION> <NAME>)

Dabei bedeutet:

• <VERSION> = Die Neo-Version, für die diese Lektion geschrieben wurde. Eine Unterscheidung ist dahingehend sinnvoll, als dass die Belegung auf der Hauptebene sich zwischen den Versionen unterscheiden kann und die Reihenfolge der zu erlernenden Buchstaben eine andere ist. Falls die Lektion keine Einführung von neuen Buchstaben vorsieht, kann die Versionsnummer entfallen.
• <NAME> = Eine beliebiger Text.

Korrekte Titel sind z.B.:

Deutsch (Neo1 Tastaturbelegung)
Deutsch (Neo2 Meine Lektion)
Deutsch (Neo Gedichte)

Die letzte Lektion stellt eine Ansammlung von Gedichten dar, bei der keine Buchstaben eingeführt, sondern direkt Gedichte getippt werden. Daher entfällt hier die Angabe der Neo-Version.

KEINE korrekten Titel sind:

• Deutsch (NEO1 Tastaturbelegung) - NEO wurde komplett groß geschrieben.
• Deutsch (Neo 1 Tastaturbelegung) - Zwischen Neo und 1 ist ein Leerzeichen.
• German (Neo1 keyboard layout) - KTouch ist lokalisiert auf deutsch, daher sollen alle für den Benutzer sichtbaren Namen auch auf deutsch lesbar sein.

Dateinamen

Veröffentlichung

Upload

Über Mailingliste oder im IRC jemanden fragen.

Dokumentation

Im Wiki die Lektion kurz beschreiben TODO: Link einsetzen