Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Use Nemeth Indicators to Delimit Math Content in Text

オープン
#103 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
停滞
技術スタック
python
領域
accessibility

調査の方向性

まず、MathCAT が Nemeth をレンダリングする際に NVDA Add-On がインライン数式をどのように処理するかを追跡し、次に、現在のスペーシングをこの issue で提案されているインジケーター列と比較します。完了の条件は、テキストと数式が混在する場合に指定された Nemeth の区切り記号を使用し、挙動と任意の Toggle が明確に解決されていることです。

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
Python
スター
10
フォーク
10
平均マージ
10時間 40分
マージ済み PR(30日)
4

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

daisy/MathCATForPython のほかの issue

daisy/MathCATForPython の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。