From 319a55f98013ab2cbc794471dc0f33416c758384 Mon Sep 17 00:00:00 2001 From: Rafael Nunes Date: Tue, 24 Dec 2019 11:37:40 +1100 Subject: [PATCH 1/5] traducao api-files-gatsby-config --- docs/docs/api-files-gatsby-config.md | 58 ++++++++++++++-------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/docs/api-files-gatsby-config.md b/docs/docs/api-files-gatsby-config.md index 81c3d325d..1a67dc916 100644 --- a/docs/docs/api-files-gatsby-config.md +++ b/docs/docs/api-files-gatsby-config.md @@ -1,22 +1,22 @@ --- -title: The gatsby-config.js API File +title: O arquivo da API gatsby-config.js --- -The file `gatsby-config.js` defines your site's metadata, plugins, and other general configuration. This file should be in the root of your Gatsby site. +O arquivo `gatsby-config.js` define os metadados do seu website, _plugins_, e outras configurações gerais. Este arquivo deve estar na raiz do seu Gatsby website. -If you created a Gatsby site with the `gatsby new` command, there should already be a sample configuration file in your site's directory. +Se você criou um Gatsby website com o comando `gatsby new`, já deve existir um arquivo de configuração de exemplo na pasta do seu website. -## Set up the configuration file +## Construindo o arquivo de configuração -The configuration file should export a JavaScript object. Within this object, you can define several different configuration options. +O arquivo de configuração deve exportar um objeto JavaScript. Dentro deste objeto, você pode definir várias opções de configuração diferentes. ```javascript:title=gatsby-config.js module.exports = { - //configuration object + // objeto de configuração } ``` -An example `gatsby-config.js` file could look like this: +Um exemplo de arquivo `gatsby-config.js` poderia ficar assim: ```javascript:title=gatsby-config.js module.exports = { @@ -29,20 +29,20 @@ module.exports = { resolve: `gatsby-plugin-name`, options: { optionA: true, - optionB: `Another option`, + optionB: `Outra opção`, }, }, ], } ``` -## Configuration options +## Opções de configuração -There are [many configuration options](/docs/gatsby-config) available, but the most common set site-wide metadata and enable plugins. +Existem [muitas opções de configuração](/docs/gatsby-config) disponíveis, mas as mais comuns configuram metadados do website e habilitam _plugins_. -### Site metadata +### Metadados do website -The `siteMetadata` object can contain any data you want to share across your site. A useful example is the site's title. If you store the title in `siteMetadata`, you can alter the title in one place, and it will be updated throughout your site. To add metadata, include a `siteMetadata` object in your configuration file: +O objeto `siteMetadata` pode conter qualquer dado que você queira compartilhar em seu website. Um exemplo útil é o título do website. Se você guardar o título em `siteMetadata`, você pode alterar o título em um único lugar, e ele será atualizado por todo seu website. Para adicionar metadados inclua o objeto `siteMetadata` no seu arquivo de configuração: ```javascript:title=gatsby-config.js module.exports = { @@ -52,27 +52,27 @@ module.exports = { } ``` -You can then [access the site title using GraphQL](/tutorial/part-four/#your-first-graphql-query) anywhere on your site. +Você pode então [acessar o título do website usando GraphQL](/tutorial/part-four/#your-first-graphql-query) de qualquer lugar no seu website. -### Plugins +### _Plugins_ -Plugins add new features to your Gatsby site. For example, some plugins fetch data from hosted services, transform data formats, or resize images. The [Gatsby plugin library](/plugins) helps you find the right plugin for your needs. +_Plugins_ adicionam novas funcionalidades no seu Gatsby website. Por exemplo, alguns _plugins_ buscam dados de um serviço hospedado, transformam a formatação dos dados, ou redimensionam imagens. A [biblioteca de _plugins_ do Gatsby](/plugins) ajuda você a encontrar o _plugin_ correto para suas necessidades. -Installing a plugin using a package manager like `npm` **does not** enable it in your Gatsby site. To finish adding a plugin, make sure your `gatsby-config.js` file has a `plugins` array so you can include a space for the plugins needed to build your site: +Instalando um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu Gatsby website. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` tenha o array, `_plugins_`, então você pode incluir um espaço para os _plugins_ necessários para construir o seu website: ```javascript:title=gatsby-config.js module.exports = { plugins: [ - //plugins go here + // plugins são colocados aqui ], } ``` -When adding multiple plugins, they should be separated by commas in the `plugins` array to support valid JavaScript syntax. +Quando adicionando multiplos _plugins_, eles devem estar separados por vírgulas no array `_plugins_` para ser uma syntaxe válida de JavaScript. -#### Plugins without options +#### _Plugins_ sem opções -If a plugin does not require any options, you can add its name as a string to the `plugins` array: +Se um _plugin_ não requer quaisquer opções, você pode adicionar o nome dele como uma string no array `_plugins_`: ```javascript:title=gatsby-config.js module.exports = { @@ -80,11 +80,11 @@ module.exports = { } ``` -#### Plugins with options +#### _Plugins_ com opções -Many plugins have optional or required options to configure them. Instead of adding a name string to the `plugins` array, add an object with its name and options. Most plugins show examples in their `README` file or page in the [Gatsby plugin library](/plugins). +Vários _plugins_ possuem opções facultativas ou obrigatórias a serem configuradas. Ao invés de adicionar a string do nome no array `_plugins_`, adicione um objeto com o nome do _plugin_ e suas opções. A maior parte dos _plugins_ apresentam exemplos em seu arquivo `README` ou na página da [biblioteca de _plugins_ do Gatsby](/plugins). -Here's an example showing how to write an object with keys to `resolve` the plugin name and an `options` object with any applicable settings: +Aqui está um exemplo mostrando como escrever um objeto com uma chave `_resolve_` para definir o nome do _plugin_ e uma chave `_options_` para definir um objeto com qualquer configuração aplicável: ```javascript:title=gatsby-config.js module.exports = { @@ -93,16 +93,16 @@ module.exports = { resolve: `gatsby-plugin-name`, options: { optionA: true, - optionB: `Another option`, + optionB: `Outra opção`, }, }, ], } ``` -### Mixed plugins +### _Plugins_ mistos -You can add plugins with and without options in the same array. Your site's config file could look like this: +Você pode adicionar _plugins_ com ou sem opções no mesmo array. O arquivo de configuração do seu website poderia ficar assim: ```javascript:title=gatsby-config.js module.exports = { @@ -112,13 +112,13 @@ module.exports = { resolve: `gatsby-plugin-name`, options: { optionA: true, - optionB: `Another option`, + optionB: `Outra opção`, }, }, ], } ``` -## Additional configuration options +## Opções de configuração adicionais -There are several more configuration options available for `gatsby-config.js`. You can find a list of every option in the [Gatsby Configuration API](/docs/gatsby-config/) page. +Existem várias configurações opções disponíveis para o arquivo `gatsby-config.js`. Você pode encontrar uma lista de cada opçõe na página [Configuração da API do Gatsby](/docs/gatsby-config/). From 30d1d8996fed015e376025e6db0aed5f587a1603 Mon Sep 17 00:00:00 2001 From: Rafael Nunes Date: Fri, 3 Jan 2020 09:47:07 +1100 Subject: [PATCH 2/5] Apply suggestions from code review Co-Authored-By: Rafael Baldasso Audibert <32079912+rafaeelaudibert@users.noreply.github.com> --- docs/docs/api-files-gatsby-config.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/docs/api-files-gatsby-config.md b/docs/docs/api-files-gatsby-config.md index 1a67dc916..7276a1bf8 100644 --- a/docs/docs/api-files-gatsby-config.md +++ b/docs/docs/api-files-gatsby-config.md @@ -2,7 +2,7 @@ title: O arquivo da API gatsby-config.js --- -O arquivo `gatsby-config.js` define os metadados do seu website, _plugins_, e outras configurações gerais. Este arquivo deve estar na raiz do seu Gatsby website. +O arquivo `gatsby-config.js` define os metadados do seu website, _plugins_, e outras configurações gerais. Este arquivo deve estar na raiz do seu website Gastby. Se você criou um Gatsby website com o comando `gatsby new`, já deve existir um arquivo de configuração de exemplo na pasta do seu website. @@ -56,7 +56,7 @@ Você pode então [acessar o título do website usando GraphQL](/tutorial/part-f ### _Plugins_ -_Plugins_ adicionam novas funcionalidades no seu Gatsby website. Por exemplo, alguns _plugins_ buscam dados de um serviço hospedado, transformam a formatação dos dados, ou redimensionam imagens. A [biblioteca de _plugins_ do Gatsby](/plugins) ajuda você a encontrar o _plugin_ correto para suas necessidades. +_Plugins_ adicionam novas funcionalidades no seu website Gatsby. Por exemplo, alguns _plugins_ buscam dados de um serviço hospedado, transformam a formatação dos dados, ou redimensionam imagens. A [biblioteca de _plugins_ do Gatsby](/plugins) ajuda você a encontrar o _plugin_ correto para suas necessidades. Instalando um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu Gatsby website. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` tenha o array, `_plugins_`, então você pode incluir um espaço para os _plugins_ necessários para construir o seu website: @@ -68,7 +68,7 @@ module.exports = { } ``` -Quando adicionando multiplos _plugins_, eles devem estar separados por vírgulas no array `_plugins_` para ser uma syntaxe válida de JavaScript. +Quando adicionando multiplos _plugins_, eles devem estar separados por vírgulas no array `_plugins_` para ser uma sintaxe válida de JavaScript. #### _Plugins_ sem opções From 4602faf81c3799ff26cfd53f5cbed65fc576395e Mon Sep 17 00:00:00 2001 From: Rafael Nunes Date: Tue, 7 Jan 2020 09:40:46 +1100 Subject: [PATCH 3/5] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Jessé Souza --- docs/docs/api-files-gatsby-config.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/docs/api-files-gatsby-config.md b/docs/docs/api-files-gatsby-config.md index 7276a1bf8..681ea9867 100644 --- a/docs/docs/api-files-gatsby-config.md +++ b/docs/docs/api-files-gatsby-config.md @@ -4,7 +4,7 @@ title: O arquivo da API gatsby-config.js O arquivo `gatsby-config.js` define os metadados do seu website, _plugins_, e outras configurações gerais. Este arquivo deve estar na raiz do seu website Gastby. -Se você criou um Gatsby website com o comando `gatsby new`, já deve existir um arquivo de configuração de exemplo na pasta do seu website. +Se você criou um website Gatsby com o comando `gatsby new`, já deve existir um arquivo de configuração de exemplo na pasta do seu website. ## Construindo o arquivo de configuração @@ -16,7 +16,7 @@ module.exports = { } ``` -Um exemplo de arquivo `gatsby-config.js` poderia ficar assim: +Um exemplo de arquivo `gatsby-config.js` poderia ser algo do tipo: ```javascript:title=gatsby-config.js module.exports = { @@ -58,7 +58,7 @@ Você pode então [acessar o título do website usando GraphQL](/tutorial/part-f _Plugins_ adicionam novas funcionalidades no seu website Gatsby. Por exemplo, alguns _plugins_ buscam dados de um serviço hospedado, transformam a formatação dos dados, ou redimensionam imagens. A [biblioteca de _plugins_ do Gatsby](/plugins) ajuda você a encontrar o _plugin_ correto para suas necessidades. -Instalando um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu Gatsby website. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` tenha o array, `_plugins_`, então você pode incluir um espaço para os _plugins_ necessários para construir o seu website: +Instalando um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu website Gatsby. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` contenha o array `_plugins_`,permitindo então que você possa incluir os _plugins_ necessários para construir o seu website dentro dele: ```javascript:title=gatsby-config.js module.exports = { From fdffa051584b0a2c32e647bc0bb5812bb6e3310d Mon Sep 17 00:00:00 2001 From: Rafael Nunes Date: Tue, 7 Jan 2020 09:41:37 +1100 Subject: [PATCH 4/5] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Jessé Souza --- docs/docs/api-files-gatsby-config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/api-files-gatsby-config.md b/docs/docs/api-files-gatsby-config.md index 681ea9867..665b9455f 100644 --- a/docs/docs/api-files-gatsby-config.md +++ b/docs/docs/api-files-gatsby-config.md @@ -42,7 +42,7 @@ Existem [muitas opções de configuração](/docs/gatsby-config) disponíveis, m ### Metadados do website -O objeto `siteMetadata` pode conter qualquer dado que você queira compartilhar em seu website. Um exemplo útil é o título do website. Se você guardar o título em `siteMetadata`, você pode alterar o título em um único lugar, e ele será atualizado por todo seu website. Para adicionar metadados inclua o objeto `siteMetadata` no seu arquivo de configuração: +O objeto `siteMetadata` pode conter qualquer dado que você queira compartilhar em seu website. Um exemplo útil é o título do website. Se você guardar o título em `siteMetadata`, você pode alterá-lo apenas em um único lugar, e ele será atualizado por todo seu website. Para adicionar metadados inclua o objeto `siteMetadata` no seu arquivo de configuração: ```javascript:title=gatsby-config.js module.exports = { From 52f8aa9bdbe55c1a973a65eb308a08e2451be1c4 Mon Sep 17 00:00:00 2001 From: Rafael Nunes Date: Thu, 9 Jan 2020 11:41:51 +1100 Subject: [PATCH 5/5] Apply suggestions from code review Co-Authored-By: Italo --- docs/docs/api-files-gatsby-config.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/docs/api-files-gatsby-config.md b/docs/docs/api-files-gatsby-config.md index 665b9455f..d41ea547d 100644 --- a/docs/docs/api-files-gatsby-config.md +++ b/docs/docs/api-files-gatsby-config.md @@ -58,7 +58,7 @@ Você pode então [acessar o título do website usando GraphQL](/tutorial/part-f _Plugins_ adicionam novas funcionalidades no seu website Gatsby. Por exemplo, alguns _plugins_ buscam dados de um serviço hospedado, transformam a formatação dos dados, ou redimensionam imagens. A [biblioteca de _plugins_ do Gatsby](/plugins) ajuda você a encontrar o _plugin_ correto para suas necessidades. -Instalando um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu website Gatsby. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` contenha o array `_plugins_`,permitindo então que você possa incluir os _plugins_ necessários para construir o seu website dentro dele: +Instalar um _plugin_ utilizando um gerenciador de pacotes como o `npm` **não** habilita ele no seu website Gatsby. Para finalizar a adição de um _plugin_ tenha certeza que seu arquivo `gatsby-config.js` contenha o array `plugins`, permitindo então que você possa incluir os _plugins_ necessários para construir o seu website dentro dele: ```javascript:title=gatsby-config.js module.exports = { @@ -68,7 +68,7 @@ module.exports = { } ``` -Quando adicionando multiplos _plugins_, eles devem estar separados por vírgulas no array `_plugins_` para ser uma sintaxe válida de JavaScript. +Quando for adicionar múltiplos _plugins_, eles devem estar separados por vírgulas no array `_plugins_` para ser uma sintaxe válida de JavaScript. #### _Plugins_ sem opções @@ -121,4 +121,4 @@ module.exports = { ## Opções de configuração adicionais -Existem várias configurações opções disponíveis para o arquivo `gatsby-config.js`. Você pode encontrar uma lista de cada opçõe na página [Configuração da API do Gatsby](/docs/gatsby-config/). +Existem várias outras opções de configurações disponíveis para o arquivo `gatsby-config.js`. Você pode encontrar uma lista de cada opção na página [Configuração da API do Gatsby](/docs/gatsby-config/).