&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.

Datenwerkzeuge

  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 Modul kann jede beliebige lesbare Datei an der Cursor-Position eingefügt werden. Ist dieses Modul 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:

- GDB - Stellt eine einfache GDB-Oberfläche zur Verfügung

- Backtrace-Browser - Ansicht zur Navigation in Backtraces

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

- SQL-Modul - Anfragen an SQL-Datenbanken ausführen

- Suchen und Ersetzen - Muster in allen geöffneten Dateien oder in allen Dateien eines Ordners suchen oder ersetzen.

- Unterfensterleiste - Fügt dem Hauptfenster von &kate; eine normale 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

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

- Mail-Dateien - Dateien per E-Mail versenden

- Mehrzeilige Unterfensterleiste - Fügt dem Hauptfenster von &kate; eine mehrzeilige Unterfensterleiste hinzu

- Kate-Textbausteine - Textbaustein-Modul mit Unterstützung für Quelltext-Vervollständigung

- Jovie-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, sodass 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 T&Tab;-taste. Wenn Sie bei der letzten Variablen angekommen sind, arbeitet die &Tab;-taste 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 Cursor-Position 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.

`day`

  Wird durch den aktuellen Tag des Monats ersetzt.

`hostname`

  Wird durch den „Rechnernamen“ Ihres Computers ersetzt.

`index`

  Wird durch „i“ ersetzt.

`fullname`

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

`firstname`

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

`lastname`

  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 Cursor-Position

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 Cursor-Position, 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 Cursor-Position 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;

## Schnellwechsler für Dokumente

### Menüstruktur

&Ctrl;1 Gehe zu Schnellumschalter

  Öffnet den Schnellumschalter mit einem Suchfeld und einer Liste mit geöffneten Dokumenten Während der Eingabe von Text in das Suchfeld werden die Dokumentennamen und URLs nach dem eingegebenen Text durchsucht.Sie können hier auch die Cursor-Tasten Auf und Ab benutzen. Wenn der Schnellumschalter mit dem Knopf OK verlassen wird, dann wird zu dem in der Liste ausgewählten Dokument umgeschaltet. Das macht das Umschalten zwischen den Dokumenten besonders dann einfacher, wenn viele Dokumente geöffnet sind.

## Exporter

### Menüstruktur

Datei Als HTML exportieren ...

  Exportiert die Datei im &HTML;-Format, sodass diese als Webseite betrachtet werden kann.

Bearbeiten Als HTML kopieren ...

  Kopiert den ausgewählten Text mit der Syntaxhervorhebung &HTML;-Format.

&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Suchen und Ersetzen

### Einleitung

Mit &kappname;'s Modul In Dateien suchen können Sie nach einfachem Text oder regulären Ausdrücken in mehreren Dateien auf einmal suchen. Sie können alle geöffneten Dateien, alle Dateien in einem Ordner und je nach Einstellung auch in den Unterordnern suchen. Auch das Filtern nach Dateinamen ist möglich, um zum Beispiel nur in Dateien mit einer bestimmten Erweiterung zu suchen.

### Oberfläche

#### Such-Anfrage

Die folgenden Einstellungen werden immer oben in der Ansicht „In Dateien suchen“ angezeigt.

Neues Unterfenster

  Sie können beliebig viele Suchvorgänge auf einmal öffnen. Klicken Sie dazu auf den Knopf Neues Unterfenster oben links in der Ansicht In Dateien suchen, dann können Sie eine weitere Suche starten.

Abfrage

  In das Eingabefeld oben tragen Sie Text ein, den Sie suchen möchten. Sie können entweder einfachen Text oder einen regulären Ausdruck eingeben, wenn diese Einstellung aktiviert wurde.

Suchen

  Haben Sie alle Einstellungen richtig vorgenommen, dann drücken Sie zum Start auf den Knopf Suchen. Sie können auch die Taste &Enter; im Eingabefeld drücken, um eine Suche zu starten.

Adresse

  In diesem Auswahlfeld gibt es zwei Einstellungen. Wählen Sie In offenen Dateien, um in allen gerade in &kappname; geöffneten Dateien oder in Ordner, um in einem Ordner und dessen Unterordnern zu suchen.

Einstellungen

  Hier gibt es zwei Einstellungen: Mit Groß-/Kleinschreibung beachten beschränken Sie die Suche auf Ausdrücke, die mit der gleichen Groß- und Kleinschreibung wie im Suchfeld auch in den Dateien vorhanden sind. Sie können auch einen Regulären Ausdruck anstatt eines einfachen Textes für die Suche verwenden.

Ergebnisse umschalten

  Mit dem nach unten gerichteten grünen Pfeil rechts oben in der Ansicht „In Dateien suchen“ schalten Sie den unteren Anzeigebereich zwischen den zusätzlichen Einstellungen für die Suche und der Anzeige der Ergebnisse Ihrer Suche um.

#### Einstellungen für die Suche in Ordnern

Diese Einstellungen erscheinen unter den vorher genannten Einstellungen für die Abfrage. Werden stattdessen die Ergebnisse einer Suche angezeigt, wechseln Sie mit dem Knopf Ergebnisse umschalten zur Anzeige der zusätzlichen Einstellungen. Diese Einstellungen sind nur bei einer Suche in Ordnern aktiviert. Ist die Suche in offenen Dateien ausgewählt, sind diese zusätzlichen Einstellungen deaktiviert.

Ordner

  Hier können Sie den Ordner eingeben, in dem die Suche starten soll. Sie können zum Beispiel `~/development/kde/kate/`, eingeben, wenn Sie im Quelltext von &kate; suchen möchten.

Dateiauswahl-Dialog

  Drücken Sie diesen Knopf, um den Ordner im Dateiauswahldialog zu öffnen.

Nach oben

  Drücken Sie diesen Knopf, um in den übergeordneten Ordner des aktuellen Ordners zu wechseln.

Aktuellen Dokumentpfad verwenden

  Mit diesem Knopf setzen Sie den Eintrag für den Ordner auf den Ordner, in der die gerade geöffnete Datei gespeichert ist.

Filter

  Mit dem Filter können Sie nur nach Dateien mit einem bestimmten Namensmuster suchen. Um zum Beispiel nur nach C++-Dateien zu suchen, geben Sie `*.cpp`. Alle Dateien, deren Namen mit `kate` beginnt, finden Sie mit der Eingabe `kate*`. Sie können mehrere Filter getrennt durch Komma (`,`) eingeben. Um hiermit Dateien von der Suche auszuschließen, hängen Sie ein Minuszeichen (`-`) an.

Rekursiv

  Ist diese Einstellung aktiviert, sucht &kappname; auch in allen Unterordnern des ausgewählten Ordners.

Versteckte Dateien einbeziehen

  Ist diese Einstellung aktiviert, sucht &kappname; auch in Dateien und Ordner, die normalerweise durch das &OS; versteckt werden.

Symbolischen Verknüpfungen folgen

  Normalerweise durchsucht dieses Modul keine symbolischen Verknüpfungen. Ist diese Einstellung aktiv, folgt das Modul bei der Suche stattdessen symbolischen Verknüpfungen und sucht in Ordnern oder Dateien, auf die sie verweisen.

  Eine symbolische Verknüpfung verweist möglicherweise auf einen Ordner, der der übergeordnete Ordner des gerade durchsuchten Ordners ist, oder andere Ordner, die symbolische Verknüpfungen zu übergeordneten Ordnern enthalten. Gibt es in einem der durchsuchten Ordner eine derartige Verknüpfung, dann folgt &kappname; bei aktivierter Einstellung diesen Verknüpfungen und durchsucht die Ordner. Dann wird die Suche niemals abgeschlossen.

#### Suchergebnisse

Die Ergebnisse Ihrer Suche werden unterhalb der Einstellungen zur Abfrage angezeigt. Werden die Einstellungen zum Suchmodus In Ordner angezeigt, drücken Sie auf das Symbol Ergebnisse umschalten, um die Suchergebnisse anzuzeigen. Diese Ergebnisse werden auch automatisch angezeigt, wenn die Suche beendet ist.

Als Ergebnisse der Suche werden drei Spalten mit Informationen über jedes Ergebnis der Suchabfrage angezeigt. Die Spalte Datei zeigt den Dateinamen. In der Spalte Zeile werden die Zeilennummern angezeigt, in denen der Inhalt Ihrer Suche gefunden wurde. Die Spalte Text zeigt den vollständigen Text in dieser Zeile.

Um eine Datei mit gefundenen Treffern der Suche zu öffnen, klicken Sie zweimal drauf. &kappname; öffnet die Datei, falls erforderlich, und setzt den Cursor an den Anfang des gefundenen Suchtexts.

### Menüstruktur

Ansicht Werkzeugansichten In Dateien suchen anzeigen

  Schaltet die Anzeige des Werkzeuges In Dateien suchen ein und aus

## Mail-Dateien

### Menüstruktur

Datei Versenden ...

  Öffnen des E-Mail Programms und Anhängen der aktuellen Nachricht als Datei.

## Der Dateisystem-Browser

Der Dateisystem-Browser ist ein Verzeichnisanzeiger, von dem aus Sie Dateien im aktuell angezeigten Verzeichnis öffnen können.

### Menüstruktur

Ansicht Werkzeugansichten Dateisystem-Browser anzeigen

  Schaltet die Anzeige des Dateisystem-Browsers von &kate; ein und aus.

### Oberfläche

Von oben nach unten besteht der Dateisystem-Browser aus folgenden Elementen:

Eine Werkzeugleiste

  Diese enthält Standardnavigationsknöpfe:

  Zurück

    Drücken dieses Knopfes schaltet die Anzeige zu dem vorher angezeigtem Verzeichnis in der Verlaufsliste um. Wenn es keine Eintragung in der Liste gibt, ist dieser Knopf deaktiviert.

  Vorwärts

    Drücken dieses Knopfes schaltet die Anzeige zu dem nächsten Verzeichnis in der Verlaufsliste um. Wenn es keine nächste Eintragung in der Liste gibt, ist dieser Knopf deaktiviert.

  Lesezeichen

    Öffnet ein Untermenü zum Ändern oder Hinzufügen von Lesezeichen. Hier können Sie auch ein neues Lesezeichenverzeichnis hinzufügen.

  Aktueller Dokumentordner

    Drücken dieses Knopfes schaltet die Anzeige zu dem Verzeichnis des aktuellen Dokuments im Editorfenster um. Dieser Knopf ist deaktiviert, wenn das aktive Dokument neu und ungesichert ist oder wenn nicht entschieden werden kann, aus welchem Ordner die Datei stammt.

  Einstellungen
    Kurzdarstellung

      Zeigt nur die Namen der Dateien.

    Ausführliche Ansicht

      Zeigt Name, Datum, Größe und Typ der Dateien an.

    Baumansicht

      Wie die Kurzansicht, aber die Ordner können ein- und ausgeklappt werden, um die Unterordner oder Dateien darin anzuzeigen.

    Ausführliche Baumansicht

      In dieser Ansicht können die Ordner ebenfalls ein- und ausgeklappt werden, zusätzlich werden die Spalten wie in der Ausführlichen Ansicht angezeigt.

    Versteckte Dateien anzeigen

      Zeigt auch die normalerweise ausgeblendeten Dateien des Betriebssystems an.

    Automatisch mit dem aktuellen Dokument abgleichen

      Ist diese Einstellung aktiviert, wechselt der Dateisystem-Browser automatisch mit dem Befehl `cd` in den Ordner des aktuell geöffneten Dokuments im Editorbereich, wenn das aktuell geöffnete Dokument gewechselt wird.

Eine Adressleiste

  Die Adressleiste zeigt den Pfad zum aktuell geöffneten Ordner als Verknüpfungsansicht wie zum Beispiel in &dolphin;. Klicken Sie auf einen Ordner in dieser Ansicht, um ihn zu öffnen, oder Klicken Sie auf einen der Pfeile, um einen Unterordner in dem Ordner zu öffnen. Mit dem ersten Pfeil öffnen Sie den Wurzelordner Ihres Dateiverzeichnisses.

  Klicken Sie rechts in der Verknüpfungsansicht, dann können Sie direkt den Pfad des Verzeichnisses angeben, das angezeigt werden soll. Dieses &URL;-Feld unterhält eine Liste von vorher eingegebenen Verzeichnissen, die durch Klick auf den kleinen Pfeil rechts aufgerufen werden kann.

  Das &URL;-Feld hat eine automatische Vervollständigung, die Vervollständigungsmethode kann durch das mit der rechten Maustaste aufzurufende Kontextmenü eingestellt werden.

Eine Verzeichnisansicht

  Dies ist eine Standard-&kde;-Verzeichnisansicht.

Ein Filtereintrag

  Der Filtereintrag gestattet die Verwendung von Filtern für die Verzeichnisansicht. Der Filter benutzt Standardausdrücke, die einzelnen Einträge müssen durch Leerzeichen getrennt sein. Beispiel: `*.cpp *.h *.moc`

  Um alle Dateien anzuzeigen, geben Sie einen einzelnen Stern (`*`) ein.

  Der Filtereintrag speichert die letzten zehn benutzten Filter. Um darauf zuzugreifen, klicken Sie auf den kleinen Pfeil rechts im Filtereintrag. Um das Filtern auszuschalten, klicken Sie auf das Symbol Text löschen links neben dem Pfeil für die automatische Vervollständigung.

### Einstellungen

Die Einstellungen für dieses Modul finden Sie auf der Seite Dateisystem-Browser in &kate;s Einrichtungsdialog.

Werkzeugleiste

  Hier können Sie festlegen, welche Knöpfe die Werkzeugleiste Dateisystem-Browser enthalten soll, indem Sie diese mit den Pfeilknöpfen in der Mitte in den Bereich Ausgewählte Aktionen: befördern (oder daraus). Sie können die ausgewählten Aktionen dann mit den Knöpfen rechts ordnen.

Martin
Gergov
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Kate-Textbausteine

### Einleitung

Kate-Textbausteine ist eine Modul, mit dem Sie sogenannte Bausteine (wiederverwendbarer Quelltext oder beliebiger Text) benutzen und sich damit die Eingabe von Text erleichtern können. Das Modul unterstützt außerdem Quelltextvervollständigung und QtScript.

### Menüstruktur

Ansicht Werkzeugansichten Kate-Textbausteine anzeigen

  Zeigt die Textbaustein-Seitenleiste mit allen Bausteinen aus Ihrem Archiv für den gerade geöffnete Dateityp.

### Einstellungen

Die Einstellungen für &kate;-Textbausteine finden Sie im Menü Einstellungen &kate; einrichten .... Wählen Sie dann die Seite Kate-Textbausteine im Abschnitt Programm.

Einrichtung der Textbausteine
Der Einrichtungsdialog für Kate-Textbausteine.

Der Einrichtungsdialog für Kate-Textbausteine.

Im Einrichtungsdialog wird eine Liste der Textbaustein-Archive angezeigt. Außerdem können Sie eigene Archive erstellen, aus dem Internet oder von lokalen Dateien laden. Jedes Archiv hat ein Ankreuzfeld, um es zu aktivieren oder zu deaktivieren. Mit den Knöpfen unter der Archivliste können Sie vorhandene Archive bearbeiten oder löschen.

#### Textbaustein-Archivdateien laden

Sie können Textbaustein-Archive aus dem Internet herunterladen. Drücken Sie dazu auf Neue Textbausteine herunterladen, um eine Liste aller verfügbaren Archive anzuzeigen. Nachdem Sie das gewünschte Archiv heruntergeladen haben, müssen Sie es noch aktivieren.

Außerdem können Sie Textbaustein-Archive aus lokalen Dateien laden, indem Sie auf das Symbol Dateiauswahl neben dem Eingabefeld unten im Dialog drücken. Klicken Sie auf Ins Archiv kopieren, wenn Sie eine Datei ausgewählt haben.

#### Textbausteine erstellen und bearbeiten

Textbaustein-Editor
Der Textbaustein-Editor.

Die Benutzerschnittstelle des Textbaustein-Editors.

Um ein neues Textbausteinarchiv anzulegen, drücken Sie auf Neue Textbausteindatei. Geben Sie im nächsten Dialog dann den Namen der Textbausteindatei und die Autoren ein und wählen eine Lizenz. Nach Eingabe aller Daten drücken Sie auf Erstellen, um den Textbaustein-Editor zu öffnen.

Der Textbaustein-Editor enthält die folgenden Einstellmöglichkeiten:

Dateityp

  Wählen Sie einen oder mehrere Dateitypen für dieses Textbaustein-Archiv. Als Voreinstellung wird hier * verwendet, dann wird das Archiv für alle Dateitypen verwendet. Sie können den Typ zum Beispiel auf `C++` ändern oder auf Bearbeiten drücken, um aus einer Liste von Dateitypen auswählen, Benutzen Sie das Trennzeichen `;`, um mehrere Dateitypen einzugeben.

Autoren

  Geben Sie hier den Namen der Autoren der Textbausteindatei ein.

Textbaustein-Liste

  Diese Liste enthält alle Textbausteine aus der Datei. Klicken Sie auf einen Eintrag in der Liste, um den Textbaustein zu bearbeiten.

Hinzufügen (+)

  Fügt einen neuen Textbaustein hinzu.

Löschen (-)

  Löscht den ausgewählten Textbaustein.

Übereinstimmung/Name

  Erscheint in der Liste der Textbausteine in der Werkzeugansicht und danach wird außerdem bei der Benutzung der Quelltextvervollständigung gesucht.

Präfix anzeigen, Postfix anzeigen, und Argumente anzeigen

  Zeigt hilfreiche Informationen bei der Quelltextvervollständigung. Präfix und Postfix werden vor bzw. nach dem Namen angezeigt, die Argumente in Klammern direkt nach dem Namen.

Inhalt des Textbausteins

  Der wiederverwendbare Text oder Quelltext, der in Ihrem Dokument mit diesem Textbaustein eingefügt wird.

Im Inhalt des Textbausteins können Sie Variablen mit `${name}` oder `%{name}` bestimmen. Diese Variablen können durch QtScript oder beim Aufruf der Variablen durch Werte ersetzt werden. Es gibt eine besondere Variable ${cursor} oder %{cursor}, die den Cursor automatisch an die erste Position setzt, an der diese Variable auftritt.

### Textbausteine benutzen

Kate-Textbausteine in Aktion
Zugriff auf Kate-Textbausteine in der Werkzeugansicht und im Auswahlfeld.

Auswahl aus einer Liste von Textbausteinen.

Sie können Textbausteine auf zwei Arten aufrufen:

- Wählen Sie einen Textbaustein aus der Werkzeugansicht.

- Drücken Sie beim Schreiben die Tastenkombination &Ctrl; Leerzeichen, dann wird eine Liste aller Textbausteine in einem Auswahlfeld angezeigt. Sie können die ersten Buchstaben des Textbausteinnamens eingeben, ehe oder nachdem Sie diese Tastenkombination drücken. Dann erscheinen ähnlich wie bei der Quelltextvervollständigung nur die passenden Textbausteine im Auswahlfeld.

Wenn der Textbaustein zudem die Variable `${cursor}` enthält, geht der Cursor automatisch zur ersten Postion der Variablen und erlaubt Ihnen dann, hier einen Text einzugeben. Nach der Eingabe drücken Sie die &Tab;-taste, um zur nächsten Variablen zu springen usw.

### Danksagungen

Die &kate;-Textbausteine wurden von Joseph Wenninger geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Martin Gergov, der den Hauptteil diese Abschnitts geschrieben hat.

Salma
Sultana
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Erstellen-Modul

### Einleitung

Mit dem Erstellen-Modul können Sie ein Projekt erstellen, dessen Konfiguration zurücksetzen und es kompilieren.

### Das Erstellen-Modul benutzen

Aktivieren Sie das Erstellen-Module, dann wird eine Anzeige für die Ausgabe beim Erstellen unten im Fenster und ein Menü Erstellen in der Menüleiste eingefügt. Mit der Ausgabe beim Erstellen können Sie Einstellungen der Ziele angeben und im Menü Aktionen zum Erstellen, Aufräumen und Kompilieren aufrufen.

Die Ausgabe beim Erstellen zeigt drei Karteikarten an:

- Fehler und Warnungen

- Ausgabe

- Ziel-Einstellungen

#### Die Karteikarte „Ziel-Einstellungen“

Auf dieser Karteikante können Sie mehrere Ziele für das Erstellen angeben.

Für jedes Ziel gibt es vier Einstellungsmöglichkeiten:

Arbeitsordner

  Hier können Sie den Pfad für das Projekt eintragen. Wenn Sie dieses Feld leer lassen wird das Verzeichnis verwendet, in dem die aktuelle Datei gespeichert ist.

Erstellen

  Mit dieser Einstellung legen Sie den Befehl zum Erstellen fest. Die Voreinstellung ist `make`.

Aufräumen

  Mit dieser Einstellung legen Sie den Befehl zum Löschen der Konfiguration fest. Die Voreinstellung ist `make clean`.

Schnellkompilieren

  Mit dieser Einstellung legen Sie den Befehl zum Schnellkompilieren fest. Die Voreinstellung ist `gcc -Wall -g %f`.

Sie können mit dem Knopf Neu ein neues Ziel erstellen.Mit Kopieren wird ein vorhandenes Ziel kopiert. Um ein Ziel zu löschen, verwenden Sie den Knopf Löschen entfernen Sie ein Ziel.

#### Die Karteikarte „Ausgabe“

Die Karteikarte Ausgabe zeigt die Konsolenausgabe des letzten Befehls an.

#### Fehler und Warnungen

Die Karteikarte Fehler und Warnungen zeigt die Ausgabe der Fehler und Warnungen des letzten Befehls an.

Jede Zeile enthält eine Nachricht mit dem Namen der Datei und - wenn vorhanden - mit der Zeilennummer Klicken Sie auf eine Zeile mit Fehlern oder Warnungen, dann wird die zugehörige Datei geöffnet und der Cursor auf die angegebene Zeilennummer gesetzt..

Zum vorherigen Fehler oder der vorherigen Warnung gehen Sie mit &Ctrl;&Alt;Pfeil links, zum nächsten Fehler oder der nächsten Warnung mit &Ctrl;&Alt;Pfeil rechts.

### Menüstruktur

Erstellen Erstellen

  Führt den Befehl Erstellen für das aktuell ausgewählte Ziel aus.

Erstellen Aufräumen

  Führt den Befehl Aufräumen für das aktuell ausgewählte Ziel aus.

Erstellen Schnellkompilieren

  Führt den Befehl Schnellkompilieren für das aktuell ausgewählte Ziel aus.

&Ctrl;&Alt;Pfeil links Erstellen Vorheriger Fehler

  Verschiebt den Cursor zum vorherigen Fehler im Dokument.

&Ctrl;&Alt;Pfeil rechts Erstellen Nächster Fehler

  Verschiebt den Cursor zum nächsten Fehler im Dokument.

Erstellen Ziele

  Ermöglicht die Auswahl aus einer Liste von benutzerdefinierten Zielen.

Erstellen Nächstes Ziel

  Wechselt zum nächsten vom Benutzer definierten Ziel.

### Danksagungen

Das Erstellen-Modul für &kate; wurde von Kåre Särs geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Salma Sultana,der den Hauptteil diese Abschnitts geschrieben hat.

Ömer
Faruk
ORUÇ
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## SQL-Modul

### Einleitung

Die Datenbanksprache SQL (Structured Query Language) ist eine spezialisierte Sprache zur Aktualisierung, Löschung und Abfrage von Informationen von Datenbanken.

Mit dem SQL-Modul von &kate; können Sie:

- Eine Datenbank erstellen

- Eine Verbindung zu einer vorhandenen Datenbank erstellen

- Daten in eine Datenbank einfügen und löschen

- Abfragen ausführen

- Ergebnisse in einer Tabelle anzeigen

### Verbindung zu einer Datenbank

Wählen Sie Verbindung hinzufügen aus dem Menü SQL oder der Werkzeugleiste und dann einen QT-Datenbanktreiber (QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, und QPSQL). Fehlt ein gewünschter Treiber, dann müssen Sie ihn installieren. Drücken Sie dann den Knopf Weiter.

Wenn die ausgewählte Datenbank eine Datei verwendet, geben Sie nur den Ordner der Datenbank an und drücken dann den Knopf Weiter. Zur Verbindung zu einer Datenbank auf einem Server, müssen Sie den Rechnernamen des Servers, Ihren Benutzernamen, das Passwort und alle sonstigen erforderlichen Informationen für den ausgewählten Treiber angeben. Drücken Sie dann den Knopf Weiter.

Zum Abschluß geben Sie einen eindeutigen Namen für die Verbindung an und drücken auf Fertigstellen.

### Abfragen ausführen

#### INSERT/DELETE/UPDATE

Mit dem SQL-Modul können Sie genau wie von der Befehlszeile oder aus einem Programm Daten einfügen. löschen oder aktualisieren. Geben Sie die Abfrage eine und drücken Sie den Knopf Abfrage ausführen.

##### Einige Beispiel-Abfragen

`INSERT`

      INSERT INTO table_name ("feature1", "feature2", "feature3", "feature4", "feature5")
      VALUES ("value1", "value2", "value3", "value4", "value5" )

`DELETE`

      DELETE FROM table_name WHERE name = "text"

`UPDATE`

      UPDATE table_name SET "feature1" = "text", "feature2" = "text", "feature3" = "text", "feature4" = "text", "feature5" = "text"

#### SELECT

Nach der Ausführung einer `SELECT`-Abfrage wird das Ergebnis als Tabelle in der Ansicht SQL-Datenausgabe oder als Text in der SQL-Textausgabe unten im Fenster von &kappname; angezeigt. Fehlermeldungen erscheinen ebenfalls in der Textausgabe.

##### Beispiel einer `SELECT`-Abfrage

    SELECT * FROM table_name

In der Ansicht SQL-Datenausgabe gibt es einige Knöpfe:

Spaltengröße an Inhalte anpassen

  Ändert die Größe der Spalten, so dass der Inhalt vollständig angezeigt wird.

Zeilengröße an Inhalte anpassen

  Ändert die Größe der Zeilen, so dass der Inhalt vollständig angezeigt wird.

Kopieren

  Wählt den den gesamten Inhalt der Tabelle und kopiert ihn in die Zwischenablage.

Exportieren

  Exportiert die gesamte Tabelle in eine Datei, in die Zwischenablage oder das aktuelle Dokument als durch Komma getrennte Werte.

Zurücksetzen

  Löscht die gesamte Tabellenansicht.

Die in der Tabelle verwendeten Farben können Sie im Einrichtungsdialog auf der Seite SQL einstellen.

### Datenbank durchsuchen

Ihre Datenbank können Sie mit der Ansicht SQL-Schema-Browser links im Hauptfenster durchsuchen. Die darin angezeigten Informationen hängen vom verwendeten Datenbanktreiber ab.

Um die Liste zu aktualisieren, klicken Sie mit der &RMBn; irgendwo in die Ansicht und wählen Aktualisieren. Um eine Abfrage für einen Eintrag in der Liste auszuführen, klicken mit der &RMBn; darauf und wählen Erzeugen und die Art der Abfrage (SELECT, UPDATE, INSERT, und DELETE) aus dem Kontextmenü.

### Menüstruktur

SQL Verbindung hinzufügen ...

  Fügt eine neue Verbindung mit einem beliebigen Datenbanktreiber hinzu.

SQL Verbindung entfernen

  Entfernt die ausgewählte Verbindung.

SQL Verbindung bearbeiten ...

  Öffnet den Dialog Verbindungsassistent, in dem Sie die Einstellungen der Verbindung ändern können.

Verbindungen

  Alle von Ihnen erstellten Datenbankverbindungen werden im Menü SQL zwischen den Einträgen Verbindung bearbeiten und Abfrage ausführen angezeigt.

&Ctrl;E SQL Abfrage ausführen

  Startet Ihre SQL-Abfrage.

### Danksagungen

Das SQL-Modul wurde von Marco Mentasti geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Ömer Faruk ORUÇ, der den Hauptteil diese Abschnitts geschrieben hat.