<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY date "February 2009">
<!ENTITY version "@PACKAGE_VERSION@">
<!ENTITY application "@PACKAGE_NAME@">
]>
<article id="xfce4-screenshooter" lang="ast">

  <!-- Header -->
  <articleinfo>
    <title>Xfce4 Screenshooter</title>

    <pubdate>&date;</pubdate>

    <copyright>
      <year>2008</year>
      <year>2009</year>
      <holder>Jérôme Guelfucci</holder>
    </copyright>

    <copyright>
      <year>2009</year>
      <holder>Sam Swift</holder>
    </copyright>

    <legalnotice id="legalnotice">
      <para>Concédese'l permisu pa copiar, distribuyir y/o camudar ésti documentu baxo los términos de la GNU Free Documentation License, Versión 1.1 o cualesquier versión postrera espublizada pola Free Software Foundation, ensin Seiciones Invariantes, ensin testos de cubierta delantera, y ensin testos de cubierta trasera. El testu completu de la llicencia ta disponible dende la <ulink type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>.</para>
    </legalnotice>

    <authorgroup>
      <author>
        <firstname>Jérôme</firstname>
        <surname>Guelfucci</surname>
        <affiliation>
          <address><email>jeromeg@xfce.org</email></address>
        </affiliation>
      </author>
      <author>
        <firstname>Sam</firstname>
        <surname>Swift</surname>
        <affiliation>
          <address><email>renmush@gmail.com</email></address>
        </affiliation>
      </author>
    </authorgroup>

    <releaseinfo>Ésti manual describe la versión @PACKAGE_VERSION@ de Xfce4 Screenshooter.</releaseinfo>
  </articleinfo>

  <sect1 id="intro">
    <title>Introducción a Xfce4 Screenshooter</title>

    <para>
      This application allows you to capture the entire screen, the
      active window or a selected region. You can set the delay that
      elapses before the screenshot is taken and the action to be
      performed afterwards: save the screenshot to a PNG file, copy it
      to the clipboard, open it using another application, or host it on
      <ulink type="http" url="http://www.zimagez.com">ZimageZ</ulink>,
      a free online image hosting service.
    </para>

    <para>También ta disponible un complementu pal panel de XFCE.</para>

  </sect1>

  <sect1 id="using-the-application">
    <title>Usando l'aplicación</title>

    <sect2 id="user-interface">
      <title>A traviés de la interface d'usuariu</title>

      <para>Pa entamar l'aplicación, use l'elementu "Captura de pantalla" de la categoría "Accesorios" del menú principal de Xfce.</para>

      <para>Amosaráse ésta pantalla:</para>

      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/xfce4-screenshooter-dialog1.png" format="PNG"/>
          </imageobject>

          <textobject>
            <phrase>La ventana de Xfce4 Screenshooter</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="region-to-capture">
        <title>Rexón a capturar</title>

        <para>
          The <emphasis>"Region to capture"</emphasis> section allows
          you to set what the screenshot will be taken of:
        </para>

        <itemizedlist>
          <listitem>"Toda la pantalla" toma una captura de toda pantalla como la vemos.</listitem>
          <listitem>
            "Active window" takes a screenshot of the active window.
            This will be the one that was active before this dialog
            appeared, or if you set a delay, the one that is active
            after the delay.
          </listitem>
          <listitem>
            "Select a region" allows you to select a region to be
            captured by clicking and dragging a rectangle over the area
            of screen that you wish to capture, before releasing the
            mouse button.
          </listitem>
        </itemizedlist>
      </sect4>

      <sect4 id="include-pointer">
        <title>Capturing the pointer</title>

        <para>
          The <emphasis>"Capture the mouse pointer"</emphasis>
          option allows you to select whether or not the screenshot will
          include the mouse pointer.
        </para>
      </sect4>

      <sect4 id="delay">
        <title>Allanciu enantes de capturar</title>

        <para>
          The <emphasis>"Delay before capturing"</emphasis>
          section allows you to set the delay that will elapse between
          pressing the <emphasis>"OK"</emphasis> button and screenshot
          being taken. This delay will allow you to open menus or to
          perform whatever action you require to see displayed in the
          screenshot.
        </para>
      </sect4>
    </sect2>
    
    <sect3 id="after-capturing">
      <title>Dempués de capturar</title>
      
      <para>
        After pressing the <emphasis>"OK"</emphasis> button a second
        window will be displayed:
      </para>

      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/xfce4-screenshooter-dialog2.png" format="PNG"/>
          </imageobject>

          <textobject>
            <phrase>The window of Xfce4 Screenshooter after taking a
            screenshot</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="preview">
        <title>Preview</title> 

        <para>
          The <emphasis>"Preview"</emphasis> section displays a
          thumbnail of the screenshot.
        </para>
      </sect4>

      <sect4 id="action">
        <title>Aición</title>

        <para>
          The <emphasis>"Action"</emphasis> section allows you to choose
          what should be performed on the screenshot.
        </para>

        <sect5 id="save">
          <title>Save</title>

          <para>
            The <emphasis>"Save"</emphasis> option will save the
            screenshot to a PNG file. A save dialog will be
            displayed. You will be able to set the save location, and
            the name of the file.
          </para>

          <para>Xfce4 Screenshooter tamién ye quien a guardar la captura de pantalla a cualesquier sistema de ficheros remotu sofitáu por GVfs, talos como FTP, SAMBA, SFTP, ordenadores remotos accesibles a traviés de SSH ... Namái tienes de coneutar el sistema de ficheros remotu usando <emphasis>gvfs-connect</emphasis> o <ulink type="http" url="http://www.uvena.de/gigolo/">Gigoloulink&gt; y tar</ulink></para>
        </sect5>

        <sect5 id="copy-to-clipboard">
          <title>Copiar al cartafueyu</title>

          <para>
            The <emphasis>"Copy to the clipboard"</emphasis> option
            allows you to paste the screenshot in another application,
            such as a word processor. This option is only available when
            a clipboard manager is running.
          </para>
        </sect5>

        <sect5 id="open-with">
          <title>Abrir con</title>

          <para>
            The <emphasis>"Open with"</emphasis> option saves the
            screenshot to the system's temporary directory and opens it
            with the application chosen from the drop-down list.
            Applications which support images are automatically detected
            and added to the drop-down list.
          </para>
        </sect5>

        <sect5 id="zimagez">
          <title>Agospiar en ZimageZ</title>
          
          <para>La opción<emphasis>"Agospiar en ZimageZ"emphasis&gt; perm</emphasis></para>

          <para>Dempués de calcar el botón<emphasis>"Aceutar"</emphasis> amosaráse ésti cuadru de diálogu:</para>

          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="images/xfce4-screenshooter-zimagez-login-dialog.png" format="PNG"/>
              </imageobject>

              <textobject>
                <phrase>El cuadru de diálogu p'agospiar una captura de pantalla en ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

          <para>Si nun tien un nome d'usuariu en ZimageZ, tendrá que criar ún nel <ulink type="http" url="http://www.zimagez.com"> sitiu web de ZimageZ</ulink>. Delles llingües tán disponibles nesti sitiu web, vusté puede camudales nel menú de la drecha. Vusté tien de enllenar tolos campos d'ésti cuadru de diálogu. Una vegada que fai clic nel botón<emphasis>"Aceutar"emphasis&gt; aniciar</emphasis></para>
          
          <para>Darréu, el cuadru de diálogu apurrirá-y los enllaces a la captura de pantalla a tamañu completu, a la miniatura grande, a les miniatures pequeñes, asina como exemplos de HTML y BBCode pa criar una imaxe en miniatura qu'apunta a la captura de pantalla a tamañu completu:</para>

          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="images/xfce4-screenshooter-zimagez-result-dialog.png" format="PNG"/>
              </imageobject>

              <textobject>
                <phrase>El cuadru de diálogu apúrre-y los enllaces a la so captura en ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

        </sect5>
      </sect4>
    </sect3>

    <sect2 id="command-line">
      <title> A traviés de llinia de comandos</title>

      <para>
        Command line options allow you to take screenshots quickly. They
        also allow you to configure the Print Screen key on the upper
        right of most keyboards so that it takes screenshots. To do so,
        configure the key-bindings of your desktop environment so that
        it launches xfce4-screenshooter with one or several of the
        following options when the Prt Scrn key is pressed.
      </para>

      <sect3 id="options">
        <title>Opciones de llinia de comandos</title>

        <sect4 id="w-option">
          <title>La opción -w</title>

          <para>La opción <emphasis>-wemphasis&gt; perm</emphasis></para>
        </sect4>

        <sect4 id="f-option">
          <title>La opción -f</title>

          <para>La opción <emphasis>-femphasis&gt; perm</emphasis></para>
        </sect4>

        <sect4 id="r-option">
          <title>La opción -r</title>

          <para>
            The <emphasis>-r</emphasis> option allows you to select a
            region to be captured by clicking and dragging a rectangle
            over the area of screen that you wish to capture, before
            releasing the mouse button.
          </para>
        </sect4>

        <sect4 id="d-option">
          <title>La opción -d</title>

          <para>
            The <emphasis>-d</emphasis> option followed by a positive
            integer allows you to set the delay before taking the
            screenshot when the <emphasis>-w</emphasis>, the
            <emphasis>-f</emphasis> or the <emphasis>-r</emphasis>
            option is given.
          </para>
        </sect4>

        <sect4 id="s-option">
          <title>La opción -s</title>

          <para>
            The <emphasis>-s</emphasis> option followed by the path to
            an existing folder allows you to set where the screenshots
            are saved. This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or
            the <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>

        <sect4 id="o-option">
          <title>La opción -o</title>

          <para>
            If the <emphasis>-o</emphasis> option is given, followed by
            an application name, the screenshot will be saved to the
            system's temporary directory and opened with the application
            whose name is to be given after <emphasis>-o</emphasis>.
            This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or the
            <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>

        <sect4 id="u-option">
          <title>La opción -u</title>

          <para>
            If the <emphasis>-u</emphasis> option is given, the screenshot
            will be hosted on ZimageZ. See above for more details.
            This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or the
            <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>
      </sect3>
    </sect2>
  </sect1>

  <sect1 id="panel-plugin">
    <title>Using the Xfce panel plugin</title>

    <sect2 id="add">
      <title>Amestando'l complementu</title>

      <para>P'amestar el complementu pal panel, fai clic drechu nel panel y escueyi <emphasis>"Amestar nuevu elementu"</emphasis>. Escueyi'l complementu denomáu <emphasis>"Captura de pantalla"</emphasis>, y amiéstalu.</para>
    </sect2>

    <sect2 id="set">
      <title>Configuring the plugin</title>

      <para>
        You can configure how screenshots are taken by right clicking on
        the plugin and selecting <emphasis>"Properties"</emphasis>. A
        preferences dialog similar to the dialog of the main application
        will appear. Please have a look above for the different
        preferences.
      </para>
    </sect2>

    <sect2 id="use">
      <title>Usando'l complementu</title>

      <para>
        To take a screenshot, just click on the plugin. You can use the
        scroll wheel on the plugin button to switch between the different
        regions to be captured.
      </para>
    </sect2>

  </sect1>

</article>
