# Benutzerdefinierte Menüs

## Einrichtung

In &kile; können benutzerdefinierte Menüs verwendet werden, die im Hauptmenü von &kile; eingefügt werden. Dieses Menü kann im Einrichtungsdialog von &kile; bearbeitet werden. Wählen Sie dazu Einstellungen Kile einrichten ...Benutzermenü.

Einrichtung des Benutzermenüs
Einrichtung des Benutzermenüs

Es gibt zwei Möglichkeiten, dieses Menü anzuordnen:

- Entweder der Menüeintrag Benutzermenü wird im Hauptmenü zwischen den Menüeinträgen LaTeX und Assistent und der Einrichtungsassistent Benutzermenü bearbeiten im Menü Assistent angezeigt

  Benutzermenü im Hauptmenü
  Benutzermenü im Hauptmenü

- oder beide Einträge werden am Ende des Menüs LaTeX angefügt.

  Benutzermenü als Teil des LaTeX-Menüs
  Benutzermenü als Teil des LaTeX-Menüs

Bereits vorhandene benutzerdefinierte Tags aus früheren &kile;-Versionen werden automatisch in das neue benutzerdefinierte Menu umgewandelt. Diese Tags sind in der Datei `usertags.xml` gespeichert. Wie alle Menüdefinitionsdateien finden Sie diese Dateien im lokalen Benutzermenü-Ordner von &kile;: `KILE_APP_DIR/usermenu/`, &eg; `/home/user/.kde/share/apps/kile/usermenu/`.

Es können mehrere Menüdefinitionsdateien für unterschiedliche Aufgaben benutzt werden. Wählen Sie Assistent Benutzermenü bearbeiten oder LaTeX Benutzermenü bearbeiten, um Menüdefinitionsdateien zu installieren oder zu bearbeiten.

## Assistent

Sie können neue Menüs erstellen oder vorhandene bearbeiten, indem Sie mit Assistent Benutzermenü bearbeiten den Assistenten für das Benutzermenü aufrufen.

Benutzermenü-Assistent
Benutzermenü-Assistent

Auf der linken Seite finden Sie die vorhandene Menüstruktur. Wie im Standardmenü gibt es drei verschiedene Arten von Einträgen:

- Standard-Menüeinträge, denen eine Aktion zugewiesen ist

- Untermenüs, die weitere Menüeinträge enthalten

- Trennlinien zur visuellen Strukturierung aller Einträge.

Um dieses Menü zu bearbeiten, verwenden Sie die sechs Knöpfe links unter der Menüstruktur. Weitere Aktionen erreichen Sie über das Kontextmenü bereits vorhandener Menüeinträge.

Benutzerdefinierte Menüstruktur
Benutzerdefinierte Menüstruktur

Jedem Standardmenüeintrag ist einer von drei Aktionsarten zugewiesen, jede Aktionsart hat andere einstellbare Attribute:

- Text: Mit &kile; können Sie ihre eigenen Tags erstellen. Ein Tag funktioniert etwa wie ein Kurzbefehl, der einen Befehl aufruft oder häufig gebrauchte Texte einfügt, &eg; oft benutzte Sätze wie `Hi, Ich bin eingefügt worden ...`. Dieses Tag Tag wird an der aktuellen Cursor-Position, wenn die Aktion wie oben erläutert aufgerufen wird. Platzhalter können ebenfalls benutzt werden, siehe .

- Datei-Inhalt einfügen: Fügt den gesamten Inhalt einer angegeben Datei ein.

  Datei-Inhalt einfügen
  Datei-Inhalt einfügen

- Externes Programm ausführen Die Ausgaben des Programms können in das geöffnete Dokument eingefügt werden. Der Platzhalter `%M` ist auch in der Befehlszeile des Programms verfügbar, da der markierte Text in einer temporären Datei gespeichert wird. Verwenden Sie `%M` als Dateinamen für diese temporäre Datei.

  Externes Programm ausführen
  Externes Programm ausführen

Sollten wichtige Informationen für eine Aktion fehlen, werden Menüeinträge in roter Farbe dargestellt. Es kann eine nicht vorhandene Datei sein

Nicht vorhandene Datei
Nicht vorhandene Datei

oder ein fehlender Titel eines Menüeintrags, was mit Fragezeichen wie `???` angezeigt wird.

Fehlender Titel eines Menüeintrags
Fehlender Titel eines Menüeintrags

Öffnen Sie das Kontextmenü eines rot angezeigten Menüeintrags, erhalten Sie zusätzliche Informationen über die Fehler.

Zusätzliche Informationen
Zusätzliche Informationen

Weitere Informationen für die meisten Elemente finden Sie in der entsprechenden Was ist das?-Hilfe.

## Platzhalter

### Text einfügen

Es gibt einige Platzhalter, die Sie in benutzerdefinierten Tags verwenden können: `%C`, `%B`, `%M`, `%E`, `%R` und `%T`.

- `%C`: An diese Stelle wird der Cursor nach dem Einfügen des benutzerdefinierten Tags gesetzt.

  Cursor-Position (%C)
  Cursor-Position (%C)

- `%B`: wird durch eine Sprungmarke ersetzt (siehe ).

  Sprungmarke (%B)
  Sprungmarke (%B)

- `%M`: wird durch den ausgewählten Text ersetzt.

  Ausgewählter Text (%M)
  Ausgewählter Text (%M)

- `%E`: Bestimmt die Einrückungstiefe von Text in einer Umgebung.

  Einrückung von Umgebungstext (%E)
  Einrückung von Umgebungstext (%E)

- `%R`: öffnet einen Referenzdialog, in dem Sie ein bereits vorher definiertes Label wählen können. Die kann benutzt werden, um eine Referenz zu einem bereits definierten aus einem Auswahlfeld auszusuchen , siehe auch LaTeX Referenzen ref oder LaTeX Referenzen pageref).

  Referenzen (%R)
  Referenzen (%R)

- `%T`: öffnet den Zitierungsdialog auf, um eine bereits definierte Zitierung zu wählen. Wie mit LaTeX Referenzen cite wird ein Dialog mit allen Zitierungsschlüsseln zur Auswahl angeboten.

  Zitierung (%T)
  Zitierung (%T)

Betrachten Sie ein Makro wie zum Beispiel `\frac{%M}{%C}`. Zuerst wird eine Zahl im Text ausgewählt, zum Beispiel `42`. Wird nun das Makro aufgerufen, wird `\frac{42}{}` eingefügt und der Cursor steht im zweiten Klammerpaar.

### Datei-Inhalt einfügen

Wenn Sie den Inhalt einer Textdatei einfügen möchten, können Sie den gleichen Platzhalter verwenden.

### Ein Programm ausführen

Möchten Sie ein externes Programm ausführen, dann wird nur der Platzhalter `%M` für eine Textauswahl in der Befehlszeile erkannt. Die Auswahl wird in einer temporären Datei gespeichert und der Platzhalter `%M` durch diesen Dateinamen ersetzt.

Ein externes Programm ausführen (%M)
Ein externes Programm ausführen (%M)

Ein weiterer Platzhalter ist `%S`, er wird durch den Basisnamen des aktuellen Dokuments ohne den Pfad ersetzt. Der Basisname enthält alle Zeichen im Dateinamen bis auf das letzte „.“-Zeichen, das ausgeschlossen ist.

## Parameter

Die meisten Menüeinträge können zusätzliche selbsterklärende Parameter haben, die aktiviert sein können. Sind einige dieser Parameter für eine bestimmte Aktion nicht verfügbar, dann sind die Ankreuzfelder deaktiviert.

Parameter in Benutzermenüs
Parameter in Benutzermenüs

Hier ist ein Beispiel für die Ausführung eines externen Programms:

Parameter-Beispiel
Parameter-Beispiel

Im oben gezeigten Bildschirmfoto wird ein `perl`-Skript aufgerufen, dass die aktuelle Auswahl bearbeitet. Der Parameter Benötigt eine Textauswahl ist aktiviert, um sicherzustellen, dass Text ausgewählt wurde. Die Ausgabe dieses Skripts wird eingefügt (Ausgabe des gewählten Programms einfügen) und ersetzt die aktuelle Auswahl (Ausgewählten Text ersetzen), ist dann aber nicht ausgewählt.

Natürlich können Sie auch Ihre eigenen Programme und Skripte starten. Wählen Sie zum Beispiel eine durch Leerzeichen getrennte Liste von Zahlen und starten dann ein Skript oder Perl-Programm, das diese Auswahl in &latex;-Quelltext für eine Matrix umwandelt. Sie können beliebige Ideen mit Einträgen im Benutzermenü umsetzen.

Parameter-Beispiel 2
Parameter-Beispiel 2

## Menüdefinitionsdateien

Während der Ausführung von &kile; können Sie mehrere Menüs für verschiedenen Aufgaben laden. Wenn Sie den Benutzermenü-Assistenten aufrufen, wird die aktuelle Menüdefinitionsdatei geladen. Wenn Sie sie bearbeiten und auf OK drücken, werden Ihre Änderungen gespeichert und als neues Benutzermenü installiert. Schließen Sie den Dialogs mit Abbrechen verwirft alle Änderungen.

Menüdefinitionsdateien
Menüdefinitionsdateien

Sie können die geänderte Datei aber auch im Ordner für Benutzermenüs speichern oder einen andere Menüdefinitionsdatei laden und installieren. Alle Menüdefinitionsdateien müssen im lokalen Ordner für Benutzermenüs von &kile; gespeichert werden: `KILE_APP_DIR/usermenu/`.

Im Beispiel einer Menüdefinitionsdatei `example.xml` finden Sie weitere Menüeinträge mit deren Parametern.