Gabriel Brown
202b5b89ac
docs/ is engineering artifacts -- design specs, plans, an upstream ledger -- and none of it is written for the person who has to live here. Five chapters that are: coming from another desktop, the keyboard, windows and workspaces, when something breaks, and making it yours. Rendered inside Settings rather than opened in a browser, so a chapter that says "the Displays page reverts after fifteen seconds" is one click from the Displays page. Qt's markdown renderer does the work; one chapter per Text, because Text has an implicit texture size limit and a document long enough to hit it goes blank rather than complaining. The chapters live beside the shell in manual/ rather than at the repository root, which departs from the plan. The reason is the path: the shell finds them through Quickshell.shellDir, which is correct wherever the repository is, whereas walking upward out of the shell directory is only correct by accident. The contract fails that pattern if it comes back. The contract also pins the set both ways -- every chapter listed exists, every chapter that exists is listed -- because a renamed file shows an error card where a chapter should be, which reads as a broken manual rather than as a moved file.
49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
# Windows and workspaces
|
|
|
|
## How the split is chosen
|
|
|
|
A new window splits the space of the window that had focus. Whether it splits
|
|
beside or below depends on which way that space is longer, which usually
|
|
matches what you were about to do anyway.
|
|
|
|
When it does not, `Super + Ctrl + G` flips the split of the focused window,
|
|
and `Super + Ctrl + Z` and `Super + Ctrl + V` decide the direction the *next*
|
|
window will take before you open it.
|
|
|
|
## Resizing
|
|
|
|
`Super + Shift` plus `Y`, `O`, `B`, `M` adjusts width; `I`, `U`, `N` and
|
|
comma adjust height. These are inverted from what their letters suggest, on
|
|
purpose, and the reason is written in `config/dot/hypr/keybinds.lua` next to
|
|
the binds.
|
|
|
|
For anything finer, hold `Super` and drag with the right mouse button.
|
|
|
|
## Fullscreen and floating
|
|
|
|
`Super + U` makes the focused window fullscreen. `Super + Ctrl + C` lifts it
|
|
out of the layout to float, and `Super + Ctrl + Shift + C` pins it so it
|
|
follows you between workspaces. A floating window can be moved by holding
|
|
`Super` and dragging with the left button.
|
|
|
|
## Workspaces
|
|
|
|
Ten of them, on `Alt + 1` through `Alt + 0`. `Alt + H` and `Alt + L` step
|
|
between neighbours, and `Alt + Shift` plus a number sends the current window
|
|
somewhere without following it.
|
|
|
|
On a machine with more than one display, workspaces belong to whichever
|
|
screen has focus. If you would rather pin workspaces one through ten to your
|
|
main display and give the second screen its own, that is a switch on the
|
|
Desktop settings page.
|
|
|
|
## Projects
|
|
|
|
A project is the set of windows you open together: which applications, which
|
|
workspace each was on, and for a terminal, which directory it was in.
|
|
|
|
Arrange things the way you want them, then run **Save Layout as Project**
|
|
from the launcher. **Open Project** lays it out again on free workspaces, so
|
|
it never lands on top of what you are already doing. An application that
|
|
refuses to open twice is moved into place rather than launched again.
|