Advanced Guides > Compotion API > Introduction の翻訳 #101

saitolume · 2020-10-06T09:06:06Z

resolve #32

Description of Problem

https://v3.vuejs.org/guide/composition-api-introduction.html の翻訳を行ったのでレビューをお願いします。

Additional Information

作業に時間がかかったためご迷惑をおかけしてしまい、申し訳ありません。
いくつか悩んだ箇所があるので共有させていただきます。

a presumedly external API: 「おそらく外部 API」や「外部 API のようなもの」は違和感があったため「適当な外部 API」にしました。←「外部 API など」でも良かった気がしました。
the drill (L482): 「ドリル」は違和感があったため文脈に合わせて「ノウハウ」にしました。

netlify · 2020-10-06T09:08:35Z

Deploy preview for vuejs-v3-ja-doc-preview ready!

Built with commit 1d3ecc4

https://deploy-preview-101--vuejs-v3-ja-doc-preview.netlify.app

kazupon

レビュー 👀 コメント 💬 しました！
翻訳内容はほぼ大丈夫です。
細かい部分コメントしていますが、対応よろしくお願いします！

kazupon · 2020-10-06T15:00:09Z

src/guide/composition-api-introduction.md


-Such fragmentation is what makes it difficult to understand and maintain a complex component. The separation of options obscures the underlying logical concerns. In addition, when working on a single logical concern, we have to constantly "jump" around option blocks for the relevant code.
+このような分離は、複雑なコンポーネントを理解ししてメンテナンスすることを難しくします。このオプションの分離は背景にある論理的な関心事をわかりづらくします。さらに、単一の論理的な関心事に取り組む場合、関連するコードのオプションブロックを何度も "ジャンプ" する必要があります。


typo の修正お願いします。 🙏

Suggested change

このような分離は、複雑なコンポーネントを理解ししてメンテナンスすることを難しくします。このオプションの分離は背景にある論理的な関心事をわかりづらくします。さらに、単一の論理的な関心事に取り組む場合、関連するコードのオプションブロックを何度も "ジャンプ" する必要があります。

このような分離は、複雑なコンポーネントを理解してメンテナンスすることを難しくします。このオプションの分離は背景にある論理的な関心事をわかりづらくします。さらに、単一の論理的な関心事に取り組む場合、関連するコードのオプションブロックを何度も "ジャンプ" する必要があります。

kazupon · 2020-10-06T15:04:18Z

src/guide/composition-api-introduction.md


-Let’s add `setup` to our component:
+`setup` をコンポーネントに追加しましょう:


正しい訳ですが、文章の流れが自然になるように、以下でお願いします！ 🙏

Suggested change

`setup` をコンポーネントに追加しましょう:

`setup` をコンポーネントに追加してみましょう:

kazupon · 2020-10-06T15:08:38Z

src/guide/composition-api-introduction.md

@@ -87,27 +87,27 @@ export default {
  setup(props) {
    console.log(props) // { user: '' }

-    return {} // anything returned here will be available for the rest of the component
+    return {} // ここで返されるものは残りの要素で使用可能です


the rest of the component の訳ですが、"rest` はコンポーネントオプションのことを示しているので、以下のような訳でどうでしょうか。
こちらの方が分かりやすいかと思います。他にいい訳があれば、お願いします！

Suggested change

return {} // ここで返されるものは残りの要素で使用可能です

return {} // ここで返されるものはコンポーネントで他のオプションで使用可能です

「ここで返されるものはコンポーネント "の" 他のオプションで使用可能です」のほうが日本語として自然な気がしました！

そうですね。それでいきましょう！

kazupon · 2020-10-06T15:10:54Z

src/guide/composition-api-introduction.md

  }
-  // the "rest" of the component
+  // 残りの要素


少し原文自体がよくない感じなのですが、ここのコメントはコンポーネントの他のオプションのこと示しているので、以下の訳でどうでしょうか。

Suggested change

// 残りの要素

// 以降、コンポーネントの"他"のオプション

kazupon · 2020-10-06T15:16:11Z

src/guide/composition-api-introduction.md


-Let’s add it to our `setup` function:
+それを `setup` 関数に追加しましょう:


前の文章の流れから、以下のように意訳気味ではどうでしょう。

Suggested change

それを `setup` 関数に追加しましょう:

では、`setup` 関数にそれを追加してみましょう:

potato4d

Pull Request ありがとうございます！

いくつか nits をコメントしました 📝
主に読みやすさの観点です。

potato4d · 2020-10-06T15:42:34Z

src/guide/composition-api-introduction.md


-**Here’s a quick look at how it works.**
+**その仕組をざっと見てみましょう。**


Suggested change

**その仕組をざっと見てみましょう。**

**その仕組みをざっと見てみましょう。**

[nits] こちらのほうがより一般的かもしれません。

potato4d · 2020-10-06T15:48:08Z

src/guide/composition-api-introduction.md


-Just like how we set up a watcher on the `user` property inside our component using the `watch` option, we can do the same using the `watch` function imported from Vue. It accepts 3 arguments:
+コンポーネント内の `user` プロパティに `watch` オプションを使用してウォッチャを追加するのと同じように、Vue からインポートした `watch` 関数を使用することができます。それは 3 つの引数を受け付けます:


Suggested change

コンポーネント内の `user` プロパティに `watch` オプションを使用してウォッチャを追加するのと同じように、Vue からインポートした `watch` 関数を使用することができます。それは 3 つの引数を受け付けます:

コンポーネント内の `user` プロパティに `watch` オプションを使用してウォッチャを追加するのと同じように、Vue からインポートした `watch` 関数を使用することができます。それは以下の 3 つの引数を受け付けます:

日本語訳の読みやすさの面で、 以下の をつけると良いかもしれません

potato4d · 2020-10-06T15:50:07Z

src/guide/composition-api-introduction.md

@@ -388,7 +388,7 @@ setup (props) {
 }
 ```

-We could do the same for other **logical concerns** but you might be already asking the question – _Isn’t this just moving the code to the `setup` option and making it extremely big?_ Well, that’s true. That’s why before moving on with the other responsibilities, we will first extract the above code into a standalone **composition function**. Let's start with creating `useUserRepositories`:
+他の**論理的な関心事**にも同じことができますが、既に疑問があるかもしれません。- _これはコードを `setup` オプションに移動させて肥大させるだけではありませんか？_ そのため他の責務に移る前に、まず上記のコードをスタンドアローンな**コンポジション関数**に抽出します。 `useUserRepositories` の作成から始めましょう:


Suggested change

他の**論理的な関心事**にも同じことができますが、既に疑問があるかもしれません。- _これはコードを `setup` オプションに移動させて肥大させるだけではありませんか？_ そのため他の責務に移る前に、まず上記のコードをスタンドアローンな**コンポジション関数**に抽出します。 `useUserRepositories` の作成から始めましょう:

他の**論理的な関心事**にも同じことができますが、既に疑問があるかもしれません。- _これはコードを `setup` オプションに移動させて肥大させるだけではありませんか？_ そのため他の責務に移る前に、まず上記のコードをスタンドアロンな**コンポジション関数**に抽出します。 `useUserRepositories` の作成から始めましょう:

すみません！ここだけ スタンドアロン でお願いします。
このページ内で スタンドアローン と スタンドアロン が両方あったのですが、基本的な長音の取り扱いと、 v2 ドキュメントの歴史的に スタンドアロン で統一したいと思います。

vuejs/jp.vuejs.org@5c56077

ミスでした…！指摘ありがとうございます 🙏

saitolume · 2020-10-07T03:05:33Z

@kazupon @potato4d 修正完了しました！レビューありがとうございます。

kazupon · 2020-10-08T03:16:02Z

対応ありがとうございました！
マージしますね！

翻訳ありがとうございました！

docs: translate composition api introduction

3750ae0

pr-triage bot added the PR: unreviewed label Oct 6, 2020

kazupon requested changes Oct 6, 2020

View reviewed changes

pr-triage bot added PR: reviewed-changes-requested and removed PR: unreviewed labels Oct 6, 2020

potato4d reviewed Oct 6, 2020

View reviewed changes

docs: fix translation of composition api introduction

1d3ecc4

pr-triage bot added PR: unreviewed and removed PR: reviewed-changes-requested labels Oct 7, 2020

saitolume requested review from kazupon and potato4d October 7, 2020 03:52

kazupon approved these changes Oct 8, 2020

View reviewed changes

pr-triage bot added PR: partially-approved and removed PR: unreviewed labels Oct 8, 2020

kazupon merged commit 01ee39a into vuejs-jp:lang-ja Oct 8, 2020

pr-triage bot added PR: merged and removed PR: partially-approved labels Oct 8, 2020

saitolume deleted the translate-composition-api-introduction branch October 8, 2020 06:35


		Such fragmentation is what makes it difficult to understand and maintain a complex component. The separation of options obscures the underlying logical concerns. In addition, when working on a single logical concern, we have to constantly "jump" around option blocks for the relevant code.
		このような分離は、複雑なコンポーネントを理解ししてメンテナンスすることを難しくします。このオプションの分離は背景にある論理的な関心事をわかりづらくします。さらに、単一の論理的な関心事に取り組む場合、関連するコードのオプションブロックを何度も "ジャンプ" する必要があります。


		Let’s add `setup` to our component:
		`setup` をコンポーネントに追加しましょう:

	`setup` をコンポーネントに追加しましょう:
	`setup` をコンポーネントに追加してみましょう:

	return {} // ここで返されるものは残りの要素で使用可能です
	return {} // ここで返されるものはコンポーネントで他のオプションで使用可能です

	// 残りの要素
	// 以降、コンポーネントの"他"のオプション


		Let’s add it to our `setup` function:
		それを `setup` 関数に追加しましょう:

	それを `setup` 関数に追加しましょう:
	では、`setup` 関数にそれを追加してみましょう:


		Here’s a quick look at how it works.
		その仕組をざっと見てみましょう。

	その仕組をざっと見てみましょう。
	その仕組みをざっと見てみましょう。


		Just like how we set up a watcher on the `user` property inside our component using the `watch` option, we can do the same using the `watch` function imported from Vue. It accepts 3 arguments:
		コンポーネント内の `user` プロパティに `watch` オプションを使用してウォッチャを追加するのと同じように、Vue からインポートした `watch` 関数を使用することができます。それは 3 つの引数を受け付けます:

Advanced Guides > Compotion API > Introduction の翻訳 #101

Advanced Guides > Compotion API > Introduction の翻訳 #101

Conversation

saitolume commented Oct 6, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description of Problem

Additional Information

Uh oh!

netlify bot commented Oct 6, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

kazupon left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

potato4d left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

saitolume commented Oct 7, 2020

Uh oh!

kazupon commented Oct 8, 2020

Uh oh!

Uh oh!

saitolume commented Oct 6, 2020 •

edited

Loading

netlify bot commented Oct 6, 2020 •

edited

Loading