文件操作 - index.docbook
返回文件管理
返回主菜单
删除本文件
文件: /usr/share/help/de/caja-actions-config-tool/index.docbook
编辑文件内容
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!-- name and version of the application --><!ENTITY prodname "<productname>Caja-Actions</productname>"> <!ENTITY appnamex "Caja-Actions Configuration Tool"> <!ENTITY appname "<application>&appnamex;</application>"> <!ENTITY appversion "3.2"> <!-- revision number and release date of this manual --><!ENTITY manrevision "3.2"> <!ENTITY mandate "January 2012"> <!-- product name used --><!ENTITY caja "<productname>Caja</productname>"> <!ENTITY windows "<productname>Windows</productname>"> <!ENTITY matedialog "<productname>MateDialog</productname>"> <!-- some user-defined internal entities merely because it appears that xsltproc may sometimes loose its path to the DocBook DTD --><!ENTITY laquosp "« "> <!ENTITY spraquo " »"> <!-- other entities --><!ENTITY asterisk "«sp;<literal>*</literal>&spraquo;"> <!ENTITY question_mark "«sp;<literal>?</literal>&spraquo;"> <!ENTITY must_match "«sp;must match one of&spraquo;"> <!ENTITY must_not_match "«sp;must not match any of&spraquo;"> <!-- the synopsys of the document --><!ENTITY articleinfo SYSTEM "articleinfo.xml"> <!ENTITY legalnotice SYSTEM "legalnotice.xml"> <!ENTITY starting SYSTEM "cact-starting.xml"> <!ENTITY conditions SYSTEM "cact-conditions.xml"> <!ENTITY where SYSTEM "cact-where.xml"> <!ENTITY execution SYSTEM "cact-execution.xml"> <!ENTITY profiles SYSTEM "cact-profiles.xml"> <!ENTITY menus SYSTEM "cact-menus.xml"> <!ENTITY sorting SYSTEM "cact-sorting.xml"> <!ENTITY edit SYSTEM "cact-edit.xml"> <!ENTITY save SYSTEM "cact-save.xml"> <!ENTITY export SYSTEM "cact-export.xml"> <!ENTITY import SYSTEM "cact-import.xml"> <!ENTITY preferences SYSTEM "cact-prefs.xml"> <!ENTITY properties SYSTEM "cact-properties.xml"> <!ENTITY misc-infos SYSTEM "cact-misc.xml"> <!ENTITY bugs SYSTEM "cact-bugs.xml"> <!ENTITY gnu-fdl SYSTEM "appendix-gnu-fdl-1.3.xml"> ]> <!-- ========================= Document Header ======================== --> <!-- Please do not change the id! For translations, change lang to appropriate code --> <article id="index" lang="de"> <articleinfo lang="en"> <title lang="en"><application>Caja-Actions Configuration Tool</application> User's Manual</title> <copyright lang="en"> <year>2010</year> <year>2011</year> <year>2012</year> <year>2013</year> <year>2014</year> <holder>Pierre Wieser</holder> </copyright> <copyright lang="en"> <year>2013</year> <year>2014</year> <holder>Wolfgang Ulbrich</holder> </copyright> <abstract role="description"> <para lang="en"> <productname>Caja-Actions</productname> is a <productname>Caja</productname> 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. </para> <para lang="en"> This manual describes the <application>Caja-Actions Configuration Tool</application> user interface, and explains how you may configure your menus and actions, making them be displayed and applied depending on specific conditions. </para> </abstract> <releaseinfo revision="3.2" role="stub" lang="en"> This manual describes version 3.2 of Caja-Actions Configuration Tool. </releaseinfo> <publisher> <publishername lang="en">GNOME Documentation Project</publishername> </publisher> <publisher> <publishername lang="en">MATE Documentation Project</publishername> </publisher> <authorgroup> <author role="maintainer" lang="en"> <firstname>Pierre</firstname> <surname>Wieser</surname> <email>pwieser@trychlos.org</email> </author> <author role="maintainer" lang="en"> <firstname>Wolfgang</firstname> <surname>Ulbrich</surname> <email>chat-to-me@raveit.de</email> </author> <!-- This is appropriate place for other contributors: translators, maintainers, etc. Commented out by default. <othercredit role="translator"> <firstname>Latin</firstname> <surname>Translator 1</surname> <affiliation> <orgname>Latin Translation Team</orgname> <address> <email>translator@gnome.org</email> </address> </affiliation> <contrib>Latin translation</contrib> </othercredit> --> </authorgroup> <!-- According to GNU FDL, revision history is mandatory if you are modifying/reusing someone else's document. If not, you can omit it. Remember to remove the 3.2 entity from the revision entries other than the current revision. The revision numbering system for MATE manuals is as follows: * the revision number consists of two components * the first component of the revision number reflects the release version of the MATE desktop. * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. For example, if the MATE desktop release is V2.x, the first version of the manual that is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. When the desktop release version changes to V3.x, the revision number of the manual changes to V3.0, and so on. --> <revhistory> <revision lang="en"> <revnumber>Caja-Actions Configuration Tool User's Manual v 3.1</revnumber> <date>May 2011</date> <revdescription> <para role="author" lang="en"> Pierre Wieser <email>pwieser@trychlos.org</email> </para> </revdescription> </revision> <revision lang="en"> <revnumber>Caja-Actions Configuration Tool User's Manual v 3.2</revnumber> <date>January 2012</date> <revdescription> <para role="author" lang="en"> Pierre Wieser <email>pwieser@trychlos.org</email> </para> </revdescription> </revision> </revhistory> legalnotice.xml </articleinfo> <indexterm zone="index" lang="en"> <primary><productname>Caja</productname></primary> </indexterm> <indexterm zone="index" lang="en"> <primary><productname>Caja-Actions</productname></primary> </indexterm> <!-- =========================== Document Body ======================== --> <!-- =========================== Introduction ========================= --> <!-- Use the Introduction section to give a brief overview of what the application is and what it does. --> <sect1 id="introduction"> <title>Einführung</title> <para><productname>Caja-Aktionen</productname> ist eine Erweiterung für <productname>Caja</productname>, 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.</para> <para>Das <application>Caja-Actions Konfigurationswerkzeug</application> ist eine Benutzerschnittstelle, die Sie bestimmen lässt, wie wo und wann Ihre Aktionen in den Kontextmenüs von <productname>Caja</productname> erscheinen sollen und wie sie ausgeführt werden.</para> <para>Das <application>Caja-Actions Konfigurationswerkzeug</application> verfügt über folgende Funktionsmerkmale:</para> <itemizedlist> <listitem> <para>Definieren und Konfigurieren von Aktionen von Null an.</para> </listitem> <listitem> <para>Organisieren von Aktionen in Menüs und Untermenüs usw.</para> </listitem> <listitem> <para>Importieren und Exportieren von Aktionen aus der und in die Welt außerhalb Ihrer Arbeitsumgebung.</para> </listitem> </itemizedlist> <note> <para><application>Caja-Actions</application> bringt noch weitere Funktionen mit, wie beispielsweise:</para> <itemizedlist> <listitem> <para>Ein Plugin für <application>Caja</application>, welches in Echtzeit die aktuell ausgewählten Dateien zum D-Bus-Dienst exportiert.</para> </listitem> <listitem> <para>Ein Befehlszeilenprogramm, das fähig ist, irgendeine Aktion auszuführen.</para> <para>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.</para> </listitem> <listitem> <para>Ein Befehlszeilenprogramm, welches in der Lage ist, eine neue Aktion zu starten.</para> </listitem> </itemizedlist> <para>Alle diese Funktionsmerkmale werden eingehend in der globalen Dokumentation des <application>Caja-Actions Konfigurationswerkzeugs</application> beschrieben.</para> </note> </sect1> <!-- ========================= Getting Started ======================== --> <!-- Use the Getting Started section to describe the steps required to start the application and to describe the user interface components of the application. If there is other information that it is important for readers to know before they start using the application, you should also include this information here. If the information about how to get started is very short, you can include it in the Introduction and omit this section. --> <sect1 id="getting-started"> <title>Erste Schritte</title> <sect2 id="getting-started-starting"> <title>Das <application>Caja-Actions Konfigurationswerkzeug</application> starten</title> <para>Sie können das <application>Caja-Actions Konfigurationswerkzeug</application> auf folgende Arten starten:</para> <variablelist> <varlistentry> <term>Menü <guimenu>System</guimenu></term> <listitem> <para>Wählen Sie <menuchoice><guisubmenu>Einstellungen</guisubmenu><guisubmenu>Darstellung</guisubmenu><guimenuitem>Einstellungen für Caja-Aktionen</guimenuitem></menuchoice>.</para> </listitem> </varlistentry> <varlistentry> <term>Befehlszeile</term> <listitem> <para>Um das <application>Caja-Actions Konfigurationswerkzeug</application> in einer Befehlszeile zu starten, geben Sie folgenden Befehl ein:</para> <para lang="en"> <command><filename>caja-actions-config-tool</filename></command> </para> <para>und drücken dann die <keycap>Eingabetaste</keycap>.</para> <tip> <para>Um die verfügbaren Befehlszeilenoptionen anzuzeigen, rufen Sie folgendes Argument auf:</para> <para lang="en"> <command> <filename>caja-actions-config-tool</filename> <option>--help-all</option> </command> </para> <para>und drücken dann die <keycap>Eingabetaste</keycap>.</para> </tip> </listitem> </varlistentry> </variablelist> <sect2 id="getting-started-first-run"> <title>Der erste Start</title> <para>Beim Start des <application>Caja-Actions Konfigurationswerkzeugs</application> wird folgendes Fenster angezeigt.</para> <figure id="cact-FIG-main-empty"> <title>Startfenster des <application>Caja-Actions Konfigurationswerkzeugs</application></title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-main-empty.png" format="PNG"/> </imageobject> <textobject> <phrase> Shows <application>Caja-Actions Configuration Tool</application> main window. Contains menubar, toolbar, display area, an empty items list in the left, several disabled properties tabs, and statusbar. </phrase> </textobject> </mediaobject> </screenshot> </figure> <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, for example, the items on the menubar and on the toolbar. This section is optional. --> <para>Das Hauptfenster des <application>Caja-Actions Konfigurationswerkzeugs</application> enthält die folgenden Elemente:</para> <variablelist> <varlistentry> <term>Menüleiste.</term> <listitem> <para>Die Menüs in der Menüleiste enthalten alle Befehle, die Sie im <application>Caja-Actions Konfigurationswerkzeug</application> benötigen.</para> <para>Für einige Befehle sind Schnellzugriffe verfügbar:</para> <variablelist> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>N</keycap> </keycombo> </term> <listitem> <para>Eine neue Aktion hinzufügen.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>S</keycap> </keycombo> </term> <listitem> <para>Geänderte Aktionen und Menüs speichern</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>Q</keycap> </keycombo> </term> <listitem> <para>Die Anwendung beenden.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>X</keycap> </keycombo> </term> <listitem> <para>Die aktuelle Auswahl ausschneiden, jedoch in der Zwischenablage behalten.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>C</keycap> </keycombo> </term> <listitem> <para>Die aktuelle Auswahl in die Zwischenablage kopieren.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Ctrl</keycap> <keycap>V</keycap> </keycombo> </term> <listitem> <para>Den Inhalt der Zwischenablage vor der aktuellen Position einfügen.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Shift</keycap> <keycap>Ctrl</keycap> <keycap>V</keycap> </keycombo> </term> <listitem> <para>Den Inhalt der Zwischenablage als Unterelement(e) des aktuellen Objekts einfügen.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>Delete</keycap> </keycombo> </term> <listitem> <para>Die momentane Auswahl löschen.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>F5</keycap> </keycombo> </term> <listitem> <para>Aktionen und Menüs neu laden.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <keycombo> <keycap>F1</keycap> </keycombo> </term> <listitem> <para>Hilfe anzeigen.</para> </listitem> </varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry> <term>Werkzeugleiste.</term> <listitem> <para>Verschiedene Werkzeugleisten können unterhalb der Menüleiste angezeigt werden, abhängig von Ihren Einstellungen im Menü <menuchoice><guimenu>Ansicht</guimenu><guimenuitem>Werkzeugleisten</guimenuitem></menuchoice>.</para> </listitem> </varlistentry> <varlistentry> <term>Objektliste.</term> <listitem> <para>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 <application>Caja-Actions Konfigurationswerkzeug</application> zur Verfügung stehen.</para> <para>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.</para> <para>Ungültige Einträge werden in roter Farbe dargestellt.</para> <para>Geänderte Objekte werden in kursiver Schrift dargestellt.</para> </listitem> </varlistentry> <varlistentry> <term>Sortierknöpfe</term> <listitem> <para>Drei Knöpfe ermöglichen Ihnen das Umschalten zwischen den Sortierungsmodi.</para> </listitem> </varlistentry> <varlistentry> <term>Reiter für Eigenschaften.</term> <listitem> <para>Im rechten Teil des Hauptfensters wird alles angezeigt, was zum Definieren benötigt wird, wie, wann und wo Menüs angezeigt werden sollen.</para> <variablelist> <varlistentry> <term>Aktion/Menü</term> <listitem> <para>Legen Sie fest, in welchen <productname>Caja</productname>-Menüs das Objekt erscheinen soll und auf welche Weise es angezeigt wird.</para> </listitem> </varlistentry> <varlistentry> <term>Befehl</term> <listitem> <para>Legen Sie fest, welcher Befehl ausgeführt wird und welche Parameter übergeben werden sollen.</para> </listitem> </varlistentry> <varlistentry> <term>Ausführung</term> <listitem> <para>Geben Sie an, wie der Befehl ausgeführt werden soll.</para> </listitem> </varlistentry> <varlistentry> <term>Basisnamen</term> <listitem> <para>Legen Sie die Filter für Basisnamen fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>MIME-Typen</term> <listitem> <para>Legen Sie die Filter für MIME-Typen fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>Ordner</term> <listitem> <para>Legen Sie die Filter für Ordner fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>Schemata</term> <listitem> <para>Legen Sie die Schema-Filter fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>Fähigkeiten</term> <listitem> <para>Legen Sie die Filter für Fähigkeiten fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>Umgebung</term> <listitem> <para>Legen Sie einige Umgebungsbedingungen fest, denen die Auswahl in <productname>Caja</productname> entsprechen muss, damit die Aktion oder das Menü für die Anzeige infrage kommt.</para> </listitem> </varlistentry> <varlistentry> <term>Eigenschaften</term> <listitem> <para>Eigenschaften eines Objekts anzeigen.</para> </listitem> </varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry> <term>Statuszeile.</term> <listitem> <para>Die Statuszeile zeigt einige Statusinformationen über die aktuell ausgewählte Zeile in der Objektliste an.</para> <para>Wenn keine relevanten Informationen zur Anzeige vorhanden sind, dann zeigt die Statuszeile die Anzahl der geladenen Menüs, Aktionen und Profile an.</para> <para>Das Symbol für »schreibgeschützt« <inlinegraphic fileref="figures/read-only.png"/> wird im rechten Teil der Statuszeile angezeigt, sofern zutreffend.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="getting-started-first-action"> <title>Erstellen Ihrer ersten Aktion</title> <para>In diesem Beispiel erstellen wir eine Aktion, die einige nützliche Informationen über die aktuelle Auswahl zur Verfügung stellt.</para> <formalpara> <title>Überprüfen der Voraussetzungen</title> <para>Diese Aktion benötigt <productname>MateDialog</productname>.</para> </formalpara> <para><productname>MateDialog</productname> ist ein Programm, das Ihnen die Erstellung grafischer Oberflächen über die Befehlszeile ermöglicht.</para> <para>Sie sollten sicherstellen, dass dieses Programm auf Ihrem System installiert ist, indem Sie beispielsweise folgenden Befehl in einem Terminal aufrufen:</para> <para lang="en"> <command> <filename>matedialog</filename> </command> </para> <para>und drücken dann die <keycap>Eingabetaste</keycap>.</para> <formalpara> <title>Erstellen der Aktion</title> <para>Um eine neue Aktion zu erstellen, wählen Sie <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut><guimenu>Datei</guimenu><guisubmenu>Neue Aktion</guisubmenu></menuchoice>.</para> </formalpara> <para>Eine neue Aktion wird in die Objektliste eingefügt und deren Eigenschaften werden in den Reitern im rechten Teilfenster angezeigt.</para> <para>Die Bezeichnung der aktuell ausgewählten Aktion (dieses) wird zum Anwendungsnamen in der Titelleiste hinzugefügt.</para> <figure id="cact-FIG-tab-action"> <title>Vorgegebenen Eigenschaften einer neuen Aktion</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-action-tab.png" format="PNG"/> </imageobject> <textobject> <phrase> Shows the default properties of a newly created action. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>In der <guilabel>Objektliste</guilabel> wird die neue Aktion in kursiver Schrift dargestellt.</para> <para>Kursivschrift wird verwendet, um den Benutzer daran zu erinnern, dass das Objekt noch nicht gespeichert wurde.</para> <para>Eine weitere Erinnerung daran, dass es ungespeicherte Änderungen gebt, ist ein Asterisk (<literal>*</literal>), der dem Anwendungsnamen in der Titelzeile vorangestellt wird.</para> <formalpara> <title>Charakterisieren Ihrer neuen Aktion</title> <para>Im Wesentlichen geht es hierbei darum, wie Ihre Aktion in den Kontextmenüs des Dateimanagers angezeigt wird.</para> </formalpara> <itemizedlist> <listitem> <para>Geben Sie <userinput>Meine erste Aktion</userinput> im Eingabefeld <guilabel>Bezeichnung des Kontextmenüeintrages</guilabel> ein.</para> <para>Das Eingabefeld <guilabel>Bezeichnung des Kontextmenüeintrages</guilabel> enthält die Bezeichnung der Aktion, so wie Sie im Kontextmenü des Dateimanagers erscheinen soll.</para> <para>Diese Bezeichnung ist eine obligatorische Eigenschaft. Falls sie leer ist, dann wird Ihre Aktion durch <productname>Caja-Actions</productname> als ungültig erkannt: Sie wird in roter Farbe in der <guilabel>Objektliste</guilabel> angezeigt und nie für die Anzeige in den Kontextmenüs des Dateimanagers in Betracht gezogen.</para> </listitem> <listitem> <para>Geben Sie <userinput>Es wird eine Aktion mit einigen Parametern ausgeführt</userinput> in das Eingabefeld <guilabel>Minihilfe</guilabel> ein.</para> <para>Im Eingabefeld <guilabel>Minihilfe</guilabel> können Sie einen Text eingeben, der als kurze Hilfe zu Ihrer Aktion angezeigt wird.</para> </listitem> <listitem> <para>Wählen Sie <inlinegraphic fileref="figures/stock-icon-about.png"/> in der Auswahlliste <guilabel>Symbol</guilabel>.</para> <para>Die <guilabel>Symbol</guilabel>-Auswahl legt das Symbol fest, das Ihrer Aktion in den Kontextmenüs des Dateimanagers und in der Werkzeugleiste zugeordnet wird.</para> <para>Sie haben zwei Möglichkeiten, Ihrer Aktion ein Symbol zuzuordnen:</para> <itemizedlist> <listitem> <para>Klicken Sie in die Auswahlliste <guilabel>Symbol</guilabel>, um ein Symbol auszuwählen.</para> </listitem> <listitem> <para>Klicken Sie auf <guibutton>Durchsuchen</guibutton>, um im Dateisystem nach einer Bilddatei zu suchen.</para> </listitem> </itemizedlist> </listitem> </itemizedlist> <formalpara> <title>Angeben des auszuführenden Befehls</title> <para>Wenn Sie Ihre Aktion im Kontextmenü des Dateimanagers auswählen, wird dieser Befehl mit den von Ihnen angegebenen Argumenten ausgeführt.</para> </formalpara> <para>Klicken Sie auf den Reiter <guilabel>Befehl</guilabel>, um einen Befehl eingeben zu können.</para> <figure id="cact-FIG-tab-command"> <title>Reiter »Befehl«</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-command-tab.png" format="PNG"/> </imageobject> <textobject> <phrase> 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. </phrase> </textobject> </mediaobject> </screenshot> </figure> <itemizedlist> <listitem> <para>Geben Sie <userinput>matedialog</userinput> in das Eingabefeld <guilabel>Pfad</guilabel> ein.</para> <para>Das Eingabefeld <guilabel>Pfad</guilabel> legt den Befehl fest, der ausgeführt wird, wenn Sie diese Aktion in den Kontextmenüs des Dateimanagers auswählen.</para> <para>Es gibt zwei Möglichkeiten, den auszuführenden Befehl festzulegen:</para> <itemizedlist> <listitem> <para>Geben Sie ihn in das Eingabefeld <guilabel>Pfad</guilabel> ein.</para> </listitem> <listitem> <para>Klicken Sie auf <guibutton>Durchsuchen</guibutton>, um im Dateisystem nach einer ausführbaren Datei zu suchen.</para> </listitem> </itemizedlist> <para>Falls Sie den Befehl ohne absoluten Pfad eingeben, wird zur Ausführungszeit in der Variable <envar>PATH</envar> danach gesucht.</para> </listitem> <listitem> <para>Geben Sie <userinput>--info --text='%c ausgewählte(s) Element(e): %U'</userinput> in das Eingabefeld <guilabel>Parameter</guilabel> ein.</para> <para>Die <guilabel>Parameter</guilabel> 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.</para> <para>Wenn sowohl <guilabel>Pfad</guilabel> als auch <guilabel>Parameter</guilabel> leer sind, dann wird Ihre Aktion als ungültig erkannt: Sie wird in roter Farbe in der <guilabel>Objektliste</guilabel> angezeigt und nie für die Anzeige in den Kontextmenüs des Dateimanagers in Betracht gezogen.</para> </listitem> </itemizedlist> <formalpara> <title>Speichern</title> <para>Um sämtliche ausstehenden Änderungen zu speichern, wählen Sie <menuchoice><shortcut><keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo></shortcut><guimenu>Datei</guimenu><guisubmenu>Speichern</guisubmenu></menuchoice>.</para> </formalpara> <para><productname>Caja</productname> berücksichtigt Ihre neue Aktion automatisch und zeigt Sie in seinem Kontextmenü an.</para> <figure id="cact-FIG-start-caja-context"> <title>Ihre erste Aktion im Kontextmenü von <productname>Caja</productname></title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/start-context-menu-caja.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the first action in the <productname>Caja</productname> context menu. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Durch Anklicken des Objekts im Kontextmenü von <productname>Caja</productname> wird es aktiviert und der zugehörige Befehl ausgeführt.</para> <figure id="cact-FIG-start-matedialog"> <title>Das Ergebnis der Ausführung Ihrer ersten Aktion</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/start-matedialog-result.png" format="PNG"/> </imageobject> <textobject> <phrase> Shows the result of the execution of your first action. This is <productname>MateDialog</productname> dialog box, displaying the URI of the selected item. </phrase> </textobject> </mediaobject> </screenshot> </figure> </sect2> </sect2> </sect1> <!-- ============================== Usage ============================= --> <!-- Use this section to describe how to use the application to perform the tasks for which the application is designed. --> <sect1 id="usage"> <title><application>Caja-Actions Konfigurationswerkzeug</application> verwenden</title> <sect2 id="usage-conditions"> <title>Definieren der Bedingungen</title> <para>Ob Ihre Aktion tatsächlich in den Kontextmenüs der Dateiverwaltung <productname>Caja</productname> oder in dessen Werkzeugleiste angezeigt wird, hängt von den Bedingungen ab, die Sie dafür definiert haben.</para> <para>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.</para> <para>Bei jeder Änderung des Ortes oder der ausgewählten Dateien prüft <productname>Caja-Actions</productname> 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.</para> <sect3 id="usage-conditions-basenames"> <title>Auf dem Basisnamen basierende Bedingungen</title> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>Basisnamen</guilabel>, um die auf Basisnamen basierenden Bedingungen zu konfigurieren.</para> <figure id="cact-FIG-tab-basenames"> <title>Auf dem Basisnamen basierende Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-basenames-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define basename-based conditions.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.</para> <para>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.</para> <para>Die Definition einer neuen auf Basisnamen basierenden Bedingung umfasst zwei Schritte.</para> <orderedlist> <listitem> <para>Definiert die neue Filterbedingung.</para> <itemizedlist> <listitem> <para>Drücken Sie <keycap>Einf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>, um eine neue Filterbedingung einzufügen.</para> </listitem> <listitem> <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Basisnamen enthält.</para> <tip> <para>Eine auf dem Basisnamen beruhende Bedingung darf die Platzhalterzeichen <literal>*</literal> oder <literal>?</literal> enthalten.</para> </tip> </listitem> </itemizedlist> </listitem> <listitem> <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para> <para>Klicken Sie auf den Radioknopf <guilabel>Muss einem entsprechen von</guilabel> oder <guilabel>Muss allen entsprechen von</guilabel> in der gleichen Zeile, um die jeweilige Bedingung festzulegen.</para> </listitem> </orderedlist> <para>Abhängig von dem Betriebssystem, auf das Sie abzielen, stellen Sie bitte sicher, dass das Ankreuzfeld <guilabel>Groß-/Kleinschreibung beachten</guilabel> aktiviert ist oder nicht.</para> <itemizedlist> <listitem> <para>Wenn aktiviert, wird für alle Filter die Groß- und Kleinschreibung beachtet, was bedeutet, dass <filename>/meine/datei</filename> und <filename>/Meine/Datei</filename> unterschiedlich gewertet werden.</para> <para>Dies ist das vorgegebene Verhalten auf Unix-ähnlichen Systemen.</para> </listitem> <listitem> <para>Wenn deaktiviert, wird für alle Filter die Groß- und Kleinschreibung nicht beachtet, was bedeutet, dass <filename>/meine/datei</filename> und <filename>/Meine/Datei</filename> gleich gewertet werden.</para> <para>Das ist höchstwahrscheinlich dann der Fall, wenn Sie auf eines der <productname>Windows</productname>-Betriebssysteme abzielen.</para> </listitem> </itemizedlist> <para>Drücken Sie <keycap>Entf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>, um eine neue Filterbedingung zu entfernen.</para> <para>Per Voreinstellung ist eine Filterbedingung »<literal>muss einem von * entsprechen</literal>«. Weil alle Basisnamen immer die Bedingung »<literal>*</literal>« erfüllen bedeutet dies, dass auf Basisnamen basierende Filterbedingungen als nicht relevant für die Aktion angesehen werden.</para> </sect3> <sect3 id="usage-conditions-mimetypes"> <title>Auf dem MIME-Typ basierende Bedingungen</title> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>MIME-Typen</guilabel>, um auf dem MIME-Typen basierende Bedingungen festzulegen.</para> <figure id="cact-FIG-tab-mimetypes"> <title>Auf dem MIME-Typ basierende Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-mimetypes-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define mimetype-based conditions.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.</para> <para>Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf dem MIME-Typ basierenden Bedingungen auf die aktuell ausgewä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«.</para> <para>Die Definition einer neuen auf dem MIME-Typ basierenden Bedingung umfasst zwei Schritte.</para> <orderedlist> <listitem> <para>Definiert die neue Filterbedingung.</para> <itemizedlist> <listitem> <para>Drücken Sie <keycap>Einf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>, um eine neue Filterbedingung einzufügen.</para> </listitem> <listitem> <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten MIME-Typen enthält.</para> <para>Ein MIME-Typ muss als Ausdruck der Form <literal>gruppe/untergruppe</literal> definiert werden.</para> <tip> <para>Der Platzhalter <literal>*</literal> wird nur in einigen Situationen unterstützt:</para> <itemizedlist> <listitem> <para>Der Ausdruck <literal>*/*</literal> trifft auf alle MIME-Typen zu. Als bequeme Abkürzung wird das Literal <literal>*</literal> für den gleichen Zweck akzeptiert.</para> </listitem> <listitem> <para>Die Zeichenkette »<literal>group/*</literal>« trifft auf alle Untergruppen des <literal>group</literal>-MIME-Typen zu.</para> </listitem> <listitem> <para>Die Zeichenkette <literal>*/subgroup</literal> wird nicht als gültiger Platzhalter akzeptiert.</para> </listitem> </itemizedlist> </tip> </listitem> </itemizedlist> </listitem> <listitem> <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para> <para>Klicken Sie auf den Radioknopf <guilabel>Muss einem entsprechen von</guilabel> oder <guilabel>Muss allen entsprechen von</guilabel> in der gleichen Zeile, um die jeweilige Bedingung festzulegen.</para> </listitem> </orderedlist> <para>Drücken Sie <keycap>Entf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>, um eine Filterbedingung zu entfernen.</para> <para>Per Voreinstellung ist eine auf einem MIME-Typ basierende Filterbedingung »<literal>muss einem von */* entsprechen</literal>«. Weil alle Basisnamen immer die Bedingung »<literal>*/*</literal>« erfüllen, bedeutet dies, dass MIME-Typen als nicht relevant für die Aktion angesehen werden.</para> <example> <title>Beispiel für übliche MIME-Typen</title> <variablelist> <varlistentry> <term lang="en"> <!-- i18n: "all/all" is a mimetype, not translatable --> <literal>all/all</literal> </term> <listitem> <para>Trifft auf alle Objekte zu.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <!-- i18n: "all/allfiles" is a mimetype, not translatable --> <literal>all/allfiles</literal> </term> <listitem> <para>Bezieht alle regulären Dateien ein.</para> </listitem> </varlistentry> <varlistentry> <term lang="en"> <!-- i18n: "inode/directory" is a mimetype, not translatable --> <literal>inode/directory</literal> </term> <listitem> <para>Bezieht nur Ordner ein.</para> </listitem> </varlistentry> </variablelist> </example> </sect3> <sect3 id="usage-conditions-folders"> <title>Auf Ordnern basierende Bedingungen</title> <para>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.</para> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>Ordner</guilabel>, um die auf Ordnern basierenden Bedingungen zu konfigurieren.</para> <figure id="cact-FIG-tab-folders"> <title>Auf Ordnern basierende Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-folders-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define folder-based conditions.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.</para> <para>Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den Ordnernamen jedes aktuell ausgewählten Objekts angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den aktuellen Ort angewendet.</para> <para>Die Definition einer neuen auf Ordnern basierenden Bedingung umfasst zwei Schritte.</para> <orderedlist> <listitem> <para>Definiert die neue Filterbedingung.</para> <itemizedlist> <listitem> <para>Drücken Sie <keycap>Einf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>, um eine neue Filterbedingung einzufügen.</para> </listitem> <listitem> <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Ordner enthält.</para> <tip> <para>Die Zeichen <literal>*</literal> und <literal>?</literal> werden auf jeder Ebene des definierten Ordnerfilters als Platzhalter akzeptiert.</para> </tip> </listitem> <listitem> <para>Oder klicken Sie auf <guibutton>Durchsuchen</guibutton>, um einen Ordner im Dateisystem auszuwählen.</para> </listitem> </itemizedlist> </listitem> <listitem> <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para> <para>Klicken Sie auf den Radioknopf <guilabel>Muss einem entsprechen von</guilabel> oder <guilabel>Muss allen entsprechen von</guilabel> in der gleichen Zeile, um die jeweilige Bedingung festzulegen.</para> </listitem> </orderedlist> <para>Drücken Sie <keycap>Entf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>, um eine definierte Ordner-basierte Filterbedingung zu entfernen.</para> <para>Per Voreinstellung ist eine auf Ordnern basierende Filterbedingung »<literal>muss einem von / entsprechen</literal>«. Weil »<literal>/</literal>« immer die oberste Ebene eines Unix-ähnlichen Dateisystems ist, erfüllen alle gewählten Objekte immer diese Bedingung.</para> <note> <para>Wenn das Ziel ein <productname>Windows</productname>-Betriebssystem ist, dann dürfte dieser Vorgabewert nicht derjenige sein, den Sie tatsächlich benötigen.</para> </note> </sect3> <sect3 id="usage-conditions-schemes"> <title>Auf Schemata basierende Bedingungen</title> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>Schemata</guilabel>, um die auf Schemata basierenden Bedingungen zu konfigurieren.</para> <figure id="cact-FIG-tab-schemes"> <title>Schemata basierte Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-schemes-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define scheme-based conditions.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.</para> <para>Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Schemata basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Schemata basierenden Bedingungen auf das Schema des aktuellen Orts angewendet.</para> <para>Die Definition einer neuen auf Schemata basierenden Bedingung umfasst zwei Schritte.</para> <orderedlist> <listitem> <para>Definiert die neue Filterbedingung.</para> <itemizedlist> <listitem> <para>Drücken Sie <keycap>Einf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>, um eine neue Filterbedingung einzufügen.</para> </listitem> <listitem> <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie das gewünschte Schema enthält.</para> <tip> <para>Auf Schemata basierende Bedingungen akzeptieren nur den Platzhalter »<literal>*</literal>«, welcher »Jedes Schema« bedeutet.</para> </tip> </listitem> <listitem> <para>Oder klicken Sie auf <guibutton>Allgemein</guibutton>, um eines der unter <menuchoice><guimenu>Bearbeiten</guimenu><guimenuitem>Einstellungen</guimenuitem></menuchoice> definierten Schemata auszuwählen.</para> <figure id="cact-FIG-add-scheme"> <title>Auswahl eines Schemas aus vordefinierten Schemata</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-new-scheme.png" format="PNG"/> </imageobject> <textobject> <phrase>Show the list of predefined schemes.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Ein neues Schema darf hier nur ausgewählt werden, wenn es nicht bereits als Schema-Filter definiert wurde.</para> <para>Um ein neues Schema auszuwählen, klicken Sie auf <guibutton>OK</guibutton> oder doppelklicken Sie auf die gewünschte Zeile.</para> </listitem> </itemizedlist> </listitem> <listitem> <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit einem von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para> <para>Klicken Sie auf den Radioknopf <guilabel>Muss einem entsprechen von</guilabel> oder <guilabel>Muss allen entsprechen von</guilabel> in der gleichen Zeile, um die jeweilige Bedingung festzulegen.</para> </listitem> </orderedlist> <para>Drücken Sie <keycap>Entf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>, um eine auf Schemata basierende Filterbedingung zu entfernen.</para> <para>Per Voreinstellung entspricht eine auf Schemata basierende Filterbedingung »<literal>muss einem von * entsprechen</literal>«. Dies bedeutet, dass Schemata für diese Aktion nicht relevant sind.</para> </sect3> <sect3 id="usage-conditions-capabilities"> <title>Auf Fähigkeiten basierende Bedingungen</title> <para>Als Fähigkeiten werden hier Eigenschaften bezeichnet, die eine Datei dem Benutzer anbietet.</para> <para>Ausser für eine <literal>Local</literal> Fähigkeit, alle anderen hängen vom Benutzer ab der diesen Befehl ausführt.</para> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>Fähigkeiten</guilabel>, um die auf den zur Verfügung stehenden Fähigkeiten basierenden Bedingungen zu konfigurieren.</para> <figure id="cact-FIG-tab-capabilities"> <title>Auf Fähigkeiten basierende Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-capabilities-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define capability-based conditions.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>Falls mindestens ein Element der Auswahl nicht alle definierten Bedingungen erfüllt, dann wird Ihre Aktion nicht angezeigt.</para> <para>Wenn Ihre Aktion für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Fähigkeiten basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Fähigkeiten basierenden Bedingungen auf jene des aktuellen Orts angewendet.</para> <para>Die Definition einer neuen auf Fähigkeiten basierenden Bedingung umfasst zwei Schritte.</para> <orderedlist> <listitem> <para>Definiert die neue Filterbedingung.</para> <itemizedlist> <listitem> <para>Drücken Sie <keycap>Einf</keycap> zum Einfügen eines neuen auf Fähigkeiten basierenden Filters.</para> </listitem> <listitem> <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie die gewünschte Fähigkeit enthält.</para> </listitem> <listitem> <para>Oder klicken Sie auf <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton> zum Öffnen des Dialogs <guilabel>Eine neue Fähigkeit hinzufügen</guilabel>.</para> <figure id="cact-FIG-add-capability"> <title>Verwaltete Fähigkeiten</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-new-capability.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the list of managed capabilities.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Eine neue Fähigkeit darf hier nur ausgewählt werden, wenn es nicht bereits als Fähigkeiten-Filter definiert wurde.</para> <para>Um eine neue Fähigkeit auszuwählen, klicken Sie auf <guibutton>OK</guibutton> oder doppelklicken Sie auf die gewünschte Zeile.</para> </listitem> </itemizedlist> </listitem> <listitem> <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit allen von … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para> <para>Klicken Sie auf den Radioknopf <guilabel>Muss allen entsprechen von</guilabel> oder <guilabel>Darf keinem entsprechen von</guilabel> in der gleichen Zeile, um die jeweilige Bedingung festzulegen.</para> </listitem> </orderedlist> <para>Drücken Sie <keycap>Entf</keycap> oder klicken Sie auf den Knopf <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>, um einen definierten Fähigkeiten-Filter zu entfernen.</para> <para>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.</para> </sect3> <sect3 id="usage-conditions-count"> <title>Bedingung zur Anzahl der Auswahl</title> <para>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.</para> <example> <title>Ein Anwendungsfall der Anzahl der Auswahl</title> <para>Falls Ihre Aktion aus der Anzeige der Unterschiede zwischen zwei Dateien besteht, können Sie hier beispielsweise <literal>Anzahl = (entspricht) 2</literal> angeben.</para> </example> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.</para> <figure id="cact-FIG-tab-environment"> <title>Auf der Umgebung basierende Bedingungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-environment-tab.png" format="PNG"/> </imageobject> <textobject> <phrase> Shows the tab which lets you define environment-based conditions. This includes the selection count configuration, the desktop selection, along with the runtime filters. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Die Bedingung Anzahl der Auswahl wird im Feld <guilabel>'Erscheint, wenn die Auswahl enthält'</guilabel> definiert.</para> <figure id="cact-FIG-frame-count"> <title>Bereich für den Auswahlzähler</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-selection-count-frame.png" format="PNG"/> </imageobject> <textobject> <phrase> Focus on the <guilabel>Appears if selection contains</guilabel> frame. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>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.</para> <para>So definieren Sie eine Bedingung für eine Auswahlanzahl:</para> <itemizedlist> <listitem> <para>Wählen Sie in der Auswahlliste <guilabel>Anzahl</guilabel> den Operator aus, den Sie auf die Auswahlanzahl anwenden wollen:</para> <simplelist type="vert"> <member lang="en"><literal><</literal> <termdef>(strictly less than)</termdef></member> <member lang="en"><literal>=</literal> <termdef>(equal to)</termdef></member> <member lang="en"><literal>></literal> <termdef>(strictly greater than)</termdef></member> </simplelist> </listitem> <listitem> <para>Geben Sie die gewünschte Auswahlanzahl ein.</para> </listitem> </itemizedlist> <para>Die Auswahlanzahl hat als Voreinstellung »<literal>Anzahl > (streng größer als) 0</literal>«. Dies bedeutet, dass die Aktion als Kandidat zum Anzeigen in Frage kommt, sobald mehr als ein Objekt in der Dateiverwaltung ausgewählt ist.</para> </sect3> <sect3 id="usage-conditions-desktop"> <title>Auswahl der Arbeitsumgebung</title> <para>Sie können festlegen, dass Ihre Aktion:</para> <itemizedlist> <listitem> <para>immer erscheint,</para> </listitem> <listitem> <para>oder nur in bestimmten angegebenen Arbeitsumgebungen erscheint,</para> </listitem> <listitem> <para>oder in bestimmten angegebenen Arbeitsumgebungen nicht erscheint.</para> </listitem> </itemizedlist> <para>Innerhalb dieser drei Möglichkeiten ist nur eine Auswahl möglich.</para> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.</para> <para>Die Auswahl der Arbeitsumgebung wird im Feld <guilabel>Arbeitsumgebung</guilabel> definiert.</para> <figure id="cact-FIG-frame-desktop"> <title>Feld zur Auswahl der Arbeitsumgebung</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-desktop-environment-frame.png" format="PNG"/> </imageobject> <textobject> <phrase> Focus on the <guilabel>Desktop environment</guilabel> frame. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>So definieren Sie die Arbeitsumgebung:</para> <orderedlist> <listitem> <para>Wählen Sie zunächst den Typ des zu verwendenden Filters:</para> <simplelist type="vert"> <member>Soll Ihre Aktion immer erscheinen, unabhängig von der Arbeitsumgebung?</member> <member>Soll Ihre Aktion nur in bestimmten Arbeitsumgebungen erscheinen?</member> <member>Soll Ihre Aktion nie in bestimmten Arbeitsumgebungen erscheinen?</member> </simplelist> </listitem> <listitem> <para>Sollte Ihre Aktion nicht immer erscheinen, so wählen Sie die entsprechende(n) Arbeitsumgebung(en) in der Auswahlliste auf der rechten Seite.</para> </listitem> </orderedlist> <para>Die für Arbeitsumgebungen bestimmten Bedingungen haben als Voreinstellung »<literal>Immer erscheinen</literal>«. Dies bedeutet, dass die Aktion unabhängig von der laufenden Arbeitsumgebung als Kandidat zum Anzeigen in Frage kommt.</para> </sect3> <sect3 id="usage-conditions-executable"> <title>Bedingung für ausführbare Datei</title> <para>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.</para> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren.</para> <para>Die Bedingung »ausführbare Datei vorhanden« ist im Feld <guilabel>Ausführungsumgebung</guilabel> definiert.</para> <figure id="cact-FIG-frame-execution-environment"> <title>Feld <guilabel>Ausführungsumgebung</guilabel></title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-execution-environment-frame.png" format="PNG"/> </imageobject> <textobject> <phrase> Focus on the <guilabel>Execution environment</guilabel> frame. </phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Geben Sie zum Festlegen der relevanten Datei deren vollen Dateinamen in das Eingabefeld <guilabel>Erscheint, wenn die Datei ausführbar ist</guilabel> ein, oder klicken Sie auf <guibutton>Durchsuchen</guibutton> und wählen Sie eine Datei im Dateisystem.</para> <para>Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.</para> <tip> <para>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.</para> </tip> </sect3> <sect3 id="usage-conditions-dbus"> <title>Bedingung für eine D-Bus-Registrierung</title> <para>Sie können festlegen, dass Ihre Aktion nur dann erscheinen soll, wenn ein bestimmter Name zur Ausführungszeit am D-Bus-System registriert ist.</para> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend <guilabel>Ausführungsumgebung</guilabel>.</para> <para>Geben Sie zum Definieren den relevanten Namen in das Eingabefeld <guilabel>Erscheint, wenn der Name bei D-Bus registriert ist</guilabel> ein.</para> <para>Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.</para> <tip> <para>Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.</para> </tip> </sect3> <sect3 id="usage-conditions-true"> <title>Angepasste Bedingung</title> <para>Sie können festlegen, dass Ihre Aktion nur dann erscheinen wird, wenn ein bestimmter Befehl die Zeichenkette <literal>true</literal> auf die Standardausgabe ausgibt.</para> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend <guilabel>Ausführungsumgebung</guilabel>.</para> <para>So können Sie Ihren eigenen angepassten Bedingungsfilter definieren, indem Sie ein kleines Skript schreiben, dass gegebenenfalls die Zeichenkette <literal>true</literal> auf die Standardausgabe ausgibt.</para> <para>Geben Sie zum Definieren den Befehl in das Eingabefeld <guilabel>Erscheint, wenn der Befehl »true« ausgibt</guilabel> ein.</para> <para>Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.</para> <tip> <para>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.</para> </tip> </sect3> <sect3 id="usage-conditions-run"> <title>Bedingung für laufende Prozesse</title> <para>Sie können bestimmten, dass Ihre Aktion nur dann erscheinen wird, wenn ein bestimmter Prozess aktuell ausgeführt wird.</para> <para>Klicken Sie auf den Reiter <guilabel>Umgebung</guilabel>, um die von der Umgebung abhängigen Bedingungen zu konfigurieren. Wählen Sie anschließend <guilabel>Ausführungsumgebung</guilabel>.</para> <para>Geben Sie zum Festlegen der Binärdatei deren Namen in das Eingabefeld <guilabel>Erscheint, wenn die Binärdatei ausgeführt wird</guilabel> ein, oder klicken Sie auf <guibutton>Durchsuchen</guibutton> und wählen Sie eine Datei im Dateisystem.</para> <note> <para>Selbst wenn Sie den vollen Dateinamen der Binärdatei angeben, so wird zur Laufzeit nur nach dem Basisnamen in der Prozessliste gesucht.</para> </note> <para>Lassen Sie das Feld leer, wenn die Bedingung für Ihre Aktion irrelevant ist.</para> <tip> <para>Sie können einige Parameter in den gesuchten Namen einbetten. Diese Parameter werden dynamisch zur Ausführungszeit mit Werten ersetzt, die von den ausgewählten Objekt(en) abhängen.</para> </tip> </sect3> </sect2> <sect2 id="usage-where"> <title>Bestimmung des Ortes der Aktion</title> <figure id="cact-FIG-target-location-where"> <title>Zielkonfiguration</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-target-location.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the three fields which let you configure the target of your action.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Die Dateiverwaltung <productname>Caja</productname> zeigt u.U. Ihre Aktion an verschiedenen Stellen an, je nach dem, was Sie hier angeben und welche Objekte ausgewählt sind.</para> <para>Klicken Sie auf den Reiter <guilabel>Aktion</guilabel>, um die Orte Ihrer Aktionsziele zu konfigurieren.</para> <sect3 id="usage-where-selection"> <title>Eintrag in das Kontextmenü der Auswahl</title> <para>Wenn das Ankreuzfeld <guilabel>Objekt im Kontextmenü der Auswahl anzeigen</guilabel> ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für das <productname>Caja</productname>-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 <productname>Caja</productname> ausgewählt ist.</para> <tip> <para>Wenn eine Aktion für das Kontextmenü einer Auswahl vorgesehen ist und auch in einem Kontextmenü von <productname>Caja</productname> angezeigt wird, dann wird sie auch im Menü <guimenu>Bearbeiten</guimenu> von <productname>Caja</productname> angezeigt.</para> </tip> <para>Dieses Ziel wird per Voreinstellung ausgewählt.</para> </sect3> <sect3 id="usage-where-location"> <title>Eintrag in das Kontextmenü des Orts</title> <para>Wenn das Ankreuzfeld <guilabel>Objekt im Kontextmenü des Orts anzeigen</guilabel> ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für das <productname>Caja</productname>-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 <productname>Caja</productname> geöffnet ist.</para> <tip> <para>Wenn eine Aktion für das Kontextmenü eines Orts vorgesehen ist und auch tatsächlich in einem Kontextmenü von <productname>Caja</productname> angezeigt wird, dann wird sie auch im Menü <guimenu>Datei</guimenu> von <productname>Caja</productname> angezeigt.</para> </tip> </sect3> <sect3 id="usage-where-toolbar"> <title>Eintrag in die Werkzeugleiste</title> <para>Wenn das Ankreuzfeld <guilabel>Objekt in der Werkzeugleiste anzeigen</guilabel> ausgewählt ist, dann ist Ihre Aktion ein potenzieller Kandidat für die <productname>Caja</productname>-Werkzeugleiste.</para> <para>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.</para> </sect3> <sect3 id="usage-where-notes"> <title>Notizen</title> <formalpara> <title>Legt fest, ob Ihre Aktion in einem Kontextmenü angezeigt werden soll</title> <para>Legt fest, ob es das Kontextmenü der Auswahl oder das Kontextmenüs des Orts ist. Es wird im <productname>Caja</productname>-Kontextmenü und in den Menüs <guimenu>Datei</guimenu> und <guimenu>Bearbeiten</guimenu> angezeigt als</para> </formalpara> <itemizedlist> <listitem> <para>die <guilabel>Kontext-Beschriftung</guilabel> als Beschriftung,</para> </listitem> <listitem> <para>ein <guilabel>Symbol</guilabel>,</para> </listitem> <listitem> <para>diese beiden Eigenschaften werden mit einer <guilabel>Minihilfe</guilabel> assoziiert.</para> </listitem> </itemizedlist> <note> <para>Ob die Bezeichnung des Menüs vor dem Symbol in der Werkzeugleiste angezeigt wird, ist von der genauen Konfiguration Ihrer Arbeitsumgebung abhängig.</para> </note> <tip> <para>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) abhängen.</para> </tip> <formalpara> <title>Wenn Ihre Aktion in der Werkzeugleiste angezeigt werden soll</title> <para>Sie wird angezeigt als</para> </formalpara> <itemizedlist> <listitem> <para>die <guilabel>Werkzeugleisten-Beschriftung</guilabel> als Beschriftung,</para> </listitem> <listitem> <para>ein <guilabel>Symbol</guilabel>,</para> </listitem> <listitem> <para>diese beiden Eigenschaften werden mit einer <guilabel>Minihilfe</guilabel> assoziiert.</para> </listitem> </itemizedlist> <note> <para>Abhängig von der genauen Konfiguration Ihrer Arbeitsumgebung wird die Beschriftung der Werkzeugleiste vor dem Symbol in der Werkzeugleiste angezeigt.</para> </note> <tip> <para>Die Beschriftung in der Werkzeugleiste entspricht per Voreinstellung derjenigen in den Menüs. Mit Abwahl des Ankreuzfelds <guilabel>Die gleiche Beschriftung für das Symbol in der Werkzeugleiste verwenden</guilabel> geben Sie eine Beschriftung explizit für die Werkzeugleiste an. Diese ist für gewöhnlich kürzer als jene für die Menüs.</para> </tip> <tip> <para>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.</para> </tip> <formalpara> <title>Definieren verschiedener Ziele</title> <para>Eine Aktion kann für das Kontextmenü einer Auswahl, eines Orts, die Werkzeugleiste bzw. für eine beliebige Kombination aller bestimmt sein.</para> </formalpara> <formalpara> <title>Definieren keines Ziels</title> <para>Falls überhaupt kein Ziel definiert ist, also wenn alle drei Ankreuzfelder deaktiviert sind, dann wird Ihre Aktion niemals angezeigt.</para> </formalpara> </sect3> </sect2> <sect2 id="usage-execution"> <title>Welche Aktion soll ausgeführt werden?</title> <para>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.</para> <para>Wie bereits gesehen wird der auszuführende Befehl auf der Seite <guilabel>Befehl</guilabel> konfiguriert.</para> <para>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.</para> <sect3 id="usage-execution-parameters"> <title>Verfügbare Parameter</title> <para>Klicken Sie auf der Seite <guilabel>Befehl</guilabel> auf den Knopf <guilabel>Legende</guilabel>, um eine Liste aller verfügbaren Parameter zu sehen.</para> <figure id="cact-FIG-legend"> <title>Liste der verfügbaren Parameter</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-legend.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the list of available parameters.</phrase> </textobject> </mediaobject> </screenshot> </figure> <tip> <para>Der Knopf <guibutton>Legende</guibutton> hat eine Doppelfunktion: Klicken Sie einmal darauf, dann erscheint das Dialogfeld <guilabel>Parameterlegende</guilabel>; Klicken Sie erneut, um es zu verbergen.</para> </tip> <note> <para>Das Wort »<guilabel>zuerst</guilabel>« kann verwirrend sein, weil es sich nur auf die interne Liste der gewählten Objekte der Dateiverwaltung bezieht, welche an das Plugin <productname>Caja-Aktionen</productname> übergeben wird.</para> <para>Genau genommen hat es <emphasis>nichts zu tun</emphasis> mit der visuellen Auswahl, die Sie im Fenster der Dateiverwaltung treffen. Tatsächlich ist das <guilabel>erste</guilabel> gewählte Objekt einer Mehrfachauswahl nicht definiert und damit unvorhersagbar.</para> </note> </sect3> <sect3 id="usage-execution-work"> <title>Wo soll die Aktion ausgeführt werden?</title> <para>Ihre Aktion kann in einem bestimmten Arbeitsordner ausgeführt werden.</para> <para>Sie geben diesen im Reiter <guilabel>Befehl</guilabel> im Eingabefeld <guilabel>Arbeitsordner</guilabel> an, oder indem Sie auf den Knopf <guibutton>Durchsuchen</guibutton> zum Wählen eines Ordners im Dateisystem klicken.</para> <figure id="cact-FIG-work-dir-frame"> <title>Feld für Arbeitsordner</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-working-directory-frame.png" format="PNG"/> </imageobject> <textobject> <phrase>Focus on the working directory selection frame.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Der Arbeitsordner ist per Voreinstellung <literal>%d</literal>, das heißt, die Befehle werden im Basisordner des (ersten) ausgewählten Objekts ausgeführt.</para> <para>Im speziellen Fall eines <literal>%d</literal>-Parameters ist das <guilabel>erste</guilabel> gewählte Objekt nicht von Bedeutung, weil man davon ausgehen kann, dass alle gewählten Objekte im selben Basisordner sind.</para> </sect3> <sect3 id="usage-execution-how"> <title>Wie soll die Aktion ausgeführt werden?</title> <para>Neben der Konfiguration der Bedingungen, denen die Auswahl entsprechen muss, damit die Aktion in den Menüs der Dateiverwaltung angezeigt wird, ermöglicht Ihnen <productname>Caja-Aktionen</productname> festzulegen, wie Ihr Befehl genau ausgeführt wird.</para> <para>Klicken Sie auf den Reiter <guilabel>Ausführung</guilabel>, um die Ausführung eines Befehls zu konfigurieren.</para> <figure id="cact-FIG-execution"> <title>Konfiguration der Ausführungsmodi</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-execution-tab.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows how to configure the execution modes of a command.</phrase> </textobject> </mediaobject> </screenshot> </figure> <sect4 id="usage-execution-how-mode"> <title>Ausführungsmodus</title> <figure id="cact-FIG-execution-mode"> <title>Konfiguration des Ausführungsmodus</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-exec-mode-frame.png" format="PNG"/> </imageobject> <textobject> <phrase>Focus on the execution mode frame.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Der Ausführungsmodus Ihres Befehls kann aus folgenden Werten gewählt werden:</para> <variablelist> <varlistentry> <term>Normal</term> <listitem> <para>Startet den Befehl als normale grafische Benutzeroberfläche.</para> </listitem> </varlistentry> <varlistentry> <term>Terminal</term> <listitem> <para>Startet das bevorzugte Terminal der Arbeitsumgebung und führt den Befehl darin aus.</para> </listitem> </varlistentry> <varlistentry> <term>Eingebettet</term> <listitem> <para>Nutzt ein spezielles Funktionsmerkmal des Dateimanagers, wodurch ein Terminal in diesem ausgeführt wird.</para> <para>Weil <productname>Caja</productname> diese Funktion nicht bietet, ist diese Option identisch zur <literal>Terminal</literal>-Option.</para> </listitem> </varlistentry> <varlistentry> <term>Ausgabe anzeigen</term> <listitem> <para>Startet das bevorzugte Terminal der Arbeitsumgebung und führt den Befehl darin aus. Am Ende werden die Standardkanäle (stdout, stderr) ausgelesen und angezeigt.</para> </listitem> </varlistentry> </variablelist> <para>Der Standardausführungsmodus eines Befehls ist <literal>Normal</literal>. Das bedeutet, dass der Befehl ohne besondere davor oder danach auszuführende Aktionen gestartet wird.</para> </sect4> <sect4 id="usage-execution-how-notify"> <title>Start-Rückmeldungen</title> <figure id="cact-FIG-startup-mode"> <title>Konfiguration der Startmodi</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-startup-mode-frame.png" format="PNG"/> </imageobject> <textobject> <phrase>Focus on the Startup mode frame.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Wenn der Ausführungsmodus des Befehls <literal>Normal</literal> ist und wenn Sie sicher sind, dass die Anwendung eine <literal>Entfernen</literal>-Nachricht bei gesetzter Umgebungsvariable <envar>DESKTOP_STARTUP_ID</envar> sendet, dann sollten Sie das Ankreuzfeld <guilabel>Startbenachrichtigung</guilabel> auswählen.</para> <para>Lesen Sie auch <ulink url="http://www.freedesktop.org/Standards/startup-notification-spec" type="http"><citetitle>Startup Notification Protocol Specification</citetitle></ulink> für weitere Informationen.</para> </sect4> <sect4 id="usage-execution-how-class"> <title>Fensterklasse</title> <para>Wenn der Ausführungsmodus des Befehls <literal>Normal</literal> ist und wenn Sie sicher sind, dass die Anwendung mindestens ein Fenster mit einem Klassennamen abbildet, dann sollten Sie diesen Namen in das Eingabefeld <guilabel>WM-Klasse beim Start</guilabel> eingeben.</para> <para>Lesen Sie auch <ulink url="http://www.freedesktop.org/Standards/startup-notification-spec" type="http"><citetitle>Startup Notification Protocol Specification</citetitle></ulink> für weitere Informationen.</para> </sect4> <sect4 id="usage-execution-how-user"> <title>Befehlsausführer</title> <figure id="cact-FIG-execute-as"> <title>Konfiguration des Besitzers der Ausführung</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-execute-as-frame.png" format="PNG"/> </imageobject> <textobject> <phrase>Focus on the <guilabel>Execute as</guilabel> frame.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Geben Sie den Benutzernamen in das Eingabefeld <guilabel>Als Benutzer ausführen</guilabel> oder die <acronym>UID</acronym> des Benutzers ein, als welcher der Befehl ausgeführt werden soll.</para> <para>Falls Sie nichts in diesem Feld eingeben, dann wird der Befehl unter dem Kennzeichen des aktuellen Benutzers ausgeführt.</para> </sect4> <sect4 id="usage-execution-how-singular"> <title>Mehrfache Ausführung</title> <para>Sie möchten möglicherweise den Befehl nur einmal ausführen, mit der Liste aller ausgewählten Objekte als Argument.</para> <para>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.</para> <para>Tatsächlich handhabt <productname>Caja-Aktionen</productname> diese beiden Verhalten automatisch, abhängig von Form und Reihenfolge der Parameter in den Argumenten der Befehlszeile.</para> <para>Obwohl einige Parameter nicht abhängig von der Anzahl der Auswahl sind, (<abbrev>z.B.</abbrev> « <literal>%c</literal> », die auswählte Anzahl selber), haben die meisten zwei Deklinationen:</para> <itemizedlist> <listitem> <para>ein « Einzelnes », <abbrev>z.B.</abbrev> « <literal>%b</literal> », der Basisname des ausgewählten Elements;</para> </listitem> <listitem> <para>ein « Mehrfaches », <abbrev>z.B.</abbrev> « <literal>%B</literal> », die durchLeerzeichen getrennte Liste der Basisnamen der ausgewählten Elemente.</para> </listitem> </itemizedlist> <para>Falls die Auswahl leer ist oder nur ein Element enthält, dann sind diese zwei Formen genau gleich.</para> <para>Falls die Auswahl mehr als ein Objekt enthält:</para> <itemizedlist> <listitem> <para>wenn der erste relevante Parameter die Form Einzelnes hat wird <productname>Caja-Actions</productname> 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;</para> </listitem> <listitem> <para>Im Gegensatz dazu, wenn der erste relevante Parameter die Form eines Mehrfachen hat, wird <productname>Caja-Actions</productname> berüpcksichtigen, das der Befehl in der Lage ist mehrere Elemente zu behandeln und dadurch nur einmal ausgeführt wird;</para> </listitem> <listitem> <para>falls alle gefundenen Parameters irrelevant sind, dann geht <productname>Caja-Aktionen</productname> davon aus, dass der Befehl nur einmal ausgeführt werden soll.</para> </listitem> </itemizedlist> <table id="cact-TAB-multiple-execution" frame="all" tocentry="1"> <title>Characterisierung der Parameter <abbrev>vs.</abbrev> mehrfache Ausführung</title> <tgroup cols="5"> <colspec align="center" colwidth="*"/> <colspec align="left" colwidth="5*"/> <colspec align="center" colwidth="*" colname="c3"/> <colspec align="center" colwidth="*"/> <colspec align="center" colwidth="*" colname="c5"/> <thead> <row> <entry>Parameter</entry> <entry>Beschreibung</entry> <entry namest="c3" nameend="c5">Wiederholung</entry> </row> </thead> <tbody> <row> <entry lang="en"><literal>%b</literal></entry> <entry>(erster) Basisname</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%B</literal></entry> <entry>Durch Leerzeichen getrennte Liste von Basisnamen</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%c</literal></entry> <entry>Anzahl der ausgewählte Objekte</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> <row> <entry lang="en"><literal>%d</literal></entry> <entry>(erster) Basisordner</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%D</literal></entry> <entry>Durch Leerzeichen getrennte Liste von Ordner-Basisnamen der ausgewählten Objekte</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%f</literal></entry> <entry>(erster) Dateiname</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%F</literal></entry> <entry>Durch Leerzeichen getrennte Liste der gewählten Dateinamen</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%h</literal></entry> <entry>Rechnername der (ersten) Adresse</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> <row> <entry lang="en"><literal>%m</literal></entry> <entry>MIME-Typ des (ersten) ausgewählten Eintrags</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%M</literal></entry> <entry>Durch Leerzeichen getrennte Liste der MIME-Typen der gewählten Objekte</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%n</literal></entry> <entry>Benutzername der (ersten) Adresse</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> <row> <entry lang="en"><literal>%o</literal></entry> <entry>»no-op« Operator, der eine einfache Form der Ausführung erzwingt.</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%O</literal></entry> <entry>»no-op« Operator, der eine mehrfache Form der Ausführung erzwingt.</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%p</literal></entry> <entry>Portnummer der (ersten) Adresse</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> <row> <entry lang="en"><literal>%s</literal></entry> <entry>Schema der (ersten) Adresse</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> <row> <entry lang="en"><literal>%u</literal></entry> <entry>(erste) Adresse</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%U</literal></entry> <entry>Durch Leerzeichen getrennte Liste der gewählten Adressen</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%w</literal></entry> <entry>(erster) Basisname ohne Erweiterung</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%W</literal></entry> <entry>Durch Leerzeichen getrennte Liste der Basisnamen ohne deren Erweiterung</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%x</literal></entry> <entry>(erste) Erweiterung</entry> <entry>Singular</entry> <entry/> <entry/> </row> <row> <entry lang="en"><literal>%X</literal></entry> <entry>Durch Leerzeichen getrennte Liste von Erweiterungen</entry> <entry/> <entry/> <entry>Plural</entry> </row> <row> <entry lang="en"><literal>%%</literal></entry> <entry lang="en">the « <literal>%</literal> » character</entry> <entry/> <entry>irrelevant</entry> <entry/> </row> </tbody> </tgroup> </table> <example> <title>Verwendung von Singular- <abbrev>gegenüber</abbrev> Plural-Formen</title> <para>Angenommen, der aktuelle Ordner ist <filename>/data</filename> und die aktuelle Auswahl enthält die drei Dateien <filename>pierre</filename>, <filename>paul</filename> und <filename>jacques</filename>.</para> <formalpara> <title>Wenn der Befehl <command>echo %b</command> angefordert wird,</title> <para>dann werden die folgenden Befehle erfolgreich ausgeführt:</para> </formalpara> <simplelist> <member lang="en"><command>echo pierre</command></member> <member lang="en"><command>echo paul</command></member> <member lang="en"><command>echo jacques</command></member> </simplelist> <para>Dies liegt daran, dass <literal>%b</literal> einen <emphasis>singulären</emphasis> Parameter darstellt. Der Befehl wird nur einmalig für jedes der gewählten Objekte ausgeführt.</para> <formalpara> <title>Gäbe es im Gegensatz dazu die Anfrage <command>echo %B</command>,</title> <para>dann wird der folgende Befehl ausgeführt:</para> </formalpara> <simplelist> <member lang="en"><command>echo pierre paul jacques</command></member> </simplelist> <para>Dies liegt daran, dass <literal>%B</literal> einen <emphasis>pluralischen</emphasis> Parameter darstellt. Der Befehl wird nur einmalig ausgeführt mit der Liste der gewählten Objekte als Argumente.</para> <formalpara> <title>Gäbe es die Anfrage <command>echo %b %B</command>,</title> <para>dann werden die folgenden Befehle erfolgreich ausgeführt:</para> </formalpara> <simplelist> <member lang="en"><command>echo pierre pierre paul jacques</command></member> <member lang="en"><command>echo paul pierre paul jacques</command></member> <member lang="en"><command>echo jacques pierre paul jacques</command></member> </simplelist> <para>Dies liegt daran, dass der erste <emphasis>relevante</emphasis> Parameter <literal>%b</literal> ist und damit der Befehl einmal für jedes gewählte Objekt ausgeführt wird, wobei jedes Mal der Parameter <literal>%b</literal> durch das entsprechende Objekt ersetzt wird. Der zweite Parameter wird berechnet und als Argument an den ausgeführten Befehl angehängt.</para> <formalpara> <title>und gäbe es die Anfrage <command>echo %B %b</command>,</title> <para>dann werden die folgenden Befehle ausgeführt:</para> </formalpara> <simplelist> <member lang="en"><command>echo pierre paul jacques pierre</command></member> </simplelist> <para>Dies liegt daran, dass in diesem Fall der erste <emphasis>relevante</emphasis> Parameter <literal>%B</literal> ist. Der Befehl wird nur einmal ausgeführt wird, wobei <literal>%B</literal> durch eine durch Leerzeichen getrennte Liste von Basisnamen ersetzt wird. Weil der Befehl nur einmal ausgeführt wird, wird <literal>%b</literal> nur einmal mit dem (ersten) Basisnamen ersetzt.</para> </example> </sect4> </sect3> </sect2> <sect2 id="usage-profile"> <title>Verwendung von Profilen zur Erweiterung Ihrer Aktion</title> <para>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.</para> <example> <title>Hier ein Terminal öffnen</title> <para>Nehmen wir an, Sie hätten eine Aktion, die am aktuellen Ort ein Terminal öffnet.</para> <para>Sie haben die Einstellungen so gewählt, dass Ihre bevorzugtes Terminal an dem Ort geöffnet wird, auf den Ihr Dateimanager gerade zeigt.</para> <para>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.</para> <para>Eine Lösung liegt darin, Ihrer Aktion ein neues Profil zuzuweisen, durch welches das Terminal im Zielordner geöffnet wird.</para> <para>Zur Laufzeit untersucht <productname>Caja-Aktionen</productname> jedes mit der Aktion verknüpfte Profil nacheinander. Falls das erste Profil auf eine Datei abzielt und ein Ordner gewählt ist, dann wird <productname>Caja-Aktionen</productname> Ihr zweites Profil abarbeiten.</para> </example> <para>Um ein neues Profil anzulegen, wählen Sie zunächst die Aktion in der Objektliste aus und wählen Sie dann <menuchoice><guisubmenu>Datei</guisubmenu><guimenuitem>Neues Profil</guimenuitem></menuchoice>.</para> <para>Ein neues Profil wird in Ihrer Aktion erstellt.</para> <para>Sie können nun die Bedingungen festlegen, die zutreffen müssen, damit dieses Profil ausgewählt und der Befehl ausgeführt wird.</para> <sect3 id="usage-profile-order"> <title>Ordnen der Profile innerhalb einer Aktion</title> <para>Zur Laufzeit beginnt <productname>Caja-Aktionen</productname> mit der Untersuchung der Bedingungen, die der Aktion zugeschrieben sind.</para> <para>Wenn diese Bedingungen (der Aktionen) erfüllt werden, dann arbeitet <productname>Caja-Aktionen</productname> jedes Profil in Reihenfolge ab.</para> <para>Wenn diese Bedingungen (der Aktionen) erfüllt werden, dann arbeitet <productname>Caja-Aktionen</productname> jedes Profil in Reihenfolge ab.</para> <para>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.</para> <para>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 <productname>Caja</productname> Kontextmenü auswählbar.</para> <para>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.</para> <para>Profile können innerhalb einer Aktion auf zwei Weisen angeordnet werden.</para> <orderedlist> <listitem> <para>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.</para> </listitem> <listitem> <para>Klicken Sie auf das Profil, das Sie verschieben möchten, und ziehen Sie es an den gewünschten Ort.</para> </listitem> </orderedlist> </sect3> </sect2> <sect2 id="usage-menus"> <title>Organisieren von Aktionen in Menüs</title> <para>Mit wachsender Zahl an Aktionen bietet es sich an, diese in Menüs, Untermenüs usw. anzuordnen.</para> <para>Wählen Sie <menuchoice><guimenu>Datei</guimenu><guimenuitem>Neues Menü</guimenuitem></menuchoice> zum Erstellen eines neuen Menüs.</para> <para>Ein Menü darf beliebig in Ihrer Aktionenliste erstellt werden, aber nur innerhalb einer Aktion (<abbrev>d.h.</abbrev> nicht zwischen zwei Aktionsprofilen).</para> <para>Bei den Aktionen hängt die Platzierung eines neuen Menüs von der aktuellen Sortierreihenfolge ab:</para> <variablelist> <varlistentry> <term>Manuelle Reihenfolge:</term> <listitem> <para>Das neue Menü wird unmittelbar vor die aktuelle Aktion oder das aktuelle Menü eingefügt.</para> <para>Der Ort wird sich nicht ändern, wenn später die Menübeschriftung verändert wird.</para> </listitem> </varlistentry> <varlistentry> <term>Aufsteigende (respektive absteigende) alphabetische Reihenfolge:</term> <listitem> <para>Das neue Menü wird an der passenden Stelle mit der vorgegebenen Beschriftung <literal>Neues Caja-Menü</literal> eingefügt</para> <para>Dieser Ort wird jedes mal automatisch geändert, wenn Sie die Bezeichnung des Menüs verändern.</para> </listitem> </varlistentry> </variablelist> <para>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 <productname>Caja</productname>-Kontextmenü wird. Falls die Bedingungen zur Programmlaufzeit nicht erfüllt werden, so wird das gesamte Menü einschließlich aller Untermenüs nicht dargestellt.</para> </sect2> <sect2 id="usage-sorting"> <title>Die Objektliste sortieren</title> <para>Ihre Aktionen und Menüs werden im Kontextmenü der Dateiverwaltung in derselben Reihenfolge dargestellt, wie in der <guilabel>Objektliste</guilabel> in der linken Seitenleiste des Fensters <application>Einstellungen für Caja-Aktionen</application> .</para> <para>Sie können:</para> <itemizedlist> <listitem> <para>entweder Ihre Aktionen und Menüs in alphabetischer oder umgekehrt alphabetischer Reihenfolge anhand ihrer Bezeichnung sortieren lassen,</para> </listitem> <listitem> <para>oder nicht sortieren lassen und Ihre Aktionen und Menüs nach Ihrer eigenen gewünschten Reihenfolge sortieren.</para> </listitem> </itemizedlist> <sect3 id="usage-sorting-alpha"> <title>Alphabetische Sortierung Ihrer Aktionen und Menüs</title> <para>In diesen Modi werden Aktionen und Menüs anhand ihrer Bezeichnung innerhalb ihres übergeordneten Objekts sortiert.</para> <figure id="cact-FIG-sort-buttons"> <title>Sortierknöpfe im Hauptfenster</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/sort-buttons-frame.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the three sort buttons in the main window.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para>Sie können Ihre Aktionen sortieren nach:</para> <itemizedlist> <listitem> <para lang="en">Click on <guibutton><inlinegraphic fileref="figures/sort-asc.png"/></guibutton>(<abbrev>resp.)</abbrev><guibutton><inlinegraphic fileref="figures/sort-desc.png"/></guibutton>button to sort your actions in ascending (<abbrev>resp.</abbrev> descending) order.</para> </listitem> <listitem> <para>Oder bearbeiten Sie bitte die entsprechende Einstellung.</para> </listitem> </itemizedlist> </sect3> <sect3 id="usage-sorting-manual"> <title>Manuelles Organisieren Ihrer Aktionen und Menüs</title> <para>Wenn Einträge manuell in der Liste sortiert werden, werden neue Einträge normalerweise an dieser Stelle eingefügt.</para> <para>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.</para> <para>So wählen Sie diesen Modus:</para> <itemizedlist> <listitem> <para>Klicken Sie auf den <guibutton><inlinegraphic fileref="figures/sort-manual.png"/></guibutton>-Knopf.</para> </listitem> <listitem> <para>Oder bearbeiten Sie bitte die entsprechende Einstellung.</para> </listitem> </itemizedlist> </sect3> </sect2> <sect2 id="usage-edit"> <title>Bearbeiten</title> <para>Mit dem <application>Caja-Actions Konfigurationswerkzeug</application> können Sie zuverlässig in die Zwischenablage ausschneiden und kopieren oder von dort einfügen.</para> <sect3 id="usage-edit-cut"> <title>Ausschneiden/Löschen</title> <para>Gelöscht wird die aktuelle Auswahl.</para> <para>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.</para> </sect3> <sect3 id="usage-edit-multiple"> <title>Mehrfachauswahlen</title> <para>Mehrfachauswahl ist in den <application>Einstellungen für Caja-Aktionen</application> möglich. Die bestehende Auswahl wird durch Drücken von <keycap>Strg</keycap> oder <keycap>Umschalttaste</keycap> und Klicken auf ein hinzuzufügendes Objekt erweitert.</para> <para>Die <application>Einstellungen für Caja-Aktionen</application> 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 <application>Einstellungen für Caja-Aktionen</application> nicht mit einer solchen Auswahl umgehen können.</para> <para>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).</para> </sect3> </sect2> <sect2 id="usage-save"> <title>Speichern Ihrer Änderungen</title> <para>Um Ihre Änderungen zu speichern, wählen Sie <menuchoice><shortcut><keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo></shortcut><guimenu>Datei</guimenu><guisubmenu>Speichern</guisubmenu></menuchoice>.</para> <para>Alle Ihre ausstehenden Änderungen werden gespeichert. Neue Einträge werden durch den nächsten freien E/A-Provider erstellt.</para> <para><productname>Caja-Aktionen</productname> besitzt die Funktion zum automatischen Speichern, welche in den <guimenuitem>Einstellungen</guimenuitem> konfigurierbar ist.</para> </sect2> <sect2 id="usage-export"> <title>Exportieren Ihrer Aktionen</title> <para> </para> </sect2> <sect2 id="usage-import"> <title>Importieren von Aktionen</title> <para> </para> </sect2> <sect2 id="usage-prefs"> <title>Festlegen Ihrer persönlichen Einstellungen</title> <para>Wählen Sie <menuchoice><guimenu>Bearbeiten</guimenu><guimenuitem>Einstellungen</guimenuitem></menuchoice>, um Ihre Einstellungen bearbeiten zu können.</para> <sect3 id="usage-prefs-runtime"> <title>Laufzeiteinstellungen</title> <figure id="cact-FIG-prefs-runtime"> <title>Laufzeiteinstellungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-runtime.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define runtime preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> </sect3> <sect3 id="usage-prefs-execution"> <title>Einstellungen der Ausführungszeit</title> <figure id="cact-FIG-prefs-execution"> <title>Einstellungen der Ausführungszeit</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-execution.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define runtime execution preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> <figure id="cact-FIG-prefs-desktop"> <title>Auswahl der Arbeitsumgebung</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-desktop.png" format="PNG"/> </imageobject> <textobject> <phrase>Let the user explicitely configure the current desktop.</phrase> </textobject> </mediaobject> </screenshot> </figure> </sect3> <sect3 id="usage-prefs-ui"> <title>Einstellungen der Benutzeroberfläche</title> <figure id="cact-FIG-prefs-ui"> <title>Einstellungen der grafischen Oberfläche</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-ui.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define UI preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> </sect3> <sect3 id="usage-prefs-import"> <title>Importeinstellungen</title> <figure id="cact-FIG-prefs-import"> <title>Importeinstellungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-import.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define import preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para> </para> </sect3> <sect3 id="usage-prefs-export"> <title>Exporteinstellungen</title> <figure id="cact-FIG-prefs-export"> <title>Exporteinstellungen</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-export.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define export preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para> </para> </sect3> <sect3 id="usage-prefs-schemes"> <title>Einstellungen für Schemata</title> <figure id="cact-FIG-prefs-schemes"> <title>Einstellungen für Schemata</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-schemes.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define schemes preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para> </para> </sect3> <sect3 id="usage-prefs-providers"> <title>Einstellungen für Ein-/Ausgabetreiber</title> <figure id="cact-FIG-prefs-io-providers"> <title>Einstellungen für Ein-/Ausgabetreiber</title> <screenshot> <mediaobject lang="en"> <imageobject> <imagedata fileref="figures/cact-preferences-io-providers.png" format="PNG"/> </imageobject> <textobject> <phrase>Shows the tab which lets you define I/O providers preferences.</phrase> </textobject> </mediaobject> </screenshot> </figure> <para> </para> </sect3> </sect2> </sect1> <!-- ============================ Misc ================================ --> <!-- informations I do not know where to put --> <sect1 id="misc"> <title>Verschiedene Informationen</title> <para>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 <productname>Caja</productname> in Frage kommt. Einige Informationen fehlen oder sind fehlerhaft. In diesem Fall fehlt trotz bereits vorhandener Voreinstellungen ein auszuführender Befehl, der von <application>Einstellungen für Caja-Aktionen</application> als gültig angesehen wird.</para> </sect1> <!-- ============================ Bugs ================================ --> <!-- This section is optional and is commented out by default. You can use it to describe known bugs and limitations of the program if there are any - please be frank and list all problems you know of. --> <sect1 id="bugs"> <title>Bekannte Fehler und Einschränkungen</title> <sect2 id="bugs-bugs"> <title>Bekannte Fehler</title> <para>Über bekannte Fehler erfahren Sie in der <ulink url="https://github.com/NiceandGently/caja-actions/issues" type="http">Bugzilla-Fehlererfassungssystem</ulink>.</para> <para>Sollten Sie neue Fehler in <application>Caja-Aktionen</application> finden, so bitten wir diesen per Web-Browser auf der Seite <ulink url="https://github.com/NiceandGently/caja-actions/issues" type="http">Bugzilla</ulink> zu melden.</para> <sect2 id="bugs-limits"> <title>Bekannte Einschränkungen</title> <formalpara> <title>Ausführungsmodus</title> <para>Ab Version 3.0 ist es möglich, den Ausführungsmodus im <application>Einstellungswerkzeug von Caja-Actions</application> einzustellen, aber er wird noch nicht vom <productname>Caja</productname>-Plugin berücksichtigt.</para> </formalpara> <para>Dies betrifft den Arbeitsordner, Ausführungsmodus, Startbenachrichtigung und die Besitzer-Parameter des Ausführenden.</para> <formalpara> <title>Vorgeschlagene Tastenkombination</title> <para>Ab Version 3.0 können vorgeschlagene Tastenkürzel – wie in der DES-EMA Spezifikation beschrieben – nicht im <application>Konfigurationswerkzeug von Caja-Aktionen </application> eingestellt werden. Sie werden auch nicht vom <productname>Caja</productname>-Plugin ausgewertet.</para> </formalpara> <formalpara> <title>Menütrenner</title> <para>Ab Version 3.0 können Menütrenner nicht im <application>Konfigurationswerkzeug von Caja-Aktionen</application> konfiguriert werden. Sie werden auch nicht vom <productname>Caja</productname>-Plugin ausgewertet.</para> </formalpara> <para>Bedenken Sie, dass derzeit die Dateiverwaltung <productname>Caja</productname> es Plugins nicht erlaubt, Trenner in Kontextmenüs festzulegen.</para> </sect2> </sect2> </sect1> <!-- =========================== About ================================ --> <!-- This section contains info about the program (not docs), such as author's name(s), web page, license, feedback address. This section is optional: primary place for this info is "About.." box of the program. However, if you do wish to include this info in the manual, this is the place to put it. Alternatively, you can put this information in the title page. --> <sect1 id="about"> <title>Info zum <application>Caja-Aktionen-Konfigurationswerkzeug</application></title> <para>Die erste Version von <productname>Caja-Aktionen</productname> wurde von Frederic Ruaudel (<email>grumz@grumz.net</email>) und Rodrigo Moya (<email>rodrigo@gnome-db.org</email>) geschrieben. Sie wurde wesentlich verbessert und wird nun von Pierre Wieser (<email>pwieser@trychlos.org</email>) betreut.</para> <para>Die Grafiken verdanken wir Ulisse Perusin (<email>uli.peru@gmail.com</email>) und DragonArtz (<ulink url="http://www.dragonartz.net/" type="http">http://www.dragonartz.net</ulink>).</para> <para>Um Fehler zu melden oder Vorschläge für <productname>Caja-Actions</productname>, das <application>Konfigurationswerkzeug für Caja-Actions</application> oder dieses Handbuch einzureichen, folgen Sie bitte den Anweisungen auf der <ulink url="help:mate-user-guide#feedback" type="help">MATE-Seite für Rückmeldungen</ulink>. Auf Wunsch können Sie auch direkt Fehlermeldungen oder Verbesserungswünsche auf der <ulink url="https://github.com/NiceandGently/caja-actions/issues" type="http">Bugzilla-Webseite</ulink> melden.</para> </sect1> <appendix id="appendix-gnu-fdl"> <title>GNU Freie Dokumentationslizenz</title> <simpara>Version 1.3, 3. November 2008</simpara> <simpara>Copyright © 2000, 2001, 2002, 2007, 2008 <ulink url="http://www.fsf.org/">Free Software Foundation, Inc.</ulink></simpara> <simpara>Es ist jedermann gestattet, wortwörtliche Kopien dieses Lizenzdokuments anzufertigen und zu verbreiten, Änderungen sind jedoch nicht erlaubt.</simpara> <bridgehead id="section0" renderas="sect2">0. VORWORT</bridgehead> <simpara>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.</simpara> <simpara>Diese Lizenz ist eine Art <quote>copyleft</quote>, 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.</simpara> <simpara>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.</simpara> <bridgehead id="section1" renderas="sect2">1. ANWENDBARKEIT UND DEFINITIONEN</bridgehead> <simpara>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.</simpara> <simpara>Eine <quote>Modifizierte Version</quote> 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.</simpara> <simpara>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. </simpara> <simpara>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. </simpara> <simpara>»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. </simpara> <simpara>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. </simpara> <simpara>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.</simpara> <simpara>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.</simpara> <simpara lang="en"> The “publisher” means any person or entity that distributes copies of the Document to the public. </simpara> <simpara>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.</simpara> <simpara>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.</simpara> <bridgehead id="section2" renderas="sect2">3. WORTWÖRTLICHE KOPIEN</bridgehead> <simpara>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.</simpara> <simpara>Sie dürfen auch Kopien unter den oben genannten Bedingungen verleihen, und Sie dürfen Kopien öffentlich zeigen.</simpara> <bridgehead id="section3" renderas="sect2">3. KOPIEREN IN MENGEN</bridgehead> <simpara>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.</simpara> <simpara>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.</simpara> <simpara>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.</simpara> <simpara>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.</simpara> <bridgehead id="section4" renderas="sect2">4. MODIFIKATIONEN</bridgehead> <simpara>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:</simpara> <orderedlist numeration="upperalpha"> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>Geben Sie auf der Titelseite den Namen des Herausgebers als Herausgeber an.</simpara> </listitem> <listitem> <simpara>Alle Urheberrechtshinweise des Dokuments bewahren.</simpara> </listitem> <listitem> <simpara>Einen passenden Copyright-Hinweis für Ihre Modifikationen angrenzend an die anderen Copyright-Hinweise hinzufügen.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>Erhalten Sie im Copyright-Vermerk die komplette Liste der unveränderlichen Abschnitte und obligatorischen Umschlagtexte, die in dem Lizenzvermerk des Dokumentes aufgeführt sind.</simpara> </listitem> <listitem> <simpara>Eine unveränderte Kopie dieser Lizenz einfügen.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>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.</simpara> </listitem> <listitem> <simpara>Löschen Sie alle Abschnitte, die als »Anmerkungen« überschrieben sind. Ein solchen Abschnitt sollte nicht in der modifizierten Version enthalten sein.</simpara> </listitem> <listitem> <simpara>Benennen Sie keinen Abschnitt in »Anmerkungen« um, oder in einen Namen, der in Konflikt mit einem unveränderlichen Abschnitt gerät.</simpara> </listitem> <listitem> <simpara>Alle Haftungsausschlüsse bewahren.</simpara> </listitem> </orderedlist> <simpara>Wenn die <link linkend="fdl-modified">Modifizierte Version</link> neue wichtige Abschnitte enthält oder Anhänge, die <link linkend="fdl-secondary">Sekundäre Abschnitte</link> 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 <link linkend="fdl-invariant">Unveränderlichen Abschnitte</link> in dem Lizenzhinweis der Modifizierten Version hinzu. Diese Titel müssen sich von allen anderen Abschnittstiteln unterscheiden.</simpara> <simpara>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.</simpara> <simpara>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.</simpara> <simpara>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.</simpara> <bridgehead id="section5" renderas="sect2">5. DOKUMENTE KOMBINIEREN</bridgehead> <simpara>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.</simpara> <simpara>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.</simpara> <simpara>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.</simpara> <bridgehead id="section6" renderas="sect2">6. SAMMLUNGEN VON DOKUMENTEN</bridgehead> <simpara>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.</simpara> <simpara>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.</simpara> <bridgehead id="section7" renderas="sect2">7. AGGREGATION MIT UNABHÄNGIGEN ARBEITEN</bridgehead> <simpara>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.</simpara> <simpara>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. </simpara> <bridgehead id="section8" renderas="sect2">8. ÜBERSETZUNG</bridgehead> <simpara>Ü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.</simpara> <simpara>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. </simpara> <bridgehead id="section9" renderas="sect2">9. TERMINATION</bridgehead> <simpara>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.</simpara> <simpara lang="en"> 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. </simpara> <simpara lang="en"> 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. </simpara> <simpara lang="en"> 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. </simpara> <bridgehead id="section10" renderas="sect2">10. ZUKÜNFTIGE REVISIONEN DIESER LIZENZ</bridgehead> <simpara>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 <ulink url="http://www.gnu.org/copyleft/">Copyleft</ulink>.</simpara> <simpara lang="en"> 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. </simpara> <bridgehead id="section11" renderas="sect2">11. NEULIZENZIERUNG</bridgehead> <simpara lang="en"> “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. </simpara> <simpara lang="en"> “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. </simpara> <simpara lang="en"> “Incorporate” means to publish or republish a Document, in whole or in part, as part of another Document. </simpara> <simpara lang="en"> 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. </simpara> <simpara lang="en"> 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. </simpara> <bridgehead id="addendum" renderas="sect2">ANHANG: Wie Sie diese Lizenz für Ihre Dokumente verwenden können</bridgehead> <simpara>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:</simpara> <screen>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«.</screen> <simpara>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:</simpara> <screen>mit den unveränderlichen Abschnitten TITEL HIER AUFLISTEN, mit den vorderen Umschlagtexten HIER AUFLISTEN und den hinteren Umschlagtexten HIER AUFLISTEN,</screen> <simpara>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. </simpara> <simpara>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. </simpara> </appendix> </article>
修改文件时间
将文件时间修改为当前时间的前一年
删除文件