Sensible defaults
[wmaker-crm.git] / WindowMaker / README.themes
blobd7327ac030caba3c25dc99b7a4b939a564b7f70b
4 Themes For Window Maker
5 =======================
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.
12 How To Install a Theme Pack
13 ===========================
15 To install a theme, unpack your theme into your WindowMaker directory 
16 (the same as old-style themes), usually ~/GNUstep/Library/WindowMaker
18 cd ~/GNUstep/Library/WindowMaker
19 gzip -dc "xyztheme.tar.gz" | tar xvf -
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.
26 How To Load a Theme
27 ===================
29 Use the setstyle command to load a theme. Example:
31 setstyle xyztheme.themed
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.
38 How To Make a Theme Pack
39 ========================
41 To create a theme pack from your current configuration, use the getstyle
42 utility with the -p flag. Example:
44 getstyle -p ~/GNUstep/Library/WindowMaker/Themes/MyTheme
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.
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.
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.
59 Example:
61 cd ~/GNUstep/Library/WindowMaker
62 tar cvf MyTheme.tar Themes/MyTheme.themed
63 gzip MyTheme.tar
66 How To Delete a Theme Pack
67 ==========================
69 Just remove the .themed directory. Example:
71 cd ~/GNUstep/Library/WindowMaker/Themes
72 rm -fr themename.themed
75 How To Save Disk Space
76 ======================
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:
82 theme1.themed/back.jpg
84 theme2.themed/backimage.jpg
86 theme3.themed/back.jpg
88 and all three files contain the same image, you can do:
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