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://. Une barre oblique finale est retirée. Les liens canoniques, les liens entre les deux langues, le sitemap, robots.txt, les données structurées et les cartes de partage sur les réseaux sociaux en sont déduits. Définissez-la sur votre domaine avant la mise en ligne. |
NEXT_PUBLIC_BUY_URL | vide | Quand elle est définie, une bande en bas de chaque page affiche un bouton « Buy This Template » qui ouvre cette adresse dans un nouvel onglet. Laissez-la vide. |
NEXT_PUBLIC_RECAPTCHA_SITE_KEY | vide | Une clé de site Google reCAPTCHA v2. Quand elle est définie, le formulaire de la page d'accueil demande la case « Je ne suis pas un robot » avant l'envoi. Laissez-la vide pour n'avoir aucune étape de captcha. |
BUILD_STANDALONE | vide | true construit un serveur autonome dans .next/standalone. Le Dockerfile la définit pour vous. Laissez-la vide pour yarn start. |
Le port n'est pas une variable : le site écoute toujours sur 3030. Pour utiliser un autre port, voir plus bas.
Sans Docker
Copiez .env.example vers .env.local et modifiez les valeurs là. Gardez .env.example tel quel, comme liste de ce qui existe.
Publino-templatecp .env.example .env.localNEXT_PUBLIC_SITE_URL=https://www.your-domain.comPour utiliser un autre port que 3030, passez-le au script : yarn dev -p 3041 ou yarn start -p 3041.
Avec Docker
Le build de l'image ne lit pas les fichiers .env ni .env.local. Passez plutôt chaque valeur comme argument de build :
Publino-templatedocker build -t publino-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .Dans le conteneur, le site écoute toujours sur le port 3030. Pour utiliser un autre port sur votre ordinateur, changez le nombre à gauche de -p au démarrage : docker run -p 3041:3030 publino-landing.
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. La clé de site reCAPTCHA est faite pour être publique ; sa clé secrète doit 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.
Paramètres dans le code
Quelques valeurs qui ne sont pas des textes se trouvent dans src/config/site.config.ts : le nom de l'auteur dans les métadonnées de la page, l'image de partage et sa taille, et les profils sociaux indiqués aux moteurs de recherche. Les profils vides sont ignorés.