WindowMaker/README.themes

   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