✎ gnome_dock [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Barre de lancement : Cairo-Dock ======

===== Présentation =====

Gnome-dock (écrit initialement par un certain MacSlow, mais qui a été abandonné) est une barre de lancement d'applications animée qui apparaît sur le bureau. Celle-ci est compatible avec [[Beryl]], [[Compiz]] ou Metacity+xcompmgr, XFCE (avec le gestionnaire de composite de xfwm4 activé), et probablement avec KDE depuis que Kwin gère la composition d'affichage.

Ce dock a été conçu à la base comme un programme de test de la libcairo, une bilbiothèque de dessin vectoriel. L'idée était séduisante mais peu fonctionnelle, et [[http://forum.ubuntu-fr.org/profile.php?id=5951|je]] l'ai donc reprise pour en faire un vrai dock utilisable. Je l'appellerai désormais //Cairo-Dock//.

[[http://www.gnome-dock.org/trac/wiki|Page du projet initial.]]

[[http://forum.ubuntu-fr.org/viewtopic.php?id=131714&p=1|Fil de discussion]] sur le forum ubuntu-fr.org où je présente les améliorations effectuées.
N'hésitez pas à y faire un tour si vous avez des suggestions pour améliorer le dock ou des remarques ! :-)

<note tip>
Il est en développement intensif, et peut donc contenir des bugs (surtout à la sortie d'une nouvelle version)
J'ai donc ouvert [[https://developer.berlios.de/bugs/?func=addbug&group_id=8724|un compte sur Berlios]], qui permet de **rapporter des bugs** ou faire des **demandes de fonctionnalités**, ou encore télécharger **les sources CVS**. Il vous suffit de vous inscrire pour pouvoir poster les bugs là-bas; l'avantage c'est que je ne risque pas de les oublier ou de passer dessus par inadvertance, ça permet une bien meilleure gestion que des pages de messages dans le forum :-)
</note>

===== Installation =====

Sources et paquet .deb se trouvent à [[https://developer.berlios.de/project/showfiles.php?group_id=8724|cette adresse]] pour les versions jugées plus stables, et à 
[[http://fabounet03.free.fr/|cette adresse]] pour les versions intermédiaires.
Le projet se décompose en 2 parties : la barre en elle-même, et des plug-ins, qui fournissent notamment des applets.
La procédure d'installation de ces derniers étant identiques à celle de la barre, je ne décrirai que l'installation de celle-ci. Simplement les plug-ins s'installent en 2ème.

[[http://forum.ubuntu-fr.org/profile.php?id=25333|Sombrero]] a écrit un script (cairo-dock-update.sh) qui gère le téléchargement et l'installation à chaque nouvelle version. Ce script est maintenant intégré directement dans l'application en faisant un clic droit -> 'Check Updates' sur le dock.

==== Avec le paquet .deb ====

[[:tutoriel:comment_installer_un_paquet|Installez]] d'abord les paquets **libcairo2 librsvg2-2 libglitz1 libglitz-glx1**.

Puis, téléchargez le .deb, et [[:tutoriel:comment_installer_un_paquet|installez-le]].
Vous pouvez utiliser Gdebi depuis la version 1.

==== Par compilation ====

Vous aurez besoin des paquets **build-essential libcairo2-dev libgtk2.0-dev librsvg2-dev libglitz1-dev libglitz-glx1-dev**

Avec cette commande, ça devrait marcher normalement :
''sudo apt-get install build-essential libcairo2-dev libgtk2.0-dev librsvg2-dev libglitz1-dev libcairo2 librsvg2-2 libglitz1 libglitz-glx1 libglitz-glx1-dev''

Pour info, j'ai les paquets autoconf, m4, autotools-dev, pkg-config, libtool, et automake1.9 d'installés, car avec automake1.10, ça ne passe pas.

Téléchargez le .tar.bz2, décompressez-le, placez-vous dans le répertoire ainsi créé dans une console, et tapez : 
  autoreconf -isvf && ./configure --prefix=/usr && make
  sudo make install

Le programme sera installé dans /usr/bin.

==== 1er lancement ====
Au 1er lancement, cairo-dock se configurera tout seul et vous proposera une liste de thèmes au démarrage s'il ne détecte pas de répertoire ~/.cairo-dock (cela vous permet d'avoir une barre fonctionnelle immédiatement, et un panorama des diverses fonctionnalités/options). Si c'est votre 1ère installation, pensez donc à vérifier que vous n'avez pas de répertoire ~/.cairo-dock.

Par la suite si vous voulez tester un autre thème, clique droit sur la barre, et dans le 1er sous-menu choisissez "Choose a theme".

==== Désinstallation / ré-installation ====

Si vous avez installé en compilant les sources, placez-vous dans le répertoire des sources, et tapez :
  sudo make uninstall
Ceci ne supprimera pas le répertoire ~/.cairo-dock ni ce qu'il contient (les lanceurs et le fichier de conf).

Si vous avez installé à partir du paquet, désinstallez le avec votre [[gestionnaire de paquets]] ou [[apt-get]]. Le répertoire .cairo-dock et tout ce qu'il contient ne seront pas effacés, sauf si vous choisissez une suppression complète.

Le fichier de conf n'est pas écrasé durant l'installation s'il existait déjà, Cairo-Dock étant capable de le compléter s'il trouve des champs manquant.

==== Qu'est-ce qu'il installe ? ====
C'est une question qu'on devrait toujours se poser en installant un programme.
Cairo-dock stocke vos lanceurs et vos paramètres dans un répertoire caché //.cairo-dock// votre répertoire perso.
La structure est la suivante (bien que vous n'aurez probablement pas à y rentrer) : 
  ~/.cairo-dock  --> current_theme --> cairo-dock.conf+decorations+readme
                 |                 +--> launchers --> .desktop+icônes
                 +--> themes --> theme1 --> cairo-dock.conf+decorations+readme
                             |          +--> launchers --> desktop+icônes
                             +--> theme2 --> cairo-dock.conf+decorations+readme
                             |           +--> launchers --> desktop+icônes
                             +--> ....
Les thèmes par défaut sont dans /usr/share/cairo-dock/themes, ne sont pas modifiables, et sont mis à jour avec le dock.

Le paquet installe également des thèmes tout prêts dans les répertoires /usr/share/cairo-dock. Vous avez donc une sauvegarde de la config de base sur votre système.
Chaque applet fait de même avec ses propres fichiers.

Il est prévu de le rajouter dans le menu Application, il a déjà son icône (merci à Necropotame !), par contre je n'ai pas trouvé comment le rajouter au .deb, avis aux âmes charitables ! :-)

=====Configuration=====

Configurer son dock est d'une simplicité remarquable.
Une liste de thèmes tout prêts est proposée au 1er démarrage. Cela permet une prise en main facile et rapide du dock.
Après vous vous construirez votre propre thème. Si l'envie vous prend d'en essayer un autre, dans le 1er sous-menu du menu, choisissez "Choose a theme"; il vous proposera à nouveau les thèmes.
Pour configurer cairo-dock, un clique droit sur le dock, option "configurer", fait apparaître un panneau organisé en onglets, chacun représentant un groupe de propriétés parentes.

====Configurer l'appli====

On choisit le 1er champ du menu.
Une fenêtre s'ouvre, avec une liste de champs. Chaque champs est commenté, et on peut changer sa valeur.
Après avoir fait "Valider", le dock rechargera tout seul la nouvelle config.

Les champs sont les suivants :

* __Groupe Position__
Ce groupe représente la **position du dock** sur l'écran.
    * Vous pouvez choisir par rapport à quel bord de l'écran placer votre barre. Les icônes se dérouleront en accord avec ce choix (par exemple si vous le mettez en hait, les icônes se dérouleront vers le bas, et le dock se cachera vers le haut). \\    L'alignement est identique à la notion d'alignement communément utilisée pour les textes. Un alignement de 0 placera donc le dock relativement au coin gauche, un alignement de 1 par rapport au coin droit, et une valeur intermédiaire par rapport à une position intermédiaire le long du bord de l'écran.
    * Les 2 écarts représentent respectivement l'écart par rapport à la position définie par l'alignement ci-dessus, et la distance au bord de l'écran (utile par exemple pour positionner le dock au-dessus de la barre des tâches de gnome).
    * Enfin vous pouvez demander à cairo-dock de réserver la place qu'il occupe au repos pour lui tout-seul. Dans ce cas, les autres fenêtres seront empêchées (par le gestionnaires de fenêtres) de venir recouvrir cette zone, à la manière de la barre des tâches de gnome.

* __Groupe Auto-Hide__
Ce groupe permet de gérer le cachage automatique du dock, et la **zone de rappel** qui prend la place du dock lorsque celui-ci est caché. Passer la souris dessus a pour effet de rappeler le dock à l'écran.
    * La 1ère case à cocher permet de spécifier si le dock doit se cacher lorsque la souris le quitte, et laisser la place à une zone de rappel dans laquelle il faut placer la souris pour rappeler le dock. Si la case est décochée, le dock reste tout le temps visible.
    * Largeur/hauteur : les dimensions en pixels de la zone qui reste à l'écran lorsque le dock est caché (par défaut, 200x20).
    * Suit un champ dans lequel on met le nom d'une image a placer sur cette zone. Ce peut être un chemin absolu (/chemin/vers/image ou ~/chemin/vers/image), ou bien le nom d'une image contenue dans le répertoire .cairo-dock. On peut aussi ne rien mettre dans ce champ, pour avoir une zone de rappel vide.
    * La transparence de cette image peut être spécifiée (nombre compris entre 0 et 1, à 0 l'image sera complètement transparente, et donc invisible; par défaut:0.5). Si vous mettez 0 et/ou aucune image, la zone de rappel sera totalement invisible, mais bien présente à l'écran.
    * Enfin, vous pouvez spécifier si vous voulez que l'image de la zone de rappel soit inversée lorsque le dock est en haut (par exemple si c'est du texte, décochez la case, si c'est une flèche, cochez-la).

* __Groupe Cairo Dock__
Ce groupe représente les paramètres des **effets visuels** du dock.
    * On peut déjà choisir sa langue, pour les panneaux de config (pas pour les messages). Cela sera effectif à la prochaine ouverture d'un panneau.
    * On peut aussi choisir dans quel ordre afficher les différents types d'icônes; le type placé le plus en haut d ela liste apparaîtra à gauche du dock, le type le plus en bas de la liste apparaîtra à droite. Pour changer cet ordre, sélectionnez un type, et avec les 2 boutons d'à côté, déplacez le vers le haut ou vers le bas.
    * Ensuite, on peut décider d'allouer une taille maximale à la barre. Cela aura pour effet que toutes les icônes ne seront pas visibles (puisque le dock sera plus petit), mais vous pourrez les faire défiler avec la molette de la souris, à la manière d'un **carrousel**. Il est possible de forcer ce mode avec la case juste en-dessous, ce qui aura pour effet de redimensionner le dock de telle manière que les icônes formeront une boucle en 3D. \\    Vous pouvez spécifier si vous voulez que les icônes reviennent à leur position d'origine (= un défilement nul) en quittant le dock, et la vitesse à laquelle elles y reviennent. \\    Si vous fixez la taille maximale à 0, cela aura pour effet de laisser Cairo-Dock s'adapter automatiquement à la taille de l'écran.
    * Puis vient les paramètres de la "vague" : son amplitude maximale (le facteur de zoom maximal appliqué aux icônes sera donc de 1+A, si A est l'amplitude) et la largeur sur laquelle s'étale la vague (en pixels, en dehors de cet intervalle centré sur le pointeur de la souris, la vague est plate). \\    Si vous mettez une amplitude nulle, il n'y aura aucune vague, et les icônes seront parfaitement immobiles (mais ce serait dommage ;-) ).
    * Ensuite ceux du cadre extérieur : la valeur du rayon des coins du dock, en pixels (0 est une valeur valide, et produira des coins carrés), l'épaisseur de la ligne externe du dock, en pixels (les icônes ne mordront pas sur le cadre quelque soit la valeur), la couleur de la ligne externe du dock, et enfin une coche permettant de dire si on veut que les bords inférieurs du dock soient aussi arrondis, ou pas.
    * Le cadre en-dessous permet de dire si on veut relier les icônes par une ficelle élastique. On peut spécifier son épaisseur (mettre 0 pour ne pas avoir de ficelle), et sa couleur.
    * Enfin les caractéristiques du mouvement vous permettent de rendre les mouvement de grossisement/réduction, et de déplacement vers le haut/bas plus au moins rapide. C'est assez difficile à expliquer, alors testez donc quelques valeurs, et observez les différences. L'accélération de dépliage latéral paramètre l'animation qui fait que les icônes semblent être repliées sur elles-mêmes initialement, puis se détendent à la manière d'un accordéon. Mettre 0 permet de ne pas avoir cette animation. \\    La fréquence de rafraîchissement est utile pour les PCs de faible puissance; vous pouvez la diminuer si votre ordi rame lors des mouvements du dock, toutefois cela rendra les mouvements moins fluides (en gros en-dessous de 15Hz, pour info les films sont à 24Hz).

* __Groupe Sub-Docks__
Ce groupe permet de **personnaliser le comportement des conteneurs** (sous-docks).
    * Vous pouvez ainsi spécifier un ratio de la taille des conteneurs. Ils apparaîtront d'autant plus petit. Il est également possible de les faire s'afficher parallèlement aux dock principal, ou bien perpendiculairement (dans ce cas, pour un dock à l'horizontal, les conteneurs seront verticaux, et inversement).
    * Il est possible de choisir d'afficher les sous-docks au survol de l'icône, ou bien de devoir cliquer sur l'icône pour les afficher. C'est utile si vous avez beaucoup de sous-docks, ou que vous passez votre temps à faire aller et venir votre curseur sur le dock :-)

* __Groupe Labels__
Ce groupe représente les **étiquettes** qu'on peut afficher avec les icônes. 
    * Vous pouvez paramétrer le rendu des étiquettes : taille des caractères, épaisseur des caractères, italique ou droit.
    * Une case à cocher permet de spécifier si l'on veut que les étiquettes ne s'affichent que pour l'icône couramment pointée, ou pour toutes les icônes ayant un zoom non nul. Pour n'afficher aucune étiquette, il vous suffit de mettre leur taille à 0.
    * Suit un paramètre qiu permet de régler le degrés de visibilité des étiquettes qui sont à côté de celle de l'icône pointée.
    * Enfin vous pouvez choisir de laisser le texte s'orienter dans le sens du dock (horizontal ou vertical), ou bien les forcer à être toujours horizontal (auquel cas il n'est pas assuré qu'elles seront entièrement contenues dans la fenêtre, et il se pourra qu'elles débordent et donc apparaissent tronquées).

* __Groupe Background__
Ce groupe représente les **décorations du fond** du dock, qui suivent les mouvements du curseur.
On peut choisir entre avoir une image en fond, ou utiliser un dégradé.
    * Au début se trouve un facteur de la vitesse de déplacement des décorations par rapport à la souris (mettre 1 pour qu'elles suivent le curseur, 0.5 pour qu'elles aillent 2 fois moins vite, etc) \\    Vous pouvez choisir d'asservir les décorations au curseur (dans ce cas, un déplacement de la souris de 1 pixel entraînent un déplacement des décorations de 1 pixel multiplié par le facteur de vitesse précdédent), ou bien de désassocier le mouvement des décorations du curseur (dans ce cas, un mouvement de la souris vers la droite entraînera un mouvement des décorations vers la droite, d'une quantité indépendante du déplacement de la souris; le mouvement est "lissé").
    * __Image en fond__ : si l'on souhaite utiliser une image en fond, il suffit d'indiquier un fichier d'image. On peut également spécifier le niveau de transparence désiré. \\    La case à cocher permet de dire si l'image choisie doit se répéter comme un motif, ou s'élargir pour remplir tout le fond.
    * __Dégradé__ : Si aucune image de fond n'est renseignée, cairo-dock utilisera les paramètres du dégradé. \\    On peut spécifier 2 couleurs, qui formeront un dégradé (mettre 2 fois la même couleur permet d'avoir un fond uni). On peut également spécifier l'inclinaison de ce dégradé par rapport à la vertivale (un angle de 0° donnera un dégradé horizontal de la gauche vers la droite, un angle de 90° donnera un dégradé vertical du haut vers le bas (l'inverse pour -90°) \\    Ce dégradé peut être répéter plusieurs fois pour obtenir des rayures, si l'on spécifie un nombre de rayures > 0. En ce cas, on peut également spécifier la largeur relative des rayures. \\    Plus le nombre de rayures est grand, plus la densité de rayure est élevée, donc plus elles sont rapprochées. Leur largeur est en pourcentage de la taille d'un motif; un motif contient N rayures, la largeur peut donc être inférieure ou égale à 1/N. Voir la rubrique [[gnome_dock#trucs_et_astuces|Truc et Astuces]] à la fin pour un exemple concret).

* __Groupe Launchers__
Ce groupe gère les **lanceurs** de cairo-dock.

* Pour les 4 onglets suivants, les 1ers paramètres sont communs. Je ne les détaillerai qu'une fois, ici.
    * Tout d'abord la taille maximale et minimale des icônes de lanceurs : c'est surtout utile si vous avez dans votre dock des icônes trop grandes ou trop petites, et que vous n'avez pas envie de les re-dimensionner à la main. 0 si vous ne souhaitez pas restreindre la taille de vos icônes.
    * Le type de l'animation lors d'un clique gauche sur une icône d'un lanceur  : bounce <=> l'icône rebondit, rotate <=> l'icône tourne sur elle-même, blink <=> l'icône clignote en transparence, random <=> animation aléatoire parmi les précédentes.
    * On peut spécifier le nombre de fois où l'animation sera jouée. 0 fait donc qu'on aura pas d'animation (mais ce serait dommage :-D )
    * Ensuite on peut spécifier une **liste de répertoires** où le dock ira chercher les icônes des applications ajoutées au dock. Vous pouvez en spécifier plusieurs, cairo-dock ira chercher dans chacun des répertoires **dans l'ordre** où vous les avez spécifiés, jusqu'à trouver l'icône voulue. Le mot clé "_ThemeDirectory_" sera remplacé par "~/.cairo-dock/themes/nom_du_theme". Plus d'infos dans [[gnome_dock#note_sur_le_champs_icon|cette section]], surtout si vous avez des **thèmes d'icônes** installés.
    * Enfin, vous pouvez glisser-déposer des répertoires dans la barre, ceux-ci seront alors considérés comme des raccourcis. Pour les ouvrir, spécifier ici le nom de l'explorateur de fichiers que vous souhaitez utiliser (nautilus, thunar, pcmanfm, ou même konqueror ;-))

* __Groupe Applications__
Ce groupe gère la partie **barre des tâches** de cairo-dock.

* Une case à cocher permet d'activer la partir barre des tâches. Cairo-dock montrera alors les applications en cours et se comportera en plus comme une barre des taches, avec les fonctions classiques comme "montrer", "minimiser" ou encore "maximiser". Si la case est décochée, seule la fonction de lanceur est active.
    * Il est possible de demander à Cairo-Dock de considérer toutes les applications ayant le même PID comme une seule aplication. Dans ce cas, une seule icône apparaîtra dans la barre pour chaque application ouverte, même si celle-ci possède plusieurs fenêtres. Faire "close" sur cette icône fermera toutes les fenêtres de l'application.
    * Comme certaines applications ont un nom à rallonge, vous pouvez spécifier le nombre de caractères maximum autorisé dans l'étiquette de chaque application. Si la description est plus longue, elle sera tronquée avec des "...".

* __Groupe Applets__
Ce groupe gère les **applets** de cairo-dock.

* Une liste de toutes les applets installées est automatiquement chargée lors de l'ouverture du panneau de config. Vous pouvez activer/désactiver chaque applet en cochant/décochant simplement la case à côté de celle-ci. Vous pouvez aussi spécifier l'ordre qu'elles auront dans la barre : l'applet tout en haut sera la plus à gauche, et l'applet tout en bas sera la plus à droite. \\    On peut aussi enlever une applet du dock en cliquant droit sur son icône, et en choisissant "remove this applet". La configuration d'une applet se fait aussi par le clique droit sur son icône.

* __Groupe Separators__
Ce groupe gère les **séparateurs** de cairo-dock, qui viennent se placer automatiquement entre les différents types d'icônes (lanceurs, applications, applets).
    * Vous pouvez spécifier le nom d'une image à utiliser pour les séparateurs, ou bien laisser le champ vide pour utiliser un séparateur par défaut.
    * Comme pour la zone de rappel, il est possible de spécifier si l'on veut que l'image du séparateur suive l'orientation du dock (haut, bas, droite, gauche), ou si l'image ne doit pas tourner.

====Rajouter des lanceurs====

3 possibilités s'offrent à vous :

1) __Ajouter un .desktop existant.__
On choisit le 2ème champs du menu. Un sélecteur de fichiers s'ouvre; il pointe initialement sur le répertoire /usr/share/app-install. Dans le sous-repertoire "desktop" se trouvent les .desktop installés par Ubuntu. 
Vous pouvez donc choisir plusieurs lanceurs dans ce répertoire, ou un autre (CTRL+clique pour en sélectionner plusieurs), puis faire "Valider".
Cairo-dock les importera tous d'un coup, et les chargera automatiquement.

Par défaut l'ordre d'un lanceur nouvellement importé est n+1, où n est le nombre d'icônes présentes avant.

2) __En créer un à partir de zéro :__
On choisit le 2ème champs du menu. Puis choisissez "Nouveau". Le sélecteur se ferme, et une fenêtre s'ouvre; elle contient un petit formulaire à remplir pour définir votre lanceur. Voir plus bas le chapitre sur la configuration des lanceurs. Faites "Valider", votre nouveau lanceur a été créé et chargé par cairo-dock !

3) __Utiliser le glisser-déposer :__
A partir du menu Applications (ou de Nautilus, ou autre), attrapez une application à la souris, faites la glisser jusque dans le dock, puis relâchez-la à l'endroit où vous voulez la voir dans le dock. Un lanceur correspondant sera ajouté, et automatiquement chargé par cairo-dock.

====Supprimer un lanceur====

Cliquez sur une icône et choisissez le 3ème champ. Une fenêtre de confirmation apparaît. Répondez "Oui". C'est fait, le lanceur a été désintégré =)

Si le lanceur était en fait un container et pointait sur un autre dock, celui-ci ainsi que tous ses sous-docks seront soit détruits, soit répartis dans le dock principal, selon ce que vous répondrez à la question qui vous sera posée.

====Modifier un lanceur====
Cliquez sur une icône et choisissez le 4ème champs. Une fenêtre s'ouvre, contenant tous les champs du lanceur. Voici la liste des champs utiles :
  * //Son nom// : Le texte qui apparaîtra au-dessus de l'icône dans le dock. Ce champ peut exister en plusieurs langues, mais Cairo-Dock vous présentera et utilisera celui correspondant à votre locale.
  * //Sa commande// à exécuter lors du clique sur une icône.
  * //le nom du fichier image// à utiliser comme icône. Voir plus loin pour une explication sur comment cairo-dock retrouve les icônes correspondant à un lanceur.
  * //son ordre// : un numéro qui permet de classer les lanceurs entre eux. Un lanceur ayant un ordre supérieur à celui d'un autre lanceur sera placé après ce dernier. En cas d'ordres égaux, ce sont les numéros d'inode des fichiers .desktop qui jouent (ou bien la date de modif, je ne sais plus, voir la man de la fonction readdir ()).
  * //le nom de son container// : c'est le nom du container dans lequel l'icône apparaîtra. Le nom d'un container est déterminé par l'icône(s) pointant sur lui.
  * une //case à cocher// indiquant si cette icône doit pointer sur un container ou juste être un simple lanceur.

====Déplacer une icône à l'intérieur du dock====
Rien de plus simple, choisissez le 5ème champ, qui contient un sous-menu. Dans ce sous-menu, vous pouvez au choix déplacer l'icône d'un cran vers la gauche, ou bien d'un cran vers la droite, ou bien encore le placer en 1er, ou en dernier. \\ Sinon vous pouvez tout simplement cliquer sur une icône, maintenir enfoncé le bouton de la souris tout en déplaçant l'icône. \\  Ceci est valable pour les lanceurs, les applications, et les applets, mais les différents types ne se mélangeront pas.

====Note sur le nom d'une image====
On peut au choix : 
  * indiquer un chemin complet vers une image (/chemin/vers/image, ou bien ~/chemin/vers/image).
  * indiquer un nom d'image seul. C'est le cas des lanceurs déjà présents sur le système. En fait ces lanceurs ne précisent même pas l'extension de l'image ! Pour s'y retrouver, cairo-dock connaît plusieurs répertoires d'icônes. Ils sont indiqués dans le fichier de conf, vous pouvez en rajouter autant que vous le voulez. L'ordre sera pris en compte lors de la recherche. C'est utile lorsque vous avez installé des thèmes, qui contiennent un jeu d'icônes. Vous pouvez ainsi **changer un thème d'icônes en 2 secondes** sans avoir à toucher chaque lanceur ! 8-) Si le nom d'icône n'a pas d'extension, Cairo-dock cherche en priorité les .SVG (image vectorielle, rendu nettement plus beau avec des svg bien faits), puis les .PNG, puis les .XPM. Les autres formats ne sont pas recherchés, car une icône sans transparence, c'est nettement moins joli ;-) Si cairo-dock ne trouve pas d'icônes, il y'aura tout simplement un vide à sa place dans le dock, mais le lanceur sera bien présent et actif.
**Note** : Cairo-Dock supporte tout type de format, mais les plus intéressants sont SVG, PNG, et XPM. Le SVG a un rendu graphique nettement supérieur aux autres formats, il est donc à privilégier.

====Trucs et astuces====
  * **Déplacer** son dock : \\    au choix : \\    - utilisez les flèches après avoir rendu la fenêtre du dock active (par exemple par un clique du milieu dessus), puis utilisez les flèches pour le déplacer. Le mouvement est accéléré pour plus de confort. \\    - Appuyez sur ALT, puis cliquez sur votre dock, maintenez cliqué tout en le déplaçant à la position voulue. Sous Beryl vous pouvez activer les bords de fentres "collantes" ce qui permet un placement plus précis. Puis relâchez le bouton de la souris, et __en dernier__ relâchez la touche ALT.

* Positionner son dock **en haut de l'écran**, comme la barre des taches sous Ubuntu par défaut : \\    Positionnez votre dock au milieu de l'écran pour être sûr de ne pas le perdre en dehors de l'écran. Faites clique droit -> configurer, et décochez la case dans l'onglet POSITION. Maintenant le dock se déroule dans l'autre sens. Finissez en le déplaçant en haut de l'écran là où vous voulez le voir. \\    **Note** : il se peut que votre gestionnaire de fenêtres ne laisse pas les fenêtres sortirent de l'écran par le haut. Dans ce cas, si l'auto-hide est activé, la fenêtre ne pourra pas se cacher progressivement vers le haut, et disparaîtra d'un coup.

* Avoir des **thèmes d'icônes** facilement **interchangeables** pour le dock : \\    Soit vous avez téléchargé un thème d'icônes, soit vous vous êtes créé un répertoire avec pleins d'icônes dedans. Faites clique droit -> configurer, allez dans l'onglet LAUNCHERS, et ajoutez, dans la liste des répertoires, le nom du répertoire où se trouve vos icônes. Ajoutez autant de thèmes que vous le voulez de cette façon. Maintenant, pour passer d'un thème à un autre à volonté, il vous suffit simplement de mettre en 1er (en haut donc) le répertoire correspondant au thème voulu (utilisez simplement les flèches haut et bas) ! Cairo-dock rechargera automatiquement les nouvelles icônes à la fermeture du panneau de configuration. \\    ** Note ** : si le nom d'une icône n'a pas d'extension, cairo-dock charge des .SVG en préférence, pour leur meilleur rendu graphique. Donc si par exemple le 2ème thème contient l'icône en SVG mais que le 1er ne la contient qu'en PNG, ce sera celle du 2ème thème qui sera utilisée. Donc essayez de faire des thèmes homogènes (et de manière plus générale, privilégiez le SVG !)

* Changer le style des **rayures** : \\    Donnons quelques exemples concrets : \\    - Mettons que je veuille des rayures **fines** et **espacées**. Je mettrais alors leur //nombre// à 8 (8 rayures par motif) et leur //largeur// à 0.02 (2% de la largeur d'un motif), par exemple. \\    - Si maintenant je veux des rayures plus **épaisses**, je peux augmenter la valeur de la //largeur// jusqu'à 1/8, soit 0.125 (12%), ce qui aura pour effet de les étaler (elles seront plus diffuses). \\    - Si je préfère avoir des rayures bien **denses (nombreuses)**, j'augmenterai leur //nombre//, par exemple 30 (30 rayures par motif). Comme il y'a beaucoup de rayures dans un motif, elles ne peuvent pas être très larges sous peine de se chevaucher; la valeur maximale pour le champ //largeur// sera de 1/30 soit environ 0.03 (3%).

* Avoir des icônes de **tailles toutes identiques** : \\    Cairo-dock s'accommode très bien d'icônes de toutes les tailles. Cependant pour des questions d'homogénéité, vous pourriez vouloir qu'elles aient toutes la même taille. Mais vous êtes trop flemmard pour toutes les re-dimensionner ! ;-) La solution est d'avoir les couples de valeurs (taille min, taille max) égaux pour les lanceurs, les applications, les applets, et les séparateurs. Cairo-dock les re-dimensionnera pour vous à chaque chargement, y compris pour les nouvelles icônes que vous rajouterez après. \\    Un truc marrant : mettez 24 dans tous les champs, et 150 dans le champs //largeur de la vague// de l'onglet CAIRO-DOCK; vous voilà avec un bébé cairo-dock ! il est pas mignon ? ^_^

* Choisir un des **thèmes prêt à l'emploi** : \\    Si le répertoire caché ~/.cairo-dock de votre répertoire perso n'existe pas, cairo-dock vous proposera de commencer avec l'un des thèmes pré-installé. Par la suite, il est possible de revenir sur ce choix (clique droit -> cairo-dock -> choose a theme). \\  Cairo-dock effectuera une sauvegarde de votre config actuelle dans ~/.cairo-dock.ori, __si ce répertoire n'existe pas déjà__. S'il existe, il ne fera pas de sauvegarde de votre config courante, mais vous demandera toutefois de confirmer avant de l'écraser.

* Ajouter des **containers** : \\    Les containers sont des lanceurs d'un type particulier : ils sont comme des tiroirs; ils vous permettent de regrouper des icônes semblables au sein d'un sous-dock qui n'apparaîtra qu'au survol du container par la souris. Vous pouvez empiler des docks les uns au-dessus des autres, tel un arbre, aussi loin que votre imagination vous le permet ! :-) \\    Pour créer un container, la méthode est identique à la création d'un lanceur; simplement, cochez la case du bas. Un container peut avoir une commande à exécuter lors du clique, mais ça n'a pas grand intérêt. Un nouveau dock vide sera créé et associé au container. Vous ne pouvez pas le voir car il est vide initialement, mais il est bien présent à l'écran, et donc vous pouvez glisser-déposer des lanceurs dedans comme précédemment. \\    Pour déplacer une icône d'un container à un autre, éditer l'icône (clique droit -> modifier l'icône), et dans le champ **Container**, indiquez le nom du container où vous voulez voir aller vote icône. (le nom d'un container est celui de l'icône pointant sur lui; il peut donc avoir plusieurs noms si plusieurs icônes pointent sur lui, indiquez simplement l'un des noms. Le dock principal s'appelle "_MainDock_").

* Ajouter/enlever des **effets d'animation** avec **Compiz-Fusion** : \\    **Compiz-Fusion** applique certaines animations par défaut à des types de fenêtre prédéfinies. Nous pouvons donc le forcer à appliquer des effets sur l'ouverture et la fermeture des sub-docks. Ouvrir le **CCSM** (**CompizConfig System Manager**), et se rendre dans les options du plugin "Animations" ; dans l'onglet "Open Animations". Ici, nous allons créer une variable qui appliquera un effet à l'ouverture d'une fenêtre (les sub-docks sont considérées comme des fenêtres par Compiz.). \\    - Appuyer sur "Ajouter", **choisir l'effet désiré** dans la liste d' "Open effect". \\    - Augmentez la valeur "effect duration" au choix (**plus c'est haut, plus l'animation sera lente**). \\    - Ajoutez "name=cairo-dock" comme valeur dans "Correspondance de fenêtre". \\    - Faites monter cette variable **en haut de la liste** en utilisant les boutons de flèches. \\    Ainsi, Compiz n'appliquera l'animation que vous avez spécifié que pour l'ouverture d'une "fenêtre" nommée cairo-dock. Donc, **toutes les ouvertures des sub-docks seront ponctuées par cet effet**. \\    Appliquez la même chose dans l'onglet "Close Animation", et rendez vous dans l'effet "Focus Animation", et créez une variable de la même façon en n'appliquant **pas d'animation** ("Aucun" dans la liste d'animations), et spécifiez encore "name=cairo-dock" en correspondance de fenêtre. Ceci évite d'appliquer un effet sur la dock lorsque la souris passe devant (focus), ce qui provoquait un "flash" désagréable du dock. \\    ** Note ** : Afin d'optimiser ces effets, je recommande de désactiver l'animation de dépliage des icones dans les paramètres de cairo-dock (mettre à 0 l'option "Caractéristique du mouvement"). Ainsi, l'animation de base de dépliage des icônes n'interférera pas avec les effets de compiz. Je recommande aussi les effets de compiz suivants : \\    - Open Animation : effet "Zoom", avec duration de 250 \\    - Close Animation : effet "Vacuum", avec duration de 250.

===== Créer des SVG avec InkScape =====
=== Installation du logiciel : ===
**InkScape** se trouve dans les dépots, son installation est aisée. 
  sudo apt-get install inkscape
=== Mettre l'icône au format ===
Si l'affichage de l'icône finale se fait en 48x48 pixels, il est préférable que l'image de base soit d'une résolution supérieur, pour qu'en cas d'agrandissement, la qualité ne soit pas médiocre.

J'ai personnellement utilisé les icônes d'un thème [[http://www.gnome-look.org/content/show.php/OSX?content=31618|Mac OS X]] ([[http://nekohayo.googlepages.com/icons|Site de l'auteur]]), qui se trouvent au format .png, en 128x128 pixels (dossier ///scalable//)

== 1. Définir la taille finale qu'aura l'icône : ==
** Fichier / Propriétés du Document... (Shift+Ctrl+D)** Changer la largeur et la hauteur à 48px. Vous constaterez que votre image dépasse du cadre que vous avez redimensionné.

== 2. Réduire l'icône sans altérer sa qualité : ==
Selectionnez l'icône, en cliquant dessus. Vous pouvez voir dans les barres d'outils : X:0 Y:-80 L:128 H:128 (si votre image .png de base est en 128x128 pixels)

Réglez comme suit : X:0 Y:0 L:48 H:48. Si l'icône est désormais en 48x48px, elle conserve malgré tout les détails d'une icône au format 128x128px.

== 3. Inclure l'image dans le document : ==
Sélectionner l'image ensuite Menu "Effects/Images/Embed All Images" et confirmer. (sinon le png est sous forme de lien dans le SVG)

== 4. Sauver et placer l'icône pour son utilisation : ==
Vous pouvez désormais sauvegarder l'icône, au format .svg (Inkscape ou autre). Placez là ensuite dans le dossier ///opt/cairo-dock///.

**Notes :** Vous trouverez - sous Ubuntu Edgy Eft dans mon cas - dans le dossier ///usr/share/icons/gnome/scalable/// d'autres icônes toute prêtes en .svg.

===== Banques d'icônes svg =====

La solution consistant à incruster une image matricielle dans un fichier svg (détaillée ci dessus) reste très brouillon et pose certains problèmes de netteté pour des redimensions telles que celles faites par gnome-dock.

La meilleur solution reste donc, dès que possible, d'utiliser de vraies images vectorielles. L'objectif des banques d'icônes svg est de vous fournir ces icônes.

En fouillant un peu des sites tels que [[http://www.gnome-look.org/|gnome-look.org]], il est possible de trouver les icônes officielles de quelques logiciels, mais surtout des sets (plus ou moins complets) d'icônes autour d'un thème, ce qui peut être intéressant pour accorder votre dock au style de votre environnement graphique.

Pour les icônes officielles (ou des reproductions qui s'en rapprochent le mieux possible), c'est sûrement [[http://svgicons.o7a.net/|svgicons.o7a.net]] qui répondra le mieux à vos besoins (il a été initialement créé pour cairo-dock).

**Note** : Je fournis dans le .tar.bz2 des sources un répertoire More_Icons, qui contient pas mal d'icônes au format .SVG.

=====Problèmes courants=====

===Avec Beryl===
Si vous utilisez Beryl avec ce dock:

* Premièrement si le dock se lance avant Beryl, celui-ci n'apparaîtra que sur un espace de travail. C'est gênant! Pour résoudre ce problème il faut s'assurer que la dock se lance après Beryl! \\  A l'installation, un petit script est installé  (///usr/bin/launch-cairo-dock-after-beryl.sh//) qui permet cela. Allez dans Système->Préférences->Session, et ajoutez-le au démarrage. Le temps est réglé sur 12 secondes par défaut, si vous avez besoin de plus, ou de moins, éditez le script, et changez la valeur après le //sleep//.

* Il est possible que vous deviez changer la “taille virtuelle verticale” ou "Vertical Virtual Size" pour que le dock fonctionne correctement: Beryl Setting Manager > General Options > Passez de 1 à 2 la Taille virtuelle verticale.

* Pour pouvoir **utiliser les containers de manière optimale**, désactivez la prévention du vol de focus dans la page "General Options", et dans la page "Animations" de l'onglet "Effets visuels" utilisez le type d'animation "Zoom" ou "Lampe Magique 3" pour la 2ème animation de la création/destruction de fenêtre, et cochez le type "Menu" dedans. Suggestion de ppmt : mettez la durée de l'animation à 300 pour un effet optimum.

* Avec la vue verticale, il reste un écart de 1 pixel avec le bord de l'écran, même si l'on met une valeur nulle ou négative pour l'écart. En effet, Beryl laisse 1 pixel d'écart entre n'importe quelle fenêtre et les bords droite/gauche de l'écran. Avec Metacity, il n'y a pas ce problème.

===Sans Beryl===
Si vous n'utilisez pas Beryl, il est presque certain que vous n'aurez pas la transparence, ce qui se manifestera par un cadre noir autour du dock.

Si vous êtes sous XFCE, le moyen le plus simple est [[http://doc.ubuntu-fr.org/xfce_faq?s=xfce%20composite#comment_rendre_transparent_les_panels_et_fenetres_sans_beryl|d'activer le compositeur de XFCE]].

Si vous êtes sous KDE, les dernières versions de Kwin intègre la gestion de la transparence (dans kconfig => section bureau => comportement des fenêtres => transparence)

Si vous êtes sous Metacity, nous allons devoir installer [[:xcompmgr|xcompmgr]] qui est un module permettant de rajouter la gestion de la transparence à Metacity. Vous pouvez tout à fait avoir Metacity+xcompmgr et Beryl installés en parallèle, mais bien sûr vous ne pouvez pas les lancer en même temps.
Une fois installé, il est nécessaire de le charger au démarrage:
Cliquez sur Système ⇒ Préférences ⇒ Sessions et choisissez l'onglet "Programmes au démarrage". Appuyez sur "Ajouter" et entrez:
<code>xcompmgr -c -f -n</code>
Ce qui activera la transparence en plus des effets d'ombres et de fondu.
Il est possible de changer ces options qui sont disponibles en faisant un simple
<code>xcompmgr --help</code> dans un terminal.

Avec certaines cartes (des vieilles ATI notamment), xcompmgr ne marche pas. La seule solution pour avoir la transparence consiste alors à [[http://doc.ubuntu-fr.org/xgl_gnome|installer XGL]].

===Mon dock disparait ! Que dois-je faire ? par Mav===
Il peut arriver que le dock disparaisse sans raisons. Le problème semble se poser en particulier avec le plugin Scale de Beryl/Compiz Fusion. Pour y remedier lancer le dock avec la ligne de commande suivante :
<code>cairo-dock --dock-hint </code>
Cette option doit être modifiée dans vos options de démarrages de session ou dans le fichier launch-cairo-dock-after-beryl.sh directement.
Edit : l'option --dock-hint est obsolète et activée par défaut depuis la 1.3.8

=== Cairo-Dock en 64bits sans compiler, c'est possible ! ===
Je vous copie-colle comme un gros sale le commentaire d'un utilisateur du forum ubuntu US (Ravan) qui a bataillé dur pour arriver à faire fonctionner le dock sur son AMD64 : :-)

Yes, it works perfectly now (as far as I tested :) ) but for the dependencies, I could have gone a simpler route... It turns out that the great AMD64 dependency solver tool (when running 32bit apps) called Getlibs does it all in one go: [[http://ubuntuforums.org/showthread.php?t=474790&highlight=getlibs]]

So here is a short How-To for Cairo-Dock on Ubuntu Gutsy AMD64:

1. Install Getlibs following instructions on http://ubuntuforums.org/showthread.php?t=474790&highlight=getlibs \\
2. Download the latest cairo-dock 32bit debs (both cairo-dock and plugins) to your home folder \\
3. Open a terminal screen and run 
a. ~$ sudo dpkg --force-all -i cairo-dock*.deb
b. ~$ sudo getlibs /usr/bin/cairo-dock
c. ~$ sudo apt-get -f install \\
4. Try Cairo-Dock by giving the command cairo-dock in the same terminal screen and see if there are any dependency errors left. If so, use the 'manual 32bit libs installation' described on the getlibs page above to get them. If not, cairo-dock should run and open itself on your screen :) \\
5. If all is well, add cairo-dock to the Sessions list to make it start up at login...

Merci de recopier le code ci-contre pour prouver que vous êtes humain : X G W F V Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported