Merge branch 'master' into docs/adding-react-components

Author: blkclct

docs/contributing/blog-and-website-contributions.md

@@ -58,6 +58,6 @@ If you want to make changes, improvements, or add new functionality to the websi
 
 > Note: If you are experiencing issues on a Linux machine, run `sudo apt install libvips-dev`, to install a native dependency. You can also reference [Gatsby guide on Linux](/docs/gatsby-on-linux/) for other Linux-specific requirements.
 
-Now you can make and preview your changes before raising a pull request!
+Now you can make and preview your changes before raising a Pull Request!
 
 For full repo setup instructions, visit the [code contributions](/contributing/code-contributions/) page.

docs/contributing/contributor-swag.md

@@ -1,26 +1,26 @@
 ---
-title: Free Swag for Gatsby Contributors!
+title: Gatsby コントリビューターへの無料の景品！
 ---
 
-Gatsby relies on contributors from the open source community, and we want to make sure you know how much it means to us that you’re willing to put time and effort into [contributing to Gatsby](/contributing/how-to-contribute/).
+Gatsby はオープンソースコミュニティーのコントリビューターに依存しています。[Gatsby への貢献](/contributing/how-to-contribute/)に時間と労力を費やすことが、私たちにとってどれだけ意味があるのかを確認したいと思います。
 
-To show our appreciation, _**everyone who contributes to Gatsby is eligible to receive free swag!**_
+感謝の証として、 _**Gatsby に貢献した全ての人が無料の景品を受け取ることができます！**_
 
-![Gatsby contributors wearing swag.](./images/gatsby-swag.jpg)
+![Gatsby の景品を着ているコントリビューター。](./images/gatsby-swag.jpg)
 
-### How to claim your free swag
+### 無料の景品を受け取る方法
 
-If you contribute to the Gatsby organization on GitHub, you can claim your swag by [logging into the Gatsby Store](https://store.gatsbyjs.org/) and requesting a discount code. With five or more contributions, you can claim your _**Level 2**_ swag.
+GitHub で Gatsby 組織に貢献した場合は [Gatsby Store にログイン](https://store.gatsbyjs.org/)して、割引コードを要求することで景品を受け取れます。5 回以上貢献することで _**レベル２**_ の景品を受け取ることもできます。
 
-If you’ve contributed in other ways, such as giving talks about Gatsby, teaching others to use it, writing Gatsby articles/tutorials, participating in a Gatsby research project, or any other way, please email <mailto:[email protected]> or [tweet at Gatsby on Twitter](https://twitter.com/gatsbyjs) to claim your swag.
+別の方法で貢献した場合は <mailto:[email protected]> にメールするか、[Twitter で Gatsby にツイート](https://twitter.com/gatsbyjs)して景品を受け取りましょう。例えば Gatsby について講演したり、Gatsby の使い方を他の人に教えたり、Gatsby の記事やチュートリアルを書いたり、Gatsby の研究プロジェクトへ参加したり、またはその他の方法で貢献した場合です。
 
-### Details about free swag
+### 無料の景品の詳細
 
-- We will send one item from our [swag store](https://store.gatsbyjs.org/) per swag tier
-- Tier 1 swag includes most items \$10 and under
-- Tier 2 swag includes most items \$26 and under
-- Not all items are eligible due to high cost to create the swag. We’ll make it clear which items are not eligible
-- There’s a limit of one free swag item per swag tier
-- Shipping is free worldwide
+- [景品ストア](https://store.gatsbyjs.org/) から景品レベルごとに 1 つのアイテムを送ります。
+- レベル 1 の景品には、10 ドル以下のほとんどのアイテムが含まれています。
+- レベル 2 の景品には、26 ドル以下のほとんどのアイテムが含まれています。
+- 景品を作成するのに費用がかかるため、すべてのアイテムが対象となるわけではありません。どのアイテムが対象外なのかを明確にします。
+- 無料で受け取ることができるのは、景品レベルごとに 1 つという制限があります。
+- 世界中どこでも送料無料です。
 
-> **NOTE:** Worldwide free shipping is a pilot program. If shipping costs get out of control, we may need to adjust this policy in the future.
+> **注意：** 世界中への送料無料は試験的なプログラムです。送料が手に負えなくなった場合は、このポリシーを調整する必要があります。

docs/contributing/docs-and-website-components.md

@@ -3,12 +3,6 @@ title: Docs and Website Components
 tableOfContentsDepth: 2
 ---
 
-import LayerModel from "../../www/src/components/layer-model"
-import HorizontalNavList from "../../www/src/components/horizontal-nav-list"
-import Breadcrumb from "../../www/src/components/docs-breadcrumb"
-import { itemListContributing } from "../../www/src/utils/sidebar/item-list"
-import TableOfContents from "../../www/src/components/docs-table-of-contents"
-
 The Gatsbyjs.org site has a handful of components that have been developed to facilitate writing new content for the blog and the docs. There are also components that help organize and lay out content in various pages across the website.
 
 This guide documents what components are available and explains how to use them. You can also refer to the [code for this page on GitHub](https://github.com/gatsbyjs/gatsby/blob/master/docs/contributing/docs-and-website-components.md) to see to how each component can be used, because they are all embedded here!
@@ -130,14 +124,6 @@ Rendered, the component looks like this:
   To improve is to change, so to be perfect is to have changed often.
 </Pullquote>
 
----
-
-## Other available components
-
-Other less commonly used components aren't globally available, but can imported at the top of a Markdown file and used in other docs.
-
----
-
 ### Layer Model
 
 The `<LayerModel />` was made to help explain concepts of how Gatsby works at a high level. It conceptually breaks Gatsby into different layers and shows how data is pulled, aggregated, and eventually rendered as an app. It's used on docs pages to help explain how Gatsby works at different levels.
@@ -168,7 +154,7 @@ When used, it looks like this:
 
 ### Horizontal Navigation List
 
-The `<HorizontalNavList />` was made for the [Glossary](/docs/glossary/), and renders a list of links to alphabetical subheadings on the page in a horizontal format. Because of its specific use case, it isn't made globally available but can be imported if needed on other pages.
+The `<HorizontalNavList />` was made for the [Glossary](/docs/glossary/), and renders a list of links to alphabetical subheadings on the page in a horizontal format.
 
 #### Usage
 
@@ -212,169 +198,6 @@ items={[
 slug={props.slug}
 />
 
-### Breadcrumb
-
-The `<Breadcrumb />` component is used in layout files to display the hierarchy of pages a user is currently browsing on.
-
-#### Usage
-
-The Breadcrumb component takes one prop:
-
-- `location` - an object provided in the props of page templates by default
-- `itemList` - an object comprised of the docs hierarchical structure
-
-<!-- prettier-ignore -->
-```jsx
-import Breadcrumb from "../../www/src/components/docs-breadcrumb"
-
-<Breadcrumb location={props.location} itemList={itemList} />
-```
-
-_You can also refer to [an example of usage of the Breadcrumb in the Gatsbyjs.org source code](https://github.com/gatsbyjs/gatsby/blob/1d65ce051967dda5c4a89da920fc34692524e237/www/src/templates/template-docs-markdown.js#L82)_
-
-#### Optional `breadcrumbTitle` entries in sidebar files
-
-To alter the title of a doc that is displayed in the Breadcrumb component, a `breadcrumbTitle` is supported as a key in the [sidebar YAML files](https://github.com/gatsbyjs/gatsby/tree/master/www/src/data/sidebars). It is commonly used to provide an abbreviated version of a doc's title when displayed next to its parent page title, e.g. shortening "Adding a Custom webpack Config" to "webpack Config".
-
-#### Sample
-
-Rendered, it looks like this:
-
-<Breadcrumb
-location={{
-    pathname: "/contributing/docs-and-website-components/",
-  }}
-itemList={itemListContributing}
-/>
-
----
-
-### Table of Contents
-
-The `<TableOfContents />` component is used to render a list of subheaders from a docs page and automatically provide deep links to them.
-
-#### Usage
-
-The component takes 2 props:
-
-- `location` - an object provided in the props of page templates by default
-- `page` - an object with data passed in from the sites `gatsby-node.js` that contains information from the MDX plugin about the structure of headings
-
-<!-- prettier-ignore -->
-```jsx
-import TableOfContents from "../../www/src/components/docs-table-of-contents"
-
-<TableOfContents location={props.location} page={page} />
-```
-
-_You can also refer to [an example of usage of the Table of Contents in the Gatsbyjs.org source code](https://github.com/gatsbyjs/gatsby/blob/1d65ce051967dda5c4a89da920fc34692524e237/www/src/templates/template-docs-markdown.js#L121)_
-
-The Table of Contents component also has some optional configurations that can be set in the frontmatter of a doc's markdown.
-
-In docs where the Table of Contents isn't required and should be disabled, a key in the frontmatter called `disableTableOfContents` can be set to `true` like this:
-
-```markdown
----
-title: Glossary
-disableTableOfContents: true
----
-
-When you're new to Gatsby there can be a lot of words to learn...
-```
-
-In other docs where the Table of Contents is extremely long it can make sense to only show headers from the doc up to a certain level, rather than all subheadings. You can set the `tableOfContentsDepth` key to a number that will limit the subheadings shown in the table of contents to that "depth". If it is set to 2, `<h2>`/`##`, and `<h3>`/`###` headers will be listed, if set to 3, `<h2>`/`##`, `<h3>`/`###`, and `<h4>`/`####` will all be shown. It is set like this:
-
-```markdown
----
-title: Glossary
-tableOfContentsDepth: 2
----
-
-When you're new to Gatsby there can be a lot of words to learn...
-```
-
-#### Sample
-
-The Table of Contents looks like this when rendered (and is also displayed on the right hand side of the page):
-
-<TableOfContents
-location={{ pathname: "/contributing/docs-and-website-components/" }}
-page={{
-    frontmatter: {
-      title: "Docs and Website Components",
-      tableOfContentsDepth: 2,
-    },
-    tableOfContents: {
-      items: [
-        {
-          url: "#globally-available-components",
-          title: "Globally available components",
-          items: [
-            {
-              url: "#guide-list",
-              title: "Guide list",
-            },
-            {
-              url: "#egghead-embed",
-              title: "Egghead embed",
-            },
-            {
-              url: "#pull-quote",
-              title: "Pull quote",
-            },
-          ],
-        },
-        {
-          url: "#other-available-components",
-          title: "Other available components",
-          items: [
-            {
-              url: "#layer-model",
-              title: "Layer model",
-            },
-            {
-              url: "#horizontal-navigation-list",
-              title: "Horizontal navigation list",
-            },
-            {
-              url: "#breadcrumb",
-              title: "Breadcrumb",
-            },
-            {
-              url: "#table-of-contents",
-              title: "Table of Contents",
-            },
-          ],
-        },
-        {
-          url: "#writing-content-in-markdown",
-          title: "Writing content in markdown",
-          items: [
-            {
-              url: "#code-blocks",
-              title: "Code blocks",
-            },
-          ],
-        },
-        {
-          url: "#styling-components-on-gatsbyjsorg-with-theme-ui",
-          title: "Styling components on Gatsbyjs.org with Theme-UI",
-          items: [
-            {
-              url: "#design-tokens",
-              title: "Design tokens",
-            },
-            {
-              url: "#the-sx-prop",
-              title: "The sx prop",
-            },
-          ],
-        },
-      ],
-    },
-  }}
-/>
-
 ---
 
 ## Writing content in Markdown