Web de la Asociación Python España
Clone or download

README.md

Build Status

Sitio Web de la asociación Python España

https://es.python.org

Este sitio web ha sido generado utilizando el generador de sitios web estáticos Pelican, escrito en Python.

El contenido está escrito en Markdown y se encuentra localizado dentro de la carpeta contents.

No necesitas conocimientos técnicos para añadir nuevo contenido a la web o editar el existente. Lee nuestra guía de contribución para aprender cómo proponer cambios desde el navegador.

Sin embargo, puedes continuar leyendo si quieres probar el proyecto en un entorno de desarrollo local.

Recuerda que al participar en esta comunidad, aceptas y te comprometes a cumplir nuestro código de conducta.

Instalación del sitio web

Prerrequisitos

Probar el sitio web en local requiere un entorno UNIX y los programas make, git, pip y Python 2.7.x or 3.3+. La siguiente guía asume que trabajas con Python 3.

Clonando el repositorio

Comienza clonando el repositorio en tu entorno de desarrollo. Como el nombre del mismo es demasiado genérico, indica el directorio de destino como último parámetro:

$ git clone https://github.com/python-spain/web.git python-es-web
$ cd python-es-web
$ git submodule init
$ git submodule update

Los dos últimos comandos instalan el tema Alchemy de pelican como un submódulo.

Configuración del proyecto

NOTA: Es opcional pero áltamente recomendable trabajar en un entorno virtual de Python.

Las dependencias del sitio web se encuentran en el archivo requirements.txt. Instala las dependencias con pip:

$ pip install -r requirements.txt

Trabajar en un entorno virtual

Un entorno virtual permite trabajar en un entorno Python 3 aislado e independiente de tu sistema. Esto quiere decir que los paquetes que instales dentro del entorno virtual no estarán disponibles en tu instalación global de Python o en otros entornos virtuales (y viceversa).

Para crear un entorno virtual, lanza el comando:

$ python3 -m venv venv

Para activar el entorno virtual, lanza el siguiente comando desde la raíz del repositorio:

$ source venv/bin/activate

Para salir de un entorno virtual activo, lanza el comando:

$ deactivate

Probando en local

Realiza pruebas en local lanzando el servidor de desarrollo:

$ make devserver

Por defecto, el servidor escucha en http://localhost:8000. Con este comando, las carpetas themes y content serán monitorizadas y el sitio web se regenerará automáticamente si el contenido cambia.

Si necesitas más información sobre los comandos de make que puedes utilizar, consulta el manual de Pelican o lanza el comando:

$ make