✨ Add the Keyboard section (#352)

Co-authored-by: Alexander Momchilov <[email protected]>

Author: yannbertrand

docs/.vitepress/config.js

@@ -355,6 +355,23 @@ export default defineConfig({
           },
         ],
       },
+      {
+        text: 'Keyboard',
+        items: [
+          {
+            text: 'Key held down behavior',
+            link: '/keyboard/applepressandholdenabled.md',
+          },
+          {
+            text: 'Configure fn/🌐︎ key',
+            link: '/keyboard/applefnusagetype.md',
+          },
+          {
+            text: 'Function keys behavior',
+            link: '/keyboard/applekeyboardfnstate.md',
+          },
+        ],
+      },
       {
         text: 'Mission Control',
         items: [
@@ -469,10 +486,6 @@ export default defineConfig({
             text: 'Close confirm changes popup',
             link: '/misc/nsclosealwaysconfirmschanges.md',
           },
-          {
-            text: 'Function keys behavior',
-            link: '/misc/applekeyboardfnstate.md',
-          },
         ],
       },
     ],

docs/index.md

@@ -147,6 +147,12 @@ defaults rename ${domain} ${old_key} ${new_key}
 - [Enable dragging without drag lock](./trackpad/dragging.md)
 - [Enable dragging with three finger drag](./trackpad/trackpadthreefingerdrag.md)
 
+### Keyboard
+
+- [Key held down behavior](./keyboard/applepressandholdenabled.md)
+- [Configure fn/🌐︎ key](./keyboard/applefnusagetype.md)
+- [Function keys behavior](./keyboard/applekeyboardfnstate.md)
+
 ### Mission Control
 
 - [Rearrange automatically](./mission-control/mru-spaces.md)
@@ -191,9 +197,7 @@ defaults rename ${domain} ${old_key} ${new_key}
 - [Enable spring loading for all Dock items](./misc/enable-spring-load-actions-on-all-items.md)
 - [Show Music song notifications](./misc/userwantsplaybacknotifications.md)
 - [Disable application quarantine message](./misc/lsquarantine.md)
-- [Key held down behavior](./misc/applepressandholdenabled.md)
 - [Close confirm changes popup](./misc/nsclosealwaysconfirmschanges.md)
-- [Function keys behavior](./misc/applekeyboardfnstate.md)
 
 ## 🤔 How do I add a command?
 

docs/keyboard/applefnusagetype.md

@@ -0,0 +1,71 @@
+---
+title: Keyboard | Fn key usage
+description: Choose what happens when you press the Fn or 🌐︎ key on the keyboard.
+head:
+  - - meta
+    - property: 'og:title'
+      content: macOS defaults > Keyboard > Fn key usage
+  - - meta
+    - property: 'og:description'
+      content: Choose what happens when you press the Fn or 🌐︎ key on the keyboard.
+---
+
+# Function key usage
+
+Choose what happens when you press the Fn or 🌐︎ key on the keyboard.
+
+⚠️ A restart of your Mac is required to apply these changes.
+
+<!-- break lists -->
+
+- **Tested on macOS**:
+  - Sonoma
+- **Parameter type**: int
+  - 0
+  - 1
+  - 2
+  - 3
+
+## Set to: Do Nothing (default)
+
+Nothing happens.
+
+```bash
+defaults write com.apple.HIToolbox AppleFnUsageType -int "0"
+```
+
+## Set to: Change input source
+
+Switches between keyboard layouts for writing in other languages (known as input sources).
+
+```bash
+defaults write com.apple.HIToolbox AppleFnUsageType -int "1"
+```
+
+## Set to: Show Emoji & Symbols
+
+Opens the Character Viewer for entering emoji, symbols, and more.
+
+```bash
+defaults write com.apple.HIToolbox AppleFnUsageType -int "2"
+```
+
+## Set to: Start Dictation
+
+Starts dictation when you press the key twice (you may be asked to enable dictation first).
+
+```bash
+defaults write com.apple.HIToolbox AppleFnUsageType -int "3"
+```
+
+## Read current value
+
+```bash
+defaults read com.apple.HIToolbox AppleFnUsageType
+```
+
+## Reset to default value
+
+```bash
+defaults delete com.apple.HIToolbox AppleFnUsageType
+```

docs/misc/applekeyboardfnstate.md renamed to docs/keyboard/applekeyboardfnstate.md

@@ -1,10 +1,10 @@
 ---
-title: Function keys behavior | Miscellaneous
+title: Function keys behavior | Keyboard
 description: Allows you to change the behavior of the function keys.
 head:
   - - meta
     - property: 'og:title'
-      content: macOS defaults > Miscellaneous > Function keys behaviour
+      content: macOS defaults > Keyboard > Function keys behaviour
   - - meta
     - property: 'og:description'
       content: Allows you to change the behavior of the function keys.

docs/misc/applepressandholdenabled.md renamed to docs/keyboard/applepressandholdenabled.md

@@ -1,10 +1,10 @@
 ---
-title: Key held down behavior | Miscellaneous
+title: Key held down behavior | Keyboard
 description: Allows you to select the behavior when a key is held down for a long time.
 head:
   - - meta
     - property: 'og:title'
-      content: macOS defaults > Miscellaneous > Key held down behavior
+      content: macOS defaults > Keyboard > Key held down behavior
   - - meta
     - property: 'og:description'
       content: Allows you to select the behavior when a key is held down for a long time.

docs/misc/images/ApplePressAndHoldEnabled/false.png renamed to docs/keyboard/images/ApplePressAndHoldEnabled/false.png

@@ -0,0 +1,21 @@
+---
+title: Keyboard
+description: The hardware device to type on a computer.
+head:
+  - - meta
+    - property: 'og:title'
+      content: macOS defaults > Keyboard
+  - - meta
+    - property: 'og:description'
+      content: The hardware device to type on a computer.
+---
+
+# Keyboard
+
+The hardware device to type on a computer.
+
+## Keys
+
+- [Key held down behavior](./applepressandholdenabled.md)
+- [Configure fn/🌐︎ key](./applefnusagetype.md)
+- [Function keys behavior](./applekeyboardfnstate.md)

docs/misc/images/ApplePressAndHoldEnabled/true.png renamed to docs/keyboard/images/ApplePressAndHoldEnabled/true.png

@@ -20,6 +20,4 @@ All the others `defaults` that don't deserve their own category.
 - [Enable spring loading for all Dock items](./enable-spring-load-actions-on-all-items.md)
 - [Show Music song notifications](./userwantsplaybacknotifications.md)
 - [Disable application quarantine message](./lsquarantine.md)
-- [Key held down behavior](./applepressandholdenabled.md)
 - [Close confirm changes popup](./nsclosealwaysconfirmschanges.md)
-- [Function keys behavior](./applekeyboardfnstate.md)