diff --git a/docs/docs/path-prefix.md b/docs/docs/path-prefix.md index b22358785..23a4ecd63 100644 --- a/docs/docs/path-prefix.md +++ b/docs/docs/path-prefix.md @@ -1,21 +1,20 @@ --- -title: Adding a Path Prefix +title: Adicionando um prefixo na rota --- -Many applications are hosted at something other than the root (`/`) of their domain. +Muitas aplicações são hospedadas em alguma rota que não necessariamente é a rota raiz (`/`) de seu domínio. -For example, a Gatsby blog could live at `example.com/blog/`, or a site could be hosted on GitHub Pages at `example.github.io/my-gatsby-site/`. +Por exemplo, um blog feito com Gatsby poderia viver em `example.com/blog/`, ou um website poderia ser hospedado no GitHub Pages em `example.github.io/my-gatsby-site/`. -Each of these sites need a prefix added to all paths on the site. So a link to -`/my-sweet-blog-post/` should be rewritten as `/blog/my-sweet-blog-post`. +Cada um destes websites precisam de um prefixo adicionado para todas as rotas no website. Fazendo com que um link para `/my-sweet-blog-post` devesse ser reescrito como `/blog/my-sweet-blog-post`. -In addition, links to various resources (JavaScript, CSS, images, and other static content) need the same prefix, so that the site continues to function correctly when served with the path prefix in place. +Além disso, links para vários recursos (JavaScript, CSS, imagens, e outros conteúdos estáticos) precisam do mesmo prefixo para que o website continue a funcionar corretamente quando servido com o prefixo adicionado. -Adding the path prefix is a two step process, as follows: +Adicionar o prefixo na rota é um processo de dois passos, são eles: -### Add to `gatsby-config.js` +### Adicionar em `gatsby-config.js` -Firstly, add a `pathPrefix` value to your `gatsby-config.js`. +Primeiramente, adicione o valor do `pathPrefix` no seu `gatsby-config.js`. ```js:title=gatsby-config.js module.exports = { @@ -23,23 +22,23 @@ module.exports = { } ``` -### Build +### Fazer o Build -The final step is to build your application with the `--prefix-paths` flag, like so: +O passo final é fazer o _build_ da sua aplicação com a opção `--prefix-paths`, assim: ```shell gatsby build --prefix-paths ``` -If this flag is not passed, Gatsby will ignore your `pathPrefix` and build the site as if hosted from the root domain. +Se essa opção não for passada, Gatsby ignorará seu `pathPrefix` e fará o build do website como se estivesse hospedado na raiz do domínio. -### In-app linking +### Links dentro da aplicação -Gatsby provides APIs and libraries to make using this feature seamless. Specifically, the [`Link`](/docs/gatsby-link/) component has built-in functionality to handle path prefixing. +O Gatsby provê APIs e bibliotecas para fazer uso dessa funcionalidade sem problemas. Especificamente, o componente [`Link`](/docs/gatsby-link/) tem uma funcionalidade embutida para lidar com prefixo na rota. -For example, if you want to link to the location `/page-2`, but the actual link will be prefixed (e.g. `/blog/page-2`); you don't need to hard code the prefix into your links. By using the Gatsby `Link` component, paths will automatically be prefixed with the `pathPrefix` value assigned in your `gatsby-config.js` file. If you later migrate away from using a path prefix, your links will _still_ work seamlessly. +Por exemplo, se você quiser um link para a rota `/page-2`, mas na realidade o link final será prefixado (e.g. `/blog/page-2`); você não precisa colocar o prefixo em todos os seus links. Usando o componente `Link` do Gatsby, as rotas serão prefixadas automaticamente com o valor do `pathPrefix` especificado no seu arquivo `gatsby-config.js`. Se depois você migrar e não usar mais o prefixo na rota, seus links _ainda_ continuarão funcionando sem problemas. -For example, when navigating to the `page-2` location in the `Link` component below; the location will be automatically prefixed with your assigned `pathPrefix` value. +Por exemplo, quando navegando para a rota `page-2` no componente de `Link` abaixo; a localização será automaticamente prefixada com o valor especificado no `pathPrefix`. ```jsx:title=src/pages/index.js import React from "react" @@ -56,7 +55,7 @@ function Index() { } ``` -If you want to do programmatic/dynamic navigation, this is also possible! Expose the Gatsby `navigate` helper, and this too automatically handles path prefixing. +Se você quiser fazer navegação programática/dinâmica isso também é possível! Utilize a função auxiliar `navigate` do Gatsby e ela também cuidará automaticamente da prefixação da rota. ```jsx:title=src/pages/index.js import React from "react" @@ -66,7 +65,7 @@ import Layout from "../components/layout" export default function Index() { return ( - {/* Note: this is an intentionally contrived example, but you get the idea! */} + {/* Nota: esse é um exemplo propositalmente simples, mas você pegou a ideia! */} {/* highlight-next-line */}