daisy / daisy/MathCATForPython
Use Nemeth Indicators to Delimit Math Content in Text
- Linguagem predominante
- Python
- Estrelas
- 10
- Forks
- 10
- Merge médio
- 10h 40min
- PRs com merge (30d)
- 4
Descrição
## 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](https://nemeth.aphtech.org/lesson3.8) 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$.
Guia de contribuição
Nenhum guia de contribuição indexado para este repositório
Direção de pesquisa
Comece rastreando como o NVDA Add-On lida com matemática inline quando o MathCAT renderiza Nemeth e, em seguida, compare o espaçamento atual com as sequências de indicadores propostas nesta issue. O trabalho deve ser considerado concluído quando texto e matemática combinados usarem os delimitadores Nemeth especificados, e o comportamento e qualquer Toggle opcional estiverem claramente resolvidos.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- python
- Domínio
- accessibility
- Tipo de issue
- Funcionalidade
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Status de atividade
- Estagnada
- Clareza
- Razoavelmente clara
- Facilidade para iniciantes
- 35/100