diff --git a/src/content/docs/usage/windows.mdx b/src/content/docs/usage/windows.mdx index 37de0856..7dc9700a 100644 --- a/src/content/docs/usage/windows.mdx +++ b/src/content/docs/usage/windows.mdx @@ -34,7 +34,7 @@ The window at the largest tile can be focused using the command. -## Movement +## Movement on a Workspace Windows can be moved in the following ways. @@ -49,3 +49,40 @@ Windows can be moved in a cyclic direction using the command. This command is reversible. + +## Movement Across Workspaces + +The commands covering movement of windows across workspaces in komorebi come in two flavors: + +- `move` - these commands move the focused window to a target workspace and then focus the target workspace +- `send` - these commands move the focused window to a target workspace while remaining on the currently focused workspace + +### By Workspace Index + +The focused window can be moved or sent to a workspace on the focused monitor identified by an index using the and commands respectively. + +### Cycle Direction + +The focused window can be moved or sent to a workspace on the focused monitor in a cyclic direction using the and commands respectively. + +### By Monitor and Workspace Index + +The focused window can be moved or sent to a workspace on a specific monitor identified by monitor and workspace indicies using the and commands respectively. + +### By Name + +The focused window can be moved or sent to a workspace in a monitor-agnostic manner by name using the and commands respectively. + +### By Last Workspace + +The focused window can be moved or sent to a last focused workspace on the focused monitor using the and commands respectively. + +## Movement Across Monitors + +### By Monitor Index + +The focused window can be moved or sent the focused workspace at a monitor identified by index using the and commands respectively. + +### Cycle Direction + +The focused window can be moved or sent to the focused workspace of a monitor in a cyclic direction using the and commands respectively. diff --git a/src/content/docs/usage/workspaces.mdx b/src/content/docs/usage/workspaces.mdx index cc6aa16c..9d792e9a 100644 --- a/src/content/docs/usage/workspaces.mdx +++ b/src/content/docs/usage/workspaces.mdx @@ -3,4 +3,42 @@ title: Workspaces description: Configuring workspaces --- -TODO +import PlatformLink from '../../../components/PlatformLink.astro'; +import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'; + + + + + + + + + + +## Focus + +Workspaces can be focused in the following ways. + +### By Index + +Workspaces can be focused by index on the focused monitor using the command, or by a mixture of monitor index and workspace index using the command. + +### By Name + +Workspaces can be focused in a monitor-agnostic manner by name using the command. All of your workspaces should have unique names. If two workspaces have the same name, the first match in the window manager state will be focused. + +### By Last Workspace + +The last focused workspace on the focused monitor can be focused using the command. + +### Across Multiple Monitors + +Workspaces can be focused by index across all monitors using the command. This will focus the same workspace index on all monitors simultaneously, giving the feeling of a workspaces which span all monitors. + +## Movement + +Workspaces can be moved to other monitors in the following ways. + +### By Focus and Index + +The focused workspace can be moved to a monitor identified by an index using the command.