Skip to content

Latest commit

 

History

History
163 lines (110 loc) · 4.8 KB

README.MD

File metadata and controls

163 lines (110 loc) · 4.8 KB

Sitio Web de la Conferencia SciPyLatam 2019

Build Status MIT License Python Status PRs Welcome GitHub issues Twitter SciPyLatam

Este es el repositorio del sitio web de la comunidad servido por Github, y construido utilizando lektor.

🔀 Flujo de trabajo

Hay 2 ramas de trabajo en git, develop y production.

⤴️ Develop

Es la rama por defecto y se despliega a través de gh-pages con Lektor a https://github.com/scipy-latinamerica/scipylatam-webpage-2019-develop (en https://scipy-latinamerica.github.io/scipylatam-webpage-2019-develop/)

⤴️ 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 la rama gh-pages de https://scipy-latinamerica.github.io/scipylatam-webpage-2019/ (pronto en http://scipy.org/conf/2019 o http://conf.scipy.org)

🛠 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 fabric

Usando conda:

$ conda install lektor fabric -c conda-forge

✅ Instala (reinstala) los plugins locales

$ lektor plugins reinstall

✅ Instala nvm

Necesitamos instalar node

Usando cURL:

$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash

Después instalamos Node y Yarn:

$ nvm install --lts
$ brew install yarn

Instalar paquetes necesarios para el bundle:

$ cd webpack
$ yarn install

✅ Corre el servidor local

$ lektor server -f webpack

⁉️ 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). Los despliegues son automáticos utilizando Travis-CI para cada PR que se une con la rama develop (o con la rama production).

La configuración de dichos repositorios se encuentra en scipylatam2019_webpage.lektorproject

✔️ Desarrollo

$ lektor deploy

Se desplegará el contenido de la rama develop en https://scipy-latinamerica.github.io/scipylatam-webpage-2019/

✔️✔️ Producción

$ lektor deploy production

Se desplegará el contenido de la rama production en http://scipyla.org/conf/2019