Add Simplified Chinese speech and navigation rules - #712
Conversation
NSoiffer
left a comment
There was a problem hiding this comment.
Thanks for for doing this!
It looks like you used AI to generate this. Have you looked through the tests and/or the unicode files to make sure the AI made the appropriate translantion? At least for other languages, it struggles to get the math terminolgy correct. For the tests, it tends to just make the expected results match the computed ones.
FYI: I changed the merge target to daisy:zh-cn (which I updated to merge).
|
Yes, a significant part of the work involved AI assistance. To ensure translation accuracy, I provided extensive reference context (as listed in the PR description, including national standards and official textbooks). I have reviewed the test cases and haven't found issues so far. However, I'd like to keep this PR as a draft for now while I double-check everything thoroughly. Once ready, I will mark it as ready for review. |
|
I'm glad to hear that you are reviewing them. AI is really helpful, and it is what we are now using to seed the speech for other languages. But most translators report that they have to change over half the strings so that the speech is what is expected. |
Summary
This PR adds a complete Simplified Chinese translation for MathCAT's speech and navigation rules.
The current English rules were used as the source, but the spoken text was rewritten in natural Mainland Mandarin rather than translated word for word. Terminology follows common usage in Mainland Chinese mathematics education.
The rules are placed directly under
Rules/Languages/zh, allowingzh-CNand similar locales to use them through MathCAT's normal locale fallback. The existing Traditional Chinese overrides underRules/Languages/zh/twremain unchanged.Coverage
The translation includes:
All 12 required language rule files are included, and verified translations use MathCAT's
T:marker.Translation choices
The wording is kept concise and follows forms familiar to students and screen reader users in Mainland China.
2 分之 1.x 的 n 次方andx 的 n 次方根.空集,属于,减去,任意,且,或, and推出.三角形,平行四边形,相似于,全等于,直角三角形, and圆 O.dot-product(a,b)is read asa 与 b 的数量积, whilecross-product(a,b)is read asa 与 b 的叉积. Ordinary infix operators remain点乘and叉乘.±and∓are read as正或负and负或正; binary operations are read as加或减and减或加.小于等于and大于等于instead of visual descriptions of the glyphs.Context-dependent symbols
Some symbols have more than one mathematical meaning and are handled according to context.
A bare
∆is read as增量, while an expression with the explicitlaplacianintent is read as拉普拉斯算子. Likewise,⊙Ois read as圆 O, while a binary expression such asa ⊙ bkeeps the generic reading带圈点运算符.Symbols such as
∼and□are not assigned a single specialized meaning where the presentation alone is insufficient to determine their use.References
Terminology and symbol readings were checked against:
Validation
The Chinese language test suite passes with 316 tests and no failures. The translation audit covers all 12 rule files and reports no missing rules or untranslated strings. The completed diff also passes whitespace validation.
Scope
This PR only adds the base Simplified Chinese rules and their tests. It does not change the existing Traditional Chinese rules, braille rules, or MathCAT engine code.