From 70acc53e0492f769c6ceafda26c9adb154cec403 Mon Sep 17 00:00:00 2001
From: vaxerski <43317083+vaxerski@users.noreply.github.com>
Date: Mon, 17 Oct 2022 13:52:17 +0100
Subject: [PATCH] revamp switchable layouts
---
pages/Configuring/Uncommon-tips-&-tricks.md | 36 +++++----------------
1 file changed, 8 insertions(+), 28 deletions(-)
diff --git a/pages/Configuring/Uncommon-tips-&-tricks.md b/pages/Configuring/Uncommon-tips-&-tricks.md
index 5b01756..3580c08 100644
--- a/pages/Configuring/Uncommon-tips-&-tricks.md
+++ b/pages/Configuring/Uncommon-tips-&-tricks.md
@@ -1,38 +1,18 @@
## Switchable keyboard layouts
-An example of a switchable keyboard layout between US and RU, where you switch
-between them with SUPER+A (SUPER+ะค)
-
-```ini
-bind=SUPER,A,exec,hyprctl keyword input:kb_layout ru
-bind=SUPER,Cyrillic_ef,exec,hyprctl keyword input:kb_layout us
+The easiest way to accomplish this is to set this using XKB settings, for example:
+```
+input {
+ kb_layout = us,pl
+ kb_options = grp:alt_shift_toggle
+}
```
-You can apply this to any number of languages, mix'n'match, etc.
-
-Please note that if a keyboard layout has a different alphabet, mappings for "a"
-"b" "c" will be replaced with mappings from that language. (meaning, e.g.
-SUPER + D will not work on a `ru` layout, because the russian layout does not
-have a D.)
-
-{{< hint type=important >}}
-After Hyprland v0.10.3beta, the above statement may be false. Hyprland (since *after* v0.10.3beta) will now ALWAYS use the global xkb settings for keybind parsing.
-
-Thus, if you have a global layout set to `us`, and per-keyboard layout as `ru`, your keyboard's layout will be russian, but the keybinds will parse based on
-the `us` layout (e.g. SUPER + E)
-{{< /hint >}}
-
-If you are unsure about the key names of your chosen alphabet, refer to the
-[xkbcommon keysym header](https://github.com/xkbcommon/libxkbcommon/blob/master/include/xkbcommon/xkbcommon-keysyms.h).
-The keysym name in Hyprland is the XKB define name without the `XKB_KEY_`.
-
-Generally, for switched layouts, it's recommended to bind by a keycode.
-
{{< hint type=important >}}
-For proper switching, or avoiding problems / bugs, it's recommended to switch per-device configs instead of global ones.
+The first layout defined in the input section will be the one used for binds.
-See [per-device input configs](../Keywords/#per-device-input-configs).
+For example: `us,ua` -> config binds would be e.g. `SUPER, A`, while on `ua,us` -> `SUPER, Cyryllic_ef`
{{< /hint >}}