<?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>Línea de comandos</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>Para ver las opciones de línea de comandos disponibles, escriba:</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>La primera ejecución</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>Barra de menú.</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>Hay atajos disponibles para algunos comandos:</para>
            <variablelist>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>N</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Crear una acción nueva.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>S</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Guardar las acciones modificadas y los menús.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>Q</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Salir de la aplicación.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>X</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Cortar la selección actual, dejándola en el portapapeles.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>C</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Copiar la selección al portapapeles.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Insertar el contenido del portapapeles antes del elemento actual.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Mayús</keycap>
                      <keycap>Ctrl</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Insertar el contenido del portapapeles como subelemento(s) del elemento actual</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Eliminar</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Eliminar la selección actual.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F5</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Recargar las acciones y los menús.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F1</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Mostrar la ayuda.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Barra de herramientas.</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>Lista de elementos.</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>Los elementos se puede clasificar alfabéticamente de manera ascendente o descendente, o no clasificarse, organizándolos y administrándolos directamente el usuario.</para>
            <para>Los elementos no válidos se muestran en color rojo.</para>
            <para>Los elementos modificados se muestran en caracteres en cursiva.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Ordenar botones</term>
          <listitem>
            <para>Tres botones le permiten conmutar entre de modos de ordenación.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Pestañas de propiedades.</term>
          <listitem>
            <para>La parte derecha de la ventana principal mostrará todo lo necesario para definir cómo, cuándo y dónde se mostrarán las acciones y los menús.</para>
            <variablelist>
              <varlistentry>
                <term>Acción/Menú</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>Comando</term>
                <listitem>
                  <para>Especifique qué comando quiere ejecutar, y qué parámetros quiere pasarle.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Ejecución</term>
                <listitem>
                  <para>Especifique como quiere ejecutar el comando.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Nombres 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>Tipos 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>Carpetas</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>Esquemas</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>Prestaciones</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>Entorno</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>Propiedades</term>
                <listitem>
                  <para>Mostrar las propiedades del elemento.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Barra de estado.</term>
          <listitem>
            <para>La barra de estado muestra alguna información del estado actual de la fila seleccionada actualmente en la lista de elementos.</para>
            <para>Cuando no hay información relevante para mostrar, la barra de estado muestra la cuenta de menús, acciones y perfiles cargados.</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>Crear su primera acción</title>
      <para>En este ejemplo, se va a mostrar una acción que muestre alguna información sobre la selección actual.</para>
      <formalpara>
        <title>Comprobando los prerrequisitos</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>Debe comprobar que este programa esté instalado en su sistema, por ejemplo escribiendo en una terminal el siguiente comando:</para>
      <para>
        <command>
          <filename>matedialog</filename>
        </command>
      </para>
      <para>
        then press <keycap>Return</keycap>.
      </para>
      <formalpara>
        <title>Crear la acción</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>Se inserta una acción nueva en la lista de elementos y sus propiedades se muestran en las pestañas del panel derecho.</para>
      <para>La etiqueta de la acción editada actualmente (ésta misma) se añade al nombre de la aplicación en la barra de título.</para>
      <figure id="cact-FIG-tab-action">
        <title>Propiedades predeterminadas de una acción nueva</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-action-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Muestra las propiedades predeterminadas de una acción nueva.</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>Las cursivas se utilizan como recordatorio de que el elemento aún no se ha guardado.</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>Calificar su acción nueva</title>
        <para>Simplemente consiste en elegir cómo su acción se mostrará en el menú contextual del gestor de archivos.</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>Tiene dos formas de elegir el icono asociado a su acción:</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>Especificar el comando que ejecutar</title>
        <para>Cuando se seleccione su acción en el menú contextual del gestor de archivos, este comando se ejecutará con los argumentos de su elección.</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>Pestaña «Comando»</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-command-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Muestra la pestaña «Comando». Esta pestaña contiene el nombre del perfil, el comando que se ejecutará con sus argumentos y la configuración de la carpeta de trabajo inicial.</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>Tiene dos formas de definir el comando que ejecutar:</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>Guardado</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>El resultado de la ejecución de su primera acción</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>
