From 60f1bc1b67967d13b2243ab999a1bb19d610e09d Mon Sep 17 00:00:00 2001 From: Yana Hontyk Date: Fri, 19 Sep 2025 13:40:50 +0200 Subject: [PATCH 1/2] Add Orca issue with Firefox, small fixes --- docs/.sphinx/.wordlist.txt | 5 ++++ .../improve-screen-reader-usability.md | 3 +++ .../accessibility/orca-preferences/index.md | 23 +++++++++++++++++-- .../orca-preferences-table-navigation.md | 2 +- .../orca-preferences-text-attributes.md | 2 +- 5 files changed, 31 insertions(+), 4 deletions(-) diff --git a/docs/.sphinx/.wordlist.txt b/docs/.sphinx/.wordlist.txt index 5dda640..d9bd817 100644 --- a/docs/.sphinx/.wordlist.txt +++ b/docs/.sphinx/.wordlist.txt @@ -35,6 +35,7 @@ balancer BAU BCD BitLocker +blockquotes BlueZ BOM bootable @@ -194,6 +195,7 @@ Linkerd linter LinuxONE Livepatch +LOL LTS LTV LVM @@ -223,6 +225,8 @@ MPA MQL MRE MSRP +multicase +MultiCaseString Multipass MyST Nagios @@ -321,6 +325,7 @@ SFDC SIP SKU SLA +sldr Snapcraft snapcrafting Snapd diff --git a/docs/how-to/troubleshoot/improve-screen-reader-usability.md b/docs/how-to/troubleshoot/improve-screen-reader-usability.md index d2509bd..ebccb22 100644 --- a/docs/how-to/troubleshoot/improve-screen-reader-usability.md +++ b/docs/how-to/troubleshoot/improve-screen-reader-usability.md @@ -71,3 +71,6 @@ If screen reader commands don't work, try pressing the key as if another relevan The Ubuntu Desktop team continues to improve the screen reader experience in each release. In Ubuntu 25.04 and 25.10, the {kbd}`CapsLock` modifier behaves more consistently, and screen reader support in GTK4 applications is enhanced. +## Enable Orca before running applications + +This issue affects Firefox and Chromium-based browsers in particular but can occur with other applications. If Orca is enabled and works in your desktop environment but does not work properly in the application, for example, it does not read web pages in your browser, try closing the application and restarting Orca *before* launching the application again. diff --git a/docs/reference/accessibility/orca-preferences/index.md b/docs/reference/accessibility/orca-preferences/index.md index 099613c..8a21a0d 100644 --- a/docs/reference/accessibility/orca-preferences/index.md +++ b/docs/reference/accessibility/orca-preferences/index.md @@ -7,11 +7,30 @@ Orca preferences can be configured globally or on the application level. Applica ## Keyboard shortcuts to open preferences dialogs -{kbd}`OrcaModifier+Space` +::::{tab-set} +:::{tab-item} Laptop layout +:sync: orca-laptop + +{kbd}`CapsLock+Space` : Open Orca's Preferences -{kbd}`Ctrl+OrcaModifier+Space` +{kbd}`Ctrl+CapsLock+Space` : Open Orca's Preferences for the current application +::: + +:::{tab-item} Desktop layout +:sync: orca-desktop + +{kbd}`Insert+Space` +: Open Orca's Preferences + +{kbd}`Ctrl+Insert+Space` +: Open Orca's Preferences for the current application +::: +:::: + + + ## General preferences and profiles diff --git a/docs/reference/accessibility/orca-preferences/orca-preferences-table-navigation.md b/docs/reference/accessibility/orca-preferences/orca-preferences-table-navigation.md index b2c546f..0f48d2f 100644 --- a/docs/reference/accessibility/orca-preferences/orca-preferences-table-navigation.md +++ b/docs/reference/accessibility/orca-preferences/orca-preferences-table-navigation.md @@ -1,6 +1,6 @@ # Table navigation preferences -The following options allow you to customize how Orca behaves when navigating within a table in applications that suppoirt Structural Naviation, see {ref}`orca-navigate-the-document-structure`. +The following options allow you to customize how Orca behaves when navigating within a table in applications that support Structural Navigation, see {ref}`orca-navigate-the-document-structure`. ## Speak cell coordinates diff --git a/docs/reference/accessibility/orca-preferences/orca-preferences-text-attributes.md b/docs/reference/accessibility/orca-preferences/orca-preferences-text-attributes.md index 4a7c8bf..ce00116 100644 --- a/docs/reference/accessibility/orca-preferences/orca-preferences-text-attributes.md +++ b/docs/reference/accessibility/orca-preferences/orca-preferences-text-attributes.md @@ -9,7 +9,7 @@ Text attributes include font, style, alignment, and other formatting features. Each row contains: - **Attribute Name:** name of the attribute -- **Speak:** whether Orca speaks it (`Orca Modifier + F`) +- **Speak:** whether Orca speaks it ({kbd}`CapsLock+F` or {kbd}`Insert+F`) - **Mark in Braille:** whether to underline the attribute in braille - **Present Unless:** condition to suppress the attribute From 21db0ec6a8005156a0201571035d19b3a87c9f22 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Such=C3=A1nek?= Date: Mon, 29 Sep 2025 11:58:16 +0200 Subject: [PATCH 2/2] Link checker exception --- docs/conf.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 43ddf30..3fdf9ca 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -223,7 +223,9 @@ linkcheck_ignore = [ "http://127.0.0.1:8000", - "https://github.com/canonical/ACME/*" + "https://github.com/canonical/ACME/*", + # The link checker tries to treat the part after # as an anchor and fails. + "https://matrix.to/#/#desktop-dev:ubuntu.com", ]