Skip to content

Commit

Permalink
i18n(pt-BR): update editor-setup.mdx (#9444)
Browse files Browse the repository at this point in the history 
* feat: update i18n/pt-br/editor-setup.mdx translation

* i18n(pt-BR): review i18n/pt-br/editor-setup.mdx content

---------

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
  • Loading branch information
@viniciusdeliz @yanthomasdev
viniciusdeliz and yanthomasdev committed Sep 19, 2024
1 parent 6cf12ee commit 084003d
Showing 1 changed file with 94 additions and 54 deletions.
148 changes: 94 additions & 54 deletions src/content/docs/pt-br/editor-setup.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,98 +4,138 @@ description: Configure seu editor para desenvolver com Astro.
i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
import { Steps } from '@astrojs/starlight/components';
import Badge from "~/components/Badge.astro"

Customize seu editor de código para melhorar a sua experiência de desenvolvimento com Astro e desfrute de novas funcionalidades.
Personalize seu editor de código para melhorar a experiência de desenvolvedor Astro e destravar novas funcionalidades.

## VS Code

[VS Code](https://code.visualstudio.com) é um popular editor de código para desenvolvedores web, feito pela Microsoft. O motor do VS Code também viabiliza editores de código populares no navegador como o [GitHub Codespaces](https://github.com/features/codespaces) e o [Gitpod](https://gitpod.io).
[VS Code](https://code.visualstudio.com) é um editor de código popular para desenvolvedores web, feito pela Microsoft. O motor do VS Code também alimenta editores de código no navegador populares como [GitHub Codespaces](https://github.com/features/codespaces) e [Gitpod](https://gitpod.io).

Astro funciona com qualquer editor de código. Porém, VS Code é o nosso editor recomendado para projetos Astro. Nós mantemos uma [extensão Astro oficial para VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) que permite desfrutar de várias funcionalidades-chave e melhorias na experiência do desenvolvedor em projetos Astro.
Astro funciona com qualquer editor de código. Entretanto, VS Code é o nosso editor recomendado para projetos Astro. Nós mantemos uma [extensão Astro VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) oficial que destrava diversas funcionalidades-chave e melhorias na experiência do desenvolvedor em projetos Astro.

- Syntax highlighting para arquivos `.astro`.
- Informação de tipos do TypeScript para arquivos `.astro`.
- [VS Code Intellisense](https://code.visualstudio.com/docs/editor/intellisense) para complementação de código, dicas e mais.
- Destaque de sintaxe em arquivos `.astro`.
- Informação de tipos TypeScript em arquivos `.astro`.
- [VS Code Intellisense](https://code.visualstudio.com/docs/editor/intellisense) para preenchimento de código, dicas e mais.

Para começar, instale a [extensão Astro para VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) hoje.
Para começar, instale a [extensão Astro VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) hoje.

import ReadMore from '~/components/ReadMore.astro';

<ReadMore>Veja como [configurar TypeScript](/pt-br/guides/typescript/) em seu projeto Astro.</ReadMore>

## Zed

[Zed](https://zed.dev/) é um editor de código aberto que adicionou suporte para Astro na versão 0.123.2. Você pode instalar a [extensão Astro](https://github.com/zed-industries/zed/tree/main/extensions/astro) na aba de Extensões da IDE. Esta extensão inclui funcionalidades como syntax highlighting, code completion e formatação.
[Zed](https://zed.dev/) é um editor de código aberto que adicionou suporte para Astro na versão 0.123.2. Você pode instalar a [extensão Astro](https://github.com/zed-industries/zed/tree/main/extensions/astro) na aba de Extensões da IDE. Esta extensão inclui funcionalidades como destaque de sintaxe, preenchimento de código e formatação.


## IDEs da JetBrains

Suporte inicial para Astro foi lançado no WebStorm 2023.1. Você pode instalar o plugin oficial no [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/20959-astro) ou pesquisando por "Astro" na aba de Plugins da IDE. Este plugin inclui funcionalidades como syntax highlighting, code completion e formatação, com planos para adicionar funcionalidades ainda mais avançadas no futuro. Ele está também disponível em todos as outras [IDEs da JetBrains com suporte para JavaScript](https://www.jetbrains.com/products/#lang=js&type=ide).
[Webstorm](https://www.jetbrains.com/webstorm/) é uma IDE de JavaScript e TypeScript que adicionou suporte para Astro Language Server na versão 2024.2. Essa atualização trás funcionalidades como destaque de sintaxe, preenchimento de código e formatação.

Instale o plugin oficial através do [Marketplace JetBrains](https://plugins.jetbrains.com/plugin/20959-astro) ou ao procurar por "Astro" na aba de plugins da IDE. Você pode ativar ou desativar o Astro Language Server em `Configurações | Linguagens & Frameworks | TypeScript | Astro`.

Para mais informações sobre o suporte de Astro no Webstorm, confira [a documentação oficial Webstorm Astro](https://www.jetbrains.com/help/webstorm/astro.html).

## Outros Editores de Código

Nossa espetacular comunidade mantém várias extensões para outros editores populares, incluindo:
Nossa comunidade incrível mantém várias extensões para outros editores populares, incluindo:

- [Extensão para VS Code na Open VSX](https://open-vsx.org/extension/astro-build/astro-vscode) <span style="margin: 0.25em;"><Badge text="Oficial" /></span> - A extensão oficial do Astro para VS Code, disponível no registro Open VSX para plataformas abertas como [VSCodium](https://vscodium.com/)
- [Extensão para Nova](https://extensions.panic.com/extensions/sciencefidelity/sciencefidelity.astro/)<span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Oferece syntax highlighting e autocompletar de código para o Astro dentro do Nova
- [Plugin para Vim](https://github.com/wuelnerdotexe/vim-astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Oferece syntax highlighting, indentação e code folding para Astro dentro do Vim ou Neovim
- Plugins Neovim [LSP](https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md#astro) e [TreeSitter](https://github.com/virchau13/tree-sitter-astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Oferece syntax highlighting, treesitter parsing e autocompletar de código para Astro dentro do Neovim
- Emacs - Consulte as instruções para [Configurar o Emacs e o Eglot](https://medium.com/@jrmjrm/configuring-emacs-and-eglot-to-work-with-astro-language-server-9408eb709ab0) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> para funcionar com o Astro
- [Syntax highlighting do Astro para o Sublime Text](https://packagecontrol.io/packages/Astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - O pacote Astro para o Sublime Text, disponível no gerenciador de pacotes do Sublime Text.
- [Extensão VS Code no Open VSX](https://open-vsx.org/extension/astro-build/astro-vscode) <span style="margin: 0.25em;"><Badge text="Oficial" /></span> - A extensão oficial do Astro para VS Code, disponível no registro Open VSX para plataformas abertas como [VSCodium](https://vscodium.com/)
- [Extensão Nova](https://extensions.panic.com/extensions/sciencefidelity/sciencefidelity.astro/)<span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Fornece destaque de sintaxe highlighting e preenchimento de código para Astro dentro do Nova
- [Plugin Vim](https://github.com/wuelnerdotexe/vim-astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Fornece destaque de sintaxe, indentação e suporte para arquivamento de código em Astro dentro do Vim ou Neovim
- Plugins Neovim [LSP](https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md#astro) e [TreeSitter](https://github.com/virchau13/tree-sitter-astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - Fornece destaque de sintaxe, interpretação treesitter e preenchimento de código em Astro dentro do Neovim
- Emacs - Veja as instruções para [Configurar Emacs e Eglot](https://medium.com/@jrmjrm/configuring-emacs-and-eglot-to-work-with-astro-language-server-9408eb709ab0) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> com Astro
- [Destaque de sintaxe Astro para Sublime Text](https://packagecontrol.io/packages/Astro) <span style="margin: 0.25em;"><Badge class="neutral-badge" text="Comunidade" /></span> - O pacote Astro para Sublime Text, disponível no gerenciador de pacotes Sublime Text.

## Editores no Navegador

Além dos editores locais, o Astro também funciona bem em editores hospedados no navegador, incluindo:
Além dos editores locais, Astro também funciona bem em editores direto no navegador, incluindo:

- [StackBlitz](https://stackblitz.com) e [CodeSandbox](https://codesandbox.io) - editores online que rodam no seu navegador, com syntax highlight por padrão para arquivos `.astro`. Sem instalação ou configuração necessária!
- [GitHub.dev](https://github.dev) - permite que você instale a extensão Astro para VS Code como uma [extensão web](https://code.visualstudio.com/api/extension-guides/web-extensions), que te dá acesso a somente algumas das funcionalidades da extensão completa. Atualmente, apenas o syntax highlight é suportado.
- [Gitpod](https://gitpod.io) - um completo ambiente de desenvolvimento na nuvem em que se pode instalar a extensão oficial Astro para VS Code pela Open VSX.
- [StackBlitz](https://stackblitz.com) e [CodeSandbox](https://codesandbox.io) - editores online que rodam no seu navegador, com destaque de sintaxe embutido para arquivos `.astro`. Sem instalação ou configuração necessária!
- [GitHub.dev](https://github.dev) - permite que você instale a extensão Astro VS Code como uma [extensão web](https://code.visualstudio.com/api/extension-guides/web-extensions), que te dá acesso a apenas algumas das funcionalidades da extensão completa. Atualmente, apenas o destaque de sintaxe é suportado.
- [Gitpod](https://gitpod.io) - um ambiente de desenvolvimento completo na nuvem que pode instalar a extensão oficial Astro VS Code do Open VSX.

## Outras ferramentas

### ESLint

[ESLint](https://eslint.org/) é um popular linter para JavaScript e JSX. Para suporte com o Astro, [um plugin mantido pela comunidade](https://github.com/ota-meshi/eslint-plugin-astro) pode ser instalado.
[ESLint](https://eslint.org/) é um _linter_ popular para JavaScript e JSX. Para suporte Astro, [um plugin mantido pela comunidade](https://github.com/ota-meshi/eslint-plugin-astro) pode ser instalado.

Veja [o Guia de Usuário do projeto](https://ota-meshi.github.io/eslint-plugin-astro/user-guide/) para mais informações em como instalar e configurar o ESLint para seu projeto.
Veja [o Guia de Usuário do projeto](https://ota-meshi.github.io/eslint-plugin-astro/user-guide/) para mais informações sobre como instalar e configurar o ESLint para seu projeto.

### Stylelint

[Stylelint](https://stylelint.io/) é um linter popular para CSS. [Uma configuração do Stylelint mantida pela comunidade](https://github.com/ota-meshi/stylelint-config-html) adiciona suporte ao Astro.
[Stylelint](https://stylelint.io/) é um _linter_ popular para CSS. [Uma configuração do Stylelint mantida pela comunidade](https://github.com/ota-meshi/stylelint-config-html) fornece suporte ao Astro.

Instruções de instalação, integração com editores e informações adicionais podem ser encontradas no README do projeto.

### Prettier

[Prettier](https://prettier.io/) é um popular formatador para JavaScript, HTML, CSS e mais. Se você está utilizando a [Extensão do Astro para VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) ou [o servidor da linguagem do Astro em outro editor](#outros-editores-de-código), formatação de código com Prettier está inclusa.

Para adicionar suporte para formatação de arquivos `.astro` fora do editor (por exemplo, CLI) ou em editores que não suportam nossas ferramentas de editor, instale [o plugin oficial do Prettier para Astro](https://github.com/withastro/prettier-plugin-astro).

Para começar, primeiro instale Prettier e o plugin:

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install --save-dev prettier prettier-plugin-astro
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm add -D prettier prettier-plugin-astro
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn add --dev prettier prettier-plugin-astro
```
</Fragment>
</PackageManagerTabs>

Prettier irá automaticamente detectar o plugin e usá-lo para processar arquivos `.astro` quando você executá-lo:

```shell
prettier --write .
```

Veja o [README do plugin do Prettier](https://github.com/withastro/prettier-plugin-astro/blob/main/README.md) para mais informações sobre as opções suportadas, como configurar o Prettier dentro do VS Code e mais.
[Prettier](https://prettier.io/) é um formatador popular para JavaScript, HTML, CSS e mais. Se você está utilizando a [Extensão Astro VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) ou [o servidor da linguagem Astro dentro de outro editor](#outros-editores-de-código), a formatação de código com Prettier está inclusa.

Para adicionar suporte para formatação de arquivos `.astro` fora do editor (como na CLI) ou dentro de editores que não suportam nossas ferramentas de editor, instale [o plugin oficial Astro Prettier](https://github.com/withastro/prettier-plugin-astro).

<Steps>
1. Instale `prettier` e `prettier-plugin-astro`.

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install --save-dev prettier prettier-plugin-astro
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm add -D prettier prettier-plugin-astro
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn add --dev prettier prettier-plugin-astro
```
</Fragment>
</PackageManagerTabs>

2. Crie um arquivo de configuração `.prettierrc.mjs` no diretório raiz do projeto e adicione `prettier-plugin-astro` nele.

Neste arquivo, também especifique manualmente o interpretador para arquivos Astro.

```js title=".prettierrc.mjs"
/** @type {import("prettier").Config} */
export default {
plugins: ['prettier-plugin-astro'],
overrides: [
{
files: '*.astro',
options: {
parser: 'astro',
},
},
],
};
```

3. Execute o comando `prettier . --write` no terminal para formatar seus arquivos.

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npx prettier . --write
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm exec prettier . --write
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn prettier . --write
```
</Fragment>
</PackageManagerTabs>
</Steps>

Veja o [README do plugin Prettier](https://github.com/withastro/prettier-plugin-astro/blob/main/README.md) para mais informações sobre as opções suportadas, como configurar o Prettier dentro do VS Code e mais.

0 comments on commit 084003d

Please sign in to comment.