Date: Mon, 24 Nov 2025 21:36:32 +0000 From: Alfonso S. Siciliano <asiciliano@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: 1eb0d9a220 - main - Acessibility Handbook: Add KDE examples Message-ID: <6924cfe0.310c7.194ee3a0@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by asiciliano: URL: https://cgit.FreeBSD.org/doc/commit/?id=1eb0d9a22091a564c73edf0c40433dc87f5b0055 commit 1eb0d9a22091a564c73edf0c40433dc87f5b0055 Author: Alfonso S. Siciliano <asiciliano@FreeBSD.org> AuthorDate: 2025-11-24 21:35:05 +0000 Commit: Alfonso S. Siciliano <asiciliano@FreeBSD.org> CommitDate: 2025-11-24 21:35:05 +0000 Acessibility Handbook: Add KDE examples Approved by: bcr Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D51294 --- .../en/books/accessibility/blindness/_index.adoc | 9 +-- .../en/books/accessibility/colors/_index.adoc | 69 +++++++++++++++++++++ .../en/books/accessibility/lowvision/_index.adoc | 71 ++++++++++++++++++++++ 3 files changed, 145 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/accessibility/blindness/_index.adoc b/documentation/content/en/books/accessibility/blindness/_index.adoc index 020adbef74..1ff0beeb44 100644 --- a/documentation/content/en/books/accessibility/blindness/_index.adoc +++ b/documentation/content/en/books/accessibility/blindness/_index.adoc @@ -88,10 +88,11 @@ From a terminal, type: % orca .... -Some desktop environments provide a keyboard shortcut to launch Orca: - -- XFCE: `Super` + `Alt` + `s` -- GNOME `Super` + `Alt` + `S` +Some desktop environments +(extref:{handbook}desktop/#kde-environment[KDE Plasma], +extref:{handbook}desktop/#xfce-environment[XFCE], +extref:{handbook}desktop/#gnome-environment[GNOME]) +provide a keyboard shortcut to launch Orca: `Super` + `Alt` + `s`. [TIP] ==== diff --git a/documentation/content/en/books/accessibility/colors/_index.adoc b/documentation/content/en/books/accessibility/colors/_index.adoc index f3cda2106c..2f9ef57333 100644 --- a/documentation/content/en/books/accessibility/colors/_index.adoc +++ b/documentation/content/en/books/accessibility/colors/_index.adoc @@ -64,6 +64,22 @@ This chapter explains how to configure colors for on-screen elements, including: Graphical Environments allow you to easily install and set up graphical themes. This paragraph describes how to configure high contrast themes for windows. +[[kde-high-contrast]] +=== KDE Plasma + +Launch the `Global Theme` module: + +[source,shell] +.... +% kcmshell6 kcm_lookandfeel +.... + +The window shows the current installed themes. +Click on the "Get New..." icon in the top right corner. +A new window will show additional themes available for installation. +In the search field at the top right, you can look for new themes to install. +You can search for "high contrast" or "Acrilic Dark". + [[xfce-high-contrast]] === XFCE @@ -107,6 +123,22 @@ The theme selection steps (5 and 6) can also be performed using the graphical co Graphical Environments allow you to easily install and set up icon themes. This paragraph describes how to configure high contrast icons. +[[kde-icon-high-contrast]] +=== KDE Plasma + +Open the `_Icons_` module: + +[source,shell] +.... +% kcmshell6 kcm_icons +.... + +The window displays the currently installed icon themes. +To install a new theme, click the `_Get New..._` icon in the top right corner. +A new window will appear, allowing you to browse and install additional icon themes. +As a suggestion, you can search for `Treepata` using the search bar at the top right. +Although originally designed for XFCE and later adapted for KDE Plasma, Treepata was created as a high-contrast accessibility theme. + [[xfce-icon-high-contrast]] === XFCE @@ -180,6 +212,11 @@ Some utilities are compatible with the extref:{handbook}x11[X Window System], ot | X11 | package:accessibility/gammastep[] +| Night Light +| Yes +| extref:{handbook}desktop/#kde-environment[KDE Plasma] +| package:x11/kde[] + | redshift | Yes | X11, Wayland @@ -264,6 +301,19 @@ If you encounter any issues, customize the configuration by adapting the link:ht Refer to the link:https://gitlab.com/chinstrap/gammastep/-/blob/master/README.md[README] for troubleshooting. ==== +[[kde-nightlight]] +=== KDE Plasma + +KDE allows you to adjust the screen color temperature based on geographic location and local time. +Launch the `_Night Light_` module: + +[source,shell] +.... +% kcmshell6 kcm_nightlight +.... + +Enable automatic color adjustment by selecting the desired option from the `_Switching times_` drop-down menu. + [[redshift]] === redshift @@ -606,3 +656,22 @@ Example for setting brightness to 50% for HDMI-1: .... % xrandr --output HDMI-1 --brightness 0.5 .... + +[[colorblindness]] +== Color Blindness + +This section describes how to use utilities designed for color blindness. + +[[kde-colorblindness]] +=== KDE Plasma + +KDE allows you to filter colors for graphical elements. +Launch the `_Accessibility_` module: + +[source,shell] +.... +% kcmshell6 kcm_access +.... + +In the navigation pane, select `_Color Blindness Correction_`. +Enable the `_Color blindness correction_` option, then choose the appropriate color transformation mode from the `_Mode_` drop-down menu. diff --git a/documentation/content/en/books/accessibility/lowvision/_index.adoc b/documentation/content/en/books/accessibility/lowvision/_index.adoc index 4b71057c0e..7424045052 100644 --- a/documentation/content/en/books/accessibility/lowvision/_index.adoc +++ b/documentation/content/en/books/accessibility/lowvision/_index.adoc @@ -60,6 +60,19 @@ This chapter outlines accessibility features available in graphical desktop envi Graphical environments allow users to adjust the desktop display size, a feature commonly known as screen scaling or HiDPI scaling. The goal is to enlarge desktop elements such as icons, text, and windows to improve visibility and accessibility. +[[kde-hidpi]] +=== KDE Plasma + +Open the `_Display Configuration_` module: + +[source,shell] +.... +% kcmshell6 kcm_kscreen +.... + +Select the scaling via the `_Global Scale_` bar. +The change will take effect after a KDE Plasma restart. + [[xfce-hidpi]] === XFCE @@ -93,6 +106,23 @@ To install, execute: The remainder of this section describes how to set up fonts in various graphical environments using _atkinson-hyperlegible_ as an example. +[[kde-fonts]] +=== KDE Plasma + +KDE allows selecting a font and its size via the `_Fonts_` module. +Run: + +[source,shell] +.... +% kcmshell6 kcm_fonts +.... + +Click on the Adjust `_All Fonts..._` button to select the font and its size for all graphical elements. +Alternatively, you can choose the font and size for individual elements using the forms below. + +At the bottom of the window, you can also select options such as `_Anti-Aliasing_`, `_Sub-pixel Rendering_`, `_Hinting_`, and `_Force Font DPI_`. +Each option has an icon on the right to open a help dialog. + [[xfce-fonts]] === XFCE @@ -311,6 +341,25 @@ Interaction is keyboard-driven, refer to man:xzoom[1] for available commands and Some desktop environments allow you to change the size, color, and other graphical properties of the mouse cursor. +[[kde-mouse]] +==== KDE Plasma + +KDE Plasma provides the `_Cursors_` module to select the mouse cursor theme and size. +To launch it, run: + +[source,shell] +.... +% kcmshell6 kcm_cursortheme +.... + +Select an installed cursor theme in the window. +There is a `_Size_` drop-down menu in the top left corner to choose the mouse cursor size, +available sizes depend on the selected theme. + +Click the `_Get New..._` icon in the top right corner to install a new theme. +You can install new themes from the new window. +As a suggestion, search for `_Large Mouse Cursors_`, a black and white high contrast theme. + [[xfce-mouse]] ==== XFCE @@ -342,6 +391,28 @@ The following example set the current theme cursur to size 50: Some desktop environments provide a visul feedback of the mouse pointer's current position. +[[kde-find-mouse-cursor]] +==== KDE Plasma + +KDE Plasma draws two circular lines moving around the mouse cursor. +Open the `Desktop Effects` module: + +[source,shell] +.... +% kcmshell6 kcm_kwin_effects +.... + +Enable the `_Track Mouse_` checkbox. +Draw circular lines by pressing `Meta` + `Ctrl` keys. +You can change the shortcut via the `_Configure_` button related to `_Track Mouse_`. + +[TIP] +==== +On keyboards where the `Meta` key is not present, it is usually replaced by the `Super` key. +Refer to https://en.wikipedia.org/wiki/Meta_key and https://en.wikipedia.org/wiki/Super_key_(keyboard_button) for more information. +==== + + [[xfce-find-mouse-cursor]] ==== XFCEhelp
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6924cfe0.310c7.194ee3a0>