summaryrefslogtreecommitdiffstats
path: root/superkaramba/doc/faq/faq.txt
blob: e7524934af5aea28bc973e6bb8a51b8dc5f34d2a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
SuperKaramba Frequently Asked Questions

This FAQ is current to SuperKaramba 0.35. For more information about this FAQ, please visit the SuperKaramba Help forum (http://sourceforge.net/forum/forum.php?forum_id=67470) or contact selan at users dot sf dot net.
______________________________________________________________________

FAQ Revised: Tuesday 09 November 2004 21:31:57


Table of Contents


1. Installation

1.1. Where can I find SuperKaramba RPMs?
1.2. When I try to compile, I get this error: "Python.h: No such file or directory"
1.3. When I try to compile, I get this error: "cannot find -lselinux"
1.4. After running ./configure,make, and make install, the superkaramba executable is not where I expected it to be. When I try to run superkaramba from the command line it says "command not found".


2. General

2.1. How do I get rid of the KDE taskbar? Do I have to keep kicker running?
2.2. Can I run a systray theme while the kicker systray is running?
2.3. How do I set up my themes to run automatically on startup?
2.4. Why is the Edit Script option disabled when I right-click on a theme?
2.5. Why is the Configure Theme menu disabled when I right-click on a theme?


3. Troubleshooting

3.1. All of my themes are "always on top" of the other windows.
3.2. My themes start up in different locations when I start KDE.
3.3. The backgrounds of my themes are black instead of transparent.


4. Installation Guides

4.1. Suse 9.1 Personal
4.2. Mandrake (9.0 and up)



1. Installation


1.1. Where can I find SuperKaramba RPMs?

The SuperKaramba web site (http://netdragon.sourceforge.net) has a list of user-submitted RPMs for several distributions. Other user-submitted RPMs have been posted to kde-look.org and to the SuperKaramba Help forum.

1.2. When I try to compile, I get this error: "Python.h: No such file or directory"

You will need to install the python-devel package. Once that package is installed you can ./configure and make again.

1.3. When I try to compile, I get this error: "cannot find -lselinux"

You will need to install the libselinux-devel package. Once that package is installed you can ./configure and make again.

1.4. After running ./configure,make, and make install, the superkaramba executable is not where I expected it to be. When I try to run superkaramba from the command line it says "command not found".

In some distributions ./configure points to different path than you might expect. For example, in Mandrake the default ./configure prefix is /usr/local/kde and the executable is installed in /usr/local/kde/bin. There are a few things you can do to fix this. You could run ./configure --prefix=/usr to specify the prefix that you prefer and then try make and make install again. Or you could create a symbolic link in your preferred directory that links to the executable. Or you could add the install directory to your $PATH.


2. General


2.1. How do I get rid of the KDE taskbar? Do I have to keep kicker running?

Many themes depend on kicker and will not work well without it. If you don't want kicker to show on your desktop, you can set it to auto-hide. Another solution is to change the auto-hide setting in a ~/.kde file. For more information see http://wiki.kdenews.org/tiki-print.php?page=Secret+Config+Settings.

2.2. Can I run a systray theme while the kicker systray is running?

It's better not to. If you run a theme with a SysTray on it while a regular kicker systray is running, the theme will "steal" all the icons from the first systray.  This is because in KDE and Gnome, the systray icons are really little windows and there is only one copy of each running. If you want to run a systray theme, you can remove the systray from kicker.

2.3. How do I set up my themes to run automatically on startup?

Turn on KDE session support in the KDE control panel. When session support is enabled, any theme that is left running when you logout will automatically start on startup. For some themes you will also need to right-click and reload the theme at least once after running it so that the config file will get written to your home directory. Another solution is to create a desktop config file in the KDE autostart directory. 
To create a desktop config file, open KWrite and enter the following:
            [Desktop Entry]
            Exec=superkaramba {location of theme file}.theme
            Name={theme name}
            Type=Application
            X-TDE-StartupNotify=false
Then save it as {theme}.desktop into /home/{user}/.kde/Autostart/.

2.4. Why is the Edit Script option disabled when I right-click on a theme?

Some karamba themes don't include a python script. This is normal and those themes will still work fine without one. However, if the theme does use a python script, superkaramba may have not been able to load the script. This is usually due to python errors. Run the theme from the command line to find out the specific error message.

2.5. Why is the Configure Theme menu disabled when I right-click on a theme?

The Configure Theme menu is only enabled if the theme has added options to it. Some themes do not have any configuration options or use a different configuration method.


3. Troubleshooting


3.1. All of my themes are "always on top" of the other windows.

This problem should be fixed in the most recent release.

3.2. My themes start up in different locations when I start KDE.

Close all superkaramba themes and then delete any session files in ~/.kde/share/config/session/ that begin with superkaramba. Restart KDE and start your themes again. Now they will stay in the right place.

3.3. The backgrounds of my themes are black instead of transparent.

In KDE, transparency only works when the desktop background is a wallpaper image that is centered or scaled. If the background is a plain color or a tiled image then superkaramba themes will not be transparent. In Gnome, there is a known issue that themes will have a black background even when a wallpaper is set.  Unfortunately there is no current solution. Your theme should work fine otherwise.


4. Installation Guides


4.1. Suse 9.1 Personal

To install on SuSE 9.1 Personal, ensure the following packages are installed, which you verify via YaST:

qt3-devel

tdelibs3-devel

python-devel


Once the above are installed, unzip your SuperKaramba tarball to its own folder.  Now, via terminal, login as root and cd (change directory) to the unzipped SuperKaramba folder. Install with following commands:

./configure --prefix=/opt/trinity/

make

make install

make clean


You're done! To start SuperKaramba, you should now be able to find SuperKaramba in your "Utilities" folder in the main Menu.


* This has not been tested on SuSE 9.1 Professional or previous versions of SuSE.  However, the need to use the ./configure --prefix=/opt/trinity/ command has been needed in previous versions by some people.

4.2. Mandrake (9.0 and up)

Unzip your SuperKaramba tarball to its own folder.  Now, via terminal, cd (change directory) to the unzipped SuperKaramba folder. Install with following commands:

./configure --prefix=/usr

make

(login as root) make install



______________________________________________________________________
Copyright (C) 2004 Sarah Elan,  Adam Geitgey, Rory in Toronto, Ryan Nickell 
and many others who contribute to the SuperKaramba Help forum.

This FAQ was generated by makefaq. 
http://www.makefaq.org/
______________________________________________________________________