Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

i18n(pt-BR): Update configuring-astro.mdx translation #8043

Merged
merged 2 commits into from
Apr 29, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions src/content/docs/pt-br/guides/configuring-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,12 @@
title: Configurando Astro
i18nReady: true
---
import ReadMore from '~/components/ReadMore.astro'

Customize o funcionamento do Astro adicionando um arquivo `astro.config.mjs` em seu projeto. Este é um arquivo comum em projetos Astro e todos os templates oficiais o incluem por padrão.

📚 Leia a [referência de configuração da API](/pt-br/reference/configuration-reference/) do Astro para uma visão geral de todas as opções de configuração suportadas.
<ReadMore>Leia a [referência de configuração da API](/pt-br/reference/configuration-reference/) do Astro para uma visão geral de todas as opções de configuração suportadas.</ReadMore>

## O Arquivo de Configuração Astro

Um arquivo de configuração Astro válido exporta sua configuração com a exportação `default`, usando a função auxiliar `defineConfig`:
Expand All @@ -32,6 +34,7 @@ export default {}
Astro suporta outros formatos de arquivos para seu arquivo de configuração JavaScript: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` e `astro.config.ts`. Nós recomendamos utilizar `.mjs` na maioria dos casos ou `.ts` se você quiser escrever TypeScript no seu arquivo de configuração.

O arquivo de configuração TypeScript é gerenciado usando o [`tsm`](https://github.com/lukeed/tsm) e irá respeitar as opções definidas no `tsconfig` do seu projeto.

## Resolução do Arquivo de Configuração

Astro irá tentar buscar automaticamente um arquivo de configuração com o nome `astro.config.mjs` na raiz de seu projeto. Se nenhum arquivo for encontrado, as opções padrão do Astro serão utilizadas.
Expand All @@ -57,7 +60,7 @@ Astro recomenda o uso da função auxiliar `defineConfig()` em seu arquivo de co
import { defineConfig } from 'astro/config'

export default defineConfig({
// Seu arquivo de configuração aqui...
// suas opções de configuração aqui...
// https://docs.astro.build/pt-br/reference/configuration-reference/
})
```
Expand All @@ -67,7 +70,7 @@ Você também pode providenciar manualmente as definições de tipo para o VSCod
```js
// astro.config.mjs
export default /** @type {import('astro').AstroUserConfig} */ {
// Seu arquivo de configuração aqui...
// suas opções de configuração aqui...
// https://docs.astro.build/pt-br/reference/configuration-reference/
}
```
Expand All @@ -81,7 +84,7 @@ Se você providenciar um caminho relativo à opção `root` ou passar a opção
import { defineConfig } from 'astro/config'

export default defineConfig({
// Resolve o caminho "./foo" em seu diretório de trabalho atual.
// Resulta no diretório "./foo" em seu diretório de trabalho atual
root: 'foo'
})
```
Expand All @@ -93,9 +96,9 @@ Astro irá resolver todos os outros arquivos e diretórios relativos à raiz do
import { defineConfig } from 'astro/config'

export default defineConfig({
// Resolve o caminho "./foo" em seu diretório de trabalho atual.
// Resulta no diretório "./foo" em seu diretório de trabalho atual
root: 'foo',
// Resolve o caminho "./foo/public" em seu diretório de trabalho atual.
// Resulta no diretório "./foo/public" em seu diretório de trabalho atual
publicDir: 'public',
})
```
Expand All @@ -107,9 +110,9 @@ Para referenciar um arquivo ou diretório relativo ao arquivo de configuração,
import { defineConfig } from 'astro/config'

export default defineConfig({
// Resolve o caminho "./foo" relativo a este arquivo de configuração.
// Resulta no diretório "./foo" relativo a este arquivo de configuração.
root: new URL("./foo", import.meta.url).toString(),
// Resolve o caminho "./public" relativo a este arquivo de configuração.
// Resulta no diretório "./foo/public" relativo a este arquivo de configuração.
publicDir: new URL("./public", import.meta.url).toString(),
})
```
Expand Down Expand Up @@ -146,12 +149,14 @@ Isto pode ser útil caso você tenha scripts com nomes que podem ser afetados po
## Variáveis de Ambiente

Astro verifica arquivos de configuração antes de carregar seus outros arquivos. Portanto, você não pode utilizar `import.meta.env` para acessar variáveis de ambiente que foram definidas em arquivos `.env`.

Você pode utilizar `process.env` em um arquivo de configuração para acessar outras variáveis de ambiente, como aquelas [definidas pela CLI](/pt-br/guides/environment-variables/#usando-a-cli).

Você também pode utilizar [o utilitário `loadEnv` do Vite](https://main.vitejs.dev/config/#using-environment-variables-in-config) para manualmente carregar arquivos `.env`.

:::note
O `pnpm` não permite você importar módulos que não estão diretamente instalados no seu projeto. Se você está usando `pnpm`, você terá que instalar `vite` para usar o utilitário `loadEnv`.

```sh
pnpm add vite --save-dev
```
Expand All @@ -164,5 +169,4 @@ const { SENHA_SECRETA } = loadEnv(process.env.NODE_ENV, process.cwd(), "");

## Referência de Configuração

📚 Leia a [referência de configuração da API](/pt-br/reference/configuration-reference/) do Astro para uma visão geral de todas as opções de configuração suportadas.

<ReadMore>Leia a [referência de configuração da API](/pt-br/reference/configuration-reference/) do Astro para uma visão geral de todas as opções de configuração suportadas.</ReadMore>
Loading