Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/alfonsoolavarria/florilegio/llms.txt

Use this file to discover all available pages before exploring further.

Florilegio de la Fe es una plataforma cristiana construida con Django 4.2. Esta guía te lleva desde cero hasta tener el servidor de desarrollo ejecutándose en tu máquina local, con la base de datos configurada y el panel de administración accesible.
Requisitos previosAntes de comenzar, asegúrate de tener instalado lo siguiente:
1

Clonar el repositorio

Clona el repositorio oficial y entra al directorio del proyecto:
git clone https://github.com/alfonsoolavarria/florilegio.git && cd florilegio
2

Crear y activar un entorno virtual

Se recomienda aislar las dependencias del proyecto en un entorno virtual de Python.
python -m venv venv
source venv/bin/activate
Una vez activado, verás el prefijo (venv) en tu terminal.
3

Instalar dependencias

Instala todos los paquetes declarados en requirements.txt:
pip install -r requirements.txt
Esto instalará las siguientes dependencias:
PaqueteVersiónPropósito
Django4.2.11Framework web principal
psycopg2-binary2.9.11Adaptador PostgreSQL para Django
whitenoise6.6.0Servir archivos estáticos en producción
python-dotenv1.0.1Cargar variables de entorno desde .env
django-allauth0.54.0Autenticación social (Google OAuth)
django-ratelimit4.1.0Limitación de tasa en vistas y APIs
bleach6.3.0Sanitización de HTML en contenido de usuario
Pillow12.2.0Procesamiento de imágenes (portadas, avatares)
4

Configurar el archivo .env

Crea un archivo .env en la raíz del proyecto (al mismo nivel que manage.py) con las variables de entorno necesarias:
SECRET_KEY=tu-clave-secreta-aqui
DJANGO_DEBUG=True

DB_NAME=florilegiofe
DB_USER=florife_user
DB_PASSWORD=yourpassword
DB_HOST=localhost
DB_PORT=5432
Consulta la referencia completa de variables en Variables de Entorno para ver todos los parámetros disponibles, incluyendo los de Brevo, PayPal y la API Bíblica.
5

Aplicar migraciones

Asegúrate de que PostgreSQL esté en ejecución y la base de datos exista, luego aplica las migraciones de Django:
python manage.py migrate
Consulta Base de Datos para los pasos detallados de creación de la base de datos PostgreSQL y la importación de datos bíblicos.
6

Crear superusuario

Crea una cuenta de administrador para acceder al panel de Django:
python manage.py createsuperuser
Se te pedirá un correo electrónico y contraseña.
7

Iniciar el servidor de desarrollo

Lanza el servidor de desarrollo de Django:
python manage.py runserver
El servidor estará disponible en http://localhost:8000.

Verificar instalación

Una vez que el servidor esté en marcha, visita http://localhost:8000/admin e inicia sesión con las credenciales del superusuario que creaste. Si el panel de administración de Django carga correctamente, la instalación fue exitosa.
Para el siguiente paso, sigue la guía de Base de Datos para habilitar la extensión unaccent de PostgreSQL e importar los datos bíblicos con los comandos de gestión incluidos.

Build docs developers (and LLMs) love