element (function)に関する用語の統一

[ultimatile]

対象ドキュメント

https://typst-jp.github.io/docs/reference/styling/

https://typst-jp.github.io/docs/reference/scripting/

など

問題

https://typst-jp.github.io/docs/reference/styling/ で"element"を「エレメント」と訳していたり、"element function"を「element関数」と訳したりしていますが、他のページでは"element function"が「要素関数」と訳されていたりと安定していません。

"element (function)"の訳語をどうするべきかご意見を伺いたいです。
私の担当範囲では「要素」と訳しています。element functionに関してはまだ担当範囲に出てきていないので訳出していません。

element functionがgrid関数やalign関数のようなものと異なるのはelementという名前の関数があるわけではないということです。
したがって「element関数」という訳語は誤解を招くと考えています。

なお、element functionに関する説明は、functionの項目に説明があり、

Element functions
Some functions are associated with elements like headings or tables. When called, these create an element of their respective kind. In contrast to normal functions, they can further be used in set rules, show rules, and selectors.

となっています。

改善案

none

貢献意思

• このIssueを解決するPull Requestの作成を自身で希望する場合はチェックしてください。

[kimushun1101]

• https://typst-jp.github.io/docs/reference/styling/ を担当したのは私でした。 reference/styling の翻訳を追加 #34 を見ると以下のように書かれています。

単語 element, fields, selector などの扱い
単語として扱うときにはカタカナ表記にして、element 関数 など連語となるときには英語表記としています。

やはり、elementやelement functionは、一般的な「要素」という意味ではなく、Typstにおける用語と捉える方がしっくりきます。
そのため、カタカナで「エレメント」と定義して訳すことをに1票入れようと思います。この考えに基づき用語集にも追加するべきと感じます。
表記ゆれに関しては、素直に「エレメント関数」と統一すればよいかと思います。

私の方でPull Requestを作成してみますが、引き続きご意見いただけますと幸いです。

[ultimatile]

今layout/gridに着手していてgrid elementとかtable elementとか出てきているのですが、これをグリッドエレメントとかテーブルエレメントとすると見慣れない表記のため若干違和感があります。一般論として、おそらく"content"を「コンテンツ」とするのは割と定着した用語の一方で、"element"は「要素」と訳すのが定着しているため違和感を感じるのだと思います。

折衷案の候補として"element function"以外の"element"を「要素」、"element function"のみをエレメント関数とするのはどうでしょうか？

個人的な感触としてはkimushun1101さんのご提案は一貫性があって良いと思うのですが、ドキュメント読者は違和感を感じる可能性があります。これまで出てきた他の訳語は一般に定着している用語が多いので、Typstの用語であることを意識せずにある程度ドキュメントの理解が可能だと思います。その一方「ほにゃららエレメント」と書かれると、初見の読者は「エレメントってなんだろう？」と考えてしまうのではないかという懸念です。

個人的な感覚な話になってしまっているので他の方の意見も伺いたいです。

[zr-tex8r]

自分は“element”はTypst特有の概念を表す「用語」だと考えていますし、また“element function”の中の“element”も「同じ用語」だと考えています。だから両者の“element”に異なる訳語を充てるのはかなり奇妙な話に思えます。

[zr-tex8r]

「“element”はTypst特有の用語だから『要素』という日常語を充てるべきでない」
という議論については私はあまり感心しません。“element”も英語の日常語のはずで、英語においてTypstの概念にその日常語を充てている以上は、日本語で同じことをやってはいけない理由がないからです。もしTypstの“element”に「要素」を充てるべきでないというのなら
「このTypstの用語は“element”の『要素』以外の意味に由来している」
という議論が欲しいところです。

@ultimatile さんはむしろ
「この“element”は『要素』という意味に由来している（文書を構成する『要素』なんだから）のでその方が理解されやすい」
と主張しているようにみえます。

自分はどうかというと
「Typstの“element”はHTMLの“element”に類似した概念で、HTMLの“element”については『要素』の訳語が定着しているから、『要素』の方が自然に感じられる」
という感じです。

[ultimatile]

コメントありがとうございます。いくつか補足的なコメントをすると、

両者の“element”に異なる訳語を充てるのはかなり奇妙な話

これに関しては同じ用語に異なる訳語を充てるのは変というのはおっしゃる通りだと思います。
ここで異なる訳語を充てた理由は、"element"に一貫して「要素」を充てると"element function"は「要素関数」となりますが、「要素関数」と"element function"を異なる文脈で見たときに同一のものとは気が付かないのではないか？という懸念があったためです。
これは杞憂で、ご指摘のとおり訳語の一貫性の原則から考えても、「要素関数」としても問題ないのかもしれません。

HTMLの“element”に類似した概念で、HTMLの“element”については『要素』の訳語が定着している

これに関しては蛇足的な補足となりますが、私もHTMLの「要素」というのは念頭にありましたが、ドキュメント読者は必ずしもHTMLに明るいわけではないという観点から、一般用語的視点で「要素」の方が理解しやすいのではないか、という主張になっています。

[kimushun1101]

お返事おそくなりすみません。
「エレメント」としたい強いこだわりはなく、決めの問題だと思っています。
「要素」とするなら「要素関数」と統一した方がいいかなと思います。（これも強い信念があるわけではなく感覚です。）

#200 は完成形があったほうがイメージがつきやすかったり、議論がしやすかったりするかと思い作成したものになります。
#200 は残しつつ、「要素」と「要素関数」と統一したプルリクエストを作成しますね。その間に他の案が出ていただいても構いませんし、解決したら不要なプルリクエストはクローズの形で片付ける予定です。

[kimushun1101]

コミットでswitchすればブランチ一本でも済みますが、愚直にプルリクエストを2本作ってみました。

• fix: elementの訳出を「エレメント」に統一 #200 (ブランチはfix/element)
• fix: elementの訳出を「要素」に統一 #203 (ブランチはfix/element-yoso)

[3w36zj6]

HTMLは組版手法として最も一般的で広く知られており、Typstも同様に組版ツールであることから、HTMLで"element(s)"の訳語が「要素」として定着している以上、Typstにおいても「要素」と呼ぶのが合理的だと思います。

また、W3Cの日本語組版処理の要件（JLReq）においても、"element(s)"は一貫して「要素」と訳されています¹。

Footnotes

1. https://www.w3.org/TR/jlreq/ ↩

[kimushun1101]

ご意見ありがとうございます。

これまで特に定義づけをせずに翻訳を進めていたところ、「要素」と訳していた方が圧倒的に多く、 #203 の方でもapproveを頂いておりますため、「要素」という訳で進めようと思います。また進めていく中でよりよい考え方があれば遠慮なくご提案ください。

[ultimatile]

みなさま、コメントありがとうございました。
本issueで、原則として用語はHTMLで定着しているものを尊重するという方針が明確になったかと思いますが、TRANSLATING_GUIDELINES.mdにその旨を追記した方が良いと思います。

関連して、HTMLおよびCSSに関する日本語の参照用の資料として

HTMLに関しては: https://momdo.github.io/html/
CSSに関しては: https://developer.mozilla.org/ja/docs/Web/CSS

を見つけました。他に推奨されるものがあればご教示いただきたいです。