Skip to content

PyConColombia/website-2023

Repository files navigation

Sitio Web - PyCon Colombia 2022

Build Status MIT License Python Status PRs Welcome GitHub issues Twitter PyCon Colombia

Este es el repositorio del sitio web de la PyCon Colombia 2022 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