# Benutzeraktionen

Mit ActionMan können Sie Benutzeraktionen erstellen, einrichten und verwalten. Einige allgemeine Einstellungen werden mit Konfigurator eingestellt. Mit Benutzeraktionen können Sie Aktionen für Dateien im Dateifenster ausführen und haben Zugriff auf die internen Funktionen von &krusader; mit Parametern die direkt Platzhalter verwenden. Die Aktionen integrieren sich nahtlos in das Aktionensystem von &plasma;, daher sind Benutzeraktionen auch in den normalen Bearbeitungsdialogen für Kurzbefehle und Werkzeugleisten vorhanden. Die Benutzeraktionen werden in `~/.local/share/krusader/useraction.xml` gespeichert. Mehrere Beispiele werden mit der Dokumentation ausgeliefert. Benutzeraktionen können durch ActionMan bearbeitet, hinzugefügt, importiert und exportiert werden. Die Standard-Benutzeraktionen werden in `~/.local/share/krusader/useractions.xml` oder `krusader/useraction.xml` im Ordner gespeichert, der mit dem Befehl `qtpaths --paths GenericDataLocation` ermittelt wird. Benutzeraktionen können überall da benutzt werden, wo auch normale KActions eingesetzt werden können. Die Aktionen können sogar in das Menü aufgenommen werden, aber dafür muss die Datei `krusaderui.rc` bearbeitet werden.

- Das Menü Benutzeraktionen

- Aktionsmenü

- Aktionen-Werkzeugleiste

- Kontextmenüs mit der &RMBn;

- &etc;

&krusader;s Benutzeraktionen sind sehr leistungsfähig und lassen sich gut anpassen, wenn Sie sich allgemein mit dem Schreiben von Benutzeraktionen auskennen.

Mehrere Benutzeraktionen werden standardmäßig installiert. Bitte laden Sie ihre beliebtesten Benutzeraktionen hoch, so dass sie auch von anderen &krusader;-Benutzern verwendet werden können. Danke.

## ActionMan

ActionMan

Im wesentlichen sind Benutzeraktionen Methoden um externe Programme mit variablen Parametern aufzurufen. Sie können zum Beispiel eine Benutzeraktion wie `xmms `--enqueue %aList("Selected")%`` benutzen, um alle gewählten Einträge im aktiven Dateifenster zur aktuellen Instanz von xmms mit der Option enqueue zu übergeben. Zusätzlich gibt es einen begrenzten Zugriff auf die internen Funktionen von &krusader; mit Parametern. Zum Beispiel wird der Befehl `%aPanelSize("80")%` die Breite des aktiven Dateifensters auf 80 % der Breite des Hauptfensters von &krusader; setzen. Da Parameter für Platzhalter auch andere Platzhalter enthalten können, sind sogar einige Skripte möglich.

Benutzerdefinierte Aktionen verwalten

Öffnen Sie den Einrichtungsdialog und klicken auf der Seite Benutzeraktionen auf ActionMan starten oder wählen Sie im Menü Benutzeraktionen Benutzeraktionen verwalten. Damit wird ein Dialog geöffnet, in dem Sie Benutzeraktionen hinzufügen, bearbeiten, löschen, importieren und exportieren können.

- Aktion hinzufügen: Wenn Sie eine Aktion hinzufügen, wird eine leere Eingabemaske angezeigt, in die Sie alle gewünschten Eigenschaften eintragen können. Die Aktion wird hinzugefügt, wenn Sie den Knopf Anwenden drücken. Der Name der Aktion wird dann links in der Liste angezeigt.

- Bearbeiten einer Aktion: Wählen Sie eine Aktion links aus und bearbeiten Sie die Eigenschaften, Die Änderungen werden nur übernommen, wenn Sie den Knopf Anwenden drücken.

- Ausgewählte Benutzeraktion löschen: Wählen Sie links eine Aktion aus und klicken Sie auf den Knopf .

- Benutzeraktionen importieren: Importieren Sie einige Aktionen, werden Sie automatisch zu Ihrer Liste hinzugefügt. Namen müssen eindeutig sein, da sie als Kennung für &plasma;s-Aktionssystem gebraucht werden. Gibt es einen Namenskonflikt, müssen Sie ihn auflösen. Dazu wird in der Liste links die Aktionen angezeigt, für die es Konflikte gibt. Sie können jetzt neue Namen vergeben oder eins der Duplikate löschen.

- Benutzeraktionen exportieren: Wenn Sie eine Benutzeraktion exportieren, müssen Sie einen Dateinamen zum Speichern angeben. Existiert die Datei noch nicht wird sie erstellt. Enthält die Datei bereits Benutzeraktionen, werden die exportierten Aktionen zur Datei hinzugefügt.

Alle definierten Aktionen werden im Menü Benutzeraktion und in den &plasma;Dialogen zur Einrichtung der Kurzbefehle und der Werkzeugleisten. Zusätzlich werden alle Aktionen für den aktuellen Eintrag auch im Kontextmenü angezeigt.

Allgemeine Eigenschaften

Bezeichner, Titel und Befehl sind immer erforderlich, alle anderen Eigenschaften sind optional.

- Bezeichner: Ein eindeutiger Name der Benutzeraktion, wird zur Identifizierung im &plasma;-Aktionssystem benutzt.

- Knopf Symbol: Das Symbol für Ihre Benutzeraktion.

- Kategorie: Benutzeraktionen können zur besseren Übersicht in Kategorien eingeteilt werden. Diese Kategorien erscheinen als Untermenüeinträge im Menü Benutzeraktionen.

- Titel: Der Text in diesem Eingabefeld wird in Menüs oder Dialogen angezeigt.

- Kurzinfo: Eine Kurzinfo für Ihre Benutzeraktion, die ⪚ in der Werkzeugleiste beim Überfahren mit dem Mauszeiger angezeigt wird.

- Beschreibung: Eine Beschreibung der Funktion der Benutzeraktion. Diese Beschreibung wird ebenfalls als Was ist das?-Hilfe angezeigt, wenn Sie die Tastenkombination &Shift; F1 für eine aktive Benutzeraktion drücken.

- Befehl: Der auszuführende Befehl. Hier können auch Platzhalter mit einer grafischen Benutzerschnittstelle eingefügt werden, drücken Sie dazu Hinzufügen.

- Arbeitsordner. Der Arbeitsordner für den ausgeführten Befehl.

- Ausführungsmodus

  - Normal: Der normale Ausführungsmodus.

  - Im Terminal ausführen: Führt den Befehl im Terminal aus.

  - Im eingebetteten Terminal-Emulator ausführen: Führt den Befehl im eingebetteten Terminal-Emulator aus.

  - Ausgabe einfangen: Sammelt die Ausgabe des ausgeführten Programms und zeigt sie in einem Fenster an.

  - Standardfehler separat: Wenn Ausgabe einfangen verwendet wird, werden die Standardausgabe (stdout) und Standardfehler (stdout) getrennt gesammelt.

- Befehl akzeptiert

  - Lokale Dateien (keine Adressen): Stellt ein, dass der Platzhalter nur lokale Adressen zurückgeben soll.

  - Adressen (entfernte und lokale): Legt fest, dass der Platzhalter Adressen zurückgeben soll.

- Standard-Kurzbefehl: Zur Einstellung des Kurzbefehls für die Benutzeraktion.

- Aktiviert: Ist die aktiv, wird die Benutzeraktion im Menu Benutzeraktionen angezeigt, sonst ist diese Aktion ausgeblendet.

Syntax der Befehlszeile

Im wesentlichen wird alles, was Sie in der Befehlszeile eingeben, ausgeführt. Geben Sie zum Beispiel ls -l ein, wird ls -l wie in einer Konsole ausgeführt. Sie können eine Zeichenfolge von &krusader; erhalten, der den aktuellen Status des Dateifensters repräsentiert. Die geschieht mit Platzhaltern. Ein Platzhalter beginnt mit einen Prozentzeichen ('%'), gefolgt von einem Indikator für das Dateifenster, 'a' für das aktive, 'o' für das andere, 'l' für das linke und 'r' für das rechte Dateifenster. Benötigt ein Platzhalter kein Dateifenster zur Ausführung, müssen Sie dies durch einen Unterstrich ('_') anzeigen. Dann kommt der Name des Platzhalters wie in der folgenden Liste, an den auch Parameter in Anführungszeichen angehängt werden können. Schließlich kommt zu Abschluß wieder ein Prozentzeichen.

Dies kling sehr kompliziert, daher ein Beispiel: '%aList("Selected")%' wird durch eine Liste aller ausgewählten Einträge im aktiven Dateifenster ersetzt. Ein Befehl wie 'xmms --enqueue %aList("All", " ", "", "*.mp3")%' führt xmms mit einer Liste aller .mp3-Dateien im aktuellen Dateifenster aus, getrennt durch ein einzelnes Leerzeichen.

Zurzeit können diese Platzhalter verwendet werden:

- `Pfad` - wird durch den Pfad des Dateifensters ersetzt

  1. Parameter (optional): Automatisch Leerzeichen maskieren. Standard: ja

- `Anzahl` - wird durch die Zahl des <ersten Parameters> ersetzt

  1. Parameter: Welche Einträge, entweder All, Selected, Files oder Dirs

- `Filter` - wird durch die Filtermaske des Dateifensters ersetzt

- `Aktuell` - wird durch den aktuellen Eintrag ersetzt

  1. Parameter (optional): Aktuellen Pfad weglassen. Standard: nein

  2. Parameter (optional): Automatisch Leerzeichen maskieren. Standard: ja

- `List` - wird durch eine Liste aller <ersten Parameter> ersetzt

  1. Parameter: Welche Einträge, entweder All, Selected, Files oder Dirs

  2. Parameter (optional): Trennzeichen zwischen Einträgen. Standard:

  3. Parameter (optional): Aktuellen Pfad weglassen. Standard: nein

  4. Parameter (optional): Filtermaske (für alle bis auf Selected). Standard: *

  5. Parameter (optional): Automatisch Leerzeichen maskieren. Standard: ja

- `Select` - verändert die Auswahl in einem Dateifenster

  1. Parameter: Filtermaske

  2. Parameter (optional): auf welche Art verändern, entweder Set, Add oder Remove. Standard: Set

- `Goto` - Ändert den Pfad des Dateifensters auf <ersten Parameter>

  1. Parameter: Ein relativer oder absoluter Pfad oder eine &URL;

  2. Parameter (optional): Öffnet den Ort in einem neuen Unterfenster. Standard: nein

- `Ask` - Fragt den Benutzer nach Text und wird durch dessen Antwort ersetzt

  1. Parameter: Die Frage

  2. Parameter (optional): Eine Standardantwort

  3. Parameter (optional): Eine Überschrift für das Fragenfenster

- `Zwischenablage` - bearbeitet die Zwischenablage

  1. Parameter: Der Text, der in die Zwischenablage eingefügt werden soll. Sie können hier %aCurrent% verwenden

  2. Parameter (optional): Hängt den aktuellen Inhalt der Zwischenablage mit diesen Trennzeichen an

- `Kopieren` - kopiert eine Datei, nützlich für schnelle lokale Sicherungen

  1. Parameter: Das zu kopierende Element

  2. Parameter: Das Ziel des Kopierens

- `Sync` - Öffnet den Abgleich mit einem angegebenen Profil

  1. Parameter: ein Profil für das Abgleichen

- `NewSearch` - Profil das Suchfenster mit einem angegebenen Profil

  1. Parameter: Ein Profil für das Suchmodul

- `Profil` - lädt ein angegebenes Dateifenster-Profil

  1. Parameter: Ein Dateifenster-Profil

- `Each` - Teilt die Befehlszeile in eine Liste. Die Befehle in der Liste werden dann nacheinander ausgeführt.

  1. Parameter: Ein Listeneintrag (all, all files, all dirs, all selected).

- `Verschieben` - verschiebt von Quelle zu Ziel.

  1. Parameter: Eine Quelle

  2. Parameter: Ein Ziel

- `PanelSize` - Ändert das Verhältnis zwischen den beiden Dateifenstern.

  1. Parameter (optional): Ein ganzzahliger Wert ⪚ mit 80 benutzt das aktive Dateifenster 80 % der Breite des &krusader;'-Fensters, bzw der Höhe im senkrechten Modus. Kein Parameter bedeutet 50 %.

- `Ask` - Abbruch der Ausführung.

  1. Parameter (optional): Ein Text für die Abbrechen-Frage.

- `ListFile` - wird durch den Pfad bzw. den Dateinamen einer temporären Datei ersetzt, die eine Liste mit Elementen enthält

  1. Parameter: Pfad/Dateiname

- `ColSort` - legt die Sortierung einer Spalte in einem angegebenen Dateifenster fest.

  1. Parameter Spalte: entweder Name, Erw, Dateityp, Größe, Geändert, Berechtigungen, rwx, Eigentümer oder Gruppe

  2. Parameter: Sortiersequenz: Entweder Toggle, Asc, Desc

- `Ansicht` - stellt den Ansichtsmodus ein.

  1. Parameter: Ansichtsmodus: Entweder generic, text, hex

  2. Parameter: Fenstermodus: Entweder tab, window

Es gibt eine grafische Hilfe, um Platzhalter einzufügen. Leerzeichen in Path, Current und List werden als Standard automatisch maskiert. Etwas wichtiges ist noch zu beachten: Alle Platzhalter für &krusader;s interne Funktionen werden beim Expandieren aufgerufen, d. h. direkt die Platzhalter ersetzt werden. Externe Programme werden zur Ausführungszeit aufgerufen, d. h. nachdem alle Platzhalter ersetzt wurden.

Erweiterte Eigenschaften

Hier können Sie einstellen, wann Ihre Aktionen im Kontextmenü angezeigt werden und dafür Protokoll, MIME-Typ, Pfad und Dateiname festlegen. Sie können sich außerdem einen Befehl vor der Ausführung nochmal anzeigen lassen, um ihn eventuell anzupassen. Falls die Aktion als anderer Benutzer ausgeführt werden soll, können Sie ihn hier eingeben.

- Legt fest, ob die Aktion für ein Protokoll, Pfad, &MIME;-Typ oder einen Dateinamen gültig ist.

- Bearbeitung der Befehlszeile ehe sie ausgeführt wird.

- Legt einen anderen Benutzer für die Ausführung fest, das hat keine Auswirkung auf die internen Funktionen von &krusader;