# Benutzerhandbuch für das Caja-Aktionen Konfigurationswerkzeug

2010 2011 2012 2013 2014 Pierre Wieser
2013 2014 Wolfgang Ulbrich

Caja-Aktionen ist eine Erweiterung für Caja, deren vorrangige Funktion es ist, dem Benutzer das Hinzufügen eigener Aktionen zu den Kontextmenüs des Dateimanagers zu ermöglichen. Diese Aktionen können in Menüs und Untermenüs angeordnet werden, exportiert und mit anderen Arbeitsumgebungen gemeinsam genutzt werden.

Dieses Handbuch beschreibt die Benutzeroberfläche des Caja-Aktionen Konfigurationswerkzeugs und erklärt die Konfiguration der Menüs und Aktionen, insbesondere deren Anzeige und Anwendung abhängig von den jeweiligen Bedingungen.

Dieses Handbuch beschreibt Version 3.2 des Caja-Aktionen Konfigurationswerkzeugs.
GNOME-Dokumentationsprojekt MATE Documentation Project
Pierre Wieser pwieser@trychlos.org
Wolfgang Ulbrich chat-to-me@raveit.de
Caja-Actions Configuration Tool User's Manual v 3.1
May 2011

Pierre Wieser pwieser@trychlos.org

Caja-Actions Configuration Tool User's Manual v 3.2
January 2012

Pierre Wieser pwieser@trychlos.org

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.3 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

Das vorliegende Handbuch ist Teil einer Reihe von MATE-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 MATE-Dokumentation vorkommen und wenn die Mitglieder des MATE-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

Caja-Aktionen ist eine Erweiterung für Caja, deren vorrangige Funktion es ist, dem Benutzer das Hinzufügen eigener Aktionen zu den Kontextmenüs des Dateimanagers zu ermöglichen. Diese Aktionen können in Menüs und Untermenüs angeordnet werden, exportiert und mit anderen Arbeitsumgebungen gemeinsam genutzt werden.

Das Caja-Actions Konfigurationswerkzeug ist eine Benutzerschnittstelle, die Sie bestimmen lässt, wie wo und wann Ihre Aktionen in den Kontextmenüs von Caja erscheinen sollen und wie sie ausgeführt werden.

Das Caja-Actions Konfigurationswerkzeug verfügt über folgende Funktionsmerkmale:

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

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

- Ein Plugin für Caja, welches in Echtzeit die aktuell ausgewählten Dateien zum D-Bus-Dienst exportiert.

- 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 Caja-Actions Konfigurationswerkzeugs beschrieben.

## Erste Schritte

### Das Caja-Actions Konfigurationswerkzeug starten

Sie können das Caja-Actions Konfigurationswerkzeug auf folgende Arten starten:

Menü System

  Wählen Sie Einstellungen Darstellung Einstellungen für Caja-Aktionen.

Befehlszeile

  Um das Caja-Actions Konfigurationswerkzeug in einer Befehlszeile zu starten, geben Sie folgenden Befehl ein:

  ``caja-actions-config-tool``

  und drücken dann die Eingabetaste.

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

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

  und drücken dann die Eingabetaste.

### Der erste Start

Beim Start des Caja-Actions Konfigurationswerkzeugs wird folgendes Fenster angezeigt.

Startfenster des Caja-Actions Konfigurationswerkzeugs

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.

Das Hauptfenster des Caja-Actions Konfigurationswerkzeugs enthält die folgenden Elemente:

Menüleiste.

  Die Menüs in der Menüleiste enthalten alle Befehle, die Sie im Caja-Actions Konfigurationswerkzeug benötigen.

  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.

  Verschiedene Werkzeugleisten können unterhalb der Menüleiste angezeigt werden, abhängig von Ihren Einstellungen im Menü Ansicht Werkzeugleisten.

Objektliste.

  Die Liste an der linken Seite des Hauptfensters enthält alle Objekte, gleich ob es sich um Aktionen oder Menüs handelt, die aktuell zur Bearbeitung im Caja-Actions Konfigurationswerkzeug zur Verfügung stehen.

  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ü

    Legen Sie fest, in welchen Caja-Menüs das Objekt erscheinen soll und auf welche Weise es angezeigt wird.

  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

    Legen Sie die Filter für Basisnamen fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  MIME-Typen

    Legen Sie die Filter für MIME-Typen fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  Ordner

    Legen Sie die Filter für Ordner fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  Schemata

    Legen Sie die Schema-Filter fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  Fähigkeiten

    Legen Sie die Filter für Fähigkeiten fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  Umgebung

    Legen Sie einige Umgebungsbedingungen fest, denen die Auswahl in Caja entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.

  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.

  Das Symbol für »schreibgeschützt« wird im rechten Teil der Statuszeile angezeigt, sofern zutreffend.

### 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 MateDialog.

MateDialog 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:

``matedialog``

und drücken dann die Eingabetaste.

Erstellen der Aktion

Um eine neue Aktion zu erstellen, wählen Sie Ctrl N Datei Neue Aktion.

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.

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.

Eine weitere Erinnerung daran, dass es ungespeicherte Änderungen gebt, ist ein Asterisk (`*`), der dem Anwendungsnamen in der Titelzeile vorangestellt wird.

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.

  Diese Bezeichnung ist eine obligatorische Eigenschaft. Falls sie leer ist, dann wird Ihre Aktion durch Caja-Actions 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.

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

- Geben Sie `matedialog` 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

Um sämtliche ausstehenden Änderungen zu speichern, wählen Sie Strg S Datei Speichern.

Caja berücksichtigt Ihre neue Aktion automatisch und zeigt Sie in seinem Kontextmenü an.

Ihre erste Aktion im Kontextmenü von Caja

Shows the first action in the Caja context menu.

Durch Anklicken des Objekts im Kontextmenü von Caja wird es aktiviert und der zugehörige Befehl ausgeführt.

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.

## Caja-Actions Konfigurationswerkzeug verwenden

### Definieren der Bedingungen

Ob Ihre Aktion tatsächlich in den Kontextmenüs der Dateiverwaltung Caja oder in dessen Werkzeugleiste angezeigt wird, hängt von den Bedingungen ab, die Sie dafür definiert haben.

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 Caja-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.

#### 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.

Faktisch werden auf Basisnamen basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Basisnamen basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der Basisname jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

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.

     Eine auf dem Basisnamen beruhende Bedingung darf die Platzhalterzeichen `*` oder `?` enthalten.

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   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.

Per Voreinstellung ist eine Filterbedingung »`muss einem von * entsprechen`«. Weil alle Basisnamen immer die Bedingung »`*`« erfüllen bedeutet dies, dass auf Basisnamen basierende Filterbedingungen als nicht relevant für die Aktion angesehen werden.

#### 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.

Faktisch werden auf dem MIME-Typ basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf dem MIME-Typ basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der MIME-Typ jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

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 dem MIME-Typ basierenden Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf dem MIME-Typ basierenden Bedingungen gegen den MIME-Typ des aktuellen Orts angewendet. Letzter ist der sehr bekannte MIME-Typ »inode/directory«.

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.

     Der Platzhalter `*` wird nur in einigen Situationen unterstützt:

     - Der Ausdruck `*/*` trifft auf alle MIME-Typen zu. Als bequeme Abkürzung wird das Literal `*` für den gleichen Zweck akzeptiert.

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

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

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   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.

Per Voreinstellung ist eine auf einem MIME-Typ basierende Filterbedingung »`muss einem von */* entsprechen`«. Weil alle Basisnamen immer die Bedingung »`*/*`« erfüllen, bedeutet dies, dass MIME-Typen als nicht relevant für die Aktion angesehen werden.

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.

Tatsächlich werden auf Ordnern basierende Bedingungen als eine Liste von »Muss einem entsprechen von« und »Darf keinem entsprechen von« erstellt. Damit Ihre Aktion auf Ordnern basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Jedes Element muss sich in einem der unter »muss mit einem von … übereinstimmen« aufgeführten Ordner befinden und darf nicht mit einem der unter »darf nicht mit einem von … übereinstimmen« aufgeführten Ordnernamen übereinstimmen.

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.

     Die Zeichen `*` und `?` werden auf jeder Ebene des definierten Ordnerfilters als Platzhalter akzeptiert.

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

2. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   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.

Per Voreinstellung ist eine auf Ordnern basierende Filterbedingung »`muss einem von / entsprechen`«. Weil »`/`« immer die oberste Ebene eines Unix-ähnlichen Dateisystems ist, erfüllen alle gewählten Objekte immer diese Bedingung.

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.

Faktisch werden auf Schemata basierte Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Basisnamen basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Der Basisname jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

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.

     Auf Schemata basierende Bedingungen akzeptieren nur den Platzhalter »`*`«, welcher »Jedes Schema« bedeutet.

   - Oder klicken Sie auf Allgemein, um eines der unter Bearbeiten Einstellungen definierten Schemata auszuwählen.

     Auswahl eines Schemas aus vordefinierten Schemata

     Show the list of predefined schemes.

     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. Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   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.

Per Voreinstellung entspricht eine auf Schemata basierende Filterbedingung »`muss einem von * entsprechen`«. Dies bedeutet, dass Schemata für diese Aktion nicht relevant sind.

#### Auf Fähigkeiten basierende Bedingungen

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

Ausser für eine `Local` Fähigkeit, alle anderen hängen vom Benutzer ab der diesen Befehl ausführt.

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.

Faktisch werden auf Fähigkeiten basierende Bedingungen als eine Liste aus Mustern erstellt, die entweder die Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« haben. Damit Ihre Aktion auf Fähigkeiten basierende Bedingungen verarbeiten kann, muss jedes Element der Auswahl für eine der aufgelisteten Bedingungen gültig sein: Die Fähigkeit jedes Elements muss auf mindestens eines der »muss mit einem von … übereinstimmen«-Muster passen und darf nicht auf eines der »darf nicht mit einem von … übereinstimmen«-Muster passen.

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.

     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. Gibt an, ob es sich um eine Bedingung der Form »muss mit allen von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.

   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

Falls Ihre Aktion aus der Anzeige der Unterschiede zwischen zwei Dateien besteht, können Sie hier beispielsweise `Anzahl = (entspricht) 2` angeben.

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.

Die Bedingung Anzahl der Auswahl wird im Feld 'Erscheint, wenn die Auswahl enthält' definiert.

Bereich für den Auswahlzähler

Focus on the Appears if selection contains 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.

Die Auswahlanzahl hat als Voreinstellung »`Anzahl > (streng größer als) 0`«. Dies bedeutet, dass die Aktion als Kandidat zum Anzeigen in Frage kommt, sobald mehr als ein Objekt in der Dateiverwaltung ausgewählt ist.

#### 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.

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.

Die für Arbeitsumgebungen bestimmten Bedingungen haben als Voreinstellung »`Immer erscheinen`«. Dies bedeutet, dass die Aktion unabhängig von der laufenden Arbeitsumgebung als Kandidat zum Anzeigen in Frage kommt.

#### 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.

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.

Die Dateiverwaltung Caja zeigt u.U. Ihre Aktion an verschiedenen Stellen an, je nach dem, was Sie hier angeben und welche Objekte ausgewählt sind.

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

#### Eintrag in das Kontextmenü der Auswahl

Wenn das Ankreuzfeld Objekt im Kontextmenü der Auswahl anzeigen ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für das Caja-Kontextmenü, sofern mindestens ein Objekt in der Dateiverwaltung ausgewählt ist. Ihre Aktion arbeitet mit den jeweils aktuell ausgewählten Objekt(en). Damit sie auch tatsächlich angezeigt wird, müssen allen Bedingungen der in Frage kommenden Aktion durch jedes aktuell gewählte Objekt erfüllt werden, das in der Dateiverwaltung Caja ausgewählt ist.

Wenn eine Aktion für das Kontextmenü einer Auswahl vorgesehen ist und auch in einem Kontextmenü von Caja angezeigt wird, dann wird sie auch im Menü Bearbeiten von Caja angezeigt.

Dieses Ziel wird per Voreinstellung ausgewählt.

#### Eintrag in das Kontextmenü des Orts

Wenn das Ankreuzfeld Objekt im Kontextmenü des Orts anzeigen ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für das Caja-Kontextmenü, sofern kein Objekt in der Dateiverwaltung ausgewählt ist. Ihre Aktion arbeitet mit dem jeweils aktuellen Ort. Damit sie auch tatsächlich angezeigt wird, müssen allen Bedingungen der in Frage kommenden Aktion durch den aktuellen Ort erfüllt werden, der in der Dateiverwaltung Caja geöffnet ist.

Wenn eine Aktion für das Kontextmenü eines Orts vorgesehen ist und auch tatsächlich in einem Kontextmenü von Caja angezeigt wird, dann wird sie auch im Menü Datei von Caja angezeigt.

#### Eintrag in die Werkzeugleiste

Wenn das Ankreuzfeld Objekt in der Werkzeugleiste anzeigen ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für die Caja-Werkzeugleiste.

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

Legt fest, ob es das Kontextmenü der Auswahl oder das Kontextmenüs des Orts ist. Es wird im Caja-Kontextmenü und in den Menüs Datei und Bearbeiten angezeigt als

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

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

Das Wort »zuerst« kann verwirrend sein, weil es sich nur auf die interne Liste der gewählten Objekte der Dateiverwaltung bezieht, welche an das Plugin Caja-Aktionen übergeben wird.

Genau genommen hat es nichts zu tun mit der visuellen Auswahl, die Sie im Fenster der Dateiverwaltung treffen. Tatsächlich ist das erste gewählte Objekt einer Mehrfachauswahl nicht definiert und damit unvorhersagbar.

#### 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.

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

Im speziellen Fall eines `%d`-Parameters ist das erste gewählte Objekt nicht von Bedeutung, weil man davon ausgehen kann, dass alle gewählten Objekte im selben Basisordner sind.

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

Neben der Konfiguration der Bedingungen, denen die Auswahl entsprechen muss, damit die Aktion in den Menüs der Dateiverwaltung angezeigt wird, ermöglicht Ihnen Caja-Aktionen festzulegen, wie Ihr Befehl genau ausgeführt wird.

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.

##### Ausführungsmodus

Konfiguration des Ausführungsmodus

Focus on the execution mode frame.

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.

  Weil Caja diese Funktion nicht bietet, ist diese Option identisch zur `Terminal`-Option.

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.

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.

Lesen Sie auch Startup Notification Protocol Specification für weitere Informationen.

##### 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.

Lesen Sie auch Startup Notification Protocol Specification für weitere Informationen.

##### Befehlsausführer

Konfiguration des Besitzers der Ausführung

Focus on the Execute as frame.

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 Caja-Aktionen diese beiden Verhalten automatisch, abhängig von Form und Reihenfolge der Parameter in den Argumenten der Befehlszeile.

Obwohl einige Parameter nicht abhängig von der Anzahl der Auswahl sind, (z.B. « `%c` », die auswählte Anzahl selber), haben die meisten zwei Deklinationen:

- ein « Einzelnes », z.B. « `%b` », der Basisname des ausgewählten Elements;

- ein « Mehrfaches », z.B. « `%B` », die durchLeerzeichen getrennte Liste der Basisnamen der ausgewählten Elemente.

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:

- wenn der erste relevante Parameter die Form Einzelnes hat wird Caja-Actions berücksichtigen, das der Befehl nur in der Lage ist ein Element zu einem Zeitpunkt zu behandeln, und dadurch einmal für jeden ausgewähltem Eintrag laufen muss;

- Im Gegensatz dazu, wenn der erste relevante Parameter die Form eines Mehrfachen hat, wird Caja-Actions berüpcksichtigen, das der Befehl in der Lage ist mehrere Elemente zu behandeln und dadurch nur einmal ausgeführt wird;

- falls alle gefundenen Parameters irrelevant sind, dann geht Caja-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.

Zur Laufzeit untersucht Caja-Aktionen jedes mit der Aktion verknüpfte Profil nacheinander. Falls das erste Profil auf eine Datei abzielt und ein Ordner gewählt ist, dann wird Caja-Aktionen Ihr zweites Profil abarbeiten.

Um ein neues Profil anzulegen, wählen Sie zunächst die Aktion in der Objektliste aus und wählen Sie dann Datei Neues Profil.

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 Caja-Aktionen mit der Untersuchung der Bedingungen, die der Aktion zugeschrieben sind.

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

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

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.

Profile einer Aktion sind sortiert, und werden in dieser Reihenfolge zur Laufzeit ausgeführt. Das erste Profil dessen Bedingungen erfüllt sind, wird validiert werden und ist im Caja Kontextmenü auswählbar.

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.

Wählen Sie Datei Neues Menü zum Erstellen eines neuen Menüs.

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:

  Das neue Menü wird an der passenden Stelle mit der vorgegebenen Beschriftung `Neues Caja-Menü` eingefügt

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

Als Aktion hat auch ein Menü eine Beschriftung und optional ein Symbol und eine Mini-Hilfe. Bei Bedarf können Bedingungen festgelegt werden, damit Ihr Menü ein Kandidat für das Caja-Kontextmenü wird. Falls die Bedingungen zur Programmlaufzeit nicht erfüllt werden, so wird das gesamte Menü einschließlich aller Untermenüs nicht dargestellt.

### Die Objektliste sortieren

Ihre Aktionen und Menüs werden im Kontextmenü der Dateiverwaltung in derselben Reihenfolge dargestellt, wie in der Objektliste in der linken Seitenleiste des Fensters Einstellungen für Caja-Aktionen .

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.

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.

Das ist gleichwohl der Fall, wenn eine Aktion ausgewählt ist, und nicht erweitert worden ist, oder derzeit nur ein Profil hat. Mit dem Einfügen eines neuen Profil legten Sie es nicht vor der Aktion an, aber in der Aktion.

So wählen Sie diesen Modus:

- Klicken Sie auf den -Knopf.

- Oder bearbeiten Sie bitte die entsprechende Einstellung.

### Bearbeiten

Mit dem Caja-Actions Konfigurationswerkzeug können Sie zuverlässig in die Zwischenablage ausschneiden und kopieren oder von dort einfügen.

#### 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

Mehrfachauswahl ist in den Einstellungen für Caja-Aktionen möglich. Die bestehende Auswahl wird durch Drücken von Strg oder Umschalttaste und Klicken auf ein hinzuzufügendes Objekt erweitert.

Die Einstellungen für Caja-Aktionen akzeptieren nur homogene Mehrfachauswahlen. Das heißt, es dürfen nur ein oder mehrere Profile oder ein oder mehrere Menüs ausgewählt werden. Eine Mehrfachauswahl mit einer Mischung beider ist nicht gestattet. Hintergrund ist, dass die Einstellungen für Caja-Aktionen nicht mit einer solchen Auswahl umgehen können.

Beachten Sie, dass Sie mit einer Zeile zugleich die Unterelemente der Reihe auswählen. Diese werden »implizit ausgewählt«: Sie sind Teil der nachfolgenden Vorgänge, werden aber bei der Prüfung auf Homogenität nicht berücksichtigt. Sie können ebensowenig explizit ausgewählt werden (oder abgewählt).

### Speichern Ihrer Änderungen

Um Ihre Änderungen zu speichern, wählen Sie Strg S Datei Speichern.

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

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

### Exportieren Ihrer Aktionen

### Importieren von Aktionen

### Festlegen Ihrer persönlichen Einstellungen

Wählen Sie Bearbeiten Einstellungen, um Ihre Einstellungen bearbeiten zu können.

#### Laufzeiteinstellungen

Laufzeiteinstellungen

Shows the tab which lets you define runtime preferences.

#### Einstellungen der Ausführungszeit

Einstellungen der Ausführungszeit

Shows the tab which lets you define runtime execution preferences.

Auswahl der Arbeitsumgebung

Let the user explicitely configure the current desktop.

#### Einstellungen der Benutzeroberfläche

Einstellungen der grafischen Oberfläche

Shows the tab which lets you define UI preferences.

#### Importeinstellungen

Importeinstellungen

Shows the tab which lets you define import preferences.

#### Exporteinstellungen

Exporteinstellungen

Shows the tab which lets you define export preferences.

#### Einstellungen für Schemata

Einstellungen für Schemata

Shows the tab which lets you define schemes preferences.

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

Einstellungen für Ein-/Ausgabetreiber

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

## Verschiedene Informationen

Die neue Aktion wird rot in der Objektliste dargestellt. Rote Farbe bedeutet, dass das Objekt ungültig ist, was zur Folge hat, dass es nicht für die Anzeige in einem Kontextmenü von Caja in Frage kommt. Einige Informationen fehlen oder sind fehlerhaft. In diesem Fall fehlt trotz bereits vorhandener Voreinstellungen ein auszuführender Befehl, der von Einstellungen für Caja-Aktionen als gültig angesehen wird.

## Bekannte Fehler und Einschränkungen

### Bekannte Fehler

Über bekannte Fehler erfahren Sie in der Bugzilla-Fehlererfassungssystem.

Sollten Sie neue Fehler in Caja-Aktionen finden, so bitten wir diesen per Web-Browser auf der Seite Bugzilla zu melden.

### Bekannte Einschränkungen

Ausführungsmodus

Ab Version 3.0 ist es möglich, den Ausführungsmodus im Einstellungswerkzeug von Caja-Actions einzustellen, aber er wird noch nicht vom Caja-Plugin berücksichtigt.

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

Vorgeschlagene Tastenkombination

Ab Version 3.0 können vorgeschlagene Tastenkürzel – wie in der DES-EMA Spezifikation beschrieben – nicht im Konfigurationswerkzeug von Caja-Aktionen eingestellt werden. Sie werden auch nicht vom Caja-Plugin ausgewertet.

Menütrenner

Ab Version 3.0 können Menütrenner nicht im Konfigurationswerkzeug von Caja-Aktionen konfiguriert werden. Sie werden auch nicht vom Caja-Plugin ausgewertet.

Bedenken Sie, dass derzeit die Dateiverwaltung Caja es Plugins nicht erlaubt, Trenner in Kontextmenüs festzulegen.

## Info zum Caja-Aktionen-Konfigurationswerkzeug

Die erste Version von Caja-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).

Um Fehler zu melden oder Vorschläge für Caja-Actions, das Konfigurationswerkzeug für Caja-Actions oder dieses Handbuch einzureichen, folgen Sie bitte den Anweisungen auf der MATE-Seite für Rückmeldungen. Auf Wunsch können Sie auch direkt Fehlermeldungen oder Verbesserungswünsche auf der Bugzilla-Webseite melden.

## 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.

Caja
Caja-Actions