binds: Improve docs for workspace key binds on non-qwerty keyboards. (#824)

Explain why the defaults for the workspaces do not work on a french azerty keyboard, and how to fix it.

Fixes  #810
This commit is contained in:
Aaron Randreth 2024-10-25 00:48:14 +02:00 committed by GitHub
parent 887fe11492
commit 575c48b163
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -53,6 +53,26 @@ can also use `xev` or `wev` to find keycodes.
## Misc ## Misc
### Workspace bindings on non-qwerty layouts
Keys used for keybinds need to be accessible without any modifiers in your layout. For instance, the `French Azerty` layout uses `SHIFT+unmodified_key` to write `0-9` numbers. As such, the workspace keybinds for this layout need to use the names of the `unmodified_key`s, and will not work when using the `0-9` numbers.
{{< callout type=info >}}
To get the correct name for an `unmodified_key`, refer to [the section on uncommon syms](#uncommon-syms--binding-with-a-keycode)
{{< /callout >}}
```ini
# On a french layout, instead of
# bind = $mainMod, 1, workspace, 1
# Use
bind = $mainMod, ampersand, workspace, 1
```
For help configuring the `French Azerty` layout, [see](https://rherault.dev/articles/hyprland-fr-layout).
### Unbind ### Unbind
You can also unbind with `unbind`, e.g.: You can also unbind with `unbind`, e.g.: