From dc93f1c1fd7b67e2da5af2ffada732b9ddeb2d6a Mon Sep 17 00:00:00 2001 From: Kent Daleng Date: Sun, 17 Aug 2025 16:05:41 +0200 Subject: github wiki replacement / mkdocs-docs (#2147) * Add wiki based on mkdocs * wording fixes * fix github bg color on narrow * Fix left sidebar section headers being bigger than pages * fix hover accent * fix list rendering on fractional layout * fix videos * fix automatic full links * remove redundant commented css * improve dark mode contrast * update pygments for better child node coloring * update logo * remove blank lines * add systemd language hint --------- Co-authored-by: Ivan Molodetskikh --- docs/wiki/Tabs.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/wiki/Tabs.md (limited to 'docs/wiki/Tabs.md') diff --git a/docs/wiki/Tabs.md b/docs/wiki/Tabs.md new file mode 100644 index 00000000..1ef438b7 --- /dev/null +++ b/docs/wiki/Tabs.md @@ -0,0 +1,35 @@ +### Overview + +Since: 25.02 + +You can switch a column to present windows as tabs, rather than as vertical tiles. +All tabs in a column have the same window size, so this is useful to get more vertical space. + +![Terminal with a tab indicator on the left.](https://github.com/user-attachments/assets/0e94ac0d-796d-4f85-a264-c105ef41c13f) + +Use this bind to toggle a column between normal and tabbed display: + +```kdl +binds { + Mod+W { toggle-column-tabbed-display; } +} +``` + +All other binds remain the same: switch tabs with `focus-window-down/up`, add or remove windows with `consume-window-into-column`/`expel-window-from-column`, and so on. + +Unlike regular columns, tabbed columns can go full-screen with multiple windows. + +### Tab indicator + +Tabbed columns show a tab indicator on the side. +You can click on the indicator to switch tabs. + +See the [`tab-indicator` section in the layout section](./Configuration:-Layout.md#tab-indicator) to configure it. + +By default, the indicator draws "outside" the column, so it can overlay other windows or go off-screen. +The `place-within-column` flag puts the indicator "inside" the column, adjusting the window size to make space for it. +This is especially useful for thicker tab indicators, or when you have very small gaps. + +| Default | `place-within-column` | +| --- | --- | +| ![A screenshot showing 4 windows, with the middle column being focused. The tab indicator overflows onto the left column](https://github.com/user-attachments/assets/c2f51f50-3d87-403a-8beb-cbbe5ec5c880) | ![A screenshot showing 4 windows, with the middle column being focused. The tab indicator is contained within its respective column](https://github.com/user-attachments/assets/f1797cd0-d518-4be6-95b4-3540523c4370) | -- cgit