WINGs: Better presentation for example code in the tutorial
[whome.git] / themepacks.php
bloba46426d5a1a5c9064a5590b3b581eb20d49540a8
1 <html xmlns="http://www.w3.org/1999/xhtml">
2 <head>
3 <meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
5 <title>Window Maker: Themes</title>
6 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
7 <link href="title.css" rel="stylesheet" type="text/css" />
8 </head>
10 <body>
11 <?php include("dock.php"); ?>
12 <?php include("header.php"); ?>
14 <table class="inner" border="0" cellpadding="1" cellspacing="1">
15 <tr>
16 <td content="content" colspan="2" valign="top">
17 <br />
18 <br />
21 <h1>ThemePacks HOWTO</h1>
23 <h2>Themes (Theme Packs) For Window Maker</h2>
25 <b>Note:</b> the information contained in this file is only valid for themes
26 in the <tt>.themed</tt> (for theme directory) format, supported in
27 Window Maker 0.50.0 or newer. See <a href="theme-HOWTO.php">here</a> for
28 information on themes for WindowMaker-0.20.3 and earlier.
29 <br><br><br>
32 <h2>How To Install a Theme Pack</h2>
34 To install a theme, unpack your theme into your <tt>WindowMaker</tt> directory
35 (the same as old-style themes), usually <tt>~/GNUstep/Library/WindowMaker</tt>
36 <br><br>
37 <tt>cd ~/GNUstep/Library/WindowMaker</tt><br>
38 <tt>gzip -dc "xyztheme.tar.gz" | tar xvf -</tt>
39 <br><br>
40 You can also do this in your system-wide <tt>WindowMaker</tt> directory (usually
41 <tt>/usr/local/share/WindowMaker</tt>) to have the themes be available to all
42 your users. This will probably need to be done with root access.
43 <br><br><br>
46 <h2>How To Load a Theme</h2>
47 After installing a theme, it will automatically show up in your menu under <b>Appearance -> Themes -> ThemeName</b>.
48 (unless of course you have manually changed your menu to remove this) If you have your Themes menu already opened and
49 pinned to your desktop, you may need to close it and reopen it to have it show the new theme.
50 <br><br>
51 To manually load the new theme from the command line, use the <tt>setstyle</tt> command. Example:
52 <br><br>
53 <tt>setstyle xyztheme.themed</tt>
54 <br><br>
55 Note that if you move the directory of the theme (for example, from
56 <tt>~/GNUstep/Library/WindowMaker/Themes</tt> to <tt>/usr/local/share/WindowMaker/Themes</tt>)
57 you will have to reload that theme so that path information is updated.
58 <br><br><br>
61 <h2>How To Make a Theme Pack</h2>
62 To create a theme pack from your current configuration, use the <tt>getstyle</tt>
63 utility with the <tt>-p</tt> flag. Example:
64 <br><br>
65 <tt>getstyle -p ~/GNUstep/Library/WindowMaker/Themes/MyTheme</tt>
66 <br><br>
67 This will create a theme pack (a new directory in either the current
68 directory or a directory you specify) named <tt>MyTheme.themed</tt>, containing
69 everything it requires, including all pixmap files. In this example,
70 the new theme pack would be made in your <tt>themes</tt> directory and be
71 immediately available in your "Themes" menu.
72 <br><br>
73 Additionally, you can put a text file named <tt>MyTheme.lsm</tt> in the <tt>MyTheme.themed</tt>
74 directory. This file can contain info like copyrights, credits or whatever.
75 <br><br>
76 To distribute your theme, just make a <tt>.tar.gz</tt> of the <tt>.themed</tt> directory.
77 This is preferably done from the same directory that you unpack the themes
78 from to maintain consistancy with the old theme format.
79 <br><br>
80 Example:
81 <br><br>
82 <tt>cd ~/GNUstep/Library/WindowMaker</tt><br>
83 <tt>tar cvf MyTheme.tar Themes/MyTheme.themed</tt><br>
84 <tt>gzip MyTheme.tar</tt>
85 <br><br><br>
88 <h2>How To Delete a Theme Pack</h2>
89 Just remove the <tt>.themed</tt> directory. Example:
90 <br><br>
91 <tt>cd ~/GNUstep/Library/WindowMaker/Themes</tt><br>
92 <tt>rm -fr themename.themed</tt>
93 <br><br><br>
96 <h2>How To Save Disk Space</h2>
97 If you have more than 1 theme that use the same huge background image,
98 you can delete all the duplicated files and then create hard links in
99 place of them. For example, if you have:
100 <br><br>
101 <tt>theme1.themed/back.jpg</tt>
102 <br><br>
103 <tt>theme2.themed/backimage.jpg</tt>
104 <br><br>
105 <tt>theme3.themed/back.jpg</tt>
106 <br><br>
107 and all three files contain the same image, you can do:
108 <br><br>
109 <tt>rm theme2.themed/backimage.jpg</tt><br>
110 <tt>rm theme3.themed/back.jpg</tt><br>
111 <tt>ln theme1.themed/back.jpg theme2.themed/backimage.jpg</tt><br>
112 <tt>ln theme1.themed/back.jpg theme3.themed/back.jpg</tt>
113 <p/>
114 <p/>
115 &nbsp;
117 </td>
118 </tr>
119 </table>
121 <?php include("footer.php"); ?>
123 </body>
124 </html>