Repository navigation
Add support for custom braille translation tables #38
Description
Hi,
With nvaccess/nvda#3304 implemented (NVDA 2024.3), it becomes possible to define and include custom braille translation tables as an add-on or included with other add-ons. With this, an add-on author can ship a Liblouis compatible braille table.
The manifest format resembles nested dictionaries:
- A key named "brailleTables" houses custom braille translation tables.
- Each custom table is a key within the dictionary, with file name as the key.
- The braille table (key) entry has four fields: displayName (description), contracted (contracted (True) or uncontracted (False) braille code), input (available from input table list), output (shown in output table list).
The challenge here is allowing localized display name for braille tables - this is no longer a top-level manifest key, so manifest translation template must be edited.
Thanks (NVDA feature implementation by @LeonarddeR).
Activity
LeonarddeR commentedon May 8, 2024
Ugh, thanks for opening this. We probably should have thought about this before.
What would be your suggestion to make the display names translatable programmatically? We somehow need to store the table names in gettext strings to work correctly.
May be add a customBrailleTables.py file to the root of the template that allows you to define your custom tables, and then the build system should construct the manifest section from that file and the translated manifest should be created accordingly.
josephsl commentedon May 8, 2024
LeonarddeR commentedon May 8, 2024
I'm not sure how NVDA itself should be involved. It has been endlessly discussed that we needed a familiar way to save the meta data, and the manifest seemed to be the most obvious place. Given that the add-on template is responsible for creating manifests, it should also be able to create table entries.
A tables dictionary in buildVars makes sense. I'd support two options:
josephsl commentedon May 8, 2024
Hi,
I have implemented the second option (full manifest) to present the same feel as root manifest section a.k.a. buildVars.addon_info dictionary. The trick I am employing is that the braille tables dictionary must have at least one entry, otherwise custom braille table portion of manifest generation is skipped. I'm testing these modifications with Windows App Essentials add-on before bringing it to the template repo.
I'll release custom braille tables support as part of template 2024.2 this week and label it as experimental - full support won't be provided until NVDA Core 2024.3 beta 1 is released.
Thanks.
buildVars: add braileTables dictionary. Re #38.
SConstruct: add custom braille tables section to manifest (actual and…
Readme: document custom braille translation table manifest specificia…
SConstruct: use getattr to make sure buildVars.brailleTables is defin…
Bump actions/checkout from 6 to 7 (nvdaaddons#38)