<?xml version="1.0" encoding="utf-8"?>
<sect2 id="getting-started-starting">
      <title>Starting <application>Caja-Actions Configuration Tool</application></title>
      <para>
        You can start <application>Caja-Actions Configuration Tool</application> in the following ways:
      </para>
      <variablelist>
        <varlistentry>
          <term><guimenu>System</guimenu> menu</term>
          <listitem>
            <para>Choose <menuchoice><guisubmenu>Preferences</guisubmenu><guisubmenu>Look and Feel</guisubmenu><guimenuitem>Caja-Actions Configuration Tool</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Ligne de commande</term>
          <listitem>
            <para>
              To start <application>Caja-Actions Configuration Tool</application> from a command line, type the following command:
            </para>
            <para>
              <command><filename>caja-actions-config-tool</filename></command>
            </para>
            <para>
              <!-- i18n: "Return" is a key name -->
              then press <keycap>Return</keycap>.
            </para>
            <tip>
              <para>Pour afficher toutes les options disponibles en ligne de commande, saisissez :</para>
              <para>
                <command>
                  <filename>caja-actions-config-tool</filename>
                  <option>--help-all</option>
                </command>
              </para>
              <para>
                <!-- i18n: "Return" is a key name -->
                then press <keycap>Return</keycap>.
              </para>
            </tip>
          </listitem>
        </varlistentry>
      </variablelist>

    <sect2 id="getting-started-first-run">
      <title>Le premier lancement</title>
      <para>
        When you start <application>Caja-Actions Configuration Tool</application>, the following window is displayed.
      </para>
      <figure id="cact-FIG-main-empty">
        <title><application>Caja-Actions Configuration Tool</application> Start Up Window</title>
        <screenshot>
          <mediaobject>
            <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>
        The <application>Caja-Actions Configuration Tool</application> main window contains the following elements:
      </para>
      <variablelist>
        <varlistentry>
          <term>Une barre de menus.</term>
          <listitem>
            <para>
              The menus on the menubar contain all of the commands
              you need to use in <application>Caja-Actions Configuration Tool</application>.
            </para>
            <para>Des raccourcis clavier sont disponibles pour certaines commandes :</para>
            <variablelist>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>N</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Créer une nouvelle action.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>S</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Enregistrer les actions et les menus modifiés.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>Q</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Quitter l'application.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>X</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Couper la sélection en cours tout en la gardant dans le presse-papier.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>C</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Copier la sélection en cours dans le presse-papier.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Insérer le contenu du presse-papier devant l'élément sélectionné.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Maj</keycap>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Insérer le contenu du presse-papier en tant que sous-élement de l'élément sélectionné.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Suppr.</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Supprimer la sélection actuelle.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F5</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Recharger les actions et les menus.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F1</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Afficher l'aide.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Une barre d'outils.</term>
          <listitem>
            <para>Several toolbars may be displayed below the menubar, depending of your choices in the <menuchoice><guimenu>View</guimenu><guimenuitem>Toolbars</guimenuitem></menuchoice> submenu.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Une liste d'éléments.</term>
          <listitem>
            <para>
              The list on the left of the main window contains all items,
              whether they are actions or menus, currently available for
              edition in <application>Caja-Actions Configuration Tool</application>.
            </para>
            <para>Les éléments peuvent être triés dans l'ordre alphabétique naturel ou inverse. Ils peuvent également être gérés et organisés par l'utilisateur sans tri particulier.</para>
            <para>Les éléments non-valides sont affichés en rouge.</para>
            <para>Les éléments modifiés sont affichés en italiques.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Des boutons de tri.</term>
          <listitem>
            <para>Trois boutons permettent de choisir le mode de tri.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Des onglets de propriétés.</term>
          <listitem>
            <para>La partie droite de la fenêtre principale affiche tout ce qui est nécessaire pour définir comment, quand et où actions et menus sont affichés.</para>
            <variablelist>
              <varlistentry>
                <term>Action/Menu</term>
                <listitem>
                  <para>
                    Define in which <productname>Caja</productname> menus the item should
                    appear, and how it will be displayed.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Commande</term>
                <listitem>
                  <para>Définit la commande à exécuter et quels paramètres lui transmettre.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Exécution</term>
                <listitem>
                  <para>Définit comment votre commande est exécutée.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Noms de base</term>
                <listitem>
                  <para>
                    Define the basename filters the <productname>Caja</productname> selection
                    must satisfy in order the action or menu be candidate
                    for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Types MIME</term>
                <listitem>
                  <para>
                    Define the mimetype filters the <productname>Caja</productname> selection
                    must satisfy in order the action or menu be candidate
                    for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Dossiers</term>
                <listitem>
                  <para>
                    Define the folder filters the <productname>Caja</productname> selection
                    must satisfy in order the action or menu be candidate
                    for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Protocoles</term>
                <listitem>
                  <para>
                    Define the scheme filters the <productname>Caja</productname> selection
                    must satisfy in order the action or menu be candidate
                    for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Attributs</term>
                <listitem>
                  <para>
                    Define the capability filters the <productname>Caja</productname> selection
                    must satisfy in order the action or menu be candidate
                    for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Environnement</term>
                <listitem>
                  <para>
                    Define some environment conditions the <productname>Caja</productname>
                    selection must satisfy in order the action or menu
                    be candidate for display.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Propriétés</term>
                <listitem>
                  <para>Affiche les propriétés des éléments.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Une barre d'état.</term>
          <listitem>
            <para>Cette barre affiche des informations d'état à propos de l'élément sur la ligne actuellement sélectionnée dans la liste des éléments.</para>
            <para>Quand il n'y a aucune information pertinente à afficher, la barre d'état affiche le décompte des menus, actions ou profils chargés.</para>
            <para>
              <!-- i18n: "read-only" may be translated -->
              The « read-only » icon 
              <inlinegraphic fileref="figures/read-only.png"/>
              is displayed in
              the right of the statusbar when appropriate.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="getting-started-first-action">
      <title>Création de votre première action</title>
      <para>Dans cet exemple, nous allons créer une action qui affiche des informations intéressantes à propos de la sélection actuelle.</para>
      <formalpara>
        <title>Vérification des prérequis</title>
        <para>
          This action will require <productname>MateDialog</productname>.
        </para>
      </formalpara>
      <para>
        <productname>MateDialog</productname> is a program which will allow you to create a graphical
        user interface from a command-line.
      </para>
      <para>Il faut vérifier que ce programme est installé sur le système ; par exemple, saisissez dans un terminal la commande suivante :</para>
      <para>
        <command>
          <filename>matedialog</filename>
        </command>
      </para>
      <para>
        then press <keycap>Return</keycap>.
      </para>
      <formalpara>
        <title>Création de l'action</title>
        <para>To create a new action, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut><guimenu>File</guimenu><guisubmenu>New action</guisubmenu></menuchoice>.</para>
      </formalpara>
      <para>Une nouvelle action s'insère dans la liste des éléments et ses propriétés sont affichées dans les onglets du panneau de droite.</para>
      <para>L'étiquette de l'action en cours de création ou de modification (uniquement celle-ci) est apposée au nom de l'application sur la barre titre.</para>
      <figure id="cact-FIG-tab-action">
        <title>Propriétés par défaut d'une nouvelle action</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-action-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Affiche les propriétés par défaut d'une action nouvellement créée.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <para>
        <!-- i18n: "Items list" is a UI label -->
        In the <guilabel>Items list</guilabel>, the new action is
        displayed in italic characters.
      </para>
      <para>La graphie italique est utilisée pour rappeler que l'élément n'a pas été enregistré.</para>
      <para>
        As another reminder that there is some pending modifications,
        an asterisk (« <literal>*</literal> »)
        comes to prefix the application name in the title bar. 
      </para>
      <formalpara>
        <title>Qualification de la nouvelle action</title>
        <para>Cela consiste essentiellement à choisir quel sera l'intitulé de l'action dans le menu contextuel du gestionnaire de fichiers.</para>
      </formalpara>
      <itemizedlist>
        <listitem>
          <para>
            <!-- i18n: "My first action" is a user entry -->
            Enter <userinput>My first action</userinput>
            <!-- i18n: "Context label" is a UI label -->
            in the <guilabel>Context label</guilabel> entry box.
          </para>
          <para>
            <!-- i18n: "Context label" is a UI label -->
            The <guilabel>Context label</guilabel> entry box contains
            the label of the action as you want it to be displayed in
            the file manager context menu.
          </para>
         <para>
            The label is a mandatory property of your action. If it
            happens to be empty, then your action will be considered as
            invalid by <productname>Caja-Actions</productname>: it will be displayed in red in
            <!-- i18n: "Items list" is a UI label -->
            <guilabel>Items list</guilabel> and will never be candidate
            to be displayed in the file manager context menus.
          </para>
        </listitem>
        <listitem>
          <para>
            Enter <userinput>This will execute an action with some parameters</userinput>
            <!-- i18n: "Tooltip" is a UI label -->
            in the <guilabel>Tooltip</guilabel> entry box.
          </para>
          <para>
            <!-- i18n: "Tooltip" is a UI label -->
            The <guilabel>Tooltip</guilabel> entry box contains the text
            you want to be displayed as a short help to your action.
          </para>
        </listitem>
        <listitem>
          <para>
            Select <inlinegraphic fileref="figures/stock-icon-about.png"/> 
            <!-- i18n: "Icon" is a UI label -->
            in the <guilabel>Icon</guilabel> drop-down list.
          </para>
          <para>
            <!-- i18n: "Icon" is a UI label -->
            The <guilabel>Icon</guilabel> selection defines the icon
            which will be associated with your action in file manager
            context menus and in the toolbar.
          </para>
          <para>Il y a deux manières de choisir l'icône associée à l'action :</para>
          <itemizedlist>
            <listitem>
              <para>
                <!-- i18n: "Icon" is a UI label -->
                Click on the <guilabel>Icon</guilabel> drop-down list
                to select an icon.
              </para>
            </listitem>
            <listitem>
              <para>
                Click on <guibutton>Browse</guibutton> to search 
                for an image in the filesystem.
              </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </itemizedlist>
      <formalpara>
        <title>Définition de la commande à exécuter</title>
        <para>Quand vous sélectionnez l'action dans le menu contextuel du gestionnaire de fichiers, cette commande est exécutée avec les paramètres de votre choix.</para>
      </formalpara>
      <para>
        <!-- i18n: "Command" is a UI label -->
        Click on the <guilabel>Command</guilabel> tab to show the page
        which will permit you to enter the command.
      </para>
      <figure id="cact-FIG-tab-command">
        <title>Onglet Commande</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-command-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Affiche l'onglet Commande. Cet onglet renferme le nom du profil, la commande à exécuter suivie de ses paramètres et la configuration du répertoire de travail de départ.</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <itemizedlist>
        <listitem>
          <para>
            Enter <userinput>matedialog</userinput> in the
            <!-- i18n: "Path" is a UI label -->
            <guilabel>Path</guilabel> entry box.
          </para>
          <para>
            <!-- i18n: "Path" is a UI label -->
            The <guilabel>Path</guilabel> entry box defines the command
            which will be executed when you will select your action in
            the file manager context menu.
          </para>
          <para>Il y a deux façons de définir la commande à exécuter :</para>
          <itemizedlist>
            <listitem>
              <para>
                <!-- i18n: "Path" is a UI label -->
                Enter it in the <guilabel>Path</guilabel> entry box.
              </para>
            </listitem>
            <listitem>
              <para>
                Click on <guibutton>Browse</guibutton> to select
                the executable file on the filesystem.
              </para>
            </listitem>
          </itemizedlist>
          <para>
            If the command you enter does not have an absolute path,
            then it will be searched for in the <envar>PATH</envar>
            variable at execution time.
          </para>
        </listitem>
        <listitem>
          <para>
            <!-- i18n: only "selected item(s)" is translatable -->
            Enter <userinput>--info --text='%c selected item(s): %U'</userinput>
            <!-- i18n: "Parameters" is a UI label -->
            in the <guilabel>Parameters</guilabel>
            entry box.
          </para>
          <para>
            <!-- i18n: "Parameters" is a UI label -->
            The <guilabel>Parameters</guilabel> contains the arguments
            which will be passed to your command when it will be executed.
            These arguments may embed parameters which will be expanded
            at runtime.
          </para>
          <para>
            <!-- i18n: "Path" and "Parameters" are UI labels -->
            If both <guilabel>Path</guilabel> and <guilabel>Parameters</guilabel>
            are empty, then this action will be considered as invalid:
            <!-- i18n: "Items list" is a UI label -->
            it will be displayed in red in <guilabel>Items list</guilabel>
            and will never be candidate to be displayed in the file
            manager context menus.
          </para>
        </listitem>
      </itemizedlist>
      <formalpara>
        <title>Enregistrement</title>
        <para>To save all pending modifications, choose <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut><guimenu>File</guimenu><guisubmenu>Save</guisubmenu></menuchoice>.</para>
      </formalpara>
      <para>
        <productname>Caja</productname> automatically takes into account your new action,
        and displays it in its context menu.
      </para>
      <figure id="cact-FIG-start-caja-context">
        <title>Your first action in the <productname>Caja</productname> context menu</title>
        <screenshot>
          <mediaobject>
            <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>
        Cliking of the item in the <productname>Caja</productname> context menu activates it,
        and executes the corresponding command.
      </para>
      <figure id="cact-FIG-start-matedialog">
        <title>Le résultat de l'exécution de « Ma première action »</title>
        <screenshot>
          <mediaobject>
            <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>
