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
tpearson fd3a982e26
Revert automated changes
14 years ago
..
Makefile.am Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
NEWS Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
README Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
TODO Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
installktheme.desktop Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kdeinstallktheme Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
knewthemedlg.cpp Trinity Qt initial conversion 14 years ago
knewthemedlg.h Revert automated changes 14 years ago
ktheme.cpp Revert automated changes 14 years ago
ktheme.h Trinity Qt initial conversion 14 years ago
kthemedlg.ui Revert automated changes 14 years ago
kthemedlg.ui.h Trinity Qt initial conversion 14 years ago
kthememanager.cpp Revert automated changes 14 years ago
kthememanager.desktop Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
kthememanager.h TQt conversion fixes 14 years ago
newthemewidget.ui Revert automated changes 14 years ago
x-ktheme.desktop Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 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|kwin" name="eventname" url="theme:/sounds/file.wav" />
    ...
</sounds>
<colors contrast="7">
    <alternateBackground rgb="#123456" object="global|kwin"/>
    ...
</colors>
<cursors name="theme_name" />
<wm type="builtin|custom" name="kwin_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