Skip to content

Commit cddda75

Browse files
committed
installation/live-images/index: describe a11y features and KCL params
1 parent 6de5639 commit cddda75

File tree

1 file changed

+34
-1
lines changed

1 file changed

+34
-1
lines changed

src/installation/live-images/index.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The following software is included:
3434

3535
- **Window manager:** xfwm4
3636
- **File manager:** Thunar
37-
- **Web Browser:** Firefox ESR
37+
- **Web Browser:** Firefox
3838
- **Terminal:** xfce4-terminal
3939
- **Plain text editor:** Mousepad
4040
- **Image viewer:** Ristretto
@@ -45,3 +45,36 @@ The install process for the xfce image is the same as the base images, except
4545
that you **must** select the `Local` source when installing. If you select
4646
`Network` instead, the installer will download and install the latest version of
4747
the base system, without any additional packages included on the live image.
48+
49+
## Accessibility support
50+
51+
All Void installer images support the console screenreader
52+
[espeakup](https://man.voidlinux.org/espeakup.8) and the console braille display
53+
driver [brltty](https://man.voidlinux.org/brltty.1). These services can be
54+
enabled at boot by pressing `s` in the bootloader menu to enable accessibility
55+
support. On UEFI-based systems, GRUB is the bootloader, and it will play a
56+
two-tone chime when the menu is available. On BIOS-based systems and UEFI
57+
systems in legacy/compatibility mode, SYSLINUX is the bootloader, and no chime
58+
is played. SYSLINUX also requires pressing the enter key after pressing `s`. The
59+
hotkey `r` will also boot with accessibility support, but will load the live ISO
60+
into RAM.
61+
62+
After booting into the installer image with accessibility support enabled, if
63+
there are multiple soundcards detected, a short audio menu allows for the
64+
selection of the soundcard for the screenreader. Press enter when the beep for
65+
the desired soundcard is heard to select it.
66+
67+
If the `Local` installation source is selected in the installer, `espeakup` and
68+
`brltty` will also be installed and enabled on the installed system if enabled
69+
in the live environment.
70+
71+
The xfce image also supports the graphical screenreader
72+
[orca](https://man.voidlinux.org/orca.1). This can be enabled by pressing `Win +
73+
R` and entering `orca -r`. Orca will also be available on the installed system
74+
if the `Local` installation source is selected.
75+
76+
## Kernel Command-line Parameters
77+
78+
Void installer images support several kernel command-line arguments that can
79+
change the behavior of the live system. See [the void-mklive README for a full
80+
list](https://github.com/void-linux/void-mklive#kernel-command-line-parameters).

0 commit comments

Comments
 (0)