Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Use Nemeth Indicators to Delimit Math Content in Text

Offen
#103 4 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
35/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Tech-Stack
python
Bereich
accessibility

Rechercherichtung

Beginne damit nachzuverfolgen, wie das NVDA Add-On Inline-Mathematik verarbeitet, wenn MathCAT Nemeth rendert, und vergleiche dann den aktuellen Abstand mit den in diesem Issue vorgeschlagenen Indikatorsequenzen. Als abgeschlossen sollte gelten, dass gemischter Text und Mathematik die angegebenen Nemeth-Begrenzer verwenden und das Verhalten sowie ein etwaiger optionaler Toggle eindeutig geklärt sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

enhancement

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$.

Vorherrschende Sprache
Python
Sterne
10
Forks
10
Ø Merge
10 Std. 40 Min.
Gemergte PRs (30 T.)
4

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus daisy/MathCATForPython

Alle Issues in daisy/MathCATForPython

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.