Merge pull request #182 from masanarih0ri/cookbook-translate-to-ja

cookbook: Translate cookbook #180

Author: potato4d

src/cookbook/index.md

@@ -1,77 +1,76 @@
-# Introduction
+# イントロダクション
 
-## The Cookbook vs the Guide
+## クックブックとガイド
 
-How is the cookbook different from the guide? Why is this necessary?
+クックブックはガイドとどう違うのでしょうか？なぜそれが必要なのでしょうか？
 
-- **Greater Focus**: In the guide, we're essentially telling a story. Each section builds on and assumes knowledge from each previous section. In the cookbook, each recipe can and should stand on its own. This means recipes can focus on one specific aspect of Vue, rather than having to give a general overview.
+- **よりフォーカスする**: ガイドの中では、基本的にストーリーを語っています。それぞれのセクションは、前のセクションの知識を基にしています。クックブックにおいては、それぞれのレシピはそれ自体が独立しています。つまりレシピは、一般的な Vue の概要を説明するのではなく、Vue の特定の側面に焦点を当てることができます。
 
-- **Greater Depth**: To avoid making the guide too long, we try to include only the simplest possible examples to help you understand each feature. Then we move on. In the cookbook, we can include more complex examples, combining features in interesting ways. Each recipe can also be as long and detailed as it needs to be, in order to fully explore its niche.
+- **より深くまで**: ガイドは長くなりすぎず、それぞれの機能を理解していただくために、可能な限り簡単な例だけを掲載するようにしています。そして次に進みます。クックブックでは、興味深い方法で機能を組み合わせた、より複雑な例を含めることができます。それぞれレシピはまた、それらの例を完全に探求するために、必要なだけ長くて詳細なものにすることができます。
 
-- **Teaching JavaScript**: In the guide, we assume at least intermediate familiarity with ES5 JavaScript. For example, we won't explain how `Array.prototype.filter` works in a computed property that filters a list. In the cookbook however, essential JavaScript features (including ES6/2015+) can be explored and explained in the context of how they help us build better Vue applications.
+- **JavaScript を教える**: ガイドでは、少なくとも ES5 の JavaScript の中級程度の知識があることを前提としています。例えば、 `Array.prototype.filter` がリストをフィルタリングする計算プロパティでどのように動作するかは説明しません。しかし、クックブックでは、必須の JavaScript 機能 (ES6/2015+ を含む) を探索し、より良い Vue アプリケーションの構築にどのように役立つのかという文脈で説明します。
 
-- **Exploring the Ecosystem**: For advanced features, we assume some ecosystem knowledge. For example, if you want to use single-file components in Webpack, we don't explain how to configure the non-Vue parts of the Webpack config. In the cookbook, we have the space to explore these ecosystem libraries in more depth - at least to the extent that is universally useful for Vue developers.
+- **エコシステムを探求する**: 高度な機能については、ある程度のエコシステムの知識を前提としています。たとえば、Webpack でシングルファイルコンポーネントを使用したい場合、Webpack の confing についての Vue 以外の部分を設定する方法については説明しません。クックブックでは、少なくとも Vue 開発者にとって普遍的に有用な範囲でこれらのエコシステムライブラリをより深く探求するスペースがあります。
 
-::: tip
-With all these differences, please note that the cookbook is still _not_ a step-by-step manual. For most of its content, you are expected to have a basic understanding of concepts like HTML, CSS, JavaScript, npm/yarn, etc.
-:::
+::: ヒント
+これらの違いはあるものの、クックブックはまだステップバイステップのマニュアルではないことに注意してください。その内容のほとんどは、HTML、CSS、JavaScript、npm/yarn などの概念を基本的に理解していることが求められます。
 
-## Cookbook Contributions
+## クックブックへの貢献
 
-### What we're looking for
+### 私たちが求めているもの
 
-The Cookbook gives developers examples to work off of that both cover common or interesting use cases, and also progressively explain more complex detail. Our goal is to move beyond a simple introductory example, and demonstrate concepts that are more widely applicable, as well as some caveats to the approach.
+このクックブックでは、一般的なユースケースや興味深いユースケースを網羅した開発者向けのサンプルを提供したり、より複雑な細かい部分を段階的にに説明していきます。私たちの目標は、単純な入門的な例を超えて、より広く適用可能な概念を示すことと、アプローチの注意点を示すことです。
 
-If you're interested in contributing, please initiate collaboration by filing an issue under the tag **cookbook idea** with your concept so that we can help guide you to a successful pull request. After your idea has been approved, please follow the template below as much as possible. Some sections are required, and some are optional. Following the numerical order is strongly suggested, but not required.
+貢献に興味のある方は、 **cookbook idea** というタグの下にあなたのコンセプトを書いて issue を提出して、コラボレーションを開始してください。あなたのアイデアが承認されたら、以下のテンプレートにできるだけ従ってください。いくつかのセクションは必須であり、いくつかのセクションは任意です。数字の順番に従うことを強くお勧めしますが、必須ではありません。
 
-Recipes should generally:
+レシピは一般的に:
 
-- Solve a specific, common problem
-- Start with the simplest possible example
-- Introduce complexities one at a time
-- Link to other docs, rather than re-explaining concepts
-- Describe the problem, rather than assuming familiarity
-- Explain the process, rather than just the end result
-- Explain the pros and cons of your strategy, including when it is and isn't appropriate
-- Mention alternative solutions, if relevant, but leave in-depth explorations to a separate recipe
+- 特定の一般的な問題を解決しましょう。
+- できるだけシンプルな例から始めましょう。
+- 複雑なことは1つずつ紹介しましょう。
+- 概念を再説明するのではなく、他のドキュメントにリンクしましょう。
+- その問題に精通していると前提とするのではなく、問題点を説明しましょう。
+- 最終的な結果だけではなく、プロセスを説明しましょう。
+- 適切な場合とそうでない場合を含めて、戦略の長所と短所を説明しましょう。
+- 関連性がある場合は、代替案に言及しますが、詳細な調査は別のレシピに任せましょう。
 
-We request that you follow the template below. We understand, however, that there are times when you may necessarily need to deviate for clarity or flow. Either way, all recipes should at some point discuss the nuance of the choice made using this pattern, preferably in the form of the alternative patterns section.
+下記のテンプレートに従ってください。しかし、説明の分かりやすさや流れのために、どうしてもテンプレートから逸脱する必要がある場合もあると思います。いずれにしても、すべてのレシピでは、このパターンを使った選択のニュアンスを、できれば代替パターンのセクションで説明する必要があります。
 
-### Base Example <Badge text="required" type="error" />
+### 基本的な例 <Badge text="必須" type="error" />
 
-1.  Articulate the problem in a sentence or two.
-2.  Explain the simplest possible solution in a sentence or two.
-3.  Show a small code sample.
-4.  Explain what this accomplishes in a sentence.
+1.  問題を1文か2文で明確にしましょう。
+2.  最も簡単な問題に対しての解答を1文か2文で説明しましょう。
+3.  小さなコードサンプルを表示しましょう。
+4.  これが何を達成しているのかを文章で説明しましょう。
 
-### Details about the Value <Badge text="required" type="error" />
+### バリューの詳細 <Badge text="必須" type="error" />
 
-1.  Address common questions that one might have while looking at the example. (Blockquotes are great for this)
-2.  Show examples of common missteps and how they can be avoided.
-3.  Show very simple code samples of good and bad patterns.
-4.  Discuss why this may be a compelling pattern. Links for reference are not required but encouraged.
+1.  例を見ている間に持っているかもしれない一般的な質問に対処しましょう。(ブロッククオートはこれに最適です)
+2.  よくある間違いの例を示し、どのように避けることができるかを示しましょう。
+3.  良いパターンと悪いパターンの非常にシンプルなコードサンプルを表示しましょう。
+4.  なぜこれが説得力のあるパターンなのか議論してください。参照用のリンクは必須ではありませんが、それをつけることを推奨します。
 
-### Real-World Example <Badge text="required" type="error" />
+### 実際の例 <Badge text="必須" type="error" />
 
-Demonstrate the code that would power a common or interesting use case, either by:
+一般的なユースケースや興味深いユースケースを動かすコードを、以下のいずれかの方法で実行してください。
 
-1.  Walking through a few terse examples of setup, or
-2.  Embedding a codepen/jsfiddle example
+1.  セットアップの簡潔な例をいくつか紹介する。または
+2.  codepen / jsfiddle の埋め込みの例
 
-If you choose to do the latter, you should still talk through what it is and does.
+後者を選択した場合でも、それが何であり、何をするのかをディスカッションする必要があります。
 
-### Additional Context <Badge text="optional" />
+### 追加の文脈 <Badge text="任意" />
 
-It's extremely helpful to write a bit about this pattern, where else it would apply, why it works well, and run through a bit of code as you do so or give people further reading materials here.
+このパターンについて、他のどこに適用されるのか、なぜそれがうまく機能するのか、そして、あなたがそうするように少しのコードを実行したり、ここでさらに読み物を人々に与えたりすることについて少し書くのは非常に有用です。
 
-### When To Avoid This Pattern <Badge text="optional" />
+### このパターンを回避するケース <Badge text="任意" />
 
-This section is not required, but heavily recommended. It won't make sense to write it for something very simple such as toggling classes based on state change, but for more advanced patterns like mixins it's vital. The answer to most questions about development is ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG), this section embraces that. Here, we'll take an honest look at when the pattern is useful and when it should be avoided, or when something else makes more sense.
+このセクションは必須ではありませんが、書くことを強くお勧めします。 状態変化に応じてクラスを切り替えるような非常に単純なものには意味がありませんが、mixins のようなより高度なパターンには不可欠です。開発に関するほとんどの質問に対する答えは ["It depends!"]](https://codepen.io/rachsmith/pen/YweZbG) であり、このセクションではそれを受け入れます。ここでは、そのパターンがどのような時に役立つのか、避けるべき時はどのような時なのか、他の何かがより意味を持つ時はどのような時なのかを率直に見ていきましょう。
 
-### Alternative Patterns <Badge text="required with avoidance section" type="warning" />
+### 代替パターン <Badge text="必須 回避のセクションに付随する" type="warning" />
 
-This section is required when you've provided the section above about avoidance. It's important to explore other methods so that people told that something is an antipattern in certain situations are not left wondering. In doing so, consider that the web is a big tent and that many people have different codebase structures and are solving different goals. Is the app large or small? Are they integrating Vue into an existing project, or are they building from scratch? Are their users only trying to achieve one goal or many? Is there a lot of asynchronous data? All of these concerns will impact alternative implementations. A good cookbook recipe gives developers this context.
+このセクションは、上記の回避についてのセクションを提供した場合に必要となります。特定の状況で何かがアンチパターンだと言われても、疑問を残さないように、他の方法を模索することが重要です。その際には、ウェブは大きなテントであり、多くの人が異なるコードベースの構造を持ち、異なる目標を解決していることを考慮してください。アプリの規模は大きいのか小さいのか？既存のプロジェクトに Vue を統合しているのか、それともゼロから構築しているのか。ユーザーは1つの目標だけを達成しようとしているのか、それとも多くの目標を達成しようとしているのか？非同期データが多いのか？これらの懸念事項はすべて、代替の実装に影響を与えます。良いクックブックのレシピは、開発者にこのような状況を提供します。
 
-## Thank you
+## 謝辞
 
-It takes time to contribute to documentation, and if you spend the time to submit a PR to this section of our docs, you do so with our gratitude.
+ドキュメンテーションに貢献するには時間がかかりますが、この部分に時間をかけてプルリクエストを提出してくれると、感謝の気持ちを込めてやってくれます。