Subtle

Version 117 (Christoph Kappel, 2011-05-09 14:00)

1 94 Christoph Kappel
h1. What is subtle?
2 1

                
3 70 Christoph Kappel
[[subtle]] is a +manual+ tiling window manager with a rather uncommon approach of tiling: Per default there is no typical layout enforcement, windows are placed on a position ([[gravity]]) in a custom grid. The user can change the [[gravity]] of each window either directly per [[grabs]] or with rules defined by [[tagging|tags]] in the [[config]].
4 53 Christoph Kappel

                
5 1
Windows are visible on views - the virtual desktops in [[subtle]] - that have at least one [[tagging|tag]] in common.
6 70 Christoph Kappel

                
7 115 Christoph Kappel
{{column(:start, width: 40%; vertical-align: top)}}
8 112 Christoph Kappel

                
9 94 Christoph Kappel
h2. Features
10 1

                
11 1
* Builtin system tray
12 1
* Extendable [[Panel|panel]] (see [[sublets]])
13 1
* Customizeable key/mouse actions (see [[Grabs|grabs]])
14 97 Christoph Kappel
* Scriptable with "Ruby":http://www.ruby-lang.org (see "rdoc":http://rdoc.subforge.org and [[subtlext]])
15 1
* Commandline client (see [[subtler]])
16 1
* Window [[tagging]]
17 110 Christoph Kappel
* "EWMH":http://standards.freedesktop.org/wm-spec/wm-spec-1.3.html / "ICCCM":http://tronche.com/gui/x/icccm/ / "MWM":http://www.ist.co.uk/motif/books/vol6A/ch-20.fm.html /  "XDG Base Directory":http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html compliant
18 104 Christoph Kappel
* "Xinerama":http://en.wikipedia.org/wiki/Xinerama / "XRandR":http://www.x.org/wiki/Projects/XRandR support
19 112 Christoph Kappel

                
20 115 Christoph Kappel
{{column(:mid, width: 60%; background: url(/images/subtlebw.png) right center no-repeat)}}
21 112 Christoph Kappel

                
22 112 Christoph Kappel
{{column(:end)}}
23 93 Christoph Kappel

                
24 94 Christoph Kappel
h2. Where to start?
25 94 Christoph Kappel

                
26 94 Christoph Kappel
{{column(:start)}}
27 94 Christoph Kappel

                
28 102 Christoph Kappel
* *Basics*
29 94 Christoph Kappel
* [[Install|Installing subtle]]
30 94 Christoph Kappel
* [[Usage|Using subtle]]
31 1
* [[Sublets|Using sublets]]
32 104 Christoph Kappel
* [[Multihead|Using multihead]]
33 94 Christoph Kappel
* [[Themes]]
34 94 Christoph Kappel

                
35 94 Christoph Kappel
{{column(:mid)}}
36 94 Christoph Kappel

                
37 102 Christoph Kappel
* *In depth*
38 94 Christoph Kappel
* [[Tagging|Understanding tagging]]
39 1
* [[Gravity|Understanding gravity]]
40 110 Christoph Kappel
* [[Styles|Understanding styles]]
41 94 Christoph Kappel
* [[Panel|Customizing panel]]
42 94 Christoph Kappel
* [[Grabs|Configuring keys]]
43 94 Christoph Kappel
* [[Hooks|Hooking events]]
44 94 Christoph Kappel

                
45 94 Christoph Kappel
{{column(:mid)}}
46 94 Christoph Kappel

                
47 102 Christoph Kappel
* *Hacking*
48 106 Christoph Kappel
* [[Hacking|Hacking subtle]]
49 94 Christoph Kappel
* [[Writing_sublets|Writing sublets]]
50 94 Christoph Kappel
* [[Scripting]]
51 94 Christoph Kappel
* [[Snippets]]
52 1
* [[Blamelist]]
53 108 Christoph Kappel

                
54 108 Christoph Kappel
{{column(:mid)}}
55 108 Christoph Kappel

                
56 108 Christoph Kappel
* *Problems*
57 108 Christoph Kappel
* "Frequently asked..":http://subforge.org/ezfaq/index/subtle
58 108 Christoph Kappel
* [[bugs|Reporting a bug]]
59 94 Christoph Kappel

                
60 94 Christoph Kappel
{{column(:end)}}
61 94 Christoph Kappel

                
62 94 Christoph Kappel
h2. Contribute
63 1

                
64 96 Christoph Kappel
In case you want to help but don't know how, please help with some documentation and improve the wiki or make a donation. Patches, suggestions and open discussions are always welcome.
65 72 Christoph Kappel

                
66 115 Christoph Kappel
{{column(:start, width: 40%; vertical-align: top)}}
67 111 Christoph Kappel

                
68 72 Christoph Kappel
Unfinished pages:
69 72 Christoph Kappel

                
70 72 Christoph Kappel
* [[Usage]]
71 81 Christoph Kappel
* [[Sublets]]
72 78 Christoph Kappel
* [[Tagging]]
73 1
* [[Gravity]]
74 92 Christoph Kappel
* [[Scripting]]
75 105 Christoph Kappel
* [[Multihead]]
76 111 Christoph Kappel

                
77 116 Christoph Kappel
{{column(:mid)}}
78 111 Christoph Kappel

                
79 1
{{pledgie}}
80 116 Christoph Kappel

                
81 111 Christoph Kappel
{{column(:end)}}
82 93 Christoph Kappel

                
83 94 Christoph Kappel
h2. Problems?
84 1

                
85 93 Christoph Kappel
* Join *#subtle* on *irc.freenode.org* (IRC)
86 94 Christoph Kappel
* Use the "bugtracker":http://subforge.org/projects/subtle/issues
87 94 Christoph Kappel
* Ask in the "forum":http://subforge.org/projects/subtle/boards
88 92 Christoph Kappel
* Drop a mail to _unexist_ at _dorfelite_ dot _net_
89 93 Christoph Kappel

                
90 109 Christoph Kappel

                
91 109 Christoph Kappel
h2. License
92 109 Christoph Kappel

                
93 109 Christoph Kappel
This code can be distributed under the terms of the GNU GPLv2. See the file COPYING for details.
94 109 Christoph Kappel

                
95 94 Christoph Kappel
h2. Read more
96 93 Christoph Kappel

                
97 94 Christoph Kappel
"Ohloh":https://www.ohloh.net/p/subtle, "Rubyforge":http://rubyforge.org/projects/subtle/, "Freshmeat":http://freshmeat.net/projects/subtle, "Sourceforge":http://sourceforge.net/projects/subtle-wm/, "Archlinux Wiki":http://wiki.archlinux.org, "Archlinux Forum":http://bbs.archlinux.org/viewtopic.php?id=71783, "Gentoo Forum":http://forums.gentoo.org/viewtopic-t-825036.html