Difference between revisions of "Installation"

From Tango Desktop Project
Jump to: navigation, search
(Overall changes for readability)
Line 1: Line 1:
Installing Tango is quite straight forward but this guide will help you if you have any difficulties. This guide was written for a user of Ubuntu Linux, but the concepts should generally apply to other distributions.
+
Installing Tango is intended to be straight forward, however this guide will help if you have any difficulties.
  
 
==From CVS==
 
==From CVS==
You will need t following packages for a successful installation:
+
You will need the following packages for a successful installation:
*automake-1.6 (at least, highly recommended you use 1.9)
+
*GNU Automake and friends
 
*XML::Simple Perl Module
 
*XML::Simple Perl Module
 
*ImageMagick Development Packages
 
*ImageMagick Development Packages
  
 +
A recent version of librsvg or kdelibs is also suggested for generating PNGs. For now, rsvg from librsvg is the preferred method as it produces much better quality PNGs when compared to ksvgtopng.
  
 
===Icon Naming Utilities===
 
===Icon Naming Utilities===
First we need to install icon-naming-utils, tools that rename the icon files appropriatly to the desktop environment you use. It should be noted, that every time icon-naming-utils updates, you should rebuild Tango, for consistancy.
+
First, we need to install icon-naming-utils. The naming utilities generate the icon files appropriate to the desktop environment you use. It should be noted, when icon-naming-utils is updated, tango-icon-theme should also be updated.
  
So, lets grab icon-naming-utils. When prompted for a password at CVS, just press enter. This will give you an anonymous login.
+
So, let's grab icon-naming-utils. When prompted for a password at CVS, just press enter. This will give you an anonymous login.
 
<html>
 
<html>
 
<pre>
 
<pre>
Line 25: Line 26:
 
<pre>
 
<pre>
 
./autogen.sh
 
./autogen.sh
 +
./configure --prefix <path> (optional)
 
make
 
make
sudo make install
+
make install (with administrator privileges)
 
</pre>
 
</pre>
 +
</html>
 +
 +
It's worth noting that icon-naming-utils can be installed and used with user privileges as well.
 +
 +
===Tango Icon Theme===
 +
Now we get to the fun part! First, lets grab Tango. Make sure you've left the icon-naming-utils directory.
 +
This is the same process as before:
  
===Tango===
 
Now we get the fun part! First, lets grab Tango, you'll probably also want to leave the icon-naming-utils directory. This is the same process as before:
 
 
<html>
 
<html>
 
<pre>
 
<pre>
cd ..
 
 
 
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango login
 
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango login
 
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango co tango-icon-theme
 
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango co tango-icon-theme
Line 42: Line 47:
 
</html>
 
</html>
  
Now, onto installing Tango. This is generally the same as icon-naming-utils, accept you will want to pay close attention to ./configure flags. So, firstly, we need to view what flags are available:
+
Now, onto installing Tango. This is generally the same as icon-naming-utils, except you will want to pay closer attention to ./configure flags. First, we need to review what flags are available:
 
<html>
 
<html>
 
<pre>
 
<pre>
Line 50: Line 55:
 
</html>
 
</html>
  
If you use KDE, you will want to have png images generated, but for gnome a standard ./configure should be fine. So, let's get down to the fun stuff!
+
If you use KDE, you will want to generate PNG images. For GNOME, a standard ./configure should suffice. So, let's back to the fun stuff! Note that the chosen --prefix needs to point to a location that allows your chosen desktop environment to find it (usually /usr or /opt, depending on how you've installed a given destop environment).
 
<html>
 
<html>
 
<pre>
 
<pre>
./configure --prefix /usr
+
./configure --prefix <path>
 
make
 
make
sudo make install
+
make install (with administrator privileges)
 
</pre>
 
</pre>
 
</html>
 
</html>
  
And now, just choose Tango from the theme manager. Enjoy!
+
Tango can also be installed with user privileges, using --prefix=$HOME/.icons. In KDE's case, --prefix=$HOME/.kde/share/icons can be used.
 +
 
 +
Finally, you should now be able to choose Tango from your desktop environment's theme manager. Enjoy!

Revision as of 20:50, 6 December 2005

Installing Tango is intended to be straight forward, however this guide will help if you have any difficulties.

From CVS

You will need the following packages for a successful installation:

  • GNU Automake and friends
  • XML::Simple Perl Module
  • ImageMagick Development Packages

A recent version of librsvg or kdelibs is also suggested for generating PNGs. For now, rsvg from librsvg is the preferred method as it produces much better quality PNGs when compared to ksvgtopng.

Icon Naming Utilities

First, we need to install icon-naming-utils. The naming utilities generate the icon files appropriate to the desktop environment you use. It should be noted, when icon-naming-utils is updated, tango-icon-theme should also be updated.

So, let's grab icon-naming-utils. When prompted for a password at CVS, just press enter. This will give you an anonymous login.

cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/icon-theme login
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/icon-theme co icon-naming-utils

cd icon-naming-utils

Now, we build icon-naming-utils (in the standard way):

./autogen.sh
./configure --prefix  (optional)
make
make install (with administrator privileges)

It's worth noting that icon-naming-utils can be installed and used with user privileges as well.

Tango Icon Theme

Now we get to the fun part! First, lets grab Tango. Make sure you've left the icon-naming-utils directory. This is the same process as before:

cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango login
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango co tango-icon-theme

cd tango-icon-theme

Now, onto installing Tango. This is generally the same as icon-naming-utils, except you will want to pay closer attention to ./configure flags. First, we need to review what flags are available:

./autogen.sh
./configure --help

If you use KDE, you will want to generate PNG images. For GNOME, a standard ./configure should suffice. So, let's back to the fun stuff! Note that the chosen --prefix needs to point to a location that allows your chosen desktop environment to find it (usually /usr or /opt, depending on how you've installed a given destop environment).

./configure --prefix 
make
make install (with administrator privileges)

Tango can also be installed with user privileges, using --prefix=$HOME/.icons. In KDE's case, --prefix=$HOME/.kde/share/icons can be used.

Finally, you should now be able to choose Tango from your desktop environment's theme manager. Enjoy!