unexist.dev

h1. Tags\015\012\015\012[[Tags]] are generally used in [[subtle]] for placement of windows. This placement is *strict*, that means that  - aside from other tiling window managers - windows _must have_ a matching [[Tags|tag]] to be on a certain [[Views|view]]. This also includes that windows that are started on a certain view will not automatically be placed there.\015\012\015\012There are to ways to define a [[Tags|tag]] in the [[config]]:\015\012* with a "string":http://www.ruby-doc.org/core/classes/String.html\015\012<pre><code class="ruby">\015\012"tag" => "xterm"\015\012</code></pre>\015\012* with a "hash":http://www.ruby-doc.org/core/classes/Hash.html of properties\015\012<pre><code class="ruby">\015\012"tag" => { :regex => "xterm|[u]?rxvt", :gravity => 5 }\015\012</code></pre>\015\012\015\012h2. Default\015\012\015\012Whenever a window has no [[Tags|tag]] it will get the +default+ [[Tags|tag]] and be placed on the default [[Views|view]]. The +default+ [[Views|view]] can either be set by the user with adding the +default+ [[Tags|tag]] to a [[Views|view]] by choice or otherwise the first defined view will be chosen automatically.\015\012\015\012Example:\015\012\015\012<pre><code class="ruby">\015\012 VIEWS = [\015\012  { "terms" => "terms" },\015\012  { "www"   => "default|browser" },\015\012  { "dev"   => "editor" }\015\012]\015\012</code></pre>\015\012\015\012h2. Properties\015\012\015\012Additionally [[tags]] can do a lot more then just control the placement - they also have properties than can define and control some aspects of a window like the default gravity or the default screen per view.\015\012\015\012h3. float\015\012\015\012This property either sets the tagged [[Clients|client]] floating or prevents it from being floating depending on the value.\015\012<pre><code class="ruby">\015\012"float"   => { :regex => "xterm", :float => true }\015\012"nofloat" => { :regex => "xterm", :float => false }\015\012</code></pre>\015\012\015\012h3. full\015\012\015\012This property either sets the tagged [[Clients|client]] to fullscreen or prevents it from being set to fullscreen depending on the value.\015\012<pre><code class="ruby">\015\012"full"   => { :regex => "xterm", :full => true }\015\012"nofull" => { :regex => "xterm", :full => false }\015\012</code></pre>\015\012\015\012h3. gravity\015\012\015\012This property sets a certain to [[gravity]] to the tagged [[Clients|client]], but +only+ [[views]] that have this tag too.\015\012<pre><code class="ruby">\015\012"gravity" => { :regex => "xterm", :gravity => 8 }\015\012</code></pre>\015\012\015\012h3. match\015\012\015\012This property influcences the matching of [[tags]], per default [[tags]] will only match the "WM_NAME":http://standards.freedesktop.org/wm-spec/1.3/ar01s05.html and the "WM_CLASS":http://standards.freedesktop.org/wm-spec/1.3/ar01s05.html portion of a [[Clients|client]]. \015\012\015\012Match expects an "array":http://www.ruby-doc.org/core/classes/Array.html with following possible values:\015\012* :title - match the title which is also visible in the [[panel]]\015\012* :name - match the {{color(#ff0000, WM_NAME)}}\015\012* :class - match the {{color(#0000ff, WM_CLASS)}}\015\012\015\012There are several ways to get these values, here are the most common:\015\012\015\012* "xprop":http://www.xfree86.org/current/xprop.1.html: Just select the window and have a look for the "WM_CLASS":http://standards.freedesktop.org/wm-spec/1.3/ar01s05.html line which usually look like this:\015\012\015\012p{class:pre}. WM_CLASS(STRING) = "{{color(#ff0000, urxvt)}}", "{{color(#0000ff, URxvt)}}")\015\012\015\012* [[subtler]]: Run *[[subtler]] -cl* and look for the matching line:\015\012\015\012p{class:pre}. 0x800007 * 1 1020x374 2 1 --- {{color(#ff0000, urxvt)}} ({{color(#0000ff,URxvt)}})\015\012\015\012<pre><code class="ruby">\015\012"match"   => { :regex => "xterm", :match => [ :title, :class ] }\015\012</code></pre>\015\012\015\012h3. regex\015\012\015\012h3. screen\015\012\015\012h3. size\015\012\015\012h3. stick\015\012\015\012h3. urgent\015\012\015\012{{tocnavi(subtle,Grabs,Quickstart,Gravity)}}