NVDA Community Addons/ addons/ MathCAT  (28%)

MathCAT

  • Forfatter: Neil Soiffer
  • NVDA compatibility: 2018.1 or later (untested in earlier versions)
  • Download stabil version

MathCAT is designed to eventually replace MathPlayer because MathPlayer is no longer supported. MathCAT generates speech and braille from MathML. The speech for math produced by MathCAT is enhanced with prosody so that it sounds more natural. The speech can be navigated in three modes using the same commands as MathPlayer. In addition, the navigation node is indicated on a braille display. Both Nemeth and UEB technical are supported.

MathCAT har en række konfigurationsmuligheder, der styrer tale, navigation og punkt. Mange af disse kan indstilles i MathCAT-indstillingsdialogen (findes i meNVDA-menuen>Opsætning). For mere information om disse indstillinger, læs MathCAT-dokumentationen. Dokumentationen indeholder et link til en tabel med alle navigationskommandoer i MathCAT.

Bemærk: MathCAT er et generelt bibliotek til generering af tale og punkt fra MathML. Dette bruges af andre lignende projekter udover NVDA. For information om MathCAT-projektet, se MathCAT-dokumentationssiden.

Hvem bør bruge MathCAT:

  • Dem, der har brug for Nemeth-braille af høj kvalitet (MathPlayers Nemeth er baseret på liblouis' Nemeth-generation, som har en række væsentlige fejl, som er teknisk svære at rette).
  • Those who need UEB technical braille, CMU (Spanish/Portuguese), German LaTeX, ASCIIMath, or Vietnamese braille
  • Dem, der ønsker at prøve den nyeste teknologi og er villige til at hjælpe ved at rapportere fejl
  • Dem, der bruger Eloquence som stemme

Hvem bør IKKE bruge MathCAT:

  • Anyone who uses MathPlayer with a language that is not yet supported by MathCAT (translations exist for Chinese (Traditional), Spanish, Indonesian and Vietnamese; translations will be coming in the future) and are not comfortable with speech in one of the supported languages.
  • Enhver, der foretrækker Access8Math frem for MathPlayer (til tale eller andre funktioner)

MathCATs regler for tale er endnu ikke så omfattende som MathPlayers regler - det kan være endnu en grund til at holde sig til MathPlayer. MathCAT bliver brugt som et testbed for ideer til MathML 4, der gør det muligt for forfattere at udtrykke deres hensigt, så tvetydige notationer kan læses korrekt og ikke gættes på. Jeg har holdt op med at tilføje for mange regler, da arkitekturen i MathCAT er centreret omkring brug og udledning af forfatterens hensigt, og disse er ikke helt afklarede endnu.

MathCAT Update Log

Version 0.6.3

  • All the language and braille Rule files are zipped up per directory and unzipped on demand.

    • This currently saves ~5mb when Rules.zip is unzipped, and will save even more as more languages and braille codes are added.
    • This is in preparation for MathCAT being built into NVDA 2024.3

  • Added new preference DecimalSeparator.

    • The default value is Auto, with other values being ".", ",", and "Custom". The first three values set DecimalSeparators and BlockSeparators.
    • Auto sets those preferences based on the value of the Language pref. For some language such as Spanish, , is used in some countries and . is used in others. In this case, it is best to set the language to also include the country code (e.g, es-es or es-mx) to ensure the right value is used.

  • Added Swedish to supported languages.

  • Added more Unicode chars to include both all Unicode chars marked as "Sm" and those with a mathclass (except Alphabetic and Glyph classes) in the Unicode standard.
  • After changing how prefs work in a previous version, I forgot to change MathRate and PauseFactor to be numbers, not strings.
  • Fixed bug in the braille Rules (missed change from earlier) where a third argument should have been given to say to look in the Braille definitions.yaml files and not the speech ones when looking up the value of a definition.
  • Cleaned up use of definitions.yaml.
  • Fixed some bugs in the MathML cleanup for "," decimal separators.
  • Found a bug in braille highlighting when nothing is highlighted (maybe never happens which is why I didn't see it in practice?)
  • Fixed "Describe" mode so that it works -- it is still very minimal and probably not useful yet
  • Fixed minimum supported version

Version 0.5.6

  • Added Copy As... to the MathCAT dialog (in the "Navagation" pane).
  • Fixed a bug where the language reverted to English when changing speech styles.
  • Fixed a bug with navigation and braille
  • Fixed some Asciimath spacing problems.
  • Improved chemistry recognition
  • Updated MathCAT to new BANA Nemeth chemistry spec (still only single line and special case style/font changes not handled)
  • Fix a crash when non-ASCII digits (e.g., bold digits) are used in numbers
  • Don't use italic indicators in braille codes when the math alphanumeric italic chars are used
  • Some other smaller bug fixes that weren't reported by users

Version 0.5.0

  • Added German LaTeX braille code. Unlike other braille codes, this generates ASCII chars and uses the current braille output table to translate the characters to braille.
  • Added (expermental) ASCIIMath braille code. Like the LaTeX braille code, this generates ASCII chars and uses the current braille output table to translate the characters to braille.
  • Added "CopyAs" preference that supports copying as MathML, LaTeX, or ASCIIMath using cntl+C when focused on MathML (as before). The currently focused node is copied. Note: this is only listed in the prefs.yaml file and is not exposed (yet) in the MathCAT Preferences dialog.

Version 0.4.2

  • Fixed language switching when voice changes and MathCAT language is "Auto"
  • Added more checks for $Impairments to improve reading when it is not set for those who are blind
  • Nemeth: fix for "~" when it isn't part of an mrow
  • UEB: character additions, "~" spacing fix if prefix, xor fix,
  • MathML cleanup for accented vowels (mainly for Vietnamese)
  • Major rewrite of preference reading/updating code with big speedup -- added CheckRuleFiles pref to control which files are checked for updates
  • Added two new interface calls -- enables setting the navigaton location from the braille cursor (not part of MathCAT addon yet)

Version 0.3.11

  • Upgraded to python 3.11 and verified working with NVDA 2024.1
  • Fix bugs in Vietnamese braille and also in Speech, mostly for chemistry.
  • Fix broken braille when braille code and dependent language don't match (specifically Vietnam braille and Vietnamese speech)
  • Fix whitespace bug in HTML inside of tokens
  • Improve roman numeral detection

Version 0.3.9

  • Added Traditional Chinese translation (thanks to Hon-Jang Yang)
  • Fixed bug with navigating into the base of a scripted expression that has parenthesis
  • Significantly changed the way whitespace is handled. This mainly affects braille output (spaces and "omission" detection).
  • Improved recognition of chemistry
  • UEB braille fixes that came up from adding chemistry examples
  • UEB fixes for adding auxillary parenthesis in some cases

Version 0.3.8

Braille:

  • Dialog has been internationalized for several languages (many thanks to the translators!)
  • Initial implementation of CMU -- the braille code used in Spanish and Portuguese speaking countries
  • Fix some UEB bugs and added some characters for UEB
  • Significant improvements to Vietnamese braille

Other fixes:

  • Change relative rate dialog slider to have a maximum value of 100% (now only allows setting slower rates). Also, added step sizes so it is easier to raise/lower the rate significantly.
  • Fix eSpeak bug that sometimes cut off speech when the relative rate was changed
  • Improvements to Vietnamese speech
  • Fixed bug with OneCore voices saying "a"
  • Fixed some navigation bugs when AutoZoomOut is False (not the default)
  • Fix updating around language changes and some other dialog changes so they take effect immediately upon clicking "Apply" or "OK".
  • Added an "Use Voice's Language" option so that out of the box, MathCAT will speak in the right language (if there is a translation)
  • Several improvements for cleaning up poor MathML code

Version 0.3.3

Denne udgivelse indeholder en række fejlrettelser. De vigtigste nye funktioner og fejlrettelser er:

  • Added Spanish Translation (thanks to Noelia Ruiz and María Allo Roldán)
  • Ændret navigation, så den begynder at zoome i ét niveau
  • Tilføjet cntrl+alt+pil som en måde at navigere i tabelstrukturer på. Disse taster burde være mere mindeværdige, fordi de bruges til tabelnavigation i NVDA.
  • Virkede uden om NVDA-fejl for eSpeak-stemmer, der fik dem til at sænke farten, når den relative MathRate var indstillet til at være langsommere end teksttalehastigheden.
  • Arbejdet med et OneCore-stemmeproblem, så de vil sige den lange 'a'-lyd.

Der er masser af små justeringer af talen og nogle fejlrettelser til både Nemeth og UEB.

Bemærk: der er nu en mulighed for at få Vietnams braillestandard som brailleoutput. Dette er stadig et igangværende arbejde og er for buggy til at blive brugt andet end til test. Jeg forventer, at den næste MathCAT-udgivelse vil indeholde en pålidelig implementering.

Version 0.2.5

  • Flere forbedringer kemi

  • Rettelser til Nemeth:

    • Added "omission" rules
    • Added some rules for English Language Indicators
    • Added more cases where the Mulitpurpose indicator is needed
    • Fixes related to Nemeth and punctuation

Version 0.2

  • Masser af fejlrettelser
  • Forbedringer af tale
  • En præferenceindstilling til at kontrollere varigheden af pause (fungerer med ændringer af relativ talehastighed for matematik)
  • Støtte til at genkende keminotation og tale den korrekt
  • Oversættelser til indonesisk og vietnamesisk