You are browsing Nuxt 2 docs. Go to Nuxt 3 docs, or learn more about Nuxt 2 Long Term Support.

Translated page Contents of this page might be outdated.

O diretório dist

A pasta dist, forma abreviada para pasta de distribuition (distribuição), é dinamicamente gerada quando se usa os comandos nuxt generate e inclui os ficheiros HTML e assets gerados e prontos para produção que são necessários para desdobrar e executar sua aplicação Nuxt estaticamente gerada.


Desdobrando

Esta é a pasta que você precisa carregar para hospedagem estática visto que ele contém seus ficheiros HTML e assets gerados e prontos para produção.

O diretório dist não deve ser enviado para o seu sistema de controlo de versão e deve ser ignorado através do seu .gitignore visto que ele será gerado automaticamente toda vez que você executar o nuxt generate.

A propriedade dir

A pasta dist é nomeada dist por padrão mas pode ser configurada dentro do seu ficheiro nuxt.config.js.

nuxt.config.js
generate: {
  dir: 'my-site'
}
Se você mudar a sua pasta dist então você precisará adicionar ele ao seu sistema de controlo de versão assim o git ignorará ele.

A propriedade subFolders

O Nuxt coloca todas as suas páginas geradas dentro de uma pasta por padrão, no entanto você pode mudar isso se você quiser ao modificar o nuxt.config.js e mudando o subFolders para ser false.

nuxt.config.js
generate: {
  subFolders: false
}

A propriedade fallback

Quando estiver fazendo o deploy do seu site você precisará certificar-se que o caminho para o HTML do fallback está corretamente definido. Ele deve ser definido como a página de erro uma vez que as rotas desconhecidas são renderizadas via Nuxt.

Quando estiver executando uma aplicação de página única faz mais sentido usar o 200.html assim ele é o único ficheiro necessário, visto que nenhuma das outras rotas é gerada.

Quando estiver trabalhando com páginas geradas estaticamente, é recomendado usar o 404.html para páginas de erro.

Dependendo de onde você estiver hospedando o seu sítio, você pode ter que usar o 200.html ou o 404.html. Consulte com o seu provedor de hospedagem. O Netlify, por exemplo usa o 404.html.
nuxt.config.js
export default {
  generate: {
    fallback: '404.html'
  }
}

A propriedade exclude

Você pode excluir páginas de serem geradas ao usar a propriedade excludes do generate. Ao invés de serem geradas como uma página estática ela voltará a ser uma página de uma aplicação de página única e somente será renderizada no lado do cliente.

nuxt.config.js
generate: {
  exclude: [/admin/]
}
Você pode também usar aqui uma expressão regular para excluir páginas que começam ou terminam com uma palavra em particular