README.md

Sitio Web - PyCon Colombia 2021

Este es el repositorio del sitio web de la PyCon Colombia 2021 servido por Github, y construido utilizando lektor. Diseño original por Edwin Jerez (El Hijo) .

🔀 Flujo de trabajo

Hay 2 ramas de git, develop y production.

⤴️ Develop

Es la rama por defecto y se despliega a través de gh-pages con Lektor a https://pyconcolombia.github.io/website-develop/ (en http://develop.pycon.co)

⤴️ Production

Después de que se han ejecutado las pruebas de calidad (QA), los cambios realizados en la rama develop se unen con la rama production y son desplegados a través de gh-pages con Lektor a https://pyconcolombia.github.io/website-production/ (pronto en http://www.pycon.co)

🛠 Desarrollo local

✅ (Opcional) Entorno Virtual

Instalación

• Instalar virtualenv

• ⚠️️ Requiere previa instalación de Python ⚠️

Crear entorno virtual

$ virtualenv <nombre_entorno>

Activar entorno virtual

Windows

$ <nombre_entorno>\Scripts\activate

Linux

$ source <nombre_entorno>/bin/activate

✅ Instala Lektor

Usando pip:

$ pip install -U Lektor unidecode

Usando conda:

$ conda install lektor unidecode -c conda-forge

✅ Instala (reinstala) los plugins locales

$ lektor plugins reinstall

✅ Corre el servidor local

$ lektor server

⁉️ Problemas comunes

• 🔴 Si en algun momento luego de instalar python3 y crear tu virtualenv. haces lektor server y ves este error:

RuntimeError: Click will abort further execution because Python 3 was configured to use ASCIas encoding for the environment.  Consult http://click.pocoo.org/python3/for mitigation steps.

Haz esto adentro de tu virtualenv:

export LC_ALL=en_us.UTF-8
export LANG=en_us.UTF-8

• 🔴 Si ves jinja2.exceptions.UndefinedError: 'estimate_reading_time' is undefined significa que necesitas instalar o reinstalar los plugins de lektor. Puedes hacer esto ejecutando

$ lektor plugins reinstall

🚀 Despliegue

Gracias a Lektor Bot (Plugin de lektor conectado a Github), podemos desplegar nuestra web estática en diferentes repositorios (en la rama seleccionada en configuración - gh-pages en nuestro caso).

La configuración de dichos repositorios se encuentra en python-colombia.lektorproject

✔️ Desarrollo

$ lektor deploy

Se desplegará el contenido de la rama develop en develop.pycon.co

✔️✔️ Producción

$ lektor deploy production

Se desplegará el contenido de la rama production en pycon.co

---

💪 Colaboradores

Alejandro E. Rendon	Jonathan Vallejo Muñoz