Skip to content

pyve/pyve.github.io

Repository files navigation

Build Status

Sitio Web Python Venezuela.

Este proyecto tiene la intención de manejar el control de versiones del sitio http://python.org.ve/ que nos permite tener un pequeño tablero de control de la comunidad Python en Venezuela.

Está basada en el generador de páginas estáticas lektor

¿Cómo correr la página en tu local?

Clona el repo (o descarga los archivos) y dentro de la carpeta del proyecto ejecuta:

sudo pip install lektor
git clone git@github.com:pyve/pyve.github.com.git
git checkout generator
cd pyve.github.com
lektor server

Luego visita http://localhost:5000 en tu navegador y ¡voilá!

Herramientas utilizadas

HTML+CSS+JS son las tecnologías empleadas en el diseño web de esta propuesta, el tema está basado en el framework de diseño web Bootstrap y puede ser detallado en el archivo assets/css/style.css.

Consideraciones del proyecto

¿Cómo colaborar?

Si deseas contribuir en cómo luce el tema del sitio: Es muy sencillo. Con un tanto de conocimiento en javascript y HTML y un manejo básico de control de versiones puedes enviar tu primer cambio al sitio.

Si deseas contribuir agregando contenido: Es muy sencillo. sigue la estrategia de para nuevos contenidos de lektor y haz tu pull request.

Como requisito, debes tener una cuenta en github y seguir los pasos que enumeramos en el archivo CONTRIBUTING.md desde tu cuenta. Si no tienes una cuenta, puedes crear una cuenta fácilmente en la página de github.

Reglas:

  • Todos los PR deberán pasar las pruebas de travis por consiguiente intenta probar tus PR antes de agregar cambios.
  • Si tienes PR pendiente intenta hacer le un rebase cada que veas un commit, estos también se iran mergeando a medida que se agreguen.
  • No podremos ni siquiera los administradores hacer push directo al branch generator, intenta mantener tu fork y llega al branch generator con un PR.

Añadir contenido

Siguiendo la filosofía de Lektor, todo el contenido están incluído en la carpeta content siguiendo una estructura gerárquica. Las principales secciones son:

  • Comunidad
  • Contactos
  • Documentación
  • Eventos
  • Fundación
  • Lista de Correos
  • Python

La manera más fácil de añadir contenido es utilizando el admin de Lektor:

 $ lektor server

En él puedes navegar hasta la sección que contendrá tu nuevo contenido, y le das a añadir página. Le colocas un nombre a la página y Lektor te presentará un formulario con los campos adecuados al tipo de página que vayas a crear.

Por ejemplo, si vas a la sección de Eventos y creas una página ahí, el formulario te presentará todos los campos necesarios para definir un evento, como por ejemplo el lugar y la fecha del evento.

Y siguiendo con este ejemplo, si luego de crear el evento creas una página dentro de él, esa página será una Actividad. Por lo tanto, el formulario que verás será el adecuado para una ello, tendrás campos como tipo de actividad, para saber si es una exposición o un taller, o el nombre del ponente.

Descripción de cambios

En el archivo log.md se van registrando las decisiones de diseño durante el desarrollo.