Este es el repositorio de la página web oficial de Yambo, una asociación infantojuvenil ubicada en Alcobendas. Puedes visitar el sitio en yambo.ddns.net.
Nuestra misión es proporcionar un espacio seguro y acogedor donde los niños y jóvenes puedan crecer, aprender y divertirse mientras fortalecen sus valores.
- Descripción
- Capturas de pantalla
- Características
- Tecnologías utilizadas
- Requisitos previos
- Configuración del archivo .env
- Instalación
- Contribuir
- Licencia
- Contacto
Aquí te mostramos algunas capturas de pantalla de nuestra página web:
Página de inicio
Página de monitores
Página de contacto
- Página de inicio: Información general sobre la asociación y sus proyectos.
- Página de monitores: Descripción de los diferentes voluntarios que participan en la asociación.
- Página de contacto: Formulario para contactar con la asociación.
Asegúrate de contar con los siguientes componentes instalados:
- Python 3.9 o superior
- pip (Administrador de paquetes de Python)
- MariaDB 10.6 o superior
- Entorno virtual (opcional, pero recomendado):
virtualenvu otro equivalente
Este proyecto utiliza el paquete python-decouple para gestionar configuraciones sensibles. Antes de ejecutar la aplicación, crea un archivo .env en la raíz del proyecto con el siguiente contenido:
# Configuración general
SECRET_KEY=tu-clave-secreta
DEBUG=True
# Configuración de la base de datos
DB_NAME=yambo_db
DB_USERNAME=yambo_user
DB_PASSWORD=contraseña_segura
DB_HOST=localhost
DB_PORT=3306
# Configuración de correo
EMAIL_HOST=smtp.tu-proveedor.com
EMAIL_HOST_USER=tu-correo@example.com
EMAIL_HOST_PASSWORD=tu-contraseña
EMAIL_RECIPIENT=destinatario@example.com
# Configuración de hosts permitidos
ALLOWED_HOSTS=localhost,127.0.0.1
CSRF_TRUSTED_ORIGINS=http://localhost,http://127.0.0.1Sigue estos pasos para configurar y ejecutar la página web en tu entorno local:
# 1. Clona el repositorio
git clone https://github.com/cabrasky/web-yambo.git
# 2. Accede al directorio del proyecto
cd web-yambo
# 3. (Opcional) Crea y activa un entorno virtual
python -m venv venv
source venv/bin/activate # En Windows: venv\Scripts\activate
# 4. Instala las dependencias
pip install -r requirements.txt
# 5. Crea el archivo .env en la raíz del proyecto y configura las variables de entorno según la sección anterior
# 6. Crea las migraciones e inicializa la base de datos
python manage.py makemigrations
python manage.py migrate
# 7. Inicia el servidor
python manage.py runserverLa aplicación estará disponible en http://127.0.0.1:8000.
¡Tu ayuda es bienvenida! Puedes contribuir de las siguientes formas:
- Reportando errores o sugerencias en la sección Issues del repositorio.
- Realizando un Fork del proyecto, desarrollando mejoras, y enviando un Pull Request con tus cambios.
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Si tienes preguntas o necesitas más información, no dudes en contactarnos:
- Correo electrónico: yamboalcobendas@gmail.com
- Sitio web: yambo.ddns.net
- Redes sociales: Instagram
🎉 ¡Gracias por tu interés en Yambo!