<?xml version="1.0" encoding="utf-8"?>
<sect2 id="usage-conditions">
  <title>Definieren der Bedingungen</title>
  <para>
    Whether your action will eventually be displayed in <productname>Caja</productname> file manager
    context menus or in its toolbar depends on the conditions you will have
    defined for it.
  </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>
    Each time the selection or the location change in the file manager,
    <productname>Caja-Actions</productname> checks all your actions, comparing the defined conditions
    against the new location and selection: all defined conditions must
    be satisfied in order your action be actually displayed. 
  </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>
      <!-- i18n: "Basenames" is a UI label -->
      Click on the <guilabel>Basenames</guilabel> tab to show the page
      which will permit you to configure your basename-based conditions.
    </para>
    <figure id="cact-FIG-tab-basenames">
      <title>Auf dem Basisnamen basierende Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-basenames-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf Basisnamen basierende Bedingungen konfigurieren können.</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>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> or click on 
              <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>
              button to insert a new condition filter
            </para>
          </listitem>
          <listitem>
            <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Basisnamen enthält.</para>
            <tip>
              <para>
                A basename-based condition may use « <literal>*</literal> » or
                « <literal>?</literal> » wildcard characters.
              </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>
          <!-- i18n: "Must match one of" is a UI label -->
          Click on the <guilabel>Must match one of</guilabel> or
          <!-- i18n: "Must not match any of" is a UI label -->
          <guilabel>Must not match any of</guilabel> radio button in the
          same row to set the corresponding condition.
        </para>
      </listitem>
    </orderedlist>
    <para>
      Depending of your target operating system, make sure that the
      <!-- i18n: "Match case" is a UI label -->
      <guilabel>Match case</guilabel> checkbox is activated (or not). 
    </para>
    <itemizedlist>
      <listitem>
        <para>
          When activated, all filters are considered as case sensitive,
          <!-- i18n: "/my/file" is an example of *nix filename, and may be translated -->
          which means that <filename>/my/file</filename> filename is
          <!-- i18n: "/My/File" is an example of *nix filename, and may be translated -->
          considered distinct from <filename>/My/File</filename> one.
        </para>
        <para>Dies ist das vorgegebene Verhalten auf Unix-ähnlichen Systemen.</para>
      </listitem>
      <listitem>
        <para>
          When deactivated, filters are considered as case insensitive,
          <!-- i18n: "/my/file" is an example of *nix filename, and may be translated -->
          which means that <filename>/my/file</filename> and
          <!-- i18n: "/My/File" is an example of *nix filename, and may be translated -->
          <filename>/My/File</filename> filenames are considered the same
          name.
        </para>
        <para>
          This is most probably what you want if you target some sort of
          <productname>Windows</productname> system.
        </para>
      </listitem>
    </itemizedlist>
    <para>
      Removing a defined basename-based condition is as simple as selecting
      <!-- i18n: "Del" is a key name -->
      it, and pressing <keycap>Del</keycap> (or clicking on 
      <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>
      button).
    </para>
    <para>
      By default, the basename-based condition is just one
      <!-- i18n: "must match one of" matches a UI label, may be translated -->
      « <literal>must match one of *</literal> » condition.
      As all basenames always match the « <literal>*</literal> »
      condition, this just means that basename-based conditions are not
      considered as relevant for the action.
    </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>
      <!-- i18n: "Mimetypes" is a UI label -->
      Click on the <guilabel>Mimetypes</guilabel> tab to show the page
      which will permit you to configure your mimetype-based conditions.
    </para>
    <figure id="cact-FIG-tab-mimetypes">
      <title>Auf dem MIME-Typ basierende Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-mimetypes-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf dem MIME-Typen basierende Bedingungen festlegen können.</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 ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf dem MIME-Typ basierenden Bedingungen gegen den MIME-Typ des aktuellen Orts angewendet. Letzter ist der sehr bekannte MIME-Typ »inode/directory«.</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>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> or click on 
              <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>
              button to insert a new condition filter
            </para>
          </listitem>
          <listitem>
            <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten MIME-Typen enthält.</para>
            <para>
              A mimetype must be defined as a
              <!-- i18n: "group/subgroup" stands for a mimetype template, may be translated -->
               <literal>group/subgroup</literal>
              expression.
            </para>
            <tip>
              <para>
                The « <literal>*</literal> » wildcard is supported only in some
                situations:
              </para>
              <itemizedlist>
                <listitem>
                  <para>
                    The « <literal>*/*</literal> » expression
                    matches all mimetypes. As a convenient shortcut, the
                    « <literal>*</literal> » literal is also accepted for this same purpose.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <!-- i18n: "group" stands for the first part of a mimetype, may be translated -->
                    A <literal>group/*</literal> string
                    <!-- i18n: "group" stands for the first part of a mimetype, may be translated -->
                    matches all subgroups of <literal>group</literal> mimetype.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <!-- i18n: "subgroup" stands for the second part of a mimetype, may be translated -->
                    The <literal>*/subgroup</literal> string
                    is not accepted as a valid wildcard.
                  </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>
          <!-- "Must match one of" is a UI label -->
          Click on the <guilabel>Must match one of</guilabel> or
          <!-- "Must not match any of" is a UI label -->
          <guilabel>Must not match any of</guilabel> radio button in the
          same row to set the corresponding condition.
        </para>
      </listitem>
    </orderedlist>
    <para>
      Removing a defined mimetype-based condition is as simple as
      <!-- i18n: "Del" is a key name -->
      selecting it, and pressing <keycap>Del</keycap> (or clicking on 
      <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>
      button).
    </para>
    <para>
      By default, the mimetype-based condition is just one
      <!-- i18n: "must match one of */*" matches a UI label, and may be translated -->
      « <literal>must match one of */*</literal> » condition.
      As all mimetypes always match the « <literal>*/*</literal> »,
      this just means that mimetypes are not considered as relevant 
      for the action.
    </para>
    <example>
      <title>Beispiel für übliche MIME-Typen</title>
      <variablelist>
        <varlistentry>
          <term>
            <!-- 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>
            <!-- 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>
            <!-- 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>
      <!-- i18n: "Folders" is a UI label -->
      Click on the <guilabel>Folders</guilabel> tab to show the page
      which will permit you to configure your folder-based conditions.
    </para>
    <figure id="cact-FIG-tab-folders">
      <title>Auf Ordnern basierende Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-folders-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf Ordnern basierende Bedingungen konfigurieren können.</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 für das Kontextmenü der Auswahl bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den Ordnernamen jedes aktuell ausgewählten Objekts angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden Ihre auf Ordnern basierenden Bedingungen auf den aktuellen Ort angewendet.</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>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> or click on 
              <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>
              button to insert a new condition filter
            </para>
          </listitem>
          <listitem>
            <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie den gewünschten Ordner enthält.</para>
            <tip>
              <para>
                The « <literal>*</literal> » and « <literal>?</literal> » characters
                are accepted as wildcards at any level of the defined
                folder filter.
              </para>
            </tip>
          </listitem>
          <listitem>
            <para>
              Or click on
              <guibutton>Browse</guibutton> to select a folder on the file system.
            </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>
          <!-- i18n: "Must match one of" is a UI label -->
          Click on the <guilabel>Must match one of</guilabel> or
          <!-- i18n: "Must not match any of" is a UI label -->
          <guilabel>Must not match any of</guilabel> radio button in
          the same row to set the corresponding condition.
        </para>
      </listitem>
    </orderedlist>
    <para>
      Removing a defined folder-based condition is as simple as
      <!-- i18n: "Del" is a key name -->
      selecting it, and pressing <keycap>Del</keycap> (or clicking on 
      <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>
      button).
    </para>
    <para>
      By default, the folder-based condition is just one
      <!-- i18n: "must match one of /" matches a UI label -->
      « <literal>must match one of /</literal> » condition.
      As <literal>/</literal> is always the top of an Unix-like file system,
      then all selected items always match this condition.
    </para>
    <note>
      <para>
        If you target a <productname>Windows</productname> system, then this default value may
        not be what you actually want.
      </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>
      <!-- i18n: "Schemes" is a UI label -->
      Click on the <guilabel>Schemes</guilabel> tab to show the page
      which will permit you to configure your scheme-based conditions.
    </para>
    <figure id="cact-FIG-tab-schemes">
      <title>Schemata basierte Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-schemes-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf Schemata basierende Bedingungen konfigurieren können.</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 für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Schemata basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Schemata basierenden Bedingungen auf das Schema des aktuellen Orts angewendet.</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>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> or click on 
              <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>
              button to insert a new condition filter
            </para>
          </listitem>
          <listitem>
            <para>Bearbeiten Sie die neu eingefügte Filterbedingung, so dass sie das gewünschte Schema enthält.</para>
            <tip>
              <para>
                Scheme-based conditions only accept « <literal>*</literal> » wildcard,
                which stands for « any scheme ».
              </para>
            </tip>
          </listitem>
          <listitem>
            <para>Or click on <!-- i18n: "Common" is a UI (button) label --><guibutton>Common</guibutton> to select a scheme among those predefined in <menuchoice><!-- i18n: "Edit" is a menu item --><guimenu>Edit</guimenu><!-- i18n: "Preferences" is a menu item --><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
            <figure id="cact-FIG-add-scheme">
              <title>Auswahl eines Schemas aus vordefinierten Schemata</title>
              <screenshot>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="figures/cact-new-scheme.png" format="PNG"/>
                  </imageobject>
                  <textobject>
                    <phrase>Die Liste der vordefinierten Schemata anzeigen.</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>
              <!-- i18n: "OK" is a UI (button) label -->
              To select a new scheme, click <guibutton>OK</guibutton>,
              or double-click on the desired row.
            </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>
          <!-- i18n: "Must match one of" is a UI label -->
          Click on the <guilabel>Must match one of</guilabel> or
          <!-- i18n: "Must not match any of" is a UI label -->
          <guilabel>Must not match any of</guilabel> radio button
          in the same row to set the corresponding condition.
        </para>
      </listitem>
    </orderedlist>
    <para>
      Removing a defined scheme-based condition is as simple as selecting
      <!-- i18n: "Del" is a key name -->
      it, and pressing <keycap>Del</keycap> (or clicking on 
      <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>
      button).
    </para>
    <para>
      By default, the scheme-based condition is just one
      <!-- i18n: "must match one of *" matches a UI label -->
      « <literal>must match one of *</literal> » condition,
      which means that schemes are not relevant for this action.
    </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>
      <!-- i18n: "Local" is a capability keyword, not translatable -->
      But except for the <literal>Local</literal> capability, all others
      depend on the user who executes the command.
    </para>
    <para>
      You may so decide that your action will appear, or not, depending
      on the capabilities of the selected item(s) <abbrev>vs.</abbrev>
      the current user.
    </para>
    <para>
      <!-- i18n: "Capabilities" is a UI label -->
      Click on the <guilabel>Capabilities</guilabel> tab to show the page
      which will permit you to configure your capability-based conditions.
    </para>
    <figure id="cact-FIG-tab-capabilities">
      <title>Auf Fähigkeiten basierende Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-capabilities-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf Fähigkeiten basierende Bedingungen konfigurieren können.</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 für das Kontextmenü der Auswahl bestimmt ist, dann werden die auf Fähigkeiten basierende Bedingungen auf die aktuell ausgewählten Objekte angewendet. Wenn Ihre Aktion dagegen für das Kontextmenü des Orts oder für die Werkzeugleiste bestimmt ist, dann werden die auf Fähigkeiten basierenden Bedingungen auf jene des aktuellen Orts angewendet.</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>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> to insert a new condition
              filter.
            </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>
              Or click on
              <guibutton><inlinegraphic fileref="figures/add.png"/></guibutton>
              <!-- i18n: "Adding a new capability" is a UI (dialog title) label -->
              to open the <guilabel>Adding a new capability</guilabel> dialog
              box.
            </para>
            <figure id="cact-FIG-add-capability">
              <title>Verwaltete Fähigkeiten</title>
              <screenshot>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="figures/cact-new-capability.png" format="PNG"/>
                  </imageobject>
                  <textobject>
                    <phrase>Zeigt eine Liste der verwalteten Fähigkeiten.</phrase>
                  </textobject>
                </mediaobject>
              </screenshot>
            </figure>
            <para>Eine neue Fähigkeit darf hier nur ausgewählt werden, wenn es nicht bereits als Fähigkeiten-Filter definiert wurde.</para>
            <para>
              <!-- i18n: "OK" is a UI (button) label -->
              To select a new capability, click <guibutton>OK</guibutton>,
              or double-click on the desired row.
            </para>
          </listitem>
        </itemizedlist>
      </listitem>
      <listitem>
        <para>Gibt an, ob es sich um eine Bedingung der Form »muss mit allen von  … übereinstimmen« oder »darf nicht mit einem von … übereinstimmen« handelt.</para>
        <para>
          <!-- i18n: "Must match all of" is a UI label -->
          Click on the <guilabel>Must match all of</guilabel> or
          <!-- i18n: "Must not match any of" is a UI label -->
          <guilabel>Must not match any of</guilabel> radio button in the
          same row to set the corresponding condition.
        </para>
      </listitem>
    </orderedlist>
    <para>
      Removing a defined capability-based condition is as simple as
      <!-- i18n: "Del" is a key name -->
      selecting it, and pressing <keycap>Del</keycap> (or clicking on 
      <guibutton><inlinegraphic fileref="figures/remove.png"/></guibutton>
      button).
    </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>
        If your action consists in displaying the differences between
        two files, you may define here
        <!-- i18n: "Count = (equal to) 2" is a UI label -->
        « <literal>Count = (equal to) 2</literal> ».
      </para>
    </example>
    <para>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the
      page which will permit you to configure your environment-based
      conditions.
    </para>
    <figure id="cact-FIG-tab-environment">
      <title>Auf der Umgebung basierende Bedingungen</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-environment-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Zeigt den Reiter, in welchem Sie auf der Umgebung basierende Bedingungen konfigurieren können. Hier sind die Konfiguration der Anzahl der Auswahl, die Auswahl der Arbeitsumgebung sowie Laufzeitfilter enthalten.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      The selection count condition is defined in the
      <guilabel>'Appears if selection contains'</guilabel> frame.
    </para>
    <figure id="cact-FIG-frame-count">
      <title>Bereich für den Auswahlzähler</title>
      <screenshot>
        <mediaobject>
          <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>
          <!-- i18n: "Count" is a UI label -->
          Select in the <guilabel>Count</guilabel> drop-down list
          the operator you want apply to the selection count:
        </para>
        <simplelist type="vert">
          <member><literal>&lt;</literal> <termdef>(definitiv kleiner als)</termdef></member>
          <member><literal>=</literal> <termdef>(entspricht)</termdef></member>
          <member><literal>&gt;</literal> <termdef>(definitiv größer als)</termdef></member>
        </simplelist>
      </listitem>
      <listitem>
        <para>Geben Sie die gewünschte Auswahlanzahl ein.</para>
      </listitem>
    </itemizedlist>
    <para>
      The selection count defaults to
          <!-- i18n: "Count > (strictly greater than) 0" is a UI label -->
      « <literal>Count &gt; (strictly greater than) 0</literal> »,
      which means that the action will be a candidate to be displayed
      as soon as at least one item is selected in the file manager.
    </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>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the page
      which will permit you to configure your environment-based conditions.
    </para>
    <para>
      The desktop selection is defined in the
      <!-- i18n: "Desktop environment" is a UI label -->
      <guilabel>Desktop environment</guilabel> frame.
    </para>
    <figure id="cact-FIG-frame-desktop">
      <title>Feld zur Auswahl der Arbeitsumgebung</title>
      <screenshot>
        <mediaobject>
          <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>
      The targeted desktop environment condition defaults to
      <!-- i18n: "Always appear" is a UI label -->
      « <literal>Always appear</literal> »,
      which means that the action will be a candidate to be displayed
      regardless of the current desktop environment.
    </para>
  </sect3>

  <sect3 id="usage-conditions-executable">
    <title>Bedingung für ausfü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>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the page
      which will permit you to configure your environment-based conditions.
    </para>
    <para>
      The executable found condition is defined in the
      <!-- i18n: "Execution environment" is a UI label -->
      <guilabel>Execution environment</guilabel> frame.
    </para>
    <figure id="cact-FIG-frame-execution-environment">
      <title>Feld <guilabel>Ausführungsumgebung</guilabel></title>
      <screenshot>
        <mediaobject>
          <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>
      To define the relevant file, enter its full filename in the
      <guilabel>Appears if the file is executable</guilabel> entry
      <!-- i18n: "Browse" is a UI (button) label -->
      box, or click on <guibutton>Browse</guibutton> to select a file
      on the file system.
    </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>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the page
      which will permit you to configure your environment-based conditions,
      <!-- i18n: "Execution environment" is a UI label -->
      and focus on <guilabel>Execution environment</guilabel> frame.
    </para>
    <para>
      To define the relevant name, enter it in the
      <guilabel>Appears if the name is registered on D-Bus</guilabel>
      entry box.
    </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 ausgewählten Objekt(en) abhängen.</para>
    </tip>
  </sect3>

  <sect3 id="usage-conditions-true">
    <title>Angepasste Bedingung</title>
    <para>
      You may define that your action will only appear if some given
      <!-- i18n: "true" is a literal value, not translatable -->
      command outputs a <literal>true</literal> string on its standard
      output.
    </para>
    <para>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the page
      which will permit you to configure your environment-based conditions,
      <!-- i18n: "Execution environment" is a UI label -->
      and focus on <guilabel>Execution environment</guilabel> frame.
    </para>
    <para>
      This lets you define your own customized condition filter,
      by writing a small script which outputs, or not, the
      <!-- i18n: "true" is a literal value, not translatable -->
      <literal>true</literal> string on stdout when it is ran.
    </para>
    <para>
      To define the command, enter it in the
      <!-- i18n: "true" is a literal value, not translatable -->
      <guilabel>Appears if the command outputs "true"</guilabel>
      entry box.
    </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>
      <!-- i18n: "Environment" is a UI label -->
      Click on the <guilabel>Environment</guilabel> tab to show the page
      which will permit you to configure your environment-based conditions,
      <!-- i18n: "Execution environment" is a UI label -->
      and focus on <guilabel>Execution environment</guilabel> frame.
    </para>
    <para>
      To define the binary, enter its name in the
      <guilabel>Appears if the binary is running</guilabel>
      <!-- i18n: "Browse" is a UI (button) label -->
      entry box, or click on <guibutton>Browse</guibutton> to select
      a file on the file system.
    </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 ausgewählten Objekt(en) abhängen.</para>
    </tip>
  </sect3>
</sect2>
