criticalrobin / try_django_weasyprint Goto Github PK

Instrucciones para la Configuración del Proyecto Django Bienvenidos al proyecto Django. Para configurar y utilizar este proyecto en su computadora local, sigan los siguientes pasos detalladamente:

1. Crear una Carpeta de Trabajo: Inicie creando una carpeta en su computadora donde alojará el proyecto.

2. Clonar el Repositorio: Abra la consola de comandos y navegue hasta la carpeta que ha creado. Ejecute el siguiente comando para clonar el repositorio:

   git clone https://github.com/criticalRobin/try_django_weasyprint.git

3. Preparación del Entorno Virtual: Antes de continuar, asegúrese de tener instalado Python y el gestor de paquetes pip. Puede verificar su instalación con los comandos python --version y pip --version.

4. Instalación de Virtualenv: Si no tiene virtualenv instalado, puede hacerlo mediante pip con el siguiente comando: pip install virtualenv

5. Creación del Entorno Virtual: Dentro de la carpeta del proyecto, cree un entorno virtual ejecutando: python -m venv env

6. Activación del Entorno Virtual: Antes de proceder con la instalación de dependencias y la configuración del proyecto, active el entorno virtual. En Windows, use: env\Scripts\activate En sistemas Unix o MacOS, use: source env/bin/activate

7. Instalación de Dependencias: Una vez activado el entorno virtual, instale las dependencias del proyecto ejecutando: pip install -r requirements.txt

8. Configuración Tailwind + Django: Una vez instaladas las dependencias siga los siguientes pasos para configurar Tailwind css:

   1. Abra el proyecto dentro de su editor de código preferido.

   2. En el directorio llamado change_forms abrir el documento settings.py

   3. Vaya a la sección de INSTALLED_APPS y comente las siguientes apps: theme y django_browser_reload

   4. Una vez comentadas esas aplicaciones ejecute el siguiente comando en su consola: python manage.py tailwind init

   5. Cuando le aparezca lo presentado en la imagen solo presione enter para continuar

   6. Una vez realizado eso le aparecerá un mensaje de que se ha creado la app theme dentro del proyecto, vaya de nuevo al archivo settings.py y descomente la app theme

   7. Vuelva a su consola y ejecute el siguiente comando: python manage.py tailwind install

   8. Una vez instaladas todas las dependencias de tailwind le aparecerá un mensaje como el de la imagen:

   9. Vuelva al archivo settings.py y descomente en la sección de apps instaladas la app con el nombre: django_browser_reload

   10. Para comprobar la correcta configuración ejecute el comando: python manage.py tailwind start

   11. Si todo salió bien deberia ver en su consola lo mismo que en la imagen a continuación:

9. Comprobación Dependencias: Ejecute el comando: python manage.py runserver Si obtiene un resultado como el de la imagen significa que los pasos anteriores fueron realizados con éxito.

10. Si en el paso anterior aparecieron errores relacionados con la libreria weasyprint, observe este video para usar weasyprint en youtube: https://www.youtube.com/watch?v=rtXLsf6Vfss&t=381s&ab_channel=AlgoriSoft

    Si es usuario de linux, más especificamente en Ubuntu ejecute el siguiente comando dentro de la consola: apt install python3-pip python3-cffi python3-brotli libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0

    De igual forma se adjunta la documentación de weasyprint: https://doc.courtbouillon.org/weasyprint/stable/index.html

11. Ejecutar Migraciones: Presione control+c para detener la ejecución de la app web, cuando se haya detenido ejecute el siguiente comando: python manage.py migrate

12. Crear Super Usuario: Finalmente ejecute el comando: python manage.py createsuperuser y complete el formulario de registro, con esto ya podrá acceder al admin view del proyecto de Django.