<?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="fr">

  <!-- 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><copyright><year>2009.</year><holder>Jérôme Guelfucci (jeromeg@xfce.org)</holder></copyright>

    <legalnotice id="legalnotice">
      <para>Vous pouvez copier, distribuer et/ou modifier ce document sous les termes de la licences GNU Free Documentation, dans sa version 1.1 ou tout autre version postérieure publiée par la Free Software Foundation; sans 'Invariant Sections', sans 'Front-Cover Texts' et sans 'Back-Cover Texts'. The texte complet de la license est fourni par 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>Ce manuel décrit la version @PACKAGE_VERSION@ de Xfce4 Screenshooter.</releaseinfo>
  </articleinfo>

  <sect1 id="intro">
    <title>Introduction à 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>Une extension pour le tableau de bord de Xfce est aussi disponible.</para>

  </sect1>

  <sect1 id="using-the-application">
    <title>Utilisation de l'application</title>

    <sect2 id="user-interface">
      <title>Via l'interface graphique</title>

      <para>Pour lancer l'application, utilisez le lanceur "Capture d'écran", dans la catégorie "Accessoires" du menu principal de Xfce.</para>

      <para>Cette fenêtre apparaîtra alors :</para>

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

          <textobject>
            <phrase>La fenêtre de Xfce4 Screenshooter</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="region-to-capture">
        <title>Zone à capturer</title>

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

        <itemizedlist>
          <listitem>"L'écran tout entier" prend une capture de l'écran tel que vous le voyez, dans sa totalité.</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>Délai avant la capture</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>Après la capture</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>Action</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 peut aussi sauvegarder la capture d'écran dans n'importe quel système de fichiers virtuel pris en charge par GVfs, comme FTP, SAMBA, SFTP, machines à distance accessibles via SSH... Il suffit de connecter ces systèmes de fichiers distants à l'aide de <emphasis>gvfs-connect</emphasis> ou de <ulink type="http" url="http://www.uvena.de/gigolo/">Gigolo</ulink>, puis ils seront disponible dans la colonne de gauche de la fenêtre de suavegarde.</para>
        </sect5>

        <sect5 id="copy-to-clipboard">
          <title>Copier dans le presse papier</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>Ouvrir avec</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>Héberger sur ZimageZ</title>
          
          <para>L'option <emphasis>"Héberger sur ZimageZ"</emphasis> permet d'héberger votre capture d'écran sur ce service en ligne gratuit d'hébergement d'images, ce qui permet de la partager facilement avec d'autres personnes. ZimageZ génère automatiquement une grande et une petite miniature de votre capture d'écran, qui peuvent être utilisées pour créer des miniatures qui pointent sur l'image en taill réelle.</para>

          <para>Après avoir appuyé sur le bouton <emphasis>"OK"</emphasis>, cette fenêtre s'affichera :</para>

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

              <textobject>
                <phrase>La fenêtre pour héberger une capture d'écran sur ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

          <para>Si vous n'avez pas pas de nom d'utilisateur ZimageZ, il vous faudra en créer un sur le <ulink type="http" url="http://www.zimagez.com"> site Internet de ZimageZ</ulink>. Plusieurs langues sont disponibles sur ce site, vous pouvez en changer en utilisant le menu en haut à droite. Vous devez remplir tous les champs de cette fenêtre. Une fois que vous avez validé, la mise en ligne commencera.</para>
          
          <para>La fenêtre ci-dessous vous donne les liens vers la capture d'écran en taille réelle, la grande et la petite miniature, ainsi que des exemples de code HTML et BBcode pour construire une miniature qui pointe vers la capture d'écran taille réelle :</para>

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

              <textobject>
                <phrase>La fenêtre qui donne les liens vers votre capture d'écran sur ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

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

    <sect2 id="command-line">
      <title>Via la ligne de commande</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>Les options en ligne de commande</title>

        <sect4 id="w-option">
          <title>L'option -w</title>

          <para>L'option <emphasis>-w</emphasis> permet de prendre une capture d'écran de la fenêtre active.</para>
        </sect4>

        <sect4 id="f-option">
          <title>L'option -f</title>

          <para>L'option <emphasis>-f</emphasis> permet de prendre une capture d'écran de l'écran tout entier.</para>
        </sect4>

        <sect4 id="r-option">
          <title>L'option -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>L'option -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>L'option -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>L'option -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>L'option -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>Ajout de l'extension</title>

      <para>Pour ajouter l'extension au tableau de bord, cliquez droit sur le tableau de bord et sélectionnez <emphasis>"Ajouter un élément"</emphasis>. Dans la fenêtre qui apparaît, choisissez d'ajouter l'extension nommée <emphasis>"Capture d'écran"</emphasis>. </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>Utilisation</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>
