Cómo editar las páginas de la wiki

Esta guía explica cómo añadir nuevos editores a la wiki y desplegar los cambios en producción.

1. Acceder al proyecto

Primero, navega al directorio del proyecto en tu máquina local:

cd ruta/a/tu/proyecto/nextjs

Nota: Reemplaza ruta/a/tu/proyecto con la ruta real de tu proyecto local.

2. Configurar variables de entorno

Las variables de entorno se configuran en Vercel Dashboard, no en archivos locales que se suban al repositorio.

IMPORTANTE: Nunca subas archivos .env* o env.local al repositorio. Estos archivos contienen información sensible y deben estar en .gitignore.

Para configurar editores, ve a:

• Vercel Dashboard → Tu proyecto → Settings → Environment Variables

3. Añadir nuevos editores

Para añadir un nuevo editor, configura las variables de entorno en Vercel Dashboard (Settings → Environment Variables):

Por username de GitHub:

ALLOWED_EDITORS=usuario1,usuario2,nuevo-usuario

Por email de GitHub:

ALLOWED_EDITOR_EMAILS=usuario1@example.com,usuario2@example.com,nuevo-usuario@example.com

Ejemplo de valores a configurar en Vercel:

ADMIN_GITHUB_USERNAME=nombre-del-admin
ALLOWED_EDITORS=usuario1,usuario2,usuario3
ALLOWED_EDITOR_EMAILS=email1@example.com,email2@example.com

Nota de seguridad: Estos valores son solo ejemplos. Reemplázalos con los usernames y emails reales de los editores autorizados.

Nota: Los usernames deben coincidir exactamente con el username de GitHub (la parte final de la URL del perfil, sin el @).

4. Verificar que estás logueado en Vercel

Antes de hacer el deploy, verifica que estás autenticado en Vercel:

vercel whoami

Si no estás logueado, inicia sesión con:

vercel login

Esto abrirá tu navegador para autenticarte con tu cuenta de Vercel.

5. Desplegar a producción

Una vez que hayas configurado las variables de entorno en Vercel Dashboard y verificado tu sesión, despliega los cambios a producción:

vercel --prod

Este comando:

• Desplegará los cambios a producción
• Aplicará las nuevas variables de entorno (incluyendo los nuevos editores)
• Hará que los nuevos usuarios puedan autenticarse y editar la wiki

6. Verificar el acceso

Después del deploy, el nuevo editor debe:

1. Ir a /login (ruta de autenticación)
2. Hacer clic en “Entrar con GitHub”
3. Si su username o email está en ALLOWED_EDITORS o ALLOWED_EDITOR_EMAILS, podrá autenticarse
4. Una vez autenticado, podrá usar el botón “Edit this page” en cualquier página de la wiki para editar desde GitHub

Notas importantes

• Seguridad: Nunca subas archivos .env* o env.local al repositorio. Estos archivos están en .gitignore por seguridad.
• Las variables de entorno se configuran en Vercel Dashboard → Settings → Environment Variables
• Los cambios en las variables de entorno se aplican después de hacer vercel --prod o en el próximo deployment
• Los editores deben tener su email verificado en GitHub para que funcione la autenticación por email
• El admin principal (ADMIN_GITHUB_USERNAME) tiene acceso automático, no necesita estar en ALLOWED_EDITORS