# ROX-Filer 2.10 - Manuel de l'utilisateur http://rox.sourceforge.net/Manual/Manual/Manual-fr.html

### Thomas Leonard

### Arnaud Calvo

Traduction française

Copyright © 2005 Thomas Leonard

Conditions

Rox-Filer est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Générale GNU, telle que publiée par la Free Software Foundation ; version 2 de la licence, ou encore (à votre choix) toute version ultérieure. Rox-Filer est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE ; sans même la garantie implicite de COMMERCIALISATION ou D'ADAPTATION À UN OBJET PARTICULIER. Pour plus de détails, voir la Licence Publique Générale GNU. Un exemplaire de la Licence Publique Générale GNU doit être fourni avec Rox-Filer ; si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.

NDT : Vous pouvez consulter une traduction non officielle de la Licence Publique Générale GNU à cette adresse : http://fsffrance.org/gpl/gpl-fr.fr.html.

Résumé

Note du traducteur : Je ne suis pas programmeur, les paragraphes 'Appliquettes pour les panneaux' et 'Structures de données' ont été traduits par Laurent Moussault `<laurent.moussault@9online.fr>`.

ROX-Filer est un gestionnaire de fichiers simple et pratique pour X11. Son interface utilisateur est basée sur le gestionnaire de fichiers de RISC OS et ses caractéristiques sont similaires ("dossiers-applications" et ouverture/enregistrement de fichiers par drag-and-drop). Le filer peut aussi jouer le rôle d'un punaiseur, vous permettant alors d'accrocher sur votre bureau les fichiers/répertoires/applications que vous utilisez fréquemment.

## Chapitre 1. Introduction

ROX-Filer est un gestionnaire de fichiers simple et pratique pour X11 — l'interface graphique à base de fenêtres très utilisé sur les systèmes d'exploitation Unix et dérivés. C'est aussi le cœur du ROX Desktop [ROX]. Beaucoup de fonctionnalités du filer ont été inspirées par RISC OS [RISC OS]. 'ROX' est un acronyme de 'RISC OS–On–X'.

## Fonctionnalités

XDND

  Un protocole pour le drag-and-drop utilisé, par exemple, par le desktop GNOME [GNOME]. Cela permet à des données d'être chargées dans une application par simple drag-and-drop depuis une fenêtre du filer. Les spécifications complètes sont données en [DND].

XDS

  Une extension de XDND qui permet aux applications d'enregistrer des données par drag-and-drop vers une fenêtre du filer. Les spécifications complètes sont données en [XDS].

Basedir spec

  Une façon simple, mais souple, de gérer les préférences des utilisateurs. Par défaut, celles-ci sont enregistrées dans ``~/.config`', mais vous pouvez utiliser la variable d'environnement `XDG_CONFIG_HOME` pour définir un autre emplacement. Voir [BaseDir] pour plus de détails.

Dossiers-applications

  Applications entièrement contenues dans un dossier, pour lesquelles l'installation consiste en la simple copie d'un dossier et la désinstallation, en la suppression de ce dossier. Une description plus détaillée est fournie plus loin.

Imagettes

  Le filer peut afficher les fichiers images avec une icône représentant le contenu de ceux-ci, au lieu d'une icône générique. Très utile pour organiser un dossier rempli de photos ! Voir [Imagettes] pour plus de détails.

Shared MIME Info Database

  Avant, chaque gestionnaire de bureau avait son propre système pour gérer les types de fichiers. La base de données des types MIME [SharedMIME] propose un standard pour que les différents gestionnaires de bureau n'utilisent plus qu'un seul système.

Thèmes (icônes)

  Des collections d'icônes, appelées 'thèmes', peuvent être installées dans ``~/.icons`'). Vous pouvez changer le thème utilisé dans la boîte Options. Lorsque d'autres 'Gestionnaires de bureaux' utiliseront la même technologie, les thèmes pourront alors être partagés avec ceux-ci. Voir [IconTheme] pour plus de détails.

Support DNotify (Linux seulement)

  Si le filer est utilisé avec un noyau Linux récent (i.e. 2.4.x), il mettra à jour automatiquement ses fenêtres. Sur d'autres systèmes, les dossiers seront mis à jour dès que le pointeur passera au-dessus.

## Chapitre 2. Arguments

Vous devriez pouvoir démarrer le filer en tapant la commande `rox`. S'il n'est pas encore installé, voyez Annexe A, Compilation.

Par défaut, ROX-Filer démarre en affichant le répertoire courant. Vous pouvez lui spécifier d'ouvrir d'autres dossiers à la place en les passant en arguments :

    $ rox /home /usr /usr/local

Vous pouvez aussi l'utiliser pour ouvrir des fichiers, comme ceci :

    $ rox README

Le filer accepte beaucoup d'options ; utilisez `-h` pour en obtenir la liste. Toutes les options ont une forme courte et une forme longue (e.g. : `-h` et `--help`) — bien que sur certains systèmes vous ne pouvez utiliser que les options courtes.

Notez que si la même version du filer est déjà lancée sur votre machine, alors, par défaut, elle sera utilisée pour ouvrir les dossiers et la nouvelle copie s'arrêtera immédiatement.

Pour obtenir la liste complète des options, voir Annexe B, Page de manuel.

## Punaiseur

Si vous voulez que le filer gère votre bureau vous utiliserez l'option `--pinboard` et fournirez un nom pour le punaiseur, e.g. :

    $ rox --pinboard=MonPunaiseur

La configuration du punaiseur est sauvée dans ``~/.config/rox.sourceforge.net/ROX-Filer/pb_MonPunaiseur`' dès que vous le modifiez (par exemple, en glissant/déposant un fichier sur votre bureau). Vous pouvez avoir autant de punaiseurs que vous le souhaitez et basculer de l'un à l'autre en lançant rox de nouveau, e.g. :

    $ rox --pinboard=MonAutrePunaiseur

Pour arrêter la fonction punaiseur, donnez au nom une chaîne vide :

    $ rox --pinboard=

Allez voir la section window manager notes si vous avez des problèmes d'affichage avec les icônes. Le punaiseur peut aussi être activé/désactivé en se plaçant dans le répertoire d'installation de ``ROX-Filer`' dans une fenêtre du filer et en choisissant Enable pinboard ou Disable pinboard dans le menu (clic droit).

## Panneaux

Les panneaux fonctionnent exactement de la même façon que les punaiseurs, mais ils correspondent à une barre, le long d'un des bords de l'écran. Pour créer un panneau :

    $ rox -b=MonPanneau

Le panneau devrait être affiché dans une fenêtre sans barre de titre. Si ça ne fonctionne pas, lisez la section window manager notes pour avoir quelques idées. Vous pouvez déposer des fichiers sur les 2 côtés du panneau, ils s'aligneront sur un côté ou sur l'autre. Les icônes des panneaux peuvent être repositionnées en les glissant avec le bouton du milieu. Les changements apportés au panneau sont automatiquement sauvegardés dans ``~/.config/rox.sourceforge.net/ROX-Filer/pan_MonPanneau`'. Comme pour le punaiseur, vous pouvez basculer entre plusieurs configurations de panneaux en relançant rox avec un nom de panneau différent.

    $ rox -b=MonAutrePanneau

Utilisez le menu contextuel pour choisir le côté sur lequel vous souhaitez positionner le panneau. Vous pouvez aussi utiliser le nom du côté ("bottom", "top", "left" ou "right"), au lieu de -b. Spécifiez une chaîne vide ("") pour ôter le panneau :

    $ rox --bottom=

## Notes sur les gestionnaires de fenêtres

Vous allez peut être avoir à configurer un peu votre gestionnaire de fenêtre pour que les icônes des punaiseurs et les panneaux s'affichent correctement (c'est-à-dire sans les bordures et sous les autres fenêtres). En particulier, vérifiez les options concernant les différentes "couches" (au-dessus, en dessous, premier, dernier, etc...) et affectez le punaiseur aux couches les plus basses.

### Sawfish / sawmill

Sawfish essaie de deviner si vous utilisez GNOME au démarrage et désactive certaines fonctions si c'est le cas. Vous devrez peut-être ajouter la ligne

    (require 'gnome)

à votre fichier ``.sawfishrc`' (lisez le manuel sawfish pour plus de détails).

### IceWM

Collez ces paramètres de configuration dans ``~/.icewm/preferences`' :

    # Manage root window (EXPERIMENTAL - normally enabled!)
    GrabRootWindow=1 # 0/1
    # Bitmask of root window button click to use in window manager
    UseRootButtons=3 # [0-255]
    # Desktop mouse-button click to show the menu
    DesktopWinMenuButton=1 # [0-20]
    # Desktop mouse-button click to show the window list
    DesktopWinListButton=2 # [0-5]
    # Desktop mouse-button click to show the window list menu
    DesktopMenuButton=0 # [0-20]

Et collez ceux-ci dans ``~/.icewm/winoptions`' :

    # ROX-Filer pinboard and panel
    ROX-Filer.icon: folder
    ROX-Panel.layer: Dock
    ROX-Panel.doNotCover: 1
    ROX-Panel.ignoreWinList: 1
    ROX-Panel.ignoreTaskBar: 1
    ROX-Panel.ignoreQuickSwitch: 1
    ROX-Pinboard.layer: Below
    ROX-Pinboard.ignoreWinList: 1
    ROX-Pinboard.ignoreTaskBar: 1
    ROX-Pinboard.ignoreQuickSwitch: 1
    ROX-Filer.layer: Normal

Redémarrez IceWM et le filer pour que les changements prennent effet.

### Window Maker

1. Démarrez le filer comme ceci : `rox -p=Default`

2. Appuyez sur Ctrl+Esc, ou faites un clic droit sur la barre de titre de n'importe quelle fenêtre. Choisissez Attributes....

3. La fenêtre Attributes Inspector apparaît. Choisissez Window Specification dans le menu, en haut (1er choix).

4. Cliquez sur le bouton Select window. Le curseur de la souris s'est transformé en double croix. Sélectionnez une des icônes du punaiseur de ROX-Filer. Les boutons radios dans le cadre Window Specification doivent maintenant être modifiés et afficher `ROX-Pinboard.ROX-Filer` pour le premier élément. Sélectionnez ce bouton radio.

5. Dans le menu du haut, revenez à Window Attributes. Dans le cadre Attributes, choisissez les caractéristiques que vous voulez donnez aux icônes du punaiseur ; je vous recommande celles-ci :

   - Disable titlebar

   - Disable resizebar

   - Disable close button

   - Disable miniaturize button

   - Keep at bottom (sunken)

   - Omnipresent

6. Toujours dans le menu du haut, choisissez Advanced Options. Dans le cadre Advanced, choisissez les options qui vous conviennent ; je vous recommande les suivantes :

   - Do not show in the window list

   - Ignore 'Hide Others'

   - Ignore 'Save Session' (éventuellement)

7. Quand vous aurez fini, cliquez sur Save, et fermez la fenêtre Attributes Inspector en cliquant sur le bouton X dans la barre de titre.

### Autres

Si rien ne fonctionne, essayez la section "Compatibilité" de la boîte d'options.

## Exécution en tant que root

Si vous utilisez le filer en tant qu'utilisateur 'root', le filer affiche un message en haut de chaque fenêtre pour vous le rappeler. L'utilisateur root a le droit d'accéder à tous les fichiers du systèmes, ainsi que de les modifier, soyez donc très vigilant quand vous utilisez le filer dans ces conditions. Normalement, vous devriez vous loguer en utilisateur ordinaire et vous changer en root que lorsque vous en avez besoin. Si sudo est installé et proprement configuré sur votre système, vous pouvez exécutera le filer de cette façon :

    $ sudo rox

Attention, souvenez-vous que tout ce que vous ferez sur n'importe quel fichier (y compris les applications que vous exécuterez depuis ces fenêtres) sera effectué avec les droits de root ! Soyez très prudent !

Vous aurez peut-être un message du serveur X window qui vous dira que root (ou d'autres utilisateurs) ne peut pas se connecter (ndt : "se connecter à X", ce qui veut dire que l'utilisateur root, par exemple, ne pourra lancer aucune commande qui utiliserait X). Une lecture des pages man pour xauth et xhost est donc conseillée, mais ce mécanisme varie selon les systèmes (c'est pourquoi ça n'est pas imtégré dans le filer !).

Note : La commande gnomesu peut aussi être utilisée pour exécuter le filer en tant que root, mais vous devrez employer setsid pour le démarrer dans une nouvelle session, sinon gnomesu le détruira avant qu'il n'ouvre la moindre fenêtre. Exemple :

    gnomesu -c 'setsid /usr/local/bin/rox /'

## Chapitre 3. Boutons de la souris et touches du clavier

Premier aperçu succinct :

- Faites un clic gauche [1] pour ouvrir fichiers et dossiers.

- Faites un clic droit pour obtenir un menu. Clic droit sur un fichier/dossier pour opérer une action sur celui-ci.

- Glissez-déposez des fichiers entre des fenêtres avec le bouton gauche pour les copier, les déplacer, les lier, etc... (action à choisir dans un menu). Lier crée un raccourci vers le fichier original.

Par défaut, l'affectation des boutons de la souris correspond aux conventions de l'environnement X. Ce comportement est toutefois hautement configurable — n'hésitez pas à essayer les différentes options possibles, dans l'espace de configuration du filer si vous n'aimez pas les options par défaut. Ces options induisent les comportements suivants :

Touche ou bouton de la souris | Action
--- | ---
Clic gauche | Ouvre le fichier ou le dossier cliqué. Maintenez enfoncé Ctrl pour sélectionner les objets au lieu de les ouvrir. Maintenez enfoncé Shift pour voir à l'intérieur des dossiers-applications, pour ouvrir les fichiers avec l'éditeur de texte, pour suivre les liens symboliques ou pour mieux gérer les points de montage (voir Removable devices).
Clic sur le bouton du milieu | Comme le bouton gauche, mais ouvre un dossier dans une nouvelle fenêtre ou ferme la fenêtre du filer en ouvrant un fichier.
Clic droit | Ouvre le menu principal. Maintenez enfoncé Ctrl en cliquant pour avoir directement le sous-menu de sélection. Maintenez enfoncé Shift pour accéder au menu Envoyer à... (voir la section Send To menu).

Drag and drop d'un objet (bouton gauche)

Affiche un menu vous permettant de choisir différentes actions. Vous pouvez désactiver cette fonction de menu via une option, ce qui permettra de copier par défaut le(s) fichier(s) dans la destination (un dossier-application ou une autre fenêtre du filer). Maintenez enfoncé Shift pour déplacer le fichier, Control+Shift pour créer un lien symbolique, ou Alt pour avoir un menu avec les différentes actions possibles.

Drag and drop d'un objet (bouton du milieu) | Comme ci-dessus, mais déplace toujours au lieu de copier ou de créer un lien symbolique. Il y a une option pour choisir ce comportement ou l'affichage d'un menu.

'Glissé' avec un bouton, mais pas au-dessus d'un autre objet

Sélectionne un groupe d'objets en les entourant avec un bouton de la souris enfoncé. Avec le bouton gauche, seuls les fichiers entourés seront sélectionnés. Si vous maintenez enfoncé Ctrl, les objets entourés seront ajoutés à la sélection. Si vous utilisez le bouton du milieu, alors les objets entourés seront désélectionnés s'ils étaient sélectionnés, et inversement.

Double-clic sur le fond d'une fenêtre | Redimensionne la fenêtre correctement (cette fonctionnalité peut être désactivée dans l'espace de configuration).
Backspace (touche 'retour en arrière') | Affiche le dossier père.
Touches de déplacement | Entoure les objets l'un après l'autre au fur et à mesure du déplacement.
Page Haut, Page Bas | Affiche les objets se trouvant une page plus haut ou une page plus bas.
Début, Fin | Affiche le premier/dernier objet du dossier.
Entrée | Comme un clic gauche sur l'objet. Vous pouvez maintenir enfoncé Shift pour modifier l'action, comme en cliquant. En maintenant Alt enfoncée, l'effet sera identique à un clic avec le bouton du milieu ; les dossiers s'ouvrent dans une nouvelle fenêtre, et l'ouverture d'un fichier provoque la fermeture immédiate du dossier.
Barre d'espace | Bascule l'objet actuellement entouré de l'état sélectionné à non-sélectionné (et inversement) et déplace le contour autour de l'objet suivant.
Tabulation, Shift+Tabulation | Déplace le contour vers l'objet sélectionné suivant/précédent.
Immobiliser la souris au-dessus d'un objet | Affiche une bulle d'aide avec une description rapide de l'application (si une description est fournie), avec la cible d'un lien symbolique, ou avec le nom complet d'un objet, si celui-ci est trop long pour être affiché en entier.

Si vous avez activé la possibilité de définir les touches de raccourcis-clavier, alors celles-ci peuvent facilement être choisies en ouvrant le menu (ndt : le menu qui contient la commande qui doit être exécutée lorsque vous utiliserez le raccourci-clavier), en positionnant le pointeur de la souris au-dessus de la commande désirée, et en pressant la (les) touche(s) devant servir de raccourci. La (les) touche(s) apparaît(ssent) maintenant dans le menu et peut(vent) désormais être utilisée(s) comme raccourci(s). Les touches de raccourcis sont automatiquement sauvées quand le filer est quitté. Vous pouvez utiliser un 'XSettings manager' tel que ROX-Session pour activer cette fonction pour toutes les applications Gtk+-2.0.

[1] Cette documentation suppose que le bouton–1 est le bouton gauche, le bouton–2 est le bouton du milieu et le bouton–3 est le bouton droit. Ce n'est pas toujours le cas — par exemple, dans une configuration pour gaucher.

## Chapitre 4. La sélection et les groupes de fichiers

Quand des objets sont sélectionnés dans une fenêtre ROX-Filer, le filer acquiert la "sélection primaire" (il copie leur nom). Vous pouvez alors les coller dans une autre fenêtre pour obtenir le chemin des objets sélectionnés.

Procédure 4.1. Par exemple, si vous voulez charger un fichier dans une application qui ne supporte pas le drag-and-drop :

1. Ouvrez la boîte 'Ouvrir...' de l'application.

2. Utilisez Ctrl et cliquez sur les fichiers dans une fenêtre ROX-Filer pour les sélectionner.

3. Cliquez avec le bouton du milieu dans la boîte 'Ouvrir...' pour y coller les noms. NDT : ça fonctionne aussi avec un XTerm...

Notez que la plupart des navigateurs internet ("web-browsers") ouvrent les fichiers dont vous "collez" les noms en cliquant avec le bouton du milieu n'importe où dans la page (sauf un lien, bien sûr...).

Si vous sélectionnez autre chose (par exemple du texte dans un autre programme), les objets sélectionnés dans la fenêtre du filer seront affichés grisés (car le filer n'aura plus la "sélection primaire"). Si vous cliquez sur un des objets grisés, vous redonnerez au filer la "sélection primaire".

## Enregistrer et restaurer la sélection

Il est parfois utile de sauvegarder la sélection courante pour une utilisation ultérieure. Vous pouvez en enregistrer 10 en appuyant sur Ctrl+<chiffre>. Vous pouvez restaurer une sélection en appuyant seulement sur le chiffre utilisé. 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.

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.

Procédure 4.2. Exemple : pour enregistrer un dossier et y retourner plus tard :

1. Vous avez un dossier affiché dans une fenêtre et vous souhaitez le "bookmarker". Appuyez sur Ctrl+1.

2. Affichez un autre dossier, ou fermez la fenêtre, ou... etc.

3. Appuyez sur 1 (NDT : Shift+1) dans n'importe quelle fenêtre pour retourner dans le dossier que vous avez enregistré.

Les groupes sont automatiquement enregistrés et seront donc accessibles pour une autre session du filer.

## Chapitre 5. La barre d'outils

Par défaut, chaque fenêtre affiche en haut une barre d'outils. Vous pouvez la désactiver (ou la rendre plus grande) dans l'espace configuration ('Options...'), et vous pouvez sélectionner les outils devant y apparaître. Normalement, vous devriez cliquer avec le bouton gauche (1). Mais beaucoup d'outils peuvent accomplir une fonction différente s'ils sont sollicités avec le bouton du milieu ou le bouton droit.

Icône | Bouton gauche (1) | Autre bouton
--- | --- | ---
Croix | Fermer la fenêtre | Ouvrir une nouvelle fenêtre
Flèche vers le haut | Affiche le dossier père | ... dans une nouvelle fenêtre[1]
Maison | Affiche le dossier "Home" | ... dans une nouvelle fenêtre[1]
Aller à | Affiche le Bookmarks menu | Édite les signets
Flèches tournantes | Rafraîchir | Ouvrir une nouvelle fenêtre
Loupe (+) | Sélectionne une taille d'icônes plus grande. | Sélectionne une taille d'icônes plus petite.
Loupe (zone) | Sélectionne le mode 'Taille automatique'. | -
Liste | Affiche/Masque le détail des objets | Idem
A..Z | Passe au critère de tri suivant. | Passe au critère de tri précédent.
Œil | Bascule entre l'affichage et le masquage des fichiers cachés (ceux dont le nom commence par un point) | Idem
Liste avec sélections | Sélectionne tout. | Inverse la sélection.
Bouée | Affiche les fichiers d'aide de ROX-Filer | Ouvre directement le manuel

[1] Si l'option 'Fenêtres uniques' est activée, l'action par défaut est d'ouvrir une nouvelle fenêtre — et cliquer avec l'autre bouton utilise la même fenêtre (le comportement du filer est inversé).

Glisser-déposer des objets sur les outils 'Flèche vers le haut' ou 'Maison', produit le même effet que de les glisser-déposer vers les dossiers auxquels ces outils mènent. Glisser-déposer sur l'outil 'Signets' créera un signet pour cet objet.

La barre d'outils peut aussi montrer le nombre de fichiers dans un dossier, et quelques informations sur la sélection. Ceci peut être activé/désactivé dans l'espace configuration ('Options...').

## Chapitre 6. Les menus

Vous pouvez ouvrir un menu en faisant un clic droit sur un punaiseur, un panneau ou une fenêtre de filer. Dans les fenêtres du filer, vous pouvez aussi utiliser \ pour ouvrir le menu. Il existe un raccourci pour afficher le sous-menu 'Fichier' directement : maintenez enfoncée la touche Ctrl en ouvrant le menu. Voici une description complète de toutes les commandes :

Commande | Action
--- | ---
Affichage | Pour modifier l'affichage.
Fichier | Opérations sur les objets sélectionnés.
Sélectionner | Pour contrôler quels objets sont sélectionnés.
Options... | Configure ROX-Filer.
Nouveau | Crée un nouveau fichier ou dossier à l'intérieur de ce dossier.
Fenêtre | Opérations diverses agissant sur la fenêtre.
Aide | Information sur le filer.

## Le menu Affichage

Commande | Action
--- | ---
Icônes | Les fichiers sont affichés sous forme de "lignes d'icônes", sans détail.
Icônes, avec... | Les fichiers sont affichés sous forme de "lignes d'icônes", avec des détails en plus (choisis dans le sous-menu). Pour voir toutes les informations sur chaque fichier, utilisez plutôt 'Liste'.
Liste | Affiche les fichiers et tous les détails. Cliquez sur le titre d'une colonne pour activer le tri correspondant à cette colonne (un nouveau clic inversera le tri).
Icônes plus grandes | Augmente la taille des icônes. Désactive le mode 'Automatique'.
Icônes plus petites | Diminue la taille des icônes. Désactive le mode 'Automatique'.
Automatique | Le filer choisit une taille d'icône adéquate pour la fenêtre active, lors de chaque changement de dossier, etc...
Trier par XXX | Définit le critère de tri. Dans la vue 'Liste', vous pouvez aussi définir le critère de tri en cliquant sur le titre des colonnes.
Inversé | Inverse l'ordre de tri (du plus récent au plus ancien, du plus gros au plus petit, etc...).
Montrer les fichiers cachés | Si cette option est activée, les objets commençant par un point sont affichés, sinon, ils sont cachés. La barre de titres affiche (All) quand cette option est activée.
Filtrer des fichiers... | Contraint ROX à n'afficher que les fichiers dont les noms correspondent à un certain motif. La barre de titre affichera (Glob (motif)) si un filtre est utilisé.
Filtrer les répertoires avec les fichiers | Applique aux répertoires également, le filtre défini dans Filtrer des fichiers....
Montrer les vignettes | Activée, le filer essaiera de lire chaque fichier-image et d'utiliser cette image comme icône pour ce fichier. Très utile quand vous avez un dossier rempli de photos et que vous en cherchez une dont le nom vous échappe ! Voir la section Thumbnails.
Rafraîchir | Relit le contenu du dossier et les détails de tous les fichiers s'y trouvant. Utilisez cette commande si l'affichage n'est plus à jour.
Sauver les options d'affichage... | Sauve les options d'affichage du dossier courant. Chaque fois que vous ouvrirez ce dossier, ces options seront utilisées.

### Permissions

Le champ permissions, quand il est affiché, est composé de quatre groupes de trois caractères. Chaque caractère est une lettre, si la permission à laquelle le caractère réfère est attribuée, sinon, ce caractère est un tiret (–). Les trois premiers caractères montrent les permissions pour le propriétaire du fichier, les trois suivants, pour les autres utilisateurs appartenant au groupe du fichier, les trois suivants, pour le reste du monde. L'utilisateur ayant démarré ROX-Filer se voit situé dans les permissions par leur soulignement. Les trois derniers caractères montrent les permissions spéciales.

Les lettres représentant les permissions ont la signification suivante :

- `r` — Permission de lire le contenu d'un fichier, ou le nom des fichiers d'un dossier.

- `w` — Permission de modifier le contenu d'un fichier, ou de changer le contenu d'un dossier (renommer un fichier, par exemple).

- `x` — Permission d'exécuter un fichier (un programme), ou de référer aux fichiers d'un dossier (nécessaire pour voir son contenu).

- `U` — Ce programme s'exécute avec l'identification de son propriétaire (user ID) plutôt qu'avec celle de l'utilisateur qui l'exécute.

- `G` — Ce programme s'exécute avec l'identification de son groupe (group ID), peut importe qui l'exécute.

- `T` — Les objets d'un tel dossier ne peuvent être supprimés que par les utilisateurs qui sont les propriétaires de ceux-ci, même si une permission d'écriture (w) existe sur le dossier.

Par exemple,

    rwx,rwx,r-x/---

signifie que le propriétaire de ce fichier est le même utilisateur que celui qui se sert de ROX-Filer (autrement dit, *vous* êtes le propriétaire de ce fichier), vous et tous les utilisateurs du groupe avez les droits de lecture, d'écriture et d'exécution ; quant au reste du monde, il peut lire et exécuter ce fichier. Il n'y a pas de 'permissions spéciales'. Les règles qui régissent l'application des permissions peuvent varier d'un système d'exploitation à un autre, mais elles peuvent être considérées comme suit :

- Si l'identité de l'utilisateur (user ID) qui utilise ROX-Filer est la même que celle du propriétaire du fichier, les permissions du propriétaire s'appliquent.

- Si l'identité du groupe (group ID) de l'utilisateur est la même que celle du groupe du fichier, OU si le groupe du fichier est le même qu'un des groupes auxquels l'utilisateur appartient, les permissions du groupe s'appliquent.

- Autrement, les 'autres' permissions s'appliquent.

## Le menu Fichier

Si vous ouvrez le menu alors que plusieurs objets sont sélectionnés, l'opération s'applique alors à tous ces objets. Si vous ouvrez le menu en cliquant droit sur un objet, alors qu'il n'y a pas de sélection, l'objet cliqué est alors temporairement sélectionné.

Si vous choisissez une commande du menu sélection sans qu'il n'y ait de sélection, vous entrez en mode 'cible' ; l'opération choisie s'appliquera au prochain objet choisi. Cliquez sur le fond de la fenêtre, appuyez sur Echap ou faites un clic droit pour sortir du mode 'cible'. Le mode 'cible' est surtout utile si vous utilisez l'option Navigation en simple clic ou pour utiliser avec des raccourcis claviers.

Notez que pour les dossiers-applications, il peut y avoir quelques commandes qui sont ajoutées au début de ce sous-menu quand vous cliquez sur ceux-ci — voir la section Application directories pour plus de détails. Vous pouvez créer des commandes supplémentaires qui apparaîtront en haut, en fonction du type de fichier sur lequel vous aurez cliqué. Pour cela, choisissez la commande Personnaliser. Par exemple, vous pourriez faire apparaître The Gimp pour toutes les images, et FreeFS pour les points de montage.

Commande | Action
--- | ---
Copier... | Copie cet objet.
Renommer... | Change le nom de cet objet, ou le déplace vers un autre dossier. Si plusieurs fichiers sont sélectionnés, la boîte The Bulk Rename window est affichée.
Lier... | Crée un lien symbolique vers cet objet.
Supprimer | Supprime tous les objets sélectionnés du dossier courant. Le contenu des sous-dossiers sera supprimé en premier. Supprimer un lien symbolique ne supprime que le lien, pas la cible de ce lien.

Shift Ouvrir

Ouvre les dossiers-applications comme s'il s'agissait de simples dossiers, ouvre les fichiers comme s'il s'agissait de simple texte brut, ou ouvre le dossier contenant la cible du lien symbolique sur lequel vous "shift-cliquez". Sur des points de montage, on peut noter des effets intéressants (voir Removable devices). C'est la même chose que de cliquer en maintenant Shift enfoncé. La commande du menu sélection prend alors le nom de la commande a effectuer.

Envoyer à... | Ouvre le menu 'Envoyer à...', ce qui permet d'envoyer les objets à une application. Voir la section Send To menu.
Fixer l'action d'exécution... | Cette commande vous permet de choisir l'application qui sera utilisée pour ouvrir les fichiers de ce type. Lire la section the Set Run Action box pour plus de détails.
Fixer l'icône... | Vous pouvez affecter une icône différente pour chaque fichier/dossier en utilisant cette commande — glissez-déposez simplement une icône sur the Set Icon box.
Propriétés | Affiche plus de détails sur l'objet. Vous pouvez aussi modifier les permissions d'accès à partir de cette boîte (la commande Permissions vous permet quant à elle d'appliquer des modifications sur plusieurs fichiers simultanément), ainsi que la cible d'un lien symbolique.
Compter | Fait le total de l'espace occupé par les objets sélectionnés. Le contenu des dossiers sélectionnés est aussi compté. Les liens symboliques sont comptés, mais pas leur cible.
Fixer le type... | Cette commande vous permet de changer le type MIME d'un fichier, seulement sur les sytèmes de fichiers qui bénéficient des "attributs étendus". Si vous utilisez un système de fichiers plus ancien, vous devrez renommer le fichier (ndt : son extension) pour changer son type MIME.
Permissions | Cette commande vous permet de changer les permissions des objets sélectionnés. Si vous ne devez changer les permissions que pour un fichier, vous pouvez utiliser la commande Propriétés, qui est plus simple.
Chercher | Cherche des fichiers en spécifiant différentes conditions — voir la section Searching.

Note à propos des liens symboliques : Un lien symbolique enregistre l'emplacement d'un autre fichier/dossier. Supprimer un lien symbolique n'affecte en rien la cible vers laquelle celui-ci pointe. Supprimer la cible rendra le lien symbolique inutile. Il y a deux types de liens symboliques — Relatif et Absolu. Un lien absolu enregistre le chemin complet de la cible (ex ``/home/fred/MonFichier`'). Un lien relatif enregistre le chemin relatif menant jusqu'à la cible (ex ``../fred/MonFichier`'). Si la cible est censée ne jamais être déplacée, utilisez un lien absolu (vous pourrez déplacer celui-ci), mais si vous pensez que la cible peut être déplacée (le lien devra l'être aussi...), alors optez pour un lien relatif.

## Le menu Sélectionner

Commande | Action
--- | ---
Tout sélectionner | Sélectionne tous les objets de cette fenêtre.
Oublier la sélection | Dé-sélectionne tous les objets de cette fenêtre.
Inverser la sélection | Dé-sélectionne tous les objets sélectionnés, et sélectionne tous les objets non sélectionnés.

Sélectionner par nom...

Ne sélectionner que les objets dont le nom correspond à un certain motif. Cette commande n'est pas aussi puissante que Sélectionner si... (cf. ci-dessous), mais elle est plus rapide à utiliser. Les fichiers sont sélectionnés automatiquement au fur et à mesure de la saisie. Le raccourci-clavier par défaut est ., ce qui vous permet de ne saisir que `.png` pour sélectionner tous les fichiers ``.png`', par exemple.

Sélectionner si... | Ne sélectionner que les objets qui correspondent à certains critères — voir la section Select If.

## Le menu Nouveau

Chaque commande de ce sous-menu ouvre une boîte pour créer un nouveau fichier ou un nouveau dossier. Il y a trois commandes de base ; les autres reflètent le contenu de votre dossier ``~/.config/rox.sourceforge.net/Templates`', s'il existe.

Commande | Action
--- | ---
Répertoire | Crée un nouveau répertoire.
Fichier vide | Crée un fichier vide.
Personnaliser le menu... | Affiche le dossier ``Templates`' pour que vous puissiez ajouter des éléments au menu.
<commandes supplémentaires> | Copie un fichier depuis votre dossier Templates.

Pour ajouter vos propres commandes, choisissez Personnaliser le menu... et enregistrez-y tous les fichiers que vous souhaitez. Chaque fichier de ce dossier apparaîtra dans le menu et la boîte qui s'ouvrira le copiera. Par exemple, vous pourriez créer une base pour un fichier HTML :

    <html>
      <head>
        <title>Ma Page</title>
      </head>
      <body>
        Le contenu.
      </body>
    </html>

Enregistrez ceci sous le nom ``index.html`' dans le dossier ``Templates`' et vous pourrez ainsi facilement créer de nouveaux fichiers HTML. Vous pouvez aussi y enregistrer des documents vides de toutes sortes d'applications (e.g. : une feuille de calcul, une lettre ou un fax, etc...).

Notez que pour l'instant, vous ne pouvez pas créer de raccourcis-clavier pour ces commandes personnalisées.

## Le menu fenêtre

Commande | Action
--- | ---
Père, nouvelle fenêtre | Ouvre une nouvelle fenêtre pour afficher le contenu du dossier père.
Père, même fenêtre | Comme ci-dessus, mais utilise la même fenêtre.
Nouvelle fenêtre | Ouvre une nouvelle fenêtre avec le même dossier courant.
Répertoire Home | Affiche le contenu de votre répertoire personnel.
Afficher les signets | Ouvre le menu des signets (voir Bookmarks menu).
Suivre les liens symboliques | Convertit le chemin affiché dans la barre de titre en son nom canonique. Par exemple, si ``/home/fred/lien`' est un lien symbolique pointant sur ``/usr/share/doc/`', cliquer le lien vous amènera dans ce dossier, et remonter avec la flèche vous ramènera dans ``/home/fred`'. Si vous aviez utilisé Suivre les liens symboliques, vous seriez revenu dans ``/usr/share`'.
Changer taille de la fenêtre | Ajuste la taille de la fenêtre à son contenu.
Fermer la fenêtre | Ferme la fenêtre.
Entrer un chemin... | Ouvre un "espace de saisie" pour ouvrir un autre dossier (voir section Minibuffer).
Commande shell... | Ouvre un "espace de saisie" pour exécuter une commande shell (voir section Minibuffer).
Xterm ici | Ouvre un xterm avec ce dossier comme dossier courant.
Remplacer par un xterm | Ouvre un xterm avec ce dossier comme dossier courant, et ferme la fenêtre du filer automatiquement.

## Le menu Aide

Commande | Action
--- | ---
Au sujet de ROX-Filer... | Affiche des informations sur le fichier. C'est la même chose que de localiser ROX-Filer dans une fenêtre du filer et de sélectionner Propriétés dans le menu Fichier.
Montrer les fichiers d'aide | Même chose que de localiser ROX-Filer et de sélectionner Aide dans le menu Fichier.
Manuel | Ouvre le manuel HTML correspondant à votre langue, ou la version anglaise si la traduction n'a pas été réalisée.

## Le menu 'Envoyer à...'

Le menu 'Envoyer à...' permet d'envoyer très facilement un (des) objet(s) à une application. Le filer cherche le dossier ``$XDG_CONFIG_DIRS/rox.sourceforge.net/SendTo`' (voir [BaseDir]) et liste son contenu dans ce menu.

Pour changer les applications qui apparaissent ici, vous pouvez utiliser la commande Personnaliser qui se trouve en bas du menu ; elle créera si nécessaire le dossier ``SendTo`' et l'ouvrira. Vous pouvez placer dans ce dossier des liens symboliques en glissant/déposant des applications et en choisissant Lier dans le menu qui apparaît.

L'affichage du menu 'Envoyer à...' via le menu principal est plutôt lent ; vous devriez l'ouvrir en cliquant sur un fichier avec le bouton droit en maintenant la touche Shift enfoncée.

### Afficher différentes applications selon les types MIME

Vous pouvez personnaliser votre environnement pour que, par exemple, seul "The Gimp" soit affiché quand une image est sélectionnée. Pour cela, créez un dossier caché dans ``SendTo`' nommé ``.image`', ou portant le nom d'un autre type MIME. Vous pouvez utiliser le nom complet d'un type MIME (par ex ``.image_png`') ou juste le "media type". Utilisez Propriétés sur un fichier pour connaître son type MIME.

Les objets créés dans ces dossiers cachés ne sont affichés que pour les fichiers correspondant au type MIME décrit par le nom dudit dossier. Si plusieurs fichiers sont sélectionnés, le dossier ``.group`' est alors utilisé.

## Le menu signets

Le menu signets trouve son utilité dans la mémorisation de chemins de dossiers souvent utilisés. Vous pouvez aussi ouvrir ce menu depuis le menu principal (dans le sous-menu Fenêtre) et vous pouvez donc y affecter un raccourci-clavier. Dans ce menu, vous pouvez choisir d'ajouter à la liste le dossier actuellement affiché, d'aller directement dans un des dossiers enregistrés, ou bien d'ouvrir une boîte de dialogue vous permettant de modifier cette liste. Dans cette boîte, vous pouvez retirer des dossiers de la liste, les classer (en utilisant les flèches ou en les faisant glisser) et modifier les chemins directement si vous le souhaitez.

Le sous-menu Récemment visités propose un historique des derniers dossiers affichés, dans lesquels vous pouvez vous rendre d'un simple clic. Le dossier actif, s'il est dans ce sous-menu, est désactivé puisque vous êtes déjà dans celui-ci.

## Chapitre 7. Le punaiseur et les panneaux

Les sections Pinboard support et Panel support expliquent comment activer/désactiver le punaiseur et les panneaux. Quand ils sont activés, vous pouvez déposer des objets dessus en les glissant depuis une fenêtre du filer. Cliquer sur un objet du punaiseur ou d'un panneau revient à cliquer sur l'objet auquel le premier fait référence (ndt : comme un lien). Vous pouvez aussi glisser-déposer les icônes du punaiseur et des panneaux comme des objets normaux, et pour les modifier, faites un clic droit dessus.

Vous pouvez arranger les icônes des panneaux en les faisant glisser avec le bouton du milieu. Dans les versions précédentes du filer, les icônes du punaiseur étaient aussi déplaçables avec le bouton du milieu ; ce n'est désormais plus possible, l'usage de celui-ci étant réservé au gestionnaire de fenêtres.

Vous pouvez affecter des raccourcis-clavier aux icônes des punaiseurs et des panneaux. Ils pourront être utilisés pour ouvrir rapidement des dossiers, des fichiers ou des applications, même si une autre fenêtre a le focus.

Tout changement apporté au punaiseur et aux panneaux est immédiatement enregistré. Si vous cliquez sur ces icônes en maintenant Ctrl enfoncé, vous les sélectionnerez/dé-sélectionnerez. Cliquez ailleurs sur le bureau pour tout dé-sélectionner.

### Important

Déposer des objets sur le punaiseur ou les panneaux NE LES COPIE PAS, cela crée seulement un raccourci vers l'objet original. Si vous effacez l'objet original, vous le perdez ! Supprimer une icône du punaiseur ou d'un panneau ne supprime que celui-ci. Ce comportement diffère de celui des autres gestionnaires de fichiers, en général...

## Les menus du punaiseur et des panneaux

Commande | Action
--- | ---
ROX-Filer | Affiche l'aide, la boîte des options, ou votre dossier personnel.
Fichier 'fichier' | Ouvre le même menu que le menu 'Fichier' du filer, mais en simplifié.
Éditer l'objet | Modifier le nom qui est affiché sous l'icône, ou le chemin de l'objet vers lequel pointe l'icône. Vous pouvez aussi assigner un raccourci-clavier à cet objet, et le vérouiller pour éviter de l'enlever accidentellement. Pour les programmes, vous pouvez préciser des arguments à passer.
Voir l'emplacement | Ouvre une fenêtre montrant le dossier où est enregistré l'objet original.
Enlever le(s) objet(s) | Supprime du punaiseur ou des panneaux les objets sélectionnés.
Image de fond... | Définit l'image de fond pour le punaiseur (voir ci-dessous). Disponible dans le menu du punaiseur seulement.
Options du panneau... | Définit le côté de l'écran utilisé par le panneau (commande disponible seulement dans le menu du panneau).

Si vous mettez en place les icônes par défaut pour plusieurs utilisateurs et que vous souhaitez créer une icône 'Home' qui pointe vers le dossier personnel de chaque utilisateur, créez une icône, choisissez Éditer l'icône et mettez ``~`' pour le chemin.

Notez que des applications peuvent ajouter des commandes au début de ce menu quand vous cliquez dessus — voir la section Application directories pour plus de détails.

## 'Appliquettes' pour les panneaux

ROX-Filer vous permet d'exécuter de petits programmes à l'intérieur des panneaux — ces programmes sont appelés appliquettes. Pour démarrer une appliquette, glissez-déposez-la sur un panneau, depuis une fenêtre du filer et au lieu de voir l'icône apparaître, vous verrez l'appliquette démarrer.

Procédure 7.1. Pour créer vos propres appliquettes (pour les programmeurs !) :

1. Créez un dossier pour l'appliquette (ex ``MonAppliquette`').

2. Utilisez la commande Fixer l'icône... pour créer une icône appelée ``.DirIcon`' à l'intérieur de ce dossier (celui-ci apparaîtra avec cette icône).

3. Créez-y un dossier ``Help`', qui sera affiché quand les utilisateurs choisiront Aide dans le menu.

4. Créez un exécutable appelé ``AppletRun`'. Lorsque le dossier de l'appliquette sera glissé sur un panneau, ROX-Filer lancera cet exécutable avec pour argument un identifiant XID, correspondant à une fenêtre-socket pour ce panneau. Vous pouvez utiliser l'identifiant pour créer une widget GtkPlug. Un tutoriel est disponible ici : http://rox.sourceforge.net/phpwiki/index.php/Tutorials/Applets

## Fenêtres iconifiées sur le punaiseur

Quand le punaiseur est utilisé, ROX-Filer peut afficher une icône pour chaque fenêtre iconisée (ou "réduite"). Vous pouvez activer/désactiver cette fonctionnalité dans la boîte Options. Les icônes des fenêtres réduites sont sur un fond semi-transparent et peuvent être déplacées à la souris. Si vous cliquez sur une de ces icônes, celle-ci reprendra la taille normale de l'application qu'elle représente. Quelques anciens gestionnaires de fenêtres ne sont pas compatibles avec cette fonctionnalité, et n'affichent donc pas ces icônes.

## L'image de fond

Vous pouvez choisir une image de fond pour le punaiseur en choisissant Image de fond... dans le menu du punaiseur (clic droit sur le bureau quand le punaiseur est activé).

Pour choisir une image, choisissez Centrer, Redimensionner, Étirer ou Paver pour le style, puis faites glisser une image dans l'emplacement prévu. Pour retrouver un bureau avec une simple couleur (définie dans la boîte Options), cliquez sur Effacer.

L'application [Wallpaper] peut être utilisée pour appliquer des effets avancés, comme choisir une nouvelle image aléatoirement toutes les heures, ou afficher une image de la Terre grâce au programme xearth, par exemple.

Pour les programmeurs... Si vous voulez créer une application qui gère le fond d'écran (par exemple pour choisir une image au hasard ou pour faire un diaporama), vous devez d'abord créer un dossier-application (voir Application directories).

Exécutée sans argument, l'application doit invoquer la méthode SOAP SetBackdropApp (voir Annexe C, SOAP RPC). Le filer ré-exécutera immédiatement l'application, cette fois avec l'option `--backdrop`.

Exécutée avec l'option `--backdrop`, l'application doit afficher le style et le nom de l'image utilisée sur sa sortie standard, ie :

    tile /tmp/image.png

`centre` et `scale` sont les 2 autres styles acceptés. Le filer va ensuite charger cette image et l'afficher. L'application ne gère pas l'affichage de l'image, elle indique seulement au filer quoi afficher.

Dans le cas d'une application qui choisirait une image aléatoirement, elle peut s'arrêter immédiatement. Si l'application a créé une image temporaire, elle doit lire la ligne "ok\n" sur son entrée standard avant d'effacer l'image.

Si l'application doit afficher une séquence d'images, elle doit toujours lire "ok\n", puis attendre jusqu'à ce que le moment soit venu d'afficher l'image suivante, afficher le nom du fichier, et ainsi de suite.

Le filer indiquera à l'application qu'elle doit s'arrêter en fermant les deux "flux" (entrée et sortie). L'application devra alors nettoyer et sortir proprement à ce moment. Vérifiez que SIGPIPE soit bien géré quand vous écrivez sur la sortie standard si vous devez supprimer des fichiers temporaires.

Voyez l'application [Wallpaper] pour un exemple détaillé (écrit en python).

## Chapitre 8. Périphériques amovibles

L'utilisation de périphériques amovibles avec ROX-Filer (tels que les lecteurs de disquettes et de CD-ROM) est relativement simple, mais il est toutefois important de bien comprendre ce que sont le montage et le démontage de périphériques.

Monter un périphérique implique l'affichage de son contenu dans le système de fichiers. Dans une installation courante, le dossier ``/floppy`' (NDT : le dossier ``/mnt/floppy`' est peut-être plus courant dans les distributions "grand public") est un dossier vide du disque dur. Le lecteur de disquettes est ensuite monté sur ce dossier, ce qui a pour effet d'afficher son contenu à l'intérieur de celui-ci. Par exemple, un fichier nommé ``Letter`' sur la disquette apparaîtra comme ``/floppy/Letter`'.

Les périphériques doivent être démontés avant d'être éjectés. Les démonter oblige le système à y écrire les données qui peuvent être encore en zone tampon. Si vous retirez un périphérique amovible sans le démonter, il pourra être endommagé. Les lecteurs de CD-ROM et de disquettes Zip bloquent généralement l'éjection quand le périphérique est monté afin que vous ne puissiez pas les éjecter accidentellement.

Afin de ne pas avoir à préciser à chaque fois quel périphérique doit être monté à quel endroit du système de fichiers, une liste est déjà établie et peut généralement être trouvée dans le fichier ``/etc/fstab`'. ROX-Filer affiche les points de montage qui y sont décrits (tel que ``/floppy`') mais non montés, avec des cercles gris translucides par-dessus leur icône.

Cliquer sur un de ces points de montage provoquera le montage du périphérique associé. Le cercle deviendra alors vert pour indiquer que le périphérique est monté. N'enlevez pas le périphérique si le cercle est vert ! Vous pouvez le démonter en cliquant (avec la touche Shift enfoncée) sur l'icône du dossier ``/floppy`'.

Vous pouvez aussi démonter un périphérique en fermant la fenêtre du dossier qui affiche son contenu (i.e., en fermant la fenêtre ``/floppy`') et en choisissant Démonter dans la boîte de dialogue qui s'affichera. Le filer ne vous proposera un tel démontage que s'il a aussi réalisé le montage.

Si vous voulez ouvrir un dossier sans monter le périphérique qui lui est normalement associé, (i.e., si vous voulez voir le contenu de ``/floppy`' sur le disque dur), vous pouvez cliquer sur le point de montage non monté avec la touche Shift enfoncée. Ce n'est généralement pas très utile, puisque ces dossiers sont souvent vides.

## Chapitre 9. Imagettes

Quand cette fonction est activée, le filer peut afficher les fichiers images avec une icône représentant le contenu de ceux-ci, au lieu d'une icône générique. Très utile pour organiser un dossier rempli de photos ! Vous pouvez activer cette fonction pour le dossier en cours en choisissant la commande Montrer les vignettes du menu Affichage. Vous pouvez aussi activer cette option par défaut dans la boîte Options. La barre de titres affiche (Imagettes) quand cette option est active.

Les vignettes sont enregistrées dans ``~/.thumbnails`' pour un affichage ultérieur plus rapide. Lors de l'affichage des vignettes, une barre de progression est présente en bas de la fenêtre. Vous pouvez stopper ce processus en cliquant sur le bouton Annuler, qui se trouve à côté de la barre de progression. Vous pouvez demander au filer qu'il crée des vignettes pour d'autres types de fichiers, comme les vidéos par exemple (i.e. en montrant la première image), grâce à un logiciel adéquat.

## Détails techniques

En mode 'Imagettes', ROX-Filer vérifie le dossier ``~/.thumbs/normal`' pour chaque fichier passé en revue. Si une vignette existe, il la charge et passe au fichier suivant.

Pour générer la vignette d'un fichier de type media/subtype, le filer recherche un exécutable nommé ``~/.config/rox.sourceforge.net/MIME-thumb/media_subtype`', en se rabattant sur ``~/.config/rox.sourceforge.net/MIME-thumb/media`' s'il ne le trouve pas. Si aucun des deux ne peut être trouvé et que le fichier est du type image/*, les routines internes sont alors utilisées. Si le fichier n'est pas du type image/*, la vignette ne sera pas générée.

Si l'exécutable est trouvé, il est démarré avec les paramètres

    thumbnailer /path/to/source/file /path/to/thumbnail pixel_size

.

Quand celui-ci est terminé, le filer essaie de charger ``/path/to/thumbnail`'. En cas d'échec, la vignette n'est pas montrée.

Notez les nombreuses étapes nécessaires ! ROX-Filer utilisera volontiers une vignette existante, même s'il ne sait pas comment celle-ci a été générée.

## Chapitre 10. Systèmes de fichier virtuel (VFS)

Certains types de fichier peuvent être représentés sous forme de dossier. Un exemple typique est le fichier zip, qui contient une structure complète et compressée d'un dossier. Il peut être très pratique d'ouvrir un tel fichier comme s'il s'agissait d'un vrai dossier ; c'est ce que vous permet de faire le système VFS.

Pour utiliser cette fonctionnalité, vous devez disposer d'un système comme AVFS [AVFS], qui permet au noyau d'intégrer directement le support de différents systèmes de fichiers virtuels.

Il y a différentes façons d'utiliser AVFS. L'exemple suivant montre comment l'utiliser avec un noyau Linux 2.6 et FUSE. Vous devez donc disposer d'un noyau qui gère FUSE, et le paquet 'libfuse-dev' doit être installé.

Procédure 10.1. Installer AVFS avec Linux 2.6

1. Téléchargez la version CVS d'AVFS (la version actuelle, datant de juillet 2005, est trop ancienne).

2. Compilez AVFS (`sh autogen.sh; ./configure; make`).

3. Déplacez-vous dans le sous-dossier ``avfs/fuse`' et exécutez `./compile.sh`.

4. Créez un point de montage : `mkdir ~/.avfs-mount`.

5. Démarrez AVFS : `./avfsd ~/.avfs-mount`.

6. Vous devez ensuite configurer ROX-Filer pour qu'il ouvre les fichiers zip (et autres archives) comme des dossiers, en utilisant AVFS. Fixez l'action d'exécution pour un fichier archive de cette manière (Fixer l'action d'exécution...) :

       rox ~/.avfs-mount/"$1#"

Notez bien que toutes les étapes ci-dessus doivent être suivies en tant que simple utilisateur, pas en tant que root. Vous devrez peut-être faire partie d'un groupe particulier pour utiliser FUSE (vérifiez le groupe de ``/usr/bin/fusermount`').

Si vous ne voulez pas AVFS comme action principale pour ces fichiers, vous pourriez créer un script se résumant à la commande ci-dessus et l'ajouter au menu Fichier, via la commande Personnaliser le menu....

## Chapitre 11. Le mini-buffer

Le mini-buffer est une barre blanche qui apparaît le long de la fenêtre du filer, en bas, et qui vous permet d'entrer du texte. Pressez Echap pour vous en débarrasser. Le mini-buffer se comporte différemment, selon la manière dont il a été appelé :

## Entrer un chemin...

Vous pouvez taper un chemin, directement. Au fur et à mesure que vous tapez, l'affichage de la fenêtre est mis à jour pour vous montrer l'objet qui correspond à ce que vous êtes en train de taper. L'utilité de cette commande réside dans la recherche d'un fichier dans un dossier très fourni, mais vous pouvez vous en servir pour passer directement à un autre dossier, ou pour coller un chemin complet que vous aurez copié depuis une autre fenêtre.

Touche | Action
--- | ---
Entrée | Ouvre l'objet sélectionné.
Tabulation | Complétion "à la shell" (comme dans xterm).
Haut, Bas | Sélectionne graphiquement la correspondance précédente/suivante.

Si vous commencez à taper un nom commençant par un '.', la commande Montrer les fichiers cachés est temporairement activée pour que les fichiers puissent être affichés.

La complétion essaie de trouver le maximum de caractères possibles. Par exemple, s'il y a deux fichiers dans un même dossier qui s'appellent ``save-mail-nov-1999`' et ``save-mail-dec-1999`', alors le simple fait de taper `save` et de presser la touche Tabulation développera `save` en `save-mail-` et bipera pour indiquer que la correspondance n'est pas complète. Si vous utilisez la complétion sur un dossier et qu'il est unique, le filer va automatiquement afficher celui-ci. Ce comportement doit rappeler quelque chose aux utilisateurs du shell.

Admettons que vous vouliez trouver la documentation de Wine dans le dossier ``/usr/share/doc`' (qui est habituellement très chargé). Voici comment vous pourriez faire :

1. Ouvrez le mini-buffer en choisissant la commande Entrer un chemin... du menu Fenêtre, ou, si vous n'avez pas modifié le raccourci-clavier par défaut, pressez /.

2. Pressez CTRL+A pour sélectionner l'entrée par défaut.

3. Tapez `u<Tab>sh<Tab>do<Tab>wi<Tab>`. Au fur et à mesure que vous tapez, les dossiers seront ouverts automatiquement. Si un bip retentit quand vous pressez la touche Tab, vous devez taper une lettre de plus (car il y a plusieurs correspondances), ou presser Entrée.

## La commande shell

Cette fonction vous permet d'entrer rapidement des commandes shell si vous ne voulez pas ouvrir d'xterm. Si vous ne savez pas ce que sont des "commandes shell", passez à la section suivante !

Tapez simplement la commande et pressez Entrée pour l'exécuter. Les touches Haut et Bas rappellent les commandes précédentes. Tab effectue toujours la complétion. Cliquer sur un objet insère son nom dans le mini-buffer. Si plusieurs objets sont sélectionnés, ils sont assignés aux paramètres `$1`, `$2`, etc.

Ouvrir le mini-buffer alors que des objets sont sélectionnés ajoute `"$@"` à la fin de la commande — ce qui remplace le nom des objets sélectionnés.

Exemples :

Pour "détarer" une archive ``.tgz`' :

1. Ouvrez le mini-buffer en choisissant la commande Commande shell... du menu Fenêtre. J'utilise habituellement le raccourci ! pour cette commande.

2. Tapez `tar xzf` et cliquez sur le fichier. L'espace entre les options de tar et le nom du fichier est automatiquement inséré.

3. Pressez Entrée pour exécuter.

Pour imprimer tous les fichiers sélectionnés :

1. Choisissez la commande Commande shell.

2. Tapez `lpr` au début de la ligne et pressez Entrée.

Notes

- Attention : aucune confirmation n'est demandée ! Si vous doutez, commencez votre commande par `xmessage`, ce qui provoquera un affichage, plutôt qu'une exécution.

- C'est sh qui est toujours utilisé (principalement à cause de la façon dont bash et csh traitent les paramètres positionnels). De toute façon, `PATH` est cherché, donc vous pouvez toujours utiliser un autre shell si vous le voulez, en le nommant sh et en le mettant dans votre `PATH`.

- Les commandes sont exécutées en arrière-plan, donc vous pouvez faire : sleep 240; xmessage Time to go!

## Sélectionner si...

Utilisez cette commande si vous voulez sélectionner des objets correspondant à certains critères.

Par exemple, pour sélectionner tous les fichiers "pesant" plus de 5 Mb :

1. Choisissez la commande Sélectionner si... (raccourci-clavier par défaut : ?).

2. Tapez `Size > 5Mb` et pressez la touche Entrée.

Tous les fichiers (et seulement eux) plus gros que 5 Mb seront sélectionnés. Les expressions que vous pouvez utiliser ici sont du même style que celles décrites à la section Searching, sauf que `prune` n'a aucun effet, puisque le contenu des dossiers n'est jamais vérifié. Vous pouvez utiliser Tab pour passer d'un objet sélectionné à un autre, en boucle.

## Chapitre 12. Renommer des fichiers en masse

Si vous devez renommer un nombre important de fichiers, vous vous apercevrez vite qu'il est fastidieux de les renommer un par un. Solution : sélectionnez-les tous et choisissez Renommer... dans le menu, ce qui fera apparaître la fenêtre de renommage en masse.

Cette fenêtre vous montre deux colonnes. La colonne Ancien nom affiche le nom actuel de tous les fichiers sélectionnés, et la colonne Nouveau nom affiche le nouveau nom, qui est le même au début de la procédure de renommage en masse.

Vous pouvez changer les nouveaux noms de deux façons différentes. Vous pouvez cliquer directement sur le nom du fichier à modifier, ou utiliser la fonction de recherche et de remplacement en haut de la fenêtre. Vous devez utiliser une expression régulière dans le champ de recherche, et du texte dans le champ de remplacement, qui remplacera ce qui aura été trouvé par l'expression régulière. Par exemple, vous voulez renommer tous vos fichiers qui ont une extension ``.htm`' avec une extension ``.html`' : utilisez `\.htm$` dans le champ Remplacer : et `.html` dans le champ par :. Quand vous cliquez sur Appliquer, la colonne "Après" est mise à jour pour afficher les nouveaux noms proposés (mais aucun fichier n'est encore renommé).

Après avoir vérifié que les nouveaux noms vous paraissent corrects, cliquez sur Renommer pour effectuer le renommage en masse.

## Chapitre 13. Les fenêtres action

Les fenêtres action sont ces fenêtres qui apparaissent quand vous êtes en train d'accomplir une opération de Copie/Déplacement/Lien/etc... La ligne de statut en haut de la fenêtre affiche le nom du dossier courant ou de l'objet en train d'être traité. L'espace qui se trouve en-dessous est là pour afficher les messages — ce qui a été fait, et éventuellement des questions.

En bas, il y a quatre boutons, et quelques options. Toutes les fenêtres ont une option Silencieux. Quand elle est active, le filer ne demandera que quelques confirmations (par exemple, la suppression d'un fichier protégé en écriture). Mais dans la majorité des cas, toutes les opérations seront automatiques.

Les boutons fonctionnent de cette manière :

Oui

  répond oui à la question affichée.

Non

  répond non à la question affichée.

Annuler

  Stoppe l'opération en cours et ferme la fenêtre action.

Silencieux

  est un raccourci pour activer l'option Silencieux puis cliquer sur Oui.

Vous pouvez préciser quelle(s) action(s) peut (peuvent) être démarrée(s) automatiquement (sans avoir à cliquer sur Silencieux au début) avec la commande Options....

## Options des fenêtres action

Certaines actions ont des options, qui apparaissent sous forme de petites cases à cocher en bas de la fenêtre :

- Forcer signifie que le filer ne va pas traiter différemment les fichiers spécifiés 'protégés en écriture'. Normalement, la suppression est confirmée même si Silencieux est enclenché. Notez que vous ne pouvez pas supprimer des fichiers présents dans des dossiers protégés en écriture car dans ce cas vous n'en avez pas la permission.

- Bref évite au filer d'afficher un message à chaque fois qu'il fait quelque chose. Utilisez cette option si vous voulez augmenter la vitesse d'exécution de l'opération, si beaucoup de messages sont affichés.

- Récursif signifie que l'action appliquée à un dossier sera aussi appliquée à tout son contenu, ainsi qu'au contenu de ses sous-dossiers, et ainsi de suite.

- Plus récent n'écrasera un fichier que si le fichier copié est plus récent que le fichier écrasé (date de modification).

Vous pouvez définir la valeur par défaut de ces options.

## Chapitre 14. Chercher

La fonction Chercher recherche à travers tous les fichiers et les dossiers sélectionnés ainsi que tous les sous-dossiers (récursivement), les objets qui correspondent à une expression particulière.

Choisissez la commande Chercher du menu Fichier pour chercher un fichier dans les objets sélectionnés. Si vous voulez sélectionner tous les fichiers d'un dossier qui correspondent à une quelconque expression, utilisez Sélectionner -> Sélectionner si....

Si vous connaissez le nom d'un fichier, entrez-le simplement dans l'espace 'Expression :', entouré par des apostrophes. Par exemple, pour chercher un fichier nommé ``log`', vous entrerez `'log'`. Souvenez-vous qu'il faut utiliser des apostrophes, et pas des guillemets (") ni des apostrophes inversées (`) !.

Au fur et à mesure que le filer trouve des objets qui correspondent, ils sont ajoutés à la liste des résultats. Si vous double-cliquez sur un des résultats, une fenêtre s'ouvrira pour vous montrer le dossier dans lequel celui-ci est enregistré. Le filer utilisera la même fenêtre pour afficher les dossiers qui correspondent aux autres résultats (donc si vous voulez garder des fenêtres différentes pour chaque résultat, vous devrez explicitement créer une nouvelle fenêtre (menu Fenêtre).

## Wildcards (les motifs génériques)

Vous pouvez aussi entrer des wildcards entre les apostrophes, par exemple :

'*.html'
'Report.*'
'Draft[1-5]'
'main.[ch]'

Lisez la page man de glob(7) (ndt : 'man 7 glob') si vous voulez en savoir plus sur les motifs génériques.

Si l'expression que vous entrez contient un slash ('/'), la recherche porte sur le chemin complet des objets, au lieu de ne porter que sur le nom de l'objet. Donc, `'*tmp*'` trouvera ``tmp`' et ``tmpfile`' mais pas ``/tmp/file`' — `'/*tmp*'` trouvera les trois.

## Tests simples

Le filer propose d'autres types de recherche (pas seulement par le nom). Notez que file est utilisé ici pour tout ce qui peut être dans le système de fichiers — y compris les répertoires, les fichiers de périphérique (devices) et autres...

Vous pouvez aussi utiliser une forme courte pour chaque test ; celle-ci est écrite entre parenthèses. Vous pouvez combiner plusieurs tests — `-rw` donnera le même résultat que `EstLisible et EstInscriptible`.

Ces expressions recherchent les objets par leur type :

- `EstOrd (-f)` correspond à un fichier ordinaire.

- `EstLien (-l)` correspond à un lien symbolique.

- `EstRép (-d)` correspond à un répertoire.

- `EstCar (-c)` correspond à un fichier de périphérique caractère (character device).

- `EstBloc (-b)` correspond à un fichier de périphérique bloc (block device).

- `EstPér (-D)` correspond à un fichier de périphérique bloc ou à un fichier de périphérique caractère.

- `EstTube (-p)` correspond à un tube.

- `EstSocket (-S)` correspond à un socket.

- `EstPorte (-O)` correspond à un objet door (Solaris).

Celles-ci, par leurs permissions — voir la section Permissions.

- `EstSUID (-u)` correspond aux fichiers qui ont le bit 'Set-UID' activé.

- `EstSGID (-g)` correspond aux fichiers qui ont le bit 'Set-GID' activé.

- `EstSticky (-k)` correspond aux fichiers qui ont le bit 'sticky bit' activé.

- `EstLisible (-r)` correspond aux fichiers que vous pouvez lire.

- `EstInscriptible (-w)` correspond aux fichiers dans lesquels vous pouvez écrire.

- `EstExécutable (-x)` correspond aux fichiers que vous pouvez exécuter.

Deux autres très utiles :

- `EstVide (-z)` trouve les fichiers vides (en fait, ceux dont la taille est de 0 octet).

- `EstÀMoi (-o)` trouve les fichiers dont vous êtes le propriétaire.

## Opérateurs logiques

Vous pouvez combiner les tests précédents pour effectuer des recherches avancées. Une expression est actuellement faite d'une liste de cas, séparés par des virgules. Le filer essaiera de trouver les correspondances pour chaque cas jusqu'à ce qu'un de ceux-ci fonctionne, ou jusqu'à ce qu'il n'y ait plus de cas. Par exemple, pour chercher des fichiers dont les extensions peuvent être différentes :

    '*.gif', '*.htm', '*.html'

Plus fort : chaque cas peut être une liste de conditions. Le cas ne fonctionne que si toutes les conditions sont respectées. Pour trouver un dossier nommé ``lib`' ou un fichier normal se terminant par ``.so`' :

    EstRép 'lib', EstOrd '*.so'

Vous pouvez inverser une condition en ajoutant un `!` devant, et vous pouvez utiliser une sous-expression comme expression, en l'entourant de parenthèses, comme ceci :

    !(EstRép, EstOrd)

    !EstRép !EstOrd

    Non EstRép et non EstOrd

    !-d !-f

Ces 4 expressions signifient la même chose.

## Comparaisons

Vous pouvez aussi comparez des valeurs en utilisant les opérateurs `<`, `<=`, `=`, `!=`, `>`, et `>=` (inférieur à, inférieur ou égal à, égal à, différent de, supérieur à, supérieur ou égal à). Quand vous comparerez des heures, vous trouverez certainement plus pratique d'utiliser `après` et `avant` au lieu de `>` et `<`.

Ce qui suit peut être utilisé dans les comparaisons :

- `atime` L'heure du dernier accès au fichier.

- `ctime` L'heure du dernier changement du statut du fichier.

- `mtime` L'heure de la dernière modification du fichier.

- `taille` La taille du fichier.

- `inode` Le numéro d'index (inode) du fichier.

- `nliens` Le nombre de liens physiques (et pas symboliques).

- `uid` Le 'User ID' du fichier.

- `gid` Le 'Group ID' du fichier.

- `blocs` Le nombre de blocs de disque utilisés par le fichier.

Les heures sont mesurées en secondes, avec un point de départ correspondant à 'Unix Epoch' (1er janvier 1970 à 00:00:00 UTC). Les tailles sont en octets. Quand vous utilisez des constantes pour comparer les valeurs, vous pouvez utiliser plusieurs mots-clés pour ajuster l'échelle de la valeur :

- `Octet(s)` Sans effet, mais 'ça fait mieux'.

- `Ko` multiplie par 1024, donc 2 Ko = 2048.

- `Mo` multiplie par 10242, soit 1024 Ko.

- `Sec` Sans effet, mais ça fait mieux aussi !

- `Min` multiplie par 60 pour obtenir des minutes.

- `Heure(s), Jour(s), Semaine(s), An(s)` convertit dans l'unité précisée.

- `Passé` rend le temps passé relatif à l'heure à laquelle est effectué le test.

- `Futur` rend le temps futur à l'heure à laquelle est effectué le test.

- `Maintenant` est un raccourci pour `0 Sec Futur`.

Quelques exemples rendront tout ceci plus clair !

    mtime après 1 jour passé

    taille > 10 Mo

    EstOrd et nliens > 1

La première expression trouve les fichiers modifiés au cours des dernières 24 heures. Vous pourriez utiliser `>` au lieu de `après`, mais ce serait moins clair.

La deuxième trouve les fichiers pesant plus de 10 Mo. La dernière trouve les fichiers normaux qui ont plus qu'un lien physique sur eux.

Attention — le filer ne vérifie pas le contexte des opérateurs, donc `taille > 1 jour passé` est admis, même si ça n'a pas de sens ! Pensez aussi aux mots-clés `passé` ou `futur`, car un oubli de ceux-ci pourrait causer des problèmes conséquents (le temps serait alors mesuré par rapport à l'Epoch au lieu de l'heure courante). Enfin, n'utilisez pas `=` avec les heures — `atime = 1 jour passé` recherche un fichier accédé il y a exactement 86400 secondes...

## Divers

- `System(commande)` exécute 'commande' sur le fichier. Le test réussit si la commande renvoie un code de retour 0 (zéro). Un caractère '%' dans 'commande' est remplacé par le chemin complet du fichier traité. `System` est un test très lent, donc utilisez-le si possible en dernier dans vos expressions. Par exemple, si vous cherchez un fichier dont l'extension est ``.c`' et qui contient le mot 'main', utilisez :

      '*.c' system(grep -q main "%")

  pour que grep ne soit exécuté que pour les fichiers ayant pour extension ``.c`' (à opposer à une recherche des fichiers qui contiendraient le mot 'main', puis qui seraient du type ``.c`'.

- `Prune` Ne réussit jamais ! [2] Ce mot-clé peut empêcher la recherche à l'intérieur du dossier courant. Souvenez-vous de l'ordre dans lequel le filer teste l'expression !

Exemples :

    '*.old' system(rm '%')

    'src' prune, '*.c'

La première expression supprime chaque fichier ayant pour extension ``.old`'. La seconde cherche les fichiers ayant pour extension ``.c`', mais ne prend pas la peine de vérifier le contenu des dossiers nommés ``src`'. L'expression est évaluée comme suit :

Si un fichier est nommé ``src`', alors `Prune'. D'autre part, vérifie s'il se termine par ``.c`' et dans ce cas, l'inclut dans les résultats.

[2] Notez que c'est l'inverse de la commande find(1).

## Chapitre 15. Options

Vous pouvez configurer beaucoup de comportements de ROX-Filer. Choisissez pour cela Options... dans le menu d'une fenêtre du filer. La liste à gauche montre les différentes sections — cliquez sur celle de votre choix pour voir les options dont elle dispose. Il y a deux boutons en bas de la boîte de configuration :

- OK sauve vos choix dans votre dossier ``~/.config/rox.sourceforge.net/ROX-Filer`', pour que ROX-Filer les retrouve la prochaine fois qu'il sera exécuté. L'endroit exact où les choix sont sauvegardés est défini par la variable d'environnement `XDG_CONFIG_HOME` — voir [BaseDir] pour plus de détails. Puisque tous vos choix prennent effet immédiatement, vous n'avez pas besoin de cliquer sur OK pour voir ce qui change.

- Revenir Annule toutes les modifications effectuées depuis l'ouverture de la fenêtre Options. Ce bouton est grisé si vous n'avez effectué aucun changement. La boîte Options n'est pas fermée si vous utilisez ce bouton.

Les options de la fenêtre Options proposent des bulles d'aide qui expliquent l'utilité de chacune d'entre elles ; maintenez votre pointeur de souris au-dessus d'une option pour voir ce qu'elle fait.

## Chapitre 16. Types de fichier

Tous les fichiers ont un type MIME sous la forme text/plain. Ici, text est le type de media et plain est le sous-type.

ROX-Filer utilise le nom d'un fichier pour décider si un fichier est d'un type MIME ou d'un autre, puis utilise le type MIME pour associer une icône et savoir quel programme exécuter quand vous ouvrez le fichier.

## Fixer l'action d'exécution...

Cette commande du menu Fichier est utilisée pour définir l'application à exécuter quand vous cliquez sur un fichier.

Par exemple, admettons que vous vouliez que les ``.gif`' s'ouvrent automatiquement avec 'The Gimp'. D'abord, faites un clic droit sur une image gif pour ouvrir le menu, et choisissez la commande Fixer l'action d'exécution... dans le sous-menu Fichier (celui qui prend le nom du fichier sur lequel vous avez cliqué). Ensuite, vous pouvez fixer l'action d'exécution de deux façons différentes :

### Par drag-and-drop

Déposez 'The Gimp' (depuis une fenêtre du filer, un panneau ou le punaiseur) sur l'aire où est inscrit Faites glisser ici une application appropriée. Maintenant, si vous cliquez sur une image gif, 'The Gimp' sera lancé automatiquement et ouvrira cette image.

### En entrant une commande shell

Tapez : `gimp "$@"` dans l'endroit Entrez une commande shell et appuyez sur Entrée. `$@` sera remplacé par le nom du fichier sur lequel vous cliquerez. Comme ci-dessus, 'The Gimp' sera lancé automatiquement et ouvrira cette image.

### Définir les types de média par défaut

Quelque soit la méthode que vous utilisez pour fixer l'action d'exécution, vous avez le choix de fixer celle-ci juste pour le type MIME du fichier, ou pour tous les fichiers ayant ce type et un sous-type différent et qui n'ont pas encore d'action par défaut.

Puisque 'The Gimp' peut lire beaucoup de types d'images, il peut être intéressant de choisir l'option Mettre la valeur par défaut pour tout 'image/<quelconque>' et ainsi vous n'aurez pas à le faire pour les fichiers image/jpeg et les autres... Cette option n'a d'effet que sur les types qui n'ont pas déjà une action définie (ie, ceux qui vous affichent un message d'erreur quand vous essayez de les ouvrir).

## La boîte 'Fixer l'icône'

Cette boîte apparaît quand vous choisissez la commande Fixer l'icône... du menu Fichier. Elle permet de définir une image pour représenter l'objet.

Elle fonctionne un peu de la même façon que la boîte 'Fixer l'action d'exécution' décrite ci-dessus, sauf que vous pouvez affecter une icône pour un fichier précis (par son nom), ou pour tous les fichiers d'un type particulier. Si vous affectez une icône à un fichier précis, le filer enregistre les noms de ce fichier et de cette icône dans le dossier ``~/.config/rox.sourceforge.net/MIME-icons`'. Si l'un ou l'autre est déplacé, l'icône ne sera plus affichée.

Quand vous affectez une icône à un répertoire, vous avez la possibilité de copier cette icône dans le dossier lui-même, en tant que fichier caché. Les autres utilisateurs verront aussi cette icône, vous pouvez donc supprimer l'image originale après sa copie (notez que la taille de l'image est ajustée si nécessaire et convertie au format PNG).

L'icône de dossier affichée dans la zone Faites glisser ici un fichier d'icône vous permet d'afficher un dossier qui contient déjà une ou plusieurs icônes dont vous vous servez.

## Comment les types de fichier sont enregistrés

ROX-Filer utilise deux sous-dossiers dans votre dossier ``~/.config/rox.sourceforge.net`' pour gérer les types de fichier :

``MIME-types`'

  contient des liens symboliques, un par type MIME, qui pointent vers des programmes qui connaissent ce type de fichiers. Pour définir quel programme est exécuté quand vous cliquez sur un fichier, vous utilisez normalement la commande Fixer l'action d'exécution... (voir la section the Set Run Action box). Cependant, vous pouvez définir ces actions manuellement — par exemple, pour ouvrir un fichier HTML avec Netscape :

  1. Trouvez l'application Netscape et choisissez la commande Lier... dans le menu.

  2. Entrez `text_html` comme nom pour le lien et glissez l'icône du haut de la boîte 'Lier' vers le dossier ``MIME-types`'.

  Vous pouvez aussi déposer dans ce dossier les programmes eux-mêmes, plutôt que des liens.

``MIME-icons`'

  contient les images utilisées pour afficher chaque type de fichier. Donc le filer essaiera d'afficher un fichier HTML en utilisant l'icône nommée ``MIME-icons/text_html.png`'. S'il n'y a pas d'icône définie ici, le filer utilisera le thème d'icône choisi dans la boîte Options (voir [IconTheme] pour plus de détails).

Dans le dossier ``MIME-types`', vous pouvez définir les actions par défaut pour chaque type de média. Par exemple, si ``text_html`' n'est pas trouvé, le filer essaiera simplement d'utiliser ``text`'.

## Comment le filer détermine-t-il un type de fichier ?

Le filer utilise la plupart du temps le nom du fichier pour déterminer son type. En cas d'échec, il essaiera de trouver d'après le contenu du fichier. Si vous ne souhaitez pas qu'il essaie de cette manière, fixez le type correct du fichier en utilisant les attributs étendus, grâce à la commande Fixer le type....

Pour gérer les règles utilisées pour déterminer le type d'un fichier en fonction de son nom, ouvrez la boîte Options et sélectionnez la section Types. Vous y trouverez un bouton qui démarrera l'application MIME-Editor. Vous pouvez aussi éditer ces règles manuellement — voir [SharedMIME] pour plus de détails. Le filer cherche le type d'un fichier en fonction de son nom. Les règles sont définies dans plusieurs fichiers ``globs`' — voir [SharedMIME] pour plus de détails.

## Chapitre 17. Dossiers-applications

Un dossier-application est un dossier qui peut être exécuté comme une application. Il contient toutes les ressources d'une application — code source, binaires, documentation et autres. Tout enregistrer au même endroit rend l'installation et la désinstallation plus faciles pour les utilisateurs. Vous pouvez aussi garder plusieurs versions différentes d'un même programme en les enregistrant dans des dossiers-applications différents. Vous pouvez les déplacer et les renommer comme vous le voulez. Les dossiers-applications sont plus faciles à utiliser et à installer.

Ils sont aussi plus sûrs, parce que vous pouvez compiler une application en tant qu'utilisateur et ensuite simplement la copier en tant que root plutôt que de lancer en tant que root un script d'installation dans lequel vous n'avez pas confiance. Tout ce que vous avez à vérifier, ce sont les binaires avec le bit setuid.

Les fichiers suivants ont une signification particulière pour ROX-Filer :

- ``AppRun`' est exécuté quand vous cliquez sur le dossier — vérifiez qu'il est bien exécutable (utilisez la boîte pour changer les permissions) !

- ``.DirIcon`' est l'image utilisée pour représenter le dossier (ceci fonctionne même s'il n'y a pas de fichier ``AppRun`').

- ``Help`' est le dossier qui s'ouvre quand vous choisissez Aide dans le menu Fichier.

- ``AppInfo.xml`' contient des informations complémentaires sur l'application (voir ci-dessous).

- ``AppIcon.xpm`' est utilisée si ``.DirIcon`' est manquant (dans un but de compatibilité avec les anciennes versions ; n'est normalement plus utilisée dorénavant).

Jetez un œil au dossier-application de ``ROX-Filer`' pour avoir un exemple détaillé et complet.

### Note

Note : pour des raisons de sécurité, un dossier-application doit avoir le même propriétaire que le fichier ``AppRun`' qu'il contient.

## Le fichier AppInfo

``AppInfo.xml`' est un fichier XML avec la structure suivante (chaque élément est facultatif, ainsi que le fichier lui-même) :

    <?xml version="1.0"?>
    <AppInfo>
     <Summary xml:lang="en">A graphical file manager</Summary>
     <Summary xml:lang="de">Ein grafische Datei-Manager</Summary>
     <Summary xml:lang="nl">Een grafisch bestandsbeheerprogramma</Summary>
     <Summary xml:lang="es">Un manejador de archivos gráafico</Summary>
     <About xml:lang="en">
        <Purpose>File manager</Purpose>
        <Version>1.3.5 PREVIEW</Version>
        <Authors>Thomas Leonard and others</Authors>
        <License>GNU General Public License</License>
        <Homepage>http://rox.sourceforge.net</Homepage>
     </About>
     <About xml:lang="es">
    	<Purpose>Manejador de Archivos</Purpose>
    	<Authors>Thomas Leonard y otros</Authors>
     </About>
     <AppMenu>
    	<Item option="-p=Default">
    	  <Label>Enable pinboard</Label>
    	  <Label xml:lang="es">Habilitar el pinboard</Label>
        </Item>
    	<Item option="-p=">
    	  <Label>Disable pinboard</Label>
    	  <Label xml:lang="es">Deshabilitar el pinboard</Label>
    	</Item>
      </AppMenu>
    </AppInfo>

- `Summary` est affiché dans une bulle d'aide quand la souris est maintenue au-dessus du dossier.

- `About` contient une liste de champs qui sont affichés dans la boîte 'Info fichier' du dossier-application (n'importe quel nom peut être utilisé comme élément, ceux de l'exemple sont seulement suggérés).

- `AppMenu` est une liste de commandes supplémentaires qui s'insèreront dans le menu du dossier-application. Quand une de ces commandes est choisie, ``AppRun`' est exécuté avec le nom de la commande `option` comme seul argument. Vous pouvez intégrer des menus 'AppMenu' à d'autres menus 'AppMenu' afin de créer des sous-menus, à condition qu'ils disposent d'un élément '$lt;Label$gt;'. Les éléments `Item` peuvent aussi bénéficier d'un attribut `icon`, qui spécifie le nom de l'icône choisie dans le thème actif.

## Chapitre 18. Internationalisation

## Choisir une traduction

ROX-Filer est capable de traduire beaucoup de ses messages, pourvu que des fichiers de traduction corrects soient fournis :

1. Ouvrez la boîte d'options via le menu,

2. Sélectionnez une langue dans la liste proposée,

3. Cliquez sur OK et redémarrez le filer pour que les changements soient pris en compte.

## Créer une nouvelle traduction

1. Allez dans le dossier ``src/po`' et créez le fichier ``src/messages.pot`' :

       $ cd ROX-Filer/src/po
       $ ./update-po

2. Copiez le fichier dans le sous-dossier ``src/po`' en le nommant ``<name>.po`'. Ex : si votre langue est 'ml' ('ma langue') :

       $ cp ../messages.pot ml.po

3. Ouvrez la copie dans un éditeur de texte.

4. Remplissez les traductions, qui sont toutes vierges au début.

5. Exécutez le script ``make-mo`' pour créer le fichier binaire que ROX-Filer pourra utiliser. Vous aurez besoin du paquetage GNU gettext pour effectuer cette opération.

       $ cd ROX-Filer/src/po
       $ ./make-mo ml
       Created file ../../Messages/ml.gmo OK

6. Éditez ``ROX-Filer/Options.xml`' pour que votre langue soit listée, redémarrez le filer et sélectionnez-la dans la boîte d'options (voir la section Translations).

7. Envoyez le fichier ``.po`' dans le 'gestionnaire de patches ROX', pour qu'il puisse être inclus dans les prochaines versions du filer.

## Mettre à jour une traduction existante

1. Allez dans le dossier contenant les fichiers ``.po`' et exécutez le script ``update-po`'. Celui-ci vérifie dans le code source s'il y a des phrases nouvelles ou modifiées et met à jour tous les fichiers de traduction.

       $ cd ROX-Filer/src/po
       $ ./update-po

2. Éditez le fichier à la main, comme pour une nouvelle traduction, en traduisant les nouveaux messages et en mettant à jour les autres. Regardez bien les entrées `fuzzy` que update-po a créées ; vérifiez que la traduction est correcte et supprimez la ligne `fuzzy`.

3. Exécutez make-mo comme la fois d'avant.

4. Soumettez-nous le fichier mis à jour.

Lisez la page info de gettext pour de plus amples instructions sur la création de traductions.

## Chapitre 19. Hacking

Ceci est un guide de base pour les personnes qui veulent modifier le code source. Si vous faites des changement utiles ou si vous corrigez des bugs, envoyez-moi les patches (Thomas Leonard) ou envoyez-les à la liste de diffusion. Dites-moi quelle version vous utilisez !

## Compiler

La première fois que vous compilerez, vous devrez exécuter AppRun --compile, mais les fois suivantes, un make dans le dossier ``src`' quand vous changerez les fichiers ``.c`' et ``.h`' suffira. Vous voudrez peut-être exécuter aussi un make depend...

## Créer et appliquer des patches

Quand les développeurs apportent de petites modifications aux sources, ils les distribuent souvent sous forme de patches — souvent sur la liste de diffusion. Pour appliquer un patch, allez dans le dossier ``src`' et exécutez la commande patch avec le nouveau patch. Recompilez ensuite :

    $ cd ROX-Filer/src
    $ patch < patchfile
    $ ../AppRun --compile

Vous pouvez retirer le patch en répétant simplement la séquence ci-dessus — patch détectera que le patch est déjà appliqué, et proposera de l'enlever.

Pour créer un patch vous devrez d'abord vous procurer la dernière version du filer sur CVS (les instructions pour l'utilisation de CVS peuvent être trouvées sur le site web). Modifiez le programme comme bon vous semble. Créez le patch en utilisant cvs diff depuis le dossier approprié :

    $ cvs diff -u > my_patch

Ceci crée un patch lisible par l'homme – et la machine. Soumettez-le à la liste de diffusion. Il est recommandé de poster des patches plutôt que les fichiers modifiés, pour plusieurs raisons :

- Ils sont plus petits. Ils sont donc plus rapides à télécharger par les gens qui n'ont pas de connexion à haut débit.

- On peut voir ce qu'il y a dedans avant de les appliquer !

- Les patches peuvent (souvent) être appliqués sur des versions légèrement modifiées des sources. Cela veut dire que plusieurs patches peuvent être appliqués sans que chaque nouveau n'écrase les autres.

## Autoconf

Voici une explication rapide du système autoconf au cas où vous ne l'auriez pas déjà utilisé. Voir info autoconf pour plus de détails.

Un fichier nommé ``configure.in`' est fourni et contient plusieurs tests (info autoconf). Vous n'avez qu'à exécuter autoconf il lira ce fichier et générera un script shell pour effectuer les tests, en le sauvant sous le nom de ``configure`'. ``configure`' est normalement distribué avec le programme car tout le monde n'a pas autoconf.

Vous exécutez ensuite ``configure`' (en fait, laissez le script ``AppRun`' le faire car il lui passe quelques arguments), qui effectue tous les tests. Il lit ``Makefile.in`' et ``config.h.in`' et complète les valeurs manquantes avec les résultats des tests pour produire ``Makefile`' et ``config.h`'.

Exécutez make, qui créera les fichiers ``.o`' à partir des fichiers ``.c`' et les liens pour créer ``ROX-Filer`'.

## Structures de données

Le fichier ``global.h`' contient les principales structures de données de ROX-Filer et explique la façon dont elles sont utilisées dans le code-source. C'est un bon point de départ si vous voulez comprendre son fonctionnement.

## Annexe A. Compilation

Si vous venez d'obtenir le filer en téléchargeant l'archive de ses sources, vous devez donc les compiler pour vous en servir. Si vous avez téléchargé et installé les binaires (le logiciel est donc déjà compilé), ou si ROX-Filer était déjà installé sur votre système, vous pouvez passer directement à la section suivante. Si vous êtes arrivés ici en cliquant sur l'icône représentant une bouée, ou si taper rox dans un XTerm fonctionne, vous n'avez pas besoin de compiler.

Pour compiler, vous aurez besoin de ce qui suit :

- Unix ou Linux (le mot de passe root n'est pas nécessaire),

- Le système 'X Window' (fourni en standard sur tous les systèmes modernes),

- GTK+ 2.4.0 ou postérieure (bibliothèques et en-têtes) — dernière version téléchargeable depuis [GTK+],

- Glade 2.0.0 ou postérieure (bibliothèques et en-têtes) — dernière version téléchargeable depuis [Glade],

- LibXML 2.0.0 ou postérieure (bibliothèques et en-têtes) — dernière version téléchargeable depuis [libxml],

- Un compilateur C, comme 'gcc' (standard sur la plupart des systèmes).

Tout ceci est standard sur la plupart des distributions Linux modernes. Pour vérifier quelle version de GTK+ est installée, utilisez la commande pkg-config, comme ceci (`$` est le prompt) :

    $ pkg-config --modversion gtk+-2.0
          2.6.8

Procédure A.1. Pour compiler (en utilisant Zero Install) :

1. Démarrez l'interface Zero Install pour ROX-Filer. Par exemple, depuis un terminal :

             $ 0launch --gui http://rox.sourceforge.net/2005/interfaces/ROX-Filer

2. Faites un clic droit sur la ligne ROX-Filer et choisissez Compiler... dans le menu.

3. Zero Install va vous demander de choisir une version de ROX-Filer à compiler et de certains fichiers d'en-têtes requis. Vous pouvez normalement accepter les choix par défaut et les télécharger.

4. Choisissez un dossier dans lequel le code compilé sera enregistré et cliquez sur Build pour procéder.

5. Une fois compilé, cliquez sur Register pour ajouter cette version à la liste des versions disponibles.

Procédure A.2. Pour compiler :

1. Le filer utilise maintenant la base de données [SharedMIME] pour gérer les types MIME des fichiers. Vous devez installer cette base avant d'installer rox, sinon le filer ne fonctionnera pas correctement (ROX-Filer vous avertira lors de son démarrage si elle n'est pas installée).

2. Allez dans le répertoire qui contient le sous-répertoire ROX-Filer.

3. Exécutez le script AppRun, comme ceci :

       $ ./ROX-Filer/AppRun --compile

4. ROX-Filer va effectuer quelques tests pour trouver sur quel type de système vous travaillez, puis va commencer la compilation. Si ça ne fonctionne pas, envoyez-nous un courriel et plaignez-vous ! Dites-nous quel type de système vous avez et quels sont les messages d'erreur affichés. Si vous réussissez à régler le problème vous-même, envoyez-nous SVP un courriel avec le correctif.

5. Une fois que le filer est compilé, il démarre automatiquement. Pour le démarrer à nouveau plus tard, exécutez le script AppRun sans argument.

## Annexe B. Page de manuel

## Nom

ROX-Filer — Un gestionnaire de fichiers graphique et simple

## Synopsis

`rox` [`OPTION`...] [FILE...]

## DESCRIPTION

ROX-Filer est un gestionnaire de fichiers simple et pratique pour X11, l'interface graphique à base de fenêtres très utilisée sur les systèmes d'exploitation Unix et dérivés.

C'est aussi le c½ur du ROX Desktop : http://rox.sourceforge.net

La commande rox ouvre tous les dossiers et/ou fichiers donnés en argument, ou seulement le répertoire courant si aucun argument n'est fourni.

## OPTIONS POUR LA LIGNE DE COMMANDE

`-b`, `--border=PANEL`

  affiche le panneau PANEL.

`-B`, `--bottom=PANEL`

  affiche le panneau PANEL en bas de votre écran.

`-c`, `--client-id=ID`

  utile pour la gestion de session.

`-d`, `--dir=DIR`

  ouvre le dossier DIR en tant que répertoire (pas comme une application, même si ce dossier y ressemble).

`-D`, `--close=DIR`

  ferme le dossier DIR et tous ses sous-dossiers.

`-h`, `--help`

  affiche l'aide et une description des options.

`-l`, `--left=PANEL`

  crée un panneau à gauche de votre écran.

`-m`, `--mime-type=FILE`

  affiche le type MIME du fichier "FILE" et s'arrête.

`-n`, `--new`

  démarre un nouveau filer, même s'il y en a déjà un. Cette option interdit au filer de forker (s'exécuter en arrière plan), et n'est quasiment utile que pour débugger.

`-p`, `--pinboard=PIN`

  utilise le punaiseur PIN.

`-r`, `--right=PANEL`

  crée un panneau à droite de votre écran.

`-R`, `--RPC`

  lit et invoque SOAP RPC depuis l'entrée standard (voir Annexe C, SOAP RPC).

`-s`, `--show=FILE`

  Ouvre une fenêtre et affiche le dossier où se trouve FILE.

`-S`, `--rox-session`

  Démarre avec un gestionnaire de sessions, et ouvre les panneau et punaiseur par défaut (implique l'utilisation de --new). Si un gestionnaire de sessions XSM est chargé, et que cette option est utilisée, ROX-Filer demandera à redémarrer automatiquement s'il se ferme inopinément.

`-t`, `--top=PANEL`

  crée un panneau en haut de votre écran.

`-u`, `--user`

  affiche le nom de l'utilisateur dans chaque fenêtre.

`-U`, `--url=URI`

  Exécute URI en tant que fichier ou répertoire. Si URI est une URL de type "file:" et correspond à un fichier sur la machine locale, elle sera convertie en un nom de fichier local : "rox -U file:///tmp" sera converti en "rox /tmp". Si l'URI correspond à un autre type d'URL, la configuration du gestionnaire d'URI est alors consultée.

`-v`, `--version`

  Affiche les informations sur la version et s'arrête.

`-x`, `--examine=FILE`

  Le fichier FILE a changé ; il faut le réexaminer.

## NOTES

La documentation principale de ROX-Filer est accessible par la commande Voir les fichiers d'aide du menu Aide, ou par le bouton le plus à droite sur la barre d'outils.

## LICENCE

Copyright (C) 2004 Thomas Leonard.

Vous pouvez redistribuer des copies de ROX-Filer si vous respectez les termes de la GNU General Public License.

## BUGS

Merci d'envoyer (en anglais) vos rapports de bugs à la liste de diffusion consacrée au développement : http://rox.sourceforge.net/contact.html.

## AUTHORS

ROX-Filer a été créé par Thomas Leonard, avec l'aide de :

Michael Adams | Thierry Godefroy | Christiansen Merel
Christopher Arndt | Olli Helenius | Jimmy Olgeni
Jens Askengren | Alex Holden | Richard Olsson
Liav Asseraf | Jasper Huijsmans | Matthew O'Phinney
Wilbert Berendsen | Sigve Indregard | Daniele Peri
Francesco Bochicchio | Bernard Jungen | Andy Piper
Yuri Bongiorno | Marcin Juszkiewicz | Marcelo Ramos
Andrzej Borsuk | James Kermode | Michel Alexandre Salim
Richard Boulton | Jim Knoble | Adam Sampson
Simon Britnell | Krzysztof Krzyzaniak | Chris Sawer
Arnaud Calvo | Aaron Kurtz | Christian Storgaard
Babyfai Cheung | Vincent Ledda | Taras
Andrew Clover | Vincent Lefèvre | Simon Truss
Fabien Coutant | Victor Liu See-le | Hirosi Utumi
Couderc Damien | Alexey Lubimov | Jan Wagemakers
Andreas Dehmel | Krzysztof Luks | Keith Warno
Micah Dowty | Marcus Lundblad | Götz Waschk
Dmitry Elfimov | Anders Lundmark | Stephen Watson
Mattias Engdegard | Jose Romildo Malaquias | Andre Wyrwa
Andrew Flegg | Denis Manente | Geoff Youngs
Olivier Fourdan | Brendan McCarthy | Diego Zamboni
Eric Gillespie | Andras Mohari |

et beaucoup d'autres ; le fichier ``Changes`' offre d'avantage d'informations !

## Annexe C. SOAP RPC

Quand vous démarrez le filer, vous pouvez lui spécifier des arguments, sur la ligne de commande, pour contrôler son comportement. Il existe une alternative à ceci ; le filer vous permet de passer vos arguments sous la forme d'un message au format RPC [SOAP]. En fait, si vous utilisez les options de la ligne de commande, le filer les convertit en RPC SOAP en interne.

Tous les messages RPC SOAP passent par l'entrée standard, comme ceci :

    $ rox --RPC << EOF
    <?xml version="1.0"?>
    <env:Envelope xmlns:env="http://www.w3.org/2001/12/soap-envelope">
    <env:Body xmlns="http://rox.sourceforge.net/SOAP/ROX-Filer">
    <Panel>
    <Name>Default</Name>
    <Side>Bottom</Side>
    </Panel>
    </env:Body>
    </env:Envelope>
    EOF

Les méthodes suivantes sont reconnues :

- Version() Returns the filer's version.

- CloseDir(Filename) Ferme le dossier Filename et tous ses sous-dossiers.

- Examine(Filename) L'objet Filename a peut-être changé — vérifier et mettre à jour l'affichage.

- OpenDir(Filename, [Style, Details, Sort, Class, ID, Hidden, Filter]) Ouvre une fenêtre et y affiche le dossier Filename. Style peut prendre la valeur `Large`, `Small`, `Huge` ou `Automatic`. Details peut prendre la valeur `None`, `ListView`, `Size`, `Type`, `Times` ou `Permissions`. Sort peut prendre la valeur `Name`, `Type`, `Date`, `Size`, `Owner` ou `Group`. Si une de ces options n'est pas renseignée, l'affichage par défaut est utilisé. Class peut être utilisé pour fixer la propriété WM_CLASS de la nouvelle fenêtre. Vous pouvez utiliser ceci pour que votre gestionnaire de fenêtres gère celle-ci d'une façon particulière. ID est une chaîne utilisée pour identifier la fenêtre ouverte. Si une fenêtre existe déjà avec cette ID, celle-ci est modifiée pour le nom du dossier ; sinon, une nouvelle fenêtre est créée et son ID lui est rattachée. Assurez-vous que les ID que vous générez sont uniques lorsque vous utilisez des scripts, en concaténant par exemple le nom du script, le PID et un horodatage pour former l'ID. Hidden Pour afficher les fichiers cachés (ceux dont le nom commence par un point), utilisez la valeur `true` ; pour ne pas les afficher, préférez `false`. Si vous omettez ce paramètre, l'option de configuration est utilisée. Filter peut être utilisé pour appliquer un filtre pour n'afficher que certains noms de fichiers. Par exemple, utilisez le filtre `*.c` pour n'afficher que les fichiers se terminant par .c.

- Panel([Side, Name]) Ouvre le panneau nommé Name sur le côté de l'écran précisé en Side (`Top`|`Bottom`| `Left`|`Right` — NDT : Haut|Bas|Gauche|Droite). Name peut être un nom stocké dans ``~/.config/rox.sourceforge.net/ROX-Filer`' (par exemple `MonPanneau`), ou un chemin complet.

- PanelAdd(Side, Path, [Label, After, Shortcut, Args]) Ajoute Path au panneau sur le côté Side, avec le libellé Label. Si After est fixé à `true`, l'icône sera alignée à droite (ou en bas) du panneau, sinon à gauche (ou en haut). Si Shortcut est précisé, il s'agit du raccourci-clavier à utiliser pour ouvrir cet objet. Les arguements Args, s'ils sont fournis, seront passés à l'objet lors de son démarrage, s'il s'agit d'un programme.

- PanelRemove(Side, Path, [Label]) Retire un objet du panneau sur le côté Side. Si ni Path, ni Label ne sont précisés, l'appel échouera : au moins un de ces deux paramètres doit être renseigné. Si plusieurs objets correspondent, un seul est retiré.

- Pinboard([Name]) Affiche sur le bureau le punaiseur nommé Name. Name peut être un nom stocké dans ``~/.config/rox.sourceforge.net/ROX-Filer`' (par exemple `MonPunaiseur`), ou un chemin complet. S'il est omis, la fonction punaiseur est désactivée.

- PinboardAdd(Path, [X, Y, Label, Shortcut, Args, Update]) Ajoute Path au punaiseur en le nommant Label (facultatif). Si X et Y ne sont pas mentionnés ou s'ils sont négatifs, l'icône est positionnée automatiquement. Les paramètres négatifs X et Y indiquent la position de l'icône ajoutée (X=-1 : gauche, X=-2 : droite, Y=-1 : haut, Y=-2 : bas). Si X et Y sont précisés et positifs, la position de l'icône est (X, Y). Si Shortcut est précisé, il s'agit du raccourci-clavier à utiliser pour ouvrir cet objet. Les arguements Args, s'ils sont fournis, seront passés à l'objet lors de son démarrage, s'il s'agit d'un programme. Si le paramètre Update est fixé à "true" et qu'une icône existe déjà sur le punaiseur avec le chemin indiqué, les valeurs seront remplacées au lieu d'ajouter une nouvelle icône.

- PinboardRemove(Path, [Label]) Retire Path du punaiseur. Si Label est précisé, il doit correspondre au label de l'objet. Si plusieurs objets correspondent, un seul est retiré.

- SetBackdropApp(App) Définit App (un dossier-application) comme le "gestionnaire" du fond d'écran du punaiseur courant. Le fichier ``AppInfo.xml`' à l'intérieur de App doit contenir l'élément CanSetBackdrop, ie :

      <?xml version="1.0"?>
      <AppInfo>
      	  <ROX:CanSetBackdrop xmlns:ROX="http://rox.sourceforge.net/SOAP/ROX-Filer"/>
      </AppInfo>

  L'application sera exécutée avec l'option `--backdrop` comme seul argument après avoir invoqué cette méthode, et chaque fois que le punaiseur sera réactivé. N'UTILISEZ PAS cette méthode si vous invoquez l'option `--backdrop`, vous seriez bloqué dans une boucle sans fin ! Voir Backdrop applications pour un guide sur l'écriture d'applications gèrant le fond d'écran.

- SetBackdrop(Filename, Style) Définit l'image de fond d'écran. Si vous souhaitez régénérer l'image lors du prochain login de l'utilisateur, ou si vous voulez la changer automatiquement de temps en temps, utilisez plutôt SetBackdropApp ci-dessus.

- Run(Filename) Exécute le fichier Filename comme s'il était cliqué dans une fenêtre du filer.

- RunURI(URI) Exécute URI comme s'il avait été cliqué dans le filer. URI est interprétée comme une URI, sous la forme file://localhost/chemin.

- Show(Directory, Leafname) Ouvre le dossier Directory et met en évidence le fichier dont le nom est Leafname.

- FileType(Filename) Affiche le type MIME du fichier Filename (en écrivant la réponse SOAP sur la sortie standard).

- SetIcon(Path, Icon) Définit l'icône à utiliser pour le chemin donné. C'est l'équivalent de la commande Fixer l'icône... du menu Fichier.

- UnsetIcon(Path) Supprime l'association entre l'icône à utiliser et le chemin donné.

Les appels suivants peuvent être utilisés pour commencer de nouvelles actions sur objets. Quiet (NDT : "Silencieux") est un booléen et peut prendre la valeur "vrai" (via `yes`, `true` ou `1`) si l'opération doit commencer immédiatement plutôt que d'attendre la confirmation de l'utilisateur. S'il prend la valeur "faux" (via `no`, `false` ou `0`), l'utilisateur doit toujours confirmer. S'il est omis, la valeur par défaut est utilisée.

- Copy(From, To, [Leafname, Quiet]) Copie tous les fichiers spécifiés en From vers le dossier spécifié en To. Si Leafname est précisé, From ne devra fournir qu'une seule entrée ; Leafname donnera alors le nouveau nom du fichier.

- Move(From, To, [Leafname, Quiet]) Déplace tous les fichiers spécifiés en From vers le dossier spécifié en To. Si Leafname est précisé, From ne devra fournir qu'une seule entrée ; Leafname donnera alors le nouveau nom du fichier.

- Link(From, To, [Leafname]) Crée un lien symbolique pour tous les fichiers spécifiés en From dans le dossier spécifié en To. Si Leafname est précisé, From ne devra fournir qu'une seule entrée ; Leafname donnera alors le nouveau nom du fichier.

- Mount(MountPoints, [OpenDir, Quiet]) Monte tous les dossiers spécifiés par MountPoints. Si OpenDir a la valeur `true`, tous les dossiers seront ouverts après leur montage.

- Unmount(MountPoints, [Quiet]) Démonte tous les dossiers spécifiés par MountPoints.

## References

[ROX] The ROX desktop, http://rox.sourceforge.net

[RISC OS] RISC OS, http://www.riscos.com

[GTK+] GTK+ Toolkit, http://www.gtk.org

[Glade] Glade - a User Interface Designer for GTK+ and GNOME, http://glade.gnome.org/

[libxml] The XML C library for Gnome http://www.xmlsoft.org

[GNOME] The GNOME desktop, http://www.gnome.org

[DND] The Drag and Drop protocol, http://www.newplanetsoftware.com/xdnd/

[XDS] The X Direct Save protocol, http://www.newplanetsoftware.com/xds/

[BaseDir] The freedesktop.org base directory system, http://www.freedesktop.org/wiki/Standards_2fbasedir_2dspec

[AVFS] AVFS - A Virtual File System, http://sourceforge.net/projects/avf/

[SOAP] Simple Object Access Protocol (SOAP) 1.2 http://www.w3.org/TR/SOAP/

[Vignettes] Thumbnail Managing Standard (Version 0.5) http://triq.net/~jens/thumbnail-spec/

[Wallpaper] Wallpaper backdrop control application http://rox.sourceforge.net/phpwiki/index.php/Wallpaper

[SharedMIME] Shared MIME-info Database (Version 0.16) http://www.freedesktop.org/wiki/Standards_2fshared_2dmime_2dinfo_2dspec

[IconTheme] The freedesktop.org Icon Theme specification http://www.freedesktop.org/wiki/Standards_2ficon_2dtheme_2dspec