Vue 3公式ドキュメント翻訳

[kazupon]

ようこそ、Vue.js 公式ドキュメント翻訳へ、そしてありがとうございます！

この discussion は、先日 2/7 に公開された Vue 3 公式ドキュメントの翻訳をしたい人方向けの入り口となるサポートページです。
翻訳されたい方は、翻訳ガイドラインを一度一読し、以降にある翻訳対象まとめissuesからたどって翻訳をお願いします！

何か分からないことがありましたら、気軽にこの discussion にコメントください。

Vue.js 公式サイト日本語翻訳ガイド

翻訳する上でかかせないガイドラインです。
https://github.com/vuejs-translations/docs-ja/blob/main/.github/CONTRIBUTING.md

翻訳対象まとめ issues

Vue.js 3 公式ドキュメントのカテゴライズした issue です。下記 issue リンク先には、Vue.js 公式ドキュメントのセクション単位 (1 markdown) でさらに issue リスト化されています。その中から翻訳したいところを選んで翻訳お願いします！

• Guide 翻訳まとめ (total: 51 markdown files) #6
• API 翻訳まとめ (total: 25 markdown files) #84
• Tutorial 翻訳まとめ (total: 15 markdown files) #100
• その他 翻訳まとめ（Style Guide, About, Ecosystem, Sponsor） #114

[naokie]

文末に出てくる「:」に疑問を持ったことはありませんか？
Vue.js のドキュメントでは、次の文（コードサンプルが多いです）にかかる意味で多用されているため、意味のある約物として原文を尊重しています。

[naokie]

TypeScript 対応のため増えている日本語・英語どちらの単語を使おうといった例を 用字、用語 に増やしました。

[yamanoku]

the latest standards

について「最新の標準」なのか「最新の規格」として訳そうか悩んでいます。

docs-ja/src/guide/extras/web-components.md

Line 251 in 06fd0cd

Vue will always be staying up to date with the latest standards in the web platform, and we will happily leverage whatever the platform provides if it makes our job easier. However, our goal is to provide solutions that work well and work today. That means we have to incorporate new platform features with a critical mindset - and that involves filling the gaps where the standards fall short while that is still the case.

[naokie]

ちょっと難しいですよね。
個人的に思うところありますので、参考までに。

単数形の「standard」に対応する「標準」という意味が考えのベースになると思います。
しかし、複数形になったときには一般的に「規格、基準」という訳が工業製品まわりに多い気がしています。
ところが Web 界隈では「Web Standards」を「ウェブ標準」という訳で出回ってしまっていて、この文で言うところも「標準化団体が定めている仕様の最新ウェブ標準」を指しているので、これに合わせるのがよいと思います。

参考: https://ja.wikipedia.org/wiki/%E3%82%A6%E3%82%A7%E3%83%96%E6%A8%99%E6%BA%96

[yamanoku]

ありがとうございます！
自分も「標準」が染み付いちゃってるのでそちらのが自然な方が読みやすいかな…

[jay-es]

前回、コンポーザブルのページで、"composable function" → コンポーザブル関数としましたが、
Reactivity Transform のページ翻訳で "composition function" というのが出てきて少し悩んでいます。

いきなり「合成関数」としても伝わらなそうですし「コンポジション関数」あたりでよいでしょうか？

[jay-es]

（"composable", "composable function" については用語集に追加しておきます）

[naokie]

むむむ、難しいですね

「合成関数」という用語は一般的に数学で使われていて、対応する英語は「composite [compound] function」のようです。
数学方面に疎いので詳細がわかりませんが、指すところの意味が違うなら、すでにある用語なので避けるべきものではあると思います。

また、Composition API / Options API は対比するものとして、英語をそのままにしています。
Composition API が v3 における新しいものなので、英語のまま or カタカナ（英語併記）にして、馴染むまで置いとくのがよさそうですね。

[jay-es]

"ref" を「参照」と翻訳しているケースが多いですが、ref() の変数を指している場合は 「ref」のままがよいと思い、レビューでもそのように直してもらっています。
（例: ref のオブジェクト、など）

こちら認識問題なければ用語集に追加してもOKでしょうか？

[naokie]

まさにそのとおりですね 👍🏼

[kazupon]

自分もそれでいいと思います！