Porting more accessibility pages

Author: msuchane

docs/how-to/accessibility/adjust-the-double-click-speed.md

@@ -0,0 +1,16 @@
+(adjust-the-double-click-speed)=
+# Adjust the double-click speed
+
+Double-clicking only happens when you press the mouse button twice quickly enough. If the second press is too long after the first, you’ll just get two separate clicks, not a double click. If you have difficulty pressing the mouse button quickly, you should increase the timeout.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Pointing & Clicking` section.
+4. Adjust the {guilabel}`Double-Click Delay` slider to a value you find comfortable.
+
+If your mouse double-clicks when you want it to single-click even though you have increased the double-click timeout, your mouse may be faulty. Try plugging a different mouse into your computer and see if that works properly. Alternatively, plug your mouse into a different computer and see if it still has the same problem.
+
+:::{note}
+This setting will affect both your mouse and touchpad, as well as any other pointing device.
+:::
+

docs/how-to/accessibility/adjust-the-speed-of-the-mouse-and-touchpad.md

@@ -0,0 +1,13 @@
+(adjust-the-speed-of-the-mouse-and-touchpad)=
+# Adjust the speed of the mouse and touchpad
+
+If your pointer moves too fast or slow when you move your mouse or use your touchpad, you can adjust the pointer speed for these devices.
+
+1. Open the Activities overview and start typing **mouse & touchpad**.
+2. Click {guilabel}`Mouse & Touchpad` to open the panel.
+3. Adjust the {guilabel}`Pointer Speed` slider until the pointer motion is comfortable for you. Sometimes the most comfortable settings for one type of device are not the best for the other.
+
+:::{note}
+The {guilabel}`Touchpad` section only appears if your system has a touchpad, while the {guilabel}`Mouse` section is only visible when a mouse is connected.
+:::
+

docs/how-to/accessibility/click-and-move-the-mouse-pointer-using-the-keypad.md

@@ -0,0 +1,60 @@
+(click-and-move-the-mouse-pointer-using-the-keypad)=
+# Click and move the mouse pointer using the keypad
+
+If you have difficulties using a mouse or other pointing device, you can control the mouse pointer using the numeric keypad on your keyboard. This feature is called **mouse keys**.
+
+1. Open the Activities overview and start typing **accessibility**.
+
+    You can access the Activities overview by pressing on it, by moving your mouse pointer against the top-left corner of the screen, by using {kbd}`Ctrl+Alt+Tab` followed by {kbd}`Enter`, or by using the {kbd}`Super` key.
+
+3. Click {guilabel}`Accessibility` to open the panel.
+4. Open the {guilabel}`Pointing & Clicking` section.
+5. Enable the {guilabel}`Mouse Keys` option.
+6. Make sure that {kbd}`Num Lock` is turned off.
+
+You will now be able to move the mouse pointer using the keypad.
+
+The keypad is a set of numerical buttons on your keyboard, usually arranged into a square grid. If you have a keyboard without a keypad (such as a laptop keyboard), you may need to hold down the function ({kbd}`Fn`) key and use certain other keys on your keyboard as a keypad. If you use this feature often on a laptop, you can purchase external USB or Bluetooth numeric keypads.
+
+Each number on the keypad corresponds to a direction. For example, pressing {kbd}`8` will move the pointer upwards and pressing {kbd}`2` will move it downwards. Press the {kbd}`5` key to click once with the mouse, or quickly press it twice to double-click.
+
+<!--
+The list table doesn't really represent well what it renders as. A standard Markdown table would be more visually readable:
+
+| 7 | 8 | 9 |
+| 4 | 5 | 6 |
+| 1 | 2 | 3 |
+
+However, this style of table requires a header, which we don't want here. The list table is a workaround.
+-->
+
+:::{list-table} Key directions
+* - {kbd}`7`
+  - {kbd}`8`
+
+    Up
+  - {kbd}`9`
+* - {kbd}`4`
+
+    Left
+  - {kbd}`5`
+
+    Click
+  - {kbd}`6`
+
+    Right
+* - {kbd}`1`
+  - {kbd}`2`
+
+    Down
+  - {kbd}`3`
+:::
+
+Most keyboards have a special key which allows you to right-click, sometimes called the {kbd}`Menu` key. Note, however, that this key responds to where your keyboard focus is, not where your mouse pointer is. See {ref}`simulate-a-right-mouse-click` for information on how to right-click by holding down {kbd}`5` or the left mouse button.
+
+If you want to use the keypad to type numbers while mouse keys is enabled, turn {kbd}`Num Lock` on. The mouse cannot be controlled with the keypad when {kbd}`Num Lock` is turned on, though.
+
+:::{note}
+The normal number keys, in a line at the top of the keyboard, will not control the mouse pointer. Only the keypad number keys can be used.
+:::
+

docs/how-to/accessibility/flash-the-screen-for-alert-sounds.md

@@ -0,0 +1,17 @@
+(flash-the-screen-for-alert-sounds)=
+# Flash the screen for alert sounds
+
+Your computer will play a simple alert sound for certain types of messages and events. If you have a hard time hearing these sounds, you can have either the entire screen or your current window visually flash whenever the alert sound is played.
+
+This can also be useful if you’re in an environment where you need your computer to be silent, such as in a library. See Choose or disable the alert sound to learn how to mute the alert sound, then enable visual alerts.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Hearing` section.
+4. In the {guilabel}`Visual Alerts` section, enable the {guilabel}`Visual Alerts` option.
+5. Under {guilabel}`Flash Area`, select whether you want the entire screen or just your current window title to flash.
+
+:::{tip}
+You can quickly turn visual alerts on and off by clicking the {ref}`accessibility icon <find-the-accessibility-menu>` on the top bar and selecting {guilabel}`Visual Alerts`.
+:::
+

docs/how-to/accessibility/index.md

@@ -12,5 +12,11 @@ adjust-the-contrast
 change-text-size-on-the-screen
 magnify-a-screen-area
 make-the-keyboard-cursor-blink
+flash-the-screen-for-alert-sounds
+adjust-the-speed-of-the-mouse-and-touchpad
+click-and-move-the-mouse-pointer-using-the-keypad
+adjust-the-double-click-speed
+simulate-a-right-mouse-click
+simulate-clicking-by-hovering
 :::
 

docs/how-to/accessibility/simulate-a-right-mouse-click.md

@@ -0,0 +1,22 @@
+(simulate-a-right-mouse-click)=
+# Simulate a right mouse click
+
+You can right-click by holding down the left mouse button. This is useful if you find it difficult to move your fingers individually on one hand, or if your pointing device only has a single button.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Pointing & Clicking` section.
+4. In the {guilabel}`Click Assist` section, enable the {guilabel}`Simulated Secondary Click` option.
+
+You can change how long you must hold down the left mouse button before it is registered as a right click by changing the {guilabel}`Acceptance Delay`.
+
+To right-click with simulated secondary click, hold down the left mouse button where you would normally right-click, then release. The pointer fills with a different color as you hold down the left mouse button. Once it will change this color entirely, release the mouse button to right-click.
+
+Some special pointers, such as the resize pointers, do not change colors. You can still use simulated secondary click as normal, even if you do not get visual feedback from the pointer.
+
+If you use {ref}`Mouse Keys <click-and-move-the-mouse-pointer-using-the-keypad>`, this also allows you to right-click by holding down the {kbd}`5` key on your keypad.
+
+:::{note}
+In the Activities overview, you are always able to long-press to right-click, even with this feature disabled. Long-press works slightly differently in the overview: you do not have to release the button to right-click.
+:::
+

docs/how-to/accessibility/simulate-clicking-by-hovering.md

@@ -0,0 +1,22 @@
+(simulate-clicking-by-hovering)=
+# Simulate clicking by hovering
+
+You can click or drag simply by hovering your mouse pointer over a control or object on the screen. This is useful if you find it difficult to move the mouse and click at the same time. This feature is called **Hover Click** or **Dwell Click**.
+
+When Hover Click is enabled, you can move your mouse pointer over a control, let go of the mouse, and then wait for a while before the button will be clicked for you.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Pointing & Clicking` section.
+4. In the {guilabel}`Click Assist` section, enable the {guilabel}`Hover Click` option.
+
+The {guilabel}`Hover Click` window will open, and will stay above all of your other windows. You can use this to choose what sort of click should happen when you hover. For example, if you select {guilabel}`Secondary Click`, you will right-click when you hover. After you double-click, right-click, or drag, you will be automatically returned to clicking.
+
+When you hover your mouse pointer over a button and do not move it, it will gradually change color. When it has fully changed color, the button will be clicked.
+
+Adjust the {guilabel}`Delay` setting to change how long you have to hold the mouse pointer still before clicking.
+
+You do not need to hold the mouse perfectly still when hovering to click. The pointer is allowed to move a little bit and will still click after a while. If it moves too much, however, the click will not happen.
+
+Adjust the {guilabel}`Motion Threshold` setting to change how much the pointer can move and still be considered to be hovering.
+