Glx-Dock / Cairo-Dock

Cairo-Dock utilise des themes et vous pouvez completement changer la maniere dont il se comporte ainsi que son apparence pour en faire un dock unique. Cela n'a pas que des avantages : il y a *beaucoup* d'options
Ce tutoriel n'a pas l'ambition de decrire toutes les options (elles sont deja decrites dans la configuration avec des tooltips pour la plupart), mais il vous guidera pour personnaliser votre dock.
Il contient aussi quelques astuces bien utiles.

Ce tutoriel est base sur les versions 2.1.x ou plus de Cairo-Dock. Si votre version est plus ancienne, il est fortement recommande de la mettre a jour pour profiter des dernières améliorations.
Pour obtenir la derniere version utiliser notre depot or recuperer le paquet sur Launchpad ou bien encore intaller a partir des sources.
Tout est explique en detail sur le wiki (http://wiki.glx-dock.org).
N'oubliez pas d'installer les plug-ins.

La premiere fois que vous lancer Cairo-Dock un theme par defaut est selectionne. C'est un theme parmi bien d'autres qui a ete choisi en parti par un vote mais aussi parceque je l'aime bien donc sans doute qu'il ne correspondra pas a vos gouts.
Avant de demarrer la personalisation de votre dock, vous devriez essayer les autres themes disponibles a travers le gestionnaire de themes : click-droit -> Cairo-Dock -> Gestionnaire de theme.
Ordonnez par leur notem ou bien leur simplicite selon votre gout, selectionnez les 2 petites boites en bas de la page, choississez un theme et appliquez. Simple non?

Nous allons choisir le theme Clear" de Coz comme point de depart.


Le theme Clear de Coz pour Cairo-Dock

une bonne habitude a prendre c'est de sauver vos themes apres avoir effectuer vos changements.
Pour sauver le theme en cours, ouvrez le gestionnaire de theme et dans le 2eme onglet entrez un nom pour votre theme puis appliquer

Si vous voulez changer de theme, choississez le dans le 12er onglet et appliquer.
VOus pouvez choisir d'y appliquer le comportement et/ou les launchers, mais dans la pratique vous voudrez sans doute garder les votres aussi soyez sur de deselectionner les 2 boites.

Si vous voulez effacer un theme, c'est sur le 3eme onglet que ca se pass. Selectionner les theme dont vous voulez vous debarrasser et valider, c'est radical.


Pour ouvir la configuration, un click a droite sur le dock, un click sur le menu Cairo-Dock et selectionnez Configuration.
Plusieurs categories sont disponible a gauche. Celle qui nous interresse est la 2eme (Apparence).
Mais d'abord passons en revue la 1ere category qui controle le comportement du dock.

Selectionnez la categorie "Comportement"; elle contient 4 modules (a droite):

• Le 1er, Position, sert a modifier le placement du dock sur votre ecran (et sur quel ecran si vous utilisez Xinerama en multi-ecran).
• Le 2eme, Accessibilite, definit comment vous accedez a vos docks : si il va se cacher automatiquement, si il restera en dessous des autres fenetres ou au contraire si on lui reserve une partie de l'ecran. On y decide aussi si les sous-docks s'ouvriront en cliquant dessus ou en les survolant avec la souris, etc...
• Le 3eme, Barre des taches, est interressant. Vous pouvez activer ou desactiver l'affichage des applications ouvertes a l'interieur du dock. SI vous l'activez, plusieurs option sont a votre disposition et font que le dock peut se comporter comme MacOSX, Windows7 ou bien tout simplement comme Gnome ou KDE. Notez l'option qui vous permet de ferner les applications en utilisant le bouton du mileiu de vore souris.
• Le dernier module, System, regroupe toutes les options que vous n'aurez sans doute jamais besoin de modifier.

Selectionnons maintenant la categorie "Appearance"; une dizaine de modules y sont present; il definisse le look de votre dock.

• Le module Background vous permet de personnaliser tout ce qui concerne le fond de vos docks : cadres, image de fond, etc...
• Le module Icones concerne l'affichage des icones : les themes d'icone, leur taille, leur ordre, etc...
• Le module Etiquettes vous permet de personnaliser la maniere dont le texte au dessus et dans les icones va pparaitre.
• Le module Vues controle comment vos docks et sous-docks seront dessinnes : sur un plan 3D , sur une courbe, sur une parabole, etc...
• Le module Dialogues definit l'apparence de bulles que Cairo-Dock utilise pour les notifications.
• Le module Desklets definit comme les applets sont affichees losrqu'elles sont detachees du dock, et vivent sur votre bureau.
• Le module Indicateurs sert a personnaliser les indicateurs. Ce sont les graphiques qui sont affiches pour indique des choses telle que lorsque vous lacher un objet sur le dock, ou bien encore quelle est la fenetre active, ou quels lanceurs ont ete executes, etc...
• Les autres modules sont la pour les animations et les effets speciaux sur les icones.

Assez de bavardage, allons-y !
Tout d'abord les options d'arriere plan du dock.

• Vous pouvez choisir une image ou bien remplir l'arrière plan avec un dégradé de 2 couleurs. Dans le cas d'une image, vous pouvez aussi choisir de répéter ou d'élargir cette dernière pour remplir le dock.
• Si vous utiliser le auto-hide vous pouvez choisir une image pour remplacer le dock quand il est caché. Pour reafficher le dock survolez cette image (aussi appeler zone de rappel) avec vore souris. Normalement la zone est un rectangle avec une grande longueur et une petite hauteur donc choississez votre image en conséquence au risque de voir l'image élargi.

• Pour compléter il est possible de configurer l'entourage du dock : la rondeur des coins, l'épaisseur et la couleur du cadre autour du dock, etc...

Le theme Clear utilise précédemment avec une couleur d'arrière plan différente.

Occupons nous maintenant des icones elles memes.

• Pour le moment decidons de l'aspect global des iconesAt this point, it is nice to decide of a global icon look. Vous pouvez trouver beaucoup de theme d'icones sur gnome-look.org ou ailleurs. Le dock vous laisse choisir d'utiliser au choix un theme d'icone ou vos propres icones (elles sont situe dans ~/.cairo-dock/current_theme/icons; quand vous chargez un theme depuis le gestionnaire de theme, c'est aussi la que seront mis ces icones). Si vous choississez un theme d'icone, decoche l'option qui indique d'utiliser les icones locales et entrez le nom du theme dans le champ adequat (par exemple Human, Gartoon, Crystal, etc...). Si vous simplement utiliser les icones du theme courant, laissez le champ vide.

Une maniere facile de modifier l'apparence global de vous icones consiste a rajouter un arriere plan sur chacune d'entre elle
An easy way to quickly alter the global look of your icons is also to add a background to each of them. Remplissez pour cela le champ qui va bien avec le chemin vers une image de votre choix.

Occupons nous maintenant de la maniere dont sont affichees les icones

• D'abord nous avons le fameux effet Zoom; ce que vous voulez sans doute regle c'est la taille maximale du zoom : 1.2 donnera un petit effet alors que 2 sera plus prononce.
• Ensuite nous avons la reflexion des icones (pour les vues qui le gere comme la vue 3D ou la vue Curve). Si vos souhaitez reduire la hauteur du dock, une maniere efficace de le faire est de diminuer la hauteur de la réflexion. Une valeur moyenne est normalement un bon compromis.
• Vous pouvez aussi dimensionner les icones en fonction de leur categorie. Ici encore vous pouvez reduire la taille du dock en utilisant de petits icones. 48*48 est une valeur standard.
• finalement on peut ordonner les icones par type. Vous pouvez par exemple placer les applets a gauche et les applications a droite.
• En bonus il y a une opton de dessiner une ficelle qui reliera les icones entre elles. Il vous suffit de mettre son épaisseur a 0 pour s'en débarrasser.

La selection du theme Gartoon comme theme d'icone permet de changer tous vos icones en une seule passe pour donner un look completement different a votre dock

Note :
Vous pouvez aussi changer l'icone d'un seul launcher en cliquant a droite-> modifier le launcher. Indiquer le chemin complet pour accedr a l'image. Le meme principe s'applique pour les applets.

Note 2 :
Pour changer l'icone d'une application active, vous devez d'abord activer l'option "Overwrite X icons with launchers" dans le module Taskbar. En faisant cela vous indiquer a Cairo-Dock d'ignorer les icones fourni par X ,qui peuvent etre quelques fois abominable, et de chercher une icone plus jolie. Maintenant en supposant que Nautilus est actif avec son icone present dans le dock. Il y 2 possibilites :

• Il y a aussi un launcher pour Nautilus dans le dock. Dans ce cas Cairo-Dock utilisera son icone pour l'application.
• Il n'y a pas de launcher et dans ce cas Cairo-Dockcerchera pour uneimage qui s'apppele "nautilus.xxx" ("svg", "png", "xpm") e il y a de grane chance qu'une telle image existe dans le theme d'icone qu'on a choisi precedemment. Si vous preferez utiliser votre propre icone il vous sufit d la placer dans le repertoire d'icone local (~/.cairo-dock/current_theme/icons).

Comment appelez cette image ?
Chaque icone doit avoir le meme nom que la classe de l'application en question. La classe est pour la plupart du temps egale au nom de l'application mais pas toujours
Pour inentifier cette classe faites en sorte que l'application sot active puis dans un terminal lancer la commande suivante : Un petit pointeur va apporter et il vous suffit de cliquer sur l'applicaton en question pour que sa classe s'affiche dans le terminal, par example :
Pour que Cairo-Dock utilise le bon icone vous devez nommer votre icone en utilisant cette classe comme nom. Soit ‘nautilus.svg’ ou bien ‘nautilus.png’ par exemple.

Each dock can be rendered differently from the others. Changing the rendering of a dock will make it appear in a totally different way.
In the "Views" module, you can set the default rendering for docks and sub-docks.
For each sub-dock, you can modify its view (<right click>-> "modify this launcher", same goes for applets).


Switching to another view really changes the rendering of your dock. Here, the "Curve" view.

The "Labels" module lets you configure the labels and quick-infos (Quick-infos are some small texts displayed on the icons to give short information, like the number of files in the Dustbin).
You can set up the font, size, color (a gradation), etc.
To make the text more readable, you may want to draw a background behind them. You can choose the color, transparency, and size of the text background.

The dock interacts with you through dialog bubbles, that can display some message, warning, information, or even ask you question or any value. In the <b>Dialogs</b> module, you can configure their look : color and style of the bubble, font and size of the text, "ok" and "cancel" buttons, etc.
Several styles are available; they change the shape of the bubbles. For instance the "comics" one will make the bubbles look like carton bubbles, whereas the "tooltip" one will give a more classic shape.

Each applet can be detached from the dock and placed on your desktop. This module lets you choose a default decoration for all desklets. Each desklet can also be configured with its own decoration.
You can choose one of the available theme, or define your own (it's just a background and foreground image, with an horizontal and vertical adjustment).

To make a really personnal and original theme, you should personnalize the <b>indicators</b>.
Indicators are small extra drawings that indicates the state of icons/dock. There are indicators for the drag-and-drop, drag-over, active window, and launched launchers.

• The drag-and-drop indicator* is displayed when you drag something over the dock (like a launcher from the Main Menu). It can be some image oriented from top to bottom, like an arrow, some rain, a starfall, etc
• The drag-over indicator is a little emblem displayed on the icon when you drag something on it. It is drawn at 1/3 of the icon's size.
• The active window indicator is drawn on the icon of the currently active window. you can set an image or just a back/foreground color. You should try to make it discret since it is drawn at the same place and size as the icon.
• The launched launcher indicator shows you which indicators have been already launched, if you're using the Taskbar option "mix applications and launchers". It is displayed at the bottom of the icon, and you can adjust its position vertically. It can be a circle, a light, etc. Try to choose something that fits the icon theme and icons shape.

To finish, and if you're running the OpenGL backend, you can easily add some fun to your dock.
The "Animated icons" and "Icon effects" modules will let you define one or more animations/effects when an icon is clicked or hovered by the pointer.
If the effects seems "too much" for you, you can customize each of them, and also choose to draw them behind the icon, to reduce the impact.
The "Illusion" module will let you choose an animation when the icon appear and disappear.

You're almost done ! You can now decide which applet you need, and where you'll place them (in the main dock to keep an eye on them easily, in a sud-dock or on the desktop if it's not needed). You can set up an icon for each of them, or even choose a theme for some of them (Clock, Dustbin, PowerManager, etc).
To go further, you can also try to make your own gauge theme. A gauge is made of some images and an XML file that describes the gauge. See exemples in /usr/share/cairo-dock/gauges.
When you make a personnal theme for an applet (a gauge, a clock, a dustbin, etc), put everything all the files in a folder named with the name you want for your theme, and place this folder into ~/.config/cairo-dock/extras/gauge if it's a gauge, or ~/.config/cairo-dock/extras/clock if it's a clock, etc.




Choose a launcher or an applet, and open its configuration panel (<right click> -> "modify this launcher/applet").
For a launcher, expand the "Extra Parameters", for an applet, go to the first Tab.
There you can set the name of the dock it belongs to. Just set a name that doesn't exist yet, for exemple "dock2"; a new dock will be created with this name, and the icon placed inside it. You can then populate it with other icons in the same way.
At first this dock will be placed at the bottom middle of the screen; to change it, <right click> on it -> "Cairo-dock" -> "set up this dock".
Each of these docks will share the same configuration though, and thus the same look.

There is a way to have many docks with different look, but it requires to launch Cairo-dock many times. Launch cairo-dock normally, and then launch where /path/to/dir will act like the "~/.config/cairo-dock" folder.




Eye-candy is nice, but it has a cost. If you feel your dock is using to much CPU, here are some tricks that can help you.

• The best way to have a smooth dock is to run it with the hardware acceleration (OpenGL). You need a nVidia card, or an Intel with the latest X.org server, and run the dock with the command
  cairo-dock -o
  (If you have an ATI, this will probably not work correctly => (see our wiki))
• You can also configure the dock to be lighter.

Try to descrease the icon size. 48x48 is a good size, and the maximum zoom can be decreased to 1.2 or even less. Also reduce the amount of reflection.
Try to reduce the number of icons into your dock :

• make some sub-docks to group launchers and/or applets by affinity.
• use the TaskBar options to group applications by class, mix applications and launcher, or to display applications of the current desktop only.
• use many root docks, each on a different screen border (see the precedent chapter).

In the "System" module, use the option to only show the labels on the pointed icon.
Also you may try to decrease the refresh frequency (don't go under 20Hz, it might have the opposite effect).
You can also decrease the refresh frequency of some applets. For instance, no displaying the seconds in Clock will make it refresh only once a minute instead of once a second, the amount of RAM can be checked only eash 10s in System-Monitor, etc.
Try to remove some applets, like Cairo-Penguin or Toons.
Try to use the "default" view instead of "3D-plane" or "Curve".




I guess your dock now looks totaly different from what it was at the beginning
I hope this little guide has helped you to not get lost during the configuration. If you have any comment/suggestion, feel free to write me at fabounet (at) users [dot] berlios -dot- de, or pay us a visit at http://glx-dock.org !