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

    thd@kde.org

GUI-Übersetzung
Matthias
Schulz

    matthias.schulz@kdemail.net

Deutsche Übersetzung

# Arbeiten mit Modulen

Im Einrichtungsdialog können Sie einzelne Module auswählen. Hier finden Sie auch die Einstellungen für einzelne Module, bei denen das nötig ist.

## &kate;-Programmmodule

&kate;-Programmmodule 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 Module die gewünschten Module aus.

Folgende Programmmodule sind verfügbar:

- Externe Programme - Ausführung von externe Programmen und Anwendungen

- Backtrace-Browser - Ansicht zur Navigation in C/C++ Backtraces

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

- Bedingtes Schließen - Eine Gruppe von Dokumenten auf der Basis eines gemeinsamen Pfades oder einer Dateierweiterung schließen

- Farbwahl - Zeigt eine Vorschau für bekannte Farbnamen

- CTags - Definition/Deklaration mit CTags nachschauen

- Dokumentvorschau - Vorschau des Dokuments im Zielformat.

- Dokumentumschalter - Schnellwechsler für Dokumente mit &Alt;&Tab;

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

- Dokumentbaum - Zeigt geöffnete Dokumente als Baumansicht an

- &gdb; - Stellt eine einfache &gdb;-Oberfläche zur Verfügung.

- Projektmodul - Integration von &git; und anderen Versionsverwaltungen für Quelltexte

- Replicode - eine konstruktivistische KI-Programmiersprache und Laufzeitumgebung

- LSP-Client - Modul für Quelltextnavigation und -Vervollständigung für viele Sprachen

- Suchen und Ersetzen - Suchen und Ersetzen in Dokumenten, Ordnern oder Projekten

- Werkzeugansicht für Textbausteine - Werkzeugansicht für die eingebettete Verwaltung von Textbausteinen

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

- Symbolbetrachter - Referenzsymbole aus Quelldateien extrahieren und anzeigen

- Werkzeugansicht für Terminal - Werkzeugansicht, die &kde;'s &konsole; als Terminal einbettet

- Textfilter - Bearbeitung von Text mit Terminal-Befehlen

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

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

## Externe Programme

Das Modul Externe Programme ermöglicht den Aufruf externer Programme mit Daten zu dem aktuelle Dokument, z. B. dessen URL, Ordner, Text oder Auswahl. Sobald es aktiviert ist, erscheint eine Einrichtungsseite wie unten abgebildet, in der vorhandene Programme geändert oder entfernt werden können. Es können auch neue Programme hinzugefügt werden. Die Programme werden dann im Untermenü Externe Programme des des Menüs Extras der Anwendung angezeigt.

Auf der Einrichtungsseite können Sie neue externe Programme hinzufügen, indem Sie auf die Schaltfläche Hinzufügen klicken. In diesem Fall erscheint ein Menü, in dem Sie entweder ein neues externes Programm, ein vorhandenes Programm aus einer vordefinierten Liste oder eine neue Kategorie hinzufügen können.Die vorhandenen Programme können entweder durch Doppel-Klick oder durch Aufrufen von Bearbeiten... geändert werden und mit Entfernen gelöscht werden.

### Externe Programme einrichten

Zum Bearbeiten eines Programms wird ein Dialog mit vielen Einstellungsmöglichkeiten geöffnet:

Es können viele Details eingestellt werden, unter anderem:

  `Name`, der Name des Programms, der später im Menü angezeigt wird.

  `Symbol`, optionales Symbol, das im Menü angezeigt wird.

  `Programmdatei`, entweder der vollständige Pfad zur Datei oder der Pfad zur Datei muss über die Umgebungsvariable `PATH` erreichbar sein.

  `Argument`, optionale Argumente, die an die Programmdatei weitergeben werden.

  `Eingabe`, optionale Eingabe, die über stdin an den Prozess weitergeben wird.

  `Arbeitsordner`, der Arbeitsordner, in dem das Programm gestartet wird. Ist kein Arbeitsordner angegeben, wird der aktuelle Pfad des Dokuments als Arbeitsordner verwendet.

  `MIME-Typen`, sind hier MIME-Typen angegeben, dann wird das Programm nur aktiviert, wenn das aktuelle Dokument diesen MIME-Typ hat.

  `Speichern`, kann beim Aufruf nichts, das aktuelle Dokument oder alle Dokumente speichern.

  `Aktuelles Dokument nach der Ausführung neu laden`, nützlich wenn die aktuelle Datei auf der Festplatte geändert wird.

  `Ausgabe`, hier wird das Ziel von stdout festgelegt. Es kann entweder `Ignorieren`, `An Cursor-Position einfügen`, `Ausgewählten Text ersetzen`, `Aktuelles Dokument ersetzen`, `An aktuelles Dokument anhängen`, `In neues Dokument einfügen`, `In die Zwischenablage kopieren` oder `In Seitenleiste anzeigen` eingestellt werden.

  `Editorbefehl`, optionaler Befehlt, der in der eingebautenBefehlszeile zu Aufruf des Programms benutzt wird..

Der Knopf Voreinstellungen wird nur bei den in Kate enthaltenen Programmen angezeigt. Damit können alle Einstellungen auf den originalen Zustand zurückgesetzt werden.

### Variablen-Erweiterungen

Einige Bearbeitungsfelder wie Programmdatei, Argumentes, Eingabe und Arbeitsordner unterstützen Variablen, die beim beim Aufruf des Programms erweitert werden. Das wird durch das Symbol {} angezeigt. Dies erscheint, sobald eines dieser Texteingabefelder den Fokus hat (siehe roter Kreis):

Wenn Sie den Mauszeiger über eines dieser Texteingabefelder bewegen, wird außerdem eine Kurzinfo mit dem aktuellen erweiterten Text angezeigt. Außerdem öffnet ein Klick auf die Aktion {} einen Dialog, der alle verfügbaren Variablen auflistet:

Diese Funktion bietet eine große Flexibilität bei der Definition eines externen Programms, da alle Variablen der Form `%{...}` erweitert werden, wenn das Programm aufgerufen wird. Es werden zwei Arten von Variablen unterstützt:

- `%{variable-name}`

- `%{variable-name:<value>}`

In der ersten Form `%{variable-name}` wird einfach die Variable durch ihren Inhalt ersetzt. Zum Beispiel wird die Variable `%{Dokument:FileName}` durch den Dateinamen des aktuellen Dokuments ohne Pfadangabe ersetzt. In der zweiten Form wird `%{Variablenname:&lg; value>}` durch `<value>` ersetzt. Dies kann zum Beispiel für eine Umgebungsvariable mit `%{ENV:HOME}` oder für das aktuelle Datum im bevorzugten Format wie `%{Datum:jjjj-MM-tt}` verwendet werden,

Folgende Variablen werden unterstützt:

  `Document:FileBaseName`: Basisname der Datei des aktuellen Dokuments ohne Pfad und Erweiterung.

  `Document:FileExtension`: Dateierweiterung des aktuellen Dokuments.

  `Document:FileName`: Dateiname ohne Pfad des aktuellen Dokuments.

  `Document:FilePath`: Vollständiger Pfad des aktuellen Dokuments einschließlich des Dateinamens

  `Document:Text`: Inhalt des aktuellen Dokuments.

  `Document:Path`: Vollständiger Pfad des aktuellen Dokuments ohne den Dateinamen.

  `Document:NativeFilePath`: Vollständiger Pfad des Dokuments mit dem Dateinamen, mit dem nativen Pfadtrennzeichen (umgekehrter Schrägstrich unter Windows).

  `Document:NativePath`: Vollständiger Pfad des Dokuments ohne den Dateinamen, mit dem nativen Pfadtrennzeichen (umgekehrter Schrägstrich unter Windows).

  `Document:Cursor:Line`: Zeilennummer der Position des Cursors im aktuellen Dokument, Zählung beginnt mit 0.

  `Document:Cursor:Column`: Spaltennummer der Position des Cursors im aktuellen Dokument, Zählung beginnt mit 0.

  `Document:Cursor:XPos`: X-Komponente der Cursor-Position in globalen Bildschirmkoordinaten.

  `Document:Cursor:YPos`: Y-Komponente der Cursor-Position in globalen Bildschirmkoordinaten.

  `Document:Selection:Text`: Textauswahl im aktiven Dokument.

  `Document:Selection:StartLine`: Startzeile des ausgewählten Texts im aktiven Dokument.

  `Document:Selection:StartColumn`: Startspalte des ausgewählten Texts im aktiven Dokument.

  `Document:Selection:EndLine`: Endzeile des ausgewählten Texts im aktiven Dokument.

  `Document:Selection:EndColumn`: Endspalte des ausgewählten Texts im aktiven Dokument.

  `Document:RowCount`: Zeilenanzahl im aktiven Dokument.

  `Document:Variable:<variable>`: Beliebige Dokumentvariablen erweitern.

  `Date:Locale`: Das aktuelle Datum in Ihren lokalen Format.

  `Date:ISO`: Das aktuelle Datum im ISO-Format.

  `Date:<value>`: Das aktuelle Datum im QDate-Format.

  `Time:Locale`: Die aktuelle Zeit in Ihren lokalen Format.

  `Time:ISO`: Die aktuelle Zeit im ISO-Format.

  `Time:<value>`: Die aktuelle Zeit im QTime-Format.

  `ENV:<value>`: Zugriff auf Umgebungsvariablen.

  `JS:<expression>`: Einfache JavaScript-Ausdrücke auswerten:

  `PercentEncoded:<text>`: Durch das Prozentzeichen kodierter Text.

  `UUID`: Eine neue UUID erzeugen.

### Liste der Standard-Programme

Einige Programme werden als Voreinstellung mitgeliefert. Wenn Sie jedoch weitere nützliche Programme haben senden Sie diese bitte an kwrite-devel@kde.org, damit wir sie zu dieser Liste hinzufügen können. Alle Standardwerkzeuge werden in der Listenansicht angezeigt. Sie können jedoch alle Programme nach Ihren Wünschen ändern, einschließlich der Kategorie oder auch sogar Programme löschen. Gelöschte Programme können wieder hinzugefügt werden, indem Sie Hinzufügen in der Einrichtungsseite wie oben beschrieben klicken.

#### git-cola

„git-cola“ ist ein grafisches Dienstprogramm für Git, mit dem Sie auf einfache Weise Commits (Änderungen) zu übertragen. Wenn „git-cola“ installiert ist, können Sie das Programm auch über die Befehlszeile durch Eingabe von `git-cola` verwenden.

  `Name`: git-cola

  `Symbol`: git-cola

  `Programmdatei`: git-cola

  `Argumente`: -r %{Document:Path}

  `Editorbefehl`: git-cola

#### gitk

„gitk“ ist ebenfalls ein Dienstprogramm für Git, mit dem sich die Git-Historie schön visualisieren lässt.

  `Name`: gitk

  `Symbol`: git-gui

  `Programmdatei`: gitk

  `Arbeitsordner`: %{Document:Path}

  `Editorbefehl`: gitk

#### git blame

Startet „git blame“, um Git-Änderungen in der aktuellen Datei einfach zu verfolgen.

  `Name`: git blame

  `Programmdatei`: git

  `Argumente`: gui blame %{Document:FileName}

  `Save`: Aktuelles Dokument speichern

  `Arbeitsordner`: %{Document:Path}

  `Editorbefehl`: git-blame

#### Shell-Skript ausführen

Startet eine externe Konsole, in der das aktuelle Dokument ausgeführt wird. Das Skript muss den Interpreter in der ersten Zeile über einen Shebang mit `#!/pfad/interpreter` angeben.

  `Name`: Shell-Skript ausführen

  `Symbol`: system-run

  `Programmdatei`: konsole

  `Argumente`: -e sh -c "cd %{Document:Path} && pwd && chmod -vc a+x %{Document:FileName} && ./%{Document:FileName} ; echo Press any key to continue. && read -n 1"

  `Save`: Aktuelles Dokument speichern

  `Arbeitsordner`: %{Document:Path}

  `Editorbefehl`: run-script

#### Ausgewählten Text mit Google suchen

Suchen nach dem ausgewählten Text in Google.

  `Name`: Ausgewählten Text mit Google suchen

  `Symbol`: globe

  `Programmdatei`: xdg-open

  `Argumente`: "https://www.google.com/search?q=%{Document:Selection:Text}"

  `Editorbefehl`: google

#### UUID einfügen

Fügt jedes mal eine neue UUID ein, wenn diese Aktion ausgeführt wird.

  `Name`: UUID einfügen

  `Programmdatei`: echo

  `Argumente`: %{UUID}

  `Output`: An Cursor-Position einfügen

  `Editorbefehl`: uuid

#### Ganze Datei mit Clang formatieren

Führt clang-format für aktuelle Datei auf der Festplatte aus. Das Dokument wird danach wieder neu geladen.

  `Name`: Ganze Datei mit Clang formatieren

  `Programmdatei`: clang-format

  `Argumente`: -i %{Document:FileName}

  `Arbeitsordner`: %{Document:Path}

  `Save`: Aktuelles Dokument speichern

  `Neu laden`: Ja

  `Editorbefehl`: clang-format-file

#### Ausgewählten Text mit Clang formatieren

Führt clang-format nur für den ausgewählten Text im aktuellen Dokument aus.

  `Name`: Ausgewählten Text mit Clang formatieren

  `Programmdatei`: clang-format

  `Argumente`: -assume-fileName: %{Document:FileName}

  `Arbeitsordner`: %{Document:Path}

  `Input`: %{Document:Selection:Text}

  `Output`: Ausgewählten Text ersetzen

  `Editorbefehl`: clang-format-selection

#### „Qt Quick 2“-Vorschau (qmlscene)

Vorschau der gesamten Datei in qmlscene.

  `Name`: „Qt Quick 2“-Vorschau (qmlscene)

  `Programmdatei`: qmlscene

  `Argumente`: %{Document:FileName}

  `Save`: Aktuelles Dokument speichern

  `Arbeitsordner`: %{Document:Path}

  `Editorbefehl`: qml-preview

#### Ganze Datei mit JSON formatieren

Formatiert die gesamte JSON-Datei.

  `Name`: Ganze Datei mit JSON formatieren

  `Symbol`: application-json

  `Programmdatei`: jq

  `Argumente`: %{Document:FileName}

  `Save`: Aktuelles Dokument speichern

  `Arbeitsordner`: %{Document:Path}

  `Output`: Aktuelles Dokument ersetzen

  `Editorbefehl`: json-format-file

#### Ganze Datei mit XML formatieren

Formatiert die gesamte XML-Datei.

  `Name`: Ganze Datei mit JSON formatieren

  `Symbol`: application-xml

  `Programmdatei`: xmllint

  `Argumente`: --format %{Document:FileName}

  `Save`: Aktuelles Dokument speichern

  `Arbeitsordner`: %{Document:Path}

  `Output`: Aktuelles Dokument ersetzen

  `Editorbefehl`: xml-format-file

## Backtrace-Browsermodul

### Das Backtrace-Browsermodul benutzen

Dieses Modul ist für Entwickler gedacht und wahrscheinlich von geringem Nutzen für Anwender. Es zeigt einen von `gdb` gelieferten Backtrace in einer Liste in einer &kate;-Werkzeugansicht. Klicken auf ein Element öffnet die ausgewählte Datei und springt zur richtigen Zeilennummer. Es funktioniert für Backtraces, die auf Ihrem eigenen Rechner erzeugt wurden, aber auch für Backtraces von Anderen, &ie; `/home/dummy/qt-copy/.../qwidget.cpp` wird weiterhin auf anderen Rechnern gefunden. Dafür müssen Sie die Ordner mit dem Quelltext indizieren.

Manchmal gibt es mehrere Dateien mit dem gleichen Namen wie &eg;:

- `kdegraphics/okular/generators/dvi/config.h`
- `kdepim-runtime/resources/gmail/saslplugin/config.h`

Um die richtige Auswahl zu treffen, werden die letzten beiden Teile der &URL; verwendet, in diesem Fall:

- `dvi/config.h`
- `saslplugin/config.h`

Dann wird normalerweise die richtige Datei gefunden.

Wenn Sie aber sowohl „master“ als auch einen Branch indizieren, gibt es eine Kollision.

### Einstellungen

Fügen Sie auf der Einstellungsseite die Ordner mit dem Quelltext hinzu.

Backtrace-Browser
Einrichtung von Pfaden in der Ansicht des Backtrace-Browser

Klicken Sie auf OK, um die Indizierung zu starten. Ist die Indizierung beendet, öffnen die Ansicht des Backtrace-Browser.

Nun können Sie einen Backtrace aus der Zwischenablage laden, wenn Sie &eg; in &drkonqi; auf In Zwischenablage kopieren gedrückt haben oder Sie laden einen Backtrace aus einer Datei.

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

Ausgabe beim Erstellen

Die Ausgabe beim Erstellen zeigt zwei Karteikarten an:

- Ziel-Einstellungen

- Ausgabe

#### Die Karteikarte „Ziel-Einstellungen“

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

Um Namen oder Befehle zu ändern, doppelklicken Sie auf die Einträge in der Tabelle und verwenden das Auswahlfeld, um die aktive Zielgruppe auszuwählen. Benutzen Sie das Ankreuzfeld vor jedem Ziel, um die Voreinstellung festzulegen.

Für ein neues Ziel gibt es mehrere Einstellungsmöglichkeiten:

Arbeitsordner

  Hier können Sie den Pfad für das Projekt eintragen. Wenn Sie dieses Feld leer lassen wird der Ordner 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`.

Einstellungen

  Mit dieser Einstellung legen Sie den Befehl zur Konfiguration fest. Die Voreinstellung ist `cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../`.

Oben in diesem Modul gibt es eine Werkzeugleiste mit folgenden Knöpfen:

- Ausgewähltes Ziel erstellen
- Neues Ziel hinzufügen
- Neue Zielgruppe erstellen
- Befehl oder Zielgruppe kopieren
- Aktuelle Zielgruppe löschen

#### Die Karteikarte „Ausgabe“

Die Karteikarte Ausgabe zeigt die Konsolenausgabe des letzten Befehls an.

Mit den Schieberegler oben können Sie Kategorien für die Ausgabe aus- oder einblenden:

Vollständige Ausgabe, Verarbeitete Ausgabe, Fehler und Warnungen oder Nur Fehler

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 gehen Sie mit &Alt;&Shift;&Left;, zum nächsten Fehler mit &Alt;&Shift;&Right;.

### Menüstruktur

Erstellen Ziel auswählen

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

Erstellen Standardziel erstellen

  Erstellt das als Voreinstellung definierte Ziel in der aktiven Zielgruppe.

Erstellen Vorheriges Ziel erstellen

  Wechselt zum vorherigen vom Benutzer definierten Ziel.

Erstellen Anhalten

  Hält das Erstellen eines Ziels an.

&Ctrl;&Alt;&Left; Erstellen Vorheriger Fehler

  Verschiebt den Cursor zum vorherigen Fehler im Dokument.

&Ctrl;&Alt;&Right; Erstellen Nächster Fehler

  Verschiebt den Cursor zum nächsten Fehler im Dokument.

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

## Modul zum bedingten Schließen

### Einleitung

Mit diesem Modul können Sie eine Gruppe von Dokumenten anhand ihrer Dateierweiterungen und Pfade schließen.

### Das Modul zum bedingten Schließen benutzen

Angenommen Sie haben folgende Dokumente in &kate; geöffnet:

- /tmp/subfolder/test.h
- /tmp/test.cpp
- /tmp/test.txt

Wie im folgenden Bildschirmfoto gezeigt wird, gibt es dann folgende Möglichkeiten zum Schließen von Dokumenten.

Schließen außer

Verwenden Sie das Ankreuzfeld im letzten Eintrag der Liste, um einen Bestätigungsdialog zu aktivieren oder zu deaktivieren. Die gewählte Einstellung wird auf beide Aktionen zum Schließen angewendet.

### Menüstruktur

Datei Schließen außer

  Schließt alle offenen Dokumente, außer denen, auf die der Pfad oder die Dateierweiterung passt, die im Untermenü ausgewählt wurde.

Datei Schließen ähnlich

  Schließt alle offenen Dokumente, auf die der Pfad oder die Dateierweiterung passt, die im Untermenü ausgewählt wurde.

## Farbauswahl-Modul

### Einleitung

Dieses Modul fügt eine Farbvorschau/Farbwahl in der Zeile im Text hinzu (&eg;, `#FFFFFF`, `white`).

Um dieses Modul zu laden, öffnen Sie den Einrichtungsdialog von &kate; mit Einstellungen &kate; einrichten .... Wählen Sie dann Farbauswahl im Abschnitt Programm / Module und schließen den Dialog.

### Einstellungen

Auf der Seite mit den Einstellungen für die Farbwahl können Sie die folgenden Einstellungen für das Verhalten des Moduls festlegen.

Vorschau für bekannte Farbnamen anzeigen

  Ob die Farbauswahl für bekannte Farbnamen angezeigt werden soll (&eg;, `skyblue`). Auf dieser Seite finden Sie eine Liste der Farben.

Vorschau nach der Textfarbe anzeigen

  Ob die Vorschau in der Zeile nach der Textfarbe im Text platziert werden soll.

Farbübereinstimmung nach Hexadezimal-Werten

  Hier können Sie die am besten passende Einstellung für die in Ihrem Quelltext verwendeten Farben wählen.

## CTags-Modul

### Einleitung

CTags generiert eine Datei mit Indizes oder Tags von allen Sprachobjekten in Quelltexten. In &kate; können Sie mit diesem Modul diese Einträge schnell und einfach finden.

Ein Tag kennzeichnet ein Sprachobjekt, für das eine Indexeintrag verfügbar oder alternativ erstellt wird.

Die Generation von Tags wird für diese Programmiersprachen unterstützt.

### Einstellungen

Das Modul CTags verwendet zwei verschiedene Datenbankdateien für den Index.

Auf dieser Einstellungsseite für CTags im Einrichtungsdialog von &kate; können Sie Ordner mit dem Quelltext hinzufügen oder entfernen und die allgemeine CTags-Datenbank neu erstellen.

#### Allgemeiner Index

CTags-Einstellungen
Globale Datenbank für CTags einrichten

Unten auf der Einstellungsseite können Sie den CTags-Befehl anpassen.

Weitere Informationen über alle verfügbaren Optionen finden Sie im Handbuch zu CTags n &khelpcenter; oder geben Sie die &URL; man:/ctags in &konqueror; ein.

Klicken Sie auf Aktualisieren, um die Indizierung zu starten. Ist die Indizierung beendet, schließen Sie den Dialog,

#### Sitzungs-Index

Um den Sitzungsindex einzurichten, öffnen Sie die Ansicht CTags.

Ziele indizieren

  Auf dieser Karteikarte können Sie Ordner mit dem Quelltext hinzufügen oder entfernen und die sitzungsspezifische CTags-Datenbank neu erstellen.

Datenbank
  Datenbankeinstellungen
  Sitzungs-Datenbank für CTags einrichten

  Wählen Sie eine andere CTags-Datenbankdatei, richten Sie den CTags-Befehl ein oder stellen Sie den Standardbefehl wieder her.

### Das CTags-Modul benutzen

Setzen Sie den Cursor in ein Sprachobjekt wie eine Funktion, Symbol &etc; und verwenden Sie dann die Aktionen im Menü CTags, um zur Datei und Zeile mit der Deklaration oder Definition des Objekts zu springen.

Als Voreinstellung sind den Aktionen im Menü CTags keine Kurzbefehle zugewiesen. Benutzen Sie den Dialog Kurzbefehle festlegen, um eigene Kurzbefehle zu definieren.

Alternativ können Sie das Suchfeld auf der Karteikarte Nachschlagen in der CTags-Ansicht verwenden.

Mit der Eingabe von Zeichen in das Suchfeld wird die Suche gestartet und passende Sprachobjekte wie Funktionen, Klassen, Symbolen &etc; zusammen mit Typ und Dateinamen angezeigt.

Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

### Menüstruktur

CTags Einen Schritt zurückgehen

  Geht im Verlauf zu dem zuletzt angezeigten Tag zurück.

CTags Aktuellen Text suchen

  Öffnet die Karteikarte Nachschlagen in der CTags-Ansicht und zeigt alle Sprachobjekte in einer Liste, die zur aktuellen Textauswahl passen.

CTags Zur Deklaration gehen

  Befindet sich der Cursor in einer Objektdefinition, wird mit dieser Aktion das Dokument geöffnet, das die Deklaration enthält, falls erforderlich, zur Ansicht gewechselt und der Cursor an den Anfang der Deklaration gesetzt.

CTags Zur Definition gehen

  Befindet sich der Cursor in einer Objektdeklaration, wird mit dieser Aktion das Dokument geöffnet, das die Definition enthält, falls erforderlich, zur Ansicht gewechselt und der Cursor an den Anfang der Definition gesetzt.

## Dokumentvorschau-Modul

### Einleitung

Diese Modul ermöglicht eine Live-Vorschau des aktuell bearbeiteten Textdokuments im endgültigen Format in der Seitenleiste. Wenn Sie &eg; einen &Markdown;-Text oder ein &SVG;-Grafik bearbeiten, wird das Ergebnis sofort neben dem Quelltext angezeigt.

Für die Anzeige wird das &kparts;-Modul verwendet, das für den &MIME;-Typ des Dokuments als bevorzugtes Modul eingestellt ist. Gibt es für diesen Typ kein &kparts;-Modul, ist eine Anzeige nicht möglich.

Um das bevorzugte Modul zu ändern, öffnen Sie das Modul Dateizuordnungen in den &systemsettings; und ändern die Rangfolge der zugeordneten Dienstprogramme auf der Karteikarte Einbetten.

#### Einige verfügbare &kparts;-Module

&MIME;-Typ | &kparts;-Modul
&Markdown;-Text | KMarkdownWebViewPart oder OkularPart
&SVG;-Grafik | SVGPart
&Qt;-UI-Dateien | KUIViewerPart
&DOT;-Graphendateien | KGraphViewerPart

### Menüstruktur

Ansicht Werkzeugansichten Vorschau anzeigen

  Schaltet die Anzeige der Dokumentvorschau in der Seitenleiste ein und aus.

### Oberfläche

Mit den Knöpfen oben im Vorschaufenster können Sie folgende Aktionen ausführen:

- Beschränken Sie die Vorschau auf ein bestimmtes Dokument. Durch die Auswahl dieser Option wird beim Wechseln zur Ansicht eines anderen Dokuments im selben &kate;-Fenster ,die Vorschau nicht auf dieses Dokument angezeigt, sondern die Vorschau dieses Dokuments.

- Die automatische Aktualisierung der Vorschau des Inhalts des aktuellen Dokuments ein- oder ausschalten

- Die Vorschau des Inhalts des aktuellen Dokuments manuell aktualisieren

- Ein Aufklappmemü mit Aktionen des &kparts;-Moduls

## Dokumentumschalter-Modul

### Menüstruktur

&Ctrl;&Tab; Ansicht Zuletzt verwendete Ansichten
&Ctrl;&Shift;&Tab; Ansicht Zuletzt verwendete Ansichten (rückwärts)

  Öffnet eine Liste mit den zuletzt angesehenen Dokumenten:

  Zuletzt angesehene Dokumente

  Halten Sie die &Ctrl;-Taste gedrückt und verwenden Sie die &Tab;-Taste, um vorwärts durch die Listenansicht zu blättern. Drücken Sie zusätzlich die &Shift;taste, um die Richtung umzudrehen.

  Halten Sie die Tasten &Ctrl;&Tab; gedrückt, dann können Sie mit den Tasten &Up;, &Down;, &Home; oder &End; in der Liste navigieren. Drücken Sie fortlaufend eine Zeichentaste, um durch alle Einträge mit diesem Zeichen an Anfang des Dateinamens zu gehen. Lassen Sie die Tasten los, wechselt die Ansicht zum ausgewählten Dokument in der Liste.

## Der Dateisystem-Browser

Der Dateisystem-Browser ist ein Ordneranzeige, in der Sie Dateien im aktuell angezeigten Ordner ö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.

  Optionen
    Kurzansicht

      Zeigt nur die Namen der Dateien.

    Ausführliche Ansicht

      Zeigt Name, Datum und Größe 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 Basisordner 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 Ordneransicht

  Dies ist eine Standard-&kde;-Ordneransicht.

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.

## Die Dokumentenliste

### Einleitung

Die Dokumentenliste zeigt alle aktuell in &kate; geöffneten Dateien an. Dateien, die noch nicht gesicherte Änderungen enthalten, werden mit einem kleinen Disketten-Symbol links neben dem Dateinamen gekennzeichnet.

Oben in der Dokumentenliste gibt es eine Werkzeugleiste mit folgenden Knöpfen:

- Neues Dokument erstellen
- Ein existierendes Dokument öffnen
- Vorheriges Dokument
- Nächstes Dokument
- Speichert das aktuelle Dokument
- Speichert das aktuelle Dokument unter einem neuen Namen

Als Voreinstellung zeigt die Dokumentenliste eine Baumansicht, die die Ordnerstruktur aller geöffneten Dokumente wiedergibt. Alternativ kann die Listenansicht benutzt werden, die alle geöffneten Dokumente als Liste anzeigt. Zwischen diesen Modi können Sie wechseln, indem Sie mit der &RMBn; auf die Liste klicken und im Kontextmenü einen Ansichtsmodus wählen.

Wenn zwei oder mehrere Dateien mit demselben Namen (in verschiedenen Verzeichnissen) in der Listenansicht geöffnet sind, wird an die Namen eine Zahl angehängt &eg; (2) &etc; Für die Auswahl der gewünschten Datei wird ihr Name einschließlich Pfad in der Kurzinfo angezeigt.

Wenn Sie ein Dokument aus der Liste aktiv machen wollen, klicken Sie einfach auf den Namen des Dokuments in der Liste.

Im Kontextmenü finden Sie einige Aktionen aus dem Menü Datei.

Außerdem gibt es Aktionen zur Dateiverwaltung wie Umbenennen oder Löschen von Dateien. Mit Dateipfad kopieren können Sie den vollständigen Pfad eines Dokuments in die Zwischenablage kopieren.

Sie können die Liste nach verschiedenen Kriterien sortieren, indem Sie mit der rechten Maustaste auf die Liste klicken und im Menü Sortieren nach auswählen. Es stehen folgende Sortierungen zur Auswahl:

Dokumentname

  Listet die Dokumente in der alphabetischen Reihenfolge des Namens auf.

Dokumentpfad

  Listet die Dokumente in der alphabetischen Reihenfolge des gesamten Pfades zum Dokument auf.

Reihenfolge beim Öffnen

  Listet die Dokumente in der Reihenfolge, in der sie geöffnet wurden, auf

Die Dokumentenliste stellt standardmäßig die Einträge farbig dar: Die Einträge der zuletzt bearbeiteten Dokumente werden mit einer Hintergrundfarbe hervorgehoben, Dokumente, die tatsächlich bearbeitet wurden werden durch eine zusätzliche eingeblendete Farbe hervorgehoben. Das Dokument, das zuletzt bearbeitet wurde, hat die stärkste Farbe, sodass Sie die Dokumente, an denen Sie aktuell arbeiten, einfach finden können. Diese Hervorhebungen können Sie im Einrichtungsdialog auf der Seite Dokumente einstellen.

Die Standardposition der Dokumentliste ist links vom Editorbereich im &kate;-Fenster.

### Menüstruktur

&Alt;&Up; Ansicht Vorheriges Dokument

  Zeigt das Dokument über dem aktuell geöffneten Dokument in der Dokumentenliste an.

&Alt;&Down; Ansicht Nächstes Dokument

  Zeigt das Dokument unter dem aktuell geöffneten Dokument in der Dokumentenliste an.

Ansicht Aktive anzeigen

  Zeigt das aktuell geöffnete Dokument in der Dokumentenliste.

### Einstellungen

Hintergrundeinfärbung

  In diesem Abschnitt können Sie die Hintergrundeinfärbung der zuletzt angezeigten Dokumente ein- oder ausschalten und die Farben für die Einfärbung einstellen.

Sortieren nach

  Stellt ein, wie die Dokumentliste sortiert wird. Diese Einstellung kann auch vom mit der &RMBn; aufrufbaren Menü vorgenommen werden.

Ansichtsmodus

  Hier gibt es zwei Einstellungen, die die Anzeige in der Werkzeugansicht Dokumente beeinflussen. Mit Baumansicht werden die Dokumente unterhalb der Ordner, in denen sie sich befinden, angezeigt, während die Listenansicht eine flache Liste der Dokumente anzeigt.

Vollständigen Pfad anzeigen

  Wenn die Baumansicht und diese Einstellung aktiviert sind, zeigen die Ordnereinträge in der Werkzeugansicht Dokumente den vollständigen Pfad zum Ordner im Dateisystem zusätzlich zum Namen des Ordners. Dies hat in der Listenansicht keinen Effekt.

Werkzeugleiste anzeigen

  Wenn die Baumansicht und diese Einstellung aktiviert sind, wird eine Symbolleiste mit Aktionen wie Speichern oberhalb der Liste der Dokumente angezeigt. Deaktivieren Sie diese Option, wenn die Symbolleiste ausgeblendet werden soll.

„Schließen“-Knopf anzeigen

  Ist dies aktiviert, wird ein Knopf zum Schließen für geöffnete Dokumente angezeigt, wenn der Mauszeiger sich darüber befindet.

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

## &gdb;-Modul

### Einleitung

&kate;s &gdb;-Modul stellt eine einfache Oberfläche für den Debugger des &GNU;-Projekts zur Verfügung.

Erfahrung im Umgang mit &gdb; wird für dieses Modul dringend empfohlen. Weitere Informationen über die Anwendung von &gdb; finden Sie auf der &gdb;-Webseite.

Sie können das &gdb;-Modul im Abschnitt Module des Einrichtungsdialogs von &kate; aktivieren.

Damit das Modul richtig funktioniert, brauchen Sie eine Quelltextdatei, deren Typ von &gdb; unterstützt wird, und die ausführbare Programmdatei.

Wenn Sie den Compiler &gcc;/`g++` verwenden, benötigen Sie das Befehlszeilenargument ``-ggdb``.

Nach diesen Vorbereitungen öffnen Sie die Quelltextdatei in &kate;, geben den Pfad zum ausführbaren Programm auf der Karteikarte Einstellungen der Debug-Ansicht ein und wählen zum Start Debuggen Debuggen starten aus dem Menü.

### Menü- und Werkzeugleistenstruktur

Alle Aktionen finden Sie in &kate;s Menüs, viele dieser Aktionen auch in der Werkzeugleiste GDB-Erweiterung.

Ansicht Werkzeugansichten Debug-Ansicht anzeigen

  Zeigt eine Werkzeugansicht mit der &gdb;-Ausgabe, einer &gdb;-Befehlszeile und weiteren Einstellungen.

Ansicht Werkzeugansichten Lokale Variablen und Aufrufstapel anzeigen

  Zeigt eine Liste aller aktuell geladenen Variablen und deren Werte und eine &gdb;-Rückverfolgung.

Debuggen Ziele

  Ein Untermenü mit einer Liste von Zielen (ausführbaren Programmen).

Debuggen Debuggen starten

  Startet &gdb; mit einem Ziel.

Debuggen Debuggen beenden/abbrechen

  Beendet &gdb;.

Debuggen Debuggen neu starten

  Startet &gdb; erneut.

Debuggen Haltepunkt ein-/ausschalten

  Setzt einen Haltepunkt an der aktuellen Cursor-Position.

Debuggen Einzelschritt

  Führt die aktuelle Anweisung aus und untersucht die Funktion.

Debuggen Funktionsschritt

  Führt die aktuelle Anweisung aus und überspringt die Funktion.

Debuggen Ausführen bis Rücksprung

  Startet die Ausführung des Programms wieder bis zum Ende der Programmausführung.

Debuggen Programmzähler verschieben

  Verschiebt den Programmzähler zur nächsten Ausführung.

Debuggen Bis zum Cursor ausführen

  Führt das Programm bis zur aktuellen Cursor-Position aus.

Debug Fortsetzen

  Ignoriert alle Haltepunkte und führt das Programm bis zum erfolgreichen Ende oder zum Absturz aus.

Debuggen Wert anzeigen

  Gibt den Wert der Variablen unter der aktuellen Cursor-Position.

Einstellungen Angezeigte Werkzeugansichten &gdb;-Modul

  Blendet die Werkzeugleiste des GDB-Moduls ein oder aus.

### Debug-Ansicht

Die Debug-Ansicht besteht aus mehreren Karteikarten:

&gdb;-Ausgabe

  Enthält die Ausgaben von &gdb; und eine &gdb;-Befehlszeile.

  Die Karteikarte „GDB-Ausgabe“
  Die Karteikarte „GDB-Ausgabe“

  Die Karteikarte GDB-Ausgabe zeigt die Ausgabe einer Debuggersitzung an.

Einstellungen
  Ausführbare Datei

    Pfad zum Ziel (ausführbares Programm) zum Debuggen.

  Arbeitsordner

    Der aktuelle Arbeitsordner des Ziels.

  Argumente

    Argumente, die an das Programm übergeben werden.

  Aktiviert halten

    Behält den Fokus auf der &gdb;-Befehlszeile.

  E/A umleiten

    Öffnet eine neue Karteikarte E/A in der Debug-Ansicht, die die Ausgabe des laufenden Programms zeigt und Eingaben für das Programm ermöglicht.

  Der Einrichtungsdialog
  Der Einrichtungsdialog

  Der Dialog Einstellungen zeigt die Einstellungen einer Debuggersitzung an.

E/A

  Enthält eine Karteikarte für die Ausgabe des laufenden Programms und eine Befehlszeile für Eingaben zum Programm.

  Die Karteikarte „E/A“
  Die Karteikarte „E/A“

  Die Karteikarte E/A mit der Ausgabe eines einfachen Testprogramms.

### Aufrufstapel und lokale Variablen

Die Ansicht Aufrufstapel enthält einen formatierten Backtrace (Rückverfolgung), der von &gdb; ausgegeben wurde.

Die Ansicht des &gdb;-Aufrufstapels
Die Ansicht des Aufrufstapels.

Die Ansicht Aufrufstapel des &gdb;-Moduls.

Die Ansicht Lokale Variablen enthält eine Liste aller zurzeit geladenen Variablen des Programms und die Werte dieser Variablen.

Die Ansicht „Lokale Variablen“ des &gdb;-Moduls
Die Ansicht „Lokale Variablen“ der &gdb;-Moduls.

Die Ansicht Lokale Variablen des &gdb;-Moduls.

### Danksagungen

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

## Projektmodul

### Einleitung

Im Projekt-Modul wird eine strukturierte Liste von Dateien, die zu einem Projekt gehören, mit folgenden Eigenschaften angezeigt:

1. Eine strukturierte Ansicht der Dateien

2. Einfaches Öffnen und Wechseln zwischen Projekten

3. Suchen und Ersetzen in einem Projekt

4. Einfache Autovervollständigung

5. Dateien im Projekt schnell öffnen

6. Unterstützung für das Erstellen des Projekts

### Strukturierte Ansicht der Dateien

Ist das Projekt-Modul auf der Einrichtungsseite von &kate; aktiviert, können Sie eine Datei in einem Projekt öffnen. Dann wird eine Seitenleiste mit allen Projekten und deren Dateien wie folgt angezeigt:

Projektansicht

Das derzeit aktuelle Projekt ist Kate, der Inhalt wird in der Baumansicht angezeigt. Klicken Sie auf Dateien in der Baumansicht, um sie im Editor zu öffnen. Zusätzlich gibt es ein Kontextmenü, mit dem Sie Dateien mit anderen Programmen wie zum Beispiel `.ui`-Dateien mit dem Qt Designer öffnen können.

Sie können die Einträge filtern, indem Sie Teile des gesuchten Dateinamens in das Suchfeld unter der Liste eingeben.

### Projekte wechseln

Mit diesem Modul müssen Sie ein Projekt nie manuell öffnen, das ist auch nicht möglich. Wenn Sie eine Datei öffnen, durchsucht das Projekt-Modul schnell den Ordner und seine übergeordneten Ordner nach einer Datei mit dem Namen `.kateproject`. Wird diese Datei gefunden, wird das Projekt automatisch geladen.

Wenn Sie ein Dokument in &kate; öffnen, das zu einem anderen Projekt gehört, wechselt das Projekt-Modul automatisch zu diesem Projekt, Also ist immer das richtige Projekt aktiv. Natürlich können Sie auch mit dem Kombinationsfeld das aktuell aktive Projekt wechseln.

### Suchen und Ersetzen in Projekten

In &kate; gibt es ein Modul „Suchen und Ersetzen“, das in der Statusleiste unten angezeigt wird. Haben Sie ein Projekt geladen, öffnen Sie „Suchen und Ersetzen“ und wählen einen Modus für das aktuelle Projekt aus:

Suchen in Projekten

### Einfache Autovervollständigung

Das Projekt-Modul kann aus allen zu einem Projekt gehörenden Dateien eine einfache automatische Vervollständigung auf der Grundlage von CTags bereit stellen. Wird ein Projekt zum ersten mal geöffnet, Liest CTags alle Projektdateien im Hintergrund ein und speichert die CTags-Informationen in einer Datei im Ordner `/tmp`. Diese Datei wird dann verwendet, um die Vorschläge für die automatische Vervollständigung zu anzuzeigen.

Im Gegensatz dazu kann &kate; ohne CTags nur eine automatische Vervollständigung aus den Wörtern in der aktuellen Datei vorschlagen. Die Vervollständigung im Projekt-Modul ist viel leistungsfähiger.

Vervollständigung in Projekten

Ist CTags nicht installiert oder aktiviert, erhalten Sie einen Hinweis über diese Problem. Die CTags-Datei im Ordner `/tmp` wird automatisch beim Beenden von &kate; gelöscht, um unnötige Dateien loszuwerden.

### Schnellöffnen von Dateien

Da das Anklicken von Dateien in der Baumansicht nicht der schnellste Weg ist, um eine Datei zu öffnen, bietet &kate; einen eingebauten Mechanismus zum schnellen Öffnen, den Sie mit &Ctrl;&Alt;O aktivieren können. Dann wird die folgende Liste angezeigt:

Schnellöffner

Sie können die Einträge filtern, indem Sie Teile des gesuchten Dateinamens eingeben. Außerdem können Sie mit den Pfeiltasten navigieren und durch die Liste nach oben oder unten blättern. Durch Drücken von &Enter; wird die ausgewählte Datei aktiviert, während &Esc; das Fenster wieder ausblendet.

Das Modul merkt sich die vorher geöffnete Datei. Wechseln Sie also zu Schnellöffner-Ansicht, wird die vorher aktive Datei automatisch ausgewählt, so dass Sie nur noch die &Enter;taste zum Öffnen drücken müssen.

### Unterstützung für das Erstellen des Projekts

Außerdem wird das Erstellen-Modul unterstützt, so dass es automatisch richtig eingerichtet ist.

### Projekte erstellen

#### Projekte automatisch laden

Mit dem Projekt-Modul könne Dateien automatisch geladen werden, die Liste der Dateien wird aus dem Versionsverwaltungssystem gelesen. Dazu muss das automatische Laden für das entsprechende Versionsverwaltungssystem in den Einstellungen aktiviert werden. Dies ist die Voreinstellung.

Einstellungen für das Projektmodul

#### Projekte manuell erstellen

Sie müssen nur eine Datei `.kateproject` im Basisordner des Projekts zu erstellen. Die ist zum Beispiel der Inhalt der Datei `.kateproject` im Projekt Kate:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    }

Der Inhalt der Datei ist in &JSON;-Syntax geschrieben. Kate ist der Name des Projekts und die Dateien darin werden aus einem „&git;-Archiv gelesen.

Neben `git` werden auch Subversion (`svn`) und Mercurial (`hg`) unterstützt. Möchten sie die Dateien nicht aus einem Versionsverwaltungssystem lesen, können Sie auf folgende Weise angeben, welche Dateien rekursiv aus Ordnern gelesen werden sollen:

    {
      "name": "Kate"
    , "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
    }

In dieser Datei definieren Unterordner und Filter die Teile des Projekts. Sie können auch Versionsverwaltungssysteme und und durch Filter definierte Dateien mischen.

Wenn Sie Unterstützung für das Erstellen-Modul hinzufügen möchten, können Sie folgende Datei `.kateproject` verwenden:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    , "build": {
        "directory": "build"
      , "build": "make all"
      , "clean": "make clean"
      , "install": "make install"
      }
    }

Falls Sie eine Datei `.kateproject` haben, die Teil eines Versionskontrollsystem ist, Sie aber die Einrichtung für einen bestimmten Arbeitsbereich ändern müssen, können Sie diese Änderungen in einer eigenen Datei namens `.kateproject.local` speichern. Der Inhalt dieser Datei hat hat Vorrang vor der Datei `.kateproject`.

### Aktuelles Projekt

Mit &Alt;1 Projekte Gehe zu können Sie die Ansicht Aktuelles Projekt unten im Editorfenster mit vier Karteikarten öffnen:

Aktuelles Projekt

Terminalleiste

  Ein Terminalemulator im Basisordner des Projekts.

Quelltext-Index

  Mit der Eingabe von Zeichen in die Suchleiste wird die Suche gestartet und passende Namen von Funktionen, Klassen, Symbolen &etc; zusammen mit Typ, Dateinamen und Zeilennummer angezeigt.

  Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

Quelltext-Analyse

  Klicken Sie auf Analyse starten, um eine statische Quelltext-Analyse für die Sprachen C und C++ mit dem Programm `cppcheck` auszuführen und einen Bericht zu generieren. In den Bericht werden Dateiname, Zeilennummer, Schweregrad (Stil, Warnung &etc;) und das gefundene Problem eingefügt.

  Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

Notizen

  Der auf dieser Karteikarte eingegebene Text wird in der Datei `.kateproject.notes` gespeichert.

### Das Menü Projekte

Das Menü Projekte ermöglicht das Umschalten zwischen aktuell offenen Projekten. Es wird durch das Projektmodul angezeigt.

&Ctrl;&Alt;&Left; Projekte Zurück

  Wechselt zum vorherigen Projekt.

&Ctrl;&Alt;&Right; Projekte Nach vorn

  Wechselt zum nächsten Projekt.

&Alt;1 Projekte Gehe zu

  Öffnet die Ansicht Aktuelles Projekt unten im Editorfenster.

## Modul LSP-CLient

Das Modul LSP-Client bietet viele Sprachenfunktionen wie Quelltextvervollständigung, Navigation im Quelltext und Suche nach Referenzen auf der Basis des Language Server Protocol.

Wenn Sie den Eintrag LSP-Client auf der Modulseite aktiviert haben, wird eine neue Seite mit dem Namen LSP-Client im Einrichtungsdialog von &kate; angezeigt.

### Menüstruktur

Gegebenenfalls wird auch ein entsprechender LSP-Befehl in der Erläuterung erwähnt, dessen Dokumentation dann möglicherweise zusätzliche Hintergrundinformation und Interpretation liefern, die allerdings je nach der verwendeten Sprache variieren kann. Die Formulierung „aktuelles Symbol“ bezieht sich auf das Symbol an der der aktuellen Cursorposition, so wie es von der Sprach- und der Server-Implementierung festgelegt ist.

LSP-Client Zur Definition gehen

  [textDocument/definition] Geht zur Definition des aktuellen Symbols.

LSP-Client Zur Deklaration gehen

  [textDocument/declaration] Geht zur Deklaration des aktuellen Symbols.

LSP-Client Zur Typ-Definition gehen

  [textDocument/typeDefinition] Geht zur Definition des aktuellen Symbols.

LSP-Client Referenzen suchen

  [textDocument/references] Sucht Referenzen zum aktuellen Symbol.

LSP-Client Implementation suchen

  [textDocument/implementation] Sucht Implementationen des aktuellen Symbols.

LSP-CLient Hervorhebung

  [textDocument/documentHighlight] Aktuelle Symbolreferenzen im aktuellen Dokument hervorheben.

LSP-Client Beim Überfahren

  [textDocument/hover] Informationen für das aktuelle Symbol beim Überfahren.

LSP-CLient Formatieren

  [textDocument/formatting] [textDocument/rangeFormatting] Formatiert das aktuelle Dokument oder die aktuelle Auswahl.

LSP-CLient Umbenennen

  [textDocument/rename] Benennt das aktuelle Symbol um.

LSP-CLient Schnellkorrektur

  [textDocument/codeAction, workspace/executeCommand] Berechnet und wendet eine Schnellkorrektur für eine Fehlerdiagnose an der aktuellen Position oder Zeile an.

LSP-Client Ausgewählte Dokumentation zur Vervollständigung anzeigen

  Zeigt Dokumentation zu einem ausgewählten Eintrag in der Vervollständigungsliste.

LSP-CLient Signaturhilfe mit Autovervollständigung aktivieren

  Die Signaturhilfe wird in der Vervollständigungsliste angezeigt.

LSP-Client Deklaration in Referenzen einschließen

  Aufforderung, bei der Anforderung von Referenzen eine Deklaration des Symbols beizufügen.

LSP-Client Klammern bei Funktionsabschluss hinzufügen

  Fügt automatisch ein Klammerpaar nach Abschluss der Funktion hinzu.

LSP-Client Information beim Überfahren anzeigen

  Informationen beim Überfahren mit dem Mauszeiger anzeigen. Unabhängig von dieser Einstellung kann die Abfrage immer manuell ausgelöst werden.

LSP-CLient Formatieren bei der Eingabe

  [document/onTypeFormatting] Formatiert Teile des Dokuments bei der Eingabe von bestimmten Auslösezeichen. Dies könnte z.B. eine Einrückung bei einem Zeilenumbruch sein, oder wie anderweitig von LSP-Server festgelegt. Beachten Sie, dass Einrückungs-Skripte für den Editor möglicherweise das Gleiche versuchen, abhängig vom Modus.Es ist daher nicht ratsam, beide gleichzeitig zu aktivieren.

LSP-Client Inkrementeller Dokument-Abgleich

  Sendet partielle Änderungen am Dokument zur Aktualisierung des Servers anstelle des gesamten Dokumenttexts (falls unterstützt).

LSP-CLient Zielort hervorheben

  Bietet einen vorübergehenden visuellen Hinweis nach dem Ausführen eines Sprungs zu einem Ziel (einer Definition, Deklaration, usw.).

LSP-Client Benachrichtigungen zur Fehlerdiagnose anzeigen

  Verarbeiten und Anzeigen von Fehlerdiagnosemeldungen die vom Server gesendet werden.

LSP-Client Fehlerdiagnose hervorheben

  Hinzufügen von Texthervorhebungen für in der Fehlerdiagnose angezeigte Bereiche.

LSP-Client Markierungen für Fehlerdiagnose anzeigen

  Dokumentmarkierungen für in der Fehlerdiagnose angezeigte Zeilen hinzufügen.

LSP-Client Zum Unterfenster Fehlerdiagnose wechseln

  Wechselt zum Unterfenster Fehlerdiagnose in der Werkzeugansicht des Modules.

LSP-Client Alle Unterfenster außer Fehlerdiagnose schließen

  Schließt alle Unterfenster ohne Fehlerdiagnose &eg; Referenzen in der Werkzeugansicht des Moduls.

LSP-Client LSP-Server neu starten

  Startet den LSP-Server des aktuellen Dokuments erneut.

LSP-Client Alle LSP-Server neu starten

  Alle LSP-Server werden angehalten und dann bei Bedarf neu gestartet.

### Einstellungen

In der Einrichtungsseite des Moduls ist es möglich, einige der oben genannten Menüeinträge dauerhaft festzulegen. Es gibt jedoch einen zusätzlichen Eintrag, um die Einrichtungsdatei des Servers anzugeben. Dies ist eine &JSON;-Datei, in der der zu startende Server angegeben werden kann, mit dem dann über „stdin/stdout“ kommuniziert wird. Der Einfachheit halber ist die folgende Standardeinrichtung enthalten, die auf der Einrichtungsseite des Moduls eingesehen werden kann. Als Hilfestellung für die nachfolgenden Erläuterungen wird hier ein Auszug dieser Einstellung wiedergegeben:

    {
        "servers": {
            "bibtex": {
                "use": "latex",
                "highlightingModeRegex": "^BibTeX$"
            },
            "c": {
                "command": ["clangd", "-log=error", "--background-index"],
                "commandDebug": ["clangd", "-log=verbose", "--background-index"],
                "url": "https://clang.llvm.org/extra/clangd/",
                "highlightingModeRegex": "^(C|ANSI C89|Objective-C)$"
            },
            "cpp": {
                "use": "c",
                "highlightingModeRegex": "^(C\\+\\+|ISO C\\+\\+|Objective-C\\+\\+)$"
            },
            "d": {
                "command": ["dls", "--stdio"],
                "url": "https://github.com/d-language-server/dls",
                "highlightingModeRegex": "^D$"
            },
            "fortran": {
                "command": ["fortls"],
                "rootIndicationFileNames": [".fortls"],
                "url": "https://github.com/hansec/fortran-language-server",
                "highlightingModeRegex": "^Fortran.*$"
            },
            "javascript": {
                "command": ["typescript-language-server", "--stdio"],
                "rootIndicationFileNames": ["package.json", "package-lock.json"],
                "url": "https://github.com/theia-ide/typescript-language-server",
                "highlightingModeRegex": "^JavaScript.*$",
                "documentLanguageId": false
            },
            "latex": {
                "command": ["texlab"],
                "url": "https://texlab.netlify.com/",
                "highlightingModeRegex": "^LaTeX$"
            },
            "go": {
                "command": ["go-langserver"],
                "commandDebug": ["go-langserver", "-trace"],
                "url": "https://github.com/sourcegraph/go-langserver",
                "highlightingModeRegex": "^Go$"
            },
            "python": {
                "command": ["python3", "-m", "pyls", "--check-parent-process"],
                "url": "https://github.com/palantir/python-language-server",
                "highlightingModeRegex": "^Python$"
            },
            "rust": {
                "command": ["rls"],
                "path": ["%{ENV:HOME}/.cargo/bin", "%{ENV:USERPROFILE}/.cargo/bin"],
                "rootIndicationFileNames": ["Cargo.lock", "Cargo.toml"],
                "url": "https://github.com/rust-lang/rls",
                "highlightingModeRegex": "^Rust$"
            },
            "ocaml": {
                "command": ["ocamlmerlin-lsp"],
                "url": "https://github.com/ocaml/merlin",
                "highlightingModeRegex": "^Objective Caml.*$"
            }
        }
    }

Beachten Sie, dass jedes „command“ ein Feld oder eine Zeichenfolge sein kann, in diesem Fall wird er in ein Feld aufgeteilt. Auch ein Eintrag „global“ der obersten Ebene neben „server“ wird ebenfalls berücksichtigt, siehe weiter unten. Die angegebene Programmdatei wird auf die übliche Weise gesucht, z. B. mit der Umgebungsvariablen `PATH`. Wenn die Programmdatei an einem benutzerdefinierten Ort installiert ist, dann muss `PATH` eventuell erweitert werden. Oder alternativ kann eine (symbolische) Verknüpfung oder ein Skript an einem Ort verwendet werden, der innerhalb des normalen `PATH` liegt. Wie oben dargestellt, kann man auch einen „Pfad“ angeben, der nach den Standard-Speicherorten durchsucht wird.

Alle Einträge in „"command“, „root“ und „path„ können als Variablen erweitern werden.

„highlightingModeRegex“ wird verwendet, um den Hervorhebungsmodus von &kate; auf die Sprachkennung des Servers zu übertragen. Wenn kein regulärer Ausdruck angegeben wird, wird die Sprachkennung selbst verwendet. Wenn ein Eintrag „documentLanguageId“auf „false“ gesetzt ist, dann wird dem Server beim Öffnen des Dokuments keine Sprachkennung angegeben. Dies kann bei einigen Servern, die den Dokumententyp genauer bestimmen als der Grundlage eines Kate-Modus, zu besseren Ergebnissen führen.

Aus dem obigen Beispiel ist das Wesentliche vermutlich ersichtlich. Darüber hinaus kann jedes Server-Eintragsobjekt auch einen „initializationOptions“-Eintrag haben, der als Teil der Methode „initialize“ an den Server weitergegeben wird. Wenn vorhanden, wird ein Eintrag „settings“ an den Server mit der Benachrichtigung „workspace/didChangeConfiguration“ an den Server übergeben.

Es werden verschiedene Stufen von Überschreiben/Zusammenführen angewendet,

- Benutzereinstellungen, aus einer Datei geladen, überschreiben interne Standard-Einstellungen

- Der Eintrag „lspclient“ der Projekteinstellungen in `.kateproject` überschreibt die oben genannten Einstellungen

- Der resultierende „globale“ Eintrag wird zum Ergänzen, nicht zum Überschreiben eines beliebigen Server-Eintrags verwendet

Je Kombination (root, servertype) wird eine Serverinstanz verwendet. Wenn „root“ als absoluter Pfad angegeben ist, dann wird er so verwendet, ansonsten ist der Pfad relativ zur projectBase wie beim Projekt-Modul oder sonst relativ zum Dokumentordner. Wenn nichts angegeben und „rootIndicationFileNames“ ein Feld ist als Dateinamen, dann wird ein übergeordneter Ordner des aktuellen Dokuments, der eine solche Datei enthält, ausgewählt. Als letzter Ausweichfall wird der Persönliche Ordner als „root“ ausgewählt. Für jedes Dokument bestimmt das resultierende „root“ dann, ob eine eigene Instanz benötigt wird. Wenn ja, wird „root“ als rootUri/rootPath übergeben.

Im Allgemeinen wird empfohlen, “root“ nicht anzugeben, da es für einen für einen Server nicht so wichtig ist, dies kann jedoch von Fall zu Fall unterschiedlich sein. Weniger Server-Instanzen sind natürlich effizienter, und sie haben auch eine "breitere" Sicht als die Ansicht von vielen einzelnen Instanzen.

#### Einrichtung des LSP-Servers

Jeder einzelne LSP-Server hat seine eigene Einstellungen und verwendet möglicherweise Sprach-/Dienst-spezifische Mittel zur Einrichtung, &eg; `tox.ini` (u.a. für Python), `.clang-format` für das Format C++.Eine solche Einrichtung kann dann auch von anderen (nicht-LSP) Diensten verwendet werden, wie tox oder clang-format. Darüber hinaus laden einige LSP-Server auch Einstellungen aus benutzerdefinierten Dateien, &eg; `.ccls`. Außerdem kann die benutzerdefinierte Servereinrichtung auch über das LSP-Protokoll übergeben werden. Siehe auch die oben erwähnten Einträge „initializationOptions“ und „settings“ in der Servereinrichtung.

Da verschiedene Stufen des Überschreibens/Zusammenfassens angewandt werden, wird im folgenden Beispiel die benutzerdefinierte Einstellung einiger Language-Server-Einstellungen für Python gezeigt

    {
        "servers": {
            "python": {
                "settings": {
                    "pyls": {
                        "plugins": {
                            "pylint": {
                                "enable": true
                            }
                        }
                    }
                }
            }
        }
    }

Leider ist die Einrichtung/Anpassung des LSP-Servers oft nicht gut dokumentiert, so dass nur ein Blick in den Quelltext die Einstellungen und die verfügbaren Optionen zeigt. Besonders unterstütztder Server des obigen Beispiels viel mehr Optionen in „Einstellungen“. Lesen Sie die Dokumentation eines anderen LSP-Clients mit Beispielen und entsprechende Einstellungen für verschiedene andere Sprachserver, die einfach und leicht in die hier verwendete und oben beschriebene &JSON;-Einrichtung umgewandelt werden kann.

#### Probleme mit dem LSP-Servers

Manchmal können wegen einer fehlerhaften Einrichtung oder wegen Fehlern auf dem Server selbst Probleme auftreten. Auf der Karteikarte „Ausgabe“ in &kate; werden dann mehrere Versuche zum Starten des Servers protokolliert. Diese Protokolle enthalten jedoch nur Meldungen auf einer höheren Ebene, keine detaillierten Fehlerdiagnose des Prozesses auf dem LSP-Server.

Der übliche Weg zur Fehlersuche besteht darin, dem Startbefehl des Sprachservers ein oder mehrere Flags hinzuzufügen, die eine zusätzliche Protokollierung (in eine Datei oder in die Standardfehlerausgabe ermöglichen, sofern dies nicht als Voreinstellung der Fall ist. Wenn dann &kate; auf der Befehlszeile gestartet wird, erhalten Sie mehr Informationen über die Fehlerursache.

Es kann auch aufschlussreich sein, den Protokollaustausch zwischen dem &kate;'s LSP-Client und dem LSP-Server zu untersuchen. Auch hier hat letzterer normalerweise Möglichkeiten, dies zu verfolgen. Der LSP-Client hat auch eine zusätzliche Fehlerverfolgung mit Ausgabe nach stderr), wenn &kate; mit `QT_LOGGING_RULES=katelspclientplugin=true` aufgerufen wird.

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

## Suchen & Ersetzen

### Einleitung

Mit &kate;'s Modul „Suchen & Ersetzen“ 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 oder im aktiven Dokument 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.

  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.

  Mit dem Knopf 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.

Suchen

  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.

Ersetzen (Textfeld)

  Text, der anstelle des Textes im Eingabefeld Suchen in die geöffneten Dokumente eingefügt wird.

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.

Ersetzen

  Haben Sie alle Einstellungen richtig vorgenommen, dann drücken Sie zum Start auf den Knopf Ersetzen, um den Text im Eingabefeld Suchen mit dem Text im Eingabefeld Ersetzen zu ersetzen. Sie können auch die Taste &Enter; im Eingabefeld Ersetzen drücken.

Weiter

  Geht zur nächsten Fundstelle der Suche. Wenn nötig, wird zum nächsten Dokument umgeschaltet.

Markierte ersetzen

  Macht dasselbe wie Ersetzen, aber nur in den Dokumenten, die unten markiert sind.

#### 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 zur Anzeige der zusätzlichen Einstellungen.

Suchen in

  In diesem Auswahlfeld gibt es drei Einstellungen. Wählen Sie In geöffneten Dateien, um in allen gerade in &kate; geöffneten Dateien oder In Ordner, um in einem Ordner und dessen Unterordnern zu suchen. Wählen Sie In der aktuellen Datei, um nur in dieser Datei zu suchen.

  Wenn das Modul Projekte geladen ist, können Sie auch im Aktuellen Projekt oder in Allen geöffneten Projekten suchen.

Groß-/Kleinschreibung beachten

  Beschränkt Sie die Suche auf Ausdrücke, die mit der gleichen Groß- und Kleinschreibung wie im Suchfeld auch in den Dateien vorhanden sind.

Reguläre Ausdrücke

  Erlaubt die Verwendung eines Regulären Ausdrucks anstatt eines einfachen Textes für die Suche.

Ergebnisse erweitern

  Zeigt alle Suchergebnisse in jedem Dokument an, nicht nur eine Liste der Dokumente, in denen die Suche erfolgreich war.

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. Diese Option steht nur dann zur Verfügung, wenn der Modus in Ordner benutzt wird.

Dateiauswahl-Dialog

  Drücken Sie diesen Knopf, um den Ordner im Dateiauswahldialog zu öffnen. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

  Drücken Sie diesen Knopf, um in den übergeordneten Ordner des aktuellen Ordners zu wechseln. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

  Mit diesem Knopf setzen Sie den Eintrag für den Ordner auf den Ordner, in der die gerade geöffnete Datei gespeichert ist. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

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. Diese Option steht nicht zur Verfügung, wenn der Modus Offene Dateien benutzt wird.

Ausschließen

  Diese Option ermöglicht, Dateien von der Suche auszuschließen. Wie im Filter können Sie mehrere Namensmuster, durch ein Komma getrennt, eingeben (`,`). Diese Option steht nicht zur Verfügung, wenn der Modus Offene Dateien benutzt wird.

Rekursiv

  Ist diese Einstellung aktiviert, sucht &kate; auch in allen Unterordnern des ausgewählten Ordners. Diese Option ist nur verfügbar, wenn der Modus Ordner benutzt wird.

Versteckte Dateien einbeziehen

  Ist diese Einstellung aktiviert, sucht &kate; auch in Dateien und Ordner, die normalerweise durch das &OS; versteckt werden. Diese Option steht nur zur Verfügung, wenn der Modus Ordner benutzt wird.

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. Diese Option steht nur zur Verfügung, wenn der Modus Ordner benutzt wird.

  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 &kate; bei aktivierter Einstellung diesen Verknüpfungen und durchsucht die Ordner. Dann wird die Suche niemals abgeschlossen.

Einschließlich Binärdateien

  Ist diese Einstellung aktiviert, sucht &kate; auch in Dateien, die keine Textdateien zu sein scheinen.

#### 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 , um die Suchergebnisse anzuzeigen. Diese Ergebnisse werden auch automatisch angezeigt, wenn die Suche beendet ist.

Das Suchergebnis ist eine Liste der Dateien, die Text enthalten, der gesucht wurde. Zu jeder Datei wird die Anzahl der Fundstellen angegeben.

Wenn Sie eine Liste der Fundstellen in der Datei sehen wollen, klicken Sie einfach auf den Pfeil links vom Dateinamen. Wenn Sie die Option Ergebnisse erweitern eingeschaltet hatten, wird die Liste sofort ausführlich angezeigt. Die Zeilennummer jeder Fundstelle wird angezeigt, danach sehen Sie den Inhalt der Zeile mit dem Suchtext hervorgehoben.

Um eine Datei mit gefundenen Treffern der Suche zu öffnen, klicken Sie zweimal drauf. &kate; öffnet die Datei, falls erforderlich, und setzt den Cursor an den Anfang des gefundenen Suchtexts. Sie können auch sofort an eine bestimmte Fundstelle springen, indem Sie auf diese Fundstelle in der Liste doppelklicken.

### Menüstruktur

&Ctrl;&Alt;F Bearbeiten In Dateien suchen

  Öffnet das Werkzeug Suchen und Ersetzen

Bearbeiten Zum nächsten Treffer springen

  Springt zur nächsten Fundstelle.

Bearbeiten Zum vorherigen Treffer springen ...

  Springt zur vorherigen Fundstelle.

Ansicht Werkzeugansichten Suchen und Ersetzen anzeigen

  Schaltet die Anzeige des Werkzeugs Suchen und Ersetzen ein und aus

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

## &kate;-Textbausteine

### Einleitung

&kate;-Textbausteine ist ein 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 &javascript;.

### Menüstruktur

Ansicht Werkzeugansichten Textbausteine anzeigen

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

Extras Textbaustein erstellen

  Erstellt einen neuen Textbaustein, der als wieder verwendbarer Text in jeden Bereich von beliebigen Dokumenten eingefügt werden kann.

### Textbaustein-Seitenleiste

Textbaustein-Seitenleiste für &kate;
Die Textbaustein-Seitenleiste für &kate;.

Die Seitenleiste für &kate;-Textbausteine.

In der Seitenleiste 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.

#### Textbausteinarchive erstellen und bearbeiten

Um ein neues Textbausteinarchiv anzulegen, drücken Sie auf Archiv hinzufügen. 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 OK.

Textbaustein-Editor
Der Archiv-Editor.

Die Benutzerschnittstelle des Archiv-Editors.

Der Editor für Textbausteinarchive enthält die folgenden Einstellmöglichkeiten:

Name

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

Namensraum

  Präfix, das für die Quelltextvervollständigung verwendet wird.

Lizenz

  Wählen Sie die Lizenz für Ihr Textbausteinarchiv.

Autoren

  Geben Sie hier den Namen der Autoren der Textbausteindatei ein.

Dateitypen

  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 benutzt. Sie können den Typ zum Beispiel auf `C++` ändern oder aus einer Liste von Dateitypen auswählen, Benutzen Sie die &Shift;-taste, um mehrere Dateitypen hinzuzufügen.

#### Textbausteine erstellen und bearbeiten

Textbaustein-Editor
Der Textbaustein-Editor.

Die Benutzerschnittstelle des Textbaustein-Editors.

Name

  Der Name wird in der Vervollständigungsliste angezeigt.

Kurzbefehl

  Drücken Sie diesen Kurzbefehl, um den Textbaustein in das Dokument einzufügen.

Textbausteine

  Der Text, der mit Ihrem Textbaustein in das Dokument eingefügt wird.

  Ein Textbaustein kann editierbare Felder enthalten. Zwischen diesen Feldern können Sie mit der &Tab;taste wechseln. Folgende Ausdrücke können in Vorlagentexten benutzt werden, um Felder zu erstellen:

  Mit `${field_name}` erstellen Sie ein einfaches Feld, dessen Wert editiert werden kann. Alle weiteren Vorkommen desgleichen field_name sind Felder, die den Wert des ersten Felds beim Editieren erhalten.

  Mit `${field_name=default}` können Sie einen Standardwert für ein Feld angeben. Als Standardwert default kann ein beliebiger &javascript;-Ausdruck verwendet werden.

  Mit `${field_name=text}` können Sie einen Text als Vorgabewert angeben.

  Mit `${func(other_field1, other_field2, ...)}` können Sie ein Feld erstellen, das eine &javascript;-Funktion bei jeder Bearbeitung evaluiert und den Wert des Felds enthält. Auf der Karteikarte Skripte finden Sie weitere Informationen.

  Mit `${cursor}` können Sie die Endposition des Cursors angeben, nachdem alle Felder ausgefüllt wurden.

Skripte

  &javascript;-Hilfsfunktionen, die Sie in Ihren Textbausteinen verwenden können.

  Alle &javascript;-Funktionen sollten den Inhalt für ein Vorlagenfeld als Zeichenfolge zurückgeben.

  Funktionen werden in einem Gültigkeitsbereich aufgerufen, der den Inhalt aller editierbaren Vorlagenfelder als lokale Variablen enthält. Gibt es zum Beispiel in einem Textbaustein `${Feld}`, dann gibt es eine Variable mit dem Namen `field`, die den aktuellen Wert des Vorlagenfelds enthält.Diese Variablen können entweder statisch in der Funktion verwendet oder als Argument übergeben werden, indem Sie `.${func(field)}` oder `${field2=func(field)}` in der Zeichenfolge des Textbausteins verwenden.

  Mit der Programmierschnittstelle (Skript-API) von &kate; haben Sie Zugriff auf ausgewählten Text, den gesamten Text, den Dateinamen und weitere Informationen mit den zugehörigen Methoden der Objekte `document` und `view`. Weitere Informationen finden Sie in der Programmierschnittstelle von &kate;.

### 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; &Space;, dann wird eine Liste aller Textbausteine in einem Auswahlfeld angezeigt. 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.

Ö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 ein und drücken Sie den Knopf Abfrage ausführen in der Werkzeugleiste oder benutzen Sie aus dem Menü SQL Abfrage ausführen (&Ctrl;E).

##### 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 &kate; angezeigt. Fehlermeldungen erscheinen ebenfalls in der Textausgabe.

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

    SELECT * FROM table_name

In der Ansicht SQL-Datenausgabe gibt es mehrere 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 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.

## Symbolansicht-Modul

### Das Modul zum bedingten Schließen benutzen

Dies Modul zeigt Symbole wie Funktionen, Makros und Strukturen im Quelltext an.

Durch Klicken auf die eingelesenen Informationen können Sie direkt den Quelltext durchsehen.

Zur Zeit werden folgende Sprachen unterstützt:

C/C++, &Java;, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Funktionsliste:

- Listen-/Baummodus
- Sortierung ein- bzw. ausschalten
- Funktionsparameter anzeigen bzw. ausblenden
- Baumansicht ein- bzw. ausklappen
- Automatische Aktualisierung bei Änderungen des Dokuments
- Da Einlesen basiert auf der Bibliothek Syntax-Highlighting der &kde-frameworks;

### Menüstruktur

&Ctrl;\ Ansicht Werkzeugansichten Symbolliste anzeigen

  Schaltet die Symbolliste mit der Anzeige von Funktionen, Makros und Strukturen des Quelltexts im aktiven Dokument ein oder aus.

### Einstellungen

Symbolansicht

Auswahl der Standardeinstellungen zum Einlesen

## Werkzeugansicht für Terminal - Werkzeugansicht, die ein Terminal-Element einbettet

Der eingebaute Terminal-Emulator ist eine Kopie der &kde;-Anwendung &konsole;, er ist durch Wählen von Ansicht Werkzeugansichten Terminalleiste anzeigen aufrufbar und bekommt beim Einschalten den Fokus. Wenn die Option Automatisch Terminal mit aktuellem Dokument abgleichen eingeschaltet ist, wird das Verzeichnis des Terminal-Emulators in das Herkunftsverzeichnis der aktuellen Datei umgeschaltet, wenn dies möglich ist.

Die Standardposition ist unten im &kate;-Fenster, unterhalb des Editorfensters.

Sie können die Einstellungen des Terminal-Emulators durch das mit der rechten Maustaste aufrufbare Kontextmenü erreichen, lesen Sie dazu das Handbuch zu &konsole; für weitere Informationen.

Der eingebaute Terminal-Emulator wird vom Terminal-Modul bereit gestellt.

### Menüstruktur

Ansicht Werkzeugansichten Terminalleiste anzeigen

  Schaltet die Anzeige des eingebauten Terminal-Emulators ein und aus.

  Wenn dieser zum ersten Mal aktiviert wird, dann wird ein neuer Terminal-Emulator erzeugt.

  Wenn der Terminal-Emulator gestartet wird, erhält bekommt er den Fokus, damit Sie sofort mit dem Eingeben von Befehlen beginnen können. Wenn die Option Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (wenn möglich) auf der Seite Terminal des Enrichtungsdialogs eingeschaltet ist, wird der Pfad des Terminal-Emulators auf den Pfad des aktiven Dokuments gesetzt, wenn es sich um ein lokales Dokument handelt.

Extras An Terminal weitergeben

  Gibt den aktuell markierten Text an den eingebauten Terminalemulator. An das Ende des Textes wird kein Zeilenendezeichen angehängt.

Extras Terminal mit aktuellem Dokument abgleichen

  Diese Option bewirkt, dass der eingebaute Terminal-Emulator mit `cd` zum Ordner des aktuellen Dokuments wechselt,

  Alternativ können Sie &kate; so einstellen, dass das Terminal immer in den Ordner des aktuellen Dokuments wechselt. Weitere Informationen finden Sie unter .

Extras Terminalleiste aktivieren/deaktivieren

  Schaltet den Fokus vom aktuellen Dokument zum Terminal und zurück.

### Einstellungen

Die Einstellungen für den Terminal-Emulator auf der Seite Terminal des Einstellungsdialoges vornehmen.

Die folgenden Einstellungen können ausgewählt werden:

Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (sofern möglich)

  Diese Option bewirkt, dass der eingebaute Terminal-Emulator immer mit `cd` zum Verzeichnis des aktuellen Dokuments wechselt, wenn ein neues Dokument geöffnet wird oder zu einem anderen Dokument umgeschaltet wird. Wenn ausgeschaltet, müssen Sie alle Wechsel selbst vornehmen.

Die EDITOR-Umgebungsvariable auf „kate -b“ einstellen

  Dies setzt die `EDITOR`-Umgebungsvariable, so dass Programme im eingebauten Terminal, die automatisch eine Datei in einem Editor öffnen, dafür &kate; anstatt des in der Shell definierten Editors verwenden. Sie können das Terminal erst dann weiter benutzen, wenn Sie die in &kate; geöffnete Datei schließen. Bis dahin wartet das aufrufende Programm auf das Ende der Dateibearbeitung.

&konsole; durch Tastendruck Esc ausblenden

  Mit dieser Einstellung kann das eingebaute Terminal mit der Taste &Esc; geschlossen werden. Dies kann bei Terminalprogrammen, die wie &eg; vim die Taste &Esc; verwenden, zu Problemen führen. Tragen Sie diese Programme als durch Kommata getrennte Liste in das Eingabefeld unten ein.

## Textfilter-Modul

### Das Textfilter-Modul benutzen

Mit diesem Modul können Sie ausgewählten Text mit Shell-Befehle bearbeiten. Als Argument für den Befehl wird eine Textauswahl verwendet. Die Ausgabe des Befehls ersetzt entweder die Auswahl oder wird in die Zwischenablage kopiert, abhängig von den Benutzereinstellungen.

#### Beispiele:

- `less /etc/fstab` - Fügt den Inhalt dieser Datei in das Dokument ein oder kopiert es in die Zwischenablage

- `wc` - Zählt Zeilen, Wörter und Zeichen in der Auswahl und fügt dies ins Dokument ein oder kopiert es in die Zwischenablage

- `sort` - Sortiert die Zeilen in der Auswahl und fügt das Ergebnis ins Dokument ein oder kopiert es in die Zwischenablage

### Menüstruktur

&Ctrl;\ Extras Text filtern

  Öffnet den Textfilter-Dialog:

  Textfilter-Dialog

  Geben Sie den Shell-Befehl im Kombinationsfeld ein oder wählen Sie einen Befahl aus dem Verlauf.

  Kopiert das Ergebnis anstatt es einzufügen

    Kopiert das Ergebnis in die Zwischenablage und lässt das Dokument unverändert.

  STDOUT und STDERR zusammenführen

    Ist dies aktiviert, werden die Ausgaben von STDOUT und STDERR zusammengeführt und keine Fehler gemeldet. Ansonsten wird die Ausgabe auf STDERR in einem passiven Nachrichtenfenster angezeigt.

&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 dieses Modul nicht.

Um dieses Modul zu laden, öffnen Sie den Einrichtungsdialog von &kate; mit Einstellungen &kate; einrichten .... Wählen Sie dann &XML;-Überprüfung im Abschnitt Programm / Module 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 `katexmltools/` in ``qtpaths` `--paths GenericDataLocation`` , der auch der 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 Module. 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.

Jetzt können Sie das Modul 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 Cursor). 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 Entitäten anzeigen.

### Funktionen und Einschränkungen

Sie können alle Funktionen und Einschränkungen testen, indem Sie die Datei `katexmltools/testcases.xml` in ``qtpaths` `--paths GenericDataLocation`` in &kate; laden und den Anweisungen folgen.

### Menüstruktur

&Ctrl;&Enter; &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;