Difference between revisions of "Installation"

From Tango Desktop Project
Jump to: navigation, search
(Overall changes for readability)
(updated for both using cvs and releases)
Line 1: Line 1:
 
Installing Tango is intended to be straight forward, however this guide will help if you have any difficulties.
 
Installing Tango is intended to be straight forward, however this guide will help if you have any difficulties.
  
==From CVS==
+
== Requirements ==
 
You will need the following packages for a successful installation:
 
You will need the following packages for a successful installation:
*GNU Automake and friends
+
*GNU Automake 1.9.x and friends
 +
*ImageMagick version 5.5.7 or greater
 +
*pkgconfig version 0.19 or greater
 
*XML::Simple Perl Module
 
*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.
 
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.
 +
 +
Both release tarballs and cvs checkouts are available.
 +
 +
[http://tango-project.org/Tango_Icon_Library#Download Releases]
 +
 +
[http://tango-project.org/Tango_Icon_Library#CVS CVS]
 +
 +
When prompted for a password at CVS, just press enter. This will give you an anonymous login.
  
 
===Icon Naming Utilities===
 
===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.
 
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.
 
<html>
 
<pre>
 
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
 
</pre>
 
</html>
 
  
Now, we build icon-naming-utils (in the standard way):
+
Build and install icon-naming-utils:
 
<html>
 
<html>
 
<pre>
 
<pre>
./autogen.sh
+
./autogen.sh (if using CVS)
./configure --prefix <path> (optional)
+
./configure --prefix=/usr  (or /opt or whatever is useful)
 
make
 
make
make install (with administrator privileges)
+
make install (may require administrator privileges)
 
</pre>
 
</pre>
 
</html>
 
</html>
  
It's worth noting that icon-naming-utils can be installed and used with user privileges as well.
+
Note that icon-naming-utils places its pkg-config file in /usr/share/pkgconfig/. Adjust PKG_CONFIG_PATH to reflect this as necessary.
  
 
===Tango Icon Theme===
 
===Tango Icon Theme===
Now we get to the fun part! First, lets grab Tango. Make sure you've left the icon-naming-utils directory.
+
Now, onto installing Tango. This is generally similar to installing icon-naming-utils, except you may want to pay closer attention to ./configure's flags if installing for use in desktop environments that support only the PNG image format. First, we need to review what flags are available:
This is the same process as before:
 
  
 
<html>
 
<html>
 
<pre>
 
<pre>
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango login
+
./autogen.sh (if using CVS)
cvs -d:pserver:anoncvs@pdx.freedesktop.org:/cvs/tango co tango-icon-theme
+
./configure --help
 
 
cd tango-icon-theme
 
 
</pre>
 
</pre>
 
</html>
 
</html>
  
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:
+
If you use KDE, you will want to generate PNG images. For GNOME, a standard ./configure should suffice. Note that the chosen --prefix needs to point to a location that allows your chosen desktop environment to find the icon theme (usually /usr or /opt, depending on how you or your distribution have installed a given destop environment).
<html>
 
<pre>
 
./autogen.sh
 
./configure --help
 
</pre>
 
</html>
 
  
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 <path>
+
./autogen.sh  (if using CVS)
 +
./configure --prefix=/usr  (or /opt or whatever is useful)
 
make
 
make
make install (with administrator privileges)
+
make install (may require administrator privileges)
 
</pre>
 
</pre>
 
</html>
 
</html>
  
Tango can also be installed with user privileges, using --prefix=$HOME/.icons. In KDE's case, --prefix=$HOME/.kde/share/icons can be used.
+
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!
 
Finally, you should now be able to choose Tango from your desktop environment's theme manager. Enjoy!

Revision as of 22:58, 16 December 2005

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

Requirements

You will need the following packages for a successful installation:

  • GNU Automake 1.9.x and friends
  • ImageMagick version 5.5.7 or greater
  • pkgconfig version 0.19 or greater
  • XML::Simple Perl Module

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.

Both release tarballs and cvs checkouts are available.

Releases

CVS

When prompted for a password at CVS, just press enter. This will give you an anonymous login.

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.


Build and install icon-naming-utils:

./autogen.sh  (if using CVS)
./configure --prefix=/usr  (or /opt or whatever is useful)
make
make install  (may require administrator privileges)

Note that icon-naming-utils places its pkg-config file in /usr/share/pkgconfig/. Adjust PKG_CONFIG_PATH to reflect this as necessary.

Tango Icon Theme

Now, onto installing Tango. This is generally similar to installing icon-naming-utils, except you may want to pay closer attention to ./configure's flags if installing for use in desktop environments that support only the PNG image format. First, we need to review what flags are available:

./autogen.sh (if using CVS)
./configure --help

If you use KDE, you will want to generate PNG images. For GNOME, a standard ./configure should suffice. Note that the chosen --prefix needs to point to a location that allows your chosen desktop environment to find the icon theme (usually /usr or /opt, depending on how you or your distribution have installed a given destop environment).

./autogen.sh  (if using CVS)
./configure --prefix=/usr  (or /opt or whatever is useful)
make
make install  (may require 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!