<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
> <firstname
>Thomas</firstname
> <surname
>Diehl</surname
> <affiliation
> <address
><email
>thd@kde.org</email
></address
> </affiliation
> <contrib
>GUI-Übersetzung</contrib
></othercredit
> <othercredit role="translator"
> <firstname
>Matthias</firstname
><surname
>Schulz</surname
> <affiliation
> <address
><email
>matthias.schulz@kdemail.net</email
></address
> </affiliation
> <contrib
>Deutsche Übersetzung</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Arbeiten mit Erweiterungen</title>

<para
>Es gibt einige Typen von Erweiterungen für &kate;. Da sind Erweiterungen für die Editorkomponente von &kate;, die dann in allen Anwendungen, die die Editorkomponente verwenden, benutzt werden können. Das sind zum Beispiel KDevelop, Quanta, Kile, &kwrite;, aber auch noch einige andere. Außerdem gibt es Erweiterungen, die nur im Editor von &kate; selbst verwendet werden können, diese können in nativem C++ oder in Python geschrieben sein. Zwischen diesen gibt es Unterschiede, die anschließend beschrieben werden.</para>

<para
>Im <link linkend="configuring-kate-configdialog"
>Einrichtungsdialog</link
> können Sie beide Arten von Erweiterungen auswählen. Hier finden Sie auch die Einstellungen für einzelne Erweiterungen, bei denen das nötig ist.</para>

<para
>Es gibt viele Erweiterungen für unterschiedliche Anwendungsbereiche. Einige Erweiterungen wie zum Beispiel automatisches Einfügen von Klammern, Einfügen von Dateien und Textexport als &HTML; sind in der Editorkomponente enthalten. Im Internet finden Sie aber noch weitere Erweiterungen.</para>
&plugins-part-sections; <sect1 id="scripts">
<title
>Skripte</title>

<variablelist>

<varlistentry id="scripts-emmet">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guimenuitem
>Emmet</guimenuitem
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-emmet-expand-abbreviation">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Abkürzung ausschreiben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Wandelt den ausgewählten Text in ein Paar von öffnenden und schließenden &HTML;- oder &XML;-Tags um. Ist zum Beispiel <userinput
>div</userinput
> ausgewählt, wird es durch <computeroutput
>&lt;div&gt;&lt;/div&gt;</computeroutput
> ersetzt. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-wrap-with-tag">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Umbruch mit Tag</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Bricht den ausgewählten Text mit dem auf der <link linkend="dev-scripting-command-line"
>Befehlszeile</link
> angegebenen Tag um. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-select-tag-inwards">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Inhalte von &HTML;/&XML;-Tag innerhalb wählen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Befindet sich der Cursor innerhalb eines Paares von &HTML;- / XML-Tags, ändert diese Aktion die Auswahl zum Inhalt der &HTML;- / &XML;-Tags ohne die Tags selbst. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-select-tag-outwards">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Inhalte von &HTML;/&XML;-Tag außerhalb wählen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Befindet sich der Cursor innerhalb eines Paares von &HTML;- / &XML;-Tags, ändert diese Aktion die Auswahl zum Inhalt der &HTML;- / &XML;-Tags einschließlich der Tags selbst. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-move-cursor-to-matching-tag">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Cursor zum passenden Tag verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Befindet sich der Cursor innerhalb eines öffnenden &HTML;- / &XML;-Tags, verschiebt diese Aktion ihn zum schließenden Tag. Befindet sich der Cursor innerhalb eines schließenden &HTML;- / &XML;-Tags, verschiebt diese Aktion ihn stattdessen zum öffnenden Tag. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-toggle-comment">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Kommentar ein-/ausschalten</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ist die Auswahl kein Kommentar, wird diese Aktion die Auswahl in &HTML;- / &XML;-Kommentaren einschließen, &eg; <computeroutput
>&lt;!-- markierter Text --&gt;</computeroutput
>). Handelt es sich bei der Auswahl um einen Kommentar, werden die Tags stattdessen entfernt. </para
></listitem>
</varlistentry>

<!--FIXME: (Go to|Select next) (previous|next) edit point -->

<varlistentry id="scripts-emmet-toggle-delete-tag">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Tag unter Cursor löschen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Befindet sich der Cursor gerade innerhalb eines &HTML;- / &XML;-Tags, löscht diese Aktion das gesamte Tag. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-1">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 1 verringern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion subtrahiert 1 vom aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>5</userinput
> ausgewählt ist, wird dies zu <computeroutput
>4</computeroutput
> geändert. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-10">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 10 verringern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion subtrahiert 10 vom aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>15</userinput
> ausgewählt ist, wird dies zu <computeroutput
>5</computeroutput
> geändert. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-0_1">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 0.1 verringern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion subtrahiert 0.1 vom aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>4.5</userinput
> ausgewählt ist, wird dies zu <computeroutput
>4.4</computeroutput
> geändert. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-1">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 1 vergrößern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion addiert 1 zum aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>5</userinput
> ausgewählt ist, wird dies zu <computeroutput
>6</computeroutput
> geändert. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-10">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 10 vergrößern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion addiert 10 zum aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>5</userinput
> ausgewählt ist, wird dies zu <computeroutput
>15</computeroutput
> geändert. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-0_1">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Zahl um 0.1 vergrößern</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Diese Aktion addiert 0.1 zum aktuell ausgewählten Text, sofern es sich dabei um eine Zahl handelt. Wenn zum Beispiel <userinput
>4.5</userinput
> ausgewählt ist, wird dies zu <computeroutput
>4.6</computeroutput
> geändert. </para
></listitem>
</varlistentry>

</variablelist
></listitem>
</varlistentry>

<varlistentry id="scripts-navigation">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Navigation</guisubmenu
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-navigation-previous-indent">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Pfeil runter</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Navigation</guisubmenu
> <guimenuitem
>Cursor zur vorherigen passenden Einrückung verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt den Cursor zur ersten Zeile oberhalb der aktuellen Cursor-Position, die die gleiche Einrückungstiefe wie die aktuelle Zeile hat. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-navigation-next-indent">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Pfeil runter</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Navigation</guisubmenu
> <guimenuitem
>Cursor zur nächsten passenden Einrückung verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt den Cursor zur nächsten Zeile unterhalb der aktuellen Cursor-Position, die die gleiche Einrückungstiefe wie die aktuelle Zeile hat. </para
></listitem>
</varlistentry>

</variablelist>
</listitem
></varlistentry>

<!--FIXME: Quick Coding -> Expand Abbreviation (CTRL+ALT+#) -->

<varlistentry id="scripts-editing">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guimenuitem
>Bearbeitung</guimenuitem
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-editing-sort">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Markierten Text sortieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Sortiert den ausgewählten Text oder das gesamte Dokument in aufsteigender Reihenfolge. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-move-down">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Pfeil runter</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
><guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Zeilen nach unten verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt die markierten Zeilen nach unten. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-move-up">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Pfeil hoch</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Zeilen nach oben verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt die markierten Zeilen nach oben. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-dupe-down">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil runter</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Markierte Zeilen nach unten kopieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kopiert die markierten Zeilen nach unten. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-dupe-up">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil hoch</keysym
></keycombo
></shortcut
> <guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Markierte Zeilen nach oben kopieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kopiert die markierten Zeilen nach oben. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-uri-encode">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Markierten Text als URI kodieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kodiert den ausgewählten Text, so dass dieser als Teil einer Abfrage in einer &URL; benutzt werden kann. Der Text ersetzt dabei die Auswahl in der &URL;. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-uri-decode">
<term
><menuchoice
><guimenu
>Extras</guimenu
><guisubmenu
>Skripte</guisubmenu
> <guisubmenu
>Bearbeitung</guisubmenu
> <guimenuitem
>Markierten Text als URI dekodieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Wenn ein Teil einer Abfrage in einer &URL; ausgewählt wird, dann wird diese Funktion die Auswahl durch den originalen Text ersetzen. </para
></listitem>
</varlistentry>

</variablelist
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="kate-application-plugins">
<title
>&kate;-Programmerweiterungen</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>&kate;-Programmerweiterungen enthalten zusätzliche Funktionen für den Editor &kate;. Diese Erweiterungen können zusätzliche Menüs und Kurzbefehle einfügen und erweitern die Fähigkeiten von &kate;. Sie können eine beliebige Anzahl von Erweiterungen in einem geöffneten &kate;- Programm installieren. Öffnen Sie den Einrichtungsdialog für &kate; mit <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>&kate; einrichten ...</guimenuitem
></menuchoice
> und wählen Sie unter <menuchoice
><guimenu
>Programm</guimenu
><guimenuitem
>Erweiterungen</guimenuitem
></menuchoice
> die gewünschten Erweiterungen aus. </para>

<para
>Folgende Programmerweiterungen sind verfügbar: </para>
<itemizedlist>
<listitem>
<para
>Backtrace-Browser - Ansicht zur Navigation in Backtraces</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-build"
>Erstellen-Modul</link
> - Kompilieren oder Make aufrufen und Fehlermeldungen ausgeben</para>
</listitem>
<listitem>
<para
>Bedingtes Schließen - Eine Gruppe von Dokumenten auf der Basis eines gemeinsamen Pfades oder einer Dateierweiterung schließen</para>
</listitem>
<listitem>
<para
>CTags - Definition/Deklaration mit CTags nachschauen</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Dateisystem-Browser</link
> - Werkzeugansicht für Dateisystem-Browser</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Dateivorlagen</link
> - Erstellt neue Dateien aus Vorlagen</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-gdb"
>&gdb;</link
> - Stellt eine einfache &gdb;-Oberfläche zur Verfügung.</para>
</listitem>
<listitem>
<para
>Jovie-Sprachausgabe - Fügt einen Menüeintrag zum Vorlesen des Textes hinzu</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-mail"
>E-Mail-Versand</link
> - Dateien per E-Mail versenden</para>
</listitem>
<listitem>
<para
>Mehrzeilige Unterfensterleiste - Fügt dem Hauptfenster von &kate; eine mehrzeilige Unterfensterleiste hinzu</para>
</listitem>
<listitem>
<para
>Header öffnen - Öffnet die zusammengehörigen .h/[.cpp|.c]-Dateien</para>
</listitem>
<listitem>
<para
>Projekterweiterung - Ein Projektmodul für Kate</para>
</listitem>
<listitem>
<para
>Python-Erweiterungen - &pate;-Verwaltung von Python-Modulen</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-searchinfiles"
>Suchen und Ersetzen</link
> - Werkzeugansicht, die es erlaubt, alle geöffneten Dateien oder Dateien im Dateisystem zu durchsuchen</para>
</listitem>
<listitem>
<para
>Werkzeugansicht für Textbausteine - Werkzeugansicht für die einbettete Verwaltung von Textbausteinen</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-sql"
>SQL-Erweiterung</link
> - Anfragen an SQL-Datenbanken ausführen</para>
</listitem>
<listitem>
<para
>Symbolbetrachter - Referenzsymbole aus Quelldateien extrahieren und anzeigen</para>
</listitem>
<listitem>
<para
>Unterfensterleiste - Fügt dem Hauptfenster von &kate; eine normale Unterfensterleiste hinzu</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
<listitem>
<para
>Werkzeugansicht für Terminal - Werkzeugansicht, die ein Terminal-Element einbettet</para>
</listitem>
<listitem>
<para
>Textfilter - Einfacher Textfilter</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>&XML;-Vervollständigung</link
> - Zeigt &XML;-Elemente, Attribute, Attributwerte und Entitäten an, die von der DTD definiert werden</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>&XML;-Überprüfung</link
> - Überprüft &XML;-Dateien mit xmllint</para>
</listitem>

<!-- not in 4.10
<listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<!--<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>External Tools</link
></para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-snippets"
>Kate Snippets</link
> - Snippets plugin with code completion support</para>
</listitem>
<para
>Tabify - Adds a tab bar to Kate's main window</para>
http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/
</listitem>
-->
</itemizedlist>
</sect1>

<sect1 id="pate">
<title
>Python-&pate;-Erweiterungen</title>

<para
>Der &pate;-Python-Host für Erweiterungen stellt viele Plugins zur Verfügung, die in der<ulink url="http://www.python.org/"
>Programmiersprache Python</ulink
> geschrieben wurden.</para>

<para
>Zum Verwenden von &pate;-Erweiterungen müssen Sie erst die Erweiterung <guilabel
>Python-Erweiterungen</guilabel
> im Menü <link linkend="config-dialog-plugins"
><guilabel
>Erweiterungen</guilabel
> des Einrichtungsdialogs</link
> von &kate; aktivieren. Dann können Sie diese im Menü <guilabel
>Python-Erweiterungen</guilabel
> des Einrichtungsdialogs aktivieren, deaktivieren und einrichten. Weitere Informationen dazu finden Sie hier <xref linkend="pate-config"/>.</para>

<sect2 id="pate-plugins">
<title
>Verfügbare Erweiterungen</title>

<variablelist>

<varlistentry id="pate-plugin-block">
<term
><guilabel
>block</guilabel
></term>
<listitem
><para
>Module, die beim Bearbeiten von Quelltext helfen </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-cmake_utils">
<term
><guilabel
>cmake_utils</guilabel
></term>
<listitem
><para
>CMake-Helfererweiterung </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-color_tools">
<term
><guilabel
>Farbwerkzeuge</guilabel
></term>
<listitem
><para
>Klasse, die das Anzeigen von farbigen Kurztipps ermöglicht </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-commentar">
<term
><guilabel
>Kommentar</guilabel
></term>
<listitem
><para
>Verschieben eines Kommentars vor die aktuelle Zeile. Dabei wird dieselbe Einrückungstiefe benutzt. </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-django_utils">
<term
><guilabel
>Django-Werkzeuge</guilabel
></term>
<listitem
><para
>Django-Werkzeuge: Textbausteine und Vorlagen </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-expand">
<term
><guilabel
>Erweitern</guilabel
></term>
<listitem>
<para
>Benutzerdefinierte Texterweiterungen.</para>

<para
>Jede Texterweiterung ist eine einfache Funktion, die eine Zeichenkette zurückgeben muss. Diese Zeichenkette wird in das aktuelle Dokument durch den Befehl <command
>expandAtCursor</command
> eingesetzt. Ein Beispiel: wenn Sie die Funktion <quote
>foo</quote
> in der Datei <filename
>all.expand</filename
> haben:</para>

<informalexample
><programlisting
>def foo:
  return 'Hello from foo!'
</programlisting
></informalexample>

<para
>dann wird diese Aktion nach der Eingabe von <quote
>foo</quote
> dieses <quote
>foo</quote
> durch <quote
>Hello from foo!</quote
> ersetzen. Die Erweiterungsfunktion kann auch Parameter haben. Ein Beispiel: Die Datei <filename
>text_x-c++src.expand</filename
> enthält die Funktion <function
>cl</function
>, die eine Klasse oder eine Vorlage einer Klasse erzeugt. Diese Funktion erweitert <quote
>cl(test)</quote
> zu:</para>

<informalexample
><programlisting
>/**
 * \\brief Klasse \c test
 */
class test
{
public:
    /// Standardkonstructor
    explicit test()
    {
    }
    /// Destruktor
    virtual ~test()
    {
    }
};
</programlisting
></informalexample>

<para
>während <quote
>cl(test, T1, T2, T3)</quote
> wie folgt erweitert wird:</para>

<informalexample
><programlisting
>/**
 * \\brief Klasse \c test
 */
template &lt;typename T1, typename T2, typename T3&gt;
class test
{
public:
    /// Standardkonstructor
    explicit test()
    {
    }
    /// Destruktor
    virtual ~test()
    {
    }
};
</programlisting
></informalexample>
</listitem>
</varlistentry>

<varlistentry id="pate-plugin-format">
<term
><guilabel
>Format</guilabel
></term>
<listitem
><para
>Module für das Arbeiten mit C++-Quelltextformatierung </para
></listitem>
</varlistentry>

<!--not in 4.12
<varlistentry id="pate-plugin-gdb">
<term
><guilabel
>gdb</guilabel
></term>
<listitem
><para>
Use <application
>gdb</application
>, the GNU debugger, from &kate;
</para
></listitem>
</varlistentry>
-->

<varlistentry id="pate-plugin-gid">
<term
><guilabel
>gid</guilabel
></term>
<listitem>
<para
>Durchsuchen Sie die Token in einer ID-Datei von <application
>GNU-Idutils</application
> und verwenden Sie sie zur Navigation in Quelltext.</para>

<para
>Die notwendigen Teile der ID-Datei werden im Hauptspeicher gehalten, um annehmbare Reaktionszeiten für die Vervollständigung der Token beim Suchen nach der Nutzung eines Token oder Springen zu dessen Definition zu erreichen. Der Befehl <command
>etags(1)</command
> wird benutzt, um die Definition zu finden.</para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-js_utils">
<term
><guilabel
>Javascript-Werkzeuge</guilabel
></term>
<listitem
><para
>Javascript-Werkzeuge: Autovervollständigung, jQuery vervollständigen, JSLint Checker, JSON-Formatierer, Textbausteine </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_autocomplete">
<term
><guilabel
>Python-Autovervollständigung</guilabel
></term>
<listitem
><para
>Python-Autovervollständigung (Beta, nur für Python 2) </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_console_classic">
<term
><guilabel
>Klassische Python-Konsole</guilabel
></term>
<listitem
><para
>interaktive Konsole für die Untersuchung der Internas von &kate; </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_console_ipython">
<term
><guilabel
>Python-Konsole (ipython)</guilabel
></term>
<listitem
><para
>IPython-Befehlszeile für das Hacken von &kate; und wissenschaftliches Arbeiten </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_utils">
<term
><guilabel
>Python-Werkzeuge</guilabel
></term>
<listitem
><para
>Python-Werkzeuge: Parse-Überprüfung, PEP8-Überprüfung, Pyflakes-Überprüfung, Textbausteine </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-xml_pretty">
<term
><guilabel
>&XML;-Formatierer</guilabel
></term>
<listitem
><para
>Ein einfacher &XML;-Formatierer. Er formatiert &XML; mit guter Einrückung. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="pate-config">
<title
>&pate; einrichten</title>

<sect3 id="pate-config-manager">
<title
>Das Unterfenster <guilabel
>Verwaltung</guilabel
></title>

<para
>Dieses Unterfenster enthält eine Liste von &pate;-Erweiterungen. Zum Aktivieren oder Deaktivieren benutzen Sie das Ankreuzfeld links neben der Erweiterung.</para>

<para
>Zum Auffrischen der Liste der Erweiterungen laden Sie eine der laufenden Erweiterungen neu, starten Sie eine neu ausgewählte Erweiterung oder drücken Sie den Knopf <guibutton
>Erweiterungen neuladen</guibutton
> am unteren Rand des Fensters.</para>

<warning
><para
>Das Neuladen einer Erweiterung kann nicht vorhersagbare Auswirkungen haben. Sichern Sie vorher Ihre Arbeit.</para
></warning>

</sect3>

<sect3 id="pate-config-documentation">
<title
>Das Unterfenster <guilabel
>Dokumentation</guilabel
></title>

<para
>Das Unterfenster <guilabel
>Dokumentation</guilabel
> enthält Informationen über Aktionen, Menüeinträge, Tastenkürzel und Einstellungen, die durch &pate;-Erweiterungen bereitgestellt werden. Sie finden dort auch die Referenz für Programmierer, die die Funktionen der Erweiterung benutzen wollen.</para>

<para
>Es gibt die folgenden Unterfenster:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Aktionen</guilabel
></term>
<listitem
><para
>Listet alle Aktionen auf, die durch die Erweiterung bereitgestellt werden. Dazu gehören Menüeintrag, Symbol sowie das Tastenkürzel das die Aktion auslöst.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Einrichtungsseiten</guilabel
></term>
<listitem
><para
>Listet die Einrichtungsseiten der Erweiterung auf. Dazu gehören Titel und Symbole.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Programmierreferenz</guilabel
></term>
<listitem
><para
>Enthält Informationen über alle Erweiterungen, Klassen und Funktionen, die von einer Erweiterung bereitgestellt werden, so wie diese vom Befehl <command
>pydoc</command
> erzeugt wurden.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Dateivorlagen</title>

  <para
>Mit der Erweiterung Dateivorlagen können Sie Dateien erstellen, indem Sie andere Dateien als Vorlage benutzen. </para>
  <para
>Nachdem Sie &kate; installiert haben, muss diese Erweiterung zuerst aktiviert werden:</para>
  <orderedlist>
        <listitem>
          <para
>Klicken Sie auf <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>&kate; einrichten ...</guimenuitem
></menuchoice
> </para>
        </listitem>
        <listitem>
          <para
>In der Baumansicht links im Dialog wählen Sie die Seite <guilabel
>Erweiterungen</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>Im Bereich <guilabel
>Verwaltung für Erweiterungen</guilabel
> rechts wählen Sie <guilabel
>Dateivorlagen</guilabel
> aus und drücken dann <guibutton
>OK</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>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.</para>
  <para
>Mit dieser Erweiterung können Sie auch auf einfache Art und Weise eine neue Vorlage aus einem geöffneten Dokument erstellen.</para>
  <para
>Vorlagen, die im Vorlagenordner gespeichert sind, werden im Menü <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Neu von Vorlage</guimenuitem
></menuchoice
> angezeigt.</para>
  <para
>Der Vorlagen-Ordner ist Teil des &kde;-Dateisystems und besteht mindestens aus:</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates.</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Wenn Ihre Umgebungsvariable <envar
>KDEDIRS</envar
> 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.</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Menüstruktur</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Datei</guimenu
> <guisubmenu
>Neu von Vorlage</guisubmenu
> <guimenuitem
>Beliebige Datei ...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Zeigt Ihnen den Dialog „Datei öffnen“, um eine beliebige Datei als Vorlage zu verwenden. Wenn die gewählte Datei die Erweiterung <filename
>katetemplate</filename
> hat, wird sie nach Vorlageninformationen und Makros durchsucht.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Neu von Vorlage</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>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.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>Vorlagen verwalten ...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Öffnet einen Dialog mit einer Liste aller Vorlagen in den Vorlagen-Ordnern, um Vorlagen hinzuzufügen, zu bearbeiten oder zu entfernen.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Wie Sie &kate;-Vorlagen benutzen</title>
    <para
>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.</para>
    <para
>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 &Tab;-taste. Wenn Sie bei der letzten Variablen angekommen sind, arbeitet die &Tab;-taste wie gewohnt.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Eigene Vorlagen erstellen</title>
    <para
>Mit <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Vorlagen verwalten ...</guimenuitem
></menuchoice
> öffnen Sie einen Dialog. Klicken Sie hier auf <guibutton
>Neu ...</guibutton
>, 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. </para
> <para
>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 <filename
>katetemplate</filename
> speichern.</para>
    <para
>Das Vorlagenmenü wird automatisch aktualisiert, wenn Sie Ihre Vorlage im Vorlagen-Ordner speichern. </para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Dateivorlagen bearbeiten</title>
    <para
>Um eine Vorlage zu bearbeiten, wählen Sie <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Vorlagen verwalten ...</guimenuitem
></menuchoice
>. Wählen Sie die Vorlage zur Bearbeitung und klicken Sie auf <guibutton
>Bearbeiten ...</guibutton
>, 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.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>Das &kate;-Vorlagenformat</title>
    <para
>Wenn Sie Dateien mit der Namenserweiterung <filename
>katetemplate</filename
> verwenden, wird beim Einlesen der Datei nach Vorlageninformationen, Makros und einer Cursor-Position gesucht.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Vorlageninformationen </title>
      <para
>Beim Einlesen der Datei werden Zeilen, die mit dem Text <constant
>katetemplate:</constant
> anfangen, nach Vorlageninformationen in der Form VARIABLENNAME=WERT durchsucht. Der Inhalt der Vorlage beginnt mit der ersten Zeile, die nicht mit <constant
>katetemplate:</constant
> anfängt. WERT kann beliebige Zeichen bis auf das Gleichheitszeichen (=) enthalten. Gültige Variablennamen sind: <variablelist>
          <varlistentry>
            <term
><varname
>Dateivorlage</varname
></term>
            <listitem
><para
>Dies ist der Vorlagenname, der im Menü <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Neu von Vorlage</guimenuitem
></menuchoice
> angezeigt wird.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Gruppe</varname
></term>
            <listitem
><para
>Die Gruppe bestimmt die Anordnung der Vorlage in einem Untermenü des Menüs <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Neu von Vorlage</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Name</varname
></term>
            <listitem
><para
>Dies ist der Dateiname des Dokuments, er wird in der Dateiliste und in der Titelleiste angezeigt. Enthält der Name <userinput
>%N</userinput
> und sind mehrere Dokumente mit gleichem Namen vorhanden, wird N für jedes Dokument durch eine um 1 vergrößerte Zahl ersetzt.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Hervorhebung</varname
></term>
            <listitem
><para
>Die Erweiterung wird den Hervorhebungsmodus für das neue Dokument auf den Wert dieser Variablen setzen. Als Wert sollte der Name wie in <menuchoice
><guimenu
>Extras</guimenu
><guimenuitem
>Hervorhebungen</guimenuitem
> </menuchoice
> eingesetzt werden.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Beschreibung</varname
></term>
            <listitem
><para
>Eine kurze aussagekräftige Beschreibung dieser Vorlage, die zurzeit für den <quote
>Was ist das</quote
>-Text der Menüeinträge benutzt wird. In Zukunft kann es weitere Anwendungen dafür geben.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Autor</term>
            <listitem
><para
>Ein Text mit dem Namen des Autors, zum Beispiel in der Form <userinput
> Name &lt;email address&gt;</userinput
>. Zurzeit wird dies für den <quote
>Was ist das</quote
>-Text der Menüeinträge benutzt, in Zukunft kann es weitere Anwendungen dafür geben.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Vorlagenmakros</title>

      <para
>Beim Einlesen der Vorlage werden Makros in der Form <userinput
>%{NAME}</userinput
> oder <userinput
>${Name}</userinput
> ersetzt. Wenn Sie das Vorzeichen <userinput
>$</userinput
> benutzen, wird das ersetzte Makro als editierbare Variable behandelt, wenn die Datei aus der Vorlage erstellt wird, im Gegensatz zu <userinput
>%</userinput
>, es sei denn, bei der Ersetzung treten Fehler auf.</para>
      <para
>Die folgenden Makros werden ersetzt: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Wird ersetzt durch die aktuelle Zeit in Ihren lokalen Format.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>date</literal
></term>
            <listitem
><para
>Wird durch das Datum im abgekürzten Format ersetzt.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datetime</literal
></term>
            <listitem
><para
>Wird durch das aktuelle Datum und Zeit in Ihrem lokalen Format ersetzt.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>year</literal
></term>
            <listitem
><para
>Das aktuelle Jahr als Zahl mit 4 Ziffern.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>month</literal
></term>
            <listitem
><para
>Der vollständige Name des Monats in Ihrer Sprache.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>day</literal
></term>
            <listitem
><para
>Wird durch den aktuellen Tag des Monats ersetzt.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Wird durch den „Rechnernamen“ Ihres Computers ersetzt.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>index</literal
></term>
            <listitem
><para
>Wird durch „i“ ersetzt.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Wird durch Ihren vollständigen Namen aus dem Standard &kde;-Adressbuch ersetzt.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>firstname</literal
></term>
            <listitem
><para
>Wird durch Ihren Vornamen aus dem Standard &kde;-Adressbuch ersetzt.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Wird durch Ihren Nachnamen aus dem Standard &kde;-Adressbuch ersetzt.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Wird durch Ihre E-Mail-Adresse aus dem Standard &kde;-Adressbuch ersetzt.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>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.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Einstellung der Cursor-Position</title>
      <para
>Das Sondermakro <userinput
>${cursor}</userinput
> wird durch einen vertikalen Balken ersetzt und ans Ende der Liste der editierbaren Variablen gestellt, unabhängig von seiner Position im Text.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Danksagungen</title>
    <para
>&kate;-Erweiterung <quote
>Dateivorlagen</quote
> Copyright 2004 &Anders.Lund; ""&Anders.Lund.mail;. </para>
    <para
>Copyright der Dokumentation 2004 &Anders.Lund;</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>

<title
>&XML;-Überprüfung</title>

<para
>Diese Erweiterung überprüft &XML;-Dateien auf richtige Form und Gültigkeit.</para>
<para
>Diese Erweiterung ü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 <quote
>DOCTYPE</quote
>, 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 <quote
>DTD/xhtml1-transitional.dtd</quote
> verweist und die aktuelle Datei <filename
>/home/peter/test.xml</filename
> ist, muss sich die DTD in <filename
>/home/peter/DTD/xhtml1-transitional.dtd</filename
> befinden. Es werden auch entfernte DTDs über http unterstützt.</para>

<para
>Dateien, die keinen Doctype besitzen, werden auf richtige Form hin überprüft.</para>

<para
>Wenn Sie mehr über &XML; lernen möchten, besuchen Sie die <ulink url="http://www.w3.org/XML/"
> offiziellen W3C &XML; Seiten</ulink
>.</para>

<para
>Intern ruft die Erweiterung den externen Befehl <command
>xmllint</command
> auf, der Teil von libxml2 ist. Wenn dieser Befehl nicht korrekt auf Ihrem System installiert ist, funktioniert die Erweiterung nicht.</para>

<note
><para
>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.</para
></note>

<para
>Um diese Erweiterung zu laden, öffnen Sie den Einrichtungsdialog von &kate; mit <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>&kate; einrichten ...</guimenuitem
></menuchoice
>. Wählen Sie dann <guilabel
>&XML;-Überprüfung</guilabel
> im Abschnitt <guilabel
>Programm</guilabel
> / <guilabel
>Erweiterungen</guilabel
> und schließen den Dialog. </para>

<sect2 id="xmlcheck-menu">
<title
>Menüstruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>&XML; überprüfen</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Dies startet die Überprüfung wie oben beschrieben.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Danksagungen</title>
<para
>&kate;-Erweiterung <quote
>&XML;-Überprüfung</quote
> Copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Copyright der Dokumentation 2002 &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>
<title
>&XML;-Vervollständigung</title>

<para
>Diese Erweiterung 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 <quote
>&amp;</quote
> ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.</para>

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

<sect2 id="xmltools-how-to-use">
<title
>Anwendung</title>

<para
>Starten Sie &kate; und öffnen Sie den Einrichtungsdialog mit <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>&kate; einrichten  ...</guimenuitem
></menuchoice
>. Dann wählen Sie <guilabel
>&XML;-Vervollständigung</guilabel
> im Abschnitt <guilabel
>Programm</guilabel
> / <guilabel
>Erweiterungen</guilabel
>. Danach wählen Sie <menuchoice
><guimenu
>&XML;</guimenu
><guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
></menuchoice
>. Wenn Ihr Dokument keinen <quote
>DOCTYPE</quote
> 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.</para>

<para
>Jetzt können Sie die Erweiterung während der Texteingabe benutzen.</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (kleiner als)</term>
<listitem
><para
>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; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
>(Zeichen "kleiner als" und Schr&auml;gstrich)</term>
<listitem
><para
>Die Eingabe dieser Zeichen schl&auml;gt das Schlie&szlig;en des aktuellen Elements vor (das n&auml;chste offene links vom Cursor). Dr&uuml;cken Sie die &Enter;-Taste, um den Vorschlag zu akzeptieren. Anders als der Men&uuml;punkt <guimenuitem
>Element schlie&szlig;en</guimenuitem
>, funktioniert dies nur mit einer zugewiesenen DTD.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (Anführungszeichen)</term>
<listitem
><para
>Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten anzeigen, wenn es welche gibt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (Leertaste)</term>
<listitem
><para
>Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element anzeigen, wenn die Taste innerhalb einer Marke gedrückt wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (Kaufmanns-Und)</term>
<listitem
><para
>Diese Taste wird eine Liste mit definierten Entitäten anzeigen.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Funktionen und Einschränkungen</title>

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

</sect2>


<sect2 id="xmltools-menu">
<title
>Menüstruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Eingabe</keycap
> </keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Element einfügen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Damit öffnen Sie einen Dialog zum Einfügen eines &XML;-Elementes. Die &lt;,&gt;-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 <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> zugewiesen wurde. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Element schließen</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Danksagungen</title>
<para
>&kate;-Erweiterung <quote
>XML-Vervollständigung</quote
> Copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>KDE SC 4 Version Copyright 2010 Tomáš Trnka</para>
<para
>Copyright der Dokumentation 2001, 2002 &Daniel.Naber;</para>
</sect2>

</sect1>
<!--FIXME this belongs to Extensions, it is an editor plugin-->
<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Exporter</title>

<sect2 id="exporter-menu">
<title
>Menüstruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Als &HTML; exportieren ...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Exportiert die Datei im &HTML;-Format, sodass diese als Webseite betrachtet werden kann. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Als &HTML; kopieren ...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Kopiert den ausgewählten Text mit der Syntaxhervorhebung &HTML;-Format.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
>&TC.Hollingsworth; &TC.Hollingsworth.mail; </author
></authorgroup>
</sect1info>
<title
>Suchen und Ersetzen</title>

<sect2 id="searchinfiles-intro">
<title
>Einleitung</title>
<para
>Mit &kappname;'s Erweiterung Suchen und Ersetzen können Sie nach einfachem Text oder <link linkend="regular-expressions"
>regulären Ausdrücken</link
> 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.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Oberfläche</title>

<sect3 id="searchinfiles-ui-query">
<title
>Such-Anfrage</title>

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

<variablelist>

<varlistentry>
<term
><guiicon
>Neues Unterfenster</guiicon
></term>
<listitem
><para
>Sie können beliebig viele Suchvorgänge auf einmal öffnen. Klicken Sie dazu auf den Knopf <guibutton
>Neues Unterfenster</guibutton
> oben links in der Ansicht <guilabel
>In Dateien suchen</guilabel
>, dann können Sie eine weitere Suche starten. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Ergebnisse umschalten</guiicon
></term>
<listitem
><para
>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.  </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Suchen</guilabel
></term>
<listitem
><para
>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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ersetzen</guilabel
> (Textfeld)</term>
<listitem
><para
>Text, der anstelle des Textes im Eingabefeld <guilabel
>Suchen</guilabel
> in die geöffneten Dokumente eingefügt wird. </para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><guibutton
>Weiter</guibutton
></term>
<listitem
><para
>Geht zur nächsten Fundstelle der Suche. Wenn nötig, wird zum nächsten Dokument umgeschaltet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Markierte ersetzen</guibutton
></term>
<listitem
><para
>Macht dasselbe wie Ersetzen, aber nur in den Dokumenten, die unten markiert sind. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Einstellungen für die Suche in Ordnern</title>

<para
>Diese Einstellungen erscheinen unter den vorher genannten Einstellungen für die Abfrage. Werden stattdessen die Ergebnisse einer Suche angezeigt, wechseln Sie mit dem Knopf <guiicon
>Ergebnisse umschalten</guiicon
> zur Anzeige der zusätzlichen Einstellungen.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Groß-/Kleinschreibung beachten</guilabel
></term>
<listitem
><para
>Beschränkt Sie die Suche auf Ausdrücke, die mit der gleichen Groß- und Kleinschreibung wie im Suchfeld auch in den Dateien vorhanden sind. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Reguläre Ausdrücke</guilabel
></term>
<listitem
><para
>Erlaubt die Verwendung eines <guilabel
>Regulären Ausdrucks</guilabel
> anstatt eines einfachen Textes für die Suche. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ergebnisse erweitern</guilabel
></term>
<listitem
><para
>Zeigt alle Suchergebnisse in jedem Dokument an, nicht nur eine Liste  der Dokumente, in denen die Suche erfolgreich war. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Suchen</guilabel
></term>
<listitem
><para
>In diesem Auswahlfeld gibt es drei Einstellungen. Wählen Sie <guilabel
>In offenen Dateien</guilabel
>, um in allen gerade in &kappname; geöffneten Dateien oder <guilabel
>in Ordner</guilabel
>, um in einem Ordner und dessen Unterordnern zu suchen. Wählen Sie <guilabel
>im Projekt</guilabel
>, um in allen Dokumenten, die im offenen Projekt gelistet sind, zu suchen. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ordner</guilabel
></term>
<listitem
><para
>Hier können Sie den Ordner eingeben, in dem die Suche starten soll. Sie können zum Beispiel <userinput
>~/development/kde/kate/</userinput
>, eingeben, wenn Sie im Quelltext von &kate; suchen möchten. Diese Option steht nur dann zur Verfügung, wenn der Modus <guilabel
>in Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Dateiauswahl-Dialog</guiicon
></term>
<listitem
><para
>Drücken Sie diesen Knopf, um den Ordner im Dateiauswahldialog zu öffnen. Diese Option steht nur dann zur Verfügung, wenn der Modus <guilabel
>in Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Nach oben</guiicon
></term>
<listitem
><para
>Drücken Sie diesen Knopf, um in den übergeordneten <guilabel
>Ordner</guilabel
> des aktuellen Ordners zu wechseln. Diese Option steht nur dann zur Verfügung, wenn der Modus <guilabel
>in Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Aktuellen Dokumentpfad verwenden</guiicon
></term>
<listitem
><para
>Mit diesem Knopf setzen Sie den Eintrag für den <guilabel
>Ordner</guilabel
> auf den Ordner, in der die gerade geöffnete Datei gespeichert ist. Diese Option steht nur dann zur Verfügung, wenn der Modus <guilabel
>in Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Filter</guilabel
></term>
<listitem
><para
>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 <userinput
>*.cpp</userinput
>. Alle Dateien, deren Namen mit <literal
>kate</literal
> beginnt, finden Sie mit der Eingabe <userinput
>kate*</userinput
>. Sie können mehrere Filter getrennt durch Komma  (<userinput
>,</userinput
>) eingeben. Diese Option steht nicht zur Verfügung, wenn der Modus <guilabel
>in offenen Dateien</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ausschließen</guilabel
></term>
<listitem
><para
>Diese Option ermöglicht, Dateien von der Suche auszuschließen. Wie im <guilabel
>Filter</guilabel
> können Sie mehrere Namensmuster, durch ein Komma getrennt, eingeben (<userinput
>,</userinput
>). Diese Option steht nicht zur Verfügung, wenn der Modus <guilabel
>in offenen Dateien</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rekursiv</guilabel
></term>
<listitem
><para
>Ist diese Einstellung aktiviert, sucht &kappname; auch in allen Unterordnern des ausgewählten Ordners. Diese Option ist nur verfügbar, wenn der Modus <guilabel
>im Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Versteckte Dateien einbeziehen</guilabel
></term>
<listitem
><para
>Ist diese Einstellung aktiviert, sucht &kappname; auch in Dateien und Ordner, die normalerweise durch das &OS; versteckt werden. Diese Option steht nur zur Verfügung, wenn der Modus <guilabel
>in Ordner</guilabel
> benutzt wird. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Symbolischen Verknüpfungen folgen</guilabel
></term>
<listitem
><para
>Normalerweise durchsucht diese Erweiterung keine <ulink url="http://de.wikipedia.org/wiki/Symbolische_Verknüpfung"
>symbolischen Verknüpfungen</ulink
>. Ist diese Einstellung aktiv, folgt die Erweiterung 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 <guilabel
>in Ordner</guilabel
> benutzt wird. </para>
<warning
><para
>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.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Einschließlich Binärdateien</guilabel
></term>
<listitem
><para
>Ist diese Einstellung aktiviert, sucht &kappname; auch in Dateien, die keine Textdateien zu sein scheinen. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Suchergebnisse</title>

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

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

<para
>Wenn Sie eine Liste der Fundstellen in der Datei sehen wollen, klicken Sie einfach auf den Pfeil links vom Dateinamen. Wenn Sie die Option <guilabel
>Ergebnisse erweitern</guilabel
> 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.</para>

<para
>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. Sie können auch sofort an eine bestimmte Fundstelle springen, indem Sie auf diese Fundstelle in der Liste doppelklicken. </para>

</sect3>
</sect2>

<sect2 id="searchinfiles-menu">
<title
>Menüstruktur</title>

<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Bearbeiten</guimenu
> <guimenuitem
>In Dateien suchen ...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Öffnet das Werkzeug Suchen und Ersetzen</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Zum nächsten Treffer springen</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Springt zur nächsten Fundstelle.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Zum vorherigen Treffer springen ...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Springt zur vorherigen Fundstelle.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Suchen und Ersetzen anzeigen</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Schaltet die Anzeige des Werkzeugs <guilabel
>Suchen und Ersetzen</guilabel
> ein und aus </para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-mail">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</sect1info
>-->
<title
>Mail-Dateien</title>

<sect2 id="mail-menu">
<title
>Menüstruktur</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Versenden ...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Öffnen des E-Mail Programms und Anhängen der aktuellen Nachricht als Datei. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Der Dateisystem-Browser</title>

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

<sect2 id="fsbrowser-menu">
<title
>Menüstruktur</title>
<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Dateisystem-Browser anzeigen</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Schaltet die Anzeige des Dateisystem-Browsers von &kate; ein und aus.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Oberfläche</title>

<para
>Von oben nach unten besteht der Dateisystem-Browser aus folgenden Elementen:</para>

<variablelist>
<varlistentry>
<term
>Eine Werkzeugleiste</term>
<listitem>
<para
>Diese enthält Standardnavigationsknöpfe:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Zurück</guibutton
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Vorwärts</guibutton
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guibutton
>Lesezeichen</guibutton
></term>
<listitem
><para
>Öffnet ein Untermenü zum Ändern oder Hinzufügen von Lesezeichen. Hier können Sie auch ein neues Lesezeichenverzeichnis hinzufügen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Aktueller Dokumentordner</guibutton
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Optionen</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Kurzdarstellung</guimenuitem
></term>
<listitem
><para
>Zeigt nur die Namen der Dateien.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Ausführliche Ansicht</guimenuitem
></term>
<listitem
><para
>Zeigt <guilabel
>Name</guilabel
>, <guilabel
>Datum</guilabel
>, <guilabel
>Größe</guilabel
> und <guilabel
>Typ</guilabel
> der Dateien an.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Baumansicht</guimenuitem
></term>
<listitem
><para
>Wie die Kurzansicht, aber die Ordner können ein- und ausgeklappt werden, um die Unterordner oder Dateien darin anzuzeigen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Ausführliche Baumansicht</guimenuitem
></term>
<listitem
><para
>In dieser Ansicht können die Ordner ebenfalls ein- und ausgeklappt werden, zusätzlich werden die Spalten wie in der Ausführlichen Ansicht angezeigt.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Versteckte Dateien anzeigen</guimenuitem
></term>
<listitem
><para
>Zeigt auch die normalerweise ausgeblendeten Dateien des Betriebssystems an.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Automatisch mit dem aktuellen Dokument abgleichen</guimenuitem
></term>
<listitem
><para
>Ist diese Einstellung aktiviert, wechselt der Dateisystem-Browser automatisch mit dem Befehl <command
>cd</command
> in den Ordner des aktuell geöffneten Dokuments im Editorbereich, wenn das aktuell geöffnete Dokument gewechselt wird.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Eine Adressleiste</term>
<listitem>
<para
>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.</para>

<para
>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.</para>
<tip
><para
>Das &URL;-Feld hat eine automatische Vervollständigung, die Vervollständigungsmethode kann durch das mit der rechten Maustaste aufzurufende Kontextmenü eingestellt werden.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Eine Verzeichnisansicht</term>
<listitem
><para
>Dies ist eine Standard-&kde;-Verzeichnisansicht.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Ein Filtereintrag</term>
<listitem>
<para
>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: <userinput
>*.cpp *.h *.moc</userinput
></para>
<para
>Um alle Dateien anzuzeigen, geben Sie einen einzelnen Stern (<userinput
>*</userinput
>) ein.</para>
<para
>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 <guibutton
>Text löschen</guibutton
> links neben dem Pfeil für die automatische Vervollständigung.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Einstellungen</title>

<para
>Die Einstellungen für diese Erweiterung finden Sie auf der Seite <guilabel
>Dateisystem-Browser</guilabel
> in &kate;s <link linkend="configuring-kate-configdialog"
>Einrichtungsdialog</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Werkzeugleiste</guilabel
></term>
<listitem
><para
>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 <guilabel
>Ausgewählte Aktionen:</guilabel
> befördern (oder daraus). Sie können die ausgewählten Aktionen dann mit den Knöpfen rechts ordnen.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--some material from mdi.docbook needs to be migrated here too-->
<!--<sect1 id="kate-application-plugin-exttools">
<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info>
<title
>External Tools</title>

<para
>In the <guimenu
>Tools</guimenu
> menu you will find a submenu labeled
<guisubmenu
>External Tools</guisubmenu
>, if you have enabled them in &kate; settings.
These tools invoke external applications with data related to the current document,
for example its URL, directory, text or selection.</para>

<para
>External tools are user defined, you can add, edit or remove tools using
the <link linkend="exttools-config"
>External Tools</link
> configuration panel.
</para>

<sect2 id="exttools-menu">
<title
>Menu Structure</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Tools</guimenu
><guisubmenu
>External
Tools</guisubmenu
></menuchoice
></term>
<listitem
><para
>This submenu contains all the external tools you have
configured.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Configuration</title>

<para
>External tools are configured on the <guilabel
>External Tools</guilabel
> page
of <link linkend="configuring-kate-configdialog"
>&kate;'s configuration</link
>. These tools invoke external
applications with data related to the current document, for example its URL,
directory, text or selection. This page allows you to manage the menu and edit,
remove or add new tools.</para>

<para
>Each external tool is a shell command which contains macros representing
the document data. When activated, the macros are substituted with data from the
active document.</para>

<variablelist>
<title
>Available Commands</title>

<varlistentry>
<term
><guibutton
>New</guibutton
></term>
<listitem
><para
>Add a new external tool to the list.  This will launch the property
sheet described below where you can configure an external tool.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Edit</guibutton
></term>
<listitem
><para
>Edit the currently selected external tool, using the property
sheet described below.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Insert Separator</guibutton
></term>
<listitem
><para
>Adds a separator line that appears in the menu below the currently
selected item.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Up Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item above the previous
one.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Down Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item below the subsequent
one.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>External Tools Properties</title>
<varlistentry>
<term
><guilabel
>Label</guilabel
></term>
<listitem
><para
>A friendly label that will appear in the <guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Icon</guibutton
></term>
<listitem
><para
>Allows you to select an icon that appears next to the label in the
<guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Script</guilabel
></term>
<listitem
><para
>The script to execute when the tool is activated. Before passing
the script to the shell, the following macros are substituted:

<variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>The full URL of the current document, or an empty string if the
document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%URLs</userinput
></term>
<listitem
><para
>A space separated list of the URLs of all open documents
(except unsaved ones).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>The directory part of the current documents URL or an empty
string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>The filename of the current document without the path, or an
empty string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%line</userinput
></term>
<listitem
><para
>The line number of the insertion cursor is in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%column</userinput
></term>
<listitem
><para
>The column number of the insertion cursor in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>The selected text in the current document, or an empty string
if no text is selected</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>The full text of the current document. Beware that this may
potentially exceed the maximum command length allowed on your system.
Use with care.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Executable</guilabel
></term>
<listitem
><para
>The main executable in the script. This is mandatory, and is used
to test if the command can be run at all. A fully qualified path is allowed
in case the executable is not in your <envar
>PATH</envar
> variable.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mime types</guilabel
></term>
<listitem
><para
>A semicolon separated list of mimetypes for which this command
should be enabled.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Save</guilabel
></term>
<listitem
><para
>You can optionally select to have the current or all documents
saved prior to executing the script. This is handy if your script reads the file
from disk.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Command line name</guilabel
></term>
<listitem
><para
>If you fill this, the tool will be available in the
<link linkend="advanced-editing-tools-commandline"
>editors command line</link
> as
<command
>exttool-<replaceable
>Command Line Name</replaceable
></command>
(the string you enter here prepended <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1
>-->

 <!--
 FIXME: replaced by built-in functionality in 4.12
        lots of this is wrong, other parts need to be moved somewhere else
<sect1 id="kate-application-plugin-snippets">
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Kate Snippets</title>

<sect2 id="snippets-intro">
<title
>Introduction</title
>       
<para
>Kate Snippets is a plugin used to save you some time by adding support for
so-called <quote
>snippets</quote
> (re-usable source code, machine code or text). The plugin
also supports code completion and QtScript.</para>
</sect2>

<sect2 id="snippets-menu">
<title
>Menu Structure</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>View</guimenu
><guisubmenu
>Tool Views</guisubmenu>
<guimenuitem
>Show Snippets</guimenuitem
></menuchoice
></term>
<listitem
><para
>Shows snippets panel containing all snippets in your repository
that are for the currently opened file type.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="snippets-panel">
<title
>Snippets panel</title>

<screenshot id="screenshot-snippets-panel">
<screeninfo
>Kate Snippets Panel</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
<textobject
><phrase
>The &kate; snippets panel.</phrase
></textobject>
<caption
><para
>The panel for &kate; Snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>In the panel you should see a list of snippet repositories,
along with options to create your own, get them from the Internet or load
them from a local file.  Each repository has a checkbox that can be used to
activate or deactivate it.  There are also buttons to edit and delete existing
repositories.</para>

<sect3 id="snippets-repo-internet">
<title
>Loading Snippet Repository Files</title>
<para
>You can download snippet repositories from the Internet.  Just click 
<guibutton
>Get New Snippets</guibutton
> and a window with a list of snippet 
repositories will open.  After downloading the desired snippet, make sure that
you have activated it.</para>
<!- -FIXME no way to load a local file ?- ->
<para
>You can also load snippet repositories from a local file using the file
browser at the bottom of the panel.  Click <guibutton
>Copy to repository</guibutton>
when finished.</para>
</sect3>

<sect3 id="snippets-repo-editor">
<title
>Creating and Editing Snippets</title>

<screenshot id="screenshot-snippets-form">
<screeninfo
>Snippet Editor</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-form.png" format="PNG"/></imageobject>
<textobject
><phrase
>The snippet editor.</phrase
></textobject>
<caption
><para
>The snippet editor interface.</para
></caption>
</mediaobject>
</screenshot>

<para
>To create a new snippet repository, click <guibutton
>New Snippet File</guibutton
>.
You should now see a dialog that asks for the name of the snippet file, license and
author.  After choosing the desired options, click <guibutton
>Create</guibutton
>,
and the snippet editor will open.</para>

<para
>The snippet editor contains the following options:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>File Type</guilabel
></term>
<listitem
><para
>Select the file type(s) you want the snippet repository to apply
to.  It is set to <quote
>*</quote
> by default, so the repository applies to all files.  You 
can change it to something like <userinput
>C++</userinput
> for instance, or select
from a list by hitting the <guibutton
>Edit</guibutton
>.  You can specify more
than one file type by separating them with <userinput
>;</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Authors</guilabel
></term>
<listitem
><para
>Enter the name(s) of the author(s) of the snippet file.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Snippets List</term>
<listitem
><para
>Contains all snippets defined in the snippet file.  You can
simply click on a snippet listed there to edit it.</para
></listitem>
</varlistentry>
    
<varlistentry>
<term
>Add (<guibutton
>+</guibutton
>)</term>
<listitem
><para
>Used to add a new snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Delete (<guibutton
>-</guibutton
>)</term>
<listitem
><para
>Used to delete a snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Match/Name</guilabel
></term>
<listitem
><para
>Appears in the list of snippets in the tool view and is also
searched when using the code completion feature.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Display Prefix</guilabel
>, <guilabel
>Display Postfix</guilabel
>,
and <guilabel
>Display Arguments</guilabel
></term>
<listitem
><para
>Used to display helpful information while using code completion.
The prefix and postfix are displayed before and after the name, while the arguments
are displayed in parenthesis immediately after the name.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Snippet Content</guilabel
></term>
<listitem
><para
>Reusable text or code.  This is what appears in your document
when the snippet is used.</para
></listitem>
</varlistentry>

</variablelist>

<para
>In <guilabel
>Snippet Content</guilabel
> you can specify variables with 
<userinput
>${<replaceable
>name</replaceable
>}</userinput
> or
<userinput
>%{<replaceable
>name</replaceable
>}</userinput
>.  These can be filled
by QtScript or when the snippet is used.  There is a special variable - 
${cursor} or %{cursor} - which automatically sets the cursor to its first 
occurrence.</para>

</sect3>
</sect2>

<sect2 id="snippets-using">
<title
>Using Snippets</title>

<screenshot id="screenshot-snippets-usage">
<screeninfo
>Kate Snippets in Action</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
<textobject
><phrase
>Accessing &kate; Snippets from a tool view and a drop down menu.</phrase
></textobject>
<caption
><para
>Selecting from a list of snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>You can call snippets in two ways:</para>

<itemizedlist>
<listitem
><para
>By choosing the snippet from the tool view.</para
></listitem>
<listitem
><para
>While writing, you can press <keycombo action="simul"
>&Ctrl;
<keysym
>Space</keysym
></keycombo
>, which will display all the snippets in a
convenient window from which you can choose.  You may enter the beginning
of the snippets name before or after pressing this key combination, which provides
functionality similar to code completion.</para
></listitem>
</itemizedlist>

<para
>If the snippet contains variables (besides <literal
>${cursor}</literal
>)
the cursor will automatically go to the first occurrence of a variable and will
wait for you to write something. When you are done, you can press &Tab; to move
to the next variable, and so on.</para>

</sect2>

<sect2 id="snippets-ack">
<title
>Thanks and Acknowledgments</title>
<para
>&kate; Snippets was written by Joseph Wenninger.</para>
<para
>Special thanks to Google Code-In 2011 participant Martin Gergov for
writing much of this section.</para>
</sect2>

</sect1>
-->

<sect1 id="kate-application-plugin-build">
<!--http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
<sect1info>
<authorgroup>
<author
><firstname
>Salma</firstname
> <surname
>Sultana</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Erstellen-Modul</title>

<sect2 id="build-intro">
<title
>Einleitung</title>

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

<!--When you first install Kate, you need to enable the plugin:

Click `Settings → Configure Kate`

In the tree on the left of the screen, click `Plugins`.

In the `Plugin Manager` panel on the right, select `Build plugin`, and then click `OK`.-->

</sect2>

<sect2 id="build-using">
<title
>Das Erstellen-Modul benutzen</title>

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


<para
>Die <guilabel
>Ausgabe beim Erstellen</guilabel
> zeigt drei Karteikarten an:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Ziel-Einstellungen</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Ausgabe</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Fehler und Warnungen</guilabel
></para
></listitem>
</itemizedlist>

<sect3 id="build-using-target-settings">
<title
>Die Karteikarte „Ziel-Einstellungen“</title>

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

<para
>Für jedes Ziel gibt es vier Einstellungsmöglichkeiten:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Arbeitsordner</guilabel
></term>
<listitem
><para
>Hier können Sie den Pfad für das Projekt eintragen. Wenn Sie dieses Feld leer lassen wird das Verzeichnis verwendet, in dem die aktuelle Datei gespeichert ist.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Erstellen</guilabel
></term>
<listitem
><para
>Mit dieser Einstellung legen Sie den Befehl zum Erstellen fest. Die Voreinstellung ist <command
>make</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Aufräumen</guilabel
></term>
<listitem
><para
>Mit dieser Einstellung legen Sie den Befehl zum Löschen der Konfiguration fest. Die Voreinstellung ist <command
>make clean</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Schnellkompilieren</guilabel
></term>
<listitem
><para
>Mit dieser Einstellung legen Sie den Befehl zum Schnellkompilieren fest. Die Voreinstellung ist <command
>gcc -Wall -g %f</command
>.</para
></listitem>
</varlistentry>
</variablelist>

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

</sect3>

<sect3 id="build-using-output">
<title
>Die Karteikarte „Ausgabe“</title>

<para
>Die Karteikarte <guilabel
>Ausgabe</guilabel
> zeigt die Konsolenausgabe des letzten Befehls an.</para>

</sect3>

<sect3 id="buiid-using-errors">
<title
>Fehler und Warnungen</title>

<para
>Die Karteikarte <guilabel
>Fehler und Warnungen</guilabel
> zeigt die Ausgabe der Fehler und Warnungen des letzten Befehls an.</para>

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

<para
>Es gibt Knöpfe für <guibutton
>Fehler</guibutton
>, <guibutton
>Warnungen</guibutton
>, und <guibutton
>Andere</guibutton
> oben im Werkzeug, mit denen Sie die entsprechenden Kategorien zeigen oder verstecken können.</para>

<!--FIXME: These shortcuts now seem to be used by the Project plugin in 4.11.
            https://bugs.kde.org/show_bug.cgi?id=328170 -->
<para
>Zum vorherigen Fehler oder der vorherigen Warnung gehen Sie mit <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil links</keysym
></keycombo
>, zum nächsten Fehler oder der nächsten Warnung mit <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil rechts</keysym
></keycombo
>.</para>

</sect3>
</sect2>

<sect2 id="build-menu">
<title
>Menüstruktur</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Erstellen</guimenu
> <guimenuitem
>Erstellen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt den Befehl <guilabel
>Erstellen</guilabel
> für das aktuell ausgewählte Ziel aus.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Erstellen</guimenu
> <guimenuitem
>Aufräumen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt den Befehl <guilabel
>Aufräumen</guilabel
> für das aktuell ausgewählte Ziel aus.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Erstellen</guimenu
> <guimenuitem
>Schnellkompilieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt den Befehl <guilabel
>Schnellkompilieren</guilabel
> für das aktuell ausgewählte Ziel aus.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil links</keysym
></keycombo
></shortcut
> <guimenu
>Erstellen</guimenu
><guimenuitem
>Vorheriger Fehler</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt den Cursor zum vorherigen Fehler im Dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Pfeil rechts</keysym
></keycombo
></shortcut
> <guimenu
>Erstellen</guimenu
><guimenuitem
>Nächster Fehler</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt den Cursor zum nächsten Fehler im Dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Erstellen</guimenu
><guisubmenu
>Ziele</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Ermöglicht die Auswahl aus einer Liste von benutzerdefinierten Zielen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Erstellen</guimenu
><guimenuitem
>Nächstes Ziel</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Wechselt zum nächsten vom Benutzer definierten Ziel.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="build-ack">
<title
>Danksagungen</title>
<para
>Das Erstellen-Modul für &kate; wurde von Kåre Särs geschrieben.</para>
<para
>Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Salma Sultana,der den Hauptteil diese Abschnitts geschrieben hat.</para>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-sql">
<sect1info>
<authorgroup>
<author
><firstname
>Ömer</firstname
> <othername
>Faruk</othername
> <surname
>ORUÇ</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>SQL-Modul</title>

<sect2 id="sql-intro">
<title
>Einleitung</title>

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

<para
>Mit dem SQL-Modul von &kate; können Sie: </para>

<itemizedlist>
<listitem
><para
>Eine Datenbank erstellen</para
></listitem>
<listitem
><para
>Eine Verbindung zu einer vorhandenen Datenbank erstellen</para
></listitem>
<listitem
><para
>Daten in eine Datenbank einfügen und löschen</para
></listitem>
<listitem
><para
>Abfragen ausführen</para
></listitem>
<listitem
><para
>Ergebnisse in einer Tabelle anzeigen</para
></listitem>
</itemizedlist>

<!--If Kate is installed on your computer, at first open Kate.
If Kate isn't installed on your computer, download and install it.

Using SQL Plugin
After opening the Kate;
Click Settings→ Configure Kate
and then;
Click Application → Select Plugins in the tree widget

In the Plugin Manager panel on the right, check SQL Plugin and click OK.
-->

</sect2>

<sect2 id="sql-connecting">
<title
>Verbindung zu einer Datenbank</title>

<para
>Wählen Sie <guibutton
>Verbindung hinzufügen</guibutton
> aus dem Menü <guimenu
>SQL</guimenu
> 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 <guibutton
>Weiter</guibutton
>. </para>

<para
>Wenn die ausgewählte Datenbank eine Datei verwendet, geben Sie nur den Ordner der Datenbank an und drücken dann den Knopf <guibutton
>Weiter</guibutton
>. 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 <guibutton
>Weiter</guibutton
>.</para>

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

</sect2>

<sect2 id="sql-querying">
<title
>Abfragen ausführen</title>

<sect3 id="sql-querying-insert-delete-update">
<title
>INSERT/DELETE/UPDATE</title>

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

<example>
<title
>Einige Beispiel-Abfragen</title>
<variablelist>

<varlistentry>
<term
><command
>INSERT</command
></term>
<listitem
><para
><programlisting
>INSERT INTO <replaceable
>table_name</replaceable
> ("<replaceable
>feature1</replaceable
>", "<replaceable
>feature2</replaceable
>", "<replaceable
>feature3</replaceable
>", "<replaceable
>feature4</replaceable
>", "<replaceable
>feature5</replaceable
>")
VALUES ("<replaceable
>value1</replaceable
>", "<replaceable
>value2</replaceable
>", "<replaceable
>value3</replaceable
>", "<replaceable
>value4</replaceable
>", "<replaceable
>value5</replaceable
>" )
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>DELETE</command
></term>
<listitem
><para
><programlisting
>DELETE FROM <replaceable
>table_name</replaceable
> WHERE name = "<replaceable
>text</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>UPDATE</command
></term>
<listitem
><para
><programlisting
>UPDATE <replaceable
>table_name</replaceable
> SET "<replaceable
>feature1</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>feature2</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>feature3</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>feature4</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>feature5</replaceable
>" = "<replaceable
>text</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

</variablelist>
</example>

</sect3>

<sect3 id="sql-querying-select">
<title
>SELECT</title>

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

<example>
<title
>Beispiel einer <command
>SELECT</command
>-Abfrage</title>
<para
><programlisting
>SELECT * FROM <replaceable
>table_name</replaceable
>
</programlisting
></para>
</example>

<para
>In der Ansicht <guilabel
>SQL-Datenausgabe</guilabel
> gibt es mehrere Knöpfe:</para>

<variablelist>

<varlistentry>
<term
><guibutton
>Spaltengröße an Inhalte anpassen</guibutton
></term>
<listitem
><para
>Ändert die Größe der Spalten, so dass der Inhalt vollständig angezeigt wird.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Zeilengröße an Inhalte anpassen</guibutton
></term>
<listitem
><para
>Ändert die Größe der Zeilen, so dass der Inhalt vollständig angezeigt wird.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Kopieren</guibutton
></term>
<listitem
><para
>Wählt den gesamten Inhalt der Tabelle und kopiert ihn in die Zwischenablage.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Exportieren</guibutton
></term>
<listitem
><para
>Exportiert die gesamte Tabelle in eine Datei, in die Zwischenablage oder das aktuelle Dokument als durch Komma getrennte Werte.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Zurücksetzen</guibutton
></term>
<listitem
><para
>Löscht die gesamte Tabellenansicht.</para
></listitem>
</varlistentry>

</variablelist>

<para
>Die in der Tabelle verwendeten Farben können Sie im Einrichtungsdialog auf der Seite <guilabel
>SQL</guilabel
> einstellen.</para>

</sect3>
</sect2>

<sect2 id="sql-browsing">
<title
>Datenbank durchsuchen</title>

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

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

</sect2>

<sect2 id="sql-menus">
<title
>Menüstruktur</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Verbindung hinzufügen ...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Fügt eine neue Verbindung mit einem beliebigen Datenbanktreiber hinzu. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Verbindung entfernen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Entfernt die ausgewählte Verbindung. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Verbindung bearbeiten ...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Öffnet den Dialog <guilabel
>Verbindungsassistent</guilabel
>, in dem Sie die Einstellungen der Verbindung ändern können. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Verbindungen</term>
<listitem
><para
>Alle von Ihnen erstellten Datenbankverbindungen werden im Menü <guimenu
>SQL</guimenu
> zwischen den Einträgen <guimenuitem
>Verbindung bearbeiten</guimenuitem
> und <guimenuitem
>Abfrage ausführen</guimenuitem
> angezeigt. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>SQL</guimenu
><guimenuitem
>Abfrage ausführen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startet Ihre SQL-Abfrage. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="sql-ack">
<title
>Danksagungen</title>

<para
>Das SQL-Modul wurde von Marco Mentasti geschrieben.</para>
<para
>Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Ömer Faruk ORUÇ, der den Hauptteil diese Abschnitts geschrieben hat.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-gdb">
<!--http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>&gdb;-Erweiterung</title>

<sect2 id="gdb-intro">
<title
>Einleitung</title>

<para
>&kappname;s &gdb;-Erweiterung stellt eine einfache Oberfläche für den Debugger des &GNU;-Projekts zur Verfügung.</para>

<important>
<para
>Erfahrung im Umgang mit &gdb; wird für diese Erweiterung dringend empfohlen. Weitere Informationen über die Anwendung von &gdb; finden Sie auf der <ulink url="http://www.gnu.org/s/gdb/"
>&gdb;-Webseite</ulink
>.</para>
</important>

<para
>Sie können die &gdb;-Erweiterung im Abschnitt <link linkend="config-dialog-plugins"
>Erweiterungen</link
> des Einrichtungsdialogs von &kappname; aktivieren.</para>

<para
>Damit die Erweiterung richtig funktioniert, brauchen Sie eine Quelltextdatei, deren Typ von &gdb; unterstützt wird, und die ausführbare Programmdatei.</para>

<tip>
<para
>Wenn Sie den Compiler &gcc;/<command
>g++</command
> verwenden, benötigen Sie das Befehlszeilenargument <command
><parameter
>-ggdb</parameter
></command
>. </para>
</tip>

<para
>Nach diesen Vorbereitungen öffnen Sie die Quelltextdatei in &kappname;, geben den Pfad zum ausführbaren Programm auf der Karteikarte <guilabel
>Einstellungen</guilabel
> der <guilabel
>Debug-Ansicht</guilabel
> ein und wählen zum Start <menuchoice
><guimenu
>Debuggen</guimenu
><guimenuitem
>Debuggen starten</guimenuitem
></menuchoice
> aus dem Menü.</para>

</sect2>

<sect2 id="gdb-menus">
<title
>Menü- und Werkzeugleistenstruktur</title>

<para
>Alle Aktionen finden Sie in &kappname;s Menüs, viele dieser Aktionen auch in der Werkzeugleiste <guilabel
>GDB-Erweiterung</guilabel
>.</para>

<variablelist>

<varlistentry id="gdb-menus-show-debug-view">
<term
><menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Debug-Ansicht anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Zeigt eine Werkzeugansicht mit der &gdb;-Ausgabe, einer &gdb;-Befehlszeile und weiteren Einstellungen.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-locals">
<term
><menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Lokale Variablen anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Zeigt eine Liste aller aktuell geladenen Variablen und deren Werte. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-call-stack">
<term
><menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Aufrufstapel anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Zeigt einen &gdb;-Backtrace.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-targets">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
><guisubmenu
>Ziele</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Ein Untermenü mit einer Liste von Zielen (ausführbaren Programmen). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-arg-lists">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
><guisubmenu
>Argumentlisten</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Ein Untermenü mit allen Argumentlisten.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-start">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Debuggen starten</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startet &gdb; mit einem Ziel.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-kill">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Debuggen beenden/abbrechen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Beendet &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-restart">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Debuggen neustarten</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startet &gdb; erneut.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-break">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Haltepunkt ein-/ausschalten</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Setzt einen Haltepunkt an der aktuellen Cursor-Position. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-in">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Einzelschritt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt die aktuelle Anweisung aus und untersucht die Funktion. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-over">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Funktionsschritt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt die aktuelle Anweisung aus und überspringt die Funktion.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-out">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Ausführen bis Rücksprung</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startet die Ausführung des Programms wieder bis zum Ende der Programmausführung.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-move-pc">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Programmzähler verschieben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Verschiebt den Programmzähler zur nächsten Ausführung.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-run-to-cursor">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Bis zum Cursor ausführen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Führt das Programm bis zur aktuellen Cursor-Position aus. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-continue">
<term
><menuchoice
><guimenu
>Debug</guimenu
> <guimenuitem
>Fortsetzen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ignoriert alle Haltepunkte und führt das Programm bis zum erfolgreichen Ende oder zum Absturz aus.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-print-value">
<term
><menuchoice
><guimenu
>Debuggen</guimenu
> <guimenuitem
>Wert anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Gibt den Wert der Variablen unter der aktuellen Cursor-Position.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-toolbar">
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
><guisubmenu
>Angezeigte Werkzeugansichten</guisubmenu
> <guimenuitem
>&gdb;-Erweiterung</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Blendet die Werkzeugleiste der GDB-Erweiterung ein oder aus.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-debug-view">
<title
>Debug-Ansicht</title>

<para
>Die <guilabel
>Debug-Ansicht</guilabel
> besteht aus mehreren Karteikarten: </para>

<variablelist>

<varlistentry>
<term
><guilabel
>&gdb;-Ausgabe</guilabel
></term>
<listitem>
<para
>Enthält die Ausgaben von &gdb; und eine &gdb;-Befehlszeile.</para>

<screenshot id="screenshot-gdb-output">
<screeninfo
>Die Karteikarte „GDB-Ausgabe“</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-output.png" format="PNG"/></imageobject>
<textobject
><phrase
>Die Karteikarte „GDB-Ausgabe“</phrase
></textobject>
<caption
><para
>Die Karteikarte <guilabel
>GDB-Ausgabe</guilabel
> zeigt die Ausgabe einer Debuggersitzung an.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Einstellungen</guilabel
></term>
<listitem>
<variablelist>

<varlistentry>
<term
><guilabel
>Ziel</guilabel
></term>
<listitem
><para
>Pfad zum Ziel (ausführbares Programm) zum Debuggen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Arbeitsordner</guilabel
></term>
<listitem
><para
>Der aktuelle Arbeitsordner des Ziels. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Argumentliste</guilabel
></term>
<listitem
><para
>Argumente, die an das Programm übergeben werden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Aktiviert halten</guilabel
></term>
<listitem
><para
>Behält den Fokus auf der &gdb;-Befehlszeile.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>E/A umleiten</guilabel
></term>
<listitem
><para
>Öffnet eine neue Karteikarte <guilabel
>E/A</guilabel
> in der <guilabel
>Debug-Ansicht</guilabel
>, die die Ausgabe des laufenden Programms zeigt und Eingaben für das Programm ermöglicht.</para
></listitem>
</varlistentry>

</variablelist>

<screenshot id="screenshot-gdb-settings">
<screeninfo
>Die Karteikarte „Einstellungen“</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-settings.png" format="PNG"/></imageobject>
<textobject
><phrase
>Die Karteikarte „Einstellungen“</phrase
></textobject>
<caption
><para
>Die Karteikarte <guilabel
>Einstellungen</guilabel
> zeigt die Einstellungen einer Debuggersitzung an.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>E/A</guilabel
></term>
<listitem>
<para
>Enthält eine Karteikarte für die Ausgabe des laufenden Programms und eine Befehlszeile für Eingaben zum Programm.</para>

<screenshot id="screenshot-gdb-io">
<screeninfo
>Die Karteikarte „E/A“</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-io.png" format="PNG"/></imageobject>
<textobject
><phrase
>Die Karteikarte „E/A“</phrase
></textobject>
<caption
><para
>Die Karteikarte <guilabel
>E/A</guilabel
> mit der Ausgabe eines einfachen Testprogramms.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-other">
<title
>Aufrufstapel und lokale Variablen</title>

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

<screenshot id="screenshot-gdb-call-stack">
<screeninfo
>Die Ansicht des &gdb;-Aufrufstapels</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-call-stack.png" format="PNG"/></imageobject>
<textobject
><phrase
>Die Ansicht des Aufrufstapels.</phrase
></textobject>
<caption
><para
>Die Ansicht <guilabel
>Aufrufstapel</guilabel
> der &gdb;-Erweiterung. </para
></caption>
</mediaobject>
</screenshot>

<para
>Die Ansicht <guilabel
>Lokale Variablen</guilabel
> enthält eine Liste aller zurzeit geladenen Variablen des Programms und die Werte dieser Variablen.</para>

<screenshot id="screenshot-gdb-locals">
<screeninfo
>Die Ansicht „Lokale Variablen“ der &gdb;-Erweiterung</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-locals.png" format="PNG"/></imageobject>
<textobject
><phrase
>Die Ansicht „Lokale Variablen“ der &gdb;-Erweiterung.</phrase
></textobject>
<caption
><para
>Die Ansicht <guilabel
>Lokale Variablen</guilabel
> der &gdb;-Erweiterung. </para
></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="gdb-ack">
<title
>Danksagungen</title>

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

</sect2>

</sect1>

<sect1 id="kate-application-plugin-konsole">
<title
>Werkzeugansicht für Terminal - Werkzeugansicht, die ein Terminal-Element einbettet</title>

<para
><indexterm
><primary
>Terminal-Emulator</primary
></indexterm
> Der eingebaute Terminal-Emulator ist eine Kopie der &kde;-Anwendung &konsole;, er ist durch Wählen von <menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
><guimenuitem
>Terminal anzeigen</guimenuitem
></menuchoice
> aufrufbar und bekommt beim Einschalten den Fokus. Wenn die Option  <link linkend="konsole-config"
>erminal mit aktuellem Dokument abgleichen</link
> eingeschaltet ist, wird das Verzeichnis des Terminal-Emulators in das Herkunftsverzeichnis der aktuellen Datei umgeschaltet, wenn dies möglich ist.</para>

<para
>Die Standardposition ist unten im &kate;-Fenster, unterhalb des Editorfensters.</para>

<para
>Sie können die Einstellungen des Terminal-Emulators durch das mit der rechten Maustaste aufrufbare Kontextmenü erreichen, sehen Sie im <ulink url="help:/konsole/index.htm"
>Handbuch zur &konsole;</ulink
> für weitere Informationen hierzu nach.</para>

<para
>Der eingebaute Terminal-Emulator wird vom Terminal-Modul bereit gestellt. Als Voreinstellung ist dieses Modul aktiviert. </para>

<sect2 id="konsole-menus">
<title
>Menüstruktur</title>

<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-konsole"/>
<menuchoice
><guimenu
>Ansicht</guimenu
><guisubmenu
>Werkzeugansichten</guisubmenu
> <guimenuitem
>Terminal anzeigen</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Schaltet die Anzeige des eingebauten Terminal-Emulators ein und aus.</para>
<para
>Wenn dieser zum ersten Mal aktiviert wird, dann wird ein neuer Terminal-Emulator erzeugt.</para>
<para
>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 <link linkend="konsole-config"
>Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (wenn möglich)</link
> auf  der Seite <guilabel
>Terminal</guilabel
> des <link linkend="config-dialog"
>Enrichtungsdialogs</link
> eingeschaltet ist, wird der Pfad des Terminal-Emulators auf den Pfad des aktiven Dokuments gesetzt, wenn es sich um ein lokales Dokument handelt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Extras</guimenu
><guimenuitem
>An Terminal weitergeben</guimenuitem
></menuchoice
></term>
<listitem
><para
>Gibt den aktuell markierten Text an den eingebauten Terminalemulator. An das Ende des Textes wird kein Zeilenendezeichen angehängt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="tools-sync-terminal-document"/><menuchoice
><guimenu
>Extras</guimenu
> <guimenuitem
>Terminal mit aktuellem Dokument abgleichen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Diese Option bewirkt, dass der eingebaute Terminal-Emulator mit <command
>cd</command
> zum Ordner des aktuellen Dokuments wechselt,</para>

<para
>Alternativ können Sie &kappname; so einstellen, dass das Terminal immer in den Ordner des aktuellen Dokuments wechselt. Weitere Informationen finden Sie unter <xref linkend="konsole-config"/>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="tools-focus-terminal"/><menuchoice
><guimenu
>Extras</guimenu
> <guimenuitem
>Terminal den Fokus geben/entziehen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Schaltet den Fokus vom aktuellen Dokument zum Terminal und zurück. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="konsole-config">
<title
>Einstellungen</title>

<para
>Die Einstellungen für den Terminal-Emulator auf der Seite <guilabel
>Terminal </guilabel
> des <link linkend="configuring-kate"
>Einstellungsdialoges</link
> vornehmen.</para>

<para
>Die folgenden Einstellungen können ausgewählt werden:</para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (sofern möglich)</guilabel
></term>
<listitem
><para
>Diese Option bewirkt, dass der eingebaute Terminal-Emulator  immer mit <command
>cd</command
> 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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Die EDITOR-Umgebungsvariable auf „kate -b“ einstellen</guilabel
></term>
<listitem
><para
>Dies setzt die <envar
>EDITOR</envar
>-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.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

</sect1>

<!--
Missing (according to config docs)
Additional pages for enabled plugins:
Backtrace Browser
Symbol Viewer
-->
</chapter>
