From 1d6bea7f2260e03a08ee3f2c832ff4ead5827d32 Mon Sep 17 00:00:00 2001
From: toofar <toofar@spalge.com>
Date: Sun, 31 Dec 2023 14:12:53 +1300
Subject: [PATCH] Add initial treetab docs.

TODO:
* convert to asciidoc or make scripts/asciidoc2html.py support markdown
  input too.
  * for now I'm using `pandoc -f markdown -t html -o qutebrowser/html/doc/treetabs.html doc/treetabs.md`
  * should be able to asciidoc with pandoc too
* the last section and the rest of the second to last
* review and refactor
* post on the PR and figure out how we can contribute to it collectively
  (put on main branch so people can open PRs? create new integration
  repo where people can open issues, discussions and PRs?)
* maybe add more examples showing the effect of various operations
* (when including in a release) consider removing the implementation
  section, or refactoring it to be more high level broad strokes and
  less low level stuff that will inevitably drift from the actual
  implementation

These docs are not supposed to be in their final state. My plan for them
so far is to provide a guide to the changes for PR contributors. I think
it's currently difficult to hold the scope of the changes in your head
the description on the PR is currently very limited.

I would like to encourage discussion of usability and feature set as
well as highlighting some implementation details to point out upsides,
downsides, implications and alternatives.

I've modified asciidoc2html to copy all images over. It was only doing
specific ones before. But there are more images in there, why are they
in doc/img if they aren't images used in the documentation? Anyway,
storage is cheap, none of the images are sensitive and not having to
hardcode individual files names is good.
---
 doc/img/treetabs/tree_tabs_new_tab_types.png  | Bin 0 -> 4869 bytes
 .../treetabs/tree_tabs_overview_detail.png    | Bin 0 -> 11259 bytes
 doc/treetabs.md                               | 212 ++++++++++++++++++
 scripts/asciidoc2html.py                      |  10 +-
 4 files changed, 217 insertions(+), 5 deletions(-)
 create mode 100644 doc/img/treetabs/tree_tabs_new_tab_types.png
 create mode 100644 doc/img/treetabs/tree_tabs_overview_detail.png
 create mode 100644 doc/treetabs.md

diff --git a/doc/img/treetabs/tree_tabs_new_tab_types.png b/doc/img/treetabs/tree_tabs_new_tab_types.png
new file mode 100644
index 0000000000000000000000000000000000000000..fdca0e01d4ceeca5e56f342e154ceb7a1a613736
GIT binary patch
literal 4869
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
V-kOv7-}hROzP7Pev4%s~{{Z{UP0|1W

literal 0
HcmV?d00001

diff --git a/doc/img/treetabs/tree_tabs_overview_detail.png b/doc/img/treetabs/tree_tabs_overview_detail.png
new file mode 100644
index 0000000000000000000000000000000000000000..fc5610ecf8c7de8a41f3f8024efe499c663ec5a1
GIT binary patch
literal 11259
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

literal 0
HcmV?d00001

diff --git a/doc/treetabs.md b/doc/treetabs.md
new file mode 100644
index 00000000000..7b14962015f
--- /dev/null
+++ b/doc/treetabs.md
@@ -0,0 +1,212 @@
+# Tree Style Tabs
+
+## Intro
+
+Tree style tabs allow you to group and manage related tabs together. Related
+tabs will be shown in a hierarchical fashion in the tab bar when it is on the
+left or right side of the browser window. It can be enabled by setting
+`tabs.tree_tabs` to `true`. That setting only applies to new windows create
+after it is enabled (including via saving and loading a session or
+`:restart`).
+
+![](img/treetabs/tree_tabs_overview_detail.png)
+
+When a tab is being opened it will be classified as one of *unrelated*
+(default), *sibling* or *related* to the current tab.
+
+![](img/treetabs/tree_tabs_new_tab_types.png)
+
+* *unrelated* tabs are created at the top level of the tree for the current
+  browser window. They can be created by opening a new tab using `:open -t`.
+* *sibling* tabs are created at the same level as the current tab. They can be
+  created by running `:open -t -S`.
+* *related* tabs are created as children of the current tab. They can be
+  created by following a link in a new tab (middle click, `F` hinting mode) or
+  by running `:open -t -r`.
+
+## Enabling Tree Tabs
+
+TODO: more words here
+
+* `tabs.tree_tabs`
+* check default settings: title format, padding, elide
+* steps to take when downgrading if you don't want to lose settings
+
+## Manipulating the Tree
+
+todo: add animated illustrations?
+
+You can change how tabs relate to each other after they are created too.
+
+* `:open`, as described in the into, has picked up some new behaviour to
+  decide where in relation to the current tab a new one should go. It has a
+  new `--sibling` argument and the `--related` argument, as well as `--tab` and
+  `-background`, has some additional meaning.
+* `:tab-move` will move a tab and its children within the tree
+    * With a `+` or `-` argument tabs will only move within their siblings
+      (wrapping at the top or bottom)
+    * With a count or integer argument tabs will move to the absolute position
+      specified, which may include changing level in the hierarchy.
+* Tabs can be moved up and down a hierarchy with the commands
+  `:tree-tab-promote` and `:tree-tab-demote`
+* `:tab-give --recursive` will move a tab and its children to another window.
+  They will be placed at the top level.
+* Some methods of moving tabs do *not* yet understand tab groups, these are:
+    * `:tab-take`
+    * moving tabs with a mouse or other pointer
+
+Other pre-existing commands that understand tab groups are:
+
+* `:tab-close --recursive` will close a tab and all its children. If
+  `:tab-close` is used without `--recursive` the first of a tabs children will
+  be promoted in its place.
+* `:tab-focus parent` will switch focus to a tab's parent, so that you don't
+  have to cycle through a tab's siblings to get there.
+* `:tab-next --sibling` and `:tab-prev --sibling` will switch the focus to a
+  tab's sibling, skipping any child tabs.
+
+## Working with Tab Groups
+
+Beyond the commands above for manipulating the tree, there are a few new
+commands introduced to take advantage of the tab grouping feature.
+
+* `:tree-tab-create-group {name}` will create a new placeholder tab with a
+  title of `{name}`. This is a light weight way of creating a "named group" by
+  putting a tab with a meaningful title at the top level of it. It can
+  create tabs at the top level of the window or under the current tab with the
+  `--related` argument. The placeholder tab contains an ascii art picture of a
+  tree. The title of the tab comes from the URL path.
+* `:tree-tab-toggle-hide` will collapse, or reveal, a tab group, which will
+  hide any children tabs from the hierarchy shown in the tab bar as well as
+  making children unelectable via `:tab-focus`, `tab-select` and `:tab-take`.
+  The tabs will still be running in the background.
+* `:tree-tab-cycle-hide` will hide successive levels of a tab's hierarchy of
+  children. For example, the first time you run it will hide the outermost
+  generation of leaf nodes, the next time will hide the next level up and so
+  on.
+* `:tree-tab-suspend-children` will suspend all of the children of a tab via
+  the lazy load mechanism (`qute://back/`). Tabs will be un-suspended when
+  they are next focused. This apply for any children which are hidden too.
+
+## Settings
+
+There are some existing settings who's behaviour will be modified when tree
+tabs are enabled:
+
+* `tabs.new_position.related`: this is essentially replaced by
+  `tabs.new_position.new_child`
+* `tabs.new_position.unrelated`: this is essentially replaced by
+  `tabs.new_position.new_toplevel`
+* the settings `tabs.title.format`, `tabs.title.format_pinned` and
+  `window.title_format` have gained two new template variables: `{tree}` and
+  `{collapsed}`. These are for displaying the tree structure in the tab bar and
+  the default value for `tabs.title.format` now has `{tree}{collapsed}` at the
+  start of it.
+
+There are a few new settings introduced to control where tabs are places in
+the tree structure as a result of various operations. All of these settings
+accept the options `first`, `last`, `next` or `prev`; apart from `new_child`
+and `demote` which only accept `first` or `last`.
+
+* `tabs.new_position.promote`
+* `tabs.new_position.demote`
+* `tabs.new_position.new_toplevel`
+* `tabs.new_position.new_sibling`
+* `tabs.new_position.new_child`
+
+## Bindings
+
+There are various new default bindings introduced to make accessing the new
+and changed commands easy. They all start with the letter `z`:
+
+TODO: more words here? Are any of these bindings analogous to existing
+ones? Any theme to them?
+
+* `zH`: `tree-tab-promote`
+* `zL`: `tree-tab-demote`
+* `zK`: `tab-prev -s` - cycle tab focus upwards among siblings
+* `zJ`: `tab-next -s` - cycle tab focus downwards among siblings
+* `zd`: `tab-close -r` - r = recursive
+* `zg`: `set-cmd-text -s :tree-tab-create-group -r` - r = related
+* `zG`: `set-cmd-text -s :tree-tab-create-group`
+* `za`: `tree-tab-toggle-hide` - same binding as vim folds
+* `zp`: `tab-focus parent`
+* `zo`: `set-cmd-text --space :open -tr` - r = related
+* `zO`: `set-cmd-text --space :open -tS` - S = sibling
+
+## Implementation
+
+The core tree data structure is in `qutebrowser/misc/notree.py`, inspired by
+the `anytree` python library. It defines a `Node` type. A Node can have a
+parent, a list of child nodes, and `value` attribute - which in qutebrowser's
+case is always a browser tab. A tree of nodes is always modified by changing
+either the parent or children of a node via property setters. Beyond those two
+setters nodes have `promote()` and `demote()` helper functions used by the
+corresponding commands.
+
+Beyond those four methods to manipulate tree the tree structures nodes have
+methods for:
+
+* traversing the tree:
+  * `traverse()` return all descendant nodes (including self)
+  * `path()` return all nodes from self up to the tree root, inclusive
+  * `depth()` return depth in tree
+* collapsing a node
+  * this just sets an attribute on a node, the traversal function respects it
+  * but beyond that it's up to callers to know that an un-collapsed node may
+    be hidden if a parent node is collapsed, there are a few pieces of
+    calling code which do implement different behaviour for collapsed nodes
+* rendering unicode tree segments to be used in tab titles
+  * our tab bar itself doesn't understand the tree structure for now, it's
+    just being represented by drawing unicode line and angle characters to
+    the left of the tab titles which happen to line up
+  * this does generally put some restrictions on some tab bar related
+    settings. `tabs.title.format` needs to have `{tree}{collapsed}` in it,
+    `tabs.padding` needs to have 0 for the top and bottom padding,
+    `tabs.title.elide` can't be on the same side as the tree related format strings.
+
+Beyond the core data structure most of the changes are in places where tabs
+need to relate to each other. There are two new subclasses of existing core
+classes:
+
+*TreeTabbedBrowser* inherits the main TabbedBrowser and has overriden methods
+to make sure tabs are correctly positioned when opening a tab, closing a tab
+and undoing a tab close. After tabs are opened they are placed into the
+correct position in the tree based on the new `tabs.new_position.*` settings
+and then into order in the tab widget corresponding to the tree traversal
+order. When tabs are closed the new `--recursive` flag is handled, children
+are re-parented in the tree and extra details are added to undo entries. When
+a tab close is undone its position in the tree is restored, including demoting
+any child that was promoted when the tab was closed. TreeTabbedBrowsers will
+be created by MainWindow when the new `tabs.tree_tabs` setting is set.
+
+*TreeTabWidget* handles making sure the new `{tree}` and `{collapsed}` are
+filled in for the tab title template string, with a lot of help from the data
+structure. It also handles hiding or showing tabs for collapsed
+groups/branches. Hidden tabs are children of tabs with the `collapsed`
+property set, they remain in the tree structure (which is held by the tabbed
+browser) but they are removed entirely from the tab widget. It also handles
+making sure tabs are moved to indexes corresponding to their traversal order
+in the tree if any changes to the tree structure happen via the
+`tree_tab_update()` method that is called from several places.
+
+A fair amount of tree tab specific code lives in *commands.py*. The six new
+commands have been added, as well as a customization so that these commands
+don't show up in the command completion if the tree tabs feature isn't
+enabled. The commands for manipulating the tree structure do very little but
+call out to other pieces of code, either the browser or the tree structure.
+Of note are the two commands `tree_tab_create_group()` and
+`tree_tab_suspend_children()` which use the scheme handlers `qute://treegroup`
+(new) and `qute://back` (existing).
+
+Beyond those six new commands quite a few existing commands to do with
+manipulating tabs have seen some tree tab specific code paths added, some of
+them quite complex and with little shared with the existing code paths. Common
+themes beyond handling new arguments are dealing with recursive operations and
+collapsed nodes.
+
+something something sessions.py
+
+Other stuff, like tree group page
+
+## Outstanding issues? Questions?
diff --git a/scripts/asciidoc2html.py b/scripts/asciidoc2html.py
index 09405c3e75a..81c63032f36 100755
--- a/scripts/asciidoc2html.py
+++ b/scripts/asciidoc2html.py
@@ -109,11 +109,11 @@ def _copy_images(self) -> None:
         """Copy image files to qutebrowser/html/doc."""
         print("Copying files...")
         dst_path = DOC_DIR / 'img'
-        dst_path.mkdir(exist_ok=True)
-        for filename in ['cheatsheet-big.png', 'cheatsheet-small.png']:
-            src = REPO_ROOT / 'doc' / 'img' / filename
-            dst = dst_path / filename
-            shutil.copy(src, dst)
+        try:
+            shutil.rmtree(dst_path)
+        except FileNotFoundError:
+            pass
+        shutil.copytree(REPO_ROOT / 'doc' / 'img', dst_path)
 
     def _build_website_file(self, root: pathlib.Path, filename: str) -> None:
         """Build a single website file."""