# Starting Caja-Actions Configuration Tool

You can start Caja-Actions Configuration Tool in the following ways:

System menu

- Choose Preferences Look and Feel Caja-Actions Configuration Tool.

Befehlszeile

- To start Caja-Actions Configuration Tool from a command line, type the following command:

  ``caja-actions-config-tool``

  then press Return.

  Um die verfügbaren Befehlszeilenoptionen anzuzeigen, rufen Sie folgendes Argument auf:

  ``caja-actions-config-tool` `--help-all``

  then press Return.

## Der erste Start

When you start Caja-Actions Configuration Tool, the following window is displayed.

### Caja-Actions Configuration Tool Start Up Window

Shows Caja-Actions Configuration Tool main window. Contains menubar, toolbar, display area, an empty items list in the left, several disabled properties tabs, and statusbar.

The Caja-Actions Configuration Tool main window contains the following elements:

Menüleiste.

- The menus on the menubar contain all of the commands you need to use in Caja-Actions Configuration Tool.

  Für einige Befehle sind Schnellzugriffe verfügbar:

  Strg N

- Eine neue Aktion hinzufügen.

Strg S

- Geänderte Aktionen und Menüs speichern

Strg Q

- Die Anwendung beenden.

Strg X

- Die aktuelle Auswahl ausschneiden, jedoch in der Zwischenablage behalten.

Strg C

- Die aktuelle Auswahl in die Zwischenablage kopieren.

Strg V

- Den Inhalt der Zwischenablage vor der aktuellen Position einfügen.

Umschalttaste Strg V

- Den Inhalt der Zwischenablage als Unterelement(e) des aktuellen Objekts einfügen.

Entf

- Die momentane Auswahl löschen.

F5

- Aktionen und Menüs neu laden.

F1

- Hilfe anzeigen.

Werkzeugleiste.

- Several toolbars may be displayed below the menubar, depending of your choices in the View Toolbars submenu.

Objektliste.

- The list on the left of the main window contains all items, whether they are actions or menus, currently available for edition in Caja-Actions Configuration Tool.

  Objekte können in alphabetischer oder umgekehrter alphabetischer Reihenfolge sortiert werden. Eine unsortierte Anzeige ist ebenfalls möglich, so dass der Benutzer die Objekte direkt selbts sortieren und verwalten kann.

  Ungültige Einträge werden in roter Farbe dargestellt.

  Geänderte Objekte werden in kursiver Schrift dargestellt.

Sortierknöpfe

- Drei Knöpfe ermöglichen Ihnen das Umschalten zwischen den Sortierungsmodi.

Reiter für Eigenschaften.

- Im rechten Teil des Hauptfensters wird alles angezeigt, was zum Definieren benötigt wird, wie, wann und wo Menüs angezeigt werden sollen.

  Aktion/Menü

- Define in which Caja menus the item should appear, and how it will be displayed.

Befehl

- Legen Sie fest, welcher Befehl ausgeführt wird und welche Parameter übergeben werden sollen.

Ausführung

- Geben Sie an, wie der Befehl ausgeführt werden soll.

Basisnamen

- Define the basename filters the Caja selection must satisfy in order the action or menu be candidate for display.

MIME-Typen

- Define the mimetype filters the Caja selection must satisfy in order the action or menu be candidate for display.

Ordner

- Define the folder filters the Caja selection must satisfy in order the action or menu be candidate for display.

Schemata

- Define the scheme filters the Caja selection must satisfy in order the action or menu be candidate for display.

Fähigkeiten

- Define the capability filters the Caja selection must satisfy in order the action or menu be candidate for display.

Umgebung

- Define some environment conditions the Caja selection must satisfy in order the action or menu be candidate for display.

Eigenschaften

- Eigenschaften eines Objekts anzeigen.

Statuszeile.

- Die Statuszeile zeigt einige Statusinformationen über die aktuell ausgewählte Zeile in der Objektliste an.

  Wenn keine relevanten Informationen zur Anzeige vorhanden sind, dann zeigt die Statuszeile die Anzahl der geladenen Menüs, Aktionen und Profile an.

  The « read-only » icon is displayed in the right of the statusbar when appropriate.

## Erstellen Ihrer ersten Aktion

In diesem Beispiel erstellen wir eine Aktion, die einige nützliche Informationen über die aktuelle Auswahl zur Verfügung stellt.

## Überprüfen der Voraussetzungen

This action will require MateDialog.

MateDialog is a program which will allow you to create a graphical user interface from a command-line.

Sie sollten sicherstellen, dass dieses Programm auf Ihrem System installiert ist, indem Sie beispielsweise folgenden Befehl in einem Terminal aufrufen:

``matedialog``

then press Return.

## Erstellen der Aktion

To create a new action, choose Ctrl N File New action.

Eine neue Aktion wird in die Objektliste eingefügt und deren Eigenschaften werden in den Reitern im rechten Teilfenster angezeigt.

Die Bezeichnung der aktuell ausgewählten Aktion (dieses) wird zum Anwendungsnamen in der Titelleiste hinzugefügt.

### Vorgegebenen Eigenschaften einer neuen Aktion

Zeigt die vorgegebenen Eigenschaften einer neu erstellten Aktion.

In the Items list, the new action is displayed in italic characters.

Kursivschrift wird verwendet, um den Benutzer daran zu erinnern, dass das Objekt noch nicht gespeichert wurde.

As another reminder that there is some pending modifications, an asterisk (« `*` ») comes to prefix the application name in the title bar.

## Charakterisieren Ihrer neuen Aktion

Im Wesentlichen geht es hierbei darum, wie Ihre Aktion in den Kontextmenüs des Dateimanagers angezeigt wird.

- Enter `My first action` in the Context label entry box.

  The Context label entry box contains the label of the action as you want it to be displayed in the file manager context menu.

  The label is a mandatory property of your action. If it happens to be empty, then your action will be considered as invalid by Caja-Actions: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

- Enter `This will execute an action with some parameters` in the Tooltip entry box.

  The Tooltip entry box contains the text you want to be displayed as a short help to your action.

- Select in the Icon drop-down list.

  The Icon selection defines the icon which will be associated with your action in file manager context menus and in the toolbar.

  Sie haben zwei Möglichkeiten, Ihrer Aktion ein Symbol zuzuordnen:

  - Click on the Icon drop-down list to select an icon.

  - Click on Browse to search for an image in the filesystem.

## Angeben des auszuführenden Befehls

Wenn Sie Ihre Aktion im Kontextmenü des Dateimanagers auswählen, wird dieser Befehl mit den von Ihnen angegebenen Argumenten ausgeführt.

Click on the Command tab to show the page which will permit you to enter the command.

### Reiter »Befehl«

Zeigt den Reiter »Befehl«. Dieser Reiter enthält den Namen des Profils, den auszuführenden Befehl einschließlich dessen Parameter sowie die Konfiguration des anfänglichen Arbeitsordners.

- Enter `matedialog` in the Path entry box.

  The Path entry box defines the command which will be executed when you will select your action in the file manager context menu.

  Es gibt zwei Möglichkeiten, den auszuführenden Befehl festzulegen:

  - Enter it in the Path entry box.

  - Click on Browse to select the executable file on the filesystem.

  If the command you enter does not have an absolute path, then it will be searched for in the `PATH` variable at execution time.

- Enter `--info --text='%c selected item(s): %U'` in the Parameters entry box.

  The Parameters contains the arguments which will be passed to your command when it will be executed. These arguments may embed parameters which will be expanded at runtime.

  If both Path and Parameters are empty, then this action will be considered as invalid: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

## Speichern

To save all pending modifications, choose Ctrl S File Save.

Caja automatically takes into account your new action, and displays it in its context menu.

### Your first action in the Caja context menu

Shows the first action in the Caja context menu.

Cliking of the item in the Caja context menu activates it, and executes the corresponding command.

### Das Ergebnis der Ausführung Ihrer ersten Aktion

Shows the result of the execution of your first action. This is MateDialog dialog box, displaying the URI of the selected item.