Merge pull request #172 from gatsbyjs/conflicts-79b09bc

BSKY · web-flow · commit a2e91f9ed3c5 · 2020-02-16T11:16:22.000+09:00
(sync) Resolve conflicts with gatsby-i18n-source @ 79b09bc
diff --git a/docs/contributing/index.md b/docs/contributing/index.md
@@ -6,12 +6,12 @@ disableTableOfContents: true
 
 Thanks for being interested in contributing! We're so glad you want to help!
 
-Below you'll find guides on the Gatsby.js community, code of conduct, and how to get started contributing:
+Below you'll find guides on the Gatsby community, code of conduct, and how to get started contributing:
 
-- [Community](/contributing/community/): Learn why you should contribute to Gatsby.js, the most effective ways to do so, and all about the benefits (did we mention the free swag?)
-- [Code of Conduct](/contributing/code-of-conduct/): Read about what we expect from everyone participating in Gatsby.js to make it the most friendly and welcoming community
+- [Community](/contributing/community/): Learn why you should contribute to Gatsby, the most effective ways to do so, and all about the benefits (did we mention the free swag?)
+- [Code of Conduct](/contributing/code-of-conduct/): Read about what we expect from everyone participating in Gatsby to make it the most friendly and welcoming community
 - [Gatsby Style Guide](/contributing/gatsby-style-guide/): The art of contributing to Gatsby, a.k.a. the detailed requirements that will make it more likely your contribution is accepted with minimal changes
-- [How to Contribute](/contributing/how-to-contribute/): How to get the most out of your Gatsby.js contributing experience, including GitHub management tips, setup instructions for docs and code contributions, and more
-- [RFC process](/contributing/rfc-process): Learn how the Gatsby.js team manages bigger changes, by way of a “Request-for-comment” process on GitHub
+- [How to Contribute](/contributing/how-to-contribute/): How to get the most out of your Gatsby contributing experience, including GitHub management tips, setup instructions for docs and code contributions, and more
+- [RFC process](/contributing/rfc-process): Learn how the Gatsby team manages bigger changes, by way of a “Request-for-comment” process on GitHub
 
 <EmailCaptureForm signupMessage="Want to keep up with the latest tips &amp; tricks? Subscribe to our newsletter!" />
diff --git a/docs/docs/add-offline-support-with-a-service-worker.md b/docs/docs/add-offline-support-with-a-service-worker.md
@@ -50,8 +50,7 @@ Service Worker が更新を見つけたときに、カスタムメッセージ
 ```javascript:title=gatsby-browser.js
 export const onServiceWorkerUpdateReady = () => {
   const answer = window.confirm(
-    `アプリケーションが更新されました。 ` +
-      `最新版を表示しますか？`
+    `アプリケーションが更新されました。 ` + `最新版を表示しますか？`
   )
 
   if (answer === true) {
diff --git a/docs/docs/babel.md b/docs/docs/babel.md
@@ -8,18 +8,13 @@ Gatsby は [Babel](https://babeljs.io/) という素晴らしいプロジェク
 
 Gatsby はデフォルトでメジャーなブラウザーの最新の 2 つのバージョンと IE9 以上 、そして 1% 以上のシェアがあるブラウザーをサポートしています。
 
-つまり JavaScript は自動的にコンパイルされ、古いブラウザー上でも動作が保証されているということです。
-ポリフィルも自動的に追加されるため、コードが古いブラウザー上で不可解に壊れることはもうありません！
+つまり JavaScript は自動的にコンパイルされ、古いブラウザー上でも動作が保証されているということです。ポリフィルも自動的に追加されるため、コードが古いブラウザー上で不可解に壊れることはもうありません！
 
-もし、新しいブラウザーのみの対応で良いなら、[サポートするブラウザー](/docs/browser-support/)のページをご覧ください。
-どのように Gatsby を設定すれば 、あなたがサポートしたいブラウザーのみを Babel がコンパイルしてくれるのか記載しています。
+もし、新しいブラウザーのみの対応で良いなら、[サポートするブラウザー](/docs/browser-support/)のページをご覧ください。どのように Gatsby を設定すれば、あなたがサポートしたいブラウザーのみを Babel がコンパイルしてくれるのか記載しています。
 
 ## どのようにカスタム .babelrc ファイルを使うか
 
-Gatsby には、ほとんどのサイトで動くようなデフォルトの .babelrc ファイルがセットアップされています。
-もしあなたが Babel のプリセットやプラグインをカスタムしたい場合、ご自身専用の `.babelrc` をサイトのルートに作成してください。
-そして [`babel-preset-gatsby`](https://github.com/gatsbyjs/gatsby/tree/master/packages/babel-preset-gatsby) をインポートし、
-プラグインやプリセットを追加後、例えば `babel-preset-gatsby` へ `targets` のように値を設定してください。
+Gatsby には、ほとんどのサイトで動くようなデフォルトの .babelrc ファイルがセットアップされています。もしあなたが Babel のプリセットやプラグインをカスタムしたい場合、ご自身専用の `.babelrc` をサイトのルートに作成してください。そして [`babel-preset-gatsby`](https://github.com/gatsbyjs/gatsby/tree/master/packages/babel-preset-gatsby) をインポートし、プラグインやプリセットを追加後、例えば `babel-preset-gatsby` へ `targets` のように値を設定してください。
 
 ```shell
 npm install --save-dev babel-preset-gatsby
diff --git a/docs/docs/gatsby-cli.md b/docs/docs/gatsby-cli.md
@@ -102,7 +102,7 @@ You can now view gatsbyjs.org in the browser.
   On Your Network:  http://192.168.0.212:8000/ // highlight-line
 ```
 
-**ヒント**: ローカルにてビルドされた Gatsby サイトには、 `localhost:8000` または `On Your Network` に表示された URL からアクセスできます。
+**ヒント**: ローカルにてビルドされた Gatsby サイトには、`localhost:8000` または `On Your Network` に表示された URL からアクセスできます。
 
 ### `build`
 
diff --git a/docs/docs/gatsby-image.md b/docs/docs/gatsby-image.md
@@ -347,7 +347,7 @@ file(relativePath: { eq: "images/default.jpg" }) {
 
 クエリーを作成した後、追加オプションを gatsby-image コンポーネントに渡すことができます。
 
-| 名前                   | タイプ               | 説明                                                                                                                                    |
+| 名前                   | タイプ              | 説明                                                                                                                                     |
 | ---------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | `fixed`                | `object`            | `fixed` クエリーで返されるデータです。                                                                                                   |
 | `fluid`                | `object`            | `fluid` クエリーで返されるデータです。                                                                                                   |
diff --git a/docs/docs/how-shadowing-works.md b/docs/docs/how-shadowing-works.md
@@ -283,7 +283,7 @@ export default props => (
 
 This is the first case we'll handle when attempting to resolve the file.
 
-In order to do this we need to leverage the **issuer** of the request. This points to the file that the request came from. This means it refers to _where_ the `import` occurs.
+In order to do this we need to leverage the **Issuer** of the request. This points to the file that the request came from. This means it refers to _where_ the `import` occurs.
 The **request** refers to what the import points to.
 
 This is implemented by another method on the plugin's class which we call `requestPathIsIssuerShadowPath` which has the following method signature:
@@ -297,7 +297,7 @@ requestPathIsIssuerShadowPath({
 })
 ```
 
-`requestPathIsIssuerShadowPath` checks all possible directories for shadowing and then returns whether the issuer's path is found. Let's first take a look at the code and then unpack what's happening here.
+`requestPathIsIssuerShadowPath` checks all possible directories for shadowing and then returns whether the Issuer's path is found. Let's first take a look at the code and then unpack what's happening here.
 
 ```js
 requestPathIsIssuerShadowPath({ requestPath, issuerPath, theme }) {
@@ -328,7 +328,7 @@ const fullPaths = [
 ]
 ```
 
-We then know that if the issuer _matches_ one of these components that it's being extended. This means that a shadowed component is extending the same component from its parent.
+We then know that if the Issuer _matches_ one of these components that it's being extended. This means that a shadowed component is extending the same component from its parent.
 
 When this happens, we return the next path, so here the original location of the theme: `/Users/johno/c/gatsby-theme-example-component-extending/gatsby-theme-tomato/src/box`.
 
@@ -352,7 +352,7 @@ Now, all usages of the Box in `gatsby-theme-tomato` will be also wrapped in a pu
 
 #### An edge case
 
-If a theme sets [`module` config](https://webpack.js.org/configuration/resolve/#resolvemodules) the issuer will be null. As such we need to first check that the `request.context.issuer` is present before we attempt to resolve the shadowed component.
+If a theme sets [`module` config](https://webpack.js.org/configuration/resolve/#resolvemodules) the Issuer will be null. As such we need to first check that the `request.context.issuer` is present before we attempt to resolve the shadowed component.
 
 It's important to note that we don't recommend appending to the modules list in themes.
 Though, if you do, we will make sure we don't arbitrarily error.
diff --git a/docs/docs/index.md b/docs/docs/index.md
@@ -1,5 +1,6 @@
 ---
 title: Gatsby.js ドキュメント
+description: Gatsby のチュートリアル、ガイド、ビルド方法などのまとめ。
 disableTableOfContents: true
 ---
 
diff --git a/docs/docs/path-prefix.md b/docs/docs/path-prefix.md
@@ -67,9 +67,7 @@ export default function Index() {
     <Layout>
       {/* 注意: 以下のコードは現実的な例ではありませんが、考え方としてはわかるはずです。 */}
       {/* highlight-next-line */}
-      <button onClick={() => navigate("/page-2")}>
-        Page 2 へ動的に移動
-      </button>
+      <button onClick={() => navigate("/page-2")}>Page 2 へ動的に移動</button>
     </Layout>
   )
 }
diff --git a/docs/docs/performance.md b/docs/docs/performance.md
@@ -7,6 +7,6 @@ overview: true
 
 このセクションではキャッシュを最適化するいくつかの方法、パフォーマンス特性を簡単にテストするための `localhost` での `https` のセットアップ、さらにウェブサイトのパフォーマンスの計測方法をカバーしており、ウェブサイトのパフォーマンスを最大化するのに必要なツールがすべて手に入るでしょう。なぜパフォーマンスがそんなに重要なのかについてのより掘り下げた説明をお望みであれば、Addy Osmani による JavaScript のコストについての[こちらの記事](https://v8.dev/blog/cost-of-javascript-2019)をチェックしてみてください。
 
-Lighthouse のスコアがすべてグリーンとなりますように😀。
+Lighthouse のスコアがすべてグリーンとなりますように 😀。
 
 <GuideList slug={props.slug} />
diff --git a/docs/docs/quick-start.md b/docs/docs/quick-start.md
@@ -37,7 +37,7 @@ cd gatsby-site
 gatsby develop
 ```
 
-Gatsby はホットリロード対応の開発環境を `localhost:8000` に立ち上げます。
+Gatsby はホットリロード対応の開発環境を `http://localhost:8000` に立ち上げます。
 
 `src/pages`の中にある JavaScript で書かれたページを編集してみてください。保存された変更はブラウザー上でリアルタイムに反映されます。
 
diff --git a/docs/docs/recipes/deploying-your-site.md b/docs/docs/recipes/deploying-your-site.md
@@ -1,5 +1,6 @@
 ---
 title: "レシピ: サイトをデプロイする"
+tableOfContentsDepth: 1
 ---
 
 ショータイム。満足ゆくサイトができたら、あとはそれをデプロイするだけです。
@@ -75,7 +76,7 @@ gatsby build && gatsby serve
 
 6. デプロイパスを `public/` に変更します。
 
-7. 正常に動作していることを確認できたら `netlify deploy --prod` で本番環境にデプロイします。
+7. 正常に動作していることを確認できたら `netlify deploy -d . --prod` で本番環境にデプロイします。
 
 ### 追加資料
 
diff --git a/docs/docs/recipes/styling-css.md b/docs/docs/recipes/styling-css.md
@@ -1,5 +1,6 @@
 ---
 title: "レシピ: CSSによるスタイリング"
+tableOfContentsDepth: 1
 ---
 
 ウェブサイトにスタイルを適用する方法はとてもたくさんありますが、 Gatsby では公式や非公式のプラグインによってほぼ全ての方法がサポートされています。
diff --git a/docs/docs/recipes/transforming-data.md b/docs/docs/recipes/transforming-data.md
@@ -1,5 +1,6 @@
 ---
 title: "レシピ集: データの変換"
+tableOfContentsDepth: 1
 ---
 
 Gatsby でのデータ変換はプラグインによって実現されています。トランスフォーマープラグインは source プラグインを通じてデータを取得し、実際に使う形式へ変換します（例：JSON を JavaScript オブジェクトにする等）。
diff --git a/docs/docs/recipes/working-with-starters.md b/docs/docs/recipes/working-with-starters.md
@@ -1,5 +1,6 @@
 ---
 title: "レシピ: スターターを使用する"
+tableOfContentsDepth: 1
 ---
 
 [スターター](/docs/starters/) は、公式もしくはコミュニティーによって整備された Gatsby サイトの雛形です。
diff --git a/docs/docs/recipes/working-with-themes.md b/docs/docs/recipes/working-with-themes.md
@@ -1,12 +1,13 @@
 ---
 title: "レシピ集: テーマを使用する"
+tableOfContentsDepth: 1
 ---
 
 [Gatsby テーマ](/docs/themes/what-are-gatsby-themes)は Gatsby を構成するもの（共有の機能、データの取得、デザイン）をインストール可能なパッケージとして抽象化したものです。つまり、テーマの設定や機能は直接あなたのプロジェクト内に書かれるのではなく、一元的にバージョン管理された依存パッケージという形でインストールされるということです。テーマをシームレスに更新したり、まとめて作成したり、あるいは互換性のあるテーマを別のものに交換したりすることもできます。
 
-## テーマを使用して新しくサイトを作成する。
+## テーマを使用して新しくサイトを作成する
 
-あなたのプロジェクトで使いたいテーマが見つかりましたか？すばらしい！以下の手順に沿ってテーマを適用することができます。
+あなたのプロジェクトで使いたいテーマが見つかりましたか？すばらしい！以下の手順に沿ってテーマを適用できます。
 
 > もっと他のテーマを探したい場合は、[テーマ一覧](https://www.npmjs.com/search?q=gatsby-theme)を参照。
 
diff --git a/docs/docs/running-queries-with-graphiql.md b/docs/docs/running-queries-with-graphiql.md
@@ -11,7 +11,11 @@ Gatsby サイトを構築する際に、頻繁に使用することになるで
 
 開発環境のサーバーを実行中に、GraphiQL へアクセスできます。
 通常、以下の URL になります。
-`http://localhost:8000/___graphql`.
+`http://localhost:8000/___graphql`
+
+## GraphiQL の使用例
+
+`http://localhost:8000/___graphql` を開くと、以下の動画のように表示されます。ビルドインの `Site` "type" を突っつくと、`siteMetadata`オブジェクトを含んだ、どのフィールドを利用できるかを確認できます。
 
 ## GraphiQL の使用例
 
diff --git a/docs/docs/setting-up-gatsby-without-gatsby-new.md b/docs/docs/setting-up-gatsby-without-gatsby-new.md
@@ -65,4 +65,4 @@ cd ../../
 gatsby develop
 ```
 
-それだけです！初期ページが `localhost:8000` で、GraphiQL IDE が `localhost:8000/___graphql` で起動しているはずです。ここからは[チュートリアル](/tutorial/part-zero/#set-up-a-code-editor)に戻って、Gatsby が提供する機能をフルに体験するためコードエディターを設定する箇所からチュートリアルを再開してください。
+それだけです！初期ページが `http://localhost:8000` で、GraphiQL IDE が `http://localhost:8000/___graphql` で起動しているはずです。ここからは[チュートリアル](/tutorial/part-zero/#set-up-a-code-editor)に戻って、Gatsby が提供する機能をフルに体験するためコードエディターを設定する箇所からチュートリアルを再開してください。
diff --git a/docs/docs/using-graphql-playground.md b/docs/docs/using-graphql-playground.md
@@ -18,7 +18,7 @@ Gatsby で GraphQL Playground にアクセスするためには、以下のよ
 "develop": "GATSBY_GRAPHQL_IDE=playground gatsby develop",
 ```
 
-`gatsby develop` の代わりに `npm run develop` を使用し、立ち上がったサーバー <https://localhost:8000/___graphql> へアクセスすることで利用できます。
+`gatsby develop` の代わりに `npm run develop` を使用し、立ち上がったサーバー `http://localhost:8000/___graphql` へアクセスすることで利用できます。
 
 `gatsby develop` を引き続き使用するためには、gatsby-config.js で dotenv パッケージを使用する必要があります。`.env.development` といった名前で[environment variable](/docs/environment-variables/)ファイルを作成し、`.env.development` へ `GATSBY_GRAPHQL_IDE=playground` と記入します。
 
diff --git a/docs/tutorial/blog-netlify-cms-tutorial/index.md b/docs/tutorial/blog-netlify-cms-tutorial/index.md
@@ -30,7 +30,7 @@ cd [your-project-name]
 gatsby develop
 ```
 
-これであなたは [`localhost:8000`](http://localhost:8000) から作成されたサイトを見ることができるようになるだけでなく、Netlify CMS がプリインストールされ、[`localhost:8000/admin`](http://localhost:8000/admin) からアクセスできるようになりました。
+これであなたは `http://localhost:8000` から作成されたサイトを見ることができるようになるだけでなく、Netlify CMS がプリインストールされ、`http://localhost:8000/admin` からアクセスできるようになりました。
 
 コンテンツマネジメントシステム（CMS）は便利です。あなたは Markdown を使い手動でブログ記事などのコンテンツを追加する代わりに、それらをサイト上のダッシュボードから追加できます。もしかすると、あなたは CMS をローカルだけでなく開発したウェブサイト上からも使いたくなるかもしれません。それを実現するためには、GitHub を通して Netlify にデプロイし、継続的デプロイを設定し、いくつかの設定を変更する必要があります。こちらについては [ステップ 5](#ステップ-5) をご覧ください。
 
diff --git a/docs/tutorial/ecommerce-tutorial/index.md b/docs/tutorial/ecommerce-tutorial/index.md
diff --git a/docs/tutorial/part-eight/index.md b/docs/tutorial/part-eight/index.md
diff --git a/docs/tutorial/part-five/index.md b/docs/tutorial/part-five/index.md
diff --git a/docs/tutorial/part-one/index.md b/docs/tutorial/part-one/index.md
diff --git a/docs/tutorial/part-zero/index.md b/docs/tutorial/part-zero/index.md
diff --git a/docs/tutorial/wordpress-image-tutorial.md b/docs/tutorial/wordpress-image-tutorial.md

Original file line number	Diff line number	Diff line change
`@@ -50,8 +50,7 @@ Service Worker が更新を見つけたときに、カスタムメッセージ`
`50`	`50`	```javascript:title=gatsby-browser.js
`51`	`51`	`export const onServiceWorkerUpdateReady = () => {`
`52`	`52`	`const answer = window.confirm(`
`53`		- `アプリケーションが更新されました。 ` +
`54`		- `最新版を表示しますか？`
	`53`	+ `アプリケーションが更新されました。 ` + `最新版を表示しますか？`
`55`	`54`	`)`
`56`	`55`
`57`	`56`	`if (answer === true) {`
Original file line number	Diff line number	Diff line change
`@@ -67,9 +67,7 @@ export default function Index() {`
`67`	`67`	`<Layout>`
`68`	`68`	`{/* 注意: 以下のコードは現実的な例ではありませんが、考え方としてはわかるはずです。 */}`
`69`	`69`	`{/* highlight-next-line */}`
`70`		`- <button onClick={() => navigate("/page-2")}>`
`71`		`- Page 2 へ動的に移動`
`72`		`- </button>`
	`70`	`+ <button onClick={() => navigate("/page-2")}>Page 2 へ動的に移動</button>`
`73`	`71`	`</Layout>`
`74`	`72`	`)`
`75`	`73`	`}`