Skip to content

Commit 996fd91

Browse files
docs(pt): update get-started folder and concepts/index (#2252)
1 parent d3d4121 commit 996fd91

File tree

7 files changed

+178
-194
lines changed

7 files changed

+178
-194
lines changed

Diff for: content/pt/docs/1.get-started/1.installation.md

+64-65
Original file line numberDiff line numberDiff line change
@@ -1,102 +1,103 @@
11
---
22
title: Instalação
3-
description: Aqui, você vai encontrar informações sobre como configurar e iniciar um projeto Nuxt em 4 passos.
3+
description: Neste artigo, encontraremos informação sobre como configurar e executar um projeto de Nuxt dentro de 4 passos.
44
category: get-started
55
csb_link: https://codesandbox.io/embed/github/nuxt-academy/guides-examples/tree/master/01_get_started/01_installation?fontsize=14&hidenavigation=1&theme=dark
66
CreateNuxtAppVideo: wHkPjOmJTt0
7-
CreateNuxtAppVideoTitle: Usando create-nuxt-app
7+
CreateNuxtAppVideoTitle: Usar a create-nuxt-app
88
ManualInstallVideo: mKV_9AIG70E
9-
ManualInstallVideoTitle: Instalar Nuxt manualmente
9+
ManualInstallVideoTitle: Instalar a Nuxt Manualmente
1010
---
1111

1212
# Instalação
1313

14-
Aqui, você vai encontrar informações sobre como configurar e iniciar um projeto Nuxt em 4 passos.
14+
Neste artigo, encontraremos informação sobre como configurar e executar um projeto de Nuxt dentro de 4 passos.
1515

1616
---
1717

18-
## Online playground
18+
## Zona de Testes Virtuais
1919

20-
Você pode divertir-se com o Nuxt de forma online, diretamente pelo CodeSandbox ou StackBlitz:
21-
:app-button[Divertir-se no CodeSandbox]{href=https://codesandbox.io/s/github/nuxt/codesandbox-nuxt/tree/master/ size="small" externalIcon}
22-
:app-button[Divertir-se no StackBlitz]{href=https://stackblitz.com/github/nuxt/starter/tree/stackblitz size="small" externalIcon}
20+
Podemos brincar com a Nuxt diretamente na CodeSandbox ou na StackBlitz:
21+
22+
:app-button[Brincar na CodeSandbox]{href=https://codesandbox.io/s/github/nuxt/codesandbox-nuxt/tree/master/ size="small" externalIcon}
23+
:app-button[Brincar na StackBlitz]{href=https://stackblitz.com/github/nuxt/starter/tree/stackblitz size="small" externalIcon}
2324

2425
## Pré-requisitos
2526

26-
- [node](https://nodejs.org) - _Nós recomendamos que você tenha a última versão LTS instalada_.
27-
- Um editor de texto, nós recomendamos [VS Code](https://code.visualstudio.com/) com a extensão [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur) ou [WebStorm](https://www.jetbrains.com/webstorm/)
27+
- [node](https://nodejs.org) - _recomendamos ter a ou a 16.x ou a 14.x instalada_.
28+
- Um editor de texto, recomendamos [VS Code](https://code.visualstudio.com/) com a extensão [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) ou [WebStorm](https://www.jetbrains.com/webstorm/)
2829
- Um terminal, nós recomendamos utilizar o [terminal integrado](https://code.visualstudio.com/docs/editor/integrated-terminal) do VS Code ou [terminal WebStorm](https://www.jetbrains.com/help/webstorm/terminal-emulator.html).
2930

30-
## Usando create-nuxt-app
31+
## Usar a `create-nuxt-app`
3132

32-
Para iniciar rapidamente, você pode utilizar [create-nuxt-app](https://github.com/nuxt/create-nuxt-app).
33+
Para iniciarmos rapidamente, podemos usar a [`create-nuxt-app`](https://github.com/nuxt/create-nuxt-app).
3334

34-
Tenha certeza que você possui instalado o yarn, npx (incluido por padrão no npm v5.2+) ou npm (v6.1+).
35+
Precisamos de certificar-nos de que temos instalado as ferramentas, yarn, npx (incluída por padrão com a npm v5.2+) ou npm (v6.1+).
3536

3637
::code-group
37-
3838
```bash [Yarn]
3939
yarn create nuxt-app <project-name>
4040
```
41-
4241
```bash [NPX]
4342
npx create-nuxt-app <project-name>
4443
```
45-
4644
```bash [NPM]
4745
npm init nuxt-app <project-name>
4846
```
49-
47+
```bash [PNPM]
48+
pnpm create nuxt-app <project-name>
49+
```
5050
::
5151

52-
O terminal irá fazer algumas perguntas (nome, opções do Nuxt, framework de UI, TypeScript, linter, framework de testes, etc). Para encontrar mais detalhes sobre todas essas opções veja a [documentação create-nuxt-app](https://github.com/nuxt/create-nuxt-app/blob/master/README.md).
52+
O programa fazer-nos-á algumas perguntas (nome, opções da Nuxt, abstração de interface de utilizador, TypeScript, analisador de código, abstração de teste, etc). Para sabermos mais sobre todas as opções, podemos consultar a [documentação da `create-nuxt-app`](https://github.com/nuxt/create-nuxt-app/blob/master/README.md).
5353

54-
Uma vez que todas as questões foram respondidas, será instalada todas as dependências. O próximo passo é navegar para a pasta do projeto e inicia-lo:
54+
Quando todas as perguntas forem respondidas, esta instalará todas as dependências. O passo seguinte é navegar para a pasta do projeto e iniciá-lo:
5555

5656
::code-group
57-
5857
```bash [Yarn]
5958
cd <project-name>
6059
yarn dev
6160
```
62-
6361
```bash [NPM]
6462
cd <project-name>
6563
npm run dev
6664
```
67-
65+
```bash [PNPM]
66+
cd <project-name>
67+
pnpm dev
68+
```
6869
::
6970

70-
A aplicação agora estará rodando em [http://localhost:3000](http://localhost:3000). Parabéns!
71+
A aplicação está agora a ser executada em [http://localhost:3000](http://localhost:3000). Muito bem!
7172

7273
::alert{type="info"}
73-
Outra forma de iniciar o Nuxt é utilizando [CodeSandbox](https://template.nuxtjs.org) o qual é uma ótima maneira de iniciar rapidamente no Nuxt e/ou compartilhar o seu código com outras pessoas.
74+
Outra maneira de começar a usar a Nuxt é com o uso da [CodeSandbox](https://template.nuxtjs.org), que é uma excelente maneira de brincar rapidamente com a Nuxt e/ou partilhar o nosso código com outras pessoas.
7475
::
7576

76-
## Instalação manual
77+
## Instalação Manual
7778

78-
Criar um projeto Nuxt do início vai necessitar apenas de um arquivo e uma pasta.
79+
A criação de um projeto de Nuxt a partir do zero requer apenas um ficheiro e um diretório.
7980

80-
Nós vamos usar o terminal para criar os diretórios e arquivos, sinta-se livre para criar usando um editor de sua escolha.
81+
Utilizaremos o terminal para criar os diretórios e ficheiros, mas podemos criá-los com o uso do nosso editor de eleição.
8182

82-
### Configurando o seu projeto
83+
### Configurar o nosso projeto
8384

84-
Crie uma pasta vazia com o nome do seu projeto e navegue para dentro dele :
85+
Criaremos um diretório vazio com o nome do nosso projeto e navegaremos para ele:
8586

8687
```bash
8788
mkdir <project-name>
8889
cd <project-name>
8990
```
9091

91-
_Substitua `<project-name>` com o nome do seu projeto._
92+
_Devemos substituir `<project-name>` pelo nome do nosso projeto._
9293

93-
Crie o arquivo `package.json` :
94+
Criaremos o ficheiro `package.json`:
9495

9596
```bash
9697
touch package.json
9798
```
9899

99-
Preencha o conteúdo do seu `package.json` com :
100+
Preencheremos o conteúdo do nosso `package.json` com:
100101

101102
```json{}[package.json]
102103
{
@@ -110,112 +111,110 @@ Preencha o conteúdo do seu `package.json` com :
110111
}
111112
```
112113

113-
`scripts` define os comandos do Nuxt que serão executados com o comando `npm run <command>` ou `yarn <command>`.
114+
`scripts` definem comandos da Nuxt que serão iniciados com o comando `npm run <command>` ou `yarn <command>`.
114115

115-
#### **O que é o arquivo package.json ?**
116+
#### **O que é um ficheiro `package.json`?**
116117

117-
O arquivo `package.json` é como o documento de identificação do seu projeto. Ele irá conter todas as dependências do projeto e muito mais. Se você não sabe o que é o arquivo `package.json`, nós recomendamos imensamente a leitura da documentação do [npm](https://docs.npmjs.com/creating-a-package-json-file).
118+
O ficheiro `package.json` é como o cartão de identificação do nosso projeto. Contém todas as dependências do projeto e muito mais. Se não soubermos o que é o ficheiro `package.json`, podemos dar uma leitura rápida da [documentação da npm](https://docs.npmjs.com/creating-a-package-json-file).
118119

119-
### Instalando Nuxt
120+
### Instalar a Nuxt
120121

121-
Uma vez que o `package.json` foi criado, adicione `nuxt` no seu projeto via `npm` or `yarn` utilizando um dos comandos abaixo:
122+
Uma vez que o `package.json` tenha sido criado, adicionamos a `nuxt` ao nosso projeto via `npm` ou `yarn` como abaixo:
122123

123124
::code-group
124-
125125
```bash [Yarn]
126126
yarn add nuxt
127127
```
128-
129128
```bash [NPM]
130129
npm install nuxt
131130
```
132-
131+
```bash [PNPM]
132+
pnpm add nuxt --shamefully-hoist
133+
```
133134
::
134135

135-
Esse comando vai adicionar `nuxt` como uma dependência para o seu projeto e vai adiciona-lo no seu `package.json`. A pasta `node_modules` também será criada, é aonde todos os seus pacotes instalados e dependencias serão salvas.
136+
Este comando adicionará a `Nuxt` como uma dependência ao nosso projeto e adicionar-lo-á ao nosso `package.json`. O diretório `node_modules` também será criado, o qual é onde todos os nossos pacotes instalados e dependências serão armazenados.
136137

137138
::alert{type="info"}
138139

139-
Um arquivo `yarn.lock` ou `package-lock.json` também será criado, o qual garante consistência e a compatibilidade das dependências instaladas no seu projeto.
140+
Um `yarn.lock` ou `package-lock.json` também é criado, garantindo uma instalação consistente e dependências compatíveis dos nossos pacotes instalados no nosso projeto.
140141

141142
::
142143

143-
### Criando a sua primeira página
144+
### Criar a nossa primeira página
144145

145-
Nuxt transforma todos arquivos `*.vue` dentro da pasta `pages` em rotas para a aplicação.
146+
A Nuxt transforma cada ficheiro `*.vue` dentro do diretório `pages` numa rota para a aplicação.
146147

147-
Crie a pasta `pages` dentro do seu projeto :
148+
Criamos o diretório `pages` no nosso projeto:
148149

149150
```bash
150151
mkdir pages
151152
```
152153

153-
Então, crie um arquivo `index.vue` dentro da pasta `pages` :
154+
Depois, criamos um ficheiro `index.vue` dentro do diretório `pages`:
154155

155156
```bash
156157
touch pages/index.vue
157158
```
158159

159-
É importante que essa página seja nomeada `index.vue` dessa forma ela será a página principal que o Nuxt irá mostrar quando a aplicação abrir.
160+
É importante que esta página se chame `index.vue`, pois esta será a página inicial padrão que a Nuxt mostrará quando a aplicação abrir.
160161

161-
Abra o arquivo `index.vue` no seu editor e adicione o seguinte conteúdo :
162+
Abrimos o ficheiro `index.vue` no nosso editor e adicionamos o seguinte conteúdo:
162163

163164
```html{}[pages/index.vue]
164165
<template>
165166
<h1>Hello world!</h1>
166167
</template>
167168
```
168169

169-
### Iniciando o projeto
170+
### Iniciar o projeto
170171

171-
Inicie o seu projeto executando um dos seguintes comandos abaixo :
172+
Executamos o nosso projeto escrevendo um dos seguintes comandos no nosso terminal:
172173

173174
::code-group
174-
175175
```bash [Yarn]
176176
yarn dev
177177
```
178-
179178
```bash [NPM]
180179
npm run dev
181180
```
182-
181+
```bash [PNPM]
182+
pnpm dev
183+
```
183184
::
184185

185186
::alert{type="info"}
186187

187-
Nós usamos o comando dev quando iniciamos a nossa aplicação no modo de desenvolvimento.
188+
Utilizamos o comando `dev` para executar a nossa aplicação em modo de desenvolvimento.
188189

189190
::
190191

191-
A aplicação está agora rodando em **[http://localhost:3000](http://localhost:3000/)**.
192+
A aplicação está agora a ser executada em **[http://localhost:3000](http://localhost:3000/)**.
192193

193-
Abra no seu navegador clicando no link do seu terminal e você deverá ver o texto "Hello world!"
194-
que nós copiamos no passo anterior.
194+
Abrimos a aplicação no nosso navegador clicando na hiperligação no nosso terminal e devemos ver o texto “Hello World” que copiámos no passo anterior.
195195

196196
::alert{type="info"}
197197

198-
Quando iniciado o Nuxt no modo de desenvolvimento, ele estará escutando por mudanças nos arquivos dentro dos demais diretórios, então não há necessidade de reiniciar a aplicação quando por exemplo adicionar páginas novas.
198+
Quando iniciarmos a Nuxt no modo de desenvolvimento, esta ouvirá as alterações de ficheiros na maioria dos diretórios, pelo que não é necessário reiniciar a aplicação quando, por exemplo, adicionarmos novas páginas.
199199

200200
::
201201

202202
::alert{type="warning"}
203203

204-
Quando você rodar o comando dev será criado uma pasta chamada `.nuxt`. Essa pasta deve ser ignorada
205-
pelo controle de versionamento. Você ignorar arquivos criando um arquivo `.gitignore` na raiz do projeto e adicionando .nuxt ao arquivo.
204+
Quando executarmos o comando `dev`, este criará uma pasta `.nuxt`. Esta pasta deve ser ignorada do controlo de versões. Podemos ignorar ficheiros criando um ficheiro `.gitignore` no nível da raiz e adicionando `.nuxt`.
206205

207206
::
208207

209-
### Passo extra
208+
### Etapa de Bónus
210209

211-
Crie uma pagina chamada `fun.vue` dentro da pasta `pages`.
210+
Criaremos uma página chamada `fun.vue` no diretório `pages`.
212211

213-
Adicione um `<template></template>` e inclua um cabeçalho com uma frase engraçada dentro.
212+
Adicionaremos um `<template></template>` e incluímos um cabeçalho com uma frase engraçada no interior.
214213

215-
Então, vá até o seu navegador e veja a sua nova página em **[localhost:3000/fun](http://localhost:3000/fun)**.
214+
Depois, iremos ao nosso navegador e veremos a nova página em **[localhost:3000/fun](http://localhost:3000/fun)**.
216215

217216
::alert{type="info"}
218217

219-
Criar uma pasta `more-fun` e colocar um arquivo `index.vue` dentro, irá dar o mesmo resultado que criar um arquivo `more-fun.vue`.
218+
Criar um diretório chamado `more-fun` e colocar um ficheiro `index.vue` dentro dele dará o mesmo resultado que criar um ficheiro `more-fun.vue`.
220219

221220
::

Diff for: content/pt/docs/1.get-started/2.routing.md

+14-14
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,53 @@
11
---
22
title: Roteamento
3-
description: A maioria dos sítios da web têm mais que uma página. Por exemplo uma página inicial, uma página sobre, página de contacto etc. No sentido de exibir essas paginas nós precisamos de um Roteador.
3+
description: A maioria dos sítios da Web têm mais que uma página. Por exemplo, uma página inicial, uma página sobre, página de contacto etc. Para mostrar estas páginas precisamos de um roteador.
44
category: get-started
55
csb_link: https://codesandbox.io/embed/github/nuxt-academy/guides-examples/tree/master/01_get_started/02_routing?fontsize=14&hidenavigation=1&theme=dark
66
video: cKutrcn-hdE
77
---
88

99
# Roteamento
1010

11-
A maioria dos sítios da web têm mais que uma página. Por exemplo uma página inicial, uma página sobre, página de contacto etc. No sentido de exibir essas paginas nós precisamos de um Roteador.
11+
A maioria dos sítios da Web têm mais que uma página. Por exemplo, uma página inicial, uma página sobre, página de contacto etc. Para mostrar estas páginas precisamos de um roteador.
1212

1313
---
1414

15-
## Rotas automáticas
15+
## Rotas Automáticas
1616

17-
A maioria dos websites irão ter mais que uma página (por exemplo página inicial, página sobre, formas de contato etc.). Para mostrar essas paginas nós precisamos de um Router. É aonde o `vue-router` entra. Quando se trabalha com aplicações Vue, você tem que iniciar o arquivo de configuração (exemplo `router.js`) e adicionar todas as rotas manualmente nele. O Nuxt gera automaticamente as configurações do `vue-router` para você, com base nos ficheiros de Vue dentro da pasta `pages`. Isso significa que você nunca mais terá que escrever as configurações do roteador! O Nuxt também oferece para você a separação automática de código para todas suas rotas.
17+
A maioria dos sítios da Web terão mais do que uma página (ou seja, uma página inicial, página sobre, uma página de contacto, etc). Para mostrar estas páginas, precisamos de um roteador. É aí que entra a `vue-router`. Quando trabalhamos com a aplicação de Vue, temos de definir um ficheiro de configuração (ou seja, `router.js`) e adicionar todas as nossas rotas manualmente. A Nuxt gera automaticamente a configuração da `vue-router` por nós, baseada nos nossos ficheiros `.vue` fornecidos dentro do diretório `pages`. Isto significa que nunca mais teremos de escrever uma configuração de roteador! A Nuxt também dá-nos a divisão automática de códigos para todas as nossas rotas.
1818

19-
Em outras palavras, tudo o que você tem que fazer para ter uma rota na sua aplicação é criar ficheiros `.vue` dentro da pasta `pages`.
19+
Em outras palavras, tudo o que temos que fazer para ter roteamento na nossa aplicação é criar ficheiros `.vue` na pasta `pages`.
2020

2121
::alert{type="next"}
22-
Saiba mais sobre o [Roteamento](/docs/features/file-system-routing)
22+
Saber mais sobre o [Roteamento](/docs/features/file-system-routing).
2323
::
2424

2525
## Navegação
2626

27-
Para navegar entre as páginas da sua aplicação, você deve usar o componente [NuxtLink](/docs/features/nuxt-components#o-componente-nuxtlink). Esse componente é incorporado no Nuxt, portanto você não tem que importar ele assim como você faz com os outros componentes. É similar ao marcador `<a>` do HTML, exceto que ao invés de usar um `href="/about"` nós usamos `to="/about"`. Se você usou `vue-router` antes, você pode pensar no componente `<NuxtLink>` como uma substituto do componente `<RouterLink>`.
27+
Para navegar entre as páginas da nossa aplicação, devemos utilizar o componente [`NuxtLink`](/docs/features/nuxt-components#o-componente-nuxtlink). Este componente é incluído com a Nuxt, pelo que não temos de o importar como fazemos com outros componentes. É semelhante ao marcador da HTML `<a>`, exceto que em vez de utilizar `href="/about"` utilizamos `to="/about"`. Se já utilizamos a `vue-router` antes, podemos pensar no `<NuxtLink>` como um substituto para o `<RouterLink>`.
2828

29-
Uma simples ligação para a página `index.vue` dentro da sua pasta `pages`:
29+
Uma simples hiperligação para a página `index.vue` na nossa pasta `pages`:
3030

3131
```html{}[pages/index.vue]
3232
<template>
33-
<NuxtLink to="/">Página inicial</NuxtLink>
33+
<NuxtLink to="/">Home page</NuxtLink>
3434
</template>
3535
```
3636

37-
Para todas ligações para as páginas dentro do seu sítio, use `<NuxtLink>`. Se você tiver ligações para outros sítios na web você deve usar o marcador `<a>`. Para ter uma ideia consulte o exemplo abaixo:
37+
Para todas as hiperligações às páginas do nosso sítio, utilizamos `<NuxtLink>`. Se tivermos hiperligações a outros sítios da Web, devemos utilizar o marcador `<a>`. Veremos abaixo um exemplo:
3838

3939
```html{}[pages/index.vue]
4040
<template>
4141
<main>
42-
<h1>Página Inicial</h1>
42+
<h1>Home page</h1>
4343
<NuxtLink to="/about">
44-
Sobre (ligação interna que pertence a aplicação do Nuxt)
44+
About (internal link that belongs to the Nuxt App)
4545
</NuxtLink>
46-
<a href="https://v2.nuxt.com">Ligação externa para outra página</a>
46+
<a href="https://v2.nuxt.com">External Link to another page</a>
4747
</main>
4848
</template>
4949
```
5050

5151
::alert{type="next"}
52-
Saiba mais sobre o [Componente NuxtLink](/docs/features/nuxt-components#o-componente-nuxtlink).
52+
Saber mais sobre o [componente `NuxtLink`](/docs/features/nuxt-components#o-componente-nuxtlink).
5353
::

0 commit comments

Comments
 (0)