Skip to content

Add a description of a known Orca issue with Firefox, small fixes #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 29, 2025
Merged

Add a description of a known Orca issue with Firefox, small fixes #16

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
60f1bc1
Add Orca issue with Firefox, small fixes
yhontyk Sep 19, 2025
21db0ec
Link checker exception
msuchane Sep 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/.sphinx/.wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ balancer
BAU
BCD
BitLocker
blockquotes
BlueZ
BOM
bootable
Expand Down Expand Up @@ -194,6 +195,7 @@ Linkerd
linter
LinuxONE
Livepatch
LOL
LTS
LTV
LVM
Expand Down Expand Up @@ -223,6 +225,8 @@ MPA
MQL
MRE
MSRP
multicase
MultiCaseString
Multipass
MyST
Nagios
Expand Down Expand Up @@ -321,6 +325,7 @@ SFDC
SIP
SKU
SLA
sldr
Snapcraft
snapcrafting
Snapd
Expand Down
4 changes: 3 additions & 1 deletion docs/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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",
]


Expand Down
3 changes: 3 additions & 0 deletions docs/how-to/troubleshoot/improve-screen-reader-usability.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,3 +71,6 @@

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.

Check warning on line 76 in docs/how-to/troubleshoot/improve-screen-reader-usability.md

View workflow job for this annotation

GitHub Actions / vale-style 

[vale] reported by reviewdog 🐶
[write-good.Passive] 'is enabled' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[write-good.Passive] 'is enabled' may be passive voice. Use active voice if you can.", "location": {"path": "docs/how-to/troubleshoot/improve-screen-reader-usability.md", "range": {"start": {"line": 76, "column": 117}}}, "severity": "WARNING"}
23 changes: 21 additions & 2 deletions docs/reference/accessibility/orca-preferences/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/accessibility/orca-preferences/orca-preferences-table-navigation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/accessibility/orca-preferences/orca-preferences-text-attributes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading