about
news
screenshots
downloads
documentation
drawing
specifications
resources
forums
icon
icon
icon
icon
icon
icon
emblem random icons

valid xhtml valid css

BerliOS Logo
documentation



howto


about

Since we are using Gentoo Linux which is all about choices, we are providing several possible ways of installing Lila theme. This HOWTO will guide you through the process of setting up Lila theme. Feel free to skip sections that are talking about the obvious :)


credits

Thanks to salmo for his Liladdiction HOWTO and Ard Righ for his Quick Lila Install HOWTO which have been merged into this HOWTO and can both be found somewhere in the depths of the Lila Theme Official Thread on the Gentoo Discussion Forums :)
The Gentoo Portage Manual has been used as reference for non-Lila specific information.
The last changes in respect to liladdiction were made by Christian Lemke.


prerequisites

All commands are either preceded by a # or a $. The # indicates a root prompt. You will need to issue these commands as root. The $ indicates a user prompt. It's recommended to issue these commands as a normal user.

If you are a non-Gentoo user or don't want to use the automatisms we provide, please skip to non-automated choice. When you are reading this, you have chosen to use our little installation helps, congratulations on that :)
What you will need, regardless of the choice you are going to make below, is a PORTDIR_OVERLAY. If you already have one, please skip to automated choices. If you don't know what a PORTDIR_OVERLAY is or how to use it, by all means, read on :)

A PORTDIR_OVERLAY directory is a place where one can store custom ebuilds (such as Lila) and portage will treat them as if they were in the actual portage tree without having everything erased by issuing emerge sync.

Setting up a PORTDIR_OVERLAY is quite easy. First create a directory where you want to put your custom ebuilds, usually /usr/local/portage.

# mkdir /usr/local/portage

Now we need to let portage know about this directory. So edit your /etc/make.conf file by doing

# nano -w /etc/make.conf

and modify the overlay line like

PORTDIR_OVERLAY="/usr/local/portage"

Your PORTDIR_OVERLAY is now set up and ready to be used. Please continue with automated choices.


choices

Automated choices for Gentoo users

Choice A - Using the script

This is the recommended way of installing Lila for Gentoo. Liladdiction is a python script designed specifically for our needs.

If you're interested in fetching and installing the latest overlay run the script with no options. This will download and verify the latest overlay, extract it into your PORTDIR_OVERLAY (configurable at the top of the script, defaults to /usr/local/portage) check for a ~/.lila_themes file and digest and install the themes listed there. If there is no ~/.lila_themes file, it will prompt you for the packages to digest/install (and it only prompts once). It will also save the last overlay installed, and only download a overlay if a newer one is available.

If you have an existing ~/.lila_themes file from using lila-install (deprecated bash script) and you want to force it to prompt you for newly added ebuilds (such as the color themes) use the -p or --prompt option. Actually it prompts you for every ebuild all over again, so if you want to add or remove anything from your list, this is the way to do it. Unless, of course, you feel like editing your ~/.lila_themes file by hand, which you are perfectly welcome to do.

If you want to only download a new overlay, digest or install the latest ebuild of each package chosen (from ~/.lila_themes or --prompt mode) use the -aACTION or --action=ACTION where ACTION is one of download, digest, install or the default all.

Run it with -h or --help for a less verbose description of the options. --version prints the version.

Liladdiction uses GnuPG to verify the overlay tarballs. So you will need GnuPG installed!

At first download the liladdiction script from our server. You may place it anywhere you like.

$ wget http://lila-theme.berlios.de/files/script/liladdiction.py

We need to change permissions in order to execute the script.

$ chmod a+x liladdiction.py

All the Lila packages are masked by the ~arch keyword. That means that the packages should generally work but need testing. In case you are running ~arch you can simply run liladdiction and choose all the themes you want :)

# ./liladdiction.py

Most people though, will need to unmask the ebuilds first. This can be achieved by listing all the Lila packages you would like to install in /etc/portage/package.keywords. Have a look at the list of ebuilds available.

Create /etc/portage if it doesn't exist already.

# mkdir /etc/portage

Now either use echo or an editor of your choice.

# echo "x11-themes/lila-$package ~arch" >> /etc/portage/package.keywords

Where $package is any Lila package and ~arch the architecture you are running, for example ~x86 or ~amd64 or ~ppc.

Now you are ready to run liladdiction and choose all the themes you want :)

# ./liladdiction.py

After installation has finished please continue with the post installation instructions.


Choice B - Using the overlay

Using the PORTDIR_OVERLAY directly without script? All right.

First you have to fetch the latest overlay from our server. You might want to verify its integrity with GnuPG. For this you need to download the correspondig .asc file from the same place you got the overlay and place it in the same directory. Now we need to add the current maintainers' public key to your keyring

$ gpg --keyserver wwwkeys.pgp.net --recv-keys 0x4D6111CE

and run

$ gpg --verify lila-theme-$date.tar.bz2.asc

Whereas $date is the actual date of the overlay.

Assuming that your PORTDIR_OVERLAY is /usr/local/portage we do

# mv lila-theme-*.tar.bz2 /usr/local/portage/
# tar -xvjf /usr/local/portage/lila-theme-*.tar.bz2

You should remove the tarball afterwards, as you don't need it anymore

# rm /usr/local/portage/lila-theme-*.tar.bz2

The ebuilds are now in your PORTDIR_OVERLAY, but they are masked by the ~arch keyword. In case you are running ~arch you can simply run

# emerge -s lila

Have a look at what's there and install anything you like.

Most people though, will need to unmask the ebuilds first. This can be achieved by listing all the Lila packages you would like to emerge in /etc/portage/package.keywords. Have a look at your PORTDIR_OVERLAY to see what's there.

# ls /usr/local/portage/x11-themes

Create /etc/portage if it doesn't exist already.

# mkdir /etc/portage

Now either use echo or an editor of your choice.

# echo "x11-themes/lila-$package ~arch" >> /etc/portage/package.keywords

Where $package is any Lila package found in your PORTDIR_OVERLAY/x11-themes and ~arch the architecture you are running, for example ~x86 or ~amd64 or ~ppc.

After that Lila can now be installed using emerge as you would do normally. Please also consider the instructions section.


Choice C - Using the ebuilds

You chose to use the ebuilds directly. This is encouraged only if you plan to use merely a couple of ebuilds, because it is quite a tedious work to place and digest a lot of ebuilds in your PORTDIR_OVERLAY. But please, go on :)

Assumed your PORTDIR_OVERLAY is in /usr/local/portage we do

# cd /usr/local/portage

Now we need to create directories for the Lila ebuilds. First we need the x11-themes directory

# mkdir x11-themes

Have a look at the list of ebuilds available. When you have chosen the Lila packages you would like to install you have to create a directory for each ebuild in x11-themes.

It's quite simple, for lila-$package-$version.ebuild you need to create a lila-$package directory

# mkdir x11-themes/lila-$package

Then fetch and digest the ebuild

# wget -P x11-themes/lila-$package http://lila-theme.berlios.de/files/ebuilds/lila-$package-$version.ebuild
# ebuild x11-themes/lila-$package/lila-$package-$version.ebuild digest

You need to go throught these tree steps for every ebuild you would like to emerge afterwards.

Now go on and install everything you just digested.

# emerge -pv lila-$package1 lila-$package2 ...

That's it! Congratulations, you just installed Lila the hard way :)
You might also want to have a look at the section for post installation instructions.


Non-automated choice for non-Gentoo users and purists :)
Choice D - Using the tarballs

You decided to use the tarballs without any automatisms. That's perfectly fine, but you'll need to know where to extract them on your system. It's generally a good idea to have a look at /usr/share/... and see what's there. If you're unsure it might help to have a look at the ebuilds and consider the basedir line, which tells you where the tarball would get extracted to if you used that ebuild. Good luck!

Once you successfully installed Lila on your system, you might want to read the post installation instructions.



instructions


For information on application/package specific setups please read the following instructions.

(more to come)








issues


There are some known issues with Lila theme, specifically with the icons. Workarounds are listed here.