Skip to content

Add options to set translation and input braille tables according to NVDA's language#17314

Merged
seanbudd merged 26 commits into
nvaccess:masterfrom
nvdaes:autoBrailleLang
Nov 4, 2024
Merged

Add options to set translation and input braille tables according to NVDA's language#17314
seanbudd merged 26 commits into
nvaccess:masterfrom
nvdaes:autoBrailleLang

Conversation

@nvdaes

@nvdaes nvdaes commented Oct 21, 2024

Copy link
Copy Markdown
Collaborator

Link to issue number:

Fixes issue #17306

Summary of the issue:

By default, NVDA sets braille tables according to its language. When NVDA's language is changed, by default braille tables are modified accordingly, which may be confusing for users.

Description of user facing changes

In the Braille settings panel, combo boxes for tables have an option to set them according to NVDA's language, so that now this is optional. The automatically selected tables corresponding to the current language are described in parentheses.

Description of development approach

New options have been added to the Braille settings panel. braille, brailleInput and brailleTables modules have been modified so that the "auto" option in configuration can be optional.

Testing strategy:

Tested manually checking that options are presented in the gui and that braille tables are set accordingly.

Known issues with pull request:

None

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

@coderabbitai summary

@seanbudd seanbudd added the conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review. label Oct 21, 2024
@AppVeyorBot

Copy link
Copy Markdown
  • PASS: Translation comments check.
  • PASS: License check.
  • FAIL: Unit tests. See test results for more information.
  • PASS: Lint check.
  • PASS: System tests (tags: installer NVDA).
  • Build (for testing PR): https://ci.appveyor.com/api/buildjobs/ni6nakjd3v9bh12e/artifacts/output/l10nUtil.exe nvda_snapshot_pr17314-34386,0d25bc42.exe
  • CI timing (mins):
    INIT 0.0,
    INSTALL_START 1.5,
    INSTALL_END 1.0,
    BUILD_START 0.0,
    BUILD_END 29.7,
    TESTSETUP_START 0.0,
    TESTSETUP_END 0.4,
    TEST_START 0.0,
    TEST_END 19.1,
    FINISH_END 0.2

See test results for failed build of commit 0d25bc42d7

@LeonarddeR LeonarddeR left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like this a lot!

Comment thread source/braille.py Outdated
Comment thread source/brailleInput.py Outdated
Comment thread source/gui/settingsDialogs.py Outdated
Comment thread source/gui/settingsDialogs.py Outdated
Comment thread source/gui/settingsDialogs.py Outdated
@nvdaes nvdaes changed the title Set auto for output table Add options to set translation and input braille tables according to NVDA's language Oct 22, 2024
Co-authored-by: Leonard de Ruijter <3049216+LeonarddeR@users.noreply.github.com>
@AppVeyorBot

Copy link
Copy Markdown

See test results for failed build of commit 4a72f93aeb

@nvdaes

nvdaes commented Oct 22, 2024

Copy link
Copy Markdown
Collaborator Author

@LeonarddeR , thanks for your review!
I don't understand well the suggestion about tableName. And I get this error.

 if table != self._table.fileName:                                                                                   
   ^^^^^                                                                                                            

UnboundLocalError: cannot access local variable 'table' where it is not associated with a value

Perhaps we should revert this suggestion?
Not sure.

@nvdaes

nvdaes commented Oct 23, 2024

Copy link
Copy Markdown
Collaborator Author

I assumed that @LeonarddeR suggestion was complete, but now I've committed a fix and this should be ready.

@nvdaes

nvdaes commented Oct 23, 2024

Copy link
Copy Markdown
Collaborator Author

pre-commit.ci run.

@nvdaes nvdaes marked this pull request as ready for review October 23, 2024 07:04
@nvdaes nvdaes requested review from a team as code owners October 23, 2024 07:04

@Qchristensen Qchristensen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good and will be a welcome improvement for users.

@nvdaes

nvdaes commented Oct 23, 2024

Copy link
Copy Markdown
Collaborator Author

Thanks Quentin.

@LeonarddeR LeonarddeR left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just small things, feel free to ignore them if you think your code is more appropriate.

Comment thread source/braille.py
Comment thread source/brailleInput.py

@seanbudd seanbudd left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you respond to @LeonarddeR's comments? Thanks

Comment thread user_docs/en/changes.md Outdated

@Qchristensen Qchristensen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good pickups on those last couple of comments on the docs changes.

@nvdaes

nvdaes commented Nov 4, 2024

Copy link
Copy Markdown
Collaborator Author

@LeonarddeR , I tried to use your suggestions in the code, but if I didn't implement them is because they diedn't work as expected.
I trust you a lot and I always try to use your suggestions. I think we can use the current code, unless someone disagrees.

nvdaes and others added 2 commits November 4, 2024 06:20
Co-authored-by: Sean Budd <seanbudd123@gmail.com>
@nvdaes

nvdaes commented Nov 4, 2024

Copy link
Copy Markdown
Collaborator Author

I've accepted the last suggestion and I think that, when checks pass, it will be ready for review again.

Comment thread user_docs/en/changes.md
@seanbudd seanbudd merged commit f99a457 into nvaccess:master Nov 4, 2024
@github-actions github-actions Bot added this to the 2025.1 milestone Nov 4, 2024
@LeonarddeR

Copy link
Copy Markdown
Collaborator

It was not at all important, thanks a lot for implementing/fixing this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add an option to preserve configured braille tables when changing NVDA's language

5 participants