From 32f3248b573cd3152a735a8b455f335720b2587b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ingo=20B=C3=BCrk?= Date: Sat, 21 Mar 2015 19:32:40 +0100 Subject: [PATCH] Added a troubleshooting section to the restoring layout docs and described solution for vertically split containers --- docs/layout-saving | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/layout-saving b/docs/layout-saving index 2b798df5..5897036e 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 + + ] +} +--------------------------------------------------------------------------------