Ajustes
Todos los ajustes que lee el sitio, su valor por defecto y cómo cambiarlos con Docker y sin él.
Los ajustes
Todos los ajustes son opcionales: el sitio funciona sin ninguno.
| Variable | Valor por defecto | Qué hace |
|---|---|---|
NEXT_PUBLIC_SITE_URL | http://localhost:3030 | La dirección pública del sitio, con https://. Se quita la barra del final. A partir de ella se construyen los enlaces canónicos, los enlaces entre los dos idiomas, el sitemap, robots.txt, los datos estructurados y las tarjetas para compartir en redes. Defínela con tu dominio antes de publicar. |
NEXT_PUBLIC_BUY_URL | vacío | Cuando está definida, una franja al pie de cada página muestra un botón "Buy This Template" que abre esta dirección en una pestaña nueva. Déjala vacía. |
NEXT_PUBLIC_RECAPTCHA_SITE_KEY | vacío | Una clave de sitio de Google reCAPTCHA v2. Cuando está definida, el formulario de la página de inicio pide marcar la casilla "No soy un robot" antes de enviar. Déjala vacía para no tener paso de captcha. |
BUILD_STANDALONE | vacío | true construye un servidor autónomo en .next/standalone. El Dockerfile lo define por ti. Déjalo vacío para yarn start. |
El puerto no es una variable: el sitio siempre escucha en 3030. Para usar otro puerto, mira más abajo.
Sin Docker
Copia .env.example a .env.local y edita allí los valores. Deja .env.example como está, como lista de lo que existe.
Publino-templatecp .env.example .env.localNEXT_PUBLIC_SITE_URL=https://www.your-domain.comPara usar otro puerto distinto de 3030, pásalo al script: yarn dev -p 3041 o yarn start -p 3041.
Con Docker
La construcción de la imagen no lee los archivos .env ni .env.local. Pasa cada valor como argumento de construcción:
Publino-templatedocker build -t publino-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .El sitio dentro del contenedor siempre escucha en el puerto 3030. Para usar otro puerto en tu equipo, cambia el número de la izquierda de -p al iniciarlo: docker run -p 3041:3030 publino-landing.
Cuándo surte efecto un cambio
Los valores que empiezan por NEXT_PUBLIC_ se compilan en el JavaScript que carga el navegador cuando se construye el sitio. Cambiar uno no cambia nada hasta que se vuelve a construir el sitio:
| Cómo lo ejecutas | Después de cambiar un valor |
|---|---|
yarn dev | Detén el servidor y ejecuta yarn dev de nuevo. |
yarn build y yarn start | Vuelve a ejecutar yarn build y luego yarn start. |
| Docker | Vuelve a construir la imagen con el valor como --build-arg y luego inicia un contenedor nuevo. |
| Vercel | Cámbialo en Environment Variables del proyecto y vuelve a desplegar. |
Nunca pongas un secreto en un valor NEXT_PUBLIC_: cualquier visitante puede leerlo en el código de la página. La clave de sitio de reCAPTCHA está pensada para ser pública; su clave secreta va en tu servidor.
La construcción autónoma
Con BUILD_STANDALONE=true, yarn build escribe un servidor que no necesita node_modules en .next/standalone. El Dockerfile lo usa para mantener la imagen pequeña. yarn start no está pensado para ese tipo de construcción y avisa "next start" does not work with "output: standalone" configuration. Deja la variable vacía a menos que copies tú mismo la carpeta standalone a un servidor.
Ajustes en el código
Unos pocos valores que no son textos están en src/config/site.config.ts: el nombre del autor en los metadatos de la página, la imagen para compartir y su tamaño, y los perfiles sociales que se indican a los buscadores. Los perfiles vacíos se omiten.