blackbox(1) General Commands Manual blackbox(1) NOM blackbox - un gestionnaire de fenetre pour X11 SYNOPSIS blackbox -help | -version blackbox [ -rc fichier_rc ] [ -display affichage ] DESCRIPTION Blackbox est un ajout de plus a la liste des gestionnaires de fenetres pour le Systeme de Fenetres X de l'Open Group, Version 11 Release 6 et au dela. Blackbox est implemente en C++, et ne reprend aucune ligne de code d'un autre gestionnaire de fenetres (bien que l'implementation des graphiques soit similaire a celle de Window Maker). Des l'heure ou la premiere ligne de code fut ecrite, Blackbox a evolue autour d'un principe : le minimalisme. Il n'est pas concu pour etre agreable au regard, ni pour etre le plus riche en fonctionnalites, ni le plus decore pour ressembler a l'interface NeXt, la plus largement connue. Il est simplement concu pour etre rapide. Blackbox fournit des decorations de fenetres configurables, un menu racine pour lancer des applications et une barre-outil qui indique le nom de l'espace de travail courant, le nom de l'application disposant du clavier, et l'heure courante. Il dispose aussi d'un menu pour gerer les espaces de travail (ajout ou suppression). La `fente' (NDT. slit) est utilisable pour accrocher de petites applications, comme la plupart des outils-bb (NDT. bbtools), par exemple. Blackbox fournit une gestion des icones d'un type particulier : lorsqu'on reduit en icone une fenetre, aucun icone n'apparait ; en revanche, le nom de l'application est ajoute dans le sous-menu `Icones' du menu des espaces de travail. Ainsi, votre bureau ne sera jamais embarrasse par une multitude d'icones eparpilles. Comme alternative aux icones, les fenetres fantomes sont mises a disposition : un double-clic sur la barre de titre d'une fenetre la rend fantome (c'est-a-dire que la fenetre disparait et seule sa barre de titre demeure visible). Blackbox utilise ses propres classes graphiques pour produire ses images a la volees. Par l'utilisation de fichiers de styles, vous pouvez tres finement determiner a quoi ressemble votre bureau. Blackbox utilise actuellement son propre protocole pour communiquer avec les clients tels que les pagineurs. Le travail est en cours pour supporter les nouvelles specifications de gestionnaires de fenetres que GNOME et KDE utilisent. OPTIONS Blackbox comprend les options de ligne de commande suivantes : -help Affiche les options de ligne de commande, les fonctionnalites supportees, puis se termine. -version Affiche les informations de version et se termine. -rc fichier_rc Utilise un autre fichier de controle d'execution que celui par defaut ~/.blackboxrc. -display affichage Demarre Blackbox sur l'affichage specifie. Les programmes lances par Blackbox auront egalement la variable d'environnement DISPLAY positionnee a cette valeur. EXECUTER BLACKBOX Le programme est habituellement execute par le script de demarrage de l'utilisateur, la plupart du temps nomme ~/.xinitrc ou ~/.xsession. Pour executer blackbox, modifiez le script en ajoutant exec blackbox en tant que derniere commande executee par le script. Lorsque Blackbox se termine, la session X est egalement terminee. Lorsqu'il demarre, Blackbox essaie de trouver un fichier de menu par defaut dans /usr/share/blackbox/menu. Vous pouvez y configurer un menu global pour les utilisateurs. Lors de l'arret ou du redemarrage, Blackbox enregistre les options par defaut de l'utilisateur dans le fichier ~/.blackboxrc dans le repertoire de l'utilisateur. Certaines ressources de ce fichier peuvent etre editees manuellement. UTILISER BLACKBOX Depuis la version 0.60.x, Blackbox n'assume plus lui-meme la gestion du clavier ; pour cela, il s'appuie sur un programme externe bbkeys(1). Aussi, dans cette section, nous n'abordons que les commandes liees a la souris. Fenetre racine (arriere-plan) : Un clic droit (bouton 3) fait jaillir le menu racine. Par celui-ci, vous pouvez lancer vos applications. Vous pouvez aussi le personnaliser en fonction de vos besoins. Voir ci-dessus pour sa localisation. Un clic central (bouton 2) fait jaillir le menu des espaces de travail. Vous pouvez ajouter ou supprimer un espace de travail, voir les applications qui s'executent sur chacun d'entre eux, voir les fenetres iconifiees, ou passer directement a n'importe quel espace de travail ou application. Cliquer a l'aide du bouton de gauche (bouton 1) sur une application dans le menu des espaces de travail vous place sur cet espace de travail, amene l'application au devant et lui attribue le clavier. Cliquer a l'aide du bouton central (bouton 2) place l'application sur l'espace de travail courant. Barre-Outil : La barre-outil consiste en trois zones : le nom de l'espace de travail, le nom de la fenetre disposant actuellement du clavier et l'horloge. Un clic gauche sur la barre-outil l'amene au devant, un clic central la cache derriere les autres fenetres (si `Toujours au dessus' n'est pas positionne) et un clic droit fait apparaitre un petit menu. En utilisant ce menu, vous pouvez saisir un nom pour l'espace de travail courant (lorsque la saisie est terminee, pressez Entree). Vous pouvez aussi determiner la position de la barre-outil, si elle doit toujours etre visible (c'est-a-dire qu'aucune autre fenetre ne la cache), et si elle doit glisser hors de l'ecran lorsque la souris la quitte. Note : Avec les versions de Blackbox anterieures a la version 0.60.0, un clic droit sur la barre-outil entrainait immediatement la saisie du nom de l'espace de travail. Barre de titre et Bordures des Fenetres : Un clic gauche sur n'importe quelle partie de la bordure d'une fenetre l'amene au devant. Faire glisser la souris (bouton maintenu enfonce) deplace alors la fenetre. Faire glisser les poignees de redimensionnement situees dans les coins au bas de la fenetre permet de changer sa taille. Cliquer avec le bouton central pousse la fenetre en arriere. Cliquer avec le bouton droit sur la bordure ou la barre de titre fait jaillir un menu de fenetre, contenant les commandes suivantes : Envoie vers ... Envoie la fenetre sur un autre espace de travail. Lorsque vous selectionnez l'espace de travail avec le bouton central, Blackbox vous place, avec l'application, sur l'espace de travail selectionne. Fantome Rend la fenetre fantome (affiche seulement sa barre de titre). Iconifie Iconifie la fenetre. L'icone est present dans le sous-menu 'Icones' du menu des espaces de travail. Il n'apparaitra d'*AUCUNE* autre facon sur l'ecran. Maximise Maximise la fenetre ou la restaure a sa taille initiale. Lorsque vous cliquez avec le bouton central sur cet item, la fenetre est seulement maximisee verticalement. Eleve Place la fenetre au dessus des autres. Abaisse Place la fenetre sous les autres. Epingle Epingle la fenetre ou la libere. Une fenetre epinglee sera toujours affichee sur l'espace de travail courant. Massacre Massacre sauvagement (-SIGKILL) le proprietaire de la fenetre. A n'utiliser qu'avec les clients recalcitrants qui refusent de se terminer. Fermer Ferme l'application proprement. Lorsque vous double-cliquez sur la barre de titre d'une fenetre, elle devient `fantome', de sorte que seule la barre de titre demeure visible. Un autre double-clic la rend a nouveau integralement visible. Boutons des Fenetres : Le bouton dans le coin en haut a gauche de la fenetre est le bouton pour iconifier. Cliquer dessus avec n'importe quel bouton de la souris iconifie la fenetre. Le bouton le plus a droite (avec le X) ferme l'application. L'autre bouton a droite (lorsqu'il est present) maximise la fenetre de trois facons differentes : le bouton gauche de la souris produit une maximisation sur tout l'ecran, le bouton central une maximisation verticale et le bouton droit une maximisation horizontale. Pour tout menu : Un clic avec le bouton droit de la souris referme le menu. Cliquer avec le bouton gauche sur la barre de titre de n'importe quel (sous)menu et ensuite le faire glisser quelque part rend ce menu permanent, il ne disparaitra pas lorsque vous cliquerez sur l'un de ses items. Divers : Lorsque vous voulez faire glisser une fenetre, mais que vous ne pouvez voir ni la barre de saisie, ni la barre de titre, vous pouvez presser Alt + bouton 1 n'importe ou dans la fenetre et ensuite la faire glisser ou vous voulez. Vous pouvez utiliser Alt + bouton 1 pour elever une fenetre partiellement visible. Enfin, Alt + bouton 2 abaisse la fenetre, et Alt + bouton 3 permet de modifier sa taille. FICHIER DE MENU Un fichier de menu par defaut est installe dans /usr/share/blackbox/menu. Bien sur, ce menu global pour le systeme peut etre configure pour tous les utilisateurs simultanement. Mais il est egalement possible de creer un menu personnel. Il est habituel de creer un repertoire ~/.blackbox/ (ou ~/blackbox/) dans votre repertoire d'utilisateur, et d'y creer un fichier de menu, par exemple menu, ou d'y copier le fichier du menu global. Ensuite, il faut indiquer a Blackbox de charger votre menu de fichier plutot que celui par defaut. Pour cela il faut ajouter une ressource (ou changer sa valeur) dans le fichier ~/.blackboxrc : session.menuFile: ~/.blackbox/menu Pour que cette modification prenne effet, Blackbox doit etre redemarre. Assurez-vous que le menu est utilisable, puis selectionnez `Redemarrer' dans le menu racine par defaut de Blackbox. Syntaxe du menu La syntaxe du menu est tres simple et tres efficace. Il peut y avoir jusqu'a trois champs sur une ligne de menu. Ils sont de la forme : [etiquette] (libelle ou fichier) {commande ou fichier} Les etiquettes supportees sont les suivantes : [begin] (libelle du menu racine) Indique a Blackbox de commencer l'analyse du fichier de menu. Cette etiquette est obligatoire pour que Blackbox analyse le fichier de menu. S'il ne peut la trouver, le menu par defaut du systeme est utilise a la place. [end] Indique a Blackbox la fin du menu. Ce peut etre un sous-menu ou le menu racine principal. Il doit y avoir au moins une etiquette [end] correspondant a l'etiquette obligatoire [begin]. [exec] (libelle de la commande) {commande shell} Insere un item de commande dans le menu. Lorsque vous selectionnez l'item dans le menu, Blackbox execute `commande shell'. [exit] (libelle pour quitter) Insere un item qui arrete Blackbox et termine. Tout programme en cours d'execution n'est pas ferme. [include] (fichier) Analyse le fichier specifie par fichier et l'inclut dans le menu courant. Le nom de fichier peut etre un chemin d'acces complet a un fichier, ou peut commencer par ~/, ce qui sera remplace par le chemin d'acces complet a votre repertoire d'utilisateur (par exemple [include] (~/blackbox/menustyles) inclut /home/bhughes/blackbox/menustyles dans mon menu). [nop] (libelle - optionnel) Insere un item inoperant dans le menu courant. Il peut etre utilise pour formater un menu en blocs ou en sections. [nop] accepte un libelle, mais il n'est pas obligatoire, et un item vide sera utilise si aucun n'est renseigne. [style] (libelle) {fichier} Demande a Blackbox d'inserer un item qui, lorsqu'il est selectionne, lit le fichier de style fichier et applique les nouvelles textures, couleurs et polices de caracteres a la session en cours. [stylesdir] (repertoire) Lit tous les noms de fichiers (les repertoires sont ignores) du repertoire specifie et cree des items de menu dans le menu courant correspondant aux noms des fichiers. Blackbox suppose que chaque fichier est un fichier de style valide. Lorsqu'un tel item est selectionne par l'utilisateur, Blackbox applique le style a la session en cours. [stylesmenu] (libelle) {repertoire} Cree une entree de sous-menu nommee libelle (qui est aussi le titre du sous-menu), et insere dans ce sous-menu tous les noms de fichiers du repertoire specifie, de la meme facon que [stylesdir]. Les commandes [stylesdir] et [stylesmenu] permettent d'installer de nouveaux fichiers de styles sans avoir a editer le fichier de menu. [submenu] (libelle) {titre du menu - optionnel} Demande a Blackbox de creer et analyser un nouveau menu. Ce menu est insere en tant que sous-menu du menu parent. Comme les menus sont analyses recursivement, il n'y a pas de limite au nombre de niveaux des sous-menus. Le titre du nouveau menu est optionnel ; si aucun n'est renseigne, le titre sera identique au libelle de l'item. Une etiquette [end] est obligatoire pour terminer le sous-menu. [reconfig] (libelle) Lorsqu'on selectionne cet item, Blackbox relit les fichiers du style courant et du menu, puis applique toute modification. Ceci est particulierement pratique pour creer de nouveaux themes ou styles, car ainsi il n'est pas necessaire de redemarrer constamment Blackbox chaque fois que le fichier du style est enregistre. Par ailleurs, Blackbox relit automagiquement le menu chaque fois qu'il a ete modifie. [restart] (libelle) {commande shell - optionnel} Indique a Blackbox de redemarrer. Si `commande shell' est renseignee, Blackbox s'arrete et execute la commande (qui lance habituellement un autre gestionnaire de fenetre). Si la commande est omise, Blackbox se redemarre lui-meme. [config] (libelle) Insere un sous-menu genere par Blackbox, contenant de nombreuses options de configuration telles que la politique de positionnement des fenetres, le mode d'attribution du clavier, le style de deplacement des fenetres, etc. [workspaces] (libelle) Insere dans le menu un lien direct vers le menu des espaces de travail. Ceci est tres pratique pour les utilisateurs ne disposant pas d'une souris a trois boutons. Toute ligne debutant par le caractere `#' est consideree comme un commentaire et n'est pas prise en compte par Blackbox. Dans les libelles, les commandes ou les noms de fichiers, n'importe quel caractere peut etre protege de la facon suivante : [exec] (\(mon super\) \{XTERM\}) {xterm -T \"super XTERM\"} L'utilisation de `\\' insere un back-slash litteral dans le libelle, la commande ou le nom de fichier. Exemple de menu Mixons un peu tout ca. Voici un court exemple de fichier de menu : # Fichier de menu Blackbox [begin] (Blackbox 0.77) [exec] (rxvt) {rxvt -ls} [exec] (Mozilla) {mozilla} [exec] (The GIMP) {gimp} [submenu] (Gestionnaire de fenetres) [exec] (Edition Menus) {nedit .blackbox/Menu} [submenu] (Style) {Quel Style ?} [stylesdir] (~/.blackbox/styles) [stylesmenu] (Styles Blackbox) {/usr/share/blackbox/styles} [end] [config] (Options de Config.) [reconfig] (Reconfigurer) [restart] (Redemarrer) [end] [exit] (Deconnexion) [end] # Fin du fichier de menu STYLES Pour determiner l'apparence generale des bordures de fenetres, des menus et de la barre-outil, Blackbox recourt a des fichiers specifiques contenant des ressources X(1). Ces dernieres permettent de specifier les couleurs, les textures et les polices de caracteres. L'installation par defaut de Blackbox fournit quelques fichiers de style. Ils sont habituellement copies dans /usr/share/blackbox/styles. Vous pouvez etudier ou editer ces fichiers pour comprendre comment fonctionnent les styles dans Blackbox. Les commandes [style], [stylesdir] et [stylesmenu] placees dans votre fichier de menu vous permettent de changer de style a la volee en le selectionnant simplement dans votre menu. Vous pouvez aussi creer un repertoire dans votre repertoire d'utilisateur (habituellement nomme ~/.blackbox/styles) et y placer vos propres styles. Vous avez bien sur le choix dans le nom du repertoire, mais de nombreux styles a telecharger s'appuient sur le nom styles (selon le modele de nom de bb.themes.org). Pour comprendre comment les styles fonctionnent, vous devez avoir une legere connaissance sur le fonctionnement des ressources X. Les ressources X consistent en une cle et une valeur. La cle est constituee d'un certain nombre de cles plus petites (parfois referencees sous le nom d'enfants), delimitees par un point (`.'). Les cles peuvent aussi contenir une asterisque (`*') qui sert de joker, ce qui signifie qu'une seule ligne de texte saisie peut correspondre a plusieurs cles. Ce cas est tres utile lorsque le style est base sur une ou deux couleurs. Blackbox vous autorise a configurer ses quatre composants principaux : la barre-outil, la fente, les menus et la decoration des fenetres. La petite fenetre qui affiche la position (x,y) pendant que vous deplacez une fenetre emprunte son style aux barres de titre des fenetres. Voici quelques exemples rapides : toolbar.clock.color: green Ici, la valeur `green' (vert) est affectee a la ressource couleur de l'horloge presente sur la barre-outil. menu*color: rgb:3/4/5 Dans cet exemple, la valeur `rgb:3/4/5' est affectee a la ressource couleur du menu et a tous ses `enfants'. (Pour une description des noms de couleurs, voir X(1) ). Ainsi, elle s'applique aussi a menu.title.color et menu.frame.color. *font: -b&h-lucida-medium-r-normal-*-*-140-* Cet exemple positionne a la meme valeur la ressource police de caractere de toutes les cles. (Pour des informations sur les fontes installees sur votre systeme, vous pouvez utiliser des programmes tels que xfontsel(1), gtkfontsel, ou xlsfonts(1) ). Mais ce qui rend Blackbox si spectaculaire, c'est sa capacite a produire des textures a la volee. Les descriptions de textures sont specifiees d'une facon semblable a celle des couleurs illustree precedemment. Par exemple : toolbar.clock: Raised Gradient Diagonal Bevel1 toolbar.clock.color: rgb:8/6/4 toolbar.clock.colorTo: rgb:4/3/2 Pas de panique ! Nous expliquons tout de suite. La description d'une texture est composee d'au plus cinq champs, qui peuvent prendre les valeurs suivantes : Flat / Raised / Sunken donne au composant un aspect plat (Flat), bombe (Raised) ou enfonce (Sunken). Gradient / Solid indique a Blackbox d'utiliser une couleur uniforme (Solid) ou d'appliquer une texture degradee (Gradient). Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid selectionne le type de texture : horizontal, vertical, diagonal (d'en haut a gauche a en bas a droite), diagonal croise (Crossdiagonal - d'en haut a droite a en bas a gauche), croisement de tuyaux (Pipecross), elliptique (Elliptic), rectangulaire (Rectangle) ou pyramidal (Pyramid). Cela n'est utile que lorsque Gradient est egalement specifie ! Interlaced indique a Blackbox d'entrelacer la texture (une ligne sur deux est assombrie). Cette option est plus couramment utilisee avec les textures degradees, mais depuis Blackbox version 0.60.3, elle est aussi disponible avec les textures uniformes. Bevel1 / Bevel2 indique a Blackbox quel type de relief utiliser. Bevel1 est le relief par defaut. L'ombre est placee au bord de l'image. Bevel2 est une alternative. Le trait d'ombre est place a un pixel du bord de l'image. A la place de la description d'une texture, l'option ParentRelative est aussi disponible, ce qui rend le composant semblable a son parent, autrement dit il est totalement transparent. Toutes les textures degradees sont composees de deux valeurs de couleur : les ressources color et colorTo. color represente la couleur initiale et colorTo la couleur finale du degrade. Lorsque Interlaced est utilise conjointement au mode Solid, la ressource colorTo est utilisee pour specifier la couleur d'entrelacement. Bien, voici la liste complete des composants, avec le type de valeur qu'ils acceptent. Les commentaires sont precedes d'un point d'exclamation (!), qui est aussi utilise pour les commentaires dans le fichier de style Blackbox, tout autant que dans les fichiers de ressources X. ! La barre-outil elle-meme. toolbar: Texture toolbar.color: Couleur toolbar.colorTo: Couleur ! Les boutons de la barre-outil. toolbar.button: Texture ou ParentRelative toolbar.button.color: Couleur toolbar.button.colorTo: Couleur ! Couleur des fleches des boutons. toolbar.button.picColor: Couleur ! Boutons dans l'etat enfonce (clique). toolbar.button.pressed: Texture (p.ex. Sunken) ou ParentRelative toolbar.button.pressed.color: Couleur toolbar.button.pressed.colorTo: Couleur ! Couleur des fleches des boutons dans l'etat enfonce (clique). toolbar.button.pressed.picColor:Couleur ! Le libelle de l'espace de travail sur la barre-outil. toolbar.label: Texture ou ParentRelative toolbar.label.color: Couleur toolbar.label.colorTo: Couleur toolbar.label.textColor: Couleur ! Le titre de la fenetre active sur la barre-outil. toolbar.windowLabel: Texture ou ParentRelative toolbar.windowLabel.color: Couleur toolbar.windowLabel.colorTo: Couleur toolbar.windowLabel.textColor: Couleur ! L'horloge sur la barre-outil. toolbar.clock: Texture ou ParentRelative toolbar.clock.color: Couleur toolbar.clock.colorTo: Couleur toolbar.clock.textColor: Couleur ! Comment le texte de la barre-outil doit etre aligne. ! Centre (center), a gauche (left) ou a droite (right). toolbar.justify: center, left, or right ! Police de caracteres a utiliser avec tous les composants de la barre-outil. toolbar.font: Fonte (p.ex. -*-helvetica-medium-r-normal-*-*-100-*) ! Barre de titre du menu. menu.title: Texture menu.title.color: Couleur menu.title.colorTo: Couleur menu.title.textColor: Couleur menu.title.font: Fonte menu.title.justify: center, left ou right ! Le menu lui-meme. menu.frame: Texture menu.frame.color: Couleur menu.frame.colorTo: Couleur menu.frame.textColor: Couleur menu.frame.disableColor: Couleur menu.frame.font: Fonte menu.frame.justify: center, left ou right ! Les bulles pour les sous-menus. ! Vide (empty), triangle (triangle), carre (square), losange (diamond). menu.bullet: empty, triangle, square ou diamond menu.bullet.position: right or left ! Un item de menu sur-ligne. menu.hilite: Texture (p.ex. Raised) menu.hilite.color: Couleur menu.hilite.colorTo: Couleur menu.hilite.textColor: Couleur ! Une fenetre disposant du clavier (active). window.title.focus: Texture window.title.focus.color: Couleur window.title.focus.colorTo: Couleur ! Une fenetre ne disposant pas du clavier (inactive). window.title.unfocus: Texture window.title.unfocus.color: Couleur window.title.unfocus.colorTo: Couleur ! Titre de la fenetre. window.label.focus: Texture ou ParentRelative window.label.focus.color: Couleur window.label.focus.colorTo: Couleur window.label.focus.textColor: Couleur window.label.unfocus: Texture ou ParentRelative window.label.unfocus.color: Couleur window.label.unfocus.colorTo: Couleur window.label.unfocus.textColor: Couleur ! Barre de saisie. window.handle.focus: Texture window.handle.focus.color: Couleur window.handle.focus.colorTo: Couleur window.handle.unfocus: Texture window.handle.unfocus.color: Couleur window.handle.unfocus.colorTo: Couleur ! Poignees de redimensionnement. window.grip.focus: Texture window.grip.focus.color: Couleur window.grip.focus.colorTo: Couleur window.grip.unfocus: Texture window.grip.unfocus.color: Couleur window.grip.unfocus.colorTo: Couleur ! Boutons de fenetre. window.button.focus: Texture ou ParentRelative window.button.focus.color: Couleur window.button.focus.colorTo: Couleur window.button.focus.picColor: Couleur window.button.unfocus: Texture ou ParentRelative window.button.unfocus.color: Couleur window.button.unfocus.colorTo: Couleur window.button.unfocus.picColor: Couleur window.button.pressed: Texture (p.ex. Sunken) window.button.pressed.color: Couleur window.button.pressed.colorTo: Couleur ! Cadre autour de la fenetre. window.frame.focusColor: Couleur window.frame.unfocusColor: Couleur ! Police de caracteres et alignement. window.font: Fonte window.justify: center, left ou right ! Diverses ressources. ! Une bordure peut etre dessinee autour de tous les composants. borderWidth: un nombre de pixels, p.ex. 1 borderColor: Couleur ! Epaisseur des reliefs. bevelWidth: un nombre de pixels > 0 ! Epaisseur de la barre de saisie. handleWidth: un nombre de pixels > 0 ! Largeur du cadre des fenetres (depuis la version 0.61). ! Lorsqu'il n'est pas specifie, la valeur de bevelWidth est prise par defaut. frameWidth: un nombre de pixels >= 0 ! Cette commande est executee chaque fois que le style est selectionne. ! Typiquement, elle place une belle image sur la fenetre racine. rootCommand: Commande shell, p.ex. bsetroot -mod 4 4 -fg rgb:5/6/6 -bg grey20 ! Certains bbtools lisent ces vieilles ressources de la version 0.51. menuFont: Fonte titleFont: Fonte Cette liste est certes longue, mais rappelez vous lorsque vous creez votre propre style que vous pouvez facilement positionner beaucoup de cles en une seule ligne, par exemple : *color: slategrey *colorTo: darkslategrey *unfocus.color: darkslategrey *unfocus.colorTo: black *textColor: white *unfocus.textColor: lightgrey *font: lucidasans-10 Cela specifie deja des valeurs par defaut sympathiques pour pas mal de composants. LA FENTE La fente est une fenetre speciale qui peut contenir des applications << accrochables >> (NDT. dockable), par exemple les `outils-bb' (NDT. `bbtools') ou les `dockapps' de WindowMaker. Lorsque des applications s'executent dans la fente, elles n'ont pas de bordure propre ; en revanche, elles sont encastrees dans la fente et elles sont toujours visibles sur l'espace de travail courant. Vous pouvez cliquer avec le bouton 3 sur le bord de la fente afin de faire apparaitre un menu permettant de configurer sa position, son orientation et si elle doit disparaitre lorsque la souris n'est plus positionnee au dessus d'elle. La plupart des applications accrochables utilise l'option -w pour s'executer dans la fente. Par exemple, vous pouvez placer dans votre fichier ~/.xinitrc : bbmail -w & bbpager -w & exec blackbox Bien sur, pour utiliser la fente, vous devez avoir compile Blackbox en activant le support de la fente (c'est l'option par defaut). FICHIER DE RESSOURCES Habituellement, le fichier de ressources ~/.blackboxrc est cree et maintenu par Blackbox lui-meme. Toutes les options du menu [config] (depuis la version 0.60.x), le dernier fichier de style selectionne, le nom des espaces de travail, etc. sont automatiquement enregistres dans ce fichier. Cependant, il y a quelques ressources que vous pouvez vouloir editer vous-meme : session.menuFile: Indique a Blackbox quel fichier de menu doit etre charge. session.screen0.toolbar.widthPercent: Determine la proportion (en %) de la largeur de l'ecran qui sera occupee par la barre-outil. La valeur par defaut est : 66. session.screen0.strftimeFormat: Specifie le format d'affichage de l'heure courante sur la barre- outil. La syntaxe du format est celle de la fonction strftime(3). La valeur par defaut est : %I:%M %p. session.autoRaiseDelay: Specifie le delai (en ms) avant que la fenetre disposant du clavier ne soit elevee au premier plan. La valeur par defaut est : 250. session.doubleClickInterval: Specifie le delai (en ms) en dessous duquel Blackbox considere deux clics consecutifs comme un double-clic. La valeur par defaut est : 250. session.screen0.edgeSnapThreshold: Lorsque vous deplacez une fenetre sur l'ecran, Blackbox peut `l'aimanter' aux extremites de l'ecran afin de faciliter son positionnement. Ce parametre indique a Blackbox la distance (en pixels) a partir de laquelle la fenetre se collera automatiquement aux bords. La valeur par defaut est : 0. session.cacheMax: Cette ressource indique a Blackbox quelle quantite de memoire (en Ko) il peut utiliser pour conserver les pixmaps en cache sur le serveur X. Si votre machine tombe a court de memoire, vous pouvez diminuer cette valeur. Elle est par defaut a : 200. session.cacheLife: Indique a Blackbox combien de temps (en minutes) les pixmaps inutilises demeurent dans la memoire du serveur X. La valeur par defaut est : 5. session.colorsPerChannel: Indique a Blackbox combien de couleurs doivent etre reservees sur le serveur X pour les affichages en mode pseudocolor. Un `channel' (NDT. canal) peut etre rouge, vert ou bleu. Blackbox alloue un nombre de couleurs correspondant a cette valeur puissance 3 et les rend toujours disponibles. Cette valeur doit etre comprise entre 2 et 6. Lorsque vous executez Blackbox sur un affichage 8 bits, vous devez positionner cette ressource a 4. La valeur par defaut est : 4. Lorsque vous executez Blackbox dans un environnement disposant de plusieurs ecrans, la cle screen0 peut aussi etre screen1, 2 etc. pour tout ecran approprie. ENVIRONNEMENT HOME Blackbox utilise $HOME pour trouver le fichier .blackboxrc, et pour resoudre le nom du fichier de style ou les noms de repertoires. DISPLAY Lorsqu'aucun autre affichage n'a ete specifie en ligne de commande, Blackbox s'execute sur l'affichage designe par cette variable. AUTEURS et CREDITS Tout le code a ete initialement ecrit et maintenu par Brad Hughes (blackbox@alug.org) puis par Jeff Raven (jraven@psu.edu), il est dorenavant maintenu par Sean 'Shaleh' Perry (shaleh@debian.org) avec les contributions et la fusion de patches provenant de nombreux individus de par le monde. L'adresse du site officiel de Blackbox est : http://blackboxwm.sf.net La page des defauts (NDT. bugs) et des demandes de fonctionnalites, ainsi que les versions courantes sont accessibles a : http://sf.net/projects/blackboxwm De nombreux themes et d'autres contributions sont disponibles a : http://bb.themes.org/ Cette page de manuel a ete redigee par Wilbert Berendsen (wbsoft@xs4all.nl) et traduite en francais par Bertrand Duret (bertrand.duret@libertysurf.fr). De nombreuses autres traductions seront bientot disponibles. VOIR AUSSI bsetroot(1), bbkeys(1) 0.62.? Fevrier 2002 blackbox(1)