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

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

- 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

- Such-Modul - Dateien nach einem Muster durchsuchen.

- 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

- Externe Programme

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

`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 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;

## 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 Cursortasten 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.

## In Dateien suchen

### Menüstruktur

Bearbeiten In Dateien suchen ...

  Öffnet den Dialog In Dateien suchen ..., der das Suchen nach Text in einem Ordner ermöglicht. Dieser Menüeintrag ist nur vorhanden,

Ansicht Werkzeugansichten In Dateien suchen anzeigen

  Schaltet die Anzeige des Werkzeuges In Dateien suchen ein und aus

T.C.
Hollingsworth

    tchollingsworth@gmail.com

## In Dateien suchen

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

Das Modul In Dateien suchenist in der Voreinstellung nicht aktiviert, da es erst in &kappname; 3.7 hinzugefügt wurde. Sie können dieses Modul auf der Seite Erweiterungen des Einrichtungsdialogs von &kappname; aktivieren. Es wird das alte Modul In Dateien suchen in der nächsten Version von &kappname; ersetzen.

### 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 statt dessen 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

  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

  Dies ermöglicht die Suche nach Dateinamen mit einem bestimmten Muster. Möchten Sie zum Beispiel nur in C++-Dateien suchen, geben Sie hier `*.cpp`. Um nur in Dateien zu suchen, deren Name mit `kate` beginnt, tragen Sie `kate*` ein.

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 ind 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 Dokumentes im Editorfenster um. Dieser Knopf ist deaktiviert, wenn das aktive Dokument neu und ungesichert ist oder wenn nicht entschieden werden kann, aus welchem Verzeichnis 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.

## Externe Programme

Im Menü Extras finden Sie ein UntermenüExterne Programme, wenn sie diese im Einrichtungsdialog von &kate; ausgewählt haben. Dies Menüeinträge starten externe Anwendungen mit Daten aus dem aktuellen Dokument wie &eg; der URL, Ordner, Text oder Auswahl.

Externe Programme werden vom Nutzer eingerichtet, Sie können neue hinzufügen, vorhandene ändern oder entfernen, indem Sie den Einrichtungsdialog für Externe Programme benutzen.

### Menüstruktur

Extras Externe Programme

  Dieses Untermenü enthält alle externen Programme, die Sie eingerichtet haben.

### Einstellungen

Die Einstellungen für die Einträge in diesem Untermenü finden Sie auf der Seite Externe Programme in &kate;s Einrichtungsdialog. Damit werden externe Programme mit Daten für das aktuell geöffnete Dokument aufgerufen, zum Beispiel mit seiner Adresse (URL), Ordner, Text oder der Auswahl. Auf dieser Seite können Sie das Menü bearbeiten und Einträge entfernen oder Neue hinzufügen.

Jedes externe Programm ist ein Befehlszeilenprogramm, das Makros für die Dokumentdaten enthält. Wenn die Programme benutzt werden, werden die Makros durch die Daten des Dokumentes ersetzt.

#### Verfügbare Befehle

Neu

  Fügt eine externes Programm zu Liste hinzu. Damit wird der weiter unten beschriebene Dialog Externe Programme geöffnet, in dem Sie das externe Programm einrichten können.

Bearbeiten

  Öffnet den unten beschriebenen Dialog, um den aktuell ausgewählten Eintrag zu bearbeiten.

Trennlinie einfügen

  Fügt eine Trennlinie im Menü unter dem aktuell ausgewählten Eintrag ein.

Pfeil nach oben

  Verschiebt den aktuell ausgewählten Eintrag über den vorherigen Eintrag.

Pfeil nach unten

  Verschiebt den aktuell ausgewählten Eintrag unter den nächsten Eintrag.

#### Eigenschaften der externen Programme

Bezeichnung

  Ein aussagekräftiger Name der im Menü Externe Programme als Menüeintrag angezeigt wird..

Symbol

  Wählt ein Symbol aus, das neben der Bezeichnung des Eintrags im Menü Externe Programme angezeigt wird.

Skript

  Das Skript, das ausgeführt wird, wenn das Programm gestartet wird. Bevor das Skript an den Befehlsinterpreter übergeben wird, werden die folgenden Makros ersetzt:

  `%URL`

    Die volle URL des Dokumentes oder eine leere Zeichenkette, wenn das Dokument noch nicht gesichert wurde.

  `%URLs`

    Eine Liste der URLs aller geöffneter Dokumente. Die einzelnen URLs sind durch Leerzeichen getrennt. Für noch nicht gesicherte Dateien werden keine URLs übergeben.

  `%directory`

    Der Teil der URL, der das Verzeichnis des aktuellen Dokuments beinhaltet oder für noch nicht gesicherte Dateien eine leere Zeichenkette.

  `%filename`

    Der Dateiname des aktuellen Dokuments ohne die Verzeichnisangabe oder für noch nicht gesicherte Dateien eine leere Zeichenkette.

  `%line`

    Die Zeilennummer des Cursors im aktuellen Dokument.

  `%column`

    Die Spaltennummer des Cursors im aktuellen Dokument.

  `%selection`

    Der im aktuellen Dokument markierte Text oder eine leere Zeichenkette, wenn kein Text markiert ist.

  `%text`

    Der gesamte Text des aktuellen Dokumentes. Beachten Sie dass dies sehr schnell die maximal erlaubte Befehlslänge Ihres Systems überschreiten kann. Vorsicht!

Ausführbare Datei

  Die ausführbare Datei ist das Skript. Dieses ist absolut notwendig und wird benutzt, um zu testen ob der Befehl überhaupt abgearbeitet werden kann. Eine vollständige Pfadangabe ist erlaubt, wenn der Pfad der ausführbaren Datei nicht in der Umgebungsvariablen `PATH` enthalten ist.

Mime-Typen

  Eine Liste von MIME-Typen, für die dieser Befehl erlaubt sein soll.

Speichern

  Sie können hier festlegen, ob das aktuelle Dokument oder alle geöffneten Dokumente gespeichert werden sollen, bevor das Skript ausgeführt wird. Wenn das Skript die Dateien, die es bearbeitet, von der Festplatte liest, ist das Speichern notwendig, weil sonst ein veralteter Stand bearbeitet wird.

Befehlszeilen-Name

  Wenn Sie dieses Feld ausfüllen, dann ist das externe Programm in der Befehlszeile des Editors als `exttool-Befehlszeilen-Name` verfügbar. (Der hier eingegebenen Zeichenkette muss dann exttool- voranstehen.)