# FileManager-Actions configuration tool User's Manual

2010 2011 2012 2013 2014 2015 Pierre Wieser

FileManager-Actions is a file manager extension whose principal function is to allow the user to add arbitrary actions to the file manager context menus. These actions may be organized in menus and submenus, exported and shared with other desktop environments.

This manual describes the FileManager-Actions configuration tool user interface, and explains how you may configure your menus and actions, making them be displayed and applied depending on specific conditions.

This manual describes version 3.4 of FileManager-Actions configuration tool.
GNOME-Dokumentationsprojekt
Pierre Wieser pwieser@trychlos.org
FileManager-Actions configuration tool User's Manual v 3.1
May 2011

Pierre Wieser pwieser@trychlos.org

FileManager-Actions configuration tool User's Manual v 3.2
January 2012

Pierre Wieser pwieser@trychlos.org

FileManager-Actions configuration tool User's Manual v 3.4
September 2015

Pierre Wieser pwieser@trychlos.org

Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free Documentation License (GFDL), Version 1.3 oder jeder späteren, von der Free Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt und/oder modifiziert werden. Eine Kopie der GFDL finden Sie unter diesem Link oder in der mit diesem Handbuch gelieferten Datei COPYING-DOCs.

Das vorliegende Handbuch ist Teil einer Reihe von GNOME-Handbüchern, die unter der GFDL verteilt werden. Wenn Sie dieses Handbuch separat verteilen möchten, können Sie dies tun, indem Sie dem Handbuch eine Kopie der Lizenz, wie in Abschnitt 6 der Lizenz beschrieben, hinzufügen.

Bei vielen der von Firmen zur Unterscheidung ihrer Produkte und Dienstleistungen verwendeten Namen handelt es sich um Marken. An den Stellen, an denen derartige Namen in einer GNOME-Dokumentation vorkommen und wenn die Mitglieder des GNOME-Dokumentationsprojekts über diese Marken informiert wurden, sind die Namen in Großbuchstaben oder mit großen Anfangsbuchstaben geschrieben.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

## Einführung

FileManager-Actions is a file manager extension whose principal function is to allow the user to add arbitrary actions to the file manager context menus. These actions may be organized in menus and submenus, exported and shared with other desktop environments.

The FileManager-Actions configuration tool application is the user interface which lets you precisely configure how, where and when your actions should appear in the file manager context menus, and how they will be executed.

FileManager-Actions configuration tool provides the following features:

- Definieren und Konfigurieren von Aktionen von Null an.

- Organisieren von Aktionen in Menüs und Untermenüs usw.

- Importieren und Exportieren von Aktionen aus der und in die Welt außerhalb Ihrer Arbeitsumgebung.

FileManager-Actions bringt noch weitere Funktionen mit, wie beispielsweise:

- A tracker plugin which exports in real time to D-Bus the currently selected files.

- Ein Befehlszeilenprogramm, das fähig ist, irgendeine Aktion auszuführen.

  Im Zusammenspiel mit der D-Bus-Schnittstelle kann der Benutzer jede Aktion über ein Tastenkürzel ausführen, wodurch die Aktion auf die aktuell im Dateimanager ausgewählten Objekte angewendet wird.

- Ein Befehlszeilenprogramm, welches in der Lage ist, eine neue Aktion zu starten.

Alle diese Funktionsmerkmale werden eingehend in der globalen Dokumentation des FileManager-Actions Konfigurationswerkzeugs beschrieben.

Starting with the version 3.4, FileManager-Actions is compatible with both Nautilus and Nemo file-managers.

## Erste Schritte

### Starting FileManager-Actions configuration tool

You can start FileManager-Actions configuration tool in the following ways:

Menü System

  Choose Preferences Look and Feel FileManager-Actions Configuration Tool .

Befehlszeile

  To start FileManager-Actions configuration tool from a command line, type the following command:

  ``fma-config-tool``

  und drücken dann die Eingabetaste.

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

  ``fma-config-tool` `--help-all``

  und drücken dann die Eingabetaste.

### Der erste Start

When you start FileManager-Actions configuration tool, the following window is displayed.

FileManager-Actions configuration tool Start Up Window

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

The empty FileManager-Actions configuration tool main window

The FileManager-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 FileManager-Actions configuration tool.

  Für einige Befehle sind Schnellzugriffe verfügbar:

  Ctrl N

    Eine neue Aktion hinzufügen.

  Ctrl S

    Geänderte Aktionen und Menüs speichern

  Ctrl Q

    Die Anwendung beenden.

  Ctrl X

    Die aktuelle Auswahl ausschneiden, jedoch in der Zwischenablage behalten.

  Ctrl C

    Die aktuelle Auswahl in die Zwischenablage kopieren.

  Ctrl V

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

  Shift Ctrl V

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

  Delete

    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 FileManager-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 file manager 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 file manager selection must satisfy in order the action or menu be candidate for display.

  MIME-Typen

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

  Ordner

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

  Schemata

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

  Fähigkeiten

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

  Umgebung

    Define some environment conditions the file manager 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

Diese Aktion benötigt Zenity.

Zenity ist ein Programm, das Ihnen die Erstellung grafischer Oberflächen über die Befehlszeile ermöglicht.

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

``zenity``

und drücken dann die Eingabetaste.

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

Shows the default properties of a newly created action.

Default properties of a new action

In der Objektliste wird die neue Aktion in kursiver Schrift dargestellt.

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.

- Geben Sie `Meine erste Aktion` im Eingabefeld Bezeichnung des Kontextmenüeintrages ein.

  Das Eingabefeld Bezeichnung des Kontextmenüeintrages enthält die Bezeichnung der Aktion, so wie Sie im Kontextmenü des Dateimanagers erscheinen soll.

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

- Geben Sie `Es wird eine Aktion mit einigen Parametern ausgeführt` in das Eingabefeld Minihilfe ein.

  Im Eingabefeld Minihilfe können Sie einen Text eingeben, der als kurze Hilfe zu Ihrer Aktion angezeigt wird.

- Wählen Sie in der Auswahlliste Symbol.

  Die Symbol-Auswahl legt das Symbol fest, das Ihrer Aktion in den Kontextmenüs des Dateimanagers und in der Werkzeugleiste zugeordnet wird.

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

  - Klicken Sie in die Auswahlliste Symbol, um ein Symbol auszuwählen.

  - Klicken Sie auf Durchsuchen, um im Dateisystem nach einer Bilddatei zu suchen.

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.

Klicken Sie auf den Reiter Befehl, um einen Befehl eingeben zu können.

Reiter »Befehl«

Shows the Command tab. This tab contains the name of the profile, the command to be executed along with its parameters, and the configuration of the starting working directory.

Command page

- Geben Sie `zenity` in das Eingabefeld Pfad ein.

  Das Eingabefeld Pfad legt den Befehl fest, der ausgeführt wird, wenn Sie diese Aktion in den Kontextmenüs des Dateimanagers auswählen.

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

  - Geben Sie ihn in das Eingabefeld Pfad ein.

  - Klicken Sie auf Durchsuchen, um im Dateisystem nach einer ausführbaren Datei zu suchen.

  Falls Sie den Befehl ohne absoluten Pfad eingeben, wird zur Ausführungszeit in der Variable `PATH` danach gesucht.

- Geben Sie `--info --text='%c ausgewählte(s) Element(e): %U'` in das Eingabefeld Parameter ein.

  Die Parameter enthalten die Argumente, die bei der Ausführung dem Befehl übergeben werden sollen. In diesen Argumente können eingebettete Parameter enthalten sein, die zur Ausführung expandiert werden.

  Wenn sowohl Pfad als auch Parameter leer sind, dann wird Ihre Aktion als ungültig erkannt: Sie wird in roter Farbe in der Objektliste angezeigt und nie für die Anzeige in den Kontextmenüs des Dateimanagers in Betracht gezogen.

Speichern

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

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

Your first action in the file manager context menu

Shows the first action in the file manager context menu.

Your first action in the file manager context menu

Cliking of the item in the file manager 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 Zenity dialog box, displaying the URI of the selected item.

The result of the execution of your first action

## Using FileManager-Actions configuration tool

### Definieren der Bedingungen

Whether your action will eventually be displayed in the file manager context menus or in its toolbar depends on the conditions you will have defined for it.

Diese Bedingungen können sich auf den Ort beziehen, an dem der Dateimanager gerade geöffnet ist oder auf die aktuell ausgewählten Objekte an diesem Ort.

Bei jeder Änderung des Ortes oder der ausgewählten Dateien prüft FileManager-Actions alle Ihre Aktionen und vergleicht sie mit den definierten Bedingungen hinsichtlich des neuen Ortes und der Dateiauswahl. Alle Bedingungen müssen erfüllt sein, damit Ihre Aktion tatsächlich angezeigt wird.

For now, all managed file managers have removed this API from their extension library. The toolbar is still configurable in FileManager-Actions, but is will not be honored by any of the targeted file managers.

#### Auf dem Basisnamen basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den Basisnamen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss ein gewisser Teil der Basisnamen der Objekte übereinstimmen, wobei Sie außerdem gleichzeitig festlegen können, dass ein weiterer Basisnamenteil nicht in den gewählten Objekten vorkommen darf.

Klicken Sie auf den Reiter Basisnamen, um die auf Basisnamen basierenden Bedingungen zu konfigurieren.

Auf dem Basisnamen basierende Bedingungen

Shows the tab which lets you define basename-based conditions.

The basename-based conditions tab

In fact, basename-based conditions are built as a list of « must match one of » and « must not match any of » patterns. In order for your action to be a candidate regarding these basename-based conditions, each element of the selection must be valid for all the listed conditions: the basename of each element must match at least one of the defined « must match one of » patterns, and must not match any of the defined « must not match any of » patterns.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Basisnamen basierenden Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Ortes oder für die Werkzeugleiste bestimmt ist, dann werden die auf Basisnamen basierenden Bedingungen auf den Basisnamen des aktuellen Ortes angewendet.

Die Definition einer neuen auf Basisnamen basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Drücken Sie Einf oder klicken Sie auf den Knopf , um eine neue Filterbedingung einzufügen.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Basisnamen enthält.

     A basename-based condition may use « `*` » or « `?` » wildcard characters.

2. Indicates whether this a « must match one of » or a « must not match any of » condition.

   Klicken Sie auf den Radioknopf Muss einem entsprechen von oder Muss allen entsprechen von in der gleichen Zeile, um die jeweilige Bedingung festzulegen.

Abhängig von dem Betriebssystem, auf das Sie abzielen, stellen Sie bitte sicher, dass das Ankreuzfeld Groß-/Kleinschreibung beachten aktiviert ist oder nicht.

- Wenn aktiviert, wird für alle Filter die Groß- und Kleinschreibung beachtet, was bedeutet, dass `/meine/datei` und `/Meine/Datei` unterschiedlich gewertet werden.

  Dies ist das vorgegebene Verhalten auf Unix-ähnlichen Systemen.

- Wenn deaktiviert, wird für alle Filter die Groß- und Kleinschreibung nicht beachtet, was bedeutet, dass `/meine/datei` und `/Meine/Datei` gleich gewertet werden.

  Das ist höchstwahrscheinlich dann der Fall, wenn Sie auf eines der Windows-Betriebssysteme abzielen.

Drücken Sie Entf oder klicken Sie auf den Knopf , um eine neue Filterbedingung zu entfernen.

By default, the basename-based condition is just one « `must match one of *` » condition. As all basenames always match the « `*` » condition, this just means that basename-based conditions are not considered as relevant for the action.

#### Auf dem MIME-Typ basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den MIME-Typen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss jedes Objekt der Auswahl einem bestimmten MIME-Typ entsprechen, wobei Sie außerdem gleichzeitig festlegen können, dass keines der ausgewählten Objekte einem anderen anzugebenden MIME-Typ entsprechen darf.

Klicken Sie auf den Reiter MIME-Typen, um auf dem MIME-Typen basierende Bedingungen festzulegen.

Auf dem MIME-Typ basierende Bedingungen

Shows the tab which lets you define mimetype-based conditions.

The mimetype-based conditions tab

In fact, mimetype-based conditions are built as a list of « must match one of » and « must not match any of » patterns. In order for your action to be a candidate regarding these mimetype-based conditions, each element of the selection must be valid for all the listed conditions: the mimetype of each element must match at least one of the defined « must match one of » patterns, and must not match any of the defined « must not match any of » patterns.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

When targeting the selection context menu, your mimetype-based conditions will be checked against the currently selected items. When targeting the location context menu or the toolbar, your mimetype-based conditions will be checked against the mimetype of the current location, which happens to be the well known « inode/directory » mimetype.

Die Definition einer neuen auf dem MIME-Typ basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Drücken Sie Einf oder klicken Sie auf den Knopf , um eine neue Filterbedingung einzufügen.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten MIME-Typen enthält.

     Ein MIME-Typ muss als Ausdruck der Form `gruppe/untergruppe` definiert werden.

     The « `*` » wildcard is supported only in some situations:

     - The « `*/*` » expression matches all mimetypes. As a convenient shortcut, the « `*` » literal is also accepted for this same purpose.

     - Die Zeichenkette »`group/*`« trifft auf alle Untergruppen des `group`-MIME-Typen zu.

     - Die Zeichenkette `*/subgroup` wird nicht als gültiger Platzhalter akzeptiert.

2. Indicates whether this a « must match one of » or a « must not match any of » condition.

   Klicken Sie auf den Radioknopf Muss einem entsprechen von oder Muss allen entsprechen von in der gleichen Zeile, um die jeweilige Bedingung festzulegen.

Drücken Sie Entf oder klicken Sie auf den Knopf , um eine Filterbedingung zu entfernen.

By default, the mimetype-based condition is just one « `must match one of */*` » condition. As all mimetypes always match the « `*/*` », this just means that mimetypes are not considered as relevant for the action.

Beispiel für übliche MIME-Typen

`all/all`

  Trifft auf alle Objekte zu.

`all/allfiles`

  Bezieht alle regulären Dateien ein.

`inode/directory`

  Bezieht nur Ordner ein.

#### Auf Ordnern basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von dem Ordner der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss sich jedes Objekt der Auswahl in einer bestimmten Hierarchie befinden, wobei Sie außerdem gleichzeitig festlegen können, dass keines der Objekte in einer anderen Hierarchie liegen darf.

Eine auf Ordnern basierende Bedingung muss als die Spezifikation einer Hierarchie angesehen werden, in welcher das aktuell untersuchte Objekt (nicht) verbleiben soll. Es ist ein Muster des Ordnernamens des Elements.

Klicken Sie auf den Reiter Ordner, um die auf Ordnern basierenden Bedingungen zu konfigurieren.

Auf Ordnern basierende Bedingungen

Shows the tab which lets you define folder-based conditions.

The folder-based conditions tab

In fact, folder-based conditions are built as a list of « must match one of » and « must not match any of » patterns. In order for your action to be a candidate regarding these folder-based conditions, each element of the selection must be valid for all the listed conditions: each element must be located in one of the defined « must match one of » folders, and must not match any of the defined « must not match any of » folders.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den Ordnernamen jedes aktuell ausgewählten Objekts angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den aktuellen Ort angewendet.

Die Definition einer neuen auf Ordnern basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Drücken Sie Einf oder klicken Sie auf den Knopf , um eine neue Filterbedingung einzufügen.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Ordner enthält.

     The « `*` » and « `?` » characters are accepted as wildcards at any level of the defined folder filter.

   - Oder klicken Sie auf Durchsuchen, um einen Ordner im Dateisystem auszuwählen.

2. Indicates whether this a « must match one of » or a « must not match any of » condition.

   Klicken Sie auf den Radioknopf Muss einem entsprechen von oder Muss allen entsprechen von in der gleichen Zeile, um die jeweilige Bedingung festzulegen.

Drücken Sie Entf oder klicken Sie auf den Knopf , um eine definierte Ordner-basierte Filterbedingung zu entfernen.

By default, the folder-based condition is just one « `must match one of /` » condition. As `/` is always the top of an Unix-like file system, then all selected items always match this condition.

Wenn das Ziel ein Windows-Betriebssystem ist, dann dürfte dieser Vorgabewert nicht derjenige sein, den Sie tatsächlich benötigen.

#### Auf Schemata basierende Bedingungen

Sie können festlegen, dass Ihre Aktion abhängig von den Schemata der Adressen der aktuell im Dateimanager ausgewählten Objekte angezeigt werden soll. Dazu muss jedes Objekt ein bestimmtes Schema haben, wobei Sie außerdem gleichzeitig festlegen können, dass keines der Objekte ein anderes Schema haben darf.

Klicken Sie auf den Reiter Schemata, um die auf Schemata basierenden Bedingungen zu konfigurieren.

Schemata basierte Bedingungen

Shows the tab which lets you define scheme-based conditions.

The scheme-based conditions tab

In fact, scheme-based conditions are built as a list of « must match one of » and « must not match any of » patterns. In order for your action to be a candidate regarding these scheme-based conditions, each element of the selection must be valid for all the listed conditions: the scheme of each element must match at least one of the defined « must match one of » patterns, and must not match any of the defined « must not match any of » patterns.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Schemata basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Schemata basierenden Bedingungen auf das Schema des aktuellen Orts angewendet.

Die Definition einer neuen auf Schemata basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Drücken Sie Einf oder klicken Sie auf den Knopf , um eine neue Filterbedingung einzufügen.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie das gewünschte Schema enthält.

     Scheme-based conditions only accept « `*` » wildcard, which stands for « any scheme ».

   - Or click on Common to select a scheme among those predefined in Edit Preferences .

     Auswahl eines Schemas aus vordefinierten Schemata

     Show the list of predefined schemes.

     Selecting a scheme among predefined defaults

     Ein neues Schema darf hier nur ausgewählt werden, wenn es nicht bereits als Schema-Filter definiert wurde.

     Um ein neues Schema auszuwählen, klicken Sie auf OK oder doppelklicken Sie auf die gewünschte Zeile.

2. Indicates whether this a « must match one of » or a « must not match any of » condition.

   Klicken Sie auf den Radioknopf Muss einem entsprechen von oder Muss allen entsprechen von in der gleichen Zeile, um die jeweilige Bedingung festzulegen.

Drücken Sie Entf oder klicken Sie auf den Knopf , um eine auf Schemata basierende Filterbedingung zu entfernen.

By default, the scheme-based condition is just one « `must match one of *` » condition, which means that schemes are not relevant for this action.

#### Auf Fähigkeiten basierende Bedingungen

Als Fähigkeiten werden hier Eigenschaften bezeichnet, die eine Datei dem Benutzer anbietet.

But except for the `Local` capability, all others depend on the user who executes the command.

Sie können festlegen, ob Ihre Aktion angezeigt werden soll oder nicht, abhängig von den Fähigkeiten der ausgewählten Objekte bzw. dem aktuellen Benutzer.

Klicken Sie auf den Reiter Fähigkeiten, um die auf den zur Verfügung stehenden Fähigkeiten basierenden Bedingungen zu konfigurieren.

Auf Fähigkeiten basierende Bedingungen

Shows the tab which lets you define capability-based conditions.

The capability-based conditions tab

In fact, capability-based conditions are built as a list of « must match all of » and « must not match any of » patterns. In order for your action to be a candidate regarding these capability-based conditions, each element of the selection must be valid for all the listed conditions: the capability of each element must match each of the defined « must match all of » capabilities, and must not match any of the defined « must not match any of » ones.

Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Fähigkeiten basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Fähigkeiten basierenden Bedingungen auf jene des aktuellen Orts angewendet.

Die Definition einer neuen auf Fähigkeiten basierenden Bedingung umfasst zwei Schritte.

1. Definiert die neue Filterbedingung.

   - Drücken Sie Einf zum Einfügen eines neuen auf Fähigkeiten basierenden Filters.

   - Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie die gewünschte Fähigkeit enthält.

   - Oder klicken Sie auf zum Öffnen des Dialogs Eine neue Fähigkeit hinzufügen.

     Verwaltete Fähigkeiten

     Shows the list of managed capabilities.

     The list of managed capabilities

     Eine neue Fähigkeit darf hier nur ausgewählt werden, wenn es nicht bereits als Fähigkeiten-Filter definiert wurde.

     Um eine neue Fähigkeit auszuwählen, klicken Sie auf OK oder doppelklicken Sie auf die gewünschte Zeile.

2. Indicates whether this a « must match all of » or a « must not match any of » condition.

   Klicken Sie auf den Radioknopf Muss allen entsprechen von oder Darf keinem entsprechen von in der gleichen Zeile, um die jeweilige Bedingung festzulegen.

Drücken Sie Entf oder klicken Sie auf den Knopf , um einen definierten Fähigkeiten-Filter zu entfernen.

Per Voreinstellung ist die Liste der auf Fähigkeiten basierenden Filter leer. Somit sind auf Fähigkeiten basierende Bedingungen für diese Aktion nicht relevant.

#### Bedingung zur Anzahl der Auswahl

Sie können festlegen, dass Ihre Auswahl nur dann erscheint, wenn die gegenwärtige Auswahl im Dateimanager einer genauen Anzahl der Objekte entspricht oder eine genaues Verhältnis zu einer gegebenen Anzahl hat.

Ein Anwendungsfall der Anzahl der Auswahl

If your action consists in displaying the differences between two files, you may define here « `Count = (equal to) 2` ».

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.

Auf der Umgebung basierende Bedingungen

Shows the tab which lets you define environment-based conditions. This includes the selection count configuration, the desktop selection, along with the runtime filters.

The environment-based conditions tab

Die Bedingung Auswahlanzahl wird im Feld Erscheint, wenn die Auswahl enthält definiert.

Bereich für den Auswahlzähler

Focus on the Appears if selection contains frame.

Selection count condition frame

Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann wird die hier definierte Zählbedingung mit der aktuellen Zahl ausgewählter Objekte verglichen. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann wird die Zählbedingung mit Null verglichen, weil es in diesem Fall kein ausgewähltes Objekt gibt.

So definieren Sie eine Bedingung für eine Auswahlanzahl:

- Wählen Sie in der Auswahlliste Anzahl den Operator aus, den Sie auf die Auswahlanzahl anwenden wollen:

  - `<` (strictly less than)
  - `=` (equal to)
  - `>` (strictly greater than)

- Geben Sie die gewünschte Auswahlanzahl ein.

The selection count defaults to « `Count > (strictly greater than) 0` », which means that the action will be a candidate to be displayed as soon as at least one item is selected in the file manager.

#### Auswahl der Arbeitsumgebung

Sie können festlegen, dass Ihre Aktion:

- immer erscheint,

- oder nur in bestimmten angegebenen Arbeitsumgebungen erscheint,

- oder in bestimmten angegebenen Arbeitsumgebungen nicht erscheint.

Innerhalb dieser drei Möglichkeiten ist nur eine Auswahl möglich.

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.

Die Auswahl der Arbeitsumgebung wird im Feld Arbeitsumgebung definiert.

Feld zur Auswahl der Arbeitsumgebung

Focus on the Desktop environment frame.

Desktop selection frame

So definieren Sie die Arbeitsumgebung:

1. Wählen Sie zunächst den Typ des zu verwendenden Filters:

   - Soll Ihre Aktion immer erscheinen, unabhängig von der Arbeitsumgebung?
   - Soll Ihre Aktion nur in bestimmten Arbeitsumgebungen erscheinen?
   - Soll Ihre Aktion nie in bestimmten Arbeitsumgebungen erscheinen?

2. Sollte Ihre Aktion nicht immer erscheinen, so wählen Sie die entsprechende(n) Arbeitsumgebung(en) in der Auswahlliste auf der rechten Seite.

The targeted desktop environment condition defaults to « `Always appear` », which means that the action will be a candidate to be displayed regardless of the current desktop environment.

#### Bedingung für ausführbare Datei

Sie können festlegen, dass Ihre Aktion nur dann erscheinen wird, wenn einige notwendige Pakete auf dem System installiert sind. Für diese Prüfung geben Sie hier eine bestimmte Datei an, die von einem Paket installiert wird. Die Datei muss im Dateisystem vorhanden und ausführbar sein.

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.

Die Bedingung »ausführbare Datei vorhanden« ist im Feld Ausführungsumgebung definiert.

Feld Ausführungsumgebung

Focus on the Execution environment frame.

Execution environment frame

Geben Sie zum Festlegen der relevanten Datei deren vollen Dateinamen in das Eingabefeld Erscheint, wenn die Datei ausführbar ist ein, oder klicken Sie auf Durchsuchen und wählen Sie eine Datei im Dateisystem.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Dateinamen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.

#### Bedingung für eine D-Bus-Registrierung

Sie können festlegen, dass Ihre Aktion nur dann erscheinen soll, wenn ein bestimmter Name zur Ausführungszeit am D-Bus-System registriert ist.

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend Ausführungsumgebung.

Geben Sie zum Definieren den relevanten Namen in das Eingabefeld Erscheint, wenn der Name bei D-Bus registriert ist ein.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.

#### Angepasste Bedingung

Sie können festlegen, dass Ihre Aktion nur dann erscheinen wird, wenn ein bestimmter Befehl die Zeichenkette `true` auf die Standardausgabe ausgibt.

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend Ausführungsumgebung.

So können Sie Ihren eigenen angepassten Bedingungsfilter definieren, indem Sie ein kleines Skript schreiben, dass gegebenenfalls die Zeichenkette `true` auf die Standardausgabe ausgibt.

Geben Sie zum Definieren den Befehl in das Eingabefeld Erscheint, wenn der Befehl »true« ausgibt ein.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den Dateinamen einbetten, der ausgeführt wird, oder in dessen Optionen. Diese Parameter werden zur Laufzeit dynamisch mit Werten ersetzt, die von den gewählte(n) Objekt(en) abhängen.

#### Bedingung für laufende Prozesse

Sie können bestimmten, dass Ihre Aktion nur dann erscheinen wird, wenn ein bestimmter Prozess aktuell ausgeführt wird.

Klicken Sie auf den Reiter Umgebung, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend Ausführungsumgebung.

Geben Sie zum Festlegen der Binärdatei deren Namen in das Eingabefeld Erscheint, wenn die Binärdatei ausgeführt wird ein, oder klicken Sie auf Durchsuchen und wählen Sie eine Datei im Dateisystem.

Selbst wenn Sie den vollen Dateinamen der Binärdatei angeben, so wird zur Laufzeit nur nach dem Basisnamen in der Prozessliste gesucht.

Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.

Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.

### Bestimmung des Ortes der Aktion

Zielkonfiguration

Shows the three fields which let you configure the target of your action.

Target configuration

The file manager may display your action in different places, depending on what you will request here, and if some item is currently selected (or not).

Klicken Sie auf den Reiter Aktion, um die Orte Ihrer Aktionsziele zu konfigurieren.

#### Eintrag in das Kontextmenü der Auswahl

When Display item in selection context menu is checked, then your action will be a candidate to be displayed in the file manager context menu as soon as at least one item is selected in the file manager. Your action will so deal with currently selected item(s).In order to be actually displayed, all the conditions defined in your candidate action must be met by each item currently selected in the file manager.

When an action targets the selection context menu, and is actually displayed in the file manager context menu, then it is also displayed in file manager' Edit menu.

Dieses Ziel wird per Voreinstellung ausgewählt.

#### Eintrag in das Kontextmenü des Orts

When Display item in location context menu checkbox is activated, then your action will be a candidate to be displayed in file manager' context menu when the file manager selection is empty. Your action will so deal with currently displayed location. In order to be actually displayed, all the conditions defined in your candidate action must be met by the location currently displayed in the file manager.

When an action targets the location context menu, and is actually displayed in file manager' context menu, then it is also displayed in file manager' File menu.

#### Eintrag in die Werkzeugleiste

When Display item in the toolbar checkbox is activated, then your action will be a candidate to be displayed in file manager;' toolbar.

In der Werkzeugleiste angezeigte Aktionen arbeiten nur mit dem aktuell in der Dateiverwaltung angezeigten Ort, nicht aber mit den jeweils aktuell (nicht) ausgewählten Objekten. Damit sie auch tatsächlich angezeigt werden, müssen allen Bedingungen der in Frage kommenden Aktion durch den aktuell geöffneten Ort erfüllt sein.

#### Notizen

Legt fest, ob Ihre Aktion in einem Kontextmenü angezeigt werden soll

Whether it is the selection context menu or the location context menu, and both in file manager' context menus and in File or Edit menus, it will be displayed as

- die Kontext-Beschriftung als Beschriftung,

- ein Symbol,

- diese beiden Eigenschaften werden mit einer Minihilfe assoziiert.

Ob die Bezeichnung des Menüs vor dem Symbol in der Werkzeugleiste angezeigt wird, ist von der genauen Konfiguration Ihrer Arbeitsumgebung abhängig.

Sie können bestimmte Parameter in die Beschriftung, den Symbolnamen und die Minihilfe integrieren. Sie werden zur Ausführungszeit dynamisch mit Werten ersetzt, die von den gewählten Objekt(en) abhängen.

Wenn Ihre Aktion in der Werkzeugleiste angezeigt werden soll

Sie wird angezeigt als

- die Werkzeugleisten-Beschriftung als Beschriftung,

- ein Symbol,

- diese beiden Eigenschaften werden mit einer Minihilfe assoziiert.

Abhängig von der genauen Konfiguration Ihrer Arbeitsumgebung wird die Beschriftung der Werkzeugleiste vor dem Symbol in der Werkzeugleiste angezeigt.

Die Beschriftung in der Werkzeugleiste entspricht per Voreinstellung derjenigen in den Menüs. Mit Abwahl des Ankreuzfelds Die gleiche Beschriftung für das Symbol in der Werkzeugleiste verwenden geben Sie eine Beschriftung explizit für die Werkzeugleiste an. Diese ist für gewöhnlich kürzer als jene für die Menüs.

Sie können bestimmte Parameter in die Beschriftung der Werkzeugleiste, den Symbolnamen und die Minihilfe integrieren. Diese werden zur Ausführungszeit dynamisch mit Werten ersetzt, die von den gewählten Objekt(en) abhängen.

Definieren verschiedener Ziele

Eine Aktion kann für das Kontextmenü einer Auswahl, eines Orts, die Werkzeugleiste bzw. für eine beliebige Kombination aller bestimmt sein.

Definieren keines Ziels

Falls überhaupt kein Ziel definiert ist, also wenn alle drei Ankreuzfelder deaktiviert sind, dann wird Ihre Aktion niemals angezeigt.

### Welche Aktion soll ausgeführt werden?

Wahrscheinlich möchten Sie, dass Ihre Aktion letztendlich etwas ausführt. Tatsächlich ist eine der wenigen Voraussetzungen für die Gültigkeit einer Aktion, dass diese etwas ausführen soll.

Wie bereits gesehen wird der auszuführende Befehl auf der Seite Befehl konfiguriert.

Dieser Befehl kann Argumente annehmen, die wiederum eingebettete Parameter enthalten dürfen. Diese werden zur Ausführungszeit mit Werten erweitert, die von den gewählten Objekt(en) abhängen.

#### Verfügbare Parameter

Klicken Sie auf der Seite Befehl auf den Knopf Legende, um eine Liste aller verfügbaren Parameter zu sehen.

Liste der verfügbaren Parameter

Shows the list of available parameters.

The available parameters

Der Knopf Legende hat eine Doppelfunktion: Klicken Sie einmal darauf, dann erscheint das Dialogfeld Parameterlegende; Klicken Sie erneut, um es zu verbergen.

The word « first » may be misleading as it only refers to the list of selected items internally provided by the file manager to the FileManager-Actions plugin.

In particular, it has nothing to do with the visual selection you may have done in the file manager window. And, in fact, which is the « first » selected item in a multiple selection is absolutely undefined and rather unpredictable.

#### Wo soll die Aktion ausgeführt werden?

Ihre Aktion kann in einem bestimmten Arbeitsordner ausgeführt werden.

Sie geben diesen im Reiter Befehl im Eingabefeld Arbeitsordner an, oder indem Sie auf den Knopf Durchsuchen zum Wählen eines Ordners im Dateisystem klicken.

Feld für Arbeitsordner

Focus on the working directory selection frame.

Working directory frame

Der Arbeitsordner ist per Voreinstellung `%d`, das heißt, die Befehle werden im Basisordner des (ersten) ausgewählten Objekts ausgeführt.

In the particular case of the `%d` parameter, the « first » selected item is not very important because it is very likely that all selected items are located in the same base directory.

#### Wie soll die Aktion ausgeführt werden?

Apart from configuring the conditions, the selection must be met in order your action be displayed in file manager menus, FileManager-Actions allows you to configure how exactly your command will be executed.

Klicken Sie auf den Reiter Ausführung, um die Ausführung eines Befehls zu konfigurieren.

Konfiguration der Ausführungsmodi

Shows how to configure the execution modes of a command.

Configuration of the execution modes

##### Ausführungsmodus

Konfiguration des Ausführungsmodus

Focus on the execution mode frame.

Configuration of the execution mode

Der Ausführungsmodus Ihres Befehls kann aus folgenden Werten gewählt werden:

Normal

  Startet den Befehl als normale grafische Benutzeroberfläche.

Terminal

  Startet das bevorzugte Terminal der Arbeitsumgebung und führt den Befehl darin aus.

Eingebettet

  Nutzt ein spezielles Funktionsmerkmal des Dateimanagers, wodurch ein Terminal in diesem ausgeführt wird.

  As for now, none of the managed file managers implement this feature.

Ausgabe anzeigen

  Startet das bevorzugte Terminal der Arbeitsumgebung und führt den Befehl darin aus. Am Ende werden die Standardkanäle (stdout, stderr) ausgelesen und angezeigt.

Der Standardausführungsmodus eines Befehls ist `Normal`. Das bedeutet, dass der Befehl ohne besondere davor oder danach auszuführende Aktionen gestartet wird.

##### Start-Rückmeldungen

Konfiguration der Startmodi

Focus on the Startup mode frame.

Configuration of the startup modes

Wenn der Ausführungsmodus des Befehls `Normal` ist und wenn Sie sicher sind, dass die Anwendung eine `Entfernen`-Nachricht bei gesetzter Umgebungsvariable `DESKTOP_STARTUP_ID` sendet, dann sollten Sie das Ankreuzfeld Startbenachrichtigung auswählen.

See the Startup Notification Protocol Specification for more details.

##### Fensterklasse

Wenn der Ausführungsmodus des Befehls `Normal` ist und wenn Sie sicher sind, dass die Anwendung mindestens ein Fenster mit einem Klassennamen abbildet, dann sollten Sie diesen Namen in das Eingabefeld WM-Klasse beim Start eingeben.

See the Startup Notification Protocol Specification for more details.

##### Befehlsausführer

Konfiguration des Besitzers der Ausführung

Focus on the Execute as frame.

Configuration of the owner of the run

Geben Sie den Benutzernamen in das Eingabefeld Als Benutzer ausführen oder die UID des Benutzers ein, als welcher der Befehl ausgeführt werden soll.

Falls Sie nichts in diesem Feld eingeben, dann wird der Befehl unter dem Kennzeichen des aktuellen Benutzers ausgeführt.

##### Mehrfache Ausführung

Sie möchten möglicherweise den Befehl nur einmal ausführen, mit der Liste aller ausgewählten Objekte als Argument.

Sie möchten möglicherweise den Befehl für jedes gewählte Objekt ausführen, jeweils mit einem unterschiedlichen Argument für jede Ausführung.

Tatsächlich handhabt Nautilus-Aktionen diese beiden Verhalten automatisch, abhängig von Form und Reihenfolge der Parameter in den Argumenten der Befehlszeile.

Though some parameters are not depending on the count of the selection (e.g. « `%c` », the selection count itself), most have two declensions:

- a « singular » one, e.g. « `%b` », the basename of the selected item;

- a « plural » one, e.g. « `%B` », the space-separated list of the basenames of selected items.

Falls die Auswahl leer ist oder nur ein Element enthält, dann sind diese zwei Formen genau gleich.

Falls die Auswahl mehr als ein Objekt enthält:

- if the first relevant parameter is of a singular form, then FileManager-Actions will consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item;

- contrarily, if the first relevant parameter found is of the plural form, then FileManager-Actions will consider that the command is able to deal with a list of items, and thus the command will be executed only once;

- falls alle gefundenen Parameters irrelevant sind, dann geht Nautilus-Aktionen davon aus, dass der Befehl nur einmal ausgeführt werden soll.

Characterisierung der Parameter vs. mehrfache Ausführung

Parameter | Beschreibung | Wiederholung
--- | --- | ---
`%b` | (erster) Basisname | Singular |  |
`%B` | Durch Leerzeichen getrennte Liste von Basisnamen |  |  | Plural
`%c` | Anzahl der ausgewählte Objekte |  | irrelevant |
`%d` | (erster) Basisordner | Singular |  |
`%D` | Durch Leerzeichen getrennte Liste von Ordner-Basisnamen der ausgewählten Objekte |  |  | Plural
`%f` | (erster) Dateiname | Singular |  |
`%F` | Durch Leerzeichen getrennte Liste der gewählten Dateinamen |  |  | Plural
`%h` | Rechnername der (ersten) Adresse |  | irrelevant |
`%m` | MIME-Typ des (ersten) ausgewählten Eintrags | Singular |  |
`%M` | Durch Leerzeichen getrennte Liste der MIME-Typen der gewählten Objekte |  |  | Plural
`%n` | Benutzername der (ersten) Adresse |  | irrelevant |
`%o` | »no-op« Operator, der eine einfache Form der Ausführung erzwingt. | Singular |  |
`%O` | »no-op« Operator, der eine mehrfache Form der Ausführung erzwingt. |  |  | Plural
`%p` | Portnummer der (ersten) Adresse |  | irrelevant |
`%s` | Schema der (ersten) Adresse |  | irrelevant |
`%u` | (erste) Adresse | Singular |  |
`%U` | Durch Leerzeichen getrennte Liste der gewählten Adressen |  |  | Plural
`%w` | (erster) Basisname ohne Erweiterung | Singular |  |
`%W` | Durch Leerzeichen getrennte Liste der Basisnamen ohne deren Erweiterung |  |  | Plural
`%x` | (erste) Erweiterung | Singular |  |
`%X` | Durch Leerzeichen getrennte Liste von Erweiterungen |  |  | Plural
`%%` | the « `%` » character |  | irrelevant |

Verwendung von Singular- gegenüber Plural-Formen

Angenommen, der aktuelle Ordner ist `/data` und die aktuelle Auswahl enthält die drei Dateien `pierre`, `paul` und `jacques`.

Wenn der Befehl `echo %b` angefordert wird,

dann werden die folgenden Befehle erfolgreich ausgeführt:

- `echo pierre`
- `echo paul`
- `echo jacques`

Dies liegt daran, dass `%b` einen singulären Parameter darstellt. Der Befehl wird nur einmalig für jedes der gewählten Objekte ausgeführt.

Gäbe es im Gegensatz dazu die Anfrage `echo %B`,

dann wird der folgende Befehl ausgeführt:

- `echo pierre paul jacques`

Dies liegt daran, dass `%B` einen pluralischen Parameter darstellt. Der Befehl wird nur einmalig ausgeführt mit der Liste der gewählten Objekte als Argumente.

Gäbe es die Anfrage `echo %b %B`,

dann werden die folgenden Befehle erfolgreich ausgeführt:

- `echo pierre pierre paul jacques`
- `echo paul pierre paul jacques`
- `echo jacques pierre paul jacques`

Dies liegt daran, dass der erste relevante Parameter `%b` ist und damit der Befehl einmal für jedes gewählte Objekt ausgeführt wird, wobei jedes Mal der Parameter `%b` durch das entsprechende Objekt ersetzt wird. Der zweite Parameter wird berechnet und als Argument an den ausgeführten Befehl angehängt.

und gäbe es die Anfrage `echo %B %b`,

dann werden die folgenden Befehle ausgeführt:

- `echo pierre paul jacques pierre`

Dies liegt daran, dass in diesem Fall der erste relevante Parameter `%B` ist. Der Befehl wird nur einmal ausgeführt wird, wobei `%B` durch eine durch Leerzeichen getrennte Liste von Basisnamen ersetzt wird. Weil der Befehl nur einmal ausgeführt wird, wird `%b` nur einmal mit dem (ersten) Basisnamen ersetzt.

### Verwendung von Profilen zur Erweiterung Ihrer Aktion

In einigen Fällen wollen Sie möglicherweise, dass eine gegebene Aktion ein abweichendes Verhalten zeigt, abhängig von den aktuell ausgewählten Objekten oder der aktuellen Ausführungsumgebung.

Hier ein Terminal öffnen

Nehmen wir an, Sie hätten eine Aktion, die am aktuellen Ort ein Terminal öffnet.

Sie haben die Einstellungen so gewählt, dass Ihre bevorzugtes Terminal an dem Ort geöffnet wird, auf den Ihr Dateimanager gerade zeigt.

Aber was tun, wenn Sie einen Ordner in Ihrem Dateimanager ausgewählt haben, und das Terminal direkt in diesem Ordner geöffnet wird? Solange die Konfiguration weiterhin auf dem aktuellen Ort des Dateimanagers basiert, wird der Elternordner des Zielordners geöffnet.

Eine Lösung liegt darin, Ihrer Aktion ein neues Profil zuzuweisen, durch welches das Terminal im Zielordner geöffnet wird.

At runtime, FileManager-Actions will successively examine each profile attached to your action. If the first profile targets a file while you have selected a directory, then FileManager-Actions will just try with your second profile.

To create a new profile, first select the action in the items list, then choose File New profile .

Ein neues Profil wird in Ihrer Aktion erstellt.

Sie können nun die Bedingungen festlegen, die zutreffen müssen, damit dieses Profil ausgewählt und der Befehl ausgeführt wird.

#### Ordnen der Profile innerhalb einer Aktion

Zur Laufzeit beginnt Nautilus-Aktionen mit der Untersuchung der Bedingungen, die der Aktion zugeschrieben sind.

Wenn diese Bedingungen (der Aktionen) erfüllt werden, dann arbeitet Nautilus-Aktionen jedes Profil in Reihenfolge ab.

Wenn die Bedingungen eines Profils erfüllt werden, dann wird dieses Profil ausgewertet. Es werden daraufhin keine weiteren ausgewertet.

Wenn zur Laufzeit kein gültiges Profil gefunden wird, so wird die Aktion als ungültig angesehen. Sie wird nicht im Kontextmenü der Dateiverwaltung angezeigt.

Profiles of an action are ordered, and they are examined in that order at runtime. The first profile whose conditions are met will be validated, and made selectable in the file manager context menu.

Das heißt, die Reihenfolge der Profile kann entscheidend für Ihre Aktion sein: Das erste gültige Profil wird das einzige gewählte Profil.

Profile können innerhalb einer Aktion auf zwei Weisen angeordnet werden.

1. Schneiden Sie das Profil aus, das Sie verschieben möchten, wählen Sie das Profil aus, vor welches Sie das Ausgeschnittene einfügen möchten, und fügen Sie es ein.

2. Klicken Sie auf das Profil, das Sie verschieben möchten, und ziehen Sie es an den gewünschten Ort.

### Organisieren von Aktionen in Menüs

Mit wachsender Zahl an Aktionen bietet es sich an, diese in Menüs, Untermenüs usw. anzuordnen.

In order to create a new menu, choose File New menu .

Ein Menü darf beliebig in Ihrer Aktionenliste erstellt werden, aber nur innerhalb einer Aktion (d.h. nicht zwischen zwei Aktionsprofilen).

Bei den Aktionen hängt die Platzierung eines neuen Menüs von der aktuellen Sortierreihenfolge ab:

Manuelle Reihenfolge:

  Das neue Menü wird unmittelbar vor die aktuelle Aktion oder das aktuelle Menü eingefügt.

  Der Ort wird sich nicht ändern, wenn später die Menübeschriftung verändert wird.

Aufsteigende (respektive absteigende) alphabetische Reihenfolge:

  The new menu is inserted at the correct place, regarding the default « `New Nautilus menu` » label.

  Dieser Ort wird jedes mal automatisch geändert, wenn Sie die Bezeichnung des Menüs verändern.

As an action, too, a menu requires a label, and may have an icon and a tooltip. Also, you may define some conditions in order your menu be candidate to be displayed in the file manager context menu. If the defined conditions are not met at runtime, then your whole menu, including its submenus, its actions and so on, will not be displayed.

### Die Objektliste sortieren

Your actions and menus will be displayed in file manager context menus in the same order that they are listed in the Items list, on the left pane of the main FileManager-Actions configuration tool window.

Sie können:

- entweder Ihre Aktionen und Menüs in alphabetischer oder umgekehrt alphabetischer Reihenfolge anhand ihrer Bezeichnung sortieren lassen,

- oder nicht sortieren lassen und Ihre Aktionen und Menüs nach Ihrer eigenen gewünschten Reihenfolge sortieren.

#### Alphabetische Sortierung Ihrer Aktionen und Menüs

In diesen Modi werden Aktionen und Menüs anhand ihrer Bezeichnung innerhalb ihres übergeordneten Objekts sortiert.

Sortierknöpfe im Hauptfenster

Shows the three sort buttons in the main window.

Sort buttons in the main window

Sie können Ihre Aktionen sortieren nach:

- Click on (resp. ) button to sort your actions in ascending (resp. descending) order.

- Oder bearbeiten Sie bitte die entsprechende Einstellung.

#### Manuelles Organisieren Ihrer Aktionen und Menüs

Wenn Einträge manuell in der Liste sortiert werden, werden neue Einträge normalerweise an dieser Stelle eingefügt.

There is nonetheless the case where an action is selected, and not expanded (or has currently only one profile). Inserting a new profile will not insert it before the action, but inside of the action.

So wählen Sie diesen Modus:

- Klicken Sie auf den -Knopf.

- Oder bearbeiten Sie bitte die entsprechende Einstellung.

### Bearbeiten

With FileManager-Actions configuration tool, you may safely cut, copy, paste to and from the clipboard.

#### Ausschneiden/Löschen

Gelöscht wird die aktuelle Auswahl.

Beachten Sie, dass das Löschen aller Profile einer Aktion diese ohne Profile in einem ungültigen Zustand zurücklässt. Der Name der Aktion wird dann rot (weil diese ungültig ist) und kursiv (weil diese verändert wurde) dargestellt.

#### Mehrfachauswahlen

Multiple selection is possible in FileManager-Actions configuration tool. You can extend the current selection by pressing Ctrl or Shift while selecting an item to add to the selection.

FileManager-Actions configuration tool only accepts homogeneous multiple selections. That is, you may select one or more profiles, or one or more actions or menus. A multiple selection containing both profiles and actions or menus is not allowed. This is because FileManager-Actions configuration tool would not know where to paste such a selection.

Note that selecting any row means also selecting children of this row. These children are said « implicitely selected »: they will be part of next edition operations, but are not considered when verifying if selection is homogeneous. Also, they cannot be explicitely selected (nor unselected).

### Speichern Ihrer Änderungen

To save your modifications, choose Ctrl S File Save .

Alle Ihre ausstehenden Änderungen werden gespeichert. Neue Einträge werden durch den nächsten freien E/A-Provider erstellt.

Nautilus-Aktionen besitzt die Funktion zum automatischen Speichern, welche in den Einstellungen konfigurierbar ist.

### Exportieren Ihrer Aktionen

### Importieren von Aktionen

### Festlegen Ihrer persönlichen Einstellungen

Choose Edit Preferences to access to the configuration of your preferences.

#### Laufzeiteinstellungen

Laufzeiteinstellungen

Shows the tab which lets you define runtime preferences.

Runtime preferences

#### Einstellungen der Ausführungszeit

Einstellungen der Ausführungszeit

Shows the tab which lets you define runtime execution preferences.

Runtime execution preferences

Auswahl der Arbeitsumgebung

Let the user explicitely configure the current desktop.

Desktop selection

#### Einstellungen der Benutzeroberfläche

Einstellungen der grafischen Oberfläche

Shows the tab which lets you define UI preferences.

UI preferences

#### Importeinstellungen

Importeinstellungen

Shows the tab which lets you define import preferences.

Import preferences

#### Exporteinstellungen

Exporteinstellungen

Shows the tab which lets you define export preferences.

Export preferences

#### Einstellungen für Schemata

Einstellungen für Schemata

Shows the tab which lets you define schemes preferences.

Schemes preferences

#### Einstellungen für Ein-/Ausgabetreiber

Einstellungen für Ein-/Ausgabetreiber

Shows the tab which lets you define I/O providers preferences.

I/O providers preferences

## Verschiedene Informationen

The new action is also displayed in red color in the items list. Red color is used as an indicator that the item is invalid, that is that the item cannot be candidate to be displayed in a file manager context menu because some of its informations are missing or erroneous. Here, and though this newly inserted action has some suitable defaults, it lacks a command to be executed to be considered valid by FileManager-Actions configuration tool

## Bekannte Fehler und Einschränkungen

### Bekannte Fehler

Known bugs are available on Bugzilla summary page.

If you find some new bug in FileManager-Actions, you are welcome to open it by pointing your favorite browser to Bugzilla web site.

#616532 Ordnerwahl

When you're browsing the folder you want to export to in the FileManager-Actions configuration tool's export assistant you can't select it as the directory to export to. Instead you have to go to the directory a level up and select the directory you want to export to there.

### Bekannte Einschränkungen

Ausführungsmodus

As of version 3.0, execution mode may be configured in FileManager-Actions configuration tool but is not yet honored by known file-managers.

Dies betrifft den Arbeitsordner, Ausführungsmodus, Startbenachrichtigung und die Besitzer-Parameter des Ausführenden.

Vorgeschlagene Tastenkombination

As of version 3.0, suggested shortcut, as described in DES-EMA specification cannot be configured in FileManager-Actions configuration tool, and is not honored by the menu plugin. But, thanks to the tracker plugin, you are always able to define a shortcut at the desktop level, assigning this shortcut to the fma-run program, making it execute the action of your choice.

Menütrenner

As of version 3.0, menu separators cannot be configured in FileManager-Actions configuration tool, and are not honored by any known file-managers.

## About FileManager-Actions configuration tool

Die erste Version von Nautilus-Aktionen wurde von Frederic Ruaudel (grumz@grumz.net) und Rodrigo Moya (rodrigo@gnome-db.org) geschrieben. Sie wurde wesentlich verbessert und wird nun von Pierre Wieser (pwieser@trychlos.org) betreut.

Die Grafiken verdanken wir Ulisse Perusin (uli.peru@gmail.com) und DragonArtz (http://www.dragonartz.net).

To find more information about FileManager-Actions, please visit the FileManager-Actions website.

To report a bug or make a suggestion regarding FileManager-Actions, the FileManager-Actions configuration tool or this manual, follow the directions in the GNOME Feedback Page, or you may prefer, at your convenience, directly open a bug or a request for enhancement in Bugzilla website.

## GNU Freie Dokumentationslizenz

Version 1.3, 3. November 2008

Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.

Es ist jedermann gestattet, wortwörtliche Kopien dieses Lizenzdokuments anzufertigen und zu verbreiten, Änderungen sind jedoch nicht erlaubt.

#### 0. VORWORT

Der Zweck dieser Lizenz ist es, ein Handbuch, Lehrbuch oder ein anderes zweckdienliches und nützliches Dokument frei, im Sinne von Freiheit, zu machen; jedermann die Freiheit zu sichern, es zu kopieren und mit oder ohne Änderungen daran sowohl kommerziell als auch nicht kommerziell weiter zu verbreiten. Weiterhin sichert diese Lizenz einem Autor oder Verleger die Möglichkeit, Anerkennung für seine Arbeit zu erhalten, ohne für Änderungen durch Andere verantwortlich gemacht zu werden.

Diese Lizenz ist eine Art copyleft, das heißt, dass abgeleitete Arbeiten des Dokumentes selbst wieder im gleichen Sinne frei sein müssen. Es ergänzt die GNU General Public License, die eine Copyleft-Lizenz für freie Software darstellt.

Wir haben diese Lizenz gestaltet, um sie für Anleitungen von freier Software zu benutzen, weil freie Software freie Dokumentation benötigt: Ein freies Programm sollte mit Anleitungen kommen, die dieselbe Freiheit wie die Software bieten. Aber diese Lizenz ist nicht auf Software-Anleitungen beschränkt; sie kann für alle textlichen Arbeiten verwendet werden, unabhängig vom Thema, oder ob es als gedrucktes Buch veröffentlicht wird. Wir empfehlen diese Lizenz prinzipiell für Arbeiten, deren Zweck Anleitungen oder Referenzen sind.

#### 1. ANWENDBARKEIT UND DEFINITIONEN

‎Diese Lizenz findet Anwendung auf jedes Handbuch oder andere Werk, unabhängig von dem Medium, auf dem es erscheint, das einen vom Rechteinhaber eingefügten Hinweis enthält, der besagt, dass das Werk unter den Bedingungen dieser Lizenz verbreitet werden darf. Ein solcher Hinweis gewährt eine weltweit gültige, tantiemenfreie und zeitlich unbefristete Lizenz, die es gestattet das Werk, unter den hier festgelegten Bedingungen, zu nutzen. Der Begriff Dokument wird im Folgenden für alle solche Handbücher und Werke verwendet. Jede Person kann Lizenznehmer sein und wird im Folgenden mit Sie angesprochen. Sie akzeptieren diese Lizenz, wenn Sie ein Dokument derart kopieren, verändern oder verteilen, dass Sie gemäß den Gesetzen zum Copyright die Erlaubnis benötigen.

Eine Modifizierte Version von dem Dokument bezeichnet jegliche Arbeit, die das Dokument oder einen Teil davon enthält, entweder wortwörtlich kopiert oder mit Modifikationen und/oder in eine andere Sprache übersetzt.

Ein »zweitrangiger Abschnitt« ist ein benannter Anhang oder eine Einleitung des Dokumentes, der sich ausschließlich mit dem Verhältnis des Autors oder Verlegers des Dokumentes zu dem eigentlichen Thema des Dokumentes (oder damit zusammenhängender Dinge) beschäftigt, und der nichts enthält, das direkt zu dem eigentlichen Thema gehört. (Wenn das Dokument beispielsweise ein Buch über Mathematik ist, dann darf ein zweitrangiger Abschnitt nichts über Mathematik enthalten). Dies kann eine historische Beziehung zu dem Thema, oder damit zusammenhängender Dinge, oder von gesetzlicher, gesellschaftlicher, philosophischer, ethischer oder politischer Art sein, die das Thema betreffen.

Die »unveränderlichen Abschnitte« sind benannte zweitrangige Abschnitte, deren Titel als unveränderlicher Abschnitt in dem Lizenzhinweis, der das Dokument unter diese Lizenz stellt, aufgeführt sind. Wenn ein Abschnitt nicht in die oben stehende Definition eines zweitrangigen Abschnittes passt, dann ist es nicht erlaubt diesen Bereich als unveränderlichen Bereich zu kennzeichnen.

»Umschlagtexte« sind bestimmte, kurze Textstücke, die als vorderer Umschlagtext oder als hinterer Umschlagtext in der Notiz benannt werden, die besagt, dass das Dokument unter dieser Lizenz freigegeben ist. Ein vorderer Umschlagtext kann bis zu 5 Worte enthalten, ein hinterer Umschlagtext bis zu 25 Worte.

Eine »transparente« Kopie des Dokumentes bezeichnet eine maschinenlesbare Kopie, dargestellt in einem Format, dessen Spezifikationen allgemein verfügbar sind, und das geeignet ist das Dokument auf einfache Weise mit einem allgemeinen Texteditor oder (für Bilder, die aus Pixeln bestehen) mit einem allgemeinen Bildbearbeitungsprogramm oder (für Zeichnungen) mit einem häufig verfügbaren Zeichenprogramm zu überarbeiten, und das geeignet ist es als Eingabe für Textformatierer zu verwenden, oder als Eingabe für automatische Konvertierungsprogramme, die eine Reihe von unterschiedlichen Formaten erzeugen, die ihrerseits als Eingabe für Textformatierer verwendet werden können. Eine Kopie in ein anderes transparentes Dateiformat, dessen Auszeichnung oder das Fehlen der Auszeichnungen derart beschaffen sind, nachfolgende Modifikationen durch die Leser zu verhindern oder zu erschweren, ist nicht transparent. Ein Bildformat ist nicht transparent, wenn es für eine wesentliche Menge von Text verwendet wird. Eine Kopie, die nicht transparent ist, wird als opak bezeichnet.

Beispiele verwendbarer Formate für transparente Kopien schließen einfachen ASCII-Text ohne Auszeichnungen, TeX-info Eingabe, LaTeX-Eingabeformat, SGML oder XML, sofern die verwendete DTD öffentlich verfügbar ist, sowie standardkonformes, einfaches HTML, Postscript oder PDF, die für Veränderungen durch Menschen entworfen sind, ein. Beispiele für transparente Bildformate sind u.a. PNG, XCF und JPG. Opake Formate sind unter anderen solche proprietären Formate, die nur von proprietären Textverarbeitungsprogramm gelesen und bearbeitet werden können, SGML oder XML deren DTD und/oder Verarbeitungswerkzeuge nicht allgemein verfügbar sind, und maschinengeneriertes HTML, PostScript oder PDF, das von manchen Textverarbeitungsprogrammen nur zu Ausgabezwecken erzeugt wird.

Mit »Titelseite« wird in einem gedruckten Buch die eigentliche Titelseite sowie die direkt darauf folgenden Seiten bezeichnet, die all das in lesbarer Form enthalten, was in dieser Lizenz gefordert ist, dass es auf der Titelseite erscheinen muss. Für Werke, die in Formaten vorliegen, die keine Titelseiten haben, gilt als Titelseite der Text, der der auffälligsten Darstellung des Titels des Werkes direkt folgt, aber noch vor dem Inhalt des Werkes steht.

The “publisher” means any person or entity that distributes copies of the Document to the public.

Ein Abschnitt mit dem Titel xyz bezeichnet einen benannten Unterbereich des Dokumentes, dessen Titel entweder genau xyz ist, oder der xyz in Anführungszeichen enthält, der einem Text folgt, der xyz in eine andere Sprache übersetzt. (Hier steht xyz für einen speziellen Abschnittsnamen, der im Folgenden erwähnt wird wie »Danksagung« (Acknowledgements), »Widmung« (Dedications), »Anmerkung« (Endorsement) oder »Historie« (History). Den Titel erhalten eines Abschnittes bedeutet, dass beim Modifizieren des Dokumentes dieser Abschnitt mit dem Titel xyz bleibt, wie es in dieser Definition festgelegt ist.

Das Dokument kann direkt hinter der Notiz, die besagt, dass das Dokument unter dieser Lizenz freigegeben ist, Garantieausschlüsse enthalten. Diese Garantieausschlüsse werden so behandelt, als seien sie als Referenzen in diese Lizenz eingeschlossen, allerdings nur um Garantien auszuschließen: Jede andere Implizierung, die dieser Ausschluss hat, ist ungültig und keine Wirkung im Sinne dieser Lizenz.

#### 3. WORTWÖRTLICHE KOPIEN

Sie dürfen das Dokument auf jedem Medium sowohl kommerziell als auch nicht kommerziell kopieren und verbreiten, vorausgesetzt, dass diese Lizenz, die Copyright-Hinweise sowie der Lizenzhinweis, der besagt, dass diese Lizenz auf das Dokument anzuwenden ist, in allen Kopien reproduziert wird, und dass keine weiteren Bedingungen jeglicher Art zu denen dieser Lizenz hinzugefügt werden. Sie dürfen in den Kopien, die Sie erstellen oder verbreiten, keinerlei technische Maßnahmen treffen, um das Lesen oder das weitere Kopieren zu erschweren oder zu kontrollieren. Dennoch dürfen Sie Gegenleistungen für Kopien akzeptieren. Wenn Sie eine ausreichend große Menge von Kopien verteilen, müssen Sie zusätzlich die Bestimmungen von Ziffer 3 beachten.

Sie dürfen auch Kopien unter den oben genannten Bedingungen verleihen, und Sie dürfen Kopien öffentlich zeigen.

#### 3. KOPIEREN IN MENGEN

Wenn Sie gedruckte Kopien des Dokumentes (oder Kopien auf Medien, die üblicherweise gedruckte Umschläge haben) in einer Stückzahl von mehr als 100 veröffentlichen, und der Lizenzhinweis des Dokumentes Umschlagtexte verlangt, müssen die Kopien in Hüllen verpackt sein, die alle diese Umschlagtexte klar und lesbar enthalten. Die vorderen Umschlagtexte auf dem vorderen Umschlag, die hinteren Umschlagtexte auf dem hinteren Umschlag. Beide Umschläge müssen Sie außerdem klar und lesbar als den Herausgeber dieser Kopien benennen. Der vordere Umschlag muss den gesamten Titel darstellen, mit allen Worten gleich auffällig und sichtbar. Sie können weiteres Material den Umschlägen hinzufügen.Das Kopieren mit Änderungen, die auf Umschläge begrenzt sind, können, solange der Titel des Dokuments erhalten bleibt, ansonsten als Datenträgerkopien behandelt werden.

Wenn die geforderten Texte für jede Seite zu groß sind, um leserlich darauf zu passen, sollten Sie die erstgenannten (so viele, wie vernünftig darauf passen) auf die aktuelle Seite setzen, und mit dem Rest auf angrenzenden Seiten fortfahren.

Wenn Sie mehr als 100 opake Kopien veröffentlichen oder verbreiten, müssen Sie entweder eine maschinenlesbare, transparente Kopie jeder opaken Kopie beilegen, oder mit bzw. in jeder opaken Kopie eine Computer-Netzwerk-Adresse angeben, von wo die allgemeine, Netzwerk benutzende Öffentlichkeit Zugriff zum Download einer kompletten transparenten Kopie über öffentliche Standardnetzwerkprotokolle hat. Wenn Sie sich für die letztere Möglichkeit entscheiden, müssen Sie mit Beginn der Verbreitung der opaken Kopien in Stückzahlen, zumutbare und vernünftige Schritte unternehmen, um sicherzustellen, dass die transparenten Kopien mindestens ein Jahr nach der Auslieferung der letzten opaken Kopie (direkt oder über einen Agenten oder Händler) dieser Ausgabe an die Öffentlichkeit, an der genannten Adresse verfügbar bleiben.

Es ist erbeten, aber nicht gefordert, dass Sie ausreichend lange vor der Auslieferung einer größeren Menge von Kopien, Kontakt mit den Autoren des Dokumentes aufnehmen, um jenen die Möglichkeit zu geben, Ihnen eine aktualisierte Version des Dokumentes zuzuleiten.

#### 4. MODIFIKATIONEN

Unter den obigen Bedingungen unter Ziffer 2 und 3 können Sie modifizierte Versionen kopieren und verbreiten, vorausgesetzt, dass Sie die modifizierte Version unter exakt dieser Lizenz herausgeben, wobei die modifizierte Version die Rolle des Dokumentes einnimmt, und dadurch die weitere Modifikation und Verbreitung an jeden lizenzieren, der eine Kopie davon besitzt. Zusätzlich müssen Sie die folgenden Dinge in der modifizierten Version beachten:

1. Benutzen Sie auf der Titelseite (und auf Umschlägen, sofern vorhanden) einen Titel, der sich von dem Titel des Dokumentes und von früheren Versionen unterscheidet. (Die früheren Versionen sollten, wenn es welche gibt, in dem Abschnitt Historie aufgelistet werden.) Sie können denselben Titel wie den einer Vorgängerversion verwenden, wenn der ursprüngliche Herausgeber damit einverstanden ist.

2. Geben Sie auf der Titelseite eine oder mehrere Personen oder Einheiten, die als Autoren auftreten können, als für die Modifikationen verantwortliche Autoren der modifizierten Version, zusammen mit mindestens fünf der ursprünglichen Autoren der Ursprungsversion an (alle vorherige Autoren, wenn es weniger als fünf sind), es sei denn, diese befreien Sie von dieser Notwendigkeit.

3. Geben Sie auf der Titelseite den Namen des Herausgebers als Herausgeber an.

4. Alle Urheberrechtshinweise des Dokuments bewahren.

5. Einen passenden Copyright-Hinweis für Ihre Modifikationen angrenzend an die anderen Copyright-Hinweise hinzufügen.

6. Schließen Sie direkt hinter den Copyright-Vermerken einen Lizenzhinweis ein, der die öffentliche Erlaubnis erteilt, die modifizierte Version unter den Bedingungen dieser Lizenz zu benutzen, wie es im Anhang weiter unten beschrieben ist.

7. Erhalten Sie im Copyright-Vermerk die komplette Liste der unveränderlichen Abschnitte und obligatorischen Umschlagtexte, die in dem Lizenzvermerk des Dokumentes aufgeführt sind.

8. Eine unveränderte Kopie dieser Lizenz einfügen.

9. Erhalten Sie den Abschnitt »Historie«. Erhalten Sie den Titel und fügen Sie einen Punkt hinzu, der mindestens den Titel, das Jahr, die neuen Autoren und Herausgeber, wie sie auf der Titelseite aufgeführt sind, enthält. Sollte es keinen Abschnitt Historie geben, dann erstellen Sie einen, der Titel, Jahr, Autor und Herausgeber des Dokumentes, wie auf der Titelseite angegeben, enthält, und fügen Sie einen Punkt hinzu, der die modifizierte Version wie oben dargestellt beschreibt.

10. Erhalten Sie die Netzwerkadresse, die angegeben wurde, um Zugang zu einer transparenten Kopie zu gewähren, sowie entsprechend angegebene Adressen früherer Versionen, auf denen das Dokument aufbaute. Diese Angaben können in den Abschnitt Historie verschoben werden. Sie können die Netzwerkadresse weglassen, wenn sie sich auf ein Werk bezieht, das mindestens 4 Jahre vor dem Dokument selbst veröffentlicht wurde, oder wenn der ursprüngliche Herausgeber der Version, auf die sich die Adresse bezieht, seine Erlaubnis erteilt.

11. Erhalten Sie für alle Abschnitte, die als »Danksagungen« oder »Widmungen« überschrieben sind, den Titel sowie die Substanz und den Ton aller vom Geber gemachten Danksagungen und/oder Widmungen in diesem Abschnitt.

12. Erhalten Sie alle unveränderlichen Abschnitte unverändert, sowohl im Titel als auch im Text. Abschnittsnummern oder dergleichen gelten hierbei nicht als Teil des Titels.

13. Löschen Sie alle Abschnitte, die als »Anmerkungen« überschrieben sind. Ein solchen Abschnitt sollte nicht in der modifizierten Version enthalten sein.

14. Benennen Sie keinen Abschnitt in »Anmerkungen« um, oder in einen Namen, der in Konflikt mit einem unveränderlichen Abschnitt gerät.

15. Alle Haftungsausschlüsse bewahren.

Wenn die Modifizierte Version neue wichtige Abschnitte enthält oder Anhänge, die Sekundäre Abschnitte darstellen, und kein Material enthalten, das aus dem Dokument kopiert wurde, dürfen Sie nach Ihrer Wahl einige oder alle diese Abschnitte als Unveränderlich bezeichnen. Um dies zu tun, fügen Sie ihre Titel der Liste der Unveränderlichen Abschnitte in dem Lizenzhinweis der Modifizierten Version hinzu. Diese Titel müssen sich von allen anderen Abschnittstiteln unterscheiden.

Sie können einen Abschnitt »Anmerkungen« anfügen, sofern dieser nichts als Bemerkungen, verschiedener Stellen, zu der modifizierten Version enthält. Beispielsweise Publikumsreaktionen oder eine Mitteilung, dass der Text von einer Organisation als maßgebliche Definition eines Standards geprüft wurde.

Sie können einen Teil mit bis zu fünf Worten als vorderen Umschlagtext und einen mit bis zu 25 Worten als hinteren Umschlagtext an das Ende der Liste mit den Umschlagtexten der modifizierten Version hinzufügen. Nur je ein Teil für den vorderen Umschlagtext und den hinteren Umschlagtext können von jeder Einheit hinzugefügt (oder durch entsprechende Anordnung erstellt) werden. Wenn das Dokument bereits einen Umschlagtext für denselben Umschlag enthält, das von Ihnen oder der Einheit, in deren Namen Sie tätig sind, bereits früher eingefügt wurde, dürfen Sie keine neue hinzufügen. Sie können aber den alten ersetzen, wenn sie die ausdrückliche Genehmigung des Herausgebers haben, der den früheren Text eingefügt hat.

Der/die Autor(en) und Herausgeber des Dokumentes geben durch diese Lizenz weder implizit noch explizit die Erlaubnis, ihren Namen für Werbung in den Anmerkungen der modifizierten Version zu benutzen.

#### 5. DOKUMENTE KOMBINIEREN

Sie können mehrere Dokumente, die unter dieser Lizenz freigegeben sind, unter den Bedingungen unter Ziffer 4 für modifizierte Versionen miteinander kombinieren, vorausgesetzt, dass in der Kombination alle unveränderlichen Abschnitte aller Originaldokumente, enthalten sind, und dass Sie diese alle in der Liste der unveränderlichen Abschnitte der Lizenzanmerkung des kombinierten Dokumentes aufführen, sowie alle Garantieausschlüsse erhalten.

Das kombinierte Werk braucht nur eine Kopie dieser Lizenz zu enthalten, und mehrere identische unveränderliche Abschnitte können durch eine einzelne Kopie ersetzt werden. Wenn es mehrere unveränderliche Abschnitte mit unterschiedlichem Inhalt, aber gleichem Namen gibt, machen Sie den Namen eindeutig, indem Sie am Ende des Titels, in Anführungszeichen, den Namen des Original-Autors oder -Herausgebers, falls bekannt, oder andernfalls eine eindeutige Nummer anhängen. Machen Sie dasselbe mit den Titeln der Abschnitte in der Liste der unveränderlichen Abschnitte im Lizenzhinweis des kombinierten Werkes.

In der Kombination müssen Sie alle Abschnitte mit dem Titel Historie in den unterschiedlichen Dokumenten zu einem einzelnen Abschnitt »Historie« zusammenführen; entsprechend verfahren Sie mit den Abschnitten »Danksagungen« und »Widmungen«. Sie müssen alle Abschnitte mit dem Titel »Anmerkungen« löschen.

#### 6. SAMMLUNGEN VON DOKUMENTEN

Sie können eine Sammlung von Dokumenten erstellen, bestehend aus diesem Dokument und weiteren, unter dieser Lizenz stehenden Dokumenten, wobei Sie die einzelnen Kopien dieser Lizenz in den verschiedenen Dokumenten durch eine einzelne Kopie, die in der Sammlung enthalten ist, ersetzen, vorausgesetzt, Sie befolgen in allen andern Punkten, für jedes der Dokumente, die Regeln für Datenträgerkopien.

Sie dürfen ein einzelnes Dokument aus einer solchen Sammlung heraustrennen, und es individuell unter dieser Lizenz verteilen, vorausgesetzt, Sie fügen eine Kopie dieser Lizenz in das herausgetrennte Dokument ein und folgen der Lizenz in jeglicher Hinsicht bezüglich dem wortwörtlichen Kopieren des Dokuments.

#### 7. AGGREGATION MIT UNABHÄNGIGEN ARBEITEN

Eine Zusammenstellung des Werkes, oder von Ableitungen davon, mit anderen, separaten und unabhängigen Dokumenten oder Werken, in oder auf demselben Band eines Speicher- oder Verbreitungsmediums, wird dann eine Aggregation genannt, wenn die Copyrights der Zusammenstellung nicht dazu verwendet werden, die Rechte der Benutzer, die für die einzelnen Werke gewährt werden, stärker zu beschränken, als dies durch die Lizenzen der einzelnen Werke geschieht. Wenn das Werk in einer Aggregation vorhanden ist, so gilt diese Lizenz nicht für die anderen Werke dieser Aggregation, die keine Ableitung des Dokumentes sind.

Wenn die Bestimmungen für die Umschlagtexte aus Ziffer 3 Anwendung finden, und wenn das Dokument weniger als die Hälfte der gesamten Aggregation ausmacht, dann können die Umschlagtexte auf Seiten gesetzt werden, die das Dokument innerhalb der Aggregation umschließen, oder auf das elektronische Äquivalent eines Umschlages, wenn das Dokument in elektronischer Form vorliegt. Andernfalls müssen sie auf gedruckten Umschlägen erscheinen, die das gesamte Werk umschließen.

#### 8. ÜBERSETZUNG

Übersetzungen werden als eine Art von Modifikationen betrachtet. Damit können Sie eine Übersetzung des Dokumentes unter den Bestimmungen von Ziffer 4 verbreiten. Um die unveränderlichen Abschnitte durch eine Übersetzung zu ersetzen, benötigen Sie die spezielle Erlaubnis des Copyright-Inhabers. Sie können allerdings Übersetzungen von einigen oder allen unveränderlichen Abschnitten zu den Original-Versionen der unveränderlichen Abschnitte hinzufügen. Sie können eine Übersetzung dieser Lizenz und allen Lizenzhinweisen im Dokument sowie allen Garantieausschlüssen hinzufügen, vorausgesetzt, dass Sie ebenso die originale englische Version dieser Lizenz und aller Hinweise und Ausschlüsse beifügen. Sollten die Übersetzung und die Originalversion dieser Lizenz oder eines Hinweises oder Ausschlusses voneinander abweichen, so hat die Originalversion Vorrang.

Wenn ein Abschnitt des Dokumentes als »Danksagung«, »Widmungen« oder »Historie« überschrieben ist, so erfordert die Forderung (Ziffer 4), den Titel dieses Abschnittes zu erhalten, die Änderung des aktuellen Titels.

#### 9. TERMINATION

Sie dürfen dieses Dokument nicht kopieren, verändern, unterlizenzieren oder verteilen mit der Ausnahme, dass Sie es ausdrücklich unter dieser Lizenz tun. Jedweder andere Versuch zu kopieren, zu modifizieren, unter zu lizenzieren oder zu verbreiten ist unzulässig und führt automatisch zum Entzug der durch diese Lizenz gewährten Rechte.

However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.

Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.

Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, receipt of a copy of some or all of the same material does not give you any rights to use it.

#### 10. ZUKÜNFTIGE REVISIONEN DIESER LIZENZ

Die Free Software Foundation kann von Zeit zu Zeit neue, überarbeitete Versionen der GNU Free Dokumentation License veröffentlichen. Diese neuen Versionen werden im Geiste gleich bleiben, können sich aber in Details unterscheiden, um neuen Problemen oder Besorgnissen gerecht zu werden. Siehe Copyleft.

Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License “or any later version” applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation. If the Document specifies that a proxy can decide which future versions of this License can be used, that proxy’s public statement of acceptance of a version permanently authorizes you to choose that version for the Document.

#### 11. NEULIZENZIERUNG

“Massive Multiauthor Collaboration Site” (or “MMC Site”) means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works. A public wiki that anybody can edit is an example of such a server. A “Massive Multiauthor Collaboration” (or “MMC”) contained in the site means any set of copyrightable works thus published on the MMC site.

“CC-BY-SA” means the Creative Commons Attribution-Share Alike 3.0 license published by Creative Commons Corporation, a not-for-profit corporation with a principal place of business in San Francisco, California, as well as future copyleft versions of that license published by that same organization.

“Incorporate” means to publish or republish a Document, in whole or in part, as part of another Document.

An MMC is “eligible for relicensing” if it is licensed under this License, and if all works that were first published under this License somewhere other than this MMC, and subsequently incorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections, and (2) were thus incorporated prior to November 1, 2008.

The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SA on the same site at any time before August 1, 2009, provided the MMC is eligible for relicensing.

#### ANHANG: Wie Sie diese Lizenz für Ihre Dokumente verwenden können

Um diese Lizenz in einem von Ihnen geschriebenen Dokument nutzen zu können, fügen Sie eine Kopie der Lizenz in das Dokument ein und setzen Sie die folgenden Copyright- und Lizenzhinweise gleich hinter die Titelseite:

    Copyright © JAHR IHR NAME

    Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free Documentation License (GFDL), Version 1.3 oder jeder neueren, von der Free Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt und/oder modifiziert werden. Eine Kopie der Lizenz finden Sie im Abschnitt »GNU Free Documentation License«.

Wenn Sie unveränderlichen Abschnitte, vordere und hintere Umschlagtexte haben, ersetzen Sie »ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel« durch Folgendes:

    mit den unveränderlichen Abschnitten TITEL HIER AUFLISTEN, mit den vorderen Umschlagtexten HIER AUFLISTEN und den hinteren Umschlagtexten HIER AUFLISTEN,

Wenn Sie unveränderliche Abschnitte, aber keine Umschlagtexte oder irgend eine andere Kombination der drei Bereiche haben, mischen Sie die verschiedenen Alternativen, dass sie zu Ihren Anforderungen passen.

Wenn Ihr Dokument nicht-triviale Codebeispiele enthält, empfehlen wir diese Beispiele parallel unter einer freien Softwarelizenz Ihrer Wahl, beispielsweise der GNU General Public License, zu lizenzieren, um ihren Gebrauch in freier Software zu erlauben.

Nautilus
Nemo
FileManager-Actions