From nobody Mon Nov 24 21:36:32 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dFfKF2FVrz6HsLK for ; Mon, 24 Nov 2025 21:36:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dFfKF0DBYz3dmh for ; Mon, 24 Nov 2025 21:36:33 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764020193; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ohZG+QbwZZwhtOtJuIyFs8hBlh2xQzdA8gqXgQd/9Cc=; b=yYQl4SnGw0MjYuDd9ugkY3EzNhXs4WdapyJAnNoKnIluqvujvfpfYUPcgty68p6Ah3KQ1A Eao7TgL2ND8UoZULkYcmOEobufYoUzNCWVpgrobAhElr+hhML1oT7SE7ERmkDN9DxrPdW9 Sz+SPT5m/J4EWdbPsG1tSFhgDwD/+b1/Faw2TeaJnuQvBgqNWxtkbyU7hnstZmUDRyQ2mQ RpB42CffGwqDhL+QxWlz6jfOgoxXhAIdzwGrOKNgrYhlcrv4vIGapbXgUf8bqILs3hZSvF EZjy4OU7rpRcaOjU9/0m4h45E15H2EOplNmIw5Mzc2YaFFNLx5/T1f4LBKXHJg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764020193; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ohZG+QbwZZwhtOtJuIyFs8hBlh2xQzdA8gqXgQd/9Cc=; b=cCfGgUtd851d4Cagh4DUPwIlmDnPqo8ADzGNrqgyUIIExIOB1lSkF0SI4lfdIxVKul2KTa OVX/YGEV+rTHsD1+S8hnJLYsarUS5Ok2rMhIlihFLb/BJkOis+682pM4SJeQy/2gnKTYe0 qsQZy6VGiIcP/FEyg/hlo7dhTF9L0gx7/4MsIDkdbotqq4eQT7NmqUBNOR6xRle6SGHvQa ekiFS7iktnEqeNTzVKGFFVOCGx5zheUM7D6UCZxRlRwPe2C0RN1edbAhR4OGCWxexTt4k9 l53oQWdIMWgzOLIxhLRsYh39+YmrAxunIqBrP3+nnjTn0ifKhgpa0phsKLIGFQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1764020193; a=rsa-sha256; cv=none; b=OCtyNWZUDH3ITceRFln1VglZrxEGCrXz9tNbu1jyNrWyMiG+q7+oVedWaRd85uXdjBBCOj 1al64j92kIsLodtXUJSp+QqZyzTZj3fIl4Gc0sCwTXthgs5i7t6QdChQ76K2tqC/YIgLD7 bWvZHn3ygl+93sYVdMVKSE0TpCoWkLOEgsZUAC0VgQfDPIPxIYPgEQCKnOsHYGfGExLIz5 mG8++uPzmvkmrPBySsAo1DI03Ub36nzhWbmuicJBIo6TAI+U9Wk7YUuGiEOywk21+J3TmV 4x1CnDtnYh8/sOBCGnoMOAC5YBHq0iWzRDggXvWVkM3+QfNIwkjmpeinOliTwg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dFfKD6Q2dzXSD for ; Mon, 24 Nov 2025 21:36:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 310c7 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 24 Nov 2025 21:36:32 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Alfonso S. Siciliano Subject: git: 1eb0d9a220 - main - Acessibility Handbook: Add KDE examples List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: asiciliano X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1eb0d9a22091a564c73edf0c40433dc87f5b0055 Auto-Submitted: auto-generated Date: Mon, 24 Nov 2025 21:36:32 +0000 Message-Id: <6924cfe0.310c7.194ee3a0@gitrepo.freebsd.org> The branch main has been updated by asiciliano: URL: https://cgit.FreeBSD.org/doc/commit/?id=1eb0d9a22091a564c73edf0c40433dc87f5b0055 commit 1eb0d9a22091a564c73edf0c40433dc87f5b0055 Author: Alfonso S. Siciliano AuthorDate: 2025-11-24 21:35:05 +0000 Commit: Alfonso S. Siciliano 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]] ==== XFCE