Skip to content

ja: read brackets and absolute value in Japanese - #725

Merged
moritz-gross merged 2 commits into
daisy:jafrom
yasumorishima:ja-brackets
Aug 29, 2026
Merged

ja: read brackets and absolute value in Japanese#725
moritz-gross merged 2 commits into
daisy:jafrom
yasumorishima:ja-brackets

Conversation

@yasumorishima

Copy link
Copy Markdown
Contributor

Follows #720, #721 and #722 on the ja branch.

Brackets

The seeded wording transliterated the English cues and kept the English word order, so the closing cue was spoken before the group it closes (閉じ丸括弧, literally "close paren"). Japanese names the shape when the group opens and postposes the closing cue (Yamaguchi, Kawane and Sawazaki 1996, item 8):

open close
( ) 丸括弧 (Terse: 括弧) 丸括弧閉じ (Terse: 括弧閉じ)
[ ] 角括弧 角括弧閉じ
{ } 中括弧 中括弧閉じ

The Terse/Verbose split is the one en already has: 丸, the word for the shape, drops out in Terse exactly as "paren" does in English.

This also fixes three machine-translation slips: クローズ ブラス (from "close brace"), オープンブレイス, and 左の括弧 for {.

Absolute value

|x| was read 絶対値 の x. That is ungrammatical: Japanese attaches the other way round, so "the absolute value of x" would have to be x の絶対値. Item 1 of the same paper says not to reorder into Japanese word order, and item 8 gives the reading for |…|, so the fix is to keep the written order and drop the preposition: |x| is now 絶対値 x.

With ClearSpeak_AbsoluteValue = AbsEnd the closing cue is a closing delimiter, so it now comes after the contents instead of before them, and リリース ("release", a transliteration of "end") becomes 閉じ.

Checks

  • audit-translations ja: Rule differences unchanged at 22, untranslated 3681 to 3680. I measured the baseline on ja first, so the 22 is pre-existing and this branch does not widen the structural gap.
  • Test expectations are the actual output taken from CI rather than guesses. Added square_and_curly_brackets and absolute_value_abs_end.

Deliberately not in this PR

unicode-full.yaml has roughly 107 more bracket names in the same shape (トップ亀甲シェルブラケット and so on), and / are 左角ブラケット/直角ブラケット — the second translated the direction word "right" as "right angle". I have left that file alone because NSoiffer mentioned in #715 that MathPlayer Japanese data could seed the unicode files, and hand-editing a table that is about to be replaced seemed wasteful. Happy to do it now instead if you would rather not wait.

The seeded wording transliterated the English cues and kept the English word
order, which puts the closing cue before the group it closes.

Japanese names the shape when the group opens and postposes the closing cue
(Yamaguchi, Kawane and Sawazaki 1996, item 8):

  (  括弧 / 丸括弧      )  括弧閉じ / 丸括弧閉じ
  [  角括弧             ]  角括弧閉じ
  {  中括弧             }  中括弧閉じ

The Terse/Verbose split is kept where en has one: 丸 (the shape) drops out in
Terse the same way "paren" does in English.

Absolute value: 「絶対値 の x」 is ungrammatical because の attaches the other
way round in Japanese, so "the absolute value of x" would have to be 「x の絶対値」.
The cited reading keeps the written order and simply drops the preposition, so
|x| is 絶対値 x. With AbsEnd the closing cue moves after the contents and the
transliteration リリース ("release", from "end") becomes 閉じ.

audit-translations ja: Rule differences unchanged at 22, untranslated 3681 to 3680.
@moritz-gross

Copy link
Copy Markdown
Collaborator

looks good.
is Yamaguchi, Kawane and Sawazaki 1996 an important publication for the Japanese localization?
The title "On the Framework of Aloud-Reading System for Mathematical Expressions in Japanese" sounds fitting.

@moritz-gross
moritz-gross merged commit 4a7a477 into daisy:ja Aug 29, 2026
10 checks passed
@github-project-automation github-project-automation Bot moved this from Triage to Done in MathCAT Project Board Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants