Paramètres
Tous les paramètres que le site lit, leur valeur par défaut, et comment les changer avec Docker et sans.
Les paramètres
Chaque paramètre est optionnel : le site fonctionne sans aucun d'eux.
| Variable | Par défaut | Rôle |
|---|---|---|
NEXT_PUBLIC_SITE_URL | http://localhost:3030 | L'adresse publique du site, avec https:// et sans barre oblique à la fin. Les liens canoniques, les liens entre les deux langues, le sitemap, robots.txt et les cartes de partage social en sont construits. Définissez-la avec votre domaine avant la mise en ligne. |
NEXT_PUBLIC_BUY_URL | vide | Quand elle est définie, une bande en bas du pied de page affiche un bouton « Buy This Template » qui ouvre cette adresse dans un nouvel onglet. Laissez-la vide. |
BUILD_STANDALONE | vide | true construit un serveur autonome dans .next/standalone. Le Dockerfile la définit pour vous. Laissez-la vide pour yarn start. |
Sans Docker
Copiez .env.example vers .env.local et modifiez les valeurs là. Gardez .env.example tel quel, comme liste de ce qui existe.
Nextjs-landing-page-template-2cp .env.example .env.localNEXT_PUBLIC_SITE_URL=https://www.your-domain.comAvec Docker
Le build de l'image ne lit pas les fichiers .env ni .env.local. Passez plutôt chaque valeur comme argument de build :
Nextjs-landing-page-template-2docker build -t analytics-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .Le site dans le conteneur écoute toujours sur le port 3030. Pour utiliser un autre port sur votre ordinateur, changez le nombre à gauche de -p au démarrage.
Quand une modification prend effet
Les valeurs qui commencent par NEXT_PUBLIC_ sont intégrées au JavaScript que charge le navigateur lors du build. En changer une ne change rien tant que le site n'est pas reconstruit :
| Comment vous la lancez | Après avoir modifié une valeur |
|---|---|
yarn dev | Arrêtez le serveur et relancez yarn dev. |
yarn build et yarn start | Relancez yarn build, puis yarn start. |
| Docker | Reconstruisez l'image avec la valeur en --build-arg, puis démarrez un nouveau conteneur. |
| Vercel | Modifiez-la dans les Environment Variables du projet et redéployez. |
Ne mettez jamais de secret dans une valeur NEXT_PUBLIC_ : chaque visiteur peut la lire dans le code de la page. Les clés de vos propres services doivent rester sur votre serveur.
Le build standalone
Avec BUILD_STANDALONE=true, yarn build produit un serveur qui n'a pas besoin de node_modules, rangé dans .next/standalone. Le Dockerfile l'utilise pour garder l'image petite. yarn start n'est pas prévu pour ce type de build et avertit "next start" does not work with "output: standalone" configuration. Laissez la variable vide, sauf si vous copiez vous-même le dossier standalone sur un serveur.