个人工具

“UbuntuHelp:CairoDock”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
第2行: 第2行:
 
{{Languages|UbuntuHelp:CairoDock}}
 
{{Languages|UbuntuHelp:CairoDock}}
 
#title Cairo-Dock
 
#title Cairo-Dock
[[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock.png]]
+
[[http://www.cairo-dock.org/images/logos/cd.png]]
 
== Introduction ==
 
== Introduction ==
Cairo-dock is an animated application launch bar displayed on the desktop comparable to Mac OS X's Dock.
+
Cairo-dock is an animated application launch bar for the desktop comparable to Mac OS X's Dock, or Rocket Dock (for those of you who come from Windows).
It is compatible with Beryl, Compiz, Metacity+xcompmgr and probably KDE since Kwin now manage composite display.
+
It is compatible with Compiz-Fusion, Beryl, Compiz, and also Xcompmgr, but it can run without a composite manager (with fake transparency). Cairo-Dock can run under  GNOME, KDE, and XFCE.
There is a [http://forum.ubuntu-fr.org/viewtopic.php?id=131714 thread] on the French Ubuntu forum that is quite active
+
This page describes only how to install Cairo-dock. If you want to know more (about configuration, themes,... ) you can see the official site:
The project page for Cairo-dock is found at [https://developer.berlios.de/projects/cairo-dock/ BerliOS] where you can download the latest binaries and submit your bugs or feature requests.
+
http://www.cairo-dock.org/index.php
 +
The site is in French mainly, but the wiki has an English section which is updated as often as the French part ;)
 +
If you have some questions or bugs to report, you can post on the forum
 +
http://www.cairo-dock.org/bg_forumlist.php
 +
. You can speak English there so don't be shy ;)
 
== Installation and Initial Launch ==
 
== Installation and Initial Launch ==
The Project is split in 2 parts: the dock itself and the plug-ins (which provides mainly the applets). The installation for both is the same, so only the installation of the dock is explained. You just have to make sure you install the plug-ins after the dock.
+
The Project is split in to two parts: the dock itself and the plug-ins (which provides mainly the applets). The installation for both is the same, so only the installation of the dock is explained. You just have to make sure you install the plug-ins after the dock.
Once installed, the dock can be updated by using an option in the dock which will execute a script that downloads and installs the package when there is a new version.
+
The config file will not be overwritten during updates as Cairo-Dock is capable of inserting the missing fields if any without losing your previous settings.
The config file will not be overwritten during updates as Cairo-Dock is capable of inserting the missing fields if any.  
+
=== From the repository (stable) ===
=== From the deb package ===
+
(only for Hardy Heron 32/64bit and Gutsy Gibbon 32 bit)
First install the packages libcairo2 and librsvg2-2.
+
Cairo-Dock has its own repository. So, to install it, you just have to edit your sources (sudo gedit /etc/apt/sources.list) and add the repository:
Then download the [https://developer.berlios.de/project/showfiles.php?group_id=8724&release_id=14108 .deb files] and install them by double-clicking on the downloaded file.
+
<pre><nowiki>
Note : the packages is compiled with glitz (for hardware acceleration), but not with libcairo (before 7.04 Feisty), so if you want to use it, you have to compile your libcairo with the --enable-glitz.
+
deb http://repository.cairo-dock.org/ubuntu hardy cairo-dock
=== By compiling it ===
+
or
You will need the packages build-essential, autoconf, libtool, intltool, libcairo2-dev, libgtk2.0-dev and librsvg2-dev.  
+
deb http://repository.cairo-dock.org/ubuntu gutsy cairo-dock (if you are under Gutsy)</nowiki></pre>
As a side note, if you have an AMD64 and you probably also have to install libglitz1-dev and libglitz1-glx-dev. The command below should be all you need:
+
The signed GPG key for identification of the repository is:
<code><nowiki>sudo aptitude install build-essential autoconf libtool intltool libcairo2-dev libgtk2.0-dev librsvg2-dev libglitz1-dev libglitz1-glx-dev libcairo2 librsvg2-2 libglitz1 </nowiki></code>
+
<pre><nowiki>
Download and decompress the source .tar.bz2, move to the newly created directory (cd opt/cairo-dock/cairo-dock) and type:
+
wget -q http://repository.cairo-dock.org/ubuntu/cairo-dock.gpg -O- | sudo apt-key add -</nowiki></pre>
<pre><nowiki>autoreconf -isvf && ./configure --prefix=/usr/local && make
+
So, type it in a shell. Then, to install cairo-dock, type in a shell:
 
+
<pre><nowiki>
sudo make install </nowiki></pre>
+
sudo apt-get update
The program will be installed in /usr/local/bin.
+
sudo apt-get install cairo-dock cairo-dock-plug-ins</nowiki></pre>
 +
There is no repository available for older distributions such as Feisty. So, if you want Cairo-Dock under Feisty or older, you must compile it, or download the package (see below).
 +
=== With the deb package (stable) ===
 +
If you can't install cairo-dock from the repository, you can download the package from Berlios. But you first need to install the following packages:
 +
<pre><nowiki>
 +
sudo apt-get install libcairo2 librsvg2-2 libglitz1 libglitz-glx1</nowiki></pre>
 +
Then, download the package:
 +
http://developer.berlios.de/project/showfiles.php?group_id=8724
 +
in a shell, go to the directory where you have downloaded the .deb (use the command “cd the_directory”) and type
 +
<pre><nowiki>
 +
sudo dpkg -i xxx.deb</nowiki></pre>
 +
xxx is the name of the package you have downloaded
 +
and, type
 +
<pre><nowiki>
 +
sudo apt-get -f install</nowiki></pre>
 +
So, it's finished, you can type “cairo-dock” in a shell to launch it and configure it
 +
== By compiling it (stable)==
 +
You must first install the following packages:
 +
<pre><nowiki>
 +
sudo apt-get install build-essential libcairo2-dev libgtk2.0-dev librsvg2-dev libglitz1-dev libcairo2 librsvg2-2 libglitz1 libglitz-glx1 libglitz-glx1-dev m4 autotools-dev pkg-config libtool</nowiki></pre>
 +
Then, download the tar.bz2 package here: http://developer.berlios.de/project/showfiles.php?group_id=8724, in the shell go to the download directory with “cd” and type:
 +
<pre><nowiki>
 +
autoreconf -isvf
 +
./configure –prefix=/usr
 +
make
 +
sudo make install</nowiki></pre>
 +
=== By compiling it with a script using the SVN version (unstable) ===
 +
""/!\ PLEASE DON'T USE THIS VERSION OF CAIRO-DOCK IF YOU DON'T KNOW WHAT YOU'RE DOING /!\""
 +
If you want to try the bleeding edge version of cairo-dock (not yet in the repository because it's not yet stable), you can use the SVN version. But be aware that this version is potentially unstable, and there are updates everyday. Please use this version only if you have used a stable version before, and if you know what you're doing. It is preferable to know how cairo-dock works to be able to use it.
 +
A script was written to compile the SVN version of Cairo-Dock easily. So, you just have to create a directory where the script will be installed in, to download the script, and to launch it:
 +
Open a Terminal, start by creating a specific repertory (for example /cairo-dock_svn):
 +
<pre><nowiki>
 +
mkdir /cairo-dock_svn
 +
cd /cairo-dock_svn</nowiki></pre>
 +
Then get the script, make it executable and launch it:
 +
<pre><nowiki>
 +
wget http://cairo-dock.vef.fr/cairo-dock_svn.sh
 +
chmod u+x cairo-dock_svn.sh
 +
./cairo-dock_svn.sh</nowiki></pre>
 +
The SVN Password will be required: JUST PRESS ENTER.
 +
To finish, enter your own password when the script requires it in order to proceed with to the installation.
 +
A line will appear after the installation of each module and the final message indicates if everything went well. If not consult the log.txt file in the directory you have created at the beginning (~/cairo-dock_svn). Look at the end to locate the problem, then post it on the forum (you don't need to speak French ;) )
 +
For a good use of this unstable version, please get information on our site:
 +
http://www.cairo-dock.org/ww_page.php?p=Accueil&lang=en
 +
(direct link to the English section of the wiki)
 
=== What is installed ? ===
 
=== What is installed ? ===
 
This is a question that everyone should ask when installing a program. Cairo-Dock stores your launchers and your parameters in a hidden directory .cairo-dock in your own user directory.
 
This is a question that everyone should ask when installing a program. Cairo-Dock stores your launchers and your parameters in a hidden directory .cairo-dock in your own user directory.
<pre><nowiki> ~/.cairo-dock  --> current_theme --> cairo-dock.conf+decorations+readme
+
<pre><nowiki>
 +
~/.cairo-dock  --> current_theme --> cairo-dock.conf+decorations+readme
 
               |                +--> launchers --> .desktop+icônes
 
               |                +--> launchers --> .desktop+icônes
 
               +--> themes --> theme1 --> cairo-dock.conf+decorations+readme
 
               +--> themes --> theme1 --> cairo-dock.conf+decorations+readme
第34行: 第83行:
 
                           |          +--> launchers --> desktop+icônes
 
                           |          +--> launchers --> desktop+icônes
 
                           +--> .... </nowiki></pre>
 
                           +--> .... </nowiki></pre>
The package also installs ready made themes in /usr/share/cairo-dock/themes. YOu can't modify them and they will be updated along with the dock.
+
The package also installs ready made themes in /usr/share/cairo-dock/themes. You can't modify them and they will be updated along with the dock.
It is planned to add the dock in the Application menu (it already have an icon thanks to Necropotame) but I haven't yet found the way to add that in the deb file. If anyone feels like it..go ahead! 
+
 
=== First Launch ===
 
=== First Launch ===
On first launch, cairo-dock will configure itself and will propose a list of themes if it didn't detect the directory ~/.cairo-dock (this allow you to have an instant fully fonctionnal dock and an overview of the different functionalities and options). If it is your first install make sure you don't have a .~/cairo-dock.
+
If you installed it from the packages, there should be a launcher in the menu, under the "System" sub-menu.
You may have to move the mouse cursor to the bottom of the screen to see the dock if auto-hide has been enabled.
+
If not, just press <ALT>+F2 and type cairo-dock in the window that will appear.
After that if you want to test another theme just right click on the Dock and select "Manage themes".
+
To have the backtraces (sometimes useful if a problem should occur), open an terminal and type “cairo-dock &; disown” and press enter.
Some options are available, try cairo-dock --help to list them.
+
On first launch, cairo-dock will configure itself and will propose a list of themes (this allows you to have an instant fully functional dock and an overview of the different functionalities and options).
<br>
+
You may have to move the mouse cursor to the bottom of the screen to see the dock if auto-hide has been enabled. (It depends on the theme you choose. Generally, a little image is displayed on the hiding zone. Move your cursor on it)
=== De-installation ===
+
After that if you want to test another theme just right click on the Dock and select "Manage themes". Some options are available, try cairo-dock –help (in a terminal) to list them. If you want to learn more about themes and how to create your own theme, you can go to the official site's wiki  http://www.cairo-dock.org/ww_page.php?p=Accueil&lang=en
If you installed by compiling the source, go to the source directory and type:
+
== Some screenshots and possibilities ==
<pre><nowiki> sudo make uninstall
+
=== Screenshots of desktops of the team Cairo-Dock ===
</nowiki></pre>
+
here you can see screenshots of desktops of people who work on Cairo-Dock http://www.cairo-dock.org/mc_album.php?a=3
This won't delete the directory ~/.cairo-dock nor its content (the launchers and the config file).
+
=== Some possibilities, applets, views... ===
If you install from the packages, deinstall it with your package manager or apt-get. The directory .cairo-dock and its content will not be delete, unless you selected a complete removal (purge).
+
** First, I'm going to show you the basic default view, simple, like the macOS bar. This is the view you will see when your dock is installed:
== Configuration ==
+
[[http://img82.imageshack.us/img82/7016/defaultte7.png]]
Configuration of the dock is very easy. You have a list of theme to choose from at the 1st start. This allow you to start easily and you can then modify the config to build your own theme and save for later use.
+
** Here is my dock, configured with the "3D view". This is a classical view with reflection of icons on the dock-panel.
<br>
+
You can also see here, the applet "compiz-icon" with the "parabolic-view" wich is a beautiful view for sub-docks:
If you decide to try another theme just right click on the dock and select "Choose a theme". You will be able to select a new theme from the list.
+
[[http://img161.imageshack.us/img161/6112/3dzw9.png]]
To configure the dock, right click on it and select "Cairo-Dock" and "Configure". YOu can then choose which part of the dock you want to configure (All of it, only items related to the Appearance). A window will appear organized in tabs. Each one represent a group of common properties.
+
** This is the "carousel" view. The dock looks like a roundabout. It is beautiful but hard to  manage ;)
Each tab contains parameters. After Validating or Applying the changes the dock will reload automatically with its new config
+
[[http://img370.imageshack.us/img370/7862/carousselbt5.png]]
=== Group POSITION ===
+
** You can see on this screenshot the curved view. This is my favorite view. And you can also see my sub dock "internet" with the "rainbow" view, very user friendly with sub docks which have a lot of launchers:
This tab will allow you to select the position of the dock on the Desktop .
+
[[http://img370.imageshack.us/img370/5711/normalex4.png]]
{|border="1" cellspacing="0"
+
** Here you can see the applet "weather" wich gives you the weather taken from the site weather.com. This applet has here the view "slide" which is smart for sub-docks which are not full:
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_PositionGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_PositionGroup.small.png]] <br>~-Click image for larger view-~
+
[[http://img161.imageshack.us/img161/9903/slideuz7.png]]
|}
+
* You can choose on which edge of the screen the dock should be .
+
The animation of the icons and the dock will adjust based on the position and the relative
+
alignment
+
* The 2 offsets are respectively for positioning the dock compare to the selected edge
+
(useful for example to position the dock just above the Gnome Task bar) and the position
+
compare to the middle of that edge.
+
* You can also specify if the recall area picture should be reversed when the dock is at the
+
top (so if you have some text in the picture untick it or if your recall areas is an arrow
+
for example then tick it)
+
=== Group AUTO-HIDE ===
+
This tab allow you to control the Automatic hiding or not of the dock. The dock is replaced by a recall area when it is hidden. Just hover the mouse over the area and the dock will reappear.
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_AutoHideGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_AutoHideGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* The box to tick will decide if the dock should hide automatically or not and be replaced by the Recall Area. Ticked it will auto-hide. Untick it will always be visible.
+
* Width/Height : The dimension in pixels of the recall area (default  200x20).
+
* Name of the file to use for the recall area. This can be an absolute path , or a picture located in the directory ~/.cairo-dock/current_theme. You can also empty that field. The result will be an empty recall area (but definitely present).
+
* The transparency of the recall area picture can be specified. Set it to 0 and the image will be completely transparent (invisible). Set it to 1 and it will be opaque. Default is 0.5
+
* Tick this box if you positioned the dock at the top and you want the recall area to be reversed
+
=== Group CAIRO DOCK ===
+
This tab control the visual effect of the dock.
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_CairoDockGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_CairoDockGroup.small.png]] <br>~-Click image for larger view-~ |||| * Language of the configuration panel. Need to press OK to validate. <br><br> * Reorder the different section of the dock. Click the item to reorder and then use UP or DOWN button <br><br> * Maximum size for the dock. This will have a resulting effect that possibly not all icons on the dock will be visible at the same time but you will be able to make them turn around (like a carousel) with the mouse wheel.<br><br> * Force or not a carousel view (icon appearing in a 3D loop) <br><br> * Specify the amount of icon scrolling in pixels (0 means 1 icons at a time) <br><br> * Specify if the icon will come back to their original position when leaving the dock and if so at which speed they will do it <br><br> * Maximal amplitude of the wave (the maximal zoom factor applied to the icons is 1+A, where A is the amplitude <br><br> * Width of the wave. Outside that zone the the wave is flat <br><br> * Set the value of the radius of the corners of the dock in pixels (0 will give square corners), the width of the external line in pixels (the icons will never overflow the line whatever its width) and the colour of the line <br><br> * Select if the corner of the edge side of the dock should be rounded or not.<br><br> * Set the width of the line that links all icons together and its colour of the line <br><br> * Finally in this section you can tweaks the movement characteristics of the icons. It allows you to control the speed of the zooming and the up and down movement for the icons. It is Hard to explain so just try different values the value and see!
+
|}
+
=== Group LABELS ===
+
This tab controls how the labels aboce the icons will be displayed.
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_LabelsGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_LabelsGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* Select how the labels will be rendered (font sized, font. thickness of font, italic or not)
+
* Will the labels will be printed only for the current icons or all of them.
+
* This box define how much you will show the labels of the surrounding icons. Only active if you untick the "Show current label only"
+
=== Group BACKGROUND ===
+
This tab control the dock background design
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_BackgroundGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_BackgroundGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* Select the speed factor of the background movement relative to the mouse movement ( set to 1 to follow the mouse, set 2 to go half the speed)
+
* Decide if the background should follow the direction of the cursor or not (tick if yes)
+
* A Background image can be inserted by selecting a pictures. You can also set the transparency of the picture.
+
  You can tick if you want the picture to repeat as a motif rather than stretching
+
* if no picture is selected, then the gradient parameters are used
+
  Specify the gradient colours (select the same colour for both to obtain a plain background).  
+
  Set the angle of the gradient (0 degree will give an horizontal gradient from left to right, 90 degree will give a vertical gradient from top to bottom and -90 to reverse it)
+
  This gradient can be repeated several time to obtains stripes (if you specify a number of stripe bigger than 0). In that case you can also set the relative width of the stripes
+
  As the number of stripes increase so does the density and the stripes get closer.The width is a percentage of a motif size. A motif contains N stripes so the width can be inferior or equal to 1/N . See [[UbuntuHelp:CairoDock?action=AttachFile&do=del&target=Cairo-Dock_CairoDockGroup2.png#head-ce85ddf009132055b2d3507977a2ffcf254af37e|Tips and Tricks]] for more.
+
<br>
+
<br>
+
For the 3 next tabs (Launchers, Application, Applet) the section Generic is the same so I will only explains once for the Launchers
+
=== Group LAUNCHERS ===
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_LaunchersGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_LaunchersGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* Set the minimum and maximum size of the icons. It is useful if all your icons don't have the same size and are either too big or too small. Set to 0 if you don't want force a specific size
+
* Animation that will happen when you click an icon  : bounce, rotate, blink , random (any of the animations at random!)
+
* Specify how many times the animation will occur (0 turns off the function :( )
+
* Enter the name of a specific theme here to use the set of icon form that theme.
+
* Create a list of directories where the dock will go and search for the icons of the dock's Launchers. You can specify several and the dock will search the icons in the order specified until it finds one (but ~/.cairo-dock/current_theme/ has priority). By default the directories are the one where Ubuntu stores its icons. See  [[UbuntuHelp:CairoDock?action=AttachFile&do=del&target=Cairo-Dock_CairoDockGroup2.png#head-ce85ddf009132055b2d3507977a2ffcf254af37e|Tips and Tricks]] for more details especially if you have some icons themes installed
+
=== Group APPLICATIONS ===
+
This tabs controls the Tasks Bar of Cairo-Dock.
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_ApplicationsGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_AppicationsGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* Tick to display a Task bar with classical function like "Show", "Minimise" or "Maximise". You can also reorder the icons to your liking. Right click on each icon to see it
+
*Tick to only display one icon for applications which have the same PID.
+
* As some applications can have a lengthy name you can select the maximum number of characters to display in the label of each application. If it is longer the name will be truncated with "..." at the end
+
=== Group APPLETS ===
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_AppletsGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_AppletsGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
a list of all the installed applets is automatically loaded at the first launch.You can select to activate or deactivate them by ticking or unticking the box next to each of them. You can specify the order they will appear in the dock (Use the UP or DOWN arrow)
+
You can also remove an applet by directly right clicking on it and selecting "Remove this applet". The configuration of each applet is done by again right clicking it and selecting "configure this module". Each applet is different and will be based on what it is supposed to do. In general you will be able to select at least its icon. The horloge add also a section to generate alarms
+
=== Group SEPARATORS ===
+
This tabs control the separators that automatically place themselves between each different types of icons (launchers, task bar, applets). They have no other purpose.
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_SeparatorsGroup.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_SeparatorsGroup.small.png]] <br>~-Click image for larger view-~
+
|}
+
* You can either specify your own separator by choosing a file or leave it empty if you don't want a separator.
+
== Managing Launchers ==
+
=== Adding new Launchers ===
+
You have 3 ways to do it :
+
1/ Add an existing .desktop file (pre made launcher from Gnome) :  Right click on the Launcher section of the dock and choose "Add a Launcher"
+
A file browser will open that will initially point to /usr/share/app-install. In the subdirectory desktop are all the .desktop for the application installed by Ubuntu. You can choose several of them in this directory (CTRL+click to select several).
+
Next Valid and Cairo-Dock will import and load them all in one go automatically.
+
You can of course go to another directory if you have desktop file somewhere else on you disk.
+
2/ Start from Scratch : Right click on the Launcher section of the dock and choose "Add a Launcher"
+
The same browser will open. This time select New. That window will close and another one will open. It contains a little form to fill in the details of your launcher (See [[UbuntuHelp:CairoDock#head-4c42908898e227f2b3d6f0515533223b7dacac67|Modify a Launcher]] for more detail).
+
After validating the new launcher is created and loaded by Cairo-Dock!
+
3/ Use Drag-and-Drop : From the Gnome Application menu (or Nautilus or anything else) drag an application and drop it where you wish on the dock. A launcher will be automatically added by Cairo-Dock.
+
=== Removing a Launcher ===
+
Click on an icon and select the "Remove this Launcher" and select Yes in the confirmation window. That's it you have disintegrate your Launcher 
+
Note: If the Launcher was a container and contained another dock with icon in it then these icons will either be destroyed or distributed in the main dock depending on what you answered in the confirmation window.
+
=== Modify a Launcher ===
+
Click on an icon and select the "Modify this Launcher". A new window will open containing all the fields from that launcher. Here is the list of the useful one  :  
+
{|border="1" cellspacing="0"
+
| [[UbuntuHelp:CairoDock?action=AttachFile&do=get&target=Cairo-Dock_ModifyLauncher.png|http://help.ubuntu.com/community/CairoDock?action=AttachFile&do=get&target=Cairo-Dock_ModifyLauncher.small.png]] <br>~-Click image for larger view-~
+
|}
+
* Its name : This is the labels that will appear above the icon. This field can exist in several languages, but Cairo-Dock will present the one that is according to your local setting.
+
* The command to be executed when the icon is clicked.
+
* The name of the picture to be used for the icon. See below to find out how Cairo-Dock finds the icons for an application
+
* Its order : A number to allow the classification of the applications. A launcher with a higher number than another one will be located after that one.
+
* The name of its container : This is the name of the container where the icon will be loaded. The default one is "_MainDock_".
+
* A box to tick specifies if that icon should be a container or just be a simple launcher. if it is to be a Container then the field containing the command to execute is not used. (see [[UbuntuHelp:CairoDock#head-e32e81d6528271cc9fe23ca55369e4d0dfe0bd5f|Add  containers]] in "Tips and Tricks" section)
+
=== Move an icon inside the dock ===
+
The easiest way is to just drag (with the mouse) the icon to another place in the dock.
+
Another way s to right click the dock and choosing "Move this icon" , which contains a sub menu. You can then choose to move the icons one step to the left or the right. You can also set it to the first or last position in the dock.
+
You can move launchers as well as the applications in the task bar or applets, and they will not mix with each others.
+
Note regarding the name of an image
+
You can either:
+
specify an absolute path (/path/to/picture, or  ~/path/to/picture).
+
Specify only the name of the image. This is the case for the launcher already present in the system (in fact you don't have to specify the extension of the image either) For that purpose Cairo-Dock already know of some default image directory. They are mentioned in the config file and you can add as many as you want. The dock will look for image in the order they are listed. This is useful when you have installed themes which contains icons. You can change your theme in 2 seconds without having to change all your launchers! (NB : the directory ~/.cairo-dock/current_theme will have priority on the others so you can put your icons in it but you don't have to). If the image name doesn't have an extension Cairo-Dock will first search for SVG (vectorial picture which gives the best rendering), then PNG and finally XPM. The other format are not search as they don't support transparency which would not be as nice for an icon ;) If Cairo-dock can't find an icon there will just be an empty space instead but the launcher will definitely be present
+
== Tips and Tricks ==
+
=== Move the dock ===
+
either :  
+
- After making the dock active (click on it for example) use the arrows to move the dock. The movement will accelerate if you keep pressing for ease of use
+
- Press ALT then click on the dock then drag it where you want. With Beryl you can activate sticky edges which allows an better positioning. Release the mouse button and then release the ALT key.
+
=== Get icons themes easily swappable for the dock ===
+
If you either downloaded a icon theme or collect some icons in a directory : Right click on the dock then choose Configure and select the Launcher tab. Add in the directory list the directory where your icons are. Add as many as you want like that . Now to go from one theme to another easily just put the correct directory at the top of the list (use up and down arrow). Cairo-Dock will automatically load the new icons when you close the configuration panel.
+
Note : when an icon doesn't have an extension Cairo-Dock will first look for an .SVG in all the directory. So if you have matching .PNG in the top directory and another matching .SVG in the next directory then this one will be loaded. Keep this in mind when you build your theme and try to keep them homogeneous.
+
=== Change the style of the stripes ===
+
Here are a few concrete example:
+
- If I want thin and well spaced stripe: put their number to 8 (8 stripes per motif) and their width to 0.02 (2% of the width of a motif).
+
- If now I want thicker stripes: increase their width to may be 1/8, or 0.125 (12%), this will have the effect to spread them .  
+
- If I prefer very dense (numerous) stripes: increase their number, to 30(30 stripes per motif). As there is a lot of  stripes per motif they can't be very large or they will overflow each other, their maximum width should be 1/30 roughly 0.03 (3%).
+
=== Make sure all your icons have the same size ===
+
Cairo-Dock can deal with icons of any size. But for practical reason it would be nice to make sure that all icons appear to have the same size.. But you are too lazy to resize them yourself !  The solution is to set both values for the icons size equal in the tabs for the launchers, the applications, the applets and the separator. Cairo-Dock will then resize all the icons to that size. One little nice trick : set the size to 24 in all fields and 150 in the field for the width of the wave (see CAIRO-DOCK tab). You end up with a baby version of Cairo-Dock, Cute no? 
+
=== Choose a  ready made theme ===
+
If the directory ~/.cairo-dock doesn't exist at launch, Cairo-Dock will offer to choose a theme to choose among the predefined one.. Later if you change your mind and wish to change the theme : Right click "cairo-dock"  and choose "Manage Theme".
+
Cairo-dock if needed will warn you that you need to save your actual theme first if it has been changed. You can either save it on another name or overwrite the existing one, except for pre-installed themes.
+
=== Add  containers ===
+
Container are launchers with a special attribute : They are like drawers, so you can group similar applications (launchers) which will only appear when you go over the container. You can create a container inside a container and create a tree structure.
+
You create a container the same way you create a launcher for an application. You just have to tick the last box to indicate that it is a Container rather than an application. A new sub dock will be created and associated with that container. Initially you can't see it as it is empty so you have to create launcher to put in it as explained before. You can also of course just drag and drop applications on the Container
+
To move a launcher from one container to another one easy way is to edit the Launcher (Right Click the icon and choose "Modify Launcher") and change the name of the container in the Container field to point towards the new container (the main dock is called "_MainDock_").
+
=== Add/Remove visual effect with Compiz-Fusion ===
+
Compiz-Fusion set visual effect by default to the predefined windows types. You can also apply specific effect to the opening and closing of the dock and subdocks.
+
Open CCSM (Compiz Config System Manager) and go the to option of the Animation plugin; in the "Open Animation" tab. Here we are going to create a new variable which will allow us to affect a specific effect when you open a window (Compiz-Fusion considers a sub-dock like a window)
+
* Click "Add" an choose your effect in the list from "Open effect".
+
* Add "name=cairo-dock" in the field "Window Match"
+
* Get this value to show at the top of the list.
+
Now Compiz-Fusion will apply that specific effect only to the windows called "cairo-dock". So all sub-dock opening will use that effect.
+
Create the same effect in the "Close Animation" tab and while you are at it go to "Focus Animation" and create a variable there as well, but here select no effect. Name it cairo-dock again. This will make sure that no effect is triggered when you fly over the dock (focus). This can create an ugly flash if not
+
Recommended value
+
Open Animation: Zoom effect with a duration of 250
+
Close Animation: Vaccuum effect with a duration of 250
+
Note: to optimize this effect I recommend to deactivate the folding of the icon in the dock. See to 0 the option for unfolding in "Movement speed and accelation. See [[UbuntuHelp:CairoDock?action=show#head-cf80085c214509abe200bfdad631dd8331fac22d|Group Cairo-Dock]].
+
=== Transform icons to SVG format with InkScape ===
+
1/ Install InkScape
+
The application is in the main repository so installing is easy:
+
sudo apt-get install inkscape
+
2/ Transform the icon
+
If the final icon will be sized to 48x48 pixels it is preferable to start from a bigger images to avoid loosing to much details (especially when the icon will zoom in in the dock.
+
The original icons for Cairo-Dock are coming from a Mac OS X theme (http://nekohayo.googlepages.com/icons) which are in PNG and sized at 128x128 (directory scalable)
+
3/ open the selected file:
+
File / Open
+
4/ Define the final size of the icon:
+
File / Document Properties... (Shift+Ctrl+D) and change the width and high to 48px. You will notice that your picture will overflow the new frame you just resized
+
5/  Reduce the picture without loosing quality:
+
Select the picture by clicking on it.  You will notice in the tool bar that it indicates the size of you picture (in this case X:0 Y:-80 L:128 H:128)
+
Adjust using this setting: X:0 Y:0 L:48 H:48. The picture is now resized to 48x48 pix but it maintains the detail level that it ias when it was sized to 128x128px.
+
6/ Embed the image in the document :
+
Select the picture and choose "Menu/Effects/Images/Embed All Images" and confirm (otherwise the png will only exist as a link inside the SVG file)
+
7/ Save the icon ready to be used :
+
You can now save the icon directly where you normally save your icon.
+
Notes : Normally your distro will contain a directory full of ready made SVG icons. For example with Ubuntu Edgy Eft they are in /usr/share/icons/gnome/scalable/.
+
=== SVG Icon Collection ===
+
The solution described above is still a workaround and will cause issue when it comes to quality and clarity of the icons, especially when Cairo-Dock zoom the icons while you hover above them
+
The best solution is to collect and use icon that were made as real vectorial images. There are web site that contains huge amount of such icons. One important one is www.gnome-look.org. In there you can find original icons for some software but in general it contains subset of icons to be used in a theme. This is sometime interesting to get an homogeneous theme for your dock
+
Another site very complete is www.svgicons.o7a.net  (it was created for the original cairo-dock).
+
In the sources of Cairo_Dock there is a directory More_Icons which contains a fair amount of SVG icons.
+
=== With or without Beryl? ===
+
* With Beryl
+
If the Cairo-Dock is started before Beryl starts the dock will only appear on one of the Desktop. This is quite annoying. The workaround is to make sure that Cairo-Dock will start only after Beryl. A script is installed just for that with the dock (/usr/bin/launch-cairo-dock-after-beryl.sh). Allez dans System/Preferences/Session and add that script to the start-up section. it add a delay of 12 seconds to actual start of the dock. if you think it is too long or too short edit the script and change the value of the sleep command
+
It is possible that you will have to change the size of the "Vertical Virtual Size" for the dock to work correctly (Beryl Setting Manager / General Options / Vertical Virtual Size -> change the value from 1 to 2)
+
To be able to use the Dock in an optimal way deactivate the grabbing of focus in the "Beryl Setting Manager / General Options". Also in the "Animations" section of the "Visual effect" tab use the Zoom animation for the 2nd animation in the Create/Close windows part and also tick the menu box. Tips: set Animation duration to 300 for an "optimum" effect.
+
when you set the dock in the vertical view there is a 1 pixel shift from the edge of the screen even if you set a negative value in the Position Group tab. It is a "feature" of Beryl that will leave a 1 pixel space on the left and right edege of the desktop. Metacity doesn't have that issue
+
* Without Beryl
+
If you are not using Beryl then is fairly certain that you will not have transparency in the dock. The result will a black border all around the dock
+
To fix this you will have to install a module that allow transparency like xcompmgr. This module for example allow Metacity to have transparency and will get of the black border. You can have all these program (Metacity+xcompmgr and Beryl) installed at the same time but of course shouldn't use them at the same time.
+
Once installed you have to start xcompmgr at startup. click on System/Preferences/Session and choose "startup" then create a new item with the following command in it: xcompmgr -c -f -n
+
This will activate transparency as well as shading and fading effects. FOr more help on xcompmgr to see the different option: xcompmgr --help
+
=== Cairo-Dock on 64bits CPU wiht no compilation, it is possible ! ===
+
Here is a copy paste from a forum user (Ravan) who fought hard to make it works on his 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:
+
<ol><li>Install Getlibs following instructions on http://ubuntuforums.org/showthread.php?t=474790&highlight=getlibs
+
</li><li>Download the latest cairo-dock 32bit debs (both cairo-dock and plugins) to your home folder
+
</li><li>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
+
</li><li>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 :)
+
</li><li>If all is well, add cairo-dock to the Sessions list to make it start up at login...</li></ol>
+
 
+
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2008年10月19日 (日) 04:30的版本


  1. title Cairo-Dock

[[1]]

Introduction

Cairo-dock is an animated application launch bar for the desktop comparable to Mac OS X's Dock, or Rocket Dock (for those of you who come from Windows). It is compatible with Compiz-Fusion, Beryl, Compiz, and also Xcompmgr, but it can run without a composite manager (with fake transparency). Cairo-Dock can run under GNOME, KDE, and XFCE. This page describes only how to install Cairo-dock. If you want to know more (about configuration, themes,... ) you can see the official site: http://www.cairo-dock.org/index.php The site is in French mainly, but the wiki has an English section which is updated as often as the French part ;) If you have some questions or bugs to report, you can post on the forum http://www.cairo-dock.org/bg_forumlist.php . You can speak English there so don't be shy ;)

Installation and Initial Launch

The Project is split in to two parts: the dock itself and the plug-ins (which provides mainly the applets). The installation for both is the same, so only the installation of the dock is explained. You just have to make sure you install the plug-ins after the dock. The config file will not be overwritten during updates as Cairo-Dock is capable of inserting the missing fields if any without losing your previous settings.

From the repository (stable)

(only for Hardy Heron 32/64bit and Gutsy Gibbon 32 bit) Cairo-Dock has its own repository. So, to install it, you just have to edit your sources (sudo gedit /etc/apt/sources.list) and add the repository:

deb http://repository.cairo-dock.org/ubuntu hardy cairo-dock
or
deb http://repository.cairo-dock.org/ubuntu gutsy cairo-dock (if you are under Gutsy)

The signed GPG key for identification of the repository is:

wget -q http://repository.cairo-dock.org/ubuntu/cairo-dock.gpg -O- | sudo apt-key add -

So, type it in a shell. Then, to install cairo-dock, type in a shell:

sudo apt-get update
sudo apt-get install cairo-dock cairo-dock-plug-ins

There is no repository available for older distributions such as Feisty. So, if you want Cairo-Dock under Feisty or older, you must compile it, or download the package (see below).

With the deb package (stable)

If you can't install cairo-dock from the repository, you can download the package from Berlios. But you first need to install the following packages:

sudo apt-get install libcairo2 librsvg2-2 libglitz1 libglitz-glx1

Then, download the package: http://developer.berlios.de/project/showfiles.php?group_id=8724 in a shell, go to the directory where you have downloaded the .deb (use the command “cd the_directory”) and type

sudo dpkg -i xxx.deb

xxx is the name of the package you have downloaded and, type

sudo apt-get -f install

So, it's finished, you can type “cairo-dock” in a shell to launch it and configure it

By compiling it (stable)

You must first install the following packages:

sudo apt-get install build-essential libcairo2-dev libgtk2.0-dev librsvg2-dev libglitz1-dev libcairo2 librsvg2-2 libglitz1 libglitz-glx1 libglitz-glx1-dev m4 autotools-dev pkg-config libtool

Then, download the tar.bz2 package here: http://developer.berlios.de/project/showfiles.php?group_id=8724, in the shell go to the download directory with “cd” and type:

autoreconf -isvf
./configure –prefix=/usr
make
sudo make install

By compiling it with a script using the SVN version (unstable)

""/!\ PLEASE DON'T USE THIS VERSION OF CAIRO-DOCK IF YOU DON'T KNOW WHAT YOU'RE DOING /!\"" If you want to try the bleeding edge version of cairo-dock (not yet in the repository because it's not yet stable), you can use the SVN version. But be aware that this version is potentially unstable, and there are updates everyday. Please use this version only if you have used a stable version before, and if you know what you're doing. It is preferable to know how cairo-dock works to be able to use it. A script was written to compile the SVN version of Cairo-Dock easily. So, you just have to create a directory where the script will be installed in, to download the script, and to launch it: Open a Terminal, start by creating a specific repertory (for example /cairo-dock_svn):

mkdir /cairo-dock_svn
cd /cairo-dock_svn

Then get the script, make it executable and launch it:

wget http://cairo-dock.vef.fr/cairo-dock_svn.sh
chmod u+x cairo-dock_svn.sh
./cairo-dock_svn.sh

The SVN Password will be required: JUST PRESS ENTER. To finish, enter your own password when the script requires it in order to proceed with to the installation. A line will appear after the installation of each module and the final message indicates if everything went well. If not consult the log.txt file in the directory you have created at the beginning (~/cairo-dock_svn). Look at the end to locate the problem, then post it on the forum (you don't need to speak French ;) ) For a good use of this unstable version, please get information on our site: http://www.cairo-dock.org/ww_page.php?p=Accueil&lang=en (direct link to the English section of the wiki)

What is installed ?

This is a question that everyone should ask when installing a program. Cairo-Dock stores your launchers and your parameters in a hidden directory .cairo-dock in your own user directory.

~/.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
                           +--> .... 

The package also installs ready made themes in /usr/share/cairo-dock/themes. You can't modify them and they will be updated along with the dock.

First Launch

If you installed it from the packages, there should be a launcher in the menu, under the "System" sub-menu. If not, just press <ALT>+F2 and type cairo-dock in the window that will appear. To have the backtraces (sometimes useful if a problem should occur), open an terminal and type “cairo-dock &; disown” and press enter. On first launch, cairo-dock will configure itself and will propose a list of themes (this allows you to have an instant fully functional dock and an overview of the different functionalities and options). You may have to move the mouse cursor to the bottom of the screen to see the dock if auto-hide has been enabled. (It depends on the theme you choose. Generally, a little image is displayed on the hiding zone. Move your cursor on it) After that if you want to test another theme just right click on the Dock and select "Manage themes". Some options are available, try cairo-dock –help (in a terminal) to list them. If you want to learn more about themes and how to create your own theme, you can go to the official site's wiki http://www.cairo-dock.org/ww_page.php?p=Accueil&lang=en

Some screenshots and possibilities

Screenshots of desktops of the team Cairo-Dock

here you can see screenshots of desktops of people who work on Cairo-Dock http://www.cairo-dock.org/mc_album.php?a=3

Some possibilities, applets, views...

    • First, I'm going to show you the basic default view, simple, like the macOS bar. This is the view you will see when your dock is installed:

[[2]]

    • Here is my dock, configured with the "3D view". This is a classical view with reflection of icons on the dock-panel.

You can also see here, the applet "compiz-icon" with the "parabolic-view" wich is a beautiful view for sub-docks: [[3]]

    • This is the "carousel" view. The dock looks like a roundabout. It is beautiful but hard to manage ;)

[[4]]

    • You can see on this screenshot the curved view. This is my favorite view. And you can also see my sub dock "internet" with the "rainbow" view, very user friendly with sub docks which have a lot of launchers:

[[5]]

    • Here you can see the applet "weather" wich gives you the weather taken from the site weather.com. This applet has here the view "slide" which is smart for sub-docks which are not full:

[[6]]