<?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>Befehlszeile</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>Um die verfügbaren Befehlszeilenoptionen anzuzeigen, rufen Sie folgendes Argument auf:</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>Der erste Start</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>Menüleiste.</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>Für einige Befehle sind Schnellzugriffe verfügbar:</para>
            <variablelist>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>N</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Eine neue Aktion hinzufügen.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>S</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Geänderte Aktionen und Menüs speichern</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>Q</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Die Anwendung beenden.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>X</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Die aktuelle Auswahl ausschneiden, jedoch in der Zwischenablage behalten.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>C</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Die aktuelle Auswahl in die Zwischenablage kopieren.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Strg</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Den Inhalt der Zwischenablage vor der aktuellen Position einfügen.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Umschalttaste</keycap>
                      <keycap>Strg</keycap>
                      <keycap>V</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Den Inhalt der Zwischenablage als Unterelement(e) des aktuellen Objekts einfügen.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>Entf</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Die momentane Auswahl löschen.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F5</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Aktionen und Menüs neu laden.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>
                    <keycombo>
                      <keycap>F1</keycap>
                    </keycombo>
                </term>
                <listitem>
                  <para>Hilfe anzeigen.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Werkzeugleiste.</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>Objektliste.</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>Objekte können in alphabetischer oder umgekehrter alphabetischer Reihenfolge sortiert werden. Eine unsortierte Anzeige ist ebenfalls möglich, so dass der Benutzer die Objekte direkt selbts sortieren und verwalten kann.</para>
            <para>Ungültige Einträge werden in roter Farbe dargestellt.</para>
            <para>Geänderte Objekte werden in kursiver Schrift dargestellt.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Sortierknöpfe</term>
          <listitem>
            <para>Drei Knöpfe ermöglichen Ihnen das Umschalten zwischen den Sortierungsmodi.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Reiter für Eigenschaften.</term>
          <listitem>
            <para>Im rechten Teil des Hauptfensters wird alles angezeigt, was zum Definieren benötigt wird, wie, wann und wo Menüs angezeigt werden sollen.</para>
            <variablelist>
              <varlistentry>
                <term>Aktion/Menü</term>
                <listitem>
                  <para>
                    Define in which <productname>Caja</productname> menus the item should
                    appear, and how it will be displayed.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Befehl</term>
                <listitem>
                  <para>Legen Sie fest, welcher Befehl ausgeführt wird und welche Parameter übergeben werden sollen.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Ausführung</term>
                <listitem>
                  <para>Geben Sie an, wie der Befehl ausgeführt werden soll.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Basisnamen</term>
                <listitem>
                  <para>
                    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>MIME-Typen</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>Ordner</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>Schemata</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>Fähigkeiten</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>Umgebung</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>Eigenschaften</term>
                <listitem>
                  <para>Eigenschaften eines Objekts anzeigen.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Statuszeile.</term>
          <listitem>
            <para>Die Statuszeile zeigt einige Statusinformationen über die aktuell ausgewählte Zeile in der Objektliste an.</para>
            <para>Wenn keine relevanten Informationen zur Anzeige vorhanden sind, dann zeigt die Statuszeile die Anzahl der geladenen Menüs, Aktionen und Profile an.</para>
            <para>
              <!-- 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>Erstellen Ihrer ersten Aktion</title>
      <para>In diesem Beispiel erstellen wir eine Aktion, die einige nützliche Informationen über die aktuelle Auswahl zur Verfügung stellt.</para>
      <formalpara>
        <title>Überprüfen der Voraussetzungen</title>
        <para>
          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>Sie sollten sicherstellen, dass dieses Programm auf Ihrem System installiert ist, indem Sie beispielsweise folgenden Befehl in einem Terminal aufrufen:</para>
      <para>
        <command>
          <filename>matedialog</filename>
        </command>
      </para>
      <para>
        then press <keycap>Return</keycap>.
      </para>
      <formalpara>
        <title>Erstellen der Aktion</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>Eine neue Aktion wird in die Objektliste eingefügt und deren Eigenschaften werden in den Reitern im rechten Teilfenster angezeigt.</para>
      <para>Die Bezeichnung der aktuell ausgewählten Aktion (dieses) wird zum Anwendungsnamen in der Titelleiste hinzugefügt.</para>
      <figure id="cact-FIG-tab-action">
        <title>Vorgegebenen Eigenschaften einer neuen Aktion</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-action-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Zeigt die vorgegebenen Eigenschaften einer neu erstellten Aktion.</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>Kursivschrift wird verwendet, um den Benutzer daran zu erinnern, dass das Objekt noch nicht gespeichert wurde.</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>Charakterisieren Ihrer neuen Aktion</title>
        <para>Im Wesentlichen geht es hierbei darum, wie Ihre Aktion in den Kontextmenüs des Dateimanagers angezeigt wird.</para>
      </formalpara>
      <itemizedlist>
        <listitem>
          <para>
            <!-- 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>Sie haben zwei Möglichkeiten, Ihrer Aktion ein Symbol zuzuordnen:</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>Angeben des auszuführenden Befehls</title>
        <para>Wenn Sie Ihre Aktion im Kontextmenü des Dateimanagers auswählen, wird dieser Befehl mit den von Ihnen angegebenen Argumenten ausgeführt.</para>
      </formalpara>
      <para>
        <!-- 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>Reiter »Befehl«</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/cact-command-tab.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Zeigt den Reiter »Befehl«. Dieser Reiter enthält den Namen des Profils, den auszuführenden Befehl einschließlich dessen Parameter sowie die Konfiguration des anfänglichen Arbeitsordners.</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>Es gibt zwei Möglichkeiten, den auszuführenden Befehl festzulegen:</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>Speichern</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>Das Ergebnis der Ausführung Ihrer ersten Aktion</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>
