X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=_docs%2Flayout-saving;fp=_docs%2Flayout-saving;h=5897036e5143f310e2b665e68db6174f7318198b;hb=5b1627c96e075e04c89ac9f271e58f0df9cc88d4;hp=2b798df5ac645dc25cda0f282ff2c000ccb54a06;hpb=7b492b3e98dcbee79808d2c04d4f015990bbc0e1;p=i3%2Fi3.github.io

diff --git a/_docs/layout-saving b/_docs/layout-saving
index 2b798df..5897036 100644
--- a/_docs/layout-saving
+++ b/_docs/layout-saving
@@ -231,3 +231,31 @@ layouts, you can either use a JSON parser that supports these deviations (for
 example libyajl), transform the layout file to a JSON-conforming file, or
 link:http://cr.i3wm.org/[submit a patch] to make +i3-save-tree(1)+ optionally
 output standard-conforming JSON.
+
+== Troubleshooting
+
+=== Restoring a vertically split workspace
+
+When using +i3-save-tree+ with the +--workspace+ switch, only the *contents* of
+the workspace will be dumped. This means that properties of the workspace
+itself will be lost.
+
+This is relevant for, e.g., a vertically split container as the base container of
+a workspace. Since the split mode is a property of the workspace, it will not be
+stored. In this case, you will have to manually wrap your layout in such a
+container:
+
+--------------------------------------------------------------------------------
+// vim:ts=4:sw=4:et
+{
+    // this is a manually added container to restore the vertical split
+    "layout": "splitv",
+    "percent": 0.5,
+    "type": "con",
+    "nodes": [
+
+        // the dumped workspace layout goes here
+
+    ]
+}
+--------------------------------------------------------------------------------