General and Principal Logarithm Math Content Reading the Same way in ScreenReaders (needs a way to hear the difference in caps L Log vs. lower case l log).

未关闭

#112 创建于 2026年8月27日 0 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 3/5
预计耗时: 1-2 天
新手友好度: 65/100

Issue 类型: 功能
描述清晰度: 基本清楚
活跃度: 活跃
技术栈: python
领域: accessibility

调研方向

从链接的 Complex Analysis 页面中的 Definition 5.2.2 开始，追踪 MathCAT 对小写 "log" 和大写 "Log" 的发音处理。使用所报告的示例检查该行为，并确保屏幕阅读器能够通过语音听辨一般对数与主对数，即视为完成。

由索引模型根据 Issue 内容生成。

描述

go to this Complex Analysis link in the browser of your choice:
https://complexanalysis.org/web/sec_complex-log.html
Find Definition 5.2.2. Principal value of the logarithm. (Search for "principal" without quotes.) 3. Read down until you find, "The domain for the function, Log."
Problem: Screenreaders are not differentiating between lower-case "log," and upper-case "Log." They have different meanings.

In short, and you may just have to take my word for this one, log(-1), in complex analysis, has infinite answers. Not only is e^(pi i) = -1, but e to the power of any odd number multiplied by pi i, also. Saying "log(-1)" can mean any of those. The "principal logarithm" (similar to principal square root in that
context) refers to the official one accepted form for complex analysis, which, in this case, is simply "pi i." The principal logarithm is written with the word "Log," with a capital L. JAWS renders both as "log," but students need to know the difference in order to know what to write down in assignments.
Expected: MathCAT pronunciation that screen readers can use to pronounce "Log" differently from "log."

主要语言: Python
星标: 10
派生: 10
平均合并: 10 小时 40 分钟
30 天内合并 PR: 4