ROX-Filer 2.5 - Manuel de l'utilisateur http://rox.sourceforge.net

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).

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=

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.

(require 'gnome)

# 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]

# 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

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 /'

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.

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

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.

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.

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.

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 '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.

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.

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.

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.

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.

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).

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.

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.

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.

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.

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

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.

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

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

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

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.

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.

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.

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 <.

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 :

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...