You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
ManualInstallVideoTitle: Instalar a Nuxt Manualmente
10
10
---
11
11
12
12
# Instalação
13
13
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.
15
15
16
16
---
17
17
18
-
## Online playground
18
+
## Zona de Testes Virtuais
19
19
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/stackblitzsize="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/stackblitzsize="small"externalIcon}
23
24
24
25
## Pré-requisitos
25
26
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/)
28
29
- 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).
29
30
30
-
## Usando create-nuxt-app
31
+
## Usar a `create-nuxt-app`
31
32
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).
33
34
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+).
35
36
36
37
::code-group
37
-
38
38
```bash [Yarn]
39
39
yarn create nuxt-app <project-name>
40
40
```
41
-
42
41
```bash [NPX]
43
42
npx create-nuxt-app <project-name>
44
43
```
45
-
46
44
```bash [NPM]
47
45
npm init nuxt-app <project-name>
48
46
```
49
-
47
+
```bash [PNPM]
48
+
pnpm create nuxt-app <project-name>
49
+
```
50
50
::
51
51
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).
53
53
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:
55
55
56
56
::code-group
57
-
58
57
```bash [Yarn]
59
58
cd<project-name>
60
59
yarn dev
61
60
```
62
-
63
61
```bash [NPM]
64
62
cd<project-name>
65
63
npm run dev
66
64
```
67
-
65
+
```bash [PNPM]
66
+
cd<project-name>
67
+
pnpm dev
68
+
```
68
69
::
69
70
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!
71
72
72
73
::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.
74
75
::
75
76
76
-
## Instalação manual
77
+
## Instalação Manual
77
78
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.
79
80
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.
81
82
82
-
### Configurando o seu projeto
83
+
### Configurar o nosso projeto
83
84
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:
85
86
86
87
```bash
87
88
mkdir <project-name>
88
89
cd<project-name>
89
90
```
90
91
91
-
_Substitua `<project-name>`com o nome do seu projeto._
92
+
_Devemos substituir `<project-name>`pelo nome do nosso projeto._
92
93
93
-
Crie o arquivo`package.json`:
94
+
Criaremos o ficheiro`package.json`:
94
95
95
96
```bash
96
97
touch package.json
97
98
```
98
99
99
-
Preencha o conteúdo do seu`package.json` com:
100
+
Preencheremos o conteúdo do nosso`package.json` com:
100
101
101
102
```json{}[package.json]
102
103
{
@@ -110,112 +111,110 @@ Preencha o conteúdo do seu `package.json` com :
110
111
}
111
112
```
112
113
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>`.
114
115
115
-
#### **O que é o arquivo package.json?**
116
+
#### **O que é um ficheiro `package.json`?**
116
117
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).
118
119
119
-
### Instalando Nuxt
120
+
### Instalar a Nuxt
120
121
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:
122
123
123
124
::code-group
124
-
125
125
```bash [Yarn]
126
126
yarn add nuxt
127
127
```
128
-
129
128
```bash [NPM]
130
129
npm install nuxt
131
130
```
132
-
131
+
```bash [PNPM]
132
+
pnpm add nuxt --shamefully-hoist
133
+
```
133
134
::
134
135
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.
136
137
137
138
::alert{type="info"}
138
139
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.
140
141
141
142
::
142
143
143
-
### Criando a sua primeira página
144
+
### Criar a nossa primeira página
144
145
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.
146
147
147
-
Crie a pasta`pages`dentro do seu projeto:
148
+
Criamos o diretório`pages`no nosso projeto:
148
149
149
150
```bash
150
151
mkdir pages
151
152
```
152
153
153
-
Então, crie um arquivo`index.vue` dentro da pasta`pages`:
154
+
Depois, criamos um ficheiro`index.vue` dentro do diretório`pages`:
154
155
155
156
```bash
156
157
touch pages/index.vue
157
158
```
158
159
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.
160
161
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:
162
163
163
164
```html{}[pages/index.vue]
164
165
<template>
165
166
<h1>Hello world!</h1>
166
167
</template>
167
168
```
168
169
169
-
### Iniciando o projeto
170
+
### Iniciar o projeto
170
171
171
-
Inicie o seu projeto executando um dos seguintes comandos abaixo :
172
+
Executamos o nosso projeto escrevendo um dos seguintes comandos no nosso terminal:
172
173
173
174
::code-group
174
-
175
175
```bash [Yarn]
176
176
yarn dev
177
177
```
178
-
179
178
```bash [NPM]
180
179
npm run dev
181
180
```
182
-
181
+
```bash [PNPM]
182
+
pnpm dev
183
+
```
183
184
::
184
185
185
186
::alert{type="info"}
186
187
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.
188
189
189
190
::
190
191
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/)**.
192
193
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.
195
195
196
196
::alert{type="info"}
197
197
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.
199
199
200
200
::
201
201
202
202
::alert{type="warning"}
203
203
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`.
206
205
207
206
::
208
207
209
-
### Passo extra
208
+
### Etapa de Bónus
210
209
211
-
Crie uma pagina chamada `fun.vue`dentro da pasta`pages`.
210
+
Criaremos uma página chamada `fun.vue`no diretório`pages`.
212
211
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.
214
213
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)**.
216
215
217
216
::alert{type="info"}
218
217
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`.
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.
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.
12
12
13
13
---
14
14
15
-
## Rotas automáticas
15
+
## Rotas Automáticas
16
16
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.
18
18
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`.
20
20
21
21
::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).
23
23
::
24
24
25
25
## Navegação
26
26
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ê já 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>`.
28
28
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`:
30
30
31
31
```html{}[pages/index.vue]
32
32
<template>
33
-
<NuxtLink to="/">Página inicial</NuxtLink>
33
+
<NuxtLink to="/">Home page</NuxtLink>
34
34
</template>
35
35
```
36
36
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:
38
38
39
39
```html{}[pages/index.vue]
40
40
<template>
41
41
<main>
42
-
<h1>Página Inicial</h1>
42
+
<h1>Home page</h1>
43
43
<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)
45
45
</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>
47
47
</main>
48
48
</template>
49
49
```
50
50
51
51
::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).
0 commit comments