Das Handbuch zu Kate - KDE Documentation
Das Handbuch zu Kate - KDE Documentation
Das Handbuch zu Kate - KDE Documentation
Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.
YUMPU macht aus Druck-PDFs automatisch weboptimierte ePaper, die Google liebt.
<strong>Das</strong> <strong>Handbuch</strong> <strong>zu</strong> <strong>Kate</strong><br />
6.4 <strong>Kate</strong> mit Skripten erweitern<br />
Seit <strong>Kate</strong> Version 3.4 in <strong>KDE</strong> 4.4 kann die Editorkomponente durch Skripte erweitert werden. Als<br />
Skriptsprache wird ECMAScript verwendet, das auch unter dem Namen JavaScript bekannt ist.<br />
In <strong>Kate</strong> können zwei Arten von Skripten benutzt werden: Einrückungs- und Befehlszeilenskripte.<br />
6.4.1 Einrückungsskripte<br />
Mit Einrückungsskripten wird der Quelltext automatisch bei der Eingabe eingerückt. Nach<br />
Drücken der Eingabetaste wird die Einrückungstiefe <strong>zu</strong>m Beispiel oft vergrößert.<br />
Die folgenden Abschnitte beschreiben Schritt für Schritt, wie das Gerüst für ein einfaches Einrückungsskript<br />
entsteht. Zuerst wird eine neue *.js-Datei mit dem Namen javascript.js im<br />
persönlichen Ordner $<strong>KDE</strong>HOME/share/apps/katepart/script/indentationerzeugt.<br />
6.4.1.1 Der Vorspann des Einrückungsskripts<br />
Der Vorspann der Datei javascript.js ist in einem Kommentar eingebettet und hat folgende<br />
Form:<br />
/* kate -script<br />
* name: JavaScript<br />
* author: Example Name <br />
* license: BSD<br />
* revision : 1<br />
* kate -version: 3.4<br />
* required -syntax -style: javascript<br />
* indent - languages : javascript<br />
* priority : 0<br />
* i18n -catalog: mycatalog<br />
*<br />
* Eine Zeile ohne Doppelpunkt (’:’) beendet das Einlesen des Vorspanns . ←↪<br />
Damit kann hier <strong>zu</strong>sätzlicher<br />
* Text wie <strong>zu</strong>m Beispiel ein ausführlicher Lizenztext eingefügt werden<br />
*/<br />
Jede Zeile wird jetzt im Detail erklärt:<br />
• kate-script [erforderlich]: Dieser Text muss in der ersten Zeile der Datei *.js stehen, sonst<br />
überspringt <strong>Kate</strong> dieses Skript.<br />
• name [erforderlich]: Dies ist der Name des Skripts, der im Menü Extras → Einrückung und im<br />
Einrichtungsdialog angezeigt wird.<br />
• author [optional]: Der Name des Autors und weitere Kontaktinformationen.<br />
• license [optional]: Kurzform der Lizenz, wie <strong>zu</strong>m Beispiel BSD oder LGPLv3.<br />
• revision [erforderlich]: Die Version des Skripts, sie sollte bei jeder Änderung des Skripts erhöht<br />
werden.<br />
• kate-version [required]: Minimal erforderliche <strong>Kate</strong>-Version.<br />
• required-syntax-style [optional]: Durch Kommata getrennte Liste der erforderlichen Syntaxhervorhebungsstile.<br />
Dies ist wichtig für Einrückungsskripte, die besondere Informationen<br />
über die Hervorhebung im Dokument benötigen. Wenn ein erforderlicher Syntaxstil angegeben<br />
ist, ist das Einrückungsskript nur verfügbar, wenn auch die <strong>zu</strong>gehörige Hervorhebung aktiviert<br />
ist. Dies verhindert ein „nicht definiertes Verhalten” beim Verwenden einer Einrückung<br />
ohne das erwartete Hervorhebungschema. Ein Beispiel dafür ist das Einrückungsskript für<br />
Ruby, das diese Option in den Dateien ruby.js und ruby.xml benutzt.<br />
64