update docs for 4.14

[i3/i3.github.io] / docs / layout-saving.html
diff --git a/docs/layout-saving.html b/docs/layout-saving.html

index e35ce5e7fdc74bdea36ddd92777d1c2dcf856fc2..d699715cab1a1064e5598e3e3fc2d388034e3196 100644 (file)
--- a/docs/layout-saving.html
+++ b/docs/layout-saving.html
@@ -2,7 +2,7 @@
      "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
  <head>\r
-<link rel="icon" type="image/png" href="/favicon.png">\r
+<link rel="icon" type="image/x-icon" href="/favicon.ico">\r
  <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
  <meta name="generator" content="AsciiDoc 8.6.9" />\r
  <title>i3: Layout saving in i3</title>\r
@@ -22,8 +22,9 @@ document.addEventListener("DOMContentLoaded", function(){asciidoc.footnotes(); a
                          <ul id="nav">\r
                                  <li><a style="border-bottom: 2px solid #fff" href="/docs">Docs</a></li>\r
                                  <li><a href="/screenshots">Screens</a></li>\r
+                                <li><a href="https://www.reddit.com/r/i3wm/">FAQ</a></li>\r
                                  <li><a href="/contact">Contact</a></li>\r
-                                <li><a href="http://bugs.i3wm.org/">Bugs</a></li>\r
+                                <li><a href="https://github.com/i3/i3/issues">Bugs</a></li>\r
                          </ul>\r
          <br style="clear: both">\r
  <div id="content">\r
@@ -272,6 +273,59 @@ output standard-conforming JSON.</p></div>
  </div>\r
  </div>\r
  </div>\r
+<div class="sect1">\r
+<h2 id="_troubleshooting">4. Troubleshooting</h2>\r
+<div class="sectionbody">\r
+<div class="sect2">\r
+<h3 id="_restoring_a_vertically_split_workspace">4.1. Restoring a vertically split workspace</h3>\r
+<div class="paragraph"><p>When using <tt>i3-save-tree</tt> with the <tt>--workspace</tt> switch, only the <strong>contents</strong> of\r
+the workspace will be dumped. This means that properties of the workspace\r
+itself will be lost.</p></div>\r
+<div class="paragraph"><p>This is relevant for, e.g., a vertically split container as the base container of\r
+a workspace. Since the split mode is a property of the workspace, it will not be\r
+stored. In this case, you will have to manually wrap your layout in such a\r
+container:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>// vim:ts=4:sw=4:et\r
+{\r
+    // this is a manually added container to restore the vertical split\r
+    "layout": "splitv",\r
+    "percent": 0.5,\r
+    "type": "con",\r
+    "nodes": [\r
+\r
+        // the dumped workspace layout goes here\r
+\r
+    ]\r
+}</tt></pre>\r
+</div></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_placeholders_using_window_title_matches_don_8217_t_swallow_the_window">4.2. Placeholders using window title matches don&#8217;t swallow the window</h3>\r
+<div class="paragraph"><p>If you use the <tt>title</tt> attribute to match a window and find that it doesn&#8217;t\r
+work or only works sometimes, the reason might be that the application sets the\r
+title only after making the window visible. This will be especially true for\r
+programs running inside terminal emulators, e.g., <tt>urxvt -e irssi</tt> when\r
+matching on <tt>title: "irssi"</tt>.</p></div>\r
+<div class="paragraph"><p>One way to deal with this is to not rely on the title, but instead use, e.g.,\r
+the <tt>instance</tt> attribute and running the program to set this window instance to\r
+that value:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt># Run irssi via\r
+# urxvt -name "irssi-container" -e irssi\r
+\r
+"swallows": [\r
+    {\r
+        "class": "URxvt",\r
+        "instance": "irssi-container"\r
+    }\r
+]</tt></pre>\r
+</div></div>\r
+</div>\r
+</div>\r
+</div>\r
  </div>\r
  <div id="footnotes"><hr /></div>\r
  <div id="footer" lang="de">\r