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
Slávek Banko 2f706891f3
Desktop file translations:
4 years ago
..
CMakeL10n.txt Add CMakeL10n rules. 6 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. 13 years ago
installktheme.desktop Desktop file translations: 4 years ago
kdeinstallktheme Rename kde-config to tde-config 13 years ago
knewthemedlg.cpp Rename additional header files to avoid conflicts with KDE4 12 years ago
knewthemedlg.h Revert automated changes 14 years ago
ktheme.cpp Conversion startkde -> starttde, exitkde -> exittde in r14-xdg-upd file and related usage in code. This resolves bug 2282 and 2283. 6 years ago
ktheme.h Rename KStandard for enhanced compatibility with KDE4 12 years ago
kthemedlg.ui Add includes to UI files to resolve FTBFS 6 years ago
kthemedlg.ui.h Fix unresponsive kcontrol theme manager buttons. 11 years ago
kthememanager.cpp Remove old upstream URLs of tdebase. 5 years ago
kthememanager.desktop Desktop file translations: 4 years ago
kthememanager.h Rename KIcon to enhance compatibility with KDE4 12 years ago
newthemewidget.ui Remove additional unneeded tq method conversions 13 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