diff --git a/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md b/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md index 0ea45fd698b5..1c61b1c3f3a0 100644 --- a/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md +++ b/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md @@ -1,65 +1,61 @@ ---- -title: Managing accessibility settings -shortTitle: Manage accessibility settings -intro: '{% data variables.product.product_name %}''s user interface can adapt to your vision, hearing, motor, cognitive, or learning needs.' -versions: - feature: keyboard-shortcut-accessibility-setting -redirect_from: - - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings - - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-accessibility-settings -type: how_to ---- +# Managing Accessibility Settings + +## Introduction -## About accessibility settings +The user interface of {% data variables.product.product_name %} can be customized to better meet your accessibility needs, whether for vision, hearing, motor, cognitive, or learning assistance. Accessibility settings aren't just for users with disabilities—they offer flexibility that can benefit everyone. For example, adjusting keyboard shortcuts helps people using voice control but can also be useful if a shortcut conflicts with another application. -To create an experience on {% data variables.location.product_location %} that fits your needs, you can customize the user interface. Accessibility settings can be essential for people with disabilities, but can be useful to anyone. For example, customization of keyboard shortcuts is essential to people who navigate using voice control, but can be useful to anyone when a keyboard shortcut for {% data variables.product.product_name %} clashes with another application shortcut. +--- -You can decide whether you want to use some or all keyboard shortcuts on {% ifversion fpt or ghec %}{% data variables.location.product_location %}{% elsif ghes %}the website for {% data variables.location.product_location %}{% endif %} and you can also control the display of animated images{% ifversion link-underlines %} and how links are displayed{% endif %}. +## Managing Accessibility Settings -{% ifversion link-underlines %} +### About Accessibility Settings -## Managing the appearance of links +To create a customized experience on {% data variables.location.product_location %}, you can adjust the user interface to fit your needs. Accessibility settings are essential for people with disabilities but can also be useful for anyone. For example, modifying keyboard shortcuts is critical for users who navigate with voice control, but it also helps anyone experiencing shortcut conflicts with other applications. -You can control whether links in text blocks on {% data variables.location.product_location %} are underlined and therefore more distinguishable. +You can choose to enable or disable some or all keyboard shortcuts on {% ifversion fpt or ghec %}{% data variables.location.product_location %}{% elsif ghes %}the website for {% data variables.location.product_location %}{% endif %}. Additionally, you can control how animated images and links are displayed. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.accessibility_settings %} -1. Under "Content", manage settings for link appearance. +--- - * To enable underlines on links in text blocks, under "Link underlines", select **Show link underlines**. - * To disable underlines on links in text blocks, under "Link underlines", select **Hide link underlines**. - * To disable hovercards for previewing link content, deselect **Hovercards**. +### Managing the Appearance of Links -{% endif %} +You can decide whether links in text blocks on {% data variables.location.product_location %} are underlined for better distinction. -## Managing keyboard shortcuts +1. Navigate to your user settings. +2. Go to **Accessibility settings**. +3. Under the "Content" section, manage settings for link appearance: + - To enable underlines on links, under "Link underlines", select **Show link underlines**. + - To disable underlines on links, select **Hide link underlines**. + - To disable hovercards for previewing link content, deselect **Hovercards**. -You can perform actions across the {% data variables.product.product_name %} website by using your keyboard alone. Keyboard shortcuts can be useful to save time, but can be activated accidentally or interfere with assistive technology. +--- + +### Managing Keyboard Shortcuts -By default, all keyboard shortcuts are enabled on {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/get-started/accessibility/keyboard-shortcuts)." +You can perform actions across the {% data variables.product.product_name %} website using keyboard shortcuts. While these can be a time saver, they might also accidentally trigger or interfere with assistive technologies. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.accessibility_settings %} -1. Under "Keyboard shortcuts", manage settings for your keyboard shortcuts. +By default, all keyboard shortcuts are enabled on {% data variables.product.product_name %}. - * To disable shortcut keys that don't use modifiers keys like Control or Command, under "General", deselect **Character keys**. - * If you disable character keys, you may still be able to trigger shortcuts for your web browser, and you can still trigger shortcuts for {% data variables.product.product_name %} that use a modifier key. - {%- ifversion command-palette %} - * To customize the keyboard shortcuts for triggering the command palette, under "Command palette", use the drop-down menus to choose a keyboard shortcut. For more information, see "[AUTOTITLE](/get-started/accessibility/github-command-palette)." - {%- endif %} +1. Navigate to your user settings. +2. Go to **Accessibility settings**. +3. Under "Keyboard shortcuts", manage your keyboard shortcut settings: + - To disable shortcut keys that don’t use modifier keys like Control or Command, deselect **Character keys** under "General". + - You can still trigger browser shortcuts and shortcuts that use modifier keys for {% data variables.product.product_name %}. -{% ifversion motion-management %} +{% ifversion command-palette %} + - To customize shortcuts for triggering the command palette, choose a shortcut under "Command palette" using the dropdown menus. For more information, refer to the "[GitHub Command Palette Documentation](/get-started/accessibility/github-command-palette)". +{% endif %} -## Managing motion +--- -You can control how {% data variables.product.product_name %} displays animated _.gif_ images. +### Managing Motion -By default, {% data variables.product.product_name %} syncs with your system-level preference for reduced motion. For more information, see the documentation or settings for your operating system. +You can control how {% data variables.product.product_name %} displays animated _.gif_ images. By default, {% data variables.product.product_name %} syncs with your system’s preference for reduced motion. -{% data reusables.user-settings.access_settings %} -{% data reusables.user-settings.accessibility_settings %} -1. Under "Motion", manage settings for motion. +1. Navigate to your user settings. +2. Go to **Accessibility settings**. +3. Under "Motion", manage settings for motion: + - To control how animated images are displayed, under "Autoplay animated images", select **Sync with system**, **Enabled**, or **Disabled**. - * To control how {% data variables.product.product_name %} displays animated images, under "Autoplay animated images", select **Sync with system**, **Enabled**, or **Disabled**. +--- -{% endif %} +For more information on accessibility settings, visit the official documentation or refer to the settings on your operating system.