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

Page traduite Le contenu de cette page peut être déprécié.

dist

Le répertoire dist, abréviation de distribution, est généré dynamiquement lors de l'utilisation de la commande nuxt generate et contient les fichiers HTML prêts pour la production ainsi que les ressources nécessaires au déploiement et à l'exécution de votre application Nuxt.


Déploiement

C'est le répertoire que vous devez télécharger pour l'hébergement statique car il contient vos fichiers HTML prêts à la production et vos ressources

Le répertoire dist ne doit pas être livré à votre système de contrôle de version et doit être ignoré par votre .gitignore car il sera généré automatiquement à chaque fois que vous lancez la commande nuxt generate.

La propriété 'dir'

Le répertoire dist est nommé dist par défaut mais peut être configuré dans votre fichier nuxt.config.

nuxt.config.js
generate: {
  dir: 'mon-site'
}
Si vous changez votre répertoire dist, vous devrez l'ajouter à votre contrôle de version pour que git l'ignore.

La propriété subFolders

Nuxt place par défaut toutes nos pages générées dans un répertoire, cependant nous pouvons changer cela si on le souhaite en modifiant le fichier nuxt.config.js et en changeant la propriété des sous-répertoires pour qu'ils soient false.

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

La propriété fallback

Lors du déploiement de votre site, vous devrez vous assurer que le chemin html de repli est correctement défini. Il doit être défini comme page d'erreur afin que les routes inconnues soient rendues via Nuxt. S'il n'est pas défini, Nuxt utilisera la valeur par défaut qui est la page 200.html.

Lors de l'exécution d'une application à page unique, il est plus logique d'utiliser 200.html car c'est le seul fichier nécessaire puisque aucune autre route n'est générée.

Lorsque vous travaillez avec des pages générées statiquement, il est recommandé d'utiliser un fichier 404.html pour les pages d'erreur.

Selon l'endroit où vous hébergez votre site, vous devez utiliser un fichier 200.html ou 404.html. Veuillez vérifier auprès de votre fournisseur d'hébergement. Netlify, par exemple, utilise 404.html.
nuxt.config.js
export default {
  generate: {
    fallback: '404.html'
  }
}

La propriété exclude

Vous pouvez exclure des pages de la génération en utilisant la propriété generate exclude. Au lieu d'être générée en tant que page statique, elle deviendra une page d'application unique et ne sera rendue que du côté client.

nuxt.config.js
generate: {
  exclude: [/admin/]
}
Vous pouvez également utiliser une expression réguliaire ici pour exclure les pages commençant ou se terminant par un mot en particulier.