Installation

From Tango Desktop Project
Revision as of 23:05, 16 December 2005 by Straw (talk) (add some feet to each section)

Jump to: navigation, search

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!