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
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á!
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.
- Este repositorio git trata de cumplir con las reglas que propone el flujo de trabajo git-flow.
- Esta propuesta trata de cumplir con las reglas que propone el versionamiento semantico.
- La organización del contenido está guiada por el sitio python.info.ve actual y por lo escrito en la propuesta del Rediseño del Sitio Web.
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.
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.
En el archivo log.md se van registrando las decisiones de diseño durante el desarrollo.