You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdebase/kcontrol/kthememanager
Michele Calgaro 0d9263f836
Replace Q_SIGNALS and Q_SLOTS
2 months ago
..
CMakeL10n.txt Add CMakeL10n rules. 5 years ago
CMakeLists.txt Desktop file translations: 4 years ago
Makefile.am Additional k => tde renaming and fixes 11 years ago
NEWS Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
README Rename kwin to twin (part 1 of 2) 13 years ago
TODO Fix references of K Menu -> TDE Menu. 12 years ago
installktheme.desktop Desktop file translations: 4 years ago
kdeinstallktheme Rename kde-config to tde-config 12 years ago
knewthemedlg.cpp Use new TQ_METHOD, TQ_SIGNAL, TQ_SLOT defines 2 months ago
knewthemedlg.h Replace Q_OBJECT with TQ_OBJECT 8 months ago
ktheme.cpp Removed additional code formatting modelines. 4 years ago
ktheme.h Removed additional code formatting modelines. 4 years ago
kthemedlg.ui Replace Q_SIGNALS and Q_SLOTS 2 months ago
kthemedlg.ui.h Fix unresponsive kcontrol theme manager buttons. 11 years ago
kthememanager.cpp Use new TQ_METHOD, TQ_SIGNAL, TQ_SLOT defines 2 months ago
kthememanager.desktop Desktop file translations: 4 years ago
kthememanager.h Replace Q_OBJECT with TQ_OBJECT 8 months ago
newthemewidget.ui Remove additional unneeded tq method conversions 12 years ago
x-ktheme.desktop Desktop file translations: 4 years ago

README

This theme manager should handle installing, removing
and creating global visual KDE themes. It's written
from scratch, totally unrelated to the old kthememgr
which was not maintained and obsolete.

*** WARNING ***
The XML file format is still subject to change!
*** WARNING ***

(c) 2003, 2004 Lukas Tinkl <lukas@kde.org>


A KDE theme consists of:
========================
- wallpapers or bg colors
- icons
- sounds
- color scheme
- cursor theme
- window decorations
- screensaver
- name of the widget theme
- themed apps (mainly Konqueror and Kicker)


Sample XML theme config file:
=============================
<ktheme version="1">
<general>
    <author value="Me" />
    <email value="me@home.com" />
    <homepage value="http://me.home.com" />
    <version value="0.1" />
    <comment value="this is a nice theme, bla bla" />
</general>
<desktop number="0" common="true|false">
    <mode id="Flat|Pattern|*Gradient" />
    <color1 rgb="#123456" />
    <color2 rgb="#123456" />
    <blending mode="" balance="" reverse="true|false" />
    <pattern name="fish" />
    <wallpaper url="theme:/wallpapers/desktop/image.jpg"
	mode="Centred|Tiled|CenterTiled|CentredMaxpect|TiledMaxpect|Scaled|CentredAutoFit" />
</desktop>
<icons name="crystalsvg" />
<sounds>
    <event object="global|twin" name="eventname" url="theme:/sounds/file.wav" />
    ...
</sounds>
<colors contrast="7">
    <alternateBackground rgb="#123456" object="global|twin"/>
    ...
</colors>
<cursors name="theme_name" />
<wm type="builtin|custom" name="twin_lib_name">
    <buttons left="M" right="HIAX" />
    <border size="number" />
</wm>
<konqueror>
    <wallpaper url="" />
    <bgcolor rgb="#123456" />
</konqueror>
<panel>
    <background url="theme:/wallpapers/panel.png" colorize="true|false" />
    <!-- or -->
    <transparent value="true|false" />
</panel>
<widgets name="Style Name" />
<screensaver name="saver.desktop" />
</kdetheme>


Theme storage:
==============
- a gzipped tarball, directory tree based (e.g. theme.kth)


Sample dir tree:
================
-- mytheme.kth
   - mytheme.xml
   - mytheme.preview.png
   - sounds/
   - wallpapers/
     - konqueror/
     - desktop/
     - panel/

     
The notion of "url" here:
=========================
- local: points to an already installed file in the system
  (must be a sole filename, e.g. "background.png"); this differs
  according to the theme part (ie. can be different for sounds
  and/or wallpapers)
- theme: relative to the root of the theme tarball or directory
  (e.g. theme:/wallpapers/desktop/image.png)
- other URLs are not allowed, the file must be contained
  either in the theme or in the target system