From 667b316d849445bc5b594ff8a523933143cb39d8 Mon Sep 17 00:00:00 2001 From: nzws Date: Mon, 20 Jan 2020 13:23:48 +0900 Subject: [PATCH] Translate docs/sourcing-from-the-filesystem --- docs/docs/sourcing-from-the-filesystem.md | 44 +++++++++++------------ 1 file changed, 20 insertions(+), 24 deletions(-) diff --git a/docs/docs/sourcing-from-the-filesystem.md b/docs/docs/sourcing-from-the-filesystem.md index 2d88bdcaf..91f8f94f3 100644 --- a/docs/docs/sourcing-from-the-filesystem.md +++ b/docs/docs/sourcing-from-the-filesystem.md @@ -1,26 +1,26 @@ --- -title: Sourcing from the Filesystem +title: ファイルシステムからデータを取得する --- -This guide will walk you through sourcing data from the filesystem. +このガイドでは、ファイルシステムからデータを取得する方法について説明します。 -## Setup +## セットアップ -This guide assumes that you have a Gatsby project set up. If you need to set up a project, please reference the [Quick Start Guide](/docs/quick-start/). +このガイドは Gatsby プロジェクトがセットアップされていることを前提としています。プロジェクトをセットアップする必要がある場合、[クイックスタートガイド](/docs/quick-start/)を参照してください。 -It will also be useful if you are familiar with [GraphiQL](/docs/introducing-graphiql/), a tool that helps you structure your queries correctly. +クエリーを正しく構成するのに役立つツールである [GraphiQL](/docs/introducing-graphiql/) を精通している場合も役立ちます。 -## Using `gatsby-source-filesystem` +## `gatsby-source-filesystem` を使う -`gatsby-source-filesystem` is the Gatsby plugin for creating File nodes from the file system. +`gatsby-source-filesystem` はファイルシステムからファイルノードを作成する Gatsby プラグインです。 -Install the plugin at the root of your Gatsby project: +Gatsby プロジェクトのルートにプラグインをインストールします： ```shell npm install --save gatsby-source-filesystem ``` -Then add it to your project's `gatsby-config.js` file: +それから、下記をあなたのプロジェクトの `gatsby-config.js` ファイルに追加します： ```javascript:title=gatsby-config.js module.exports = { @@ -41,36 +41,32 @@ module.exports = { } ``` -Save the `gatsby-config.js` file, and restart the Gatsby development server. +`gatsby-config.js` ファイルを保存して、Gatsby 開発サーバーを再起動してください。 -Open up GraphiQL. +GraphiQL を開きます。 -If you bring up the autocomplete window, you'll see: +オートコンプリートウィンドウを表示すると、これが表示されます： ![graphiql-filesystem](./images/graphiql-filesystem.png) -Hit Enter on `allFile` then type Ctrl + Enter to run a -query. +`allFile`　で Enter キーを押し、Ctrl + Enter を押してクエリーを実行します。 ![filesystem-query](./images/filesystem-query.png) -Delete the `id` from the query and bring up the autocomplete again (Ctrl + -Space). +クエリーから `id` を削除し、オートコンプリートを再度表示します。（Ctrl + Space） ![filesystem-autocomplete](./images/filesystem-autocomplete.png) -Try adding a number of fields to your query, pressing Ctrl + Enter -each time to re-run the query. You'll see something like this: +クエリーにいくつかのフィールドを追加して、毎回 Ctrl + Enter を押してクエリーを再実行してみてください。次のようなものが表示されます： ![allfile-query](./images/allfile-query.png) -The result is an array of File "nodes" (node is a fancy name for an object in a -"graph"). Each File object has the fields you queried for. +結果はファイル「ノード」の配列です。（ノードは「グラフ」内のオブジェクトの仮名です）各ファイルオブジェクトには、クエリーしたフィールドがあります。 -## Transforming File nodes +## ファイルノードの変換 -Once files have been sourced, various "transformer" plugins in the Gatsby ecosystem can then be used to transform File nodes into various other types of data. For example, a JSON file can be sourced using `gatsby-source-filesystem`, and then the resulting File nodes can be transformed into JSON nodes using `gatsby-transformer-json`. +ファイルが取得されると、Gatsby エコシステムのさまざまな「トランスフォーマー」プラグインを使用して、ファイルノードを様々な他のタイプのデータに変換できます。例えば、JSON ファイルは `gatsby-source-filesystem` を使用してデータを取得でき、結果であるファイルノードを `gatsby-transformer-json` を使用して JSON ノードに変換できます。 -## Further reference and examples +## 詳細なリファレンスと例 -For further reference, you may be interested in checking out the `gatsby-source-filesystem` [package README](/packages/gatsby-source-filesystem/), and various official and community [starters that use the plugin](/starters/?d=gatsby-source-filesystem). +さらに使い方を学びたければ、 `gatsby-source-filesystem` [パッケージの README](/packages/gatsby-source-filesystem/) や様々な公式およびコミュニティーが作成した [このプラグインを使用しているスターター](/starters/?d=gatsby-source-filesystem) を確認してください。