ROX-Filer/src/Docs/Manual-fr.xml

   1 <?xml version="1.0" standalone="no"?>
   2 <?xml-stylesheet href="to_html.xsl" type="text/xml"?>
   3 <!-- vim: set sw=1 sts=1 : -->
   4 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   5 "/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd">
   6
   7 <book lang="fr">
   8  <bookinfo>
   9   <title>
  10    ROX-Filer 2.1.1 - Manuel de l'utilisateur
  11    <ulink url="http://rox.sourceforge.net"/>
  12   </title>
  13
  14   <authorgroup>
  15    <author>
  16         <firstname>Thomas</firstname>
  17         <surname>Leonard</surname>
  18         <affiliation>
  19          <address>
  20           <email>tal197 at users.sourceforge.net</email>
  21          </address>
  22     </affiliation>
  23    </author>
  24
  25    <othercredit role="translator">
  26         <firstname>Arnaud</firstname>
  27         <surname>Calvo</surname>
  28         <contrib>Traduction française</contrib>
  29     <affiliation>
  30          <address>
  31           <email>arnaud at calvo-france.com</email>
  32          </address>
  33     </affiliation>
  34    </othercredit>
  35   </authorgroup>
  36
  37   <copyright>
  38    <year>2003</year>
  39    <holder>Thomas Leonard</holder>
  40   </copyright>
  41
  42   <legalnotice>
  43    <title>Conditions</title>
  44    <para>
  45         Ce programme est un logiciel libre, vous pouvez le redistribuer et/ou le modifier
  46         suivant les termes de la 'GNU General Public License', publiée par
  47         la 'Free Software Foundation', soit la version 2, soit (à votre convenance) une
  48         version ultérieure.
  49         Ce programme est distribué en espérant qu'il sera utile, mais SANS AUCUNE GARANTIE.
  50         Consultez la 'GNU General Public License' pour plus de détails.
  51         Vous devez avoir reçu une copie de la 'GNU General Public License' avec ce programme.
  52         Si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  53    </para>
  54    <para>
  55         NDT : Vous pouvez consulter une traduction non officielle de la licence 'GNU General
  56         Public License' à cette adresse : <ulink url="http://www.april.org/gnu/gpl_french.html"/>.
  57    </para>
  58   </legalnotice>
  59
  60   <abstract>
  61    <para>
  62         Note du traducteur :
  63         Je ne suis pas programmeur, les paragraphes 'Appliquettes pour les panneaux' et
  64         'Structures de données' ont été traduits par Laurent Moussault <email>laurent.moussault@9online.fr</email>.
  65    </para>
  66    <para>
  67         <application>ROX-Filer</application> est un gestionnaire de fichiers simple et pratique pour X11.
  68         Son interface utilisateur est basée sur le gestionnaire de fichiers de RISC OS et ses caractéristiques
  69         sont similaires ("dossiers-applications" et ouverture/enregistrement de fichiers par drag-and-drop). Le
  70         filer peut aussi jouer le rôle d'un punaiseur, vous permettant alors d'accrocher sur votre bureau les
  71         fichiers/répertoires/applications que vous utilisez fréquemment.
  72    </para>
  73   </abstract>
  74  </bookinfo>
  75
  76  <chapter id="intro">
  77
  78   <title>Introduction</title>
  79   <para>
  80    <application>ROX-Filer</application> est un gestionnaire de fichiers simple et pratique pour X11 &mdash;
  81    l'interface graphique à base de fenêtres très utilisé sur les systèmes d'exploitation Unix et dérivés.
  82    C'est aussi le coeur du ROX Desktop <citation>ROX</citation>. Beaucoup de fonctionnalités du filer ont
  83    été inspirées par RISC OS <citation>RISC OS</citation>. 'ROX' est un acronyme de 'RISC OS&ndash;On&ndash;X'.
  84   </para>
  85
  86   <sect1>
  87    <title>Fonctionnalités</title>
  88    <para>
  89         <variablelist>
  90          <varlistentry>
  91           <term>XDND</term>
  92           <listitem>
  93            <para>
  94                 Un protocole pour le drag-and-drop utilisé, par exemple, par le desktop
  95                 GNOME <citation>GNOME</citation>. Cela permet à des données d'être chargées
  96                 dans une application par simple drag-and-drop depuis une fenêtre du filer.
  97                 Les spécifications complètes sont données en <citation>DND</citation>.
  98            </para>
  99           </listitem>
 100          </varlistentry>
 101
 102          <varlistentry>
 103           <term>XDS</term>
 104           <listitem>
 105            <para>
 106                 Une extension de XDND qui permet aux applications d'enregistrer des données
 107                 par drag-and-drop vers une fenêtre du filer.
 108                 Les spécifications complètes sont données en <citation>XDS</citation>.
 109            </para>
 110           </listitem>
 111          </varlistentry>
 112
 113          <varlistentry>
 114           <term>Choices</term>
 115           <listitem>
 116            <para>
 117                 Une façon simple, mais souple, de gérer les préférences des utilisateurs.
 118                 Voir <citation>Choices</citation> pour plus de détails.
 119            </para>
 120           </listitem>
 121          </varlistentry>
 122
 123          <varlistentry>
 124           <term>Dossiers-applications</term>
 125           <listitem>
 126            <para>
 127                 Applications entièrement contenues dans un dossier, pour lesquelles l'installation
 128                 consiste en la simple copie d'un dossier et la désinstallation, en la suppression
 129                 de ce dossier. Une description plus détaillée est fournie plus loin.
 130            </para>
 131           </listitem>
 132          </varlistentry>
 133
 134          <varlistentry>
 135           <term>Imagettes</term>
 136           <listitem>
 137            <para>
 138                 Le filer peut afficher les fichiers images avec une icône représentant le contenu
 139                 de ceux-ci, au lieu d'une icône générique.
 140                 Très utile pour organiser un dossier rempli de photos ! Voir <citation>Imagettes</citation>
 141                 pour plus de détails (l'établissement de normes est en cours).
 142            </para>
 143           </listitem>
 144          </varlistentry>
 145          <varlistentry>
 146           <term>Shared MIME Info Database</term>
 147           <listitem>
 148            <para>
 149                 Avant, chaque gestionnaire de bureau avait son propre système pour gérer les types de fichiers.
 150                 La base de données des types MIME <citation>SharedMIME</citation> propose un standard pour que
 151                 les différents gestionnaires de bureau n'utilisent plus qu'un seul système.
 152            </para>
 153          </listitem>
 154     </varlistentry>
 155
 156 <varlistentry><term>Thèmes (icônes)</term>
 157       <listitem>
 158         <para>
 159         Des collections d'icônes, appelées 'thèmes', peuvent être installées
 160         dans <filename>~/.icons</filename>).
 161         Vous pouvez changer le thème utilisé dans la boîte Options.
 162         Lorsque d'autres 'Gestionnaires de bureaux' utiliseront la même
 163         technologie, les thèmes pourront alors être partagés avec ceux-ci.
 164         </para>
 165        </listitem>
 166 </varlistentry>
 167
 168         <varlistentry>
 169      <term>Support DNotify (Linux seulement)</term>
 170          <listitem>
 171       <para>
 172        Si le filer est utilisé avec un noyau Linux récent (i.e. 2.4.x), il mettra à jour automatiquement
 173            ses fenêtres. Sur d'autres systèmes, les dossiers seront mis à jour dès que le pointeur passera
 174            au-dessus.
 175       </para>
 176      </listitem>
 177     </varlistentry>
 178
 179         </variablelist>
 180    </para>
 181   </sect1>
 182
 183  </chapter>
 184
 185 <chapter id="invoking">
 186  <title>Arguments</title>
 187   <para>
 188    Vous devriez pouvoir démarrer le filer en tapant la commande <userinput>rox</userinput>.
 189    S'il n'est pas encore installé, voyez <xref linkend="compiling"/>.
 190   </para>
 191
 192   <para>
 193    Par défaut, <application>ROX-Filer</application> démarre en affichant le répertoire courant.
 194    Vous pouvez lui spécifier d'ouvrir d'autres dossiers à la place en les passant en arguments :
 195
 196 <screen>$ rox /home /usr /usr/local</screen>
 197
 198 Vous pouvez aussi l'utiliser pour ouvrir des fichiers, comme ceci :
 199
 200 <screen>$ rox README</screen>
 201
 202 Le filer accepte beaucoup d'options ; utilisez <option>-h</option> pour en obtenir la liste.
 203 Toutes les options ont une forme courte et une forme longue (ex : <option>-h</option> et
 204 <option>--help</option>) &mdash; bien que sur certains systèmes vous ne pouvez utiliser que les options
 205 courtes.
 206 </para>
 207 <para>
 208 Notez que si la même version du filer est déjà lancée sur votre machine,
 209 alors, par défaut, elle sera utilisée pour ouvrir les dossiers et la nouvelle
 210 copie s'arrêtera immédiatement.
 211 </para>
 212 <para>
 213 Pour obtenir la liste complète des options, voir <xref linkend="manpage"/>.
 214 </para>
 215
 216 <sect1>
 217         <title><anchor id="run_pin" xreflabel="Pinboard support"/>Punaiseur</title>
 218   <para>
 219
 220 Si vous voulez que le filer gère votre bureau vous utiliserez l'option
 221 <option>--pinboard</option> et fournirez un nom pour le punaiseur, ex :
 222
 223 <screen>$ rox --pinboard=MonPunaiseur</screen>
 224
 225 La configuration du punaiseur est sauvée dans <filename>&lt;Choices&gt;/ROX-Filer/pb_MonPunaiseur</filename>
 226 dès que vous le modifiez (par exemple, en glissant/déposant un fichier
 227 sur votre bureau).
 228 Vous pouvez avoir autant de punaiseurs que vous le souhaitez et basculer
 229 de l'un à l'autre en lançant rox de nouveau, ex :
 230
 231 <screen>$ rox --pinboard=MonAutrePunaiseur</screen>
 232
 233 Pour arrêter la fonction punaiseur, donnez au nom une chaîne vide :
 234
 235 <screen>$ rox --pinboard=</screen>
 236
 237 Allez voir la section <xref linkend="winman"/> si vous avez des problèmes d'affichage avec les icônes.
 238 Le punaiseur peut aussi être activé/désactivé en se plaçant dans le répertoire d'installation de
 239 <filename>ROX-Filer</filename> dans une fenêtre du filer et en choisissant 'Enable pinboard' ou
 240 'Disable pinboard' dans le menu (clic droit).
 241
 242   </para>
 243 </sect1>
 244
 245 <sect1>
 246   <title><anchor id="run_pan" xreflabel="Panel support"/>Panneaux</title>
 247   <para>
 248
 249 Les panneaux fonctionnent exactement de la même façon que les punaiseurs.
 250 Vous pouvez créer un panneau sur n'importe quel côté de l'écran en utilisant
 251 les options <option>--left</option>, <option>--right,</option>, <option>--top</option> et <option>--bottom</option>,
 252 (respectivement pour les non-anglophones 'gauche', 'droite', 'haut' et 'bas'),
 253 en fonction du côté sur lequel vous souhaitez voir apparaître votre panneau.
 254 Sur certains systèmes, vous devrez utiliser l'option courte (une lettre).
 255 Par exemple, pour créer un panneau en bas de votre écran :
 256
 257 <screen>$ rox -b=MonPanneau</screen>
 258
 259 Le panneau devrait être affiché dans une fenêtre sans barre de titre. Si
 260 ça ne fonctionne pas, lisez la section <xref linkend="winman"/> pour avoir quelques idées.
 261 Vous pouvez déposer des fichiers sur les 2 côtés du panneau, ils s'aligneront
 262 sur un côté ou sur l'autre.
 263 Les icônes des panneaux peuvent être repositionnées en les glissant avec le bouton du milieu.
 264 Les changements apportés au panneau sont automatiquement sauvegardés dans <filename>&lt;Choices&gt;/ROX-Filer/pan_MonPanneau</filename>.
 265 Comme pour le punaiseur, vous pouvez basculer entre plusieurs configurations
 266 de panneaux en relançant rox avec un nom de panneau différent.
 267 Spécifiez une chaîne ville pour ôter le panneau.
 268
 269 <screen>$ rox --bottom=MonAutrePanneau
 270 $ rox --bottom=</screen>
 271
 272   </para>
 273 </sect1>
 274
 275 <sect1>
 276  <title><anchor id="winman" xreflabel="window manager notes"/>Notes sur les gestionnaires de fenêtres</title>
 277   <para>
 278
 279           Vous allez peut être avoir à configurer un peu votre gestionnaire de fenêtre
 280           pour que les icônes des punaiseurs et les panneaux s'affichent correctement
 281           (c'est-à-dire sans les bordures et sous les autres fenêtres).
 282           En particulier, vérifiez les options concernant les différentes
 283           "couches" (au-dessus, en dessous, premier, dernier, etc...) et affectez le
 284           punaiseur aux couches les plus basses.
 285   </para>
 286
 287 <sect2><title>Sawfish / sawmill</title>
 288   <para>
 289           Sawfish essaie de deviner si vous utilisez GNOME au démarrage
 290           et désactive certaines fonctions si c'est le cas.
 291          Vous devrez peut-être ajouter la ligne <programlisting>(require 'gnome)</programlisting> à
 292           votre fichier <filename>.sawfishrc</filename> (lisez le manuel sawfish pour plus de détails).
 293   </para>
 294 </sect2>
 295
 296 <sect2><title>IceWM</title>
 297   <para>
 298
 299           Collez ces paramètres de configuration dans <filename>~/.icewm/preferences</filename> :
 300
 301 <programlisting>
 302 # Manage root window (EXPERIMENTAL - normally enabled!)
 303 GrabRootWindow=1 # 0/1
 304 # Bitmask of root window button click to use in window manager
 305 UseRootButtons=3 # [0-255]
 306 # Desktop mouse-button click to show the menu
 307 DesktopWinMenuButton=1 # [0-20]
 308 # Desktop mouse-button click to show the window list
 309 DesktopWinListButton=2 # [0-5]
 310 # Desktop mouse-button click to show the window list menu
 311 DesktopMenuButton=0 # [0-20]
 312 </programlisting>
 313
 314 Et collez ceux-ci dans <filename>~/.icewm/winoptions</filename> :
 315
 316 <programlisting>
 317 # ROX-Filer pinboard and panel
 318 ROX-Filer.icon: folder
 319 ROX-Panel.layer: Dock
 320 ROX-Panel.doNotCover: 1
 321 ROX-Panel.ignoreWinList: 1
 322 ROX-Panel.ignoreTaskBar: 1
 323 ROX-Panel.ignoreQuickSwitch: 1
 324 ROX-Pinboard.layer: Below
 325 ROX-Pinboard.ignoreWinList: 1
 326 ROX-Pinboard.ignoreTaskBar: 1
 327 ROX-Pinboard.ignoreQuickSwitch: 1
 328 ROX-Filer.layer: Normal
 329 </programlisting>
 330
 331 Redémarrez IceWM et le filer pour que les changements prennent effet.
 332
 333   </para>
 334 </sect2>
 335
 336 <sect2>
 337  <title>Window Maker</title>
 338  <procedure>
 339   <step>
 340    <para>
 341         Démarrez le filer comme ceci : <userinput>rox -p=Default</userinput>
 342    </para>
 343   </step>
 344
 345   <step>
 346    <para>
 347         Appuyez sur <keycap>Ctrl</keycap>+<keycap>Esc</keycap>, ou
 348         faites un clic droit sur la barre de titre de n'importe quelle
 349         fenêtre.
 350         Choisissez <guimenuitem>Attributes...</guimenuitem>.
 351    </para>
 352   </step>
 353
 354   <step>
 355    <para>
 356         La fenêtre Attributes Inspector apparaît. Choisissez <guimenuitem>Window Specification</guimenuitem>
 357         dans le menu, en haut (1er choix).
 358    </para>
 359   </step>
 360
 361   <step>
 362    <para>
 363         Cliquez sur le bouton <guibutton>Select window</guibutton>.
 364         Le curseur de la souris s'est transformé en double croix. Sélectionnez
 365         une des icônes du punaiseur de <application>ROX-Filer</application>. Les
 366         boutons radios dans le cadre <guilabel>Window Specification</guilabel>
 367         doivent maintenant être modifiés et afficher <userinput>ROX-Pinboard.ROX-Filer</userinput>
 368         pour le premier élément. Sélectionnez ce bouton radio.
 369    </para>
 370   </step>
 371
 372   <step>
 373    <para>
 374         Dans le menu du haut, revenez à <guimenuitem>Window Attributes</guimenuitem>.
 375         Dans le cadre <guilabel>Attributes</guilabel>, choisissez les caractéristiques
 376         que vous voulez donnez aux icônes du punaiseur ; je vous recommande celles-ci :
 377
 378         <itemizedlist>
 379          <listitem><para>Disable titlebar</para></listitem>
 380          <listitem><para>Disable resizebar</para></listitem>
 381          <listitem><para>Disable close button</para></listitem>
 382          <listitem><para>Disable miniaturize button</para></listitem>
 383          <listitem><para>Keep at bottom (sunken)</para></listitem>
 384          <listitem><para>Omnipresent</para></listitem>
 385         </itemizedlist>
 386
 387    </para>
 388   </step>
 389
 390   <step>
 391    <para>
 392         Toujours dans le menu du haut, choisissez <guimenuitem>Advanced Options</guimenuitem>.
 393         Dans le cadre <guilabel>Advanced</guilabel>, choisissez les options qui vous conviennent ;
 394         je vous recommande les suivantes :
 395
 396         <itemizedlist>
 397          <listitem><para>Do not show in the window list</para></listitem>
 398          <listitem><para>Ignore 'Hide Others'</para></listitem>
 399          <listitem><para>Ignore 'Save Session' (éventuellement)</para></listitem>
 400     </itemizedlist>
 401
 402    </para>
 403   </step>
 404
 405   <step>
 406    <para>
 407         Quand vous aurez fini, cliquez sur <guibutton>Save</guibutton>, et fermez
 408         la fenêtre Attributes Inspector en cliquant sur le bouton <guibutton>X</guibutton>
 409         dans la barre de titre.
 410    </para>
 411   </step>
 412  </procedure>
 413 </sect2>
 414
 415 <sect2>
 416  <title>Autres</title>
 417   <para>
 418           Si rien ne fonctionne, essayez la section "Compatibilité" de la boîte d'options.
 419   </para>
 420 </sect2>
 421 </sect1>
 422
 423 <sect1>
 424         <title>Exécution en tant que root</title>
 425   <para>
 426
 427           Si vous utilisez le filer en tant qu'utilisateur 'root', le filer affiche
 428           un message en haut de chaque fenêtre pour vous le rappeler. L'utilisateur root
 429           a le droit d'accéder à tous les fichiers du systèmes, ainsi que de les modifier,
 430           soyez donc très vigilant quand vous utilisez le filer dans ces conditions.
 431
 432           Normalement, vous devriez vous loguer en utilisateur ordinaire et vous changer
 433           en root que lorsque vous en avez besoin.
 434           Si <command>sudo</command> est installé et proprement configuré sur votre système,
 435           vous pouvez exécutera le filer de cette façon :
 436
 437           <screen>$ sudo rox</screen>
 438
 439           Attention, souvenez-vous que tout ce que vous ferez sur n'importe quel fichier (y
 440           compris les applications que vous exécuterez depuis ces fenêtres) sera effectué
 441           avec les droits de root ! Soyez très prudent !
 442
 443          </para>
 444
 445          <para>
 446           Vous aurez peut-être un message du serveur X window qui vous dira que root (ou d'autres
 447           utilisateurs) ne peut pas se connecter (ndt : "se connecter à X", ce qui veut dire que
 448           l'utilisateur root, par exemple, ne pourra lancer aucune commande qui utiliserait X).
 449           Une lecture des pages man pour <command>xauth</command> et <command>xhost</command> est
 450           donc conseillée, mais ce mécanisme varie selon les systèmes (c'est pourquoi ça n'est pas
 451           implémenté dans le filer !).
 452          </para>
 453
 454 </sect1>
 455 </chapter>
 456
 457 <chapter id="keys" xreflabel="mouse and key bindings">
 458         <title>Boutons de la souris et touches du clavier</title>
 459
 460 <itemizedlist><title>Premier aperçu succinct :</title>
 461
 462   <listitem><para>Faites un clic gauche
 463   <footnote><para>Cette documentation suppose que le bouton&ndash;1 est le bouton gauche, le bouton&ndash;2
 464 est le bouton du milieu et le bouton&ndash;3 est le bouton droit. Ce n'est pas
 465 toujours le cas &mdash; par exemple, dans une configuration pour gaucher.</para></footnote>
 466 pour ouvrir fichiers et dossiers.</para></listitem>
 467
 468   <listitem><para>
 469                   Faites un clic droit pour obtenir un menu. Clic droit sur un fichier/dossier pour opérer une action sur celui-ci.
 470   </para></listitem>
 471
 472   <listitem>
 473    <para>
 474     Glissez-déposez des fichiers entre des fenêtres avec le bouton gauche pour les copier,
 475     les déplacer, les lier, etc... (action à choisir dans un menu).
 476         Lier crée un raccourci vers le fichier original.
 477    </para>
 478   </listitem>
 479
 480 </itemizedlist>
 481
 482   <para>
 483           Par défaut, l'affectation des boutons de la souris correspond aux conventions de l'environnement X.
 484           Ce comportement est toutefois hautement configurable &mdash; n'hésitez pas
 485           à essayer les différentes options possibles, dans l'espace de configuration du filer si vous n'aimez pas les options par défaut.
 486           Ces options induisent les comportements suivants :
 487   </para>
 488
 489 <informaltable>
 490 <tgroup cols="2">
 491 <thead><row><entry>Touche ou bouton de la souris</entry><entry>Action</entry></row></thead>
 492
 493 <tbody>
 494
 495  <row>
 496   <entry>Clic gauche</entry>
 497   <entry>
 498    Ouvre le fichier ou le dossier cliqué. Maintenez enfoncé <keycap>Ctrl</keycap> pour
 499    sélectionner les objets au lieu de les ouvrir.
 500    Maintenez enfoncé <keycap>Shift</keycap> pour voir à l'intérieur des dossiers-applications,
 501    pour ouvrir les fichiers avec l'éditeur de texte, pour suivre les liens symboliques ou pour
 502    mieux gérer les points de montage (voir <xref linkend="media"/>).
 503   </entry>
 504  </row>
 505
 506  <row>
 507   <entry>Clic sur le bouton du milieu</entry>
 508   <entry>
 509    Comme le bouton gauche, mais ouvre un dossier dans une nouvelle fenêtre ou ferme la fenêtre
 510    du filer en ouvrant un fichier.
 511   </entry>
 512  </row>
 513
 514  <row>
 515   <entry>Clic droit</entry>
 516   <entry>
 517    Ouvre le menu principal. Maintenez enfoncé <keycap>Ctrl</keycap> en cliquant pour avoir
 518    directement le sous-menu de sélection.
 519    Maintenez enfoncé <keycap>Shift</keycap> pour accéder au menu <guimenu>Envoyer à...</guimenu>
 520    (voir la section <xref linkend="SendTo"/>).
 521   </entry>
 522  </row>
 523
 524 <row>
 525  <entry>Drag and drop d'un objet (bouton gauche)</entry>
 526  <entry>
 527   Affiche un menu vous permettant de choisir différentes actions. Vous pouvez désactiver cette
 528   fonction de menu via une option, ce qui permettra de copier par défaut le(s) fichier(s) dans
 529   la destination (un dossier-application ou une autre fenêtre du filer).
 530   Maintenez enfoncé <keycap>Shift</keycap> pour déplacer le fichier,
 531   <keycap>Control</keycap>+<keycap>Shift</keycap> pour créer un lien symbolique, ou
 532   <keycap>Alt</keycap> pour avoir un menu avec les différentes actions possibles.
 533  </entry>
 534 </row>
 535
 536 <row><entry>Drag and drop d'un objet (bouton du milieu)</entry><entry>
 537             Comme ci-dessus, mais déplace toujours au lieu de copier ou de créer un lien symbolique.
 538                 Il y a une option pour choisir ce comportement ou l'affichage d'un menu.
 539 </entry></row>
 540
 541 <row><entry>'Glissé' avec un bouton, mais pas au-dessus d'un autre objet</entry><entry>
 542                 Sélectionne un groupe d'objets en les entourant avec un bouton de la souris enfoncé.
 543                 Avec le bouton gauche, seuls les fichiers entourés seront sélectionnés.
 544                 Si vous maintenez enfoncé <keycap>Ctrl</keycap>, les objets entourés seront ajoutés à la sélection.
 545                 Si vous utilisez le bouton du milieu, alors les objets entourés
 546                 seront désélectionnés s'ils étaient sélectionnés, et inversement.
 547 </entry></row>
 548
 549 <row><entry>Double-clic sur le fond d'une fenêtre</entry><entry>
 550 Redimensionne la fenêtre correctement (cette fonctionnalité peut être désactivée dans l'espace de configuration).
 551 </entry></row>
 552
 553 <row>
 554  <entry>
 555   <keycap>Backspace</keycap> (touche 'retour en arrière')
 556  </entry>
 557  <entry>
 558   Affiche le dossier père.
 559  </entry>
 560 </row>
 561
 562 <row><entry>Touches de déplacement</entry><entry>
 563 Entoure les objets l'un après l'autre au fur et à mesure du déplacement.
 564 </entry></row>
 565
 566 <row><entry>
 567 <keycap>Page Haut</keycap>, <keycap>Page Bas</keycap></entry><entry>
 568 Affiche les objets se trouvant une page plus haut ou une page plus bas.
 569 </entry></row>
 570
 571 <row><entry><keycap>Début</keycap>, <keycap>Fin</keycap></entry><entry>
 572 Affiche le premier/dernier objet du dossier.
 573 </entry></row>
 574
 575 <row><entry><keycap>Entrée</keycap></entry><entry>
 576                 Comme un clic gauche sur l'objet.
 577                 Vous pouvez maintenir enfoncé <keycap>Shift</keycap> pour modifier l'action, comme en cliquant.
 578                 En maintenant <keycap>Alt</keycap> enfoncée, l'effet sera identique à un clic avec
 579                 le bouton du milieu ; les dossiers s'ouvrent dans une nouvelle fenêtre, et l'ouverture d'un fichier
 580                 provoque la fermeture immédiate du dossier.
 581 </entry></row>
 582
 583 <row><entry><keycap>Barre d'espace</keycap></entry><entry>
 584                 Bascule l'objet actuellement entouré de l'état sélectionné à non-sélectionné (et inversement)
 585                 et déplace le contour autour de l'objet suivant.
 586 </entry></row>
 587
 588 <row>
 589  <entry>
 590   <keycap>Tabulation</keycap>, <keycap>Shift</keycap>+<keycap>Tabulation</keycap>
 591  </entry>
 592  <entry>
 593   Déplace le contour vers l'objet sélectionné suivant/précédent.
 594  </entry>
 595 </row>
 596
 597 <row>
 598  <entry>
 599   Immobiliser la souris au-dessus d'un objet
 600  </entry>
 601  <entry>
 602   Affiche une bulle d'aide avec une description rapide de l'application (si une description est fournie),
 603   avec la cible d'un lien symbolique, ou avec le nom complet d'un objet, si celui-ci est trop long pour
 604   être affiché en entier.
 605  </entry>
 606 </row>
 607
 608 </tbody></tgroup></informaltable>
 609
 610   <para>
 611           Si vous avez activé la possibilité de définir les touches de raccourcis-clavier, alors
 612       celles-ci peuvent facilement être choisies en ouvrant le menu (ndt : le menu qui contient
 613           la commande qui doit être exécutée lorsque vous utiliserez le raccourci-clavier), en
 614           positionnant le pointeur de la souris au-dessus de la commande désirée, et en pressant la
 615           (les) touche(s) devant servir de raccourci.
 616           La (les) touche(s) apparaît(ssent) maintenant dans le menu et peut(vent) désormais être utilisée(s)
 617           comme raccourci(s).
 618           Les touches de raccourcis sont automatiquement sauvées quand le filer est quitté.
 619           Vous pouvez utiliser un 'XSettings manager' tel que ROX-Session pour activer cette fonction pour
 620           toutes les applications Gtk+-2.0.
 621   </para>
 622 </chapter>
 623
 624 <chapter id="selection">
 625   <title>La sélection et les groupes de fichiers</title>
 626   <para>
 627 Quand des objets sont sélectionnés dans une fenêtre <application>ROX-Filer</application>,
 628 le filer acquiert la "sélection primaire" (il copie leur nom).
 629 Vous pouvez alors les coller dans une autre fenêtre pour obtenir le chemin des objets sélectionnés.
 630   </para>
 631
 632 <procedure>
 633         <title>Par exemple, si vous voulez charger un fichier dans une application qui ne supporte pas le drag and drop :</title>
 634
 635   <step><para>Ouvrez la boîte 'Ouvrir...' de l'application.</para></step>
 636
 637   <step><para>
 638                   Utilisez <keycap>Ctrl</keycap> et cliquez sur les fichiers dans une fenêtre <application>ROX-Filer</application> pour les sélectionner.
 639   </para></step>
 640
 641   <step><para>
 642                   Cliquez avec le bouton du milieu dans la boîte 'Ouvrir...' pour y coller les noms.
 643                   NDT : ça fonctionne aussi avec un XTerm...
 644   </para></step>
 645 </procedure>
 646
 647   <para>
 648    Notez que la plupart des navigateurs internet ("web-browsers") ouvrent les fichiers dont vous "collez"
 649    les noms en cliquant avec le bouton du milieu n'importe où dans la page (sauf un lien, bien sûr...).
 650   </para>
 651   <para>
 652    Si vous sélectionnez autre chose (par exemple du texte dans un autre programme), les objets sélectionnés
 653    dans la fenêtre du filer seront affichés grisés (car le filer n'aura plus la "sélection primaire").
 654    Si vous cliquez sur un des objets grisés, vous redonnerez au filer la "sélection primaire".
 655    </para>
 656
 657 <sect1><title>Enregistrer et restaurer la sélection</title>
 658    <para>
 659    Il est parfois utile de sauvegarder la sélection courante pour une utilisation ultérieure.
 660    Vous pouvez en enregistrer 10 en appuyant sur <keycap>Ctrl</keycap>+<keycap>&lt;chiffre&gt;</keycap>.
 661    Vous pouvez restaurer une sélection en appuyant seulement sur le chiffre utilisé.
 662    Vous pouvez aussi restaurer des sélections si un dossier différent est affiché, et même si vous utilisez une fenêtre différente.
 663    </para>
 664    <para>
 665         Cette fonction de sauvegarde est très utile même si rien n'est sélectionné, puisque le filer enregistre quand même le nom du dossier courant.
 666    </para>
 667
 668    <procedure>
 669         <title>Exemple : pour enregistrer un dossier et y retourner plus tard :</title>
 670         <step>
 671          <para>Vous avez un dossier affiché dans une fenêtre et vous souhaitez le "bookmarker".
 672    Appuyez sur <keycap>Ctrl</keycap>+<keycap>1</keycap>.
 673          </para>
 674         </step>
 675
 676         <step>
 677          <para>Affichez un autre dossier, ou fermez la fenêtre, ou... etc.</para>
 678         </step>
 679         <step>
 680          <para>Appuyez sur <keycap>1</keycap> (NDT : <keycap>Shift</keycap>+<keycap>1</keycap>) dans n'importe quelle fenêtre
 681          pour retourner dans le dossier que vous avez enregistré.
 682          </para>
 683         </step>
 684    </procedure>
 685    <para>Les groupes sont automatiquement enregistrés et seront donc accessibles pour une autre session du filer.</para>
 686 </sect1>
 687
 688 </chapter>
 689
 690 <chapter id="toolbar">
 691         <title><anchor id="Toolbar" xreflabel="Toolbar"/>La barre d'outils</title>
 692   <para>
 693
 694 Par défaut, chaque fenêtre affiche en haut une barre d'outils. Vous pouvez la désactiver
 695 (ou la rendre plus grande) dans l'espace configuration ('Options...'), et vous pouvez
 696 sélectionner les outils devant y apparaître. Normalement, vous devriez cliquer avec le
 697 bouton gauche (1). Mais beaucoup d'outils peuvent accomplir une fonction différente s'ils
 698 sont sollicités avec le bouton du milieu ou le bouton droit.
 699   </para>
 700
 701 <informaltable><tgroup cols="3">
 702
 703 <thead>
 704 <row><entry>
 705 Icône</entry><entry>
 706 Bouton gauche (1)</entry><entry>
 707 Autre bouton
 708 </entry></row>
 709
 710 </thead>
 711 <tbody>
 712
 713  <row>
 714   <entry>Croix</entry>
 715   <entry>Fermer la fenêtre</entry>
 716   <entry>Ouvrir une nouvelle fenêtre</entry>
 717  </row>
 718  <row>
 719   <entry>Flèche vers le haut</entry>
 720   <entry>Affiche le dossier père</entry>
 721   <entry>... dans une nouvelle fenêtre<xref linkend="newwin_fn"/></entry>
 722  </row>
 723  <row>
 724   <entry>Maison</entry>
 725   <entry>Affiche le dossier "Home"</entry>
 726   <entry>... dans une nouvelle fenêtre<xref linkend="newwin_fn"/></entry>
 727  </row>
 728  <row>
 729   <entry>Aller à</entry>
 730   <entry>Affiche le <xref linkend="bookmarks"/></entry>
 731   <entry>Édite les signets</entry>
 732  </row>
 733  <row>
 734   <entry>Flèches tournantes</entry>
 735   <entry>Rafraîchir</entry>
 736   <entry>Ouvrir une nouvelle fenêtre</entry>
 737  </row>
 738  <row>
 739   <entry>Loupe (+)</entry>
 740   <entry>Sélectionne une taille d'icônes plus grande.</entry>
 741   <entry>Sélectionne une taille d'icônes plus petite.</entry>
 742  </row>
 743  <row>
 744   <entry>Loupe (zone)</entry>
 745   <entry>Sélectionne le mode 'Taille automatique'.</entry>
 746   <entry>-</entry>
 747  </row>
 748  <row>
 749   <entry>Liste</entry>
 750   <entry>Affiche/Masque le détail des objets</entry>
 751   <entry>Idem</entry>
 752  </row>
 753  <row>
 754   <entry>A..Z</entry>
 755   <entry>Passe au critère de tri suivant.</entry>
 756   <entry>Passe au critère de tri précédent.</entry>
 757  </row>
 758  <row>
 759   <entry>Œil</entry>
 760   <entry>Bascule entre l'affichage et le masquage des fichiers cachés (ceux dont le nom commence par un point)</entry>
 761   <entry>Same</entry>
 762  </row>
 763  <row>
 764   <entry>Liste avec sélections</entry>
 765   <entry>Sélectionne tout.</entry>
 766   <entry>Inverse la sélection.</entry>
 767  </row>
 768  <row>
 769   <entry>Bouée</entry>
 770   <entry>Affiche les fichiers d'aide de <application>ROX-Filer</application></entry>
 771   <entry>Ouvre directement le manuel</entry>
 772  </row>
 773 </tbody></tgroup></informaltable>
 774
 775 <para>
 776 <anchor id="newwin_fn" xreflabel="[1]"/>[1]
 777 Si l'option 'Fenêtres uniques' est activée, l'action par défaut est d'ouvrir
 778 une nouvelle fenêtre &mdash; et cliquer avec l'autre bouton utilise la même
 779 fenêtre (le comportement du filer est inversé).
 780 </para>
 781
 782   <para>
 783           Glisser-déposer des objets sur les outils 'Flèche vers le haut' ou 'Maison',
 784       produit le même effet que de les glisser-déposer vers les dossiers auxquels
 785           ces outils mènent. Glisser-déposer sur l'outil 'Signets' créera un signet
 786           pour cet objet.
 787   </para>
 788   <para>
 789           La barre d'outils peut aussi montrer le nombre de fichiers dans un dossier,
 790           et quelques informations sur la sélection.
 791           Ceci peut être activé/désactivé dans l'espace configuration ('Options...').
 792   </para>
 793 </chapter>
 794
 795 <chapter id="menus">
 796   <title>Les menus</title>
 797   <para>
 798 Vous pouvez ouvrir un menu en faisant un clic droit sur un punaiseur, un panneau ou une fenêtre de filer.
 799
 800 Dans les fenêtres du filer, vous pouvez aussi utiliser <keycap>\</keycap> pour ouvrir le menu. Il
 801 existe un raccourci pour afficher le sous-menu 'Fichier' directement : maintenez enfoncée la touche
 802 <keycap>Ctrl</keycap> en ouvrant le menu. Voici une description complète de toutes les commandes :
 803
 804 <informaltable><tgroup cols="2">
 805
 806 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
 807
 808 <tbody>
 809
 810 <row><entry><guimenuitem>Affichage</guimenuitem></entry><entry>
 811 Pour modifier l'affichage.
 812 </entry></row>
 813
 814 <row><entry><guimenuitem>Fichier</guimenuitem></entry><entry>
 815 Opérations sur les objets sélectionnés.
 816 </entry></row>
 817
 818 <row><entry><guimenuitem>Sélectionner</guimenuitem></entry><entry>
 819 Pour contrôler quels objets sont sélectionnés.
 820 </entry></row>
 821
 822 <row><entry><guimenuitem>Options...</guimenuitem></entry><entry>
 823 Configure <application>ROX-Filer</application>.
 824 </entry></row>
 825
 826 <row><entry><guimenuitem>Nouveau</guimenuitem></entry><entry>
 827 Crée un nouveau fichier ou dossier à l'intérieur de ce dossier.
 828 </entry></row>
 829
 830 <row><entry><guimenuitem>Fenêtre</guimenuitem></entry><entry>
 831 Opérations diverses agissant sur la fenêtre.
 832 </entry></row>
 833
 834 <row><entry><guimenuitem>Aide</guimenuitem></entry><entry>
 835   Information sur le filer.
 836 </entry></row>
 837
 838 </tbody></tgroup></informaltable>
 839
 840   </para>
 841
 842 <sect1>
 843   <title>Le menu Affichage</title>
 844   <para>
 845
 846 <informaltable><tgroup cols="2">
 847
 848 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
 849
 850 <tbody>
 851  <row>
 852   <entry><guimenuitem>Icônes</guimenuitem></entry>
 853   <entry>Les fichiers sont affichés sous forme de "lignes d'icônes", sans détail.</entry>
 854  </row>
 855
 856  <row>
 857   <entry><guimenuitem>Icônes, avec...</guimenuitem></entry>
 858   <entry>
 859    Les fichiers sont affichés sous forme de "lignes d'icônes", avec des détails en plus
 860    (choisis dans le sous-menu). Pour voir toutes les informations sur chaque fichier,
 861    utilisez plutôt 'Liste'.
 862   </entry>
 863  </row>
 864
 865  <row>
 866   <entry><guimenuitem>Liste</guimenuitem></entry>
 867   <entry>
 868    Affiche les fichiers et tous les détails.
 869    Cliquez sur le titre d'une colonne pour activer le tri correspondant à cette colonne
 870    (un nouveau clic inversera le tri).
 871   </entry>
 872  </row>
 873
 874  <row>
 875   <entry><guimenuitem>Icônes plus grandes</guimenuitem></entry>
 876   <entry>
 877    Augmente la taille des icônes. Désactive le mode 'Automatique'.
 878   </entry>
 879  </row>
 880
 881  <row>
 882   <entry><guimenuitem>Icônes plus petites</guimenuitem></entry>
 883   <entry>
 884    Diminue la taille des icônes. Désactive le mode 'Automatique'.
 885   </entry>
 886  </row>
 887
 888  <row>
 889   <entry><guimenuitem>Automatique</guimenuitem></entry>
 890   <entry>
 891    Le filer choisit une taille d'icône adéquate pour la fenêtre active,
 892    lors de chaque changement de dossier, etc...
 893   </entry>
 894  </row>
 895
 896  <row>
 897   <entry><guimenuitem>Trier par XXX</guimenuitem></entry>
 898   <entry>
 899    Définit le critère de tri.
 900    Dans la vue 'Liste', vous pouvez aussi définir le critère de tri en cliquant
 901    sur le titre des colonnes.
 902   </entry>
 903  </row>
 904
 905  <row>
 906   <entry><guimenuitem>Inversé</guimenuitem></entry>
 907   <entry>
 908    Inverse l'ordre de tri (du plus récent au plus ancien, du plus lourd au plus
 909    léger, etc...).
 910   </entry>
 911  </row>
 912
 913  <row>
 914   <entry><guimenuitem>Montrer les fichiers cachés</guimenuitem></entry>
 915   <entry>
 916    Si cette option est activée, les objets commençant par un point sont affichés,
 917    sinon, ils sont cachés. La barre de titres affiche <guilabel>(All)</guilabel>
 918    quand cette option est activée.
 919   </entry>
 920  </row>
 921
 922  <row>
 923   <entry><guimenuitem>Montrer les imagettes</guimenuitem></entry>
 924   <entry>
 925    Activée, le filer essaiera de lire chaque fichier-image et d'utiliser cette
 926    image comme icône pour ce fichier. Très utile quand vous avez un dossier
 927    rempli de photos et que vous en cherchez une dont le nom vous échappe !
 928    Voir la section <xref linkend="thumbnails"/>.
 929   </entry>
 930  </row>
 931
 932  <row>
 933   <entry><guimenuitem>Rafraîchir</guimenuitem></entry>
 934   <entry>
 935    Relit le contenu du dossier et les détails de tous les fichiers s'y trouvant.
 936    Utilisez cette commande si l'affichage n'est plus à jour.
 937   </entry>
 938  </row>
 939
 940    </tbody>
 941   </tgroup>
 942  </informaltable>
 943
 944   </para>
 945
 946 <sect2><title><anchor id="Permissions" xreflabel="Permissions"/>
 947     Permissions
 948   </title>
 949   <para>
 950
 951 Le champ permissions, quand il est affiché, est composé de quatre groupes de trois caractères.
 952 Chaque caractère est une lettre, si la permission à laquelle le caractère réfère est attribuée,
 953 sinon, ce caractère est un tiret (&ndash;).
 954 Les trois premiers caractères montrent les permissions pour le propriétaire du fichier,
 955 les trois suivants, pour les autres utilisateurs appartenant au groupe du fichier,
 956 les trois suivants, pour le reste du monde.
 957 L'utilisateur ayant démarré <application>ROX-Filer</application> se voit situé dans les permissions
 958 par leur soulignement.
 959 Les trois derniers caractères montrent les permissions spéciales.
 960   </para><para>
 961 Les lettres représentant les permissions ont la signification suivante :
 962
 963 <itemizedlist>
 964
 965 <listitem><para><computeroutput>r</computeroutput> &mdash;
 966 Permission de lire le contenu d'un fichier, ou le nom des fichiers d'un dossier.</para></listitem>
 967
 968 <listitem><para><computeroutput>w</computeroutput> &mdash;
 969 Permission de modifier le contenu d'un fichier, ou de changer le contenu d'un dossier (renommer un fichier, par exemple).</para></listitem>
 970
 971 <listitem><para><computeroutput>x</computeroutput> &mdash;
 972 Permission d'exécuter un fichier (un programme), ou de référer aux fichiers d'un dossier (nécessaire pour voir son contenu).</para></listitem>
 973
 974 <listitem><para><computeroutput>U</computeroutput> &mdash;
 975 Ce programme s'exécute avec l'identification de son propriétaire <emphasis>(user ID)</emphasis> plutôt qu'avec celle de l'utilisateur qui l'exécute.</para></listitem>
 976
 977 <listitem><para><computeroutput>G</computeroutput> &mdash;
 978 Ce programme s'exécute avec l'identification de son groupe <emphasis>(group ID)</emphasis>, peut importe qui l'exécute.</para></listitem>
 979
 980 <listitem><para><computeroutput>T</computeroutput> &mdash;
 981 Les objets d'un tel dossier ne peuvent être supprimés que par les utilisateurs qui sont les propriétaires de ceux-ci,
 982 même si une permission d'écriture (w) existe sur le dossier.</para></listitem>
 983
 984 </itemizedlist>
 985 Par exemple,
 986 <programlisting>
 987 <emphasis role="underline">rwx</emphasis>,rwx,r-x/---</programlisting>
 988 signifie que le propriétaire de ce fichier est le même utilisateur que celui qui se sert de <application>ROX-Filer</application>
 989 (autrement dit, *vous* êtes le propriétaire de ce fichier), vous et tous les utilisateurs du groupe avez les droits
 990 de lecture, d'écriture et d'exécution ; quant au reste du monde, il peut lire et exécuter ce fichier.
 991 Il n'y a pas de 'permissions spéciales'.
 992
 993 Les règles qui régissent l'application des permissions peuvent varier d'un système d'exploitation à un autre,
 994 mais elles peuvent être considérées comme suit :
 995
 996 <itemizedlist>
 997
 998 <listitem><para>Si l'identité de l'utilisateur (<emphasis>user ID</emphasis>) qui utilise <application>ROX-Filer</application> est la même que
 999 celle du propriétaire du fichier, les permissions du propriétaire s'appliquent.
1000 </para></listitem>
1001
1002 <listitem><para>Si l'identité du groupe (<emphasis>group ID</emphasis>) de l'utilisateur est la même que celle du groupe du fichier, OU si
1003 le groupe du fichier est le même qu'un des groupes auxquels l'utilisateur appartient, les permissions du groupe s'appliquent.
1004 </para></listitem>
1005
1006 <listitem><para>Autrement, les 'autres' permissions s'appliquent.
1007 </para></listitem>
1008
1009 </itemizedlist>
1010
1011   </para>
1012 </sect2>
1013 </sect1>
1014
1015 <sect1>
1016  <title>Le menu Fichier</title>
1017  <para>
1018   Si vous ouvrez le menu alors que plusieurs objets sont sélectionnés, l'opération
1019   s'applique alors à tous ces objets. Si vous ouvrez le menu en cliquant droit sur
1020   un objet, alors qu'il n'y a pas de sélection, l'objet cliqué est alors temporairement
1021   sélectionné.
1022  </para>
1023  <para>
1024   Si vous choisissez une commande du menu sélection sans qu'il n'y ait de
1025   sélection, vous entrez en mode 'cible' ; l'opération choisie s'appliquera au prochain
1026   objet choisi. Cliquez sur le fond de la fenêtre, appuyez sur <keycap>Echap</keycap> ou
1027   faites un clic droit pour sortir du mode 'cible'. Le mode 'cible' est surtout utile si
1028   vous utilisez l'option <guilabel>Navigation en simple clic</guilabel> ou pour utiliser
1029   avec des raccourcis claviers.
1030  </para>
1031  <para>
1032   Notez que pour les dossiers-applications, il peut y avoir quelques commandes qui sont
1033   ajoutées au début de ce sous-menu quand vous cliquez sur ceux-ci &mdash; voir la section
1034   <xref linkend="AppDir"/> pour plus de détails. Vous pouvez créer des commandes supplémentaires
1035   qui apparaîtront en haut, en fonction du type de fichier sur lequel vous aurez cliqué.
1036   Pour cela, choisissez la commande <guimenuitem>Personnaliser</guimenuitem>.
1037   Par exemple, vous pourriez faire apparaître <application>The Gimp</application> pour toutes
1038   les images, et <application>FreeFS</application> pour les points de montage.
1039
1040 <informaltable><tgroup cols="2">
1041                 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
1042 <tbody>
1043
1044 <row><entry>
1045 <guimenuitem>Copier...</guimenuitem></entry><entry>
1046 Copie cet objet.
1047 </entry></row>
1048
1049 <row><entry>
1050 <guimenuitem>Renommer...</guimenuitem></entry><entry>
1051 Change le nom de cet objet, ou le déplace vers un autre dossier.
1052 </entry></row>
1053
1054 <row><entry>
1055 <guimenuitem>Lier...</guimenuitem></entry><entry>
1056 Crée un lien symbolique vers cet objet.
1057 </entry></row>
1058
1059 <row><entry>
1060 <guimenuitem>Supprimer</guimenuitem></entry><entry>
1061 Supprime tous les objets sélectionnés du dossier courant. Le contenu des sous-dossiers
1062 sera supprimé en premier. Supprimer un lien symbolique ne supprime que le lien, pas la
1063 cible de ce lien.
1064 </entry></row>
1065
1066 <row><entry>
1067 <guimenuitem>Shift Ouvrir</guimenuitem></entry><entry>
1068 Ouvre les dossiers-applications comme s'il s'agissait de simples dossiers,
1069 ouvre les fichiers comme s'il s'agissait de simple texte brut, ou ouvre le
1070 dossier contenant la cible du lien symbolique sur lequel vous "shift-cliquez".
1071 Sur des points de montage, on peut noter des effets intéressants (voir <xref linkend="media"/>).
1072 C'est la même chose que de cliquer en maintenant <keycap>Shift</keycap> enfoncé.
1073 La commande du menu sélection prend alors le nom de la commande a effectuer.
1074 </entry></row>
1075
1076 <row><entry>
1077 <guimenuitem>Ouvrir AVFS</guimenuitem></entry><entry>
1078 Ouvre le fichier comme s'il s'agissait d'un dossier &mdash; voir la section <xref linkend="vfs"/>.
1079 </entry></row>
1080
1081 <row><entry>
1082 <guimenuitem>Envoyer à...</guimenuitem></entry><entry>
1083 Ouvre le menu 'Envoyer à...', ce qui permet d'envoyer les objets à une application.
1084 Voir la section <xref linkend="SendTo"/>.
1085 </entry></row>
1086
1087 <row><entry>
1088 <guimenuitem>Fixer l'action d'exécution...</guimenuitem></entry><entry>
1089 Cette commande vous permet de choisir l'application qui sera utilisée pour
1090 ouvrir les fichiers de ce type. Lire la section <xref linkend="RunAction"/>
1091 pour plus de détails.
1092 </entry></row>
1093
1094 <row><entry>
1095 <guimenuitem>Fixer l'icône...</guimenuitem></entry><entry>
1096 Vous pouvez affecter une icône différente pour chaque fichier/dossier en
1097 utilisant cette commande &mdash; glissez-déposez simplement une icône sur <xref linkend="SetIcon"/>.
1098 </entry></row>
1099
1100 <row>
1101  <entry><guimenuitem>Propriétés</guimenuitem></entry>
1102  <entry>
1103  Affiche plus de détails sur l'objet.
1104  Vous pouvez aussi modifier les permissions d'accès à partir de cette boîte (la commande  <guimenuitem>Permissions</guimenuitem> vous permet quant à elle d'appliquer des
1105 modifications sur plusieurs fichiers simultanément), ainsi que la cible d'un lien symbolique.
1106  </entry>
1107 </row>
1108
1109 <row><entry>
1110 <guimenuitem>Compter</guimenuitem></entry><entry>
1111 Fait le total de l'espace occupé par les objets sélectionnés. Le contenu des dossiers
1112 sélectionnés est aussi compté. Les liens symboliques sont comptés, mais pas leur cible.
1113 </entry></row>
1114
1115 <row>
1116  <entry><guimenuitem>Fixer le type...</guimenuitem></entry>
1117  <entry>
1118  Cette commande vous permet de changer le type MIME d'un fichier, seulement sur les sytèmes
1119  de fichiers qui bénéficient des "attributs étendus".
1120  Si vous utilisez un système de fichiers plus ancien, vous devrez renommer le fichier (ndt : son
1121  extension) pour changer son type MIME.
1122  </entry>
1123 </row>
1124
1125 <row>
1126  <entry><guimenuitem>Permissions</guimenuitem></entry>
1127  <entry>
1128  Cette commande vous permet de changer les permissions des objets sélectionnés.
1129  Si vous ne devez changer les permissions que pour un fichier, vous pouvez utiliser
1130  la commande <guimenuitem>Propriétés</guimenuitem>, qui est plus simple.
1131  </entry>
1132 </row>
1133
1134 <row><entry>
1135 <guimenuitem>Chercher</guimenuitem></entry><entry>
1136 Cherche des fichiers en spécifiant différentes conditions &mdash; voir la section <xref linkend="Searching"/>.
1137 </entry></row>
1138
1139 </tbody></tgroup></informaltable>
1140   </para>
1141
1142   <formalpara><title>Note à propos des liens symboliques :</title>
1143     <para>
1144 Un lien symbolique enregistre <emphasis>l'emplacement</emphasis> d'un autre fichier/dossier.
1145 Supprimer un lien symbolique n'affecte en rien la cible vers laquelle celui-ci pointe.
1146 Supprimer la cible rendra le lien symbolique inutile.
1147 Il y a deux types de liens symboliques &mdash; Relatif et Absolu. Un lien absolu
1148 enregistre le chemin complet de la cible (ex <filename>/home/fred/MonFichier</filename>).
1149 Un lien relatif enregistre le chemin relatif menant jusqu'à la cible (ex <filename>../fred/MonFichier</filename>).
1150 Si la cible est censée ne jamais être déplacée, utilisez un lien absolu (vous pourrez
1151 déplacer celui-ci), mais si vous pensez que la cible peut être déplacée (le lien devra
1152 l'être aussi...), alors optez pour un lien relatif.
1153     </para>
1154   </formalpara>
1155 </sect1>
1156
1157 <sect1>
1158  <title>Le menu Sélectionner</title>
1159  <para>
1160   <informaltable><tgroup cols="2">
1161         <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
1162         <tbody>
1163          <row>
1164           <entry>
1165            <guimenuitem>Tout sélectionner</guimenuitem>
1166           </entry>
1167           <entry>
1168            Sélectionne tous les objets de cette fenêtre.
1169           </entry>
1170          </row>
1171          <row>
1172           <entry>
1173            <guimenuitem>Oublier la sélection</guimenuitem>
1174           </entry>
1175           <entry>
1176            Dé-sélectionne tous les objets de cette fenêtre.
1177           </entry>
1178          </row>
1179          <row>
1180           <entry>
1181            <guimenuitem>Inverser la sélection</guimenuitem>
1182           </entry>
1183           <entry>
1184            Dé-sélectionne tous les objets sélectionnés, et sélectionne tous
1185            les objets non sélectionnés.
1186           </entry>
1187          </row>
1188          <row>
1189           <entry>
1190            <guimenuitem>Sélectionner si...</guimenuitem>
1191           </entry>
1192           <entry>
1193            Ne sélectionner que les objets qui correspondent à certains critères
1194            &mdash; voir la section <xref linkend="SelectIf"/>.
1195           </entry>
1196          </row>
1197
1198  </tbody></tgroup></informaltable>
1199 </para>
1200 </sect1>
1201
1202 <sect1>
1203   <title>Le menu Nouveau</title>
1204   <para>
1205
1206 Chaque commande de ce sous-menu ouvre une boîte pour créer un nouveau fichier
1207 ou un nouveau dossier.
1208 Il y a deux commandes de base ; les autres reflètent le contenu de votre
1209 dossier <filename>&lt;Choices&gt;/Templates</filename>, s'il existe.
1210
1211
1212 <informaltable><tgroup cols="2">
1213 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
1214 <tbody>
1215 <row><entry>
1216 Répertoire</entry><entry>
1217 Crée un nouveau répertoire.
1218 </entry></row><row><entry>
1219 Fichier vide</entry><entry>
1220 Crée un fichier vide.
1221 </entry></row><row><entry>
1222 &lt;commandes supplémentaires&gt;</entry><entry>
1223 Copie un fichier depuis votre dossier Templates.
1224 </entry></row>
1225 </tbody></tgroup></informaltable>
1226
1227
1228 Pour ajouter vos propres commandes, créez un nouveau dossier <filename>~/Choices/Templates</filename>
1229 (si la variable <envar>CHOICESPATH</envar> est celle par défaut) et enregistrez-y tous les fichiers
1230 que vous souhaitez. Chaque fichier de ce dossier apparaîtra dans le menu et la boîte qui s'ouvrira
1231 le copiera.
1232 Par exemple, vous pourriez créer une base pour un fichier HTML :
1233
1234 <programlisting>
1235 &lt;html&gt;
1236   &lt;head&gt;
1237     &lt;title&gt;Ma Page&lt;/title&gt;
1238   &lt;/head&gt;
1239   &lt;body&gt;
1240     Le contenu.
1241   &lt;/body&gt;
1242 &lt;/html&gt;
1243 </programlisting>
1244
1245 Enregistrez ceci sous le nom <filename>index.html</filename> dans le dossier
1246 <filename>Templates</filename> et vous pourrez ainsi facilement créer de nouveaux fichiers HTML.
1247 Vous pouvez aussi y enregistrer des documents vides de toutes sortes d'applications (ex : une
1248 feuille de calcul, une lettre ou un fax, etc...).
1249   </para><para>
1250 Notez que pour l'instant, vous ne pouvez pas créer de raccourcis-clavier pour ces commandes personnalisées.
1251   </para>
1252 </sect1>
1253
1254 <sect1>
1255   <title>Le menu fenêtre</title>
1256   <para>
1257
1258
1259 <informaltable><tgroup cols="2">
1260 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
1261 <tbody>
1262
1263  <row>
1264   <entry><guimenuitem>Père, nouvelle fenêtre</guimenuitem></entry>
1265   <entry>Ouvre une nouvelle fenêtre pour afficher le contenu du dossier père.</entry>
1266  </row>
1267
1268  <row>
1269   <entry><guimenuitem>Père, même fenêtre</guimenuitem></entry>
1270   <entry>Comme ci-dessus, mais utilise la même fenêtre.</entry>
1271  </row>
1272
1273  <row>
1274   <entry><guimenuitem>Nouvelle fenêtre</guimenuitem></entry>
1275   <entry>Ouvre une nouvelle fenêtre avec le même dossier courant.</entry>
1276  </row>
1277
1278  <row>
1279   <entry><guimenuitem>Répertoire Home</guimenuitem></entry>
1280   <entry>Affiche le contenu de votre répertoire personnel.</entry>
1281  </row>
1282
1283  <row>
1284   <entry><guimenuitem>Afficher les signets</guimenuitem></entry>
1285   <entry>Ouvre le menu des signets (voir <xref linkend="bookmarks"/>).</entry>
1286  </row>
1287
1288  <row>
1289   <entry><guimenuitem>Suivre les liens symboliques</guimenuitem></entry>
1290   <entry>
1291    Convertit le chemin affiché dans la barre de titre en son nom canonique.
1292    Par exemple, si <filename>/home/fred/lien</filename> est un lien symbolique
1293    pointant sur <filename>/usr/share/doc/</filename>, cliquer le lien vous
1294    amènera dans ce dossier, et remonter avec la flèche vous ramènera dans
1295    <filename>/home/fred</filename>.
1296    Si vous aviez utilisé <guimenuitem>Suivre les liens symboliques</guimenuitem>,
1297    vous seriez revenu dans <filename>/usr/share</filename>.
1298   </entry>
1299  </row>
1300
1301  <row>
1302   <entry><guimenuitem>Changer taille de la fenêtre</guimenuitem></entry>
1303   <entry>Ajuste la taille de la fenêtre à son contenu.</entry>
1304  </row>
1305
1306  <row>
1307   <entry><guimenuitem>Fermer la fenêtre</guimenuitem></entry>
1308   <entry>Ferme la fenêtre.</entry>
1309  </row>
1310
1311  <row>
1312   <entry><guimenuitem>Entrer un chemin...</guimenuitem></entry>
1313   <entry>Ouvre un "espace de saisie" pour ouvrir un autre dossier (voir section <xref linkend="mini"/>).</entry>
1314  </row>
1315
1316  <row>
1317   <entry><guimenuitem>Commande shell...</guimenuitem></entry>
1318   <entry>Ouvre un "espace de saisie" pour exécuter une commande shell (voir section <xref linkend="mini"/>).</entry>
1319  </row>
1320
1321  <row>
1322   <entry><guimenuitem>Xterm ici</guimenuitem></entry>
1323   <entry>Ouvre un xterm avec ce dossier comme dossier courant.</entry>
1324  </row>
1325
1326  <row>
1327   <entry><guimenuitem>Remplacer par un xterm</guimenuitem></entry>
1328   <entry>Ouvre un xterm avec ce dossier comme dossier courant, et ferme la fenêtre du filer automatiquement.</entry>
1329  </row>
1330
1331 </tbody></tgroup></informaltable>
1332   </para>
1333 </sect1>
1334
1335 <sect1>
1336  <title>Le menu Aide</title>
1337  <para>
1338   <informaltable>
1339    <tgroup cols="2">
1340         <thead>
1341          <row>
1342           <entry>Commande</entry>
1343           <entry>Action</entry>
1344          </row>
1345         </thead>
1346         <tbody>
1347          <row>
1348           <entry>
1349            <guimenuitem>Au sujet de ROX-Filer...</guimenuitem>
1350           </entry>
1351           <entry>
1352            Affiche des informations sur le fichier. C'est la même chose que de localiser ROX-Filer
1353            dans une fenêtre du filer et de sélectionner <guimenuitem>Propriétés</guimenuitem>
1354            dans le menu Fichier.
1355           </entry>
1356          </row>
1357          <row>
1358           <entry>
1359            <guimenuitem>Montrer les fichiers d'aide</guimenuitem></entry><entry>
1360            Même chose que de localiser ROX-Filer et de sélectionner <guimenuitem>Aide</guimenuitem> dans
1361            le menu Fichier.
1362           </entry>
1363          </row>
1364          <row>
1365           <entry>
1366            <guimenuitem>Manuel</guimenuitem>
1367           </entry>
1368           <entry>
1369            Ouvre le manuel HTML correspondant à votre langue, ou la version anglaise si la traduction n'a
1370            pas été réalisée.
1371           </entry>
1372          </row>
1373         </tbody>
1374    </tgroup>
1375   </informaltable>
1376
1377  </para>
1378 </sect1>
1379
1380 <sect1>
1381  <title><anchor id="SendTo" xreflabel="Send To menu"/>Le menu 'Envoyer à...'</title>
1382  <para>
1383   Le menu 'Envoyer à...' permet d'envoyer très facilement un (des) objet(s) à une application.
1384   Le filer cherche le dossier <filename>SendTo</filename> dans votre <envar>CHOICESPATH</envar>
1385   et liste son contenu dans ce menu.
1386  </para>
1387  <para>
1388   Pour changer les applications qui apparaissent ici, vous pouvez utiliser la commande
1389   <guimenuitem>Personnaliser</guimenuitem> qui se trouve en bas du menu ; elle créera si
1390   nécessaire le dossier <filename>SendTo</filename> et l'ouvrira.
1391   Vous pouvez placer dans ce dossier des liens symboliques en glissant/déposant des applications
1392   et en choisissant <guimenuitem>Lier</guimenuitem> dans le menu qui apparaît.
1393  </para>
1394  <para>
1395   L'affichage du menu 'Envoyer à...' via le menu principal est plutôt lent ; vous devriez l'ouvrir
1396   en cliquant sur un fichier avec le bouton droit en maintenant la touche <keycap>Shift</keycap>
1397   enfoncée.
1398  </para>
1399
1400  <sect2>
1401   <title>Afficher différentes applications selon les types MIME</title>
1402   <para>
1403    Vous pouvez personnaliser votre environnement pour que, par exemple,
1404    seul "The Gimp" soit affiché quand une image est sélectionnée.
1405    Pour cela, créez un dossier caché dans <filename>SendTo</filename> nommé
1406    <filename>.image</filename>, ou portant le nom d'un autre type MIME.
1407    Vous pouvez utiliser le nom complet d'un type MIME (par ex <filename>.image_png</filename>)
1408    ou juste le "media type". Utilisez <guimenuitem>Propriétés</guimenuitem> sur un fichier pour
1409    connaître son type MIME.
1410   </para>
1411   <para>
1412    Les objets créés dans ces dossiers cachés ne sont affichés que pour les fichiers correspondant
1413    au type MIME décrit par le nom dudit dossier. Si plusieurs fichiers sont sélectionnés, le dossier
1414    <filename>.group</filename> est alors utilisé.
1415   </para>
1416  </sect2>
1417 </sect1>
1418
1419 <sect1>
1420  <title><anchor id="bookmarks" xreflabel="Bookmarks menu"/>Le menu signets</title>
1421  <para>
1422   Le menu signets trouve son utilité dans la mémorisation de chemins de dossiers
1423   souvent utilisés. Vous pouvez aussi ouvrir ce menu depuis le menu principal
1424   (dans le sous-menu <guimenuitem>Fenêtre</guimenuitem>) et vous pouvez donc y affecter
1425   un raccourci-clavier.
1426   Dans ce menu, vous pouvez choisir d'ajouter à la liste le dossier actuellement affiché,
1427   d'aller directement dans un des dossiers enregistrés, ou bien d'ouvrir une boîte de
1428   dialogue vous permettant de modifier cette liste.
1429   Dans cette boîte, vous pouvez retirer des dossiers de la liste, les classer (en utilisant
1430   les flèches ou en les faisant glisser) et modifier les chemins directement si vous le souhaitez.
1431  </para>
1432  <para>
1433   Le sous-menu <guimenuitem>Récemment visités</guimenuitem> propose un historique des derniers
1434   dossiers affichés, dans lesquels vous pouvez vous rendre d'un simple clic. Le dossier actif, s'il
1435   est dans ce sous-menu, est désactivé puisque vous êtes déjà dans celui-ci.
1436  </para>
1437 </sect1>
1438
1439 </chapter>
1440
1441 <chapter id="icons">
1442   <title>Le punaiseur et les panneaux</title>
1443   <para>
1444 Les sections <xref linkend="run_pin"/> et <xref linkend="run_pan"/> expliquent
1445 comment activer/désactiver le punaiseur et les panneaux. Quand ils sont activés,
1446 vous pouvez déposer des objets dessus en les glissant depuis une fenêtre du filer.
1447 Cliquer sur un objet du punaiseur ou d'un panneau revient à cliquer sur l'objet
1448 auquel le premier fait référence (ndt : comme un lien). Vous pouvez aussi glisser-déposer
1449 les icônes du punaiseur et des panneaux comme des objets normaux, et pour les modifier,
1450 faites un clic droit dessus.
1451   </para>
1452   <para>
1453    Vous pouvez arranger les icônes des panneaux en les faisant glisser avec le bouton du milieu.
1454    Dans les versions précédentes du filer, les icônes du punaiseur étaient aussi déplaçables avec
1455    le bouton du milieu ; ce n'est désormais plus possible, l'usage de celui-ci étant réservé au
1456    gestionnaire de fenêtres.
1457   </para>
1458   <para>
1459    Vous pouvez affecter des raccourcis-clavier aux icônes des punaiseurs et des panneaux. Ils
1460    pourront être utilisés pour ouvrir rapidement des dossiers, des fichiers ou des applications,
1461    même si une autre fenêtre a le focus.
1462   </para>
1463   <para>
1464    Tout changement apporté au punaiseur et aux panneaux est immédiatement enregistré.
1465    Si vous cliquez sur ces icônes en maintenant <keycap>Ctrl</keycap> enfoncé,
1466    vous les sélectionnerez/dé-sélectionnerez. Cliquez ailleurs sur le bureau pour tout dé-sélectionner.
1467   </para>
1468
1469   <important>
1470    <para>
1471         Déposer des objets sur le punaiseur ou les panneaux <emphasis>NE LES COPIE PAS</emphasis>, cela
1472         crée seulement un raccourci vers l'objet original. Si vous effacez l'objet
1473         original, vous le perdez ! Supprimer une icône du punaiseur ou d'un panneau
1474         ne supprime que celui-ci. Ce comportement diffère de celui des autres gestionnaires
1475         de fichiers, en général...
1476    </para>
1477   </important>
1478
1479 <sect1>
1480   <title>Les menus du punaiseur et des panneaux</title>
1481   <para>
1482
1483 <informaltable><tgroup cols="2">
1484 <thead><row><entry>Commande</entry><entry>Action</entry></row></thead>
1485 <tbody>
1486
1487 <row><entry>
1488 <guimenuitem>ROX-Filer</guimenuitem></entry><entry>
1489 Affiche l'aide, la boîte des options, ou votre dossier personnel.
1490 </entry></row>
1491
1492 <row><entry>
1493                 <guimenuitem>Fichier 'fichier'</guimenuitem></entry><entry>
1494 Ouvre le même menu que le menu 'Fichier' du filer, mais en simplifié.
1495 </entry></row>
1496
1497 <row><entry>
1498 <guimenuitem>Éditer l'objet</guimenuitem></entry><entry>
1499 Modifier le nom qui est affiché sous l'icône, ou le chemin de l'objet vers lequel
1500 pointe l'icône. Vous pouvez aussi assigner un raccourci-clavier à cet objet.
1501 </entry></row>
1502
1503 <row><entry>
1504 <guimenuitem>Voir l'emplacement</guimenuitem></entry><entry>
1505 Ouvre une fenêtre montrant le dossier où est enregistré l'objet original.
1506 </entry></row>
1507
1508 <row><entry>
1509 <guimenuitem>Enlever le(s) objet(s)</guimenuitem></entry><entry>
1510 Supprime du punaiseur ou des panneaux les objets sélectionnés.
1511 </entry></row>
1512
1513 <row>
1514  <entry>
1515   <guimenuitem>Image de fond...</guimenuitem>
1516  </entry>
1517  <entry>
1518   Définit l'image de fond pour le punaiseur (voir ci-dessous). Disponible dans
1519   le menu du punaiseur seulement.
1520  </entry>
1521 </row>
1522
1523 </tbody></tgroup></informaltable>
1524
1525 </para>
1526
1527 <para>
1528  Si vous mettez en place les icônes par défaut pour plusieurs utilisateurs
1529  et que vous souhaitez créer une icône 'Home' qui pointe vers le dossier
1530  personnel de chaque utilisateur, créez une icône, choisissez
1531  <guimenuitem>Éditer l'icône</guimenuitem> et mettez <filename>~</filename>
1532  pour le chemin.
1533 </para>
1534 <para>
1535  Notez que des applications peuvent ajouter des commandes au début de ce
1536  menu quand vous cliquez dessus &mdash; voir la section <xref linkend="AppDir"/>
1537  pour plus de détails.
1538 </para>
1539
1540 </sect1>
1541
1542 <sect1>
1543   <title>'Appliquettes' pour les panneaux</title>
1544   <para>
1545
1546 <application>ROX-Filer</application> vous permet d'exécuter de petits programmes à l'intérieur des panneaux
1547 &mdash; ces programmes sont appelés <emphasis>appliquettes</emphasis>. Pour démarrer une appliquette,
1548 glissez-déposez-la sur un panneau, depuis une fenêtre du filer et au lieu de voir l'icône apparaître,
1549 vous verrez l'appliquette démarrer.
1550   </para>
1551
1552   <procedure><title>Pour créer vos propres appliquettes (pour les programmeurs !) :</title>
1553
1554     <step><para>
1555 Créez un dossier pour l'appliquette (ex <filename>MonAppliquette</filename>).
1556     </para></step>
1557
1558         <step>
1559          <para>
1560           Utilisez la commande <guimenuitem>Fixer l'icône...</guimenuitem> pour créer
1561           une icône appelée <filename>.DirIcon</filename> à l'intérieur de ce dossier
1562           (celui-ci apparaîtra avec cette icône).
1563          </para>
1564         </step>
1565
1566         <step>
1567          <para>
1568           Créez-y un dossier <filename>Help</filename>, qui sera affiché quand les utilisateurs
1569           choisiront <guimenuitem>Aide</guimenuitem> dans le menu.
1570          </para>
1571         </step>
1572
1573         <step>
1574          <para>
1575           Créez un exécutable appelé <filename>AppletRun</filename>.
1576           Lorsque le dossier de l'appliquette sera glissé sur un panneau, ROX-Filer lancera cet
1577           exécutable avec pour argument un identifiant XID, correspondant à une fenêtre-socket
1578           pour ce panneau. Vous pouvez utiliser l'identifiant pour créer une widget GtkPlug.
1579           Un exemple d'appliquette (en Python) est disponible ici : <ulink url="http://rox.sourceforge.net/applets.html"/>
1580      </para>
1581         </step>
1582
1583   </procedure>
1584 </sect1>
1585
1586 <sect1>
1587  <title><anchor id="iconify" xreflabel="Iconified windows"/>Fenêtres iconifiées sur le punaiseur</title>
1588  <para>
1589   Quand le punaiseur est utilisé, ROX-Filer peut afficher une icône pour chaque fenêtre iconisée (ou
1590   "réduite"). Vous pouvez activer/désactiver cette fonctionnalité dans la boîte Options.
1591   Les icônes des fenêtres réduites sont sur un fond semi-transparent et peuvent être déplacées à la souris.
1592   Si vous cliquez sur une de ces icônes, celle-ci reprendra la taille normale de l'application qu'elle représente.
1593   Quelques anciens gestionnaires de fenêtres ne sont pas compatibles avec cette fonctionnalité, et n'affichent
1594   donc pas ces icônes.
1595  </para>
1596 </sect1>
1597
1598 <sect1>
1599  <title><anchor id="backdropapp" xreflabel="Backdrop applications"/>L'image de fond</title>
1600  <para>
1601   Vous pouvez choisir une image de fond pour le punaiseur en choisissant <guimenuitem>Image de fond...</guimenuitem>
1602   dans le menu du punaiseur (clic droit sur le bureau quand le punaiseur est activé).
1603  </para>
1604  <para>
1605    Pour choisir une image, choisissez <guilabel>Centrer</guilabel>, <guilabel>Redimensionner</guilabel>,
1606    <guilabel>Étirer</guilabel> ou <guilabel>Paver</guilabel> pour le style, puis faites glisser une image dans l'emplacement prévu.
1607    Pour retrouver un bureau avec une simple couleur (définie dans la boîte Options), cliquez sur
1608    <guibutton>Effacer</guibutton>.
1609    </para>
1610    <para>
1611         L'application <citation>Wallpaper</citation> peut être utilisée pour appliquer des
1612         effets avancés, comme choisir une nouvelle image aléatoirement toutes les heures, ou
1613         afficher une image de la Terre grâce au programme xearth, par exemple.
1614    </para>
1615  <formalpara>
1616   <title>Pour les programmeurs...</title>
1617   <para>
1618    Si vous voulez créer une application qui gère le fond d'écran (par exemple pour choisir une image au hasard
1619    ou pour faire un diaporama), vous devez d'abord créer un dossier-application (voir <xref linkend="AppDir"/>).
1620   </para>
1621  </formalpara>
1622  <para>
1623   Exécutée sans argument, l'application doit invoquer la méthode SOAP <function>SetBackdropApp</function>
1624   (voir <xref linkend="soap"/>). Le filer ré-exécutera immédiatement l'application, cette fois avec l'option
1625   <option>--backdrop</option>.
1626  </para>
1627  <para>
1628   Exécutée avec l'option <option>--backdrop</option>, l'application doit afficher le style et le nom de
1629   l'image utilisée sur sa sortie standard, ie :
1630   <screen>tile /tmp/image.png</screen>
1631   <userinput>centre</userinput> et <userinput>scale</userinput> sont les 2 autres styles acceptés.
1632   Le filer va ensuite charger cette image et l'afficher. L'application ne gère pas l'affichage de
1633   l'image, elle indique seulement au filer quoi afficher.
1634  </para>
1635  <para>
1636   Dans le cas d'une application qui choisirait une image aléatoirement, elle peut s'arrêter immédiatement.
1637   Si l'application a créé une image temporaire, elle doit lire la ligne "ok\n" sur son entrée standard avant
1638   d'effacer l'image.
1639  </para>
1640  <para>
1641   Si l'application doit afficher une séquence d'images, elle doit toujours lire "ok\n", puis attendre
1642   jusqu'à ce que le moment soit venu d'afficher l'image suivante, afficher le nom du fichier, et ainsi de suite.
1643  </para>
1644  <para>
1645   Le filer indiquera à l'application qu'elle doit s'arrêter en fermant les deux "flux" (entrée et sortie).
1646   L'application devra alors nettoyer et sortir proprement à ce moment.
1647   Vérifiez que SIGPIPE soit bien géré quand vous écrivez sur la sortie standard si vous devez supprimer
1648   des fichiers temporaires.
1649  </para>
1650  <para>
1651   Voyez l'application <citation>Wallpaper</citation> pour un exemple détaillé (écrit en python).
1652  </para>
1653 </sect1>
1654 </chapter>
1655
1656 <chapter>
1657  <title>
1658   <anchor id="media" xreflabel="Removable devices"/>Périphériques amovibles</title>
1659   <para>
1660    L'utilisation de périphériques amovibles avec ROX-Filer (tels que les lecteurs de disquettes
1661    et de CD-ROM) est relativement simple, mais il est toutefois important de bien comprendre
1662    ce que sont le <emphasis>montage</emphasis> et le <emphasis>démontage</emphasis> de périphériques.
1663   </para>
1664   <para>
1665    Monter un périphérique implique l'affichage de son contenu dans le système de fichiers.
1666    Dans une installation courante, le dossier <filename>/floppy</filename> (NDT : le dossier
1667    <filename>/mnt/floppy</filename> est peut-être plus courant dans les distributions "grand public")
1668    est un dossier vide du disque dur.
1669    Le lecteur de disquettes est ensuite monté sur ce dossier, ce qui a pour effet d'afficher son
1670    contenu à l'intérieur de celui-ci. Par exemple, un fichier nommé <filename>Letter</filename> sur
1671    la disquette apparaîtra comme <filename>/floppy/Letter</filename>.
1672   </para>
1673   <para>
1674    Les périphériques doivent être démontés avant d'être éjectés. Les démonter oblige le système à
1675    y écrire les données qui peuvent être encore en zone tampon. Si vous retirez un périphérique
1676    amovible sans le démonter, il pourra être endommagé. Les lecteurs de CD-ROM et de disquettes Zip
1677    bloquent généralement l'éjection quand le périphérique est monté afin que vous ne puissiez pas
1678    les éjecter accidentellement.
1679   </para>
1680   <para>
1681    Afin de ne pas avoir à préciser à chaque fois quel périphérique doit être monté à quel endroit
1682    du système de fichiers, une liste est déjà établie et peut généralement être trouvée dans le
1683    fichier <filename>/etc/fstab</filename>. ROX-Filer affiche les points de montage qui y sont
1684    décrits (tel que <filename>/floppy</filename>) mais non montés, avec des cercles gris
1685    translucides par-dessus leur icône.
1686   </para>
1687   <para>
1688    Cliquer sur un de ces points de montage provoquera le montage du périphérique associé.
1689    Le cercle deviendra alors vert pour indiquer que le périphérique est monté.
1690    <emphasis>N'enlevez pas</emphasis> le périphérique si le cercle est vert ! Vous pouvez
1691    le démonter en cliquant (avec la touche <keycap>Shift</keycap> enfoncée) sur l'icône du
1692    dossier <filename>/floppy</filename>.
1693   </para>
1694   <para>
1695    Vous pouvez aussi démonter un périphérique en fermant la fenêtre du dossier qui affiche
1696    son contenu (i.e., en fermant la fenêtre <filename>/floppy</filename>) et en choisissant
1697    Démonter dans la boîte de dialogue qui s'affichera. Le filer ne vous proposera un tel
1698    démontage que s'il a aussi réalisé le montage.
1699   </para>
1700   <para>
1701    Si vous voulez ouvrir un dossier sans monter le périphérique qui lui est normalement
1702    associé, (i.e., si vous voulez voir le contenu de <filename>/floppy</filename> sur le
1703    disque dur), vous pouvez cliquer sur le point de montage non monté avec la touche
1704    <keycap>Shift</keycap> enfoncée.
1705    Ce n'est généralement pas très utile, puisque ces dossiers sont souvent vides.
1706   </para>
1707
1708 </chapter>
1709
1710 <chapter>
1711   <title><anchor id="thumbnails" xreflabel="Thumbnails"/>Imagettes</title>
1712   <para>
1713     Quand cette fonction est activée, le filer peut afficher les fichiers images avec une icône
1714     représentant le contenu de ceux-ci, au lieu d'une icône générique. Très utile pour
1715     organiser un dossier rempli de photos ! Vous pouvez activer cette fonction pour le dossier
1716     en cours en choisissant la commande <guimenuitem>Montrer les imagettes</guimenuitem>
1717     du menu <guimenu>Affichage</guimenu>. Vous pouvez aussi activer cette option par
1718     défaut dans la boîte Options.
1719     La barre de titres affiche <guilabel>(Imagettes)</guilabel> quand cette option est active.
1720   </para>
1721   <para>
1722    Les imagettes sont enregistrées dans <filename>~/.thumbnails</filename> pour un
1723    affichage ultérieur plus rapide.
1724    Lors de l'affichage des imagettes, une barre de progression est présente en bas
1725    de la fenêtre. Vous pouvez stopper ce processus en cliquant sur le bouton
1726    <guibutton>Annuler</guibutton>, qui se trouve à côté de la barre de progression.
1727    Vous pouvez demander au filer qu'il crée des imagettes pour d'autres types de fichiers,
1728    comme les vidéos par exemple (i.e. en montrant la première image), grâce à un logiciel
1729    adéquat.
1730   </para>
1731 <sect1>
1732  <title>Détails techniques</title>
1733   <para>
1734   En mode 'Imagettes', <application>ROX-Filer</application> vérifie le
1735   dossier <filename>~/.thumbs/normal</filename> pour chaque fichier passé en revue.
1736   Si une imagette existe, il la charge et passe au fichier suivant.
1737   </para>
1738   <para>
1739   Pour générer l'imagette d'un fichier de type media/subtype, le filer recherche un exécutable
1740   nommé <filename>&lt;Choices&gt;/MIME-thumb/media_subtype</filename>,
1741   en se rabattant sur <filename>&lt;Choices&gt;/MIME-thumb/media</filename> s'il
1742   ne le trouve pas. Si aucun des deux ne peut être trouvé et que le fichier est du
1743   type image/*, les routines internes sont alors utilisées. Si le fichier n'est pas
1744   du type image/*, l'imagette ne sera pas générée.
1745   </para>
1746   <para>
1747   Si l'exécutable est trouvé, il est démarré avec les paramètres
1748   <screen>thumbnailer /path/to/source/file /path/to/thumbnail pixel_size</screen>.
1749   </para>
1750   <para>
1751   Quand celui-ci est terminé, le filer essaie de charger
1752   <filename>/path/to/thumbnail</filename>. En cas d'échec, l'imagette n'est pas
1753   montrée.
1754   </para>
1755   <para>
1756   Notez les nombreuses étapes nécessaires ! ROX-Filer utilisera volontiers une imagette
1757   existante, même s'il ne sait pas comment celle-ci a été générée.
1758   </para>
1759 </sect1>
1760
1761  </chapter>
1762
1763 <chapter id="virtual">
1764   <title>
1765     <anchor id="vfs" xreflabel="Virtual file systems"/>Systèmes de fichier virtuel (VFS)
1766   </title>
1767   <para>
1768    Certains types de fichier peuvent être représentés sous forme de dossier.
1769    Un exemple typique est le fichier zip, qui contient une structure complète
1770    et compressée d'un dossier.
1771    Il peut être très pratique d'ouvrir un tel fichier comme s'il s'agissait
1772    d'un vrai dossier ; c'est ce que vous permet de faire le système VFS.
1773   </para>
1774   <para>
1775    Pour utiliser cette fonctionnalité, vous devez disposer d'un système comme
1776    AVFS <citation>AVFS</citation>, qui permet au noyau d'intégrer directement
1777    le support de différents Systèmes de Fichiers Virtuels.
1778   </para>
1779 </chapter>
1780
1781 <chapter id="minibuffer">
1782   <title><anchor id="mini" xreflabel="Minibuffer"/>Le mini-buffer</title>
1783   <para>
1784
1785 Le mini-buffer est une barre blanche qui apparaît le long de la fenêtre du filer,
1786 en bas, et qui vous permet d'entrer du texte.
1787 Pressez <keycap>Echap</keycap> pour vous en débarrasser. Le mini-buffer se comporte différemment,
1788 selon la manière dont il a été appelé :
1789   </para>
1790
1791 <sect1>
1792   <title>Entrer un chemin...</title>
1793   <para>
1794
1795 Vous pouvez taper un chemin, directement. Au fur et à mesure que vous tapez, l'affichage de la fenêtre est mis à jour
1796 pour vous montrer l'objet qui correspond à ce que vous êtes en train de taper.
1797 L'utilité de cette commande réside dans la recherche d'un fichier dans un dossier très fourni, mais vous pouvez
1798 vous en servir pour passer directement à un autre dossier, ou pour coller un chemin complet que vous aurez copié
1799 depuis une autre fenêtre.
1800
1801
1802 <informaltable><tgroup cols="2">
1803 <thead><row><entry>Touche</entry><entry>Action</entry></row></thead>
1804 <tbody>
1805
1806 <row><entry>
1807 <keycap>Entrée</keycap></entry><entry>
1808 Ouvre l'objet sélectionné.
1809 </entry></row>
1810
1811 <row><entry>
1812 <keycap>Tabulation</keycap></entry><entry>
1813 Complétion "à la shell" (comme dans xterm).
1814 </entry></row>
1815
1816 <row><entry>
1817 <keycap>Haut</keycap>, <keycap>Bas</keycap></entry><entry>
1818 Sélectionne graphiquement la correspondance précédente/suivante.
1819 </entry></row>
1820 </tbody></tgroup></informaltable>
1821
1822   </para>
1823
1824   <para>
1825 Si vous commencez à taper un nom commençant par un '.', la commande <guimenuitem>Montrer les fichiers cachés</guimenuitem>
1826 est     temporairement activée pour que les fichiers puissent être affichés.
1827   </para>
1828
1829   <para>
1830    La complétion essaie de trouver le maximum de caractères possibles.
1831    Par exemple, s'il y a deux fichiers dans un même dossier qui s'appellent
1832    <filename>save-mail-nov-1999</filename> et
1833    <filename>save-mail-dec-1999</filename>, alors le simple fait de taper
1834    <userinput>save</userinput> et de presser la touche <keycap>Tabulation</keycap>
1835    développera <userinput>save</userinput> en <userinput>save-mail-</userinput>
1836    et bipera pour indiquer que la correspondance n'est pas complète.
1837    Si vous utilisez la complétion sur un dossier et qu'il est unique,
1838    le filer va automatiquement afficher celui-ci.
1839    Ce comportement doit rappeler quelque chose aux utilisateurs du shell.
1840   </para>
1841
1842   <informalexample>
1843    <para>
1844         Admettons que vous vouliez trouver la documentation de Wine dans le
1845         dossier <filename>/usr/share/doc</filename> (qui est habituellement très chargé).
1846         Voici comment vous pourriez faire :
1847
1848 <orderedlist>
1849
1850  <listitem>
1851   <para>
1852    Ouvrez le mini-buffer en choisissant la commande
1853    <guimenuitem>Entrer un chemin...</guimenuitem> du menu <guimenu>Fenêtre</guimenu>, ou,
1854    si vous n'avez pas modifié le raccourci-clavier par défaut, pressez <keycap>/</keycap>.
1855 </para></listitem>
1856
1857 <listitem>
1858  <para>
1859   Pressez <keycap>CTRL</keycap>+<keycap>A</keycap> pour sélectionner l'entrée par défaut.
1860  </para>
1861 </listitem>
1862
1863 <listitem>
1864  <para>
1865   Tapez <userinput>u&lt;Tab&gt;sh&lt;Tab&gt;do&lt;Tab&gt;wi&lt;Tab&gt;</userinput>.
1866   Au fur et à mesure que vous tapez, les dossiers seront ouverts automatiquement.
1867   Si un bip retentit quand vous pressez la touche <keycap>Tab</keycap>, vous devez
1868   taper une lettre de plus (car il y a plusieurs correspondances), ou presser
1869   <keycap>Entrée</keycap>.
1870  </para>
1871 </listitem>
1872
1873 </orderedlist>
1874
1875   </para></informalexample>
1876 </sect1>
1877
1878 <sect1>
1879   <title>La commande shell</title>
1880   <para>
1881    Cette fonction vous permet d'entrer rapidement des commandes shell
1882    si vous ne voulez pas ouvrir d'xterm.
1883    Si vous ne savez pas ce que sont des "commandes shell", passez à la section suivante !
1884   </para>
1885   <para>
1886    Tapez simplement la commande et pressez <keycap>Entrée</keycap> pour
1887    l'exécuter.
1888    Les touches <keycap>Haut</keycap> et <keycap>Bas</keycap> rappellent
1889    les commandes précédentes. <keycap>Tab</keycap> effectue toujours la
1890    complétion. Cliquer sur un objet insère son nom dans le mini-buffer.
1891    Si plusieurs objets sont sélectionnés, ils sont assignés aux paramètres
1892    <userinput>$1</userinput>, <userinput>$2</userinput>, etc.
1893   </para>
1894   <para>
1895    Ouvrir le mini-buffer alors que des objets sont sélectionnés ajoute <computeroutput>"$@"</computeroutput>
1896    à la fin de la commande &mdash; ce qui remplace le nom des objets sélectionnés.
1897   </para>
1898
1899   <informalexample>
1900    <para>Exemples :
1901
1902 <orderedlist><title>Pour "détarer" une archive <filename>.tgz</filename> :</title>
1903
1904 <listitem><para>
1905 Ouvrez le mini-buffer en choisissant la commande <guimenuitem>Commande shell...</guimenuitem> du menu
1906 <guimenu>Fenêtre</guimenu>.
1907 J'utilise habituellement le raccourci <keycap>!</keycap> pour cette commande.
1908 </para></listitem>
1909
1910 <listitem><para>
1911 Tapez <userinput>tar xzf</userinput> et cliquez sur le fichier.
1912 L'espace entre les options de tar et le nom du fichier est automatiquement inséré.
1913 </para></listitem>
1914
1915 <listitem><para>
1916 Pressez <keycap>Entrée</keycap> pour exécuter.
1917 </para></listitem>
1918
1919 </orderedlist>
1920
1921 <orderedlist><title>Pour imprimer tous les fichiers sélectionnés :</title>
1922
1923 <listitem><para>
1924 Choisissez la commande <guimenuitem>Commande shell</guimenuitem>.
1925 </para></listitem>
1926
1927 <listitem><para>
1928 Tapez <userinput>lpr</userinput> au début de la ligne et pressez <keycap>Entrée</keycap>.
1929 </para></listitem>
1930
1931 </orderedlist>
1932
1933 </para></informalexample>
1934
1935 <itemizedlist><title>Notes</title>
1936
1937 <listitem><para>
1938 Attention : aucune confirmation n'est demandée ! Si vous doutez, commencez
1939 votre commande par <userinput>xmessage</userinput>, ce qui provoquera un affichage, plutôt qu'une exécution.
1940 </para></listitem>
1941
1942 <listitem><para>
1943 C'est <citerefentry><refentrytitle>sh</refentrytitle></citerefentry>
1944 qui est toujours utilisé (principalement à cause de la façon dont
1945 <citerefentry><refentrytitle>bash</refentrytitle></citerefentry> et
1946 <citerefentry><refentrytitle>csh</refentrytitle></citerefentry> traitent
1947 les paramètres positionnels).
1948 De toute façon, <envar>PATH</envar> est cherché, donc vous pouvez
1949 toujours utiliser un autre shell si vous le voulez, en le nommant sh
1950 et en le mettant dans votre <envar>PATH</envar>.
1951 </para></listitem>
1952
1953 <listitem><para>
1954 Les commandes sont exécutées en arrière-plan, donc vous pouvez faire :
1955
1956 <command>sleep 240; xmessage Time to go!</command>
1957 </para></listitem>
1958
1959 </itemizedlist>
1960 </sect1>
1961
1962 <sect1>
1963   <title><anchor id="SelectIf" xreflabel="Select If"/>Sélectionner si...</title>
1964   <para>
1965
1966 Utilisez cette commande si vous voulez sélectionner des objets correspondant à certains critères.
1967
1968 <orderedlist><title>Par exemple, pour sélectionner tous les fichiers "pesant" plus de 5 Mb :</title>
1969
1970 <listitem><para>
1971                 Choisissez la commande <guimenuitem>Sélectionner si...</guimenuitem>.
1972 </para></listitem>
1973
1974 <listitem><para>
1975 Tapez <userinput>Size &gt; 5Mb</userinput> et pressez la touche <keycap>Entrée</keycap>.
1976 </para></listitem>
1977
1978 </orderedlist>
1979
1980 Tous les fichiers (et seulement eux) plus gros que 5 Mb seront sélectionnés.
1981 Les expressions que vous pouvez utiliser ici sont du même style que celles décrites
1982 à la section <xref linkend="Searching"/>, sauf que <userinput>prune</userinput> n'a aucun effet,
1983 puisque le contenu des dossiers n'est jamais vérifié. Vous pouvez utiliser <keycap>Tab</keycap>
1984 pour passer d'un objet sélectionné à un autre, en boucle.
1985
1986   </para>
1987 </sect1>
1988 </chapter>
1989
1990 <chapter id="actions">
1991   <title>Les fenêtres action</title>
1992   <para>
1993
1994 Les fenêtres action sont ces fenêtres qui apparaissent quand vous êtes en train
1995 d'accomplir une opération de Copie/Déplacement/Lien/etc... La ligne de statut
1996 en haut de la fenêtre affiche le nom du dossier courant ou de l'objet en train
1997 d'être traité. L'espace qui se trouve en-dessous est là pour afficher les messages
1998 &mdash; ce qui a été fait, et éventuellement des questions.
1999
2000 <mediaobject>
2001  <imageobject>
2002   <imagedata align="center" format="PNG" fileref="../Action.png"/>
2003  </imageobject>
2004 </mediaobject>
2005   </para><para>
2006
2007 En bas, il y a quatre boutons, et quelques options. Toutes les fenêtres ont une
2008 option <guilabel>Silencieux</guilabel>. Quand elle est active, le filer ne demandera
2009 que quelques confirmations (par exemple, la suppression d'un fichier protégé en
2010 écriture). Mais dans la majorité des cas, toutes les opérations seront automatiques.
2011 </para><para>
2012
2013 Les boutons fonctionnent de cette manière :
2014
2015 <variablelist>
2016
2017 <varlistentry><term><guibutton>Oui</guibutton></term><listitem><para>
2018 répond oui à la question affichée.
2019 </para></listitem></varlistentry>
2020
2021 <varlistentry><term><guibutton>Non</guibutton></term><listitem><para>
2022 répond non à la question affichée.
2023 </para></listitem></varlistentry>
2024
2025 <varlistentry><term><guibutton>Annuler</guibutton></term><listitem><para>
2026 Stoppe l'opération en cours et ferme la fenêtre action.
2027 </para></listitem></varlistentry>
2028
2029 <varlistentry><term><guibutton>Silencieux</guibutton></term><listitem><para>
2030 est un raccourci pour activer l'option <guilabel>Silencieux</guilabel> puis
2031 cliquer sur <guibutton>Oui</guibutton>.
2032 </para></listitem></varlistentry>
2033
2034 </variablelist>
2035
2036 Vous pouvez préciser quelle(s) action(s) peut (peuvent) être démarrée(s)
2037 automatiquement (sans avoir à cliquer sur <guibutton>Silencieux</guibutton> au début) avec la
2038 commande <guimenuitem>Options...</guimenuitem>.
2039   </para>
2040
2041 <sect1>
2042   <title>Options des fenêtres action</title>
2043   <para>
2044
2045 Certaines actions ont des options, qui apparaissent sous forme de petites
2046 cases à cocher en bas de la fenêtre :
2047
2048 <itemizedlist>
2049
2050 <listitem><para>
2051 <guilabel>Forcer</guilabel> signifie que le filer ne va pas traiter différemment
2052 les fichiers spécifiés 'protégés en écriture'. Normalement, la suppression est
2053 confirmée même si <guibutton>Silencieux</guibutton> est enclenché.
2054 Notez que vous ne pouvez pas supprimer des fichiers présents dans des dossiers
2055 protégés en écriture car dans ce cas vous n'en avez pas la permission.
2056 </para></listitem>
2057
2058 <listitem><para>
2059 <guilabel>Bref</guilabel> évite au filer d'afficher un message à chaque fois
2060 qu'il fait quelque chose. Utilisez cette option si vous voulez augmenter la vitesse
2061 d'exécution de l'opération, si beaucoup de messages sont affichés.
2062 </para></listitem>
2063
2064 <listitem>
2065  <para>
2066   <guilabel>Récursif</guilabel> signifie que l'action appliquée à un
2067   dossier sera aussi appliquée à tout son contenu, ainsi qu'au contenu
2068   de ses sous-dossiers, et ainsi de suite.
2069  </para>
2070 </listitem>
2071
2072 <listitem>
2073  <para>
2074   <guilabel>Plus récent</guilabel> n'écrasera un fichier que si le fichier
2075   copié est plus récent que le fichier écrasé (date de modification).
2076  </para>
2077 </listitem>
2078
2079 </itemizedlist>
2080
2081 </para>
2082
2083  <para>
2084   Vous pouvez définir la valeur par défaut de ces options.
2085  </para>
2086 </sect1>
2087 </chapter>
2088
2089 <chapter id="searching">
2090   <title><anchor id="Searching" xreflabel="Searching"/>Chercher</title>
2091   <para>
2092
2093 La fonction Chercher recherche à travers tous les fichiers et les dossiers
2094 sélectionnés ainsi que tous les sous-dossiers (récursivement), les objets
2095 qui correspondent à une expression particulière.
2096 </para>
2097 <para>
2098  Choisissez la commande <guimenuitem>Chercher</guimenuitem> du menu <guimenu>Fichier</guimenu>
2099  pour chercher un fichier dans les objets sélectionnés. Si vous voulez sélectionner tous les fichiers
2100  d'un dossier qui correspondent à une quelconque expression, utilisez
2101  <guimenuitem>Sélectionner</guimenuitem> -> <guimenuitem>Sélectionner si...</guimenuitem>.
2102 </para>
2103 <para>
2104 Si vous connaissez le nom d'un fichier, entrez-le simplement dans l'espace
2105 'Expression :', entouré par des apostrophes.
2106 Par exemple, pour chercher un fichier nommé <filename>log</filename>, vous entrerez <userinput>'log'</userinput>.
2107
2108 Souvenez-vous qu'il faut utiliser des apostrophes, et pas des guillemets (") ni des apostrophes inversées (`) !.
2109 </para>
2110 <para>
2111  Au fur et à mesure que le filer trouve des objets qui correspondent, ils sont ajoutés
2112  à la liste des résultats.
2113  Si vous double-cliquez sur un des résultats, une fenêtre s'ouvrira pour vous montrer
2114  le dossier dans lequel celui-ci est enregistré.
2115  Le filer utilisera la même fenêtre pour afficher les dossiers qui correspondent aux
2116  autres résultats (donc si vous voulez garder des fenêtres différentes pour chaque
2117  résultat, vous devrez explicitement créer une nouvelle fenêtre (menu <guimenu>Fenêtre</guimenu>).
2118 </para>
2119
2120 <sect1>
2121   <title>Wildcards (les motifs génériques)</title>
2122   <para>
2123
2124 Vous pouvez aussi entrer des wildcards entre les apostrophes, par exemple :
2125
2126   <simplelist>
2127
2128     <member><command>'*.html'</command></member>
2129     <member><command>'Report.*'</command></member>
2130     <member><command>'Draft[1-5]'</command></member>
2131     <member><command>'main.[ch]'</command></member>
2132
2133   </simplelist>
2134
2135 Lisez la page man de <citerefentry><refentrytitle>glob</refentrytitle><manvolnum>7</manvolnum></citerefentry>
2136 (ndt : 'man 7 glob') si vous voulez en savoir plus sur les motifs génériques.
2137   </para><para>
2138 Si l'expression que vous entrez contient un slash ('/'), la recherche porte sur le chemin complet des objets,
2139 au lieu de ne porter que sur le nom de l'objet. Donc, <userinput>'*tmp*'</userinput> trouvera <filename>tmp</filename> et <filename>tmpfile</filename> mais pas
2140 <filename>/tmp/file</filename> &mdash; <userinput>'/*tmp*'</userinput> trouvera les trois.
2141   </para>
2142 </sect1>
2143
2144 <sect1>
2145 <title>Tests simples</title>
2146   <para>
2147 Le filer propose d'autres types de recherche (pas seulement par le nom).
2148 Notez que <emphasis>file</emphasis> est utilisé ici pour tout ce qui peut être
2149 dans le système de fichiers &mdash; y compris les répertoires, les devices et autres...
2150   </para>
2151   <para>
2152 Vous pouvez aussi utiliser une forme courte pour chaque test ; celle-ci est écrite entre parenthèses.
2153 Vous pouvez combiner plusieurs tests &mdash; <userinput>-rw</userinput> donnera le même résultat que
2154 <userinput>IsReadable and IsWriteable</userinput>.
2155 </para>
2156
2157 <itemizedlist><title>Ces expressions recherchent les objets par leur type :</title>
2158
2159 <listitem><para>
2160 <userinput>IsReg (-f)</userinput> correspond à un fichier normal.
2161 </para></listitem>
2162
2163 <listitem><para>
2164 <userinput>IsLink (-l)</userinput> correspond à un lien symbolique.
2165 </para></listitem>
2166
2167 <listitem><para>
2168 <userinput>IsDir (-d)</userinput> correspond à un dossier.
2169 </para></listitem>
2170
2171 <listitem><para>
2172 <userinput>IsChar (-c)</userinput> correspond à un 'character device'.
2173 </para></listitem>
2174
2175 <listitem><para>
2176 <userinput>IsBlock (-b)</userinput> correspond à un 'block device'.
2177 </para></listitem>
2178
2179 <listitem><para>
2180 <userinput>IsDev (-D)</userinput> correspond à un 'block device' ou à un 'character device'.
2181 </para></listitem>
2182
2183 <listitem><para>
2184 <userinput>IsPipe (-p)</userinput> correspond à un tube.
2185 </para></listitem>
2186
2187 <listitem><para>
2188 <userinput>IsSocket (-S)</userinput> correspond à un point de communication.
2189 </para></listitem>
2190
2191 </itemizedlist>
2192
2193 <itemizedlist><title>Celles-ci, par leurs permissions &mdash;
2194 voir la section <xref linkend="Permissions"/>.</title>
2195
2196 <listitem><para>
2197 <userinput>IsSUID (-u)</userinput> correspond aux fichiers qui ont le bit 'Set-UID' activé.
2198 </para></listitem>
2199
2200 <listitem><para>
2201 <userinput>IsSGID (-g)</userinput> correspond aux fichiers qui ont le bit 'Set-GID' activé.
2202 </para></listitem>
2203
2204 <listitem><para>
2205 <userinput>IsSticky (-k)</userinput> correspond aux fichiers qui ont le bit 'sticky bit' activé.
2206 </para></listitem>
2207
2208 <listitem><para>
2209 <userinput>IsReadable (-r)</userinput> correspond aux fichiers que vous pouvez lire.
2210 </para></listitem>
2211
2212 <listitem><para>
2213 <userinput>IsWriteable (-w)</userinput> correspond aux fichiers dans lesquels vous pouvez écrire.
2214 </para></listitem>
2215
2216 <listitem><para>
2217 <userinput>IsExecutable (-x)</userinput> correspond aux fichiers que vous pouvez exécuter.
2218 </para></listitem>
2219
2220 </itemizedlist>
2221
2222 <itemizedlist><title>Deux autres très utiles :</title>
2223
2224 <listitem><para>
2225                 <userinput>IsEmpty (-z)</userinput> trouve les fichiers vides (en fait, ceux dont la taille est de 0 octet).
2226 </para></listitem>
2227
2228 <listitem><para>
2229 <userinput>IsMine (-o)</userinput> trouve les fichiers dont vous êtes le propriétaire.
2230 </para></listitem>
2231
2232 </itemizedlist>
2233
2234 </sect1>
2235
2236 <sect1>
2237   <title>Opérateurs logiques</title>
2238   <para>
2239 Vous pouvez combiner les tests précédents pour effectuer des recherches avancées.
2240 Une expression est actuellement faite d'une liste de <emphasis>cas</emphasis>,
2241 séparés par des virgules. Le filer essaiera de trouver les correspondances pour
2242 chaque cas jusqu'à ce qu'un de ceux-ci fonctionne, ou jusqu'à ce qu'il n'y ait plus
2243 de cas.
2244 Par exemple, pour chercher des fichiers dont les extensions peuvent être différentes :
2245 <screen>'*.gif', '*.htm', '*.html'</screen>
2246
2247 Plus fort : chaque cas peut être une liste de conditions. Le cas ne fonctionne que si
2248 toutes les conditions sont respectées. Pour trouver un dossier nommé <filename>lib</filename> ou un fichier normal se terminant par <filename>.so</filename> :
2249
2250 <screen>IsDir 'lib', IsReg '*.so'</screen>
2251
2252 Vous pouvez inverser une condition en ajoutant un <userinput>!</userinput> devant, et vous pouvez utiliser une sous-expression
2253 comme expression, en l'entourant de parenthèses, comme ceci :
2254
2255 <screen>
2256 !(IsDir, IsReg)
2257
2258 !IsDir !IsReg
2259
2260 Not isdir and not isreg
2261
2262 !-d !-f
2263 </screen>
2264
2265 Ces 4 expressions signifient la même chose.
2266   </para>
2267 </sect1>
2268
2269 <sect1>
2270   <title>Comparaisons</title>
2271   <para>
2272 Vous pouvez aussi comparez des valeurs en utilisant les opérateurs
2273 <userinput>&lt;</userinput>,
2274 <userinput>&lt;=</userinput>,
2275 <userinput>=</userinput>,
2276 <userinput>!=</userinput>,
2277 <userinput>&gt;</userinput>, et
2278 <userinput>&gt;=</userinput>
2279 (inférieur à, inférieur ou égal à, égal à,
2280 différent de, supérieur à, supérieur ou égal à).
2281
2282 Quand vous comparerez des heures, vous trouverez certainement plus pratique d'utiliser
2283 <userinput>after</userinput> (ndt : après) et <userinput>before</userinput> (ndt : avant) au lieu de
2284 <userinput>&gt;</userinput> et <userinput>&lt;</userinput>.
2285   </para>
2286
2287 <itemizedlist><title>
2288 Ce qui suit peut être utilisé dans les comparaisons :
2289 </title>
2290
2291 <listitem><para>
2292 <userinput>atime</userinput> L'heure du dernier accès au fichier.
2293 </para></listitem>
2294
2295 <listitem><para>
2296 <userinput>ctime</userinput> L'heure du dernier changement du fichier.
2297 </para></listitem>
2298
2299 <listitem><para>
2300 <userinput>mtime</userinput> L'heure de la dernière modification du fichier.
2301 </para></listitem>
2302
2303 <listitem><para>
2304 <userinput>size</userinput> La taille du fichier.
2305 </para></listitem>
2306
2307 <listitem><para>
2308                 <userinput>inode</userinput> Le numéro d'index (i-n½ud) du fichier.
2309 </para></listitem>
2310
2311 <listitem><para>
2312 <userinput>nlinks</userinput> Le nombre de liens physiques (et pas symboliques).
2313 </para></listitem>
2314
2315 <listitem><para>
2316 <userinput>uid</userinput> L' 'User ID' du fichier.
2317 </para></listitem>
2318
2319 <listitem><para>
2320 <userinput>gid</userinput> Le 'Group ID' du fichier.
2321 </para></listitem>
2322
2323 <listitem><para>
2324 <userinput>blocks</userinput> Le nombre de blocs d'octets utilisés par le fichier.
2325 </para></listitem>
2326
2327 </itemizedlist>
2328
2329   <para>
2330 Les heures sont mesurées en secondes, avec un point de départ correspondant
2331 à 'Unix Epoch' (1er janvier 1970 à 00:00:00 UTC).
2332 Les tailles sont en octets. Quand vous utilisez des constantes pour comparer
2333 les valeurs, vous pouvez utiliser plusieurs mots-clés pour ajuster l'échelle
2334 de la valeur :
2335
2336 <itemizedlist>
2337
2338 <listitem><para>
2339 <userinput>Byte(s)</userinput> Sans effet, mais 'ça fait mieux' (ndt : byte signifie octet).
2340 </para></listitem>
2341
2342 <listitem><para>
2343 <userinput>Kb</userinput> multiplie par 1024, donc 2 Kb = 2048.
2344 </para></listitem>
2345
2346 <listitem><para>
2347 <userinput>Mb</userinput> multiplie par 1024<superscript>2</superscript>,
2348 soit 1024 Kb.
2349 </para></listitem>
2350
2351 <listitem><para>
2352 <userinput>Sec(s)</userinput> Sans effet, mais ça fait mieux aussi !
2353 </para></listitem>
2354
2355 <listitem><para>
2356 <userinput>Min(s)</userinput> multiplie par 60 pour obtenir des minutes.
2357 </para></listitem>
2358
2359 <listitem><para>
2360 <userinput>Hour(s), Day(s), Week(s), Year(s)</userinput> convertit dans l'unité précisée (ndt : heure(s), jour(s), semaine(s), année(s)).
2361 </para></listitem>
2362
2363 <listitem><para>
2364 <userinput>Ago</userinput> rend le temps passé relatif à l'heure à laquelle est effectué le test.
2365 </para></listitem>
2366
2367 <listitem><para>
2368 <userinput>Hence</userinput> rend le temps futur à l'heure à laquelle est effectué le test.
2369 </para></listitem>
2370
2371 <listitem><para>
2372 <userinput>Now</userinput> est un raccourci pour <userinput>0 Secs Hence</userinput>.
2373 </para></listitem>
2374
2375 </itemizedlist>
2376
2377 Quelques exemples rendront tout ceci plus clair !
2378
2379 <screen>
2380 mtime after 1 day ago
2381
2382 size &gt; 10 Mb
2383
2384 IsReg and nlinks &gt; 1
2385 </screen>
2386
2387 La première expression trouve les fichiers modifiés au cours des dernières
2388 24 heures (ndt : 'after 1 day ago', littéralement, veut dire 'après il y a
2389 un jour'). Vous pourriez utiliser <userinput>&gt;</userinput> au lieu de <userinput>after</userinput>,
2390 mais ce serait moins clair.
2391 </para>
2392 <para>
2393  La deuxième trouve les fichiers pesant plus de 10 Mb.
2394  La dernière trouve les fichiers normaux qui ont plus qu'un lien physique sur eux.
2395 </para>
2396 <para>
2397 Attention &mdash; le filer ne vérifie pas le contexte des opérateurs, donc
2398 <userinput>size &gt; 1 day ago</userinput> est admis (ndt : 'taille > 1 jour avant'), même si ça n'a pas de sens !
2399
2400 Pensez aussi aux mots-clés <userinput>ago</userinput> ou <userinput>hence</userinput> (ndt : 'il y a' et 'désormais'),
2401 car un oubli de ceux-ci pourrait causer des problèmes conséquents (le temps serait
2402 alors mesuré par rapport à l'Epoch au lieu de l'heure courante).
2403 Enfin, n'utilisez pas <userinput>=</userinput> avec les heures &mdash;
2404 <userinput>atime = 1 day ago</userinput> recherche un fichier accédé il y a
2405 <emphasis>exactement</emphasis> 86400 secondes...
2406
2407   </para>
2408 </sect1>
2409
2410 <sect1>
2411   <title>Divers</title>
2412   <para>
2413
2414 <itemizedlist>
2415
2416 <listitem><para>
2417 <userinput>System(commande)</userinput> exécute 'commande' sur le fichier. Le test
2418 réussit si la commande renvoie un code de retour 0 (zéro). Un caractère '%' dans
2419 'commande' est remplacé par le chemin complet du fichier traité.
2420 <userinput>System</userinput> est un test très lent, donc utilisez-le si possible
2421 en dernier dans vos expressions. Par exemple, si vous cherchez un fichier dont
2422 l'extension est <filename>.c</filename> et qui contient le mot 'main', utilisez :
2423
2424 <screen>
2425 '*.c' system(grep -q main "%")
2426 </screen>
2427
2428 pour que grep ne soit exécuté que pour les fichiers ayant pour extension <filename>.c</filename>
2429 (à opposer à une recherche des fichiers qui contiendraient le mot 'main', puis qui seraient du type <filename>.c</filename>.
2430 </para></listitem>
2431
2432 <listitem><para>
2433 <userinput>Prune</userinput> Ne réussit jamais !
2434 <footnote><para>Notez que c'est l'inverse de la commande <citerefentry><refentrytitle>find</refentrytitle><manvolnum>1</manvolnum>
2435 </citerefentry>.</para></footnote>
2436
2437 Ce mot-clé peut empêcher la recherche à l'intérieur du dossier courant.
2438 Souvenez-vous de l'ordre dans lequel le filer teste l'expression !
2439 </para></listitem>
2440
2441 </itemizedlist>
2442
2443 Exemples :
2444
2445 <screen>
2446 '*.old' system(rm '%')
2447
2448 'src' prune, '*.c'
2449 </screen>
2450
2451 La première expression supprime chaque fichier ayant pour extension <filename>.old</filename>.
2452 La seconde cherche les fichiers ayant pour extension <filename>.c</filename>, mais ne prend pas la peine
2453 de vérifier le contenu des dossiers nommés <filename>src</filename>.
2454 L'expression est évaluée comme suit :
2455 </para><para>
2456 Si un fichier est nommé <filename>src</filename>, alors `Prune'.
2457 D'autre part, vérifie s'il se termine par <filename>.c</filename>
2458 et dans ce cas, l'inclut dans les résultats.
2459   </para>
2460 </sect1>
2461 </chapter>
2462
2463 <chapter id="options">
2464   <title>Options</title>
2465   <para>
2466
2467 Vous pouvez configurer beaucoup de comportements de <application>ROX-Filer</application>.
2468 Choisissez pour cela <guimenuitem>Options...</guimenuitem> dans le menu d'une fenêtre du filer.
2469 La liste à gauche montre les différentes sections &mdash; cliquez sur celle de votre choix
2470 pour voir les options dont elle dispose.
2471
2472 Il y a deux boutons en bas de la boîte de configuration :
2473
2474 <itemizedlist>
2475
2476  <listitem>
2477   <para>
2478    <guibutton>OK</guibutton>
2479    sauve vos choix dans votre dossier Choices, pour que <application>ROX-Filer</application>
2480    les retrouve la prochaine fois qu'il sera exécuté.
2481    L'endroit exact où les choix sont sauvegardés est défini par la variable d'environnement
2482    <envar>CHOICESPATH</envar> &mdash; voir <citation>Choices</citation> pour plus de détails.
2483    Puisque tous vos choix prennent effet immédiatement, vous n'avez pas besoin de cliquer sur
2484    <guibutton>OK</guibutton> pour voir ce qui change.
2485   </para>
2486  </listitem>
2487
2488  <listitem>
2489   <para>
2490    <guibutton>Revenir</guibutton>
2491    Annule toutes les modifications effectuées depuis l'ouverture de la fenêtre Options.
2492    Ce bouton est grisé si vous n'avez effectué aucun changement.
2493    La boîte Options n'est pas fermée si vous utilisez ce bouton.
2494   </para>
2495  </listitem>
2496
2497 </itemizedlist>
2498
2499 Les options de la fenêtre Options proposent des bulles d'aide qui expliquent l'utilité
2500 de chacune d'entre elles ; maintenez votre pointeur de souris au-dessus d'une option
2501 pour voir ce qu'elle fait.
2502 </para>
2503 </chapter>
2504
2505 <chapter id="types">
2506  <title>Types de fichier</title>
2507  <para>
2508   Tous les fichiers ont un type MIME sous la forme <emphasis>text/plain</emphasis>. Ici,
2509   <emphasis>text</emphasis> est le <emphasis>type de media</emphasis> et <emphasis>plain
2510   </emphasis> est le <emphasis>sous-type</emphasis>.
2511  </para>
2512  <para>
2513   <application>ROX-Filer</application> utilise le nom d'un fichier pour décider si un
2514   fichier est d'un type MIME ou d'un autre, puis utilise le type MIME pour associer une
2515   icône et savoir quel programme exécuter quand vous ouvrez le fichier.
2516  </para>
2517
2518 <sect1>
2519  <title><anchor id="RunAction" xreflabel="the Set Run Action box"/>
2520   Fixer l'action d'exécution...
2521  </title>
2522  <para>
2523   Cette commande du menu Fichier est utilisée pour définir l'application à exécuter
2524   quand vous cliquez sur un fichier.
2525  </para>
2526  <para>
2527   Par exemple, admettons que vous vouliez que les <filename>.gif</filename> s'ouvrent
2528   automatiquement avec 'The Gimp'.
2529   D'abord, faites un clic droit sur une image gif pour ouvrir le menu, et choisissez
2530   la commande <guimenuitem>Fixer l'action d'exécution...</guimenuitem> dans le sous-menu
2531   <guimenuitem>Fichier</guimenuitem> (celui qui prend le nom du fichier sur lequel
2532   vous avez cliqué).
2533   Ensuite, vous pouvez fixer l'action d'exécution de deux façons différentes :
2534  </para>
2535
2536  <sect2>
2537   <title>Par drag-and-drop</title>
2538   <para>
2539    Déposez 'The Gimp' (depuis une fenêtre du filer, un panneau ou le punaiseur)
2540    sur l'aire où est inscrit <guilabel>Faites glisser ici une application
2541    appropriée</guilabel>.
2542    Maintenant, si vous cliquez sur une image gif, 'The Gimp' sera lancé automatiquement
2543    et ouvrira cette image.
2544   </para>
2545  </sect2>
2546
2547  <sect2>
2548   <title>En entrant une commande shell</title>
2549   <para>
2550    Tapez : <userinput>gimp "$@"</userinput> dans l'endroit <guilabel>Entrez une commande
2551    shell</guilabel> et appuyez sur <keycap>Entrée</keycap>. <userinput>$@</userinput>
2552    sera remplacé par le nom du fichier sur lequel vous cliquerez.
2553    Comme ci-dessus, 'The Gimp' sera lancé automatiquement et ouvrira cette image.
2554   </para>
2555  </sect2>
2556
2557  <sect2>
2558   <title>Définir les types de média par défaut</title>
2559   <para>
2560    Quelque soit la méthode que vous utilisez pour fixer l'action d'exécution,
2561    vous avez le choix de fixer celle-ci juste pour le type MIME du fichier,
2562    ou pour tous les fichiers ayant ce type et un sous-type différent et qui
2563    n'ont pas encore d'action par défaut.
2564   </para>
2565   <para>
2566    Puisque 'The Gimp' peut lire beaucoup de types d'images, il peut être intéressant
2567    de choisir l'option <guilabel>Mettre la valeur par défaut pour tout
2568    'image/&lt;quelconque&gt;'</guilabel> et ainsi vous n'aurez pas à le faire pour
2569    les fichiers image/jpeg et les autres...
2570    Cette option n'a d'effet que sur les types qui n'ont pas déjà une action définie
2571    (ie, ceux qui vous affichent un message d'erreur quand vous essayez de les ouvrir).
2572   </para>
2573  </sect2>
2574 </sect1>
2575
2576 <sect1>
2577  <title><anchor id="SetIcon" xreflabel="the Set Icon box"/>La boîte 'Fixer l'icône'</title>
2578  <para>
2579   Cette boîte apparaît quand vous choisissez la commande <guimenuitem>Fixer l'icône...
2580   </guimenuitem> du menu Fichier. Elle permet de définir une image pour représenter l'objet.
2581  </para>
2582  <para>
2583   Elle fonctionne un peu de la même façon que la boîte 'Fixer l'action d'exécution' décrite
2584   ci-dessus, sauf que vous pouvez affecter une icône pour un fichier précis (par son nom),
2585   ou pour tous les fichiers d'un type particulier. Si vous affectez une icône à un fichier
2586   précis, le filer enregistre les noms de ce fichier et de cette icône dans le dossier
2587   <filename>Choices</filename>. Si l'un ou l'autre est déplacé, l'icône ne sera plus affichée.
2588  </para>
2589  <para>
2590   Quand vous affectez une icône à un répertoire, vous avez la possibilité de copier cette icône
2591   dans le dossier lui-même, en tant que fichier caché.
2592   Les autres utilisateurs verront aussi cette icône, vous pouvez donc supprimer l'image originale
2593   après sa copie (notez que la taille de l'image est ajustée si nécessaire et convertie
2594   au format PNG).
2595  </para>
2596  <para>
2597   L'icône de dossier affichée dans la zone <guilabel>Faites glisser ici un fichier d'icône
2598   </guilabel> vous permet d'afficher un dossier qui contient déjà une ou plusieurs icônes
2599   dont vous vous servez.
2600  </para>
2601 </sect1>
2602
2603 <sect1>
2604  <title>Comment les types de fichier sont enregistrés</title>
2605  <para>
2606   <application>ROX-Filer</application> utilise deux sous-dossiers dans votre dossier Choices pour gérer
2607   les types de fichier :
2608   <variablelist>
2609    <varlistentry>
2610         <term><filename>MIME-types</filename></term>
2611         <listitem>
2612          <para>
2613           contient des liens symboliques, un par type MIME, qui pointent vers des programmes
2614           qui connaissent ce type de fichiers. Pour définir quel programme est exécuté quand vous
2615           cliquez sur un fichier, vous utilisez normalement la commande <guimenuitem>Fixer l'action
2616           d'exécution...</guimenuitem> (voir la section <xref linkend="RunAction"/>).
2617           Cependant, vous pouvez définir ces actions manuellement &mdash; par exemple, pour ouvrir
2618           un fichier HTML avec Netscape :
2619
2620           <orderedlist>
2621            <listitem>
2622                 <para>
2623                  Trouvez l'application Netscape et choisissez la commande <guimenuitem>Lier...</guimenuitem> dans le menu.
2624                 </para>
2625            </listitem>
2626
2627            <listitem>
2628                 <para>
2629                  Entrez <userinput>text_html</userinput> comme nom pour le lien et glissez l'icône du haut de la
2630                  boîte 'Lier' vers le dossier <filename>MIME-types</filename>.
2631                 </para>
2632            </listitem>
2633
2634           </orderedlist>
2635
2636           Vous pouvez aussi déposer dans ce dossier les programmes eux-mêmes, plutôt que des liens.
2637    </para>
2638  </listitem>
2639 </varlistentry>
2640
2641 <varlistentry><term><filename>MIME-icons</filename></term>
2642  <listitem>
2643   <para>
2644    contient les images utilisées pour afficher chaque type de fichier.
2645    Donc le filer essaiera d'afficher un fichier HTML en utilisant l'icône nommée
2646    <filename>MIME-icons/text_html.png</filename>.
2647   </para>
2648  </listitem>
2649 </varlistentry>
2650
2651 </variablelist>
2652
2653 Dans les dossiers <filename>MIME-types</filename> et <filename>MIME-icons</filename>,
2654 vous pouvez définir les actions/images par défaut pour chaque type de média.
2655 Par exemple, si <filename>text_html</filename> n'est pas trouvé, le filer
2656 essaiera simplement d'utiliser <filename>text</filename>.
2657
2658   </para>
2659   <para>
2660    Le filer cherche le type d'un fichier en fonction de son nom. Les règles sont définies dans
2661    plusieurs fichiers <filename>globs</filename> &mdash; voir <citation>SharedMIME</citation> pour
2662    plus de détails.
2663   </para>
2664  </sect1>
2665 </chapter>
2666
2667 <chapter id="appdirs">
2668   <title><anchor id="AppDir" xreflabel="Application directories"/>
2669     Dossiers-applications
2670   </title>
2671   <para>
2672 Un dossier-application est un dossier qui peut être exécuté comme une application.
2673 Il contient toutes les ressources d'une application &mdash; code source, binaires,
2674 documentation et autres. Tout enregistrer au même endroit rend l'installation et la
2675 désinstallation plus faciles pour les utilisateurs.
2676 Vous pouvez aussi garder plusieurs versions différentes d'un même programme
2677 en les enregistrant dans des dossiers-applications différents.
2678 Vous pouvez les déplacer et les renommer comme vous le voulez.
2679 Les dossiers-applications sont plus faciles à utiliser et à installer.
2680   </para><para>
2681 Ils sont aussi plus sûrs, parce que vous pouvez compiler une application en tant qu'utilisateur et
2682 ensuite simplement la copier en tant que root plutôt que de lancer en tant
2683 que root un script d'installation dans lequel vous n'avez pas confiance.
2684 Tout ce que vous avez à vérifier, ce sont les binaires avec le bit setuid.
2685   </para><para>
2686
2687 Les fichiers suivants ont une signification particulière pour <application>ROX-Filer</application> :
2688
2689 <itemizedlist>
2690
2691 <listitem><para>
2692 <filename>AppRun</filename>
2693 est exécuté quand vous cliquez sur le dossier &mdash; vérifiez qu'il est bien
2694 exécutable (utilisez la boîte pour changer les permissions) !
2695 </para></listitem>
2696
2697 <listitem><para>
2698 <filename>.DirIcon</filename>
2699 est l'image utilisée pour représenter le dossier (ceci fonctionne
2700 même s'il n'y a pas de fichier <filename>AppRun</filename>).
2701 </para></listitem>
2702
2703 <listitem><para>
2704 <filename>Help</filename>
2705 est le dossier qui s'ouvre quand vous choisissez <guimenuitem>Aide</guimenuitem>
2706 dans le menu Fichier.
2707 </para></listitem>
2708
2709 <listitem><para>
2710 <filename>AppInfo.xml</filename>
2711 contient des informations complémentaires sur l'application (voir ci-dessous).
2712 </para></listitem>
2713
2714 <listitem>
2715  <para>
2716   <filename>AppIcon.xpm</filename>
2717   est utilisée si <filename>.DirIcon</filename> est manquant (dans un but de compatibilité
2718   avec les anciennes versions ; n'est normalement plus utilisée dorénavant).
2719  </para>
2720 </listitem>
2721
2722 </itemizedlist>
2723
2724 Jetez un oeil au dossier-application de <filename>ROX-Filer</filename> pour avoir un exemple détaillé et complet.
2725   </para>
2726
2727 <note><para>Note : pour des raisons de sécurité, un dossier-application doit avoir le
2728                 même propriétaire que le fichier <filename>AppRun</filename> qu'il contient.</para></note>
2729
2730 <sect1>
2731   <title>Le fichier AppInfo</title>
2732   <para>
2733
2734 <filename>AppInfo.xml</filename> est un fichier XML avec la structure suivante (chaque élément est facultatif,
2735 ainsi que le fichier lui-même) :
2736
2737 <screen>
2738 &lt;?xml version="1.0"?&gt;
2739 &lt;AppInfo&gt;
2740  &lt;Summary xml:lang="en"&gt;A graphical file manager&lt;/Summary&gt;
2741  &lt;Summary xml:lang="de"&gt;Ein grafische Datei-Manager&lt;/Summary&gt;
2742  &lt;Summary xml:lang="nl"&gt;Een grafisch bestandsbeheerprogramma&lt;/Summary&gt;
2743  &lt;Summary xml:lang="es"&gt;Un manejador de archivos gr&#xE1;afico&lt;/Summary&gt;
2744  &lt;About xml:lang="en"&gt;
2745     &lt;Purpose&gt;File manager&lt;/Purpose&gt;
2746     &lt;Version&gt;1.3.5 PREVIEW&lt;/Version&gt;
2747     &lt;Authors&gt;Thomas Leonard and others&lt;/Authors&gt;
2748     &lt;License&gt;GNU General Public License&lt;/License&gt;
2749     &lt;Homepage&gt;http://rox.sourceforge.net&lt;/Homepage&gt;
2750  &lt;/About&gt;
2751  &lt;About xml:lang="es"&gt;
2752         &lt;Purpose&gt;Manejador de Archivos&lt;/Purpose&gt;
2753         &lt;Authors&gt;Thomas Leonard y otros&lt;/Authors&gt;
2754  &lt;/About&gt;
2755  &lt;AppMenu&gt;
2756         &lt;Item option="-p=Default"&gt;
2757           &lt;Label&gt;Enable pinboard&lt;/Label&gt;
2758           &lt;Label xml:lang="es"&gt;Habilitar el pinboard&lt;/Label&gt;
2759     &lt;/Item&gt;
2760         &lt;Item option="-p="&gt;
2761           &lt;Label&gt;Disable pinboard&lt;/Label&gt;
2762           &lt;Label xml:lang="es"&gt;Deshabilitar el pinboard&lt;/Label&gt;
2763         &lt;/Item&gt;
2764   &lt;/AppMenu&gt;
2765 &lt;/AppInfo&gt;
2766 </screen>
2767
2768 <itemizedlist>
2769
2770 <listitem><para>
2771 <userinput>Summary</userinput>
2772 est affiché dans une bulle d'aide quand la souris est maintenue au-dessus du dossier.
2773 </para></listitem>
2774
2775 <listitem><para>
2776 <userinput>About</userinput>
2777 contient une liste de champs qui sont affichés dans la boîte 'Info fichier'
2778 du dossier-application (n'importe quel nom peut être utilisé comme élément,
2779 ceux de l'exemple sont seulement suggérés).
2780 </para></listitem>
2781
2782 <listitem><para>
2783 <userinput>AppMenu</userinput>
2784 est une liste de commandes supplémentaires qui s'insèreront dans le menu du dossier-application.
2785 Quand une de ces commandes est choisie, <filename>AppRun</filename> est exécuté avec le nom de
2786 la commande <userinput>option</userinput>
2787 comme seul argument. Vous pouvez intégrer des menus 'AppMenu' à d'autres menus 'AppMenu' afin de
2788 créer des sous-menus, à condition qu'ils disposent d'un élément '$lt;Label$gt;'.
2789 </para></listitem>
2790
2791 </itemizedlist>
2792
2793   </para>
2794 </sect1>
2795 </chapter>
2796
2797 <chapter id="i18n">
2798   <title>Internationalisation</title>
2799   <para>
2800
2801   </para>
2802
2803 <sect1>
2804   <title><anchor id="LANG" xreflabel="Translations"/>
2805     Choisir une traduction
2806   </title>
2807   <para>
2808
2809 <application>ROX-Filer</application> est capable de traduire beaucoup de ses messages,
2810 pourvu que des fichiers de traduction corrects soient fournis :
2811
2812 <orderedlist>
2813 <listitem><para>Ouvrez la boîte d'options via le menu,</para></listitem>
2814 <listitem><para>Sélectionnez une langue,</para></listitem>
2815 <listitem><para>Cliquez sur <guibutton>Sauver</guibutton> et redémarrez le filer
2816 pour que les changements soient pris en compte.</para></listitem>
2817 </orderedlist>
2818
2819   </para>
2820 </sect1>
2821
2822 <sect1>
2823   <title>Créer une nouvelle traduction</title>
2824   <para>
2825
2826 <orderedlist>
2827 <listitem><para>Allez dans le dossier <filename>src</filename> et créez le fichier
2828 <filename>messages.pot</filename> :
2829
2830 <screen>
2831 $ cd ROX-Filer/src
2832 $ make messages.pot
2833 </screen>
2834
2835 </para></listitem>
2836
2837 <listitem><para>Copiez le fichier dans le sous-dossier <filename>po</filename>
2838 (du dossier <filename>src</filename>) en le nommant <filename>&lt;name&gt;.po</filename>.
2839 Ex : si votre langue est 'ml' ('ma langue') :
2840
2841 <screen>$ cp messages.pot po/ml.po</screen>
2842 </para></listitem>
2843
2844 <listitem><para>Ouvrez la copie dans un éditeur de texte.</para></listitem>
2845
2846 <listitem><para>Remplissez les traductions, qui sont toutes vierges au début.
2847 </para></listitem>
2848
2849 <listitem><para>Exécutez le script <filename>make-mo</filename> pour créer le
2850 fichier binaire que <application>ROX-Filer</application> pourra utiliser.
2851 Vous aurez besoin du paquetage GNU gettext pour effectuer cette opération.
2852 Si vous ne l'avez pas, envoyez-moi (ndt : pas à moi, à l'auteur du manuel !)
2853 simplement le fichier <filename>.po</filename> et je le convertirai pour vous.
2854
2855 <screen>
2856 $ cd ROX-Filer/src/po
2857 $ ./make-mo ml
2858 Created file ../../Messages/ml.gmo OK
2859 </screen>
2860
2861 </para></listitem>
2862
2863 <listitem><para>Éditez <filename>ROX-Filer/Options.xml</filename> pour que
2864 votre langue soit listée, redémarrez le filer et sélectionnez-la dans la
2865 boîte d'options (voir la section <xref linkend="LANG"/>).
2866 </para></listitem>
2867
2868 <listitem><para>Envoyez-moi le fichier <filename>.po</filename> pour que je
2869 puisse l'inclure dans les prochaines versions du filer.
2870 </para></listitem>
2871
2872 </orderedlist>
2873   </para>
2874 </sect1>
2875
2876 <sect1>
2877   <title>Mettre à jour une traduction existante</title>
2878   <para>
2879
2880 <orderedlist>
2881 <listitem><para>Allez dans le dossier contenant les fichiers <filename>.po</filename>
2882 et exécutez le script <filename>update-po</filename>.
2883 Celui-ci vérifie dans le code source s'il y a des phrases nouvelles ou
2884 modifiées et met à jour tous les fichiers de traduction.
2885
2886 <screen>
2887 $ cd ROX-Filer/src/po
2888 $ ./update-po
2889 </screen>
2890
2891 </para></listitem>
2892
2893 <listitem><para>Éditez le fichier à la main, comme pour une nouvelle traduction, en traduisant
2894 les nouveaux messages et en mettant à jour les autres.
2895 Regardez bien les entrées <computeroutput>fuzzy</computeroutput> que <command>update-po</command>
2896 a créées ; vérifiez que la traduction est correcte et supprimez la ligne <computeroutput>fuzzy</computeroutput>.
2897 </para></listitem>
2898
2899 <listitem><para>Exécutez <command>make-mo</command> comme la fois d'avant.</para></listitem>
2900
2901 <listitem><para>Soumettez-moi le fichier mis à jour.</para></listitem>
2902
2903 </orderedlist>
2904
2905 Lisez la page info de <command>gettext</command> pour de plus amples instructions sur la création de traductions.
2906
2907   </para>
2908 </sect1>
2909 </chapter>
2910
2911 <chapter id="hacking">
2912   <title>Hacking</title>
2913   <para>
2914 Ceci est un guide de base pour les personnes qui veulent modifier le code
2915 source. Si vous faites des changement utiles ou si vous corrigez des bugs,
2916 envoyez-moi les patches (Thomas Leonard) ou envoyez-les à la liste de
2917 diffusion. Dites-moi quelle version vous utilisez !
2918   </para>
2919
2920 <sect1>
2921   <title>Compiler</title>
2922   <para>
2923 La première fois que vous compilerez, vous devrez exécuter <command>AppRun --compile</command>,
2924 mais les fois suivantes, un <command>make</command> dans le dossier <filename>src</filename> quand vous changerez
2925 les fichiers <filename>.c</filename> et <filename>.h</filename> suffira.
2926 Vous voudrez peut-être exécuter aussi un <command>make depend</command>...
2927   </para>
2928 </sect1>
2929
2930 <sect1>
2931   <title>Créer et appliquer des patches</title>
2932   <para>
2933 Quand les développeurs apportent de petites modifications aux sources, ils
2934 les distribuent souvent sous forme de <emphasis>patches</emphasis> &mdash; souvent sur la liste
2935 de diffusion.
2936
2937 Pour appliquer un patch, allez dans le dossier <filename>src</filename> et exécutez
2938 la commande <command>patch</command> avec le nouveau patch. Recompilez ensuite :
2939
2940 <screen>
2941 $ cd ROX-Filer/src
2942 $ patch &lt; patchfile
2943 $ ../AppRun --compile
2944 </screen>
2945
2946 Vous pouvez retirer le patch en répétant simplement la séquence ci-dessus &mdash;
2947 <command>patch</command> détectera que le patch est déjà appliqué, et proposera de l'enlever.
2948   </para><para>
2949 Pour créer un patch vous devrez d'abord vous procurer la dernière version
2950 du filer sur CVS (les instructions pour l'utilisation de CVS peuvent être trouvées
2951 sur le site web).
2952 Modifiez le programme comme bon vous semble.
2953 Créez le patch en utilisant <command>cvs diff</command> depuis le dossier approprié :
2954
2955 <screen>
2956 $ cvs diff -u &gt; my_patch
2957 </screen>
2958
2959 Ceci crée un patch lisible par l'homme &ndash; et la machine. Soumettez-le
2960 à la liste de diffusion. Il est recommandé de poster des patches plutôt que
2961 les fichiers modifiés, pour plusieurs raisons :
2962
2963 <itemizedlist>
2964 <listitem><para>Ils sont plus petits. Ils sont donc plus rapides à télécharger
2965 par les gens qui n'ont pas de connexion à haut débit.
2966 </para></listitem>
2967
2968 <listitem><para>On peut voir ce qu'il y a dedans avant de les appliquer !
2969 </para></listitem>
2970
2971 <listitem><para>Les patches peuvent (souvent) être appliqués sur des versions
2972 légèrement modifiées des sources.
2973 Cela veut dire que plusieurs patches peuvent être appliqués sans que chaque
2974 nouveau n'écrase les autres.
2975 </para></listitem>
2976
2977 </itemizedlist>
2978
2979   </para>
2980 </sect1>
2981
2982 <sect1>
2983   <title>Autoconf</title>
2984   <para>
2985 Voici une explication rapide du système autoconf au cas où vous ne l'auriez
2986 pas déjà utilisé. Voir <command>info autoconf</command> pour plus de détails.
2987   </para><para>
2988 Un fichier nommé <filename>configure.in</filename> est fourni et contient
2989 plusieurs tests (<command>info autoconf</command>).
2990 Vous n'avez qu'à exécuter <command>autoconf</command> il lira ce fichier et
2991 générera un script shell pour effectuer les tests, en le sauvant sous le nom
2992 de <filename>configure</filename>.
2993 <filename>configure</filename> est normalement distribué avec le programme car
2994 tout le monde n'a pas autoconf.
2995   </para><para>
2996 Vous exécutez ensuite <filename>configure</filename> (en fait, laissez le script
2997 <filename>AppRun</filename> le faire car il lui passe quelques arguments), qui
2998 effectue tous les tests. Il lit <filename>Makefile.in</filename> et <filename>config.h.in</filename>
2999 et complète les valeurs manquantes avec les résultats des tests pour produire <filename>Makefile</filename>
3000 et <filename>config.h</filename>.
3001   </para><para>
3002 Exécutez <command>make</command>, qui créera les fichiers <filename>.o</filename>
3003 à partir des fichiers <filename>.c</filename> et les liens pour créer <filename>ROX-Filer</filename>.
3004   </para>
3005 </sect1>
3006
3007 <sect1><title>Structures de données</title>
3008  <para>
3009   Le fichier <filename>global.h</filename> contient les principales structures de données
3010   de ROX-Filer et explique la façon dont elles sont utilisées dans le code-source.
3011   C'est un bon point de départ si vous voulez comprendre son fonctionnement.
3012  </para>
3013 </sect1>
3014 </chapter>
3015
3016 <appendix id="compiling">
3017  <title>Compilation</title>
3018  <para>
3019          Si vous venez d'obtenir le filer en téléchargeant l'archive de ses sources,
3020          vous devez donc les compiler pour vous en servir. Si vous avez téléchargé et
3021          installé les binaires (le logiciel est donc déjà compilé), ou si
3022          <application>ROX-Filer</application> était déjà installé sur votre système,
3023          vous pouvez passer directement à la section suivante. Si vous êtes arrivés
3024          ici en cliquant sur l'icône représentant une bouée, ou si taper
3025          <command>rox</command> dans un XTerm fonctionne, vous n'avez pas besoin de
3026          compiler.
3027          <itemizedlist>
3028       <title>Pour compiler, vous aurez besoin de ce qui suit :</title>
3029           <listitem>
3030        <para>
3031         Unix ou Linux (le mot de passe root n'est pas nécessaire),
3032        </para>
3033       </listitem>
3034
3035           <listitem>
3036        <para>
3037         Le système 'X Window' (fourni en standard sur tous les systèmes modernes),
3038        </para>
3039       </listitem>
3040
3041       <listitem>
3042        <para>
3043         GTK+ 2.0.1 ou postérieure (bibliothèques et en-têtes) &mdash; dernière
3044                 version téléchargeable depuis <citation>GTK+</citation>,
3045        </para>
3046       </listitem>
3047
3048           <listitem>
3049        <para>
3050         LibXML 2.0.0 ou postérieure (bibliothèques et en-têtes)  &mdash; dernière
3051                 version téléchargeable depuis <citation>libxml</citation>,
3052        </para>
3053       </listitem>
3054
3055           <listitem>
3056        <para>
3057         Un compilateur C, comme 'gcc' (standard sur la plupart des systèmes).
3058        </para>
3059       </listitem>
3060
3061      </itemizedlist>
3062
3063      Tout ceci est standard sur la plupart des distributions Linux modernes.
3064          Pour vérifier quelle version de GTK+ est installée, utilisez la commande
3065          <command>pkg-config</command>, comme ceci (<prompt>$</prompt> est le prompt) :
3066
3067      <screen>$ pkg-config --modversion gtk+-2.0
3068       2.0.5</screen>
3069
3070     </para>
3071
3072         <procedure>
3073      <title>Pour compiler :</title>
3074
3075          <step>
3076       <para>
3077        Le filer utilise maintenant la base de données <citation>SharedMIME</citation>
3078            pour gérer les types MIME des fichiers. Vous devez installer cette base avant
3079            d'installer rox, sinon le filer ne fonctionnera pas correctement (ROX-Filer
3080            vous avertira lors de son démarrage si elle n'est pas installée).
3081       </para>
3082      </step>
3083
3084      <step>
3085       <para>
3086        Allez dans le répertoire qui contient le sous-répertoire ROX-Filer.
3087       </para>
3088      </step>
3089
3090      <step>
3091       <para>
3092        Exécutez le script d'installation <command>install.sh</command>, comme ceci :
3093
3094            <screen>
3095         $ ./install.sh
3096        </screen>
3097
3098       </para>
3099      </step>
3100
3101      <step>
3102       <para>
3103        <application>ROX-Filer</application> va effectuer quelques tests pour trouver
3104            sur quel type de système vous travaillez, puis va commencer la compilation.
3105            Si ça ne fonctionne pas, envoyez-moi un e-mail et plaignez-vous ! (ndt : plaignez-vous
3106            -en anglais- à l'auteur de ce manuel, pas à moi ;-)
3107            Dites-moi quel type de système vous avez et quels sont les messages d'erreur affichés.
3108            Si vous réussissez à régler le problème vous-même, envoyez-moi SVP un e-mail avec le correctif.
3109       </para>
3110           <para>
3111        Le fichier exécutable se trouve à l'intérieur du dossier ROX-Filer, dans un
3112        sous-répertoire différent pour chaque plate-forme. Ainsi, vous pouvez compiler
3113            la même application sur plusieurs types de machines différents et l'exécuter depuis
3114            n'importe laquelle en utilisant le script <filename>AppRun</filename>.
3115            C'est particulièrement utile dans un environnement réseau.
3116       </para>
3117      </step>
3118
3119      <step>
3120       <para>
3121        Une fois que le filer est compilé, vous allez devoir préciser où vous voulez l'installer.
3122            Si vous voulez effectuer une installation standard en root, vous devriez arrêter ici,
3123            passer en root (un <command>su</command> suffit), et relancer le script d'installation.
3124
3125        Si vous n'avez pas le mot de passe root, ne vous inquiétez pas &mdash; suivez simplement
3126            les instructions, pour installer le filer dans votre dossier personnel (home).
3127       </para>
3128      </step>
3129
3130     </procedure>
3131
3132     <para>
3133      Vous pouvez maintenant lancer le filer en exécutant la commande <command>rox</command>
3134          sans aucune option, comme ceci :
3135
3136          <screen>
3137       $ rox
3138      </screen>
3139
3140      Une fenêtre devrait apparaître et afficher le contenu du dossier courant.
3141          Si vous avez installé le script dans votre home, vous devrez sûrement mettre
3142          à jour votre variable d'environnement <envar>PATH</envar> pour que le shell
3143          puisse le trouver.
3144      Par exemple, si vous l'avez installé dans un dossier nommé <filename>bin</filename>
3145          dans votre home, tapez ceci :
3146
3147      <screen>$ PATH=$HOME/bin:$PATH; export PATH</screen>
3148
3149      ou (si vous utilisez le shell <citerefentry><refentrytitle>csh</refentrytitle>
3150      <manvolnum>1</manvolnum></citerefentry>) :
3151
3152      <screen>$ setenv PATH $HOME/bin:$PATH
3153       $ rehash</screen>
3154
3155     </para>
3156
3157 </appendix>
3158
3159 <appendix id="manpage"><title>Page de manuel</title>
3160
3161  <refentry id="rox">
3162
3163   <refmeta>
3164    <refentrytitle>ROX</refentrytitle>
3165    <manvolnum>1</manvolnum>
3166   </refmeta>
3167
3168   <refnamediv>
3169    <refname>ROX-Filer</refname>
3170    <refpurpose>Un gestionnaire de fichiers graphique et simple</refpurpose>
3171   </refnamediv>
3172
3173   <refsynopsisdiv>
3174    <cmdsynopsis>
3175         <command>rox</command>
3176         <arg choice="opt" rep="repeat"><option>OPTION</option></arg>
3177         <arg choice="opt" rep="repeat">FILE</arg>
3178    </cmdsynopsis>
3179   </refsynopsisdiv>
3180
3181   <refsect1><title>DESCRIPTION</title>
3182    <para>
3183         ROX-Filer est un gestionnaire de fichiers simple et pratique pour X11,
3184         l'interface graphique à base de fenêtres très utilisée sur les systèmes d'exploitation
3185         Unix et dérivés.
3186    </para>
3187    <para>
3188         C'est aussi le c½ur du ROX Desktop : <ulink url="http://rox.sourceforge.net"/>
3189    </para>
3190    <para>
3191         La commande <command>rox</command> ouvre tous les dossiers et/ou fichiers donnés en argument,
3192         ou seulement le répertoire courant si aucun argument n'est fourni.
3193    </para>
3194   </refsect1>
3195
3196   <refsect1><title>OPTIONS POUR LA LIGNE DE COMMANDE</title>
3197      <para>
3198             <variablelist>
3199
3200                      <varlistentry><term><option>-b</option></term><term><option>--bottom=PANEL</option></term>
3201                           <listitem><para>crée un panneau en bas de votre écran.
3202                          </para></listitem></varlistentry>
3203
3204                          <varlistentry><term><option>-c</option></term><term><option>--client-id=ID</option></term>
3205                           <listitem><para>utile pour la gestion de session.
3206                          </para></listitem></varlistentry>
3207
3208  <varlistentry>
3209   <term><option>-d</option></term><term><option>--dir=DIR</option></term>
3210   <listitem>
3211    <para>
3212         ouvre le dossier DIR en tant que répertoire (pas comme une application, même si ce dossier y ressemble).
3213    </para>
3214   </listitem>
3215  </varlistentry>
3216
3217   <varlistentry><term><option>-D</option></term><term><option>--close=DIR</option></term>
3218    <listitem><para>ferme le dossier DIR et tous ses sous-dossiers.
3219   </para></listitem></varlistentry>
3220
3221   <varlistentry><term><option>-h</option></term><term><option>--help</option></term>
3222    <listitem><para>affiche l'aide et une description des options.
3223   </para></listitem></varlistentry>
3224
3225   <varlistentry><term><option>-l</option></term><term><option>--left=PANEL</option></term>
3226    <listitem><para>crée un panneau à gauche de votre écran.
3227   </para></listitem></varlistentry>
3228
3229   <varlistentry><term><option>-m</option></term><term><option>--mime-type=FILE</option></term>
3230    <listitem><para>affiche le type MIME du fichier "FILE" et s'arrête.
3231   </para></listitem></varlistentry>
3232
3233   <varlistentry><term><option>-n</option></term><term><option>--new</option></term>
3234    <listitem><para>démarre un nouveau filer, même s'il y en a déjà un. Cette option interdit au filer
3235          de forker (s'exécuter en arrière plan), et n'est quasiment utile que pour débugger.
3236   </para></listitem></varlistentry>
3237
3238   <varlistentry><term><option>-p</option></term><term><option>--pinboard=PIN</option></term>
3239    <listitem><para>utilise le punaiseur PIN.
3240   </para></listitem></varlistentry>
3241
3242   <varlistentry><term><option>-r</option></term><term><option>--right=PANEL</option></term>
3243    <listitem><para>crée un panneau à droite de votre écran.
3244   </para></listitem></varlistentry>
3245
3246   <varlistentry><term><option>-R</option></term><term><option>--RPC</option></term>
3247    <listitem><para>lit et invoque SOAP RPC depuis l'entrée standard (voir <xref linkend="soap"/>).
3248   </para></listitem></varlistentry>
3249
3250   <varlistentry><term><option>-s</option></term><term><option>--show=FILE</option></term>
3251    <listitem><para>Ouvre une fenêtre et affiche le dossier où se trouve FILE.
3252   </para></listitem></varlistentry>
3253
3254   <varlistentry><term><option>-t</option></term><term><option>--top=PANEL</option></term>
3255    <listitem><para>crée un panneau en haut de votre écran.
3256   </para></listitem></varlistentry>
3257
3258   <varlistentry><term><option>-u</option></term><term><option>--user</option></term>
3259    <listitem><para>affiche le nom de l'utilisateur dans chaque fenêtre.
3260   </para></listitem></varlistentry>
3261
3262   <varlistentry><term><option>-v</option></term><term><option>--version</option></term>
3263    <listitem><para>Affiche les informations sur la version et s'arrête.
3264   </para></listitem></varlistentry>
3265
3266   <varlistentry><term><option>-x</option></term><term><option>--examine=FILE</option></term>
3267    <listitem><para>Le fichier FILE a changé ; il faut le réexaminer.
3268   </para></listitem></varlistentry>
3269
3270     </variablelist>
3271    </para>
3272   </refsect1>
3273
3274   <refsect1><title>NOTES</title>
3275        <para>
3276                 La documentation principale de ROX-Filer est accessible par la
3277                 commande <guimenuitem>Voir les fichiers d'aide</guimenuitem> du menu
3278                 Aide, ou par le bouton le plus à droite sur la barre d'outils.
3279           </para>
3280   </refsect1>
3281
3282   <refsect1>
3283    <title>LICENCE</title>
3284    <para>Copyright (C) 2003 Thomas Leonard.</para>
3285    <para>
3286         Vous pouvez redistribuer des copies de ROX-Filer si vous respectez les termes de la GNU General Public License.
3287    </para>
3288   </refsect1>
3289
3290   <refsect1>
3291    <title>BUGS</title>
3292    <para>
3293            Merci d'envoyer (en anglais) vos rapports de bugs à la liste de diffusion
3294            consacrée au développement : <ulink url="http://rox.sourceforge.net/contact.html"/>.
3295    </para>
3296   </refsect1>
3297   <refsect1>
3298    <title>AUTHORS</title>
3299    <para>
3300         ROX-Filer a été créé par Thomas Leonard, avec l'aide de :
3301    </para>
3302    <para>
3303         <simplelist columns='3'>
3304          <member>Michael Adams</member>
3305          <member>Christopher Arndt</member>
3306          <member>Jens Askengren</member>
3307          <member>Liav Asseraf</member>
3308          <member>Wilbert Berendsen</member>
3309          <member>Francesco Bochicchio</member>
3310          <member>Yuri Bongiorno</member>
3311          <member>Andrzej Borsuk</member>
3312          <member>Richard Boulton</member>
3313          <member>Simon Britnell</member>
3314          <member>Arnaud Calvo</member>
3315          <member>Babyfai Cheung</member>
3316          <member>Andrew Clover</member>
3317          <member>Fabien Coutant</member>
3318          <member>Couderc Damien</member>
3319          <member>Andreas Dehmel</member>
3320          <member>Micah Dowty</member>
3321          <member>Dmitry Elfimov</member>
3322          <member>Mattias Engdegard</member>
3323          <member>Andrew Flegg</member>
3324          <member>Olivier Fourdan</member>
3325          <member>Eric Gillespie</member>
3326          <member>Thierry Godefroy</member>
3327          <member>Olli Helenius</member>
3328          <member>Alex Holden</member>
3329          <member>Jasper Huijsmans</member>
3330          <member>Sigve Indregard</member>
3331          <member>Bernard Jungen</member>
3332          <member>Marcin Juszkiewicz</member>
3333          <member>James Kermode</member>
3334          <member>Jim Knoble</member>
3335          <member>Krzysztof Krzyzaniak</member>
3336          <member>Aaron Kurtz</member>
3337          <member>Vincent Ledda</member>
3338          <member>Vincent Lefèvre</member>
3339          <member>Victor Liu See-le</member>
3340          <member>Alexey Lubimov</member>
3341          <member>Krzysztof Luks</member>
3342          <member>Marcus Lundblad</member>
3343          <member>Anders Lundmark</member>
3344          <member>Jose Romildo Malaquias</member>
3345          <member>Denis Manente</member>
3346          <member>Brendan McCarthy</member>
3347          <member>Andras Mohari</member>
3348          <member>Christiansen Merel</member>
3349          <member>Jimmy Olgeni</member>
3350          <member>Richard Olsson</member>
3351          <member>Matthew O'Phinney</member>
3352          <member>Daniele Peri</member>
3353          <member>Andy Piper</member>
3354          <member>Marcelo Ramos</member>
3355          <member>Michel Alexandre Salim</member>
3356          <member>Adam Sampson</member>
3357          <member>Chris Sawer</member>
3358          <member>Christian Storgaard</member>
3359          <member>Taras</member>
3360          <member>Simon Truss</member>
3361          <member>Hirosi Utumi</member>
3362          <member>Jan Wagemakers</member>
3363          <member>Keith Warno</member>
3364          <member>Götz Waschk</member>
3365          <member>Stephen Watson</member>
3366          <member>Andre Wyrwa</member>
3367          <member>Geoff Youngs</member>
3368          <member>Diego Zamboni</member>
3369         </simplelist>
3370         </para>
3371         <para>
3372          et beaucoup d'autres ; le fichier <filename>Changes</filename> offre d'avantage d'informations !
3373     </para>
3374    </refsect1>
3375   </refentry>
3376 </appendix>
3377
3378 <appendix id="soap"><title>SOAP RPC</title>
3379
3380 <para>
3381  Quand le vous démarrer le filer, vous pouvez lui spécifier des arguments, sur la ligne de commande, pour contrôler son comportement.
3382  Il existe une alternative à ceci ; le filer vous permet de passer vos arguments sous la forme d'un message au format RPC <citation>SOAP</citation>.
3383  En fait, si vous utilisez les options de la ligne de commande, le filer les convertit en RPC SOAP en interne.
3384 </para>
3385
3386  <para>Tous les messages RPC SOAP passent par l'entrée standard, comme ceci :
3387
3388 <screen>
3389 $ rox --RPC &lt;&lt; EOF
3390 &lt;?xml version="1.0"?&gt;
3391 &lt;env:Envelope xmlns:env="http://www.w3.org/2001/12/soap-envelope"&gt;
3392 &lt;env:Body xmlns="http://rox.sourceforge.net/SOAP/ROX-Filer"&gt;
3393 &lt;Panel&gt;
3394 &lt;Name&gt;Default&lt;/Name&gt;
3395 &lt;Side&gt;Bottom&lt;/Side&gt;
3396 &lt;/Panel&gt;
3397 &lt;/env:Body&gt;
3398 &lt;/env:Envelope&gt;
3399 EOF
3400 </screen>
3401
3402 Les méthodes suivantes sont reconnues :</para>
3403
3404 <itemizedlist>
3405
3406  <listitem>
3407   <para>
3408    <function>Version</function>()
3409    Returns the filer's version.
3410   </para>
3411  </listitem>
3412
3413  <listitem>
3414   <para>
3415    <function>CloseDir</function>(<parameter>Filename</parameter>)
3416    Ferme le dossier <parameter>Filename</parameter> et tous ses sous-dossiers.
3417   </para>
3418  </listitem>
3419
3420  <listitem>
3421   <para>
3422    <function>Examine</function>(<parameter>Filename</parameter>)
3423    L'objet <parameter>Filename</parameter> a peut-être changé &mdash; vérifier
3424    et mettre à jour l'affichage.
3425   </para>
3426  </listitem>
3427
3428  <listitem>
3429   <para>
3430    <function>OpenDir</function>(<parameter>Filename</parameter>,
3431    [<parameter>Style</parameter>, <parameter>Details</parameter>, <parameter>Sort</parameter>, <parameter>Class</parameter>, <parameter>ID</parameter>])
3432    Ouvre une fenêtre et y affiche le dossier <parameter>Filename</parameter>.
3433    <parameter>Style</parameter> peut prendre la valeur <userinput>Large</userinput>,
3434    <userinput>Small</userinput>, <userinput>Huge</userinput> ou <userinput>Automatic</userinput>.
3435    <parameter>Details</parameter> peut prendre la valeur <userinput>None</userinput>,
3436    <userinput>ListView</userinput>, <userinput>Size</userinput>, <userinput>Type</userinput>,
3437    <userinput>Times</userinput> ou <userinput>Permissions</userinput>.
3438    <parameter>Sort</parameter> peut prendre la valeur <userinput>Name</userinput>,
3439    <userinput>Type</userinput>, <userinput>Date</userinput>, <userinput>Size</userinput>,
3440    <userinput>Owner</userinput> ou <userinput>Group</userinput>.
3441    Si une de ces options n'est pas renseignée, l'affichage par défaut est utilisé.
3442    <parameter>Class</parameter> peut être utilisé pour fixer la propriété WM_CLASS de la nouvelle fenêtre.
3443    Vous pouvez utiliser ceci pour que votre gestionnaire de fenêtres gère celle-ci d'une façon particulière.
3444    <parameter>ID</parameter> est une chaîne utilisée pour identifier la fenêtre ouverte.
3445 Si une fenêtre existe déjà avec cette ID, celle-ci est modifiée pour le nom du dossier ;
3446 sinon, une nouvelle fenêtre est créée et son ID lui est rattachée.
3447 Assurez-vous que les ID que vous générez sont uniques lorsque vous utilisez des scripts,
3448 en concaténant par exemple le nom du script, le PID et un horodatage pour former l'ID.
3449   </para>
3450  </listitem>
3451
3452  <listitem>
3453   <para>
3454    <function>Panel</function>(<parameter>Name</parameter>, <parameter>Side</parameter>)
3455    Ouvre le panneau nommé <parameter>Name</parameter> sur le côté de l'écran précisé en
3456    <parameter>Side</parameter> (<userinput>Top</userinput>|<userinput>Bottom</userinput>|
3457    <userinput>Left</userinput>|<userinput>Right</userinput> &mdash; NDT : Haut|Bas|Gauche|Droite).
3458    <parameter>Name</parameter> peut être un nom stocké dans <filename>Choices</filename>
3459    (par exemple <userinput>MonPanneau</userinput>), ou un chemin complet.
3460   </para>
3461  </listitem>
3462
3463  <listitem>
3464   <para>
3465    <function>PanelAdd</function>(<parameter>Side</parameter>,
3466         <parameter>Path</parameter>, [<parameter>Label</parameter>,
3467         <parameter>After</parameter>])
3468         Ajoute <parameter>Path</parameter> au panneau sur le côté <parameter>Side</parameter>,
3469         avec le libellé <parameter>Label</parameter>.
3470         Si <parameter>After</parameter> est fixé à <userinput>true</userinput>, l'icône sera alignée
3471         à droite (ou en bas) du panneau, sinon à gauche (ou en haut).
3472   </para>
3473  </listitem>
3474
3475  <listitem>
3476   <para>
3477    <function>Pinboard</function>([<parameter>Name</parameter>])
3478    Affiche sur le bureau le punaiseur nommé <parameter>Name</parameter>.
3479    <parameter>Name</parameter> peut être un nom stocké dans <filename>Choices</filename>
3480    (par exemple <userinput>MonPunaiseur</userinput>), ou un chemin complet.. S'il est
3481    omis, la fonction punaiseur est désactivée.
3482   </para>
3483  </listitem>
3484
3485  <listitem>
3486   <para>
3487    <function>PinboardAdd</function>(<parameter>Path</parameter>,
3488         <parameter>X</parameter>, <parameter>Y</parameter>, [<parameter>Label</parameter>])
3489         Ajoute <parameter>Path</parameter> au punaiseur à la position
3490         (<parameter>X</parameter>, <parameter>Y</parameter>), en le nommant <parameter>Label</parameter>.
3491   </para>
3492  </listitem>
3493
3494  <listitem>
3495   <para>
3496    <function>SetBackdropApp</function>(<parameter>App</parameter>)
3497    Définit <parameter>App</parameter> (un dossier-application) comme le "gestionnaire"
3498    du fond d'écran du punaiseur courant.
3499    Le fichier <filename>AppInfo.xml</filename> à l'intérieur de <parameter>App</parameter>
3500    doit contenir l'élément CanSetBackdrop, ie :
3501    <programlisting>
3502 &lt;?xml version="1.0"?&gt;
3503 &lt;AppInfo&gt;
3504           &lt;ROX:CanSetBackdrop xmlns:ROX="http://rox.sourceforge.net/SOAP/ROX-Filer"/>
3505 &lt;/AppInfo&gt;</programlisting>
3506          L'application sera exécutée avec l'option <option>--backdrop</option> comme seul argument
3507          après avoir invoqué cette méthode, et chaque fois que le punaiseur sera réactivé.
3508          N'UTILISEZ PAS cette méthode si vous invoquez l'option <option>--backdrop</option>, vous seriez
3509          bloqué dans une boucle sans fin !
3510          Voir <xref linkend="backdropapp"/> pour un guide sur l'écriture d'applications gèrant le fond d'écran.
3511   </para>
3512  </listitem>
3513
3514  <listitem>
3515   <para>
3516   <function>SetBackdrop</function>(<parameter>Filename</parameter>,
3517    <parameter>Style</parameter>)
3518    Définit l'image de fond d'écran. Si vous souhaitez régénérer l'image lors du prochain
3519    login de l'utilisateur, ou si vous voulez la changer automatiquement de temps en
3520    temps, utilisez plutôt <function>SetBackdropApp</function> ci-dessus.
3521   </para>
3522  </listitem>
3523
3524  <listitem>
3525   <para>
3526    <function>Run</function>(<parameter>Filename</parameter>)
3527    Exécute le fichier <parameter>Filename</parameter> comme s'il était cliqué dans une fenêtre du filer.
3528   </para>
3529  </listitem>
3530
3531  <listitem>
3532   <para>
3533    <function>Show</function>(<parameter>Directory</parameter>, <parameter>Leafname</parameter>)
3534    Ouvre le dossier <parameter>Directory</parameter> et met en évidence le fichier dont le nom
3535    est <parameter>Leafname</parameter>.
3536   </para>
3537  </listitem>
3538
3539  <listitem>
3540   <para>
3541    <function>FileType</function>(<parameter>Filename</parameter>)
3542    Affiche le type MIME du fichier <parameter>Filename</parameter> (en écrivant la
3543    réponse SOAP sur la sortie standard).
3544   </para>
3545  </listitem>
3546 </itemizedlist>
3547
3548 <para>
3549  Les appels suivants peuvent être utilisés pour commencer de nouvelles actions
3550  sur objets.
3551  <parameter>Quiet</parameter> (NDT : "Silencieux") est un booléen et peut prendre la valeur "vrai"
3552  (via <userinput>yes</userinput>, <userinput>true</userinput> ou <userinput>1</userinput>) si
3553  l'opération doit commencer immédiatement plutôt  que d'attendre la confirmation de l'utilisateur.
3554  S'il prend la valeur "faux" (via <userinput>no</userinput>, <userinput>false</userinput> ou
3555  <userinput>0</userinput>), l'utilisateur doit toujours confirmer.
3556  S'il est omis, la valeur par défaut est utilisée.
3557 </para>
3558
3559 <itemizedlist>
3560  <listitem>
3561   <para>
3562    <function>Copy</function>(<parameter>From</parameter>, <parameter>To</parameter>,
3563    [<parameter>Leafname</parameter>, <parameter>Quiet</parameter>])
3564    Copie tous les fichiers spécifiés en <parameter>From</parameter> vers le dossier spécifié
3565    en <parameter>To</parameter>. Si <parameter>Leafname</parameter> est précisé, <parameter>From</parameter>
3566    ne devra fournir qu'une seule entrée ; <parameter>Leafname</parameter> donnera alors le nouveau nom du fichier.
3567   </para>
3568  </listitem>
3569
3570  <listitem>
3571   <para>
3572    <function>Move</function>(<parameter>From</parameter>, <parameter>To</parameter>,
3573    [<parameter>Leafname</parameter>, <parameter>Quiet</parameter>])
3574    Déplace tous les fichiers spécifiés en <parameter>From</parameter> vers le dossier
3575    spécifié en <parameter>To</parameter>. Si <parameter>Leafname</parameter> est précisé,
3576    <parameter>From</parameter> ne devra fournir qu'une seule entrée ; <parameter>Leafname</parameter>
3577    donnera alors le nouveau nom du fichier.
3578   </para>
3579  </listitem>
3580
3581  <listitem>
3582   <para>
3583    <function>Link</function>(<parameter>From</parameter>, <parameter>To</parameter>, [<parameter>Leafname</parameter>])
3584    Crée un lien symbolique pour tous les fichiers spécifiés en <parameter>From</parameter>
3585    dans le dossier spécifié en <parameter>To</parameter>. Si <parameter>Leafname</parameter>
3586    est précisé, <parameter>From</parameter> ne devra fournir qu'une seule entrée ; <parameter>Leafname</parameter>
3587    donnera alors le nouveau nom du fichier.
3588   </para>
3589  </listitem>
3590
3591  <listitem>
3592   <para>
3593    <function>Mount</function>(<parameter>MountPoints</parameter>, [<parameter>OpenDir</parameter>,
3594    <parameter>Quiet</parameter>])
3595    Monte tous les dossiers spécifiés par <parameter>MountPoints</parameter>.
3596    Si <parameter>OpenDir</parameter> a la valeur <userinput>true</userinput>, tous les dossiers
3597    seront ouverts après leur montage.
3598   </para>
3599  </listitem>
3600 </itemizedlist>
3601 </appendix>
3602
3603 <bibliography>
3604   <title>References</title>
3605
3606 <bibliomixed>
3607   <abbrev>ROX</abbrev><citetitle>The ROX desktop,
3608   <ulink url="http://rox.sourceforge.net"/></citetitle>
3609 </bibliomixed>
3610
3611 <bibliomixed>
3612   <abbrev>RISC OS</abbrev><citetitle>RISC OS,
3613   <ulink url="http://www.riscos.com"/></citetitle>
3614 </bibliomixed>
3615
3616 <bibliomixed>
3617   <abbrev>GTK+</abbrev><citetitle>GTK+ Toolkit,
3618   <ulink url="http://www.gtk.org"/></citetitle>
3619 </bibliomixed>
3620
3621 <bibliomixed>
3622  <abbrev>libxml</abbrev><citetitle>The XML C library for Gnome
3623  <ulink url="http://www.xmlsoft.org"/></citetitle>
3624 </bibliomixed>
3625
3626 <bibliomixed>
3627   <abbrev>GNOME</abbrev><citetitle>The GNOME desktop,
3628   <ulink url="http://www.gnome.org"/></citetitle>
3629 </bibliomixed>
3630
3631 <bibliomixed>
3632   <abbrev>DND</abbrev><citetitle>The Drag and Drop protocol,
3633   <ulink url="http://www.newplanetsoftware.com/xdnd/"/></citetitle>
3634 </bibliomixed>
3635
3636 <bibliomixed>
3637   <abbrev>XDS</abbrev><citetitle>The X Direct Save protocol,
3638   <ulink url="http://www.newplanetsoftware.com/xds/"/></citetitle>
3639 </bibliomixed>
3640
3641 <bibliomixed>
3642   <abbrev>Choices</abbrev><citetitle>The ROX Choices system,
3643   <ulink url="http://rox.sourceforge.net/choices.html"/></citetitle>
3644 </bibliomixed>
3645
3646 <bibliomixed>
3647   <abbrev>AVFS</abbrev><citetitle>AVFS - A Virtual File System,
3648   <ulink url="http://sourceforge.net/projects/avf/"/></citetitle>
3649 </bibliomixed>
3650
3651 <bibliomixed>
3652  <abbrev>SOAP</abbrev><citetitle>Simple Object Access Protocol (SOAP) 1.2
3653   <ulink url="http://www.w3.org/TR/SOAP/"/></citetitle>
3654 </bibliomixed>
3655
3656 <bibliomixed>
3657  <abbrev>Imagettes</abbrev><citetitle>Thumbnail Managing Standard (Version 0.5)
3658   <ulink url="http://triq.net/~jens/thumbnail-spec/"/></citetitle>
3659 </bibliomixed>
3660
3661 <bibliomixed>
3662  <abbrev>Wallpaper</abbrev><citetitle>Wallpaper backdrop control application
3663   <ulink url="http://rox.sf.net/wallpaper.html"/></citetitle>
3664 </bibliomixed>
3665
3666 <bibliomixed>
3667  <abbrev>SharedMIME</abbrev><citetitle>Shared MIME-info Database (Version 0.8)
3668   <ulink url="http://www.freedesktop.org/standards/shared-mime-info-spec/"/></citetitle>
3669 </bibliomixed>
3670
3671 </bibliography>
3672 </book>