Skip to content
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.

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

Use Nemeth Indicators to Delimit Math Content in Text #326

Open
NV-Codes opened this issue Dec 30, 2024 · 2 comments
Open

Use Nemeth Indicators to Delimit Math Content in Text #326

NV-Codes opened this issue Dec 30, 2024 · 2 comments

Comments

@NV-Codes
Copy link

NV-Codes commented Dec 30, 2024

MathCAT Version

MathCAT-0.6.6 (NVDA Add-On)

Current Behavior

When MathCAT encounters in-line math content and is set to render math as Nemeth, it inserts one space before the math and two spaces afterward to distinguish it from the surrounding text.

Proposed Change

Nemeth indicators would likely serve as better delimiters. Benefits include

  • a more natural rendering of mixed content (text interspersed with math), since that is how such content would be brailled physically.
  • more conspicuous indication of code switching (especially useful in STEM documents).
  • easier identification of symbols (e.g., punctuation) directly following math content, as the Nemeth indicators occupy the full height of the cells they use.
  • the ability (at least in theory) to use NVDA's braille output as (nearly) embosser-ready Unicode braille (since the standard is to use Nemeth indicators in UEB documents with Nemeth math content).

Perhaps an option could be given to toggle this behavior if desired.

Comparison

Mixed-Content Statement

In this case, $y$ is proportional to $x^2$.

Current Nemeth Output (Unicode)

⠠⠔⠀⠹⠀⠉⠁⠎⠑⠂⠀⠀⠰⠽⠀⠀⠀⠊⠎⠀⠏⠗⠕⠏⠕⠗⠰⠝⠁⠇⠀⠞⠕⠀⠀⠭⠘⠆⠀⠀⠲

Proposed Nemeth Output (Unicode)

⠠⠔⠀⠹⠀⠉⠁⠎⠑⠂⠀⠸⠩⠀⠽⠀⠸⠱⠀⠊⠎⠀⠏⠗⠕⠏⠕⠗⠰⠝⠁⠇⠀⠞⠕⠀⠸⠩⠀⠭⠘⠆⠀⠸⠱⠲

If Nemeth indicators were adopted, then the grade 1 symbol indicator would not be necessary before the $y$.

@NSoiffer
Copy link
Owner

NSoiffer commented Jan 1, 2025

MathCAT deliberately does not include the Nemeth indicators. That is left to the code that calls MathCAT. Nemeth code is used in contexts beyond UEB and so the start/end indicators will likely differ.

It sounds like maybe a modification to NVDA is what is needed to optimize certain cases. Is that correct? If so, please file an NVDA issue with details on what should be changed.

I'll leave this open for now in case I have misunderstood what you are asking for.

@NV-Codes
Copy link
Author

NV-Codes commented Jan 2, 2025

Yes, delimiters depend on the surrounding code and the math code itself as well. It seems that whichever module would handle delimiters where appropriate would have to be aware of the surrounding code (handled by NVDA) and the math code (handled by MathCAT) in use. Since there are so many possible combinations of codes, perhaps it is best not to include the delimiters.

Is there a reason for one preceding space and two trailing spaces?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants