1.1. A propos de cette documentation

Ceci est la nouvelle documentation de Fluxbox un gestionnaire de fenêtres pour X. Elle a été créé à partir de l'ancienne documentation HTML avec pour but de la rendre facilement adaptable à différents formats de sortie. Sa source a été écrite en DocBook 4.1, un format qui a été spécifiquement pensé pour la rédaction de documentation.

Je suis la personne responsable de la documentation à ce moment. Mon nom est Tobias Klausmann <mailto:klausman-fluxbox@tuts.net>. Contactez moi pour des questions relatives à la documentation de Fluxbox. Vous pouvez également essayer de m'atteindre sur irc.openprojects.net #fluxbox (Nick: Blackb|rd). Cette documentation a été traduite en français par Monsieur Vincent Carriere <mailto:carriere_vincent@yahoo.fr>. S'adresser à lui pour toutes questions concernant cette traduction.

	Soumissions
	J'accepte à peu près toutes les soumissions de documentations bien rédigées concernant tout ce qui n'est pas couvert ici et qui, d'après l'avis de certains, devraient être ajoutées ; Envoyez-moi simplement un email à l'adresse spécifiée au dessus si vous avez des questions sur la manière dont vous pourriez aider ou simplement si vous avez de la documentation que vous voudriez bien ajouter.

A la fois les sources et les différents formats de documentations comme l'HTML et le PostScript sont disponibles sur le site de Fluxbox. Si vous préferez utiliser un DTD différent ou un autre format de sortie, la source est voter amie, bien que vous aurez probablement besoin de compétence en language DocBook pour modifier les DTDs. Si vous désirez convertir le fichier source dans un autre format que ceux fournis sur le site de Fluxbox, le paquetage docbook2x vous sera utile.

1.2. A propos de Fluxbox

2.1. Installer Fluxbox

Cette section est une contribution de Jason Gillman Jr. "Ircaddict"

De nombreuses distributions fournissent des paquetages binaires de Fluxbox qui rendent l'installation de Fluxbox assez peu douloureuse. Cependant, il existe des raisons pour compiler les sources. Par exemple, la version le plus récente de Fluxbox peut ne pas être disponible. De plus, il peut être intéressant de compiler Fluxbox avec certaines options. Si vous désirez utiliser le paquetage de votre distribution, consultez la documentation pour les distributions. Pour certaines distributions, les paquetages binaires et les sources sont disponibles sur le site de Fluxbox.

Le but de ce document est d'aider les personnes qui sont relativement novices dans l'utilisation d'X window (ou de Linux en général) à compiler et installer le gestionnaire de fenêtre Fluxbox.

    $ tar -xzvf fluxbox-0.1.12.tar.gz

    $ ./configure
    $ make

    # make install

   exec /usr/local/bin/fluxbox

   $ chmod 700 .xinitrc

   $ mkdir .fluxbox

3.1. Introduction

Fluxbox est fourni avec un assortiment d'outils qui rendent la vie plus facile ou apportent des fonctionnalités intéressantes. Par défaut, ils sont installés à la même place que le binaire de fluxbox, souvent /usr/local/bin à moins que vous ayez utilisé un préfixe différent durant la configuration. La plupart des distributions choisissent aussi un emplacement différent, donc si vous avez utilisé un paquetages binaires, vous les trouverez dans /usr/bin.

3.2. fbrun

fbrun est l'équivalent de la boite de dialogue "Run..." présente dans d'autres gestionnaires de fenêtres. C'est un moyen aisé de démarrer des programmes qui ne sont pas présent dans le menu racine (ou nécessitant un certain réglage de paramètres pour une exécution particulière).

Une autre manière d'employer fbrun peut être utile afin d'appeller depuis le menu une commande que vous pourrez éditer puis exécuter. Un exemple pourrait être l'exécution de ssh sur un nom d'hôte très long et avec de nombreuses options changeant tout le temps. Dans ce cas, vous pouvez ajouter une entrée au menu avec fbrun contenant toutes les options et le nom d'hôte. Quand vous utiliserez cette entrée, vous pourrez éditer la ligne et l'exécuter.

fbrun a plusieurs options :

   -font [nom de la fonte]     Fonte du texte
   -title [nom du titre]       Nom du titre
   -text [texte]               Texte à exécuter
   -w [largeur]                Largeur de la fenêtre en pixels
   -h [hauteur]                Hauteur de la fenêtre en pixels
   -display [affichage]        Nom de l'affichage
   -pos [x] [y]                Position de la fenêtre en pixel
   -fg [couleur]               Couleur du texte
   -bg [couleur]               Couleur de l'arrière plan
   -a                          Lissage des fontes
   -hf [historique]            Fichier d'historique à charger (défaut ~/.fluxbox/history)
   -help                       Affiche cette aide

La plupart de ces options devraient être suffisamment explicatives. Les options -text et -hf nécessitent certainement plus d'explications. La première est utilisée pour spécifier le texte préchargé (et éditable) à l'intérieur de la fenêtre de fbrun. Si vous désirez entrer des arguments multiples (comme ssh -X -f ), soyez sûr d'encadrer votre commande par des guillemets :

	fbrun -text "ssh -X -f"

L'option -hf détermine le fichier d'historique, qui est l'endroit où fbrun garde en mémoire les commandes que vous avez utilisé (de la même manière que bash). Si vous n'utilisez pas cette option, alors le fichier par défaut sera utilisé. Elle peut devenir utile si vous possédez de multiples entrées fbrun dans votre menu et que vous souhaitez séparer les historiques pour chacunes d'entre elles.

3.3. fluxbox-generate_menu

FIXME: Cette section doit être rédigée prochainement.

4.1. Une introduction aux onglets

Les onglets (NdT: tabs) de Fluxbox ne sont en aucun cas une idée neuve. L'implémentation de ce concept est déjà présente dans le gestionnaire de fenêtres PWM. La manière dont cela fonctionne est la suivante : les fenêtres sont groupées ensemble, et elles partagent la même géométrie- elles ont la même taille, exactement la même position, et le même comportement lorsqu'on les déplace. Pensez à cela comme à une pile de feuilles. Les onglets sont semblables à un petit marque-page que vous pouvez coller sur les feuilles afin de retouver une feuille facilement et rapidement.

C'est exactement ainsi que fonctionne les onglets dans fluxbox. En sélectionnant simplement l'onglet correspondant à la fenêtre que vous désirez, cette fenêtre apparaitra au sommet de la pile de fenêtres. Maintenant, essayons cela.

Les Bases des Onglets

La première chose à se rappeler est que toutes les manipulations concernant les tabs utilisent le troisième bouton de la souris. Donc, pour commencer, choisissez deux fenêtres que vous aimeriez grouper ensemble. Cliquez sur l'onglet de la première fenêtre et glissez-le sur l'onglet de la deuxième fenêtre. Félicitations, les fenêtres sont collées ensemble ! Vous pouvez maintenant utiliser les onglets pour passer d'une fenêtre à une autre.

Pour dégrouper une fenêtre, c'est la même chose. Cliquez (toujours avec le troisième bouton) sur l'onglet groupé et glissez-le autre part.

4.2. Manipulation avancée des Onglets

    session.tabs:   true

---

4.2.5. Groupement automatique des Onglets

Vous pouvez avoir envie de grouper certaines applications dès le démarage. C'est possible et cela s'appelle en toute logique groupement automatique (Autogrouping). Cette partie explique comment ça marche. Avant tout, vous devez avoir Fluxbox v0.1.11 ou plus. Le groupement automatique ne marche pas avec les versions plus anciennes. Ensuite vous devez créer le fichier ~/.fluxbox/groups si il n'existe pas déjà. Puis, éditez votre fichier ~/.fluxbox/init et ajoutez cette ligne :

         session.groupFile:		~/.fluxbox/groups

Ok, tout est en place. Maintenant vous devez simplement remplir le fichier de groupement.

Format du fichier de groupement

Il y a un groupe par ligne et il faut juste taper le nom de l'instance du programme qui devra être groupé. Exemple :

Example 4-1. Exemple des fichiers de groupement

    Navigator nedit
    xterm

Cela va créer deux groupes, un avec netscape et nedit et un autre avec xterm. La nouvelle fenêtre sera uniquement groupée avec les autres fenêtres du même bureau et à la derniere fenêtre selectionnée. Le nom des instances a ajouter dans le fichier sont donné par:

    xprop |awk '/WM_CLASS/{print $4}'

et par un clic sur la fenêtre. Si cela n'affiche rien du tout, essayez de modifier $4 par $3.

Groupement Automatique depuis les Onglets

Cela vous permet de faire apparaitre le menu principal en faisant un clic droit sur l'onglet. En selectionnant une application, elle démarrera groupée à l'onglet.

Grouper de cette manière peut mal interférer avec le groupement automatique normal.

5.1. Le Keygrabber

Cela fonctionne de manière similaire à bbkeys, qui est un outil excellent mais souffre de limitations (et avait une licence incompatible), mais avec une toute nouvelle syntaxe pour le fichier de configuration, ainsi que deux ou trois fonctionnalités qui rendent Fluxbox encore plus puissant.

En premier lieu, le nouveau "keygrabber" supporte les "chaînes de séquences de touches" (pensez à emacs)... donc vous pouvez par exemple avoir Mod1 + M + Mod1 + F pour aller au bureau suivant (mais tout le monde ne veut pas avoir cette séquence de touches particulière).

Et si vous tapez une partie de la séquence mais que vous décidez de ne pas continuer (avorter) vous pouvez taper une autre séquence de touches (que vous avez configuré dans votre fichier "keys") pour simplement avorter (avec: AbortChain).

En plus de cela, vous pouvez maintenant lier une séquence de touches pour passer des fenêtres liées aux fenêtres dockées (ndt : joined/docked, en anglais) d'un groupe (avec: NextTab et PrevTab)!

Finalement, pour votre facilité (ou plutôt celle de vlaad et tarzeau) nous vous avons concocté deux scripts (ils font tout les deux la même chose) pour convertir un fichier de configuration bbkeys en un fichier "keys" de fluxbox. (les modes d'emploi de ces scripts sont décrits à l'intérieur de ceux-ci). Download: convertkeys ou convertkeys2.

    Mod1 Tab :NextWindow
    Mod1 F1 :Workspace1
    Mod1 F2 :Workspace2
    Mod1 F3 :Workspace3
    Mod1 F4 :Workspace4
    Control n Mod1 n :NextTab

Donc, comme vous pouvez le constater, il y a d'abord un "modificateur" (ndt : "modifier" en anglais), ensuite une touche (puis un modificateur et encore une touche, si vous voulez avoir une séquence plus longue) et finalement deux points et une action.

Pour une liste des actions valides, lire un peu plus bas dans ce document. :)

En quoi est-ce bon pour vous? Et bien, maintenant vous pouvez maîtriser votre xmms, par exemple :

    Mod1 P :ExecCommand xmms -p
    Mod1 F :ExecCommand xmms -f

Si vous avez des touches additionnelles (par ex. touches multimedia), vous pourrez contrôler xmms de cette manière:

    None XF86AudioPlay :ExecCommand xmms -u
    None XF86AudioStop :ExecCommand xmms -s

Je vous conseille de consulter xmms --help pour de plus amples informations, mais je parie que vous êtes déjà en train de le faire...

5.2. Noms des touches

Vous vous demandez probablement comment trouver le nom des touches. Exécutez xev, bougez votre souris vers la nouvelle fenêtre créée, appuyez sur une touche et regardez ce qui s'affiche. Ici un exemple de ce que cela donne après avoir pressé la touche de la flèche droite :

    KeyPress event, serial 18, synthetic NO, window 0x2c00001,
    root 0x60, subw 0x0, time 3745737930, (373,380), root:(504,526),
    state 0x10, keycode 102 (keysym 0xff53, Right), same_screen YES,
    XLookupString gives 0 characters:  ""

La partie intéressante est le nom de la touche, qui est donné dans la parenthèse avec keysym. Dans cet exemple, on lit (keysym 0xff53, Right). Ainsi le nom de la touche est Right.

Touches spéciales

Ci après sont donnés, pour votre confort, des noms de touche spéciale. Notez qu'ils peuvent être affichés par xev immédiatement après avoir pressés les touches (mais non comme un modificateur d'autres touches).

5.3. Actions

1. NextWindow / PrevWindow

NextWindow/PrevWindow prend un argument numérique, ce qui est peu difficile à expliquer à l'intérieur du tableau ci-dessus. Voilà comment cela fonctionne. L'argument entier qui défini les options sont prises dans la table ci dessous et utilisées avec l'opérateur OR : Valeur du Bit Option 1 Naviguer entre les onglets réduits (Traiter les groupes de tabs comme une seule fenêtre) 2 Naviguer entre les fenêtres collées 4 Naviguer entre les fenêtres ombrées Aditionnez les nombres ci dessus pour spécifier plusieurs options. Le résultat est le paramètre pour NextWindow/PrevWindow. Vous pouvez prendre ces valeurs dans la table suivante : Paramètre Options 0 Pas de skipping 1 Naviguer entre les onglets réduits 2 Naviguer entre les fenêtres collées 3 Naviguer entre les onglets réduits/fenêtres collées 4 Naviguer entre les fenêtres ombrées 5 Naviguer entre les onglets réduits/fenêtres ombrées 6 Naviguer entre les fenêtres collées/fenêtres ombrées 7 Naviguer entre les onglets réduits/fenêtres collées/fenêtres ombrées

	2. HorizontalIncrement / HorizontalDecrement / VerticalIncrement / VerticalDecrement
	Je dis "une unité" quand je décris le redimensionnement. C'est en particulier à cause des xterm/aterm/Eterm qui, au lieu d'ajouter un pixel, ajoutent un caractère d'espace. Les autres programmes devraient être redimensionner d'un pixel.

8.1. Configurer l'emplacement du Fichier Menu

Le fichier Menu de Fluxbox est, par défaut, ~/.fluxbox/menu.. Ceci peut être changé via le fichier init. Voici un exemple de la ligne :

    session.menuFile:       ~/.fluxbox/menu

Changez simplement /path/to/filename si vous désirez utiliser un fichier menu différent. La structure courante, cependant, devrait convenir pour la plupart des personnes.

8.2. Commandes Disponibles

Le menu de Fluxbox est juste un fichier texte qui vous permet d'insérer des sous-menus, de lancer des applications, de contrôler les bureaux, de configurer fluxbox, et de sortir de X. Le menu peut recevoir les commandes suivantes :

    [begin] (TitreduMenu)
    [submenu]  (NomduSousMenu) {TitreduSousMenu}
    [exec] (Nom_de_l'Application) {/path/to/programme}
    [include] (/path/to/fichier_menu)
    [end]
    [nop] (--------)
    [workspaces] (NomduSousMenu)
    [stylesdir] (/path/to/répertoire_des_styles)
    [config] (ConfigurationdeFluxbox)
    [reconfigure] (Reconfiguration)
    [restart] (Redémarrer)
    [exit] (Sortir)

La plupart de ces commandes devraient être suffisamment parlantes sur leur fonction. Les mots entre parenthèses sont ceux qui seront affichés sur votre écran . Je vais expliquer les "items" plus difficiles à comprendre un peu plus loin.

[nop] - Ceci vous permet de mettre du texte (ou rien du tout) mais n'exécute absolument rien ; cela agit comme un séparateur dans votre menu.

[reconfigure] - Si vous utilisez le menu pour configurer Fluxbox, les changements seront perdus après avoir quitté Fluxbox. Ces changements ont besoin d'être écrit dans le fichier init afin d'être permanents; ceci peut être effectué en choisissant reconfigure après avoir fait les changements.

[restart] - Je veux juste être sûr que les gens sachent que restart redémarre seulement Fluxbox, et non le système entier.

Et comme toujours, pour plus de référence, nous vous proposons un fichier de menu d'exemple avec Fluxbox.

9.1. Bases des Thèmes

Contribution par : Justin Rebelo rebelo@shaw.ca aka "demerol".

Qu'est-ce qu'un style et comment cela fonctionne-t-il ?

Basiquement, un style est un thème pour Fluxbox. C'est un simple fichier texte ascii qui dit à fluxbox comment générer l'apparence des différent composants du gestionnaire de fenêtres. Les styles sont disposés dans ~/.fluxbox/styles et dans le répertoire global de fluxbox, qui varie selon les méthodes d'installations utilisées..

Comment faire mon propre style ?

Commencez par ouvrir un style dans votre éditeur favori (je recommande vim). Regardez la structure et l'organisation du style. Le simple fait d'observer répondra à beaucoup de questions que vous pourriez avoir.

Structure d'un style :

Le style est fait de plusieurs composants principaux qui ont chacun leurs sous-directives. La barre de menu, le menu et la fenêtre constituent ses composants principaux. La directive window.* contrôle l'apparence de vos cadres de fenêtres et window.tab.* contrôle l'apparence des onglets de fenêtres. menu.* contrôle l'apparence du menu racine qui apparait quand vous faites un clic droit sur le bureau. toolbar.* est la barre que vous voyez en haut ou en bas de l'écran. Le slit (aussi appelé le dock, wharf, etc dans les autres gestionnaires de fenêtres) est contrôlé par les préférences de la barre d'outils.

Puis-je mettre une image/couleur de fond ?

Quelque part dans le fichier de style, vous verrez une ligne qui commence par rootCommand et qui est suivie par une commande (de préférence bsetbg) dont le rôle est de mettre en place une image de fond. Vous pouvez utiliser d'autres rootCommands que bsetbg, mais je ne le recommande pas. bsetbg est en fait une encapsulation d'autres programmes qui configurent réellement le fopnd d'écran. De cette manière, l'utilisateur spécifie quelles rootCommands il préfère et elles seront utilisées par tous les thèmes qui utilisent bsetbg.

Puis-je ajouter des notes/commentaires dans mes styles ?

Bien sûr, commencez simplement la ligne par une dièse (#), un point d'exclamation (!), ou utilisez les commentaires à la C (//).

J'ai encore d'autres questions...

Jetez un oeil aux styles offerts avec fluxbox, vous devriez trouver les réponses dedans, ou encore, essayez d'autres préférences. Si vraiment vous ne trouvez pas les réponses, arrêtez-vous sur #fluxbox sur openprojects. Mon nick est demerol.