hablemospython.dev 🐍

Sitio web de introducción a la comunidad "Python en Español". Encontrarás consejos y recursos de nuestras comunidades en Telegram, y Discord.

Implementación

El template está basado en Cirrus, y no se utiliza ningún generador de sitios estáticos, en su lugar, existe un script llamado generate.py que lee el contenido de las páginas en pages/ que utilizan formato markdown, y generan archivos HTML.

¿Cómo contribuir?

• Los cambios a las páginas existentes van directamente en los archivos de pages/.
• Para agregar una nueva página, hay que crear el nuevo archivo markdown en pages/ y también modificar el archivo template/head.html en caso que la página deba estar presente en el menú superior del sitio. No olvides agregar la página en .gitignore para evitar que sea agregada.
• Para agregar comunidades, solo debes agregar una entrada en el diccionario en lib/comunidades.py.

Configuración

Los pasos para generar el sitio localmente son:

Entorno virtual

Crea un entorno virtual, y actívalo:

python -m venv env
source env/bin/activate   # Linux, macOS, Windows (mingw)
env\Scripts\activate.bat  # Para Windows (cmd)
env\Scripts\Activate.ps1  # Para Windows (Powershell)

Dependencia y generación

Instala las dependencias con pip install -r requirements.txt, y luego ejecuta el script principal python generate.py para poder tener el contenido del sitio en el directorio actual.