&Anders.Lund; &Anders.Lund.mail;
Thomas
Diehl

    thd@kde.org

GUI-Übersetzung
Matthias
Schulz

    matthias.schulz@kdemail.net

Deutsche Übersetzung

# Arbeiten mit Modulen

Kate verwendet zwei unterschiedliche Arten von Modulen, nämlich für das Programm &kate; und für die Editorkomponente in &kate;. Komponenten-Module können in jedem Programm wie KDevelop, Quanta, Kile, Kwrite und anderen, die die Editorkomponente benutzen, verwendet werden. Programm-Module werden nur im Programm &kate; verwendet.

Im Einrichtungsdialog können Sie beide Arten von Modulen auswählen. Hier finden Sie auch die Einstellungen für die einzelnen Module.

Es gibt viele Module für unterschiedliche Anwendungsbereich. Einige Module wie zum Beispiel automatische Einfügung von Klammern, Einfügen von Dateien, Datenwerkzeuge und Textexport als &HTML; sind in der Editorkomponente enthalten. Im Internet finden Sie aber noch weitere Module.

## Erweiterungen für die Editorkomponente

Die Karteikarte Erweiterungen listet alle verfügbaren Editor-Module auf. Sie können die Module ankreuzen, die Sie benutzen wollen. Klicken Sie auf Information, um den Dialog über dieses Modul anzuzeigen.

Wenn eine konfigurierbare Erweiterung ausgewählt ist, dann wird der Knopf Einrichten... aktiviert, und Sie können darauf klicken, um die Einstellungen für dieses Modul vorzunehmen.

AutoKlammern

  Das Modul AutoKlammern ersetzt die interne &kate;-Funktion Automatische Klammern. Damit wird automatisch eine schließende Klammer } am Anfang der nächsten Zeile eingefügt, wenn eine Zeile mit einer öffnenden Klammer { endet und die &Enter;taste gedrückt wird.

Daten-Programme

  Aktiviert Datenwerkzeuge wie Thesaurus und Rechtschreibprüfung, wenn sie installiert sind. Datenwerkzeuge sind nur dann verfügbar, wenn Text ausgewählt ist oder die &RMB; über einem Wort gedrückt wird. Einige Datenwerkzeuge sind Bestandteil des &koffice;-Moduls. Ist dieses Modul geladen und sind Datenwerkzeuge installiert, werden zusätzliche Einträge am Ende des Kontextmenüs angezeigt.

Exporter

  Mit diesem Modul können Sie das aktuelle Dokument mit allen Informationen zur Hervorhebung mit Datei Als HTML exportieren in eine HTML-Datei exportieren. Außerdem kann mit Bearbeiten Als HTML kopieren der aktuell gewählte Text im HTML-Format in die Zwischenablage kopiert werden.

Symboleinfüger

  Das Modul Symboleinfüger ist nur zur Entwicklung von &kde;-Programmen sinnvoll einzusetzen. Ist es aktiviert, enthält das Kontextmenü des Editors die Aktion KIcon-Quelltext einfügen. Mit dieser Aktion wird der &kde;-Dialog „Symbolauswahl“ mit Symbolen für Programme, Aktionen &etc; geöffnet. Klicken Sie auf ein Symbol, dann wird der Dateiname ohne Erweiterung als Text eingefügt. Diese Modul hilft bei der Eingabe der Symbole für die KIcon()-Klasse.

Irrsinnige HTML-Kodierung (nicht ZEN, Basisversion)

  Ein Modul zur ZEN-ähnlichen Auswahlvervollständigung. Weitere Informationen finden Sie unter Zen Coding.

Datei einfügen

  Mit diesem Module kann jede beliebige lesbare Datei an der Cursorposition eingefügt werden. Ist diese Mudul geladen, enthält das Menü Extras den zusätzlichen Eintrag Datei einfügen.

## &kate;-Programm-Module

&kate;-Programm-Module enthalten zusätzliche Funktionen für den Editor &kate;. Diese Module können zusätzliche Menüs und Kurzbefehle einfügen und erweitern die Fähigkeiten von &kate;.Sie können eine beliebige Anzahl von Modulen in einem geöffneten &kate;- Programm installieren. Öffnen Sie den Einrichtungsdialog für &kate; mit Einstellungen&kate; einrichten ... und wählen Sie unter Programm Erweiterungen die gewünschten Module aus.

Folgende Programm-Module sind verfügbar:

- Werkzeugansicht zum Suchen in Dateien - Werkzeugansicht, die es erlaubt, alle geöffneten Dateien oder Dateien im Dateisystem zu durchsuchen

- Backtrace-Browser - Ansicht zur Navigation in Backtraces

- Schnellwechsler für Dokumente - Zu einem anderen geöffneten Dokument springen

- Unterfensterleiste - Fügt dem Hauptfenster von Kate eine Unterfensterleiste hinzu

- Textfilter - Einfacher Textfilter

- Symbolbetrachter - Referenzsymbole aus Quelldateien extrahieren und anzeigen

- Dateisystem-Browser - Werkzeugansicht für Dateisystem-Browser

- Werkzeugansicht für Terminal - Werkzeugansicht, die ein Terminalelement einbettet

- CTags -Modul - Definition/Deklaration mit CTags nachschauen

- Dateivorlagen - Erstellt neue Dateien aus Vorlagen

- Header öffnen - Öffnet die zusammengehörigen .h/[.cpp|.c]-Dateien

- Externe Programme

- Erstellen-Modul - Kompilieren oder Make aufrufen und Fehlermeldungen ausgeben

- Mail-Dateien - Dateien per E-Mail versenden

- Kate Schnipsel - Schnipsel-Modul mit Unterstützung für Code-Vervollständigung

- KTextEditor-Modul Jovie für die Sprachausgabe - Fügt einen Menüeintrag zum Vorlesen des Textes hinzu

- &XML;-Überprüfung - Überprüft &XML;-Dateien mit xmllint

- &XML;-Vervollständigung - Zeigt &XML;-Elemente, Attribute, Attributwerte und Entitäten an, die von der DTD definiert werden

- Tabify - Fügt dem Hauptfenster von Kate eine Unterfensterleiste hinzu

&Anders.Lund; &Anders.Lund.mail;

## Dateivorlagen

Mit dem Modul Dateivorlagen können Sie Dateien erstellen, indem Sie andere Dateien als Vorlage benutzen.

Nachdem Sie Kate installiert haben, muss dieses Modul zuerst aktiviert werden:

1. Klicken Sie auf Einstellungen Kate einrichten ...

2. In der Baumansicht links im Dialog wählen Sie die Seite Erweiterungen.

3. Im Bereich Verwaltung für Erweiterungen rechts wählen Sie Dateivorlagen aus drücken dann OK.

Nun können Sie jede Datei als Vorlage benutzen, um eine Kopie mit einer leeren &URL; zu erzeugen oder eine spezielle Vorlage benutzen, deren Makros Informationen einfügen wie Name und E-Mail-Adresse, das aktuelle Datum und Umgebungsvariablen und die den Cursor an eine passende Position in der neuen Datei setzen.

Mit diesem Modul können Sie auch auf einfache Art und Weise eine neue Vorlage aus einem geöffneten Dokument erstellen.

Vorlagen, die im Vorlagenordner gespeichert sind, werden im Menü Datei Neu von Vorlage angezeigt.

Der Vorlagen-Ordner ist Teil des &kde;-Dateisystems und besteht mindestens aus:

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates.`

Wenn Ihre Umgebungsvariable `KDEDIRS` zusätzliche Ordner enthält, werden diese auch nach einem gleichnamigen Unterordner abgesucht. Wenn mehrere Vorlagen mit gleichem Namen gefunden werden, wird die Vorlage im lokalen (KDEHOME) Ordner gewählt.

### Menüstruktur

Datei Neu von Vorlage Beliebige Datei ...

  Zeigt Ihnen den Dialog Datei öffnen, um eine beliebige Datei als Vorlage zu verwenden. Wenn die gewählte Datei die Erweiterung `katetemplate` hat, wird sie nach Vorlageninformationen und Makros durchsucht.

Datei Neu von Vorlage

  Die weiteren Untermenüs enthalten Verknüpfungen zu Vorlagen. Klicken Sie auf einen Menüeintrag, um eine Datei wie im Menütext beschrieben zu erzeugen.

Einstellungen Vorlagen verwalten ...

  Öffnet einen Dialog mit einer Liste aller Vorlagen in den Vorlagen-Ordnern, um Vorlagen hinzuzufügen, zu bearbeiten oder zu entfernen.

### Wie Sie &kate;-Vorlagen benutzen

Wenn Sie eine Datei aus einer Vorlage mit Makros erstellen, erscheinen einige Makros als veränderbare Variablen im Text. Diese Variablen werden als unterstrichene Worte dargestellt.

Die erste Variable ist ausgewählt, so dass Sie nur lostippen müssen, um sie zu bearbeiten. Wenn im Text der Datei die gleiche Variable mehrfach vorhanden ist, werden alle bei der Eingabe geändert. Die nächste Variable erreichen Sie mit der Tabulatortaste. Wenn Sie bei der letzten Variablen angekommen sind, arbeitet die Tabulatortaste wie gewohnt.

### Eigene Vorlagen erstellen

Mit Einstellungen Vorlagen verwalten ... öffnen Sie einen Dialog. Klicken Sie hier auf Neu ..., um den Assistenten für Dateivorlagen zu starten. Wählen Sie eine Datei aus, die in eine Vorlage umgewandelt werden soll und geben Sie Vorlageninformationen ein. Mit diesen Angaben wird eine Vorlagendatei für Sie erstellt.

Alternativ können Sie eine Vorlage manuell erzeugen, indem Sie Vorlageninformationen am Anfang jeder Datei einfügen, Text und Makros schreiben und die Datei dann mit der Namenserweiterung `katetemplate` speichern.

Das Vorlagenmenü wird automatisch aktualisiert, wenn Sie Ihre Vorlage im Vorlagen-Ordner speichern.

### Dateivorlagen bearbeiten

Um eine Vorlage zu bearbeiten, wählen Sie Einstellungen Vorlagen verwalten .... Wählen Sie die Vorlage zur Bearbeitung und klicken Sie auf Bearbeiten ..., um sie zu öffnen. Schließen Sie den Dialog, bearbeiten Sie die Vorlage, speichern und schließen Sie die Datei. Änderungen der Vorlagen werden sofort wirksam, Sie können die Vorlage aufrufen, um Ihre Änderungen nach dem Speichern zu prüfen.

### Das &kate;-Vorlagenformat

Wenn Sie Dateien mit der Namenserweiterung `katetemplate` verwenden, wird beim Einlesen der Datei nach Vorlageninformationen, Makros und einer Cursorposition gesucht.

#### Vorlageninformationen

Beim Einlesen der Datei werden Zeilen, die mit dem Text `katetemplate:` anfangen, nach Vorlageninformationen in der Form VARIABLENNAME=WERT durchsucht. Der Inhalt der Vorlage beginnt mit der ersten Zeile, die nicht mit `katetemplate:` anfängt. WERT kann beliebige Zeichen bis auf das Gleichheitszeichen (=) enthalten. Gültige Variablennamen sind:

`Dateivorlage`

  Dies ist der Vorlagenname, der im Menü Datei Neu von Vorlage angezeigt wird.

`Gruppe`

  Die Gruppe bestimmt die Anordnung der Vorlage in einem Untermenü des Menüs Datei Neu von Vorlage.

`Name`

  Dies ist der Dateiname des Dokuments, er wird in der Dateiliste und in der Titelleiste angezeigt. Enthält der Name `%N` und sind mehrere Dokumente mit gleichem Namen vorhanden, wird N für jedes Dokument durch eine um 1 vergrößerte Zahl ersetzt.

`Hervorhebung`

  Das Modul wird den Hervorhebungsmodus für das neue Dokument auf den Wert dieser Variablen setzen. Als Wert sollte der Name wie in Extras Hervorhebungen eingesetzt werden.

`Beschreibung`

  Eine kurze aussagekräftige Beschreibung dieser Vorlage, die zurzeit für den Was ist das-Text der Menüeinträge benutzt wird. In Zukunft kann es weitere Anwendungen dafür geben.

Autor

  Ein Text mit dem Namen des Autors, zum Beispiel in der Form `Name <email address>`. Zurzeit wird dies für den Was ist das-Text der Menüeinträge benutzt, in Zukunft kann es weitere Anwendungen dafür geben.

#### Vorlagenmakros

Beim Einlesen der Vorlage werden Makros in der Form `%{NAME}` oder `${Name}` ersetzt. Wenn Sie das Vorzeichen `$` benutzen, wird das ersetzte Makro als editierbare Variable behandelt, wenn die Datei aus der Vorlage erstellt wird, im Gegensatz zu `%`, es sei denn, bei der Ersetzung treten Fehler auf.

Die folgenden Makros werden ersetzt:

time

  Wird ersetzt durch die aktuelle Zeit in Ihren lokalen Format.

date

  Wird durch das Datum im abgekürzten Format ersetzt.

datetime

  Wird durch das aktuelle Datum und Zeit in Ihrem lokalen Format ersetzt.

year

  Das aktuelle Jahr als Zahl mit 4 Ziffern.

month

  Der vollständige Name des Monats in Ihrer Sprache.

Tag

  Wird durch den aktuellen Tag des Monats ersetzt.

Rechnername

  Wird durch den ‚Rechnernamen‘ Ihres Computers ersetzt.

index

  Wird durch ‚i‘ ersetzt.

Vollständiger Name

  Wird durch Ihren vollständigen Namen aus dem Standard &kde;-Adressbuch ersetzt.

Vorname

  Wird durch Ihren Vornamen aus dem Standard &kde;-Adressbuch ersetzt.

Nachname

  Wird durch Ihren Nachnamen aus dem Standard &kde;-Adressbuch ersetzt.

email

  Wird durch Ihre E-Mail-Adresse aus dem Standard &kde;-Adressbuch ersetzt.

Jedes Makro aus der oben genannten Liste wird als editierbar behandelt, unabhängig vom Vorzeichen. Wenn die gleiche Variable mehrfach in der Vorlage vorhanden ist, kann diese Variable gleichzeitig bearbeitet werden, nachdem die Datei aus der Vorlage erstellt wurde.

#### Einstellung der Cursorposition

Das Sondermakro `${cursor}` wird durch einen vertikalen Balken ersetzt und ans Ende der Liste der editierbaren Variablen gestellt, unabhängig von seiner Position im Text.

### Danksagungen

&kate;-Modul Dateivorlagen Copyright 2004 &Anders.Lund; ""&Anders.Lund.mail;.

Copyright der Dokumentation 2004 &Anders.Lund;

Daniel
Naber

    &Daniel.Naber.mail;

## &XML;-Überprüfung

Dieses Modul überprüft &XML;-Dateien auf richtige Form und Gültigkeit.

Dieses Modul überprüft die aktuelle Datei. Eine Liste mit Warnungen und Fehlern erscheint im unteren Teil des Hauptfensters von &kate;. Wenn Sie auf eine Fehlermeldung klicken, gelangen Sie zu der entsprechenden Stelle in der Datei. Besitzt die Datei einen DOCTYPE, wird die darin angegebene DTD für die Überprüfung der Korrektheit der Datei benutzt. Die DTD muss sich an einem zur aktuellen Datei relativen Ort befinden. Wenn &eg; der Doctype auf DTD/xhtml1-transitional.dtd verweist und die aktuelle Datei `/home/peter/test.xml` ist, muss sich die DTD in `/home/peter/DTD/xhtml1-transitional.dtd` befinden. Es werden auch entfernte DTDs über http unterstützt.

Dateien, die keinen Doctype besitzen, werden auf richtige Form hin überprüft.

Wenn Sie mehr über &XML; lernen möchten, besuchen Sie die offiziellen W3C &XML; Seiten.

Intern ruft das Modul den externen Befehl `xmllint` auf, der Teil von libxml2 ist. Wenn dieser Befehl nicht korrekt auf Ihrem System installiert ist, funktioniert das Modul nicht.

Sie benötigen Schreibzugriff für den Ordner, in dem sich die zu überprüfende Datei befindet, da eine temporäre Datei dort angelegt werden muss.

Um diese Modul zu laden, öffnen Sie den Einrichtungsdialog von &kate; mit Einstellungen &kate; einrichten .... Wählen Sie dann XML-Überprüfung im Abschnitt Programm Erweiterungen und schließen den Dialog.

### Menüstruktur

XML XML überprüfen

  Dies startet die Überprüfung wie oben beschrieben.

### Danksagungen

&kate;-Modul XML-Überprüfung Copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;.

Copyright der Dokumentation 2002 &Daniel.Naber;

Daniel
Naber

    &Daniel.Naber.mail;

## &XML;-Vervollständigung

Dieses Modul gibt Hinweise, was an einer bestimmten Stelle einer &XML;-Datei gemäß der zugehörigen DTD erlaubt ist. Es zeigt, abhängig von der Cursorposition, mögliche Elemente, Attribute, Attributwerte oder Entitäten an (&eg; werden alle Entitäten angezeigt, wenn das Zeichen links vom Cursor & ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.

Die DTD muss im &XML;-Format vorliegen, wie es das Perl-Programm `dtdparse` liefert. Eine DTD mit diesem Format wird als Meta-DTD bezeichnet. Einige Meta-DTDs werden mitgeliefert. Sie befinden sich im Ordner `$KDEDIR/share/apps/katexmltools/`, der auch Standardordner für den Menü-Befehl Meta-DTD zuweisen ... ist. Um eigene Meta-DTDs zu erzeugen, benötigen Sie `dtdparse` von http://dtdparse.sourceforge.net.

### Anwendung

Starten Sie &kate; und öffnen Sie den Einrichtungsdialog mit Einstellungen &kate; einrichten .... Dann wählen Sie XML-Vervollständigung im Abschnitt Programm Erweiterungen. Danach wählen Sie XML Meta-DTD zuweisen .... Wenn Ihr Dokument keinen DOCTYPE enthält oder dieser unbekannt ist, wählen Sie eine Meta-DTD aus Ihrem Dateisystem. Ansonsten wird die passende Meta-DTD für Ihr aktuelles Dokument automatisch geladen.

Das Modul können Sie jetzt während der Texteingabe benutzen.

< (kleiner als)

  Damit wird eine Liste mit möglichen Elementen angezeigt, solange sich der Cursor nicht schon in einer Marke befindet. Beachten Sie, dass Sie dies derzeitig noch nicht benutzen können, um ein Element aus der obersten Ebene einzufügen (&eg; <html>).

</(Zeichen "kleiner als" und Schrägstrich)

  Die Eingabe dieser Zeichen schlägt das Schließen des aktuellen Elements vor (das nächste offene links vom Kursor). Drücken Sie die &Enter;-Taste, um den Vorschlag zu akzeptieren. Anders als der Menüpunkt Element schließen, funktioniert dies nur mit einer zugewiesenen DTD.

" (Anführungszeichen)

  Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten anzeigen (wenn es welche gibt).

(Leertaste)

  Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element anzeigen, wenn die Taste innerhalb einer Marke gedrückt wird.

& (Kaufmanns-Und)

  Diese Taste wird eine Liste mit definierten Entities anzeigen.

### Funktionen und Einschränkungen

Sie können alle Funktionen und Einschränkungen testen, indem Sie die Datei `$KDEDIR/share/apps/katexmltools/testcases.xml` in &kate; laden und den Anweisungen folgen.

### Menüstruktur

&Ctrl;Eingabe XML Element einfügen ...

  Damit öffnen Sie einen Dialog zum Einfügen eines &XML;-Elementes. Die <,>-Zeichen und die schließende Marke werden automatisch eingefügt. Wenn vorher Text markiert war, wird dieser mit einer öffnenden und einer schließenden Marke umgeben. Mit dem Dialog ist es auch möglich, alle an der Cursor-Position eingegebenen Elemente zu vervollständigen, wenn eine Meta-DTD mittels Meta-DTD zuweisen ... zugewiesen wurde.

&Ctrl;< XML Element schließen

  Sucht im Text nach einer Marke, die noch nicht geschlossen wurde und schließt diese durch Einfügen der entsprechenden schließenden Marke. Die Suche erfolgt von der Cursorposition aus nach links. Falls keine offene Marke gefunden wird, hat dieser Befehl keine Auswirkungen.

XML Meta-DTD zuweisen ...

  Bestimmt die Meta-DTD für das aktuelle Dokument. Beachten Sie, dass diese Zuordnung nicht gespeichert wird. Sie muss beim nächsten Programmstart von &kate; wiederholt werden.

### Danksagungen

&kate;-Modul XML-Vervollständigung Copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail;.

KDE SC 4 Version Copyright 2010 Tomáš Trnka

Copyright der Dokumentation 2001, 2002 &Daniel.Naber;