fundations/calcの翻訳

[sbtseiji]

Calculationを翻訳しました。

[Copilot]

Pull Request Overview

This PR translates the calc module documentation and comments from English to Japanese.

• Translates all function documentation comments and parameter descriptions
• Updates module comments for mathematical functions
• Updates translation status to mark calc module as translated

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
website/translation-status.json	Updates calc module status from "untranslated" to "translated"
crates/typst-library/src/foundations/calc.rs	Translates all documentation comments and parameter descriptions for mathematical functions

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[ultimatile]

calcの最初の説明文とbinomのkが未翻訳です。

[sbtseiji]

ありがとうございます。最初の説明文は別のファイルになっていたのですね。そちらの訳、および訳漏れ箇所の翻訳を追加しました。

[ultimatile]

対応ありがとうございます。

私はnon-negativeは非負と訳すことに馴染みがあるのですが、みなさんはどうですかね？

[ultimatile]

あと、ソース中のコメントにあるものの中でドキュメントに表示されるコメントと、そうでないものがあります。大雑把にはpublicになっている関数が表示されるのですが、publicであったとしてもドキュメントに表示されない、あるいは別の場所に表示されるものがありますので、mise run generate && mise run previewで翻訳が行った部分と表示の変化がどう対応するのかは逐次確認しながら作業することをお勧めします。

[3w36zj6]

値を表す「-1」は許容されてほしいので、false positiveな気がします。

Run bun run --bun textlint-html
$ textlint ./website/typst-docs-web/dist/

/home/runner/work/docs/docs/website/typst-docs-web/dist/reference/foundations/calc/index.html
  44:6472  error  原則として和文ではハイフン(-)を使用しません。
例外は、住所や電話番号の区切りに使う場合です。  jtf-style/4.2.6.ハイフン(-)
  46:6473  error  原則として和文ではハイフン(-)を使用しません。
例外は、住所や電話番号の区切りに使う場合です。  jtf-style/4.2.6.ハイフン(-)

✖ 2 problems (2 errors, 0 warnings, 0 infos)

error: script "textlint-html" exited with code 1
Error: Process completed with exit code 1.

https://github.com/textlint-ja/textlint-rule-preset-JTF-style/blob/master/test/4.2.6-test.js

このエラーは一旦無視してください。

[kimushun1101]

内容の多いページの翻訳ありがとうございます。コメントを入れさせていただきました。

[kimushun1101]

原文にPull Requestしたほうが良いかもしれませんが、ちょっと誤解を招きそうな表現ですね。
#calc.round(3.4)は3になり、#calc.round(3.5)は4になるため、普通に四捨五入の処理だと思うのですが。
#calc.round(3.4)が3と4では0から離れるのは4であるため、この表現だと（正の数では）切り上げられるイメージを持ちました。

解釈のご助言があればお願いしたいです。

[sbtseiji]

コメントありがとうございます。原文の意味では「切り上げ」ですね。実際には四捨五入されているのであれば、原文の表現が適切でない（「away frm zero」はない方が正しい）と言うことになります。この場合、ひとまず邦訳は「四捨五入します」としておくのがよいでしょうか。

[3w36zj6]

原文の表現が紛らわしい気がするので、「round half away from zero」と明記するか、「Rounds a number to the nearest integer, with halfway cases (e.g., 0.5, -0.5) rounded away from zero.」のような説明に変更する提案をすると良いと思います。

[kimushun1101]

ひとまず邦訳は「四捨五入します」としておくのがよいでしょうか。

私はよいと思います。 @3w36zj6 さんはどう思いますか？
バージョンアップの際に更新されると思うのですが、コンフリクト処理は面倒になったりしますでしょうか？

本家へのプルリクエストは @sbtseiji さんから行ってみますか？もし面倒であれば私の方から行っても構いませんのでご指定ください。

[3w36zj6]

上流が修正される前提で「四捨五入します」として問題ないです。マージコミットの作成時には正式に採用された文章をもとに再度検討します。

[sbtseiji]

和訳の方は「四捨五入します」にしておきます。Gitの作業についてはあまり慣れていませんので、本家へのプルリクエストについては、@kimushun1101 様にお願いできるとありがたいです。