TDE base libraries and programs
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.
Slávek Banko b95b665c78
Add CMakeL10n rules.
5 months ago
..
CMakeL10n.txt Add CMakeL10n rules. Update TIMEZONES list. 5 months ago
CMakeLists.txt Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
Makefile.am Additional k => tde renaming and fixes 5 years ago
NEWS Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
README Rename kwin to twin (part 1 of 2) 7 years ago
TODO Fix references of K Menu -> TDE Menu. 7 years ago
installktheme.desktop Branding cleanup: *.desktop files 7 years ago
kdeinstallktheme Rename kde-config to tde-config 7 years ago
knewthemedlg.cpp Rename additional header files to avoid conflicts with KDE4 6 years ago
knewthemedlg.h Revert automated changes 8 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 months ago
ktheme.h Rename KStandard for enhanced compatibility with KDE4 6 years ago
kthemedlg.ui Add includes to UI files to resolve FTBFS 8 months ago
kthemedlg.ui.h Fix unresponsive kcontrol theme manager buttons. 5 years ago
kthememanager.cpp Bring most mimetypes in line with XDG specifications. The following are not fully verified in source as of this commit due to ubiquity: html, empty, info, make, man, misc, source, unknown 4 years ago
kthememanager.desktop Fix remaining missing semicolons at end of Keywords strings 4 years ago
kthememanager.h Rename KIcon to enhance compatibility with KDE4 6 years ago
newthemewidget.ui Remove additional unneeded tq method conversions 7 years ago
x-ktheme.desktop Update XDG information in support of bug report 892. 7 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