~profzoom/ubuntu/quantal/wmaker/bug-1079925

« back to all changes in this revision

Viewing changes to WindowMaker/README.themes

  • Committer: Bazaar Package Importer
  • Author(s): Marcelo E. Magallon
  • Date: 2004-11-10 14:05:30 UTC
  • Revision ID: james.westby@ubuntu.com-20041110140530-qpd66b5lm38x7apk
Tags: upstream-0.91.0
ImportĀ upstreamĀ versionĀ 0.91.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
 
 
3
 
 
4
Themes For Window Maker
 
5
=======================
 
6
 
 
7
Note: the information contained in this file is only valid for themes
 
8
in the .themed (for theme directory) format, supported in 
 
9
Window Maker 0.20.4 or newer.
 
10
 
 
11
 
 
12
How To Install a Theme Pack
 
13
===========================
 
14
 
 
15
To install a theme, unpack your theme into your WindowMaker directory 
 
16
(the same as old-style themes), usually ~/GNUstep/Library/WindowMaker
 
17
 
 
18
cd ~/GNUstep/Library/WindowMaker
 
19
gzip -dc "xyztheme.tar.gz" | tar xvf -
 
20
 
 
21
You can also do this in your system-wide WindowMaker directory (usually
 
22
/usr/local/share/WindowMaker) to have the themes be available to all 
 
23
your users. This will probably need to be done with root access.
 
24
 
 
25
 
 
26
How To Load a Theme
 
27
===================
 
28
 
 
29
Use the setstyle command to load a theme. Example:
 
30
 
 
31
setstyle xyztheme.themed
 
32
 
 
33
Note that if you move the directory of the theme (for example, from
 
34
~/GNUstep/Library/WindowMaker/Themes to /usr/local/share/WindowMaker/Themes)
 
35
you will have to reload that theme so that path information is updated.
 
36
 
 
37
 
 
38
How To Make a Theme Pack
 
39
========================
 
40
 
 
41
To create a theme pack from your current configuration, use the getstyle
 
42
utility with the -p flag. Example:
 
43
 
 
44
getstyle -p ~/GNUstep/Library/WindowMaker/Themes/MyTheme
 
45
 
 
46
This will create a theme pack (a new directory in either the current
 
47
directory or a directory you specify) named MyTheme.themed, containing
 
48
everything it requires, including all pixmap files. In this example,
 
49
the new theme pack would be made in your themes directory and be 
 
50
immediately available in your Themes menu.
 
51
 
 
52
Additionally, you can put a text file named MyTheme.lsm in the MyTheme.themed 
 
53
directory. This file can contain info like copyrights, credits or whatever.
 
54
 
 
55
To distribute your theme, just make a .tar.gz of the .themed directory.
 
56
This is preferably done from the same directory that you unpack the themes
 
57
from to maintain consistancy with the old theme format.
 
58
 
 
59
Example:
 
60
 
 
61
cd ~/GNUstep/Library/WindowMaker
 
62
tar cvf MyTheme.tar Themes/MyTheme.themed
 
63
gzip MyTheme.tar
 
64
 
 
65
 
 
66
How To Delete a Theme Pack
 
67
==========================
 
68
 
 
69
Just remove the .themed directory. Example:
 
70
 
 
71
cd ~/GNUstep/Library/WindowMaker/Themes
 
72
rm -fr themename.themed
 
73
 
 
74
 
 
75
How To Save Disk Space
 
76
======================
 
77
 
 
78
If you have more than 1 theme that use the same huge background image,
 
79
you can delete all the duplicated files and then create hard links in
 
80
place of them. For example, if you have:
 
81
 
 
82
theme1.themed/back.jpg
 
83
 
 
84
theme2.themed/backimage.jpg
 
85
 
 
86
theme3.themed/back.jpg
 
87
 
 
88
and all three files contain the same image, you can do:
 
89
 
 
90
rm theme2.themed/backimage.jpg
 
91
rm theme3.themed/back.jpg
 
92
ln theme1.themed/back.jpg theme2.themed/backimage.jpg
 
93
ln theme1.themed/back.jpg theme3.themed/back.jpg
 
94
 
 
95