daisy / daisy/MathCATForPython

Use Nemeth Indicators to Delimit Math Content in Text

Aberta
#103 4 comentários 0 reações 0 responsáveis Ver no GitHub
enhancement
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

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.