<?xml version="1.0" encoding="utf-8"?>
<sect2 id="usage-conditions">
  <title>Définition des conditions</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>Il est possible d'imposer des conditions relativement à l'emplacement sur lequel le gestionnaire de fichiers pointe actuellement ou bien relativement aux éléments actuellement sélectionnés dans cet emplacement.</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>Conditions relatives aux noms de base</title>
    <para>Vous pouvez décider que l'action apparaît en fonction du nom de base des éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez définir que chaque élément de la sélection doit entrer dans une certaine typologie de nom de base en vérifiant simultanément qu'aucun élément parmi ceux sélectionnés n'ait un autre type de nom de base.</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>Conditions relatives aux noms de base</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-basenames-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche l'onglet qui vous permet de définir les conditions relatives aux noms de base.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>En pratique, les conditions relatives aux noms de base se fondent sur une liste de motifs « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ». Pour que l'action soit candidate compte tenu des conditions relatives aux noms de base, chaque élément de la sélection doit remplir toutes les conditions de la liste : le nom de base de chaque élément doit se conformer à au moins un des motifs « Doit correspondre à l'un des » tout en ne répondant à aucun des motifs « Ne doit correspondre à aucun des ».</para>
    <para>Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.</para>
    <para>Si l'action cible le menu contextuel de la sélection, les conditions relatives aux noms de base seront vérifiées pour chacun des éléments sélectionnés. Si elle cible le menu contextuel de l'emplacement ou la barre d'outils, les conditions relatives aux noms de base seront vérifiées par rapport au nom de base de l'emplacement actif.</para>
    <para>La définition d'une nouvelle condition relative aux noms de base s'effectue en deux étapes.</para>
    <orderedlist>
      <listitem>
        <para>Définir le filtre de la nouvelle condition.</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>Modifiez le filtre de la condition nouvellement ajoutée au nom de base auquel vous souhaitez qu'il se rapporte.</para>
            <tip>
              <para>
                A basename-based condition may use « <literal>*</literal> » or
                « <literal>?</literal> » wildcard characters.
              </para>
            </tip>
          </listitem>
        </itemizedlist>
      </listitem>
      <listitem>
        <para>Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».</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>C'est le comportement par défaut des systèmes de type Unix.</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>Conditions relatives au type MIME</title>
    <para>Vous pouvez décider que votre action apparaît selon les types MIME des éléments de la sélection en cours dans le gestionnaire de fichiers : vous pouvez indiquer que chaque élément de la sélection doit être d'un type MIME donné tout en décidant simultanément qu'aucun élément sélectionné ne doit appartenir à tel ou tel autre type MIME.</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>Conditions relatives au type MIME</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-mimetypes-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche l'onglet qui vous permet de définir les conditions relatives aux types MIME.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>En pratique, les conditions relatives aux types MIME sont fondées sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit correspondre à aucun des ». Pour que votre action soit candidate en regard des conditions relatives aux types MIME, tout élément de la sélection doit respecter toutes les conditions définies : le type MIME de chaque élément doit correspondre à au moins un des motifs « Doit correspondre à l'un des » tout en ne coïncidant avec aucun des motifs de la colonne « Ne doit correspondre à aucun des ».</para>
    <para>Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.</para>
    <para>Lors de l'ouverture du menu contextuel de la sélection, les conditions relatives aux types MIME sont vérifiées pour chacun des éléments choisis. Lors de l'ouverture du menu contextuel de l'emplacement ou de la barre d'outils, les conditions relatives au type MIME sont contrôlées vis à vis du type MIME de l'emplacement actuel, qui se trouve être le type MIME bien connu « inode/directory ».</para>
    <para>La définition d'une nouvelle condition fondée sur le type MIME s'effectue en deux étapes.</para>
    <orderedlist>
      <listitem>
        <para>Définir le filtre de la nouvelle condition.</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>Définissez le filtre de la condition nouvellement introduite pour le type MIME que vous voulez comparer.</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>Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».</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>Exemple de types MIME usuels</title>
      <variablelist>
        <varlistentry>
          <term>
            <!-- i18n: "all/all" is a mimetype, not translatable -->
            <literal>all/all</literal>
          </term>
          <listitem>
            <para>Correspond à tous les éléments.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <!-- i18n: "all/allfiles" is a mimetype, not translatable -->
            <literal>all/allfiles</literal>
          </term>
          <listitem>
            <para>Correspond à tous les fichiers réguliers.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <!-- i18n: "inode/directory" is a mimetype, not translatable -->
            <literal>inode/directory</literal>
          </term>
          <listitem>
            <para>Correspond uniquement aux répertoires.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </example>
  </sect3>

  <sect3 id="usage-conditions-folders">
    <title>Conditions relatives aux dossiers</title>
    <para>Vous pouvez décider que l'action s'affiche selon le répertoire dans lequel sont contenus les éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez définir que chaque élément de la sélection doit se situer dans telle ou telle partie de l'arborescence des fichiers et, simultanément, ne pas situer dans une autre.</para>
    <para>Une condition relative aux dossiers doit se comprendre comme étant la définition de l'arborescence des fichiers dans laquelle l'élément en cours d'examen doit (ou ne doit pas) être situé : c'est un motif de noms de répertoires pour l'élément.</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>Conditions relatives aux dossiers</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-folders-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche l'onglet qui vous permet de définir les conditions relatives aux dossiers.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>En pratique, les conditions relatives aux dossiers se fondent sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit pas correspondre à un des ». Pour que l'action soit candidate compte tenu des conditions relatives aux dossiers, chaque élément de la sélection doit être valide pour toutes les conditions fixées : chaque élément doit être situé dans un des dossiers définis dans « Doit correspondre à l'un des » sans appartenir à aucun de ceux définis dans « Ne doit correspondre à aucun des ».</para>
    <para>Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.</para>
    <para>Quand l'action a pour cible le menu contextuel d'une sélection, les conditions relatives aux dossiers sont vérifiées en examinant le nom du répertoire de chaque élément sélectionné. Quand est ciblé le menu contextuel de l'emplacement ou la barre d'outils, ces mêmes conditions sont contrôlées par rapport à l'emplacement en cours.</para>
    <para>La définition d'une nouvelle condition se rapportant à un dossier s'effectue en deux étapes.</para>
    <orderedlist>
      <listitem>
        <para>Définir le filtre de la nouvelle condition.</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>Définir le filtre de la condition nouvellement introduite au dossier que vous voulez comparer.</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>Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».</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>Conditions relatives au protocole</title>
    <para>Vous pouvez décider que l'action est affichée selon les protocoles des URI des éléments actuellement sélectionnés dans le gestionnaire de fichiers : vous pouvez décider que chaque élément de la sélection doit respecter tel ou tel protocole et, simultanément, de pas relever d'un autre.</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>Conditions relatives aux protocoles</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-schemes-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche l'onglet qui vous permet de définir les conditions relatives aux protocoles.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>En pratique, les conditions relatives aux protocoles sont bâties sur une liste de motifs « Doit correspondre à l'un des » et « Ne doit correspondre à aucun des ». Pour que l'action soit candidate selon les conditions relatives aux protocoles, chaque élément de la sélection doit répondre à l'ensemble des conditions précisées : le protocole de chaque élément doit répondre à une au moins des conditions définies dans les motifs « Doit correspondre à l'un des » tout en ne répondant à aucune des conditions « Ne doit correspondre à aucun des ».</para>
    <para>Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.</para>
    <para>Quand l'action cible le menu contextuel d'une sélection, les conditions relatives aux protocoles sont vérifiées par rapport aux éléments de la sélection actuelle. Quand est ciblé le menu contextuel d'un emplacement ou une barre d'outils, les conditions relatives aux protocoles sont contrôlées relativement au protocole de l'emplacement actuel.</para>
    <para>La définition d'une nouvelle condition relative aux protocoles s'effectue en deux étapes.</para>
    <orderedlist>
      <listitem>
        <para>Définir le filtre de la nouvelle condition.</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>Établir le filtre de la condition nouvellement introduite au protocole à vérifier.</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>Choix d'un protocole parmi ceux prédéfinis par défaut</title>
              <screenshot>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="figures/cact-new-scheme.png" format="PNG"/>
                  </imageobject>
                  <textobject>
                    <phrase>Affiche la liste des protocoles prédéfinis.</phrase>
                  </textobject>
                </mediaobject>
              </screenshot>
            </figure>
            <para>Un nouveau protocole ne peut être sélectionné ici que s'il n'a pas déjà été utilisé dans un autre filtre de protocole.</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>Indiquer s'il s'agit d'une condition « Doit correspondre à l'un des » ou « Ne doit correspondre à aucun des ».</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>Conditions relatives aux attributs</title>
    <para>Les attributs sont des propriétés qu'un fichier peut exposer vis à vis de l'utilisateur.</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>Conditions relatives aux attributs</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-capabilities-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche la page qui permet de définir les conditions relatives aux attributs.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>En pratique, les conditions relatives aux attributs sont bâties sur une liste de motifs « Doit correspondre à tous les » et « Ne doit correspondre à aucun des ». Pour que l'action soit candidate selon les conditions relatives aux attributs, chaque élément de la sélection doit répondre à toutes les conditions définies : l'attribut de chaque élément doit répondre à chacun des attributs précisés dans les motifs « Doit correspondre à tous les » tout en ne répondant à aucun des attributs « Ne doit correspondre à aucun des ».</para>
    <para>Si un seul élément de la sélection ne remplit pas toutes les conditions définies, l'action ne sera pas affichée.</para>
    <para>
      When targeting the selection context menu, your capability-based
      conditions will be checked against the currently selected items.
      When targeting the location context menu or the toolbar, your
      capability-based conditions will be checked against those of the
      current location.
    </para>
    <para>La définition d'une nouvelle condition relative aux attributs s'effectue en deux étapes.</para>
    <orderedlist>
      <listitem>
        <para>Définir le filtre de la nouvelle condition.</para>
        <itemizedlist>
          <listitem>
            <para>
              <!-- i18n: "Insert" is a key name -->
              Press <keycap>Insert</keycap> to insert a new condition
              filter.
            </para>
          </listitem>
          <listitem>
            <para>établissez le filtre de la condition nouvellement introduite à l'attribut à vérifier,</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>Attributs pris en charge</title>
              <screenshot>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="figures/cact-new-capability.png" format="PNG"/>
                  </imageobject>
                  <textobject>
                    <phrase>Affiche la liste des attributs pris en charge.</phrase>
                  </textobject>
                </mediaobject>
              </screenshot>
            </figure>
            <para>Un nouvel attribut ne peut être choisi dans cette liste que s'il n'a pas déjà été utilisé dans un autre filtre d'attribut.</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>Indiquer s'il s'agit d'une condition « Doit correspondre à tous les » ou « Ne doit correspondre à aucun des ».</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>Par défaut, la liste des conditions relatives aux attributs est vide. Cela signifie qu'aucun attribut n'est pertinent pour l'action.</para>
  </sect3>

  <sect3 id="usage-conditions-count">
    <title>Condition relative au nombre de sélections</title>
    <para>Vous pouvez indiquer que l'action ne s'affiche que si le nombre de fichiers de la sélection actuelle dans le gestionnaire de fichiers possède une valeur ou une relation précise avec le nombre d'éléments donné.</para>
    <example>
      <title>Exemple d'utilisation d'un décompte de sélection</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>Conditions relatives à l'environnement</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/cact-environment-tab.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Affiche l'onglet qui permet de définir les conditions relatives à l'environnement. Ces conditions comprennent la configuration du nombre d'éléments sélectionnés, le choix du bureau et les filtres d'exécution.</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>Encadré de la condition sur le nombre d'éléments sélectionnés</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>Si la cible est le menu contextuel des sélections, les conditions relatives au nombre d'éléments seront vérifiées par rapport au nombre d'éléments de la sélection en cours. Si est ciblé le menu contextuel de l'emplacement ou la barre d'outils, la condition relative au nombre d'éléments sera vérifiée par rapport à zéro étant donné qu'il n'y a pas d'élément sélectionné dans ce cas.</para>
    <para>Pour définir une condition sur le nombre d'éléments sélectionnés :</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>(strictement plus petit que)</termdef></member>
          <member><literal>=</literal> <termdef>(égal à)</termdef></member>
          <member><literal>&gt;</literal> <termdef>(strictement plus grand que)</termdef></member>
        </simplelist>
      </listitem>
      <listitem>
        <para>Saisissez la valeur souhaitée comme référence de décompte.</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>Sélection du bureau</title>
    <para>Vous pouvez définir que l'action :</para>
    <itemizedlist>
      <listitem>
        <para>apparaît dans tous les cas,</para>
      </listitem>
      <listitem>
        <para>ou n'apparaît que dans des environnement bureau donnés,</para>
      </listitem>
      <listitem>
        <para>ou n'apparaît pas dans des environnements de bureau donnés.</para>
      </listitem>
    </itemizedlist>
    <para>Il n'y a qu'un seul choix possible entre ces trois éléments.</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>Encadré de sélection du bureau</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>Pour définir la condition d'environnement de bureau :</para>
    <orderedlist>
      <listitem>
        <para>D'abord sélectionnez le type de filtre :</para>
        <simplelist type="vert">
          <member>votre action doit-elle toujours apparaître quel que soit l'environnement de bureau ?</member>
          <member>votre action doit-elle uniquement apparaître dans certains environnements de bureau ?</member>
          <member>votre action ne doit-elle jamais apparaître dans certains environnements de bureau ?</member>
        </simplelist>
      </listitem>
      <listitem>
        <para>Si l'action ne doit jamais apparaître, sélectionnez ensuite les environnements de bureau concernés dans la liste sur le côté droit.</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>Condition relative à la présence d'un exécutable</title>
    <para>Vous pouvez décider que l'action n'apparaît que si un paquet requis est installé sur le système. Dans ce cas, cette vérification s'effectue en recherchant qu'un fichier donné, connu ou supposé connu comme fourni par le paquet, est bien présent dans le système de fichiers et est exécutable.</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>Encadré de l'environnement d'exécution</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>Laissez ce champ vide si la condition n'est pas pertinente pour l'action.</para>
    <tip>
      <para>Vous pouvez intégrer certains paramètres relatifs au fichier recherché. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.</para>
    </tip>
  </sect3>

  <sect3 id="usage-conditions-dbus">
    <title>Condition d'enregistrement D-Bus</title>
    <para>Vous pouvez définir que l'action n'apparaît que si un nom donné est enregistré sur le système D-Bus lors de l'exécution.</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>Laissez ce champ vide si la condition n'est pas pertinente pour l'action.</para>
    <tip>
      <para>Vous pouvez incorporer des paramètres dans le nom à rechercher. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.</para>
    </tip>
  </sect3>

  <sect3 id="usage-conditions-true">
    <title>Condition personnalisée</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>Laissez ce champ vide si la condition n'est pas pertinente pour l'action.</para>
    <tip>
      <para>Vous pouvez incorporer des paramètres dans le nom du fichier à exécuter ou dans ses options. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.</para>
    </tip>
  </sect3>

  <sect3 id="usage-conditions-run">
    <title>Condition relative à un processus en cours d'exécution</title>
    <para>Vous pouvez définir que l'action n'apparaît que si un binaire donné est en cours d'exécution.</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>Même si vous saisissez ici le nom et le chemin du binaire, seul son nom de base sera recherché dans la liste des processus en cours d'exécution.</para>
    </note>
    <para>Laissez ce champ vide si la condition n'est pas pertinente pour l'action.</para>
    <tip>
      <para>Vous pouvez incorporer des paramètres dans le nom à rechercher. Les valeurs, qui dépendent des éléments de la sélection en cours, seront substituées dynamiquement à ces paramètres lors de l'exécution.</para>
    </tip>
  </sect3>
</sect2>
