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 theme directory,
  16 usually ~/GNUstep/Library/WindowMaker/Themes
  17
  18 cd ~/GNUstep/Library/WindowMaker/Themes
  19 gunzip -c xyztheme.tar.gz | tar xf -
  20
  21
  22 How To Load a Theme
  23 ===================
  24
  25 Use the setstyle command to load a theme. Example:
  26
  27 setstyle xyztheme.themed
  28
  29 Note that if you move the directory of the theme (for example, from
  30 ~/GNUstep/Library/WindowMaker/Themes to /usr/local/share/WindowMaker/Themes)
  31 you will have to reload that theme so that path information is updated.
  32
  33
  34 How To Make a Theme Pack
  35 ========================
  36
  37 To create a theme pack from your current configuration, use the getstyle
  38 utility with the -p flag. Example:
  39
  40 getstyle -p MyTheme
  41
  42 This will create a theme pack named MyTheme.themed, containing everything
  43 it requires, including all pixmap files.
  44
  45 Additionally, you can put a text file named MyTheme.lsm in the MyTheme.themed
  46 directory. This file can contain info like copyrights, credits or whatever.
  47
  48 To distribute your theme, just make a .tar.gz of the .themed directory.
  49
  50 Example:
  51
  52 tar cf MyTheme.tar MyTheme.themed
  53 gzip MyTheme.tar
  54
  55
  56 How To Delete a Theme Pack
  57 ==========================
  58
  59 Just remove the .themed directory. Example:
  60
  61 cd ~/GNUstep/Library/WindowMaker/Themes
  62 rm -fr themename.themed
  63
  64
  65 How To Save Disk Space
  66 ======================
  67
  68 If you have more than 1 theme that use the same huge background image,
  69 you can delete all the duplicated files and then create hard links in
  70 place of them. For example, if you have:
  71
  72 theme1.themed/back.jpg
  73
  74 theme2.themed/backimage.jpg
  75
  76 theme3.themed/back.jpg
  77
  78 and all three files contain the same image, you can do:
  79
  80 rm theme2.themed/backimage.jpg
  81 rm theme3.themed/back.jpg
  82 ln theme1.themed/back.jpg theme2.themed/backimage.jpg
  83 ln theme1.themed/back.jpg theme3.themed/back.jpg
  84
  85