Das Handbuch zu Kate - KDE Documentation

Das Handbuch zu Kate
In diesem Fall ist das erste Element die Einrückungstiefe wie oben mit derselben Bedeutung
spezieller Werte. Das zweite Element ist ein absoluter Wert für die Spalte der „Ausrichtung”. Ist
dieser Wert größer als der Einrückungswert, legt die Differenz der Werte die Anzahl von Leerzeichen
fest, die zum ersten Wert für die gesamte Einrückung hinzuaddiert werden. Anderenfalls
wird der zweite Rückgabewert ignoriert. Die Benutzung von Tabulator- und Leerzeichen wird
oft als „Mischmodus” bezeichnet.
Betrachten Sie das folgende Beispiel: Angenommen das Tabulatorzeichen wird zur Einrückung
verwendet und die Tabulatorweite beträgt 4. Hier steht for den Tabulator und ’.’ für ein
Leerzeichen:
1: foobar (" hello",
2: ......." world ");
Beim Einrücken der Zeile 2 gibt die Funktion indent() [8, 15] zurück. Daher werden zwei Tabulatoren
für das Einrücken bis Spalte 8 und noch zusätzlich 7 Leerzeichen hinzugefügt. Dadurch
steht der zweite Parameter unter dem ersten und bleibt auch so ausgerichtet, wenn die Datei mit
einer anderen Tabulatorweite angezeigt wird.
In der Standardinstallation von KDE wird Kate mit einigen Einrückungsskripten installiert. Die
entsprechenden JavaScript-Quelltexte finden Sie unter $KDEDIR/share/apps/katepart/script/i
ndentation.
Bei der Entwicklung eines Einrückungsskripts muss das Skript wieder neu geladen werden, um
testen zu können, ob es richtig funktioniert. Anstatt das ganze Programm neu zu starten, wechseln
Sie zur Befehlszeile und geben reload-scripts ein.
Wenn Sie nützliche Skripte entwickelt haben, sollten Sie darüber nachdenken, sie zum Kate-
Projekt hinzufügen. Schreiben Sie dazu an die Mailingliste.
6.4.2 Befehlszeilenskripte
Da nicht alle gewünschten Funktionen in Kate eingebaut werden können, ist es möglich, kleine
Hilfsskripte für die schnelle Änderung von Textes mit der eingebauten Befehlszeile auszuführen.
Der Befehl sort ist zum Beispiel als Skript geschrieben. Dieser Abschnitt erklärt, wie *.js-Dateien
erstellt werden, um die Fähigkeiten von Kate mit beliebigen Hilfsskripten zu erweitern.
Befehlszeilenskripte werden im gleichen Ordner wie Einrückungsskripte gespeichert. Zuerst erstellen
eine neue *.js-Datei namens myutils.js im lokalen persönlichen Ordner $KDEHOME/sha
re/apps/katepart/script/commands.
6.4.2.1 Der Vorspann des Befehlszeilenskripts
Der Vorspann jedes Befehlszeilenskripts ist in einem Kommentar eingebettet und hat folgende
Form:
/* kate -script
* author: Example Name
* license: BSD
* revision : 1
* kate -version: 3.4
* functions : sort , format - paragraph
* i18n -catalog: mycatalog
*
* Eine Zeile ohne Doppelpunkt (’:’) beendet das Einlesen des Vorspanns . ←↪
Damit kann hier zusätzlicher
* Text wie zum Beispiel ein ausführlicher Lizenztext eingefügt werden.
*/
66