Este es el repositorio de la nueva web del Hacklab Almería, creada mediante Jekyll, Markdown y HTML/CSS.
La maquetación principal está hecha conHTML/CSS, sin embargo cada página individual está escrita en markdown con la idea de simplificar su creación y mantener un estilo uniforme.
Para las tareas de construcción, el encargado será Jekyll.
En distribuciones basadas en Debian bastará un apt-get install jekyll. Como norma general siempre se puede instalar usando las gems de Ruby, gem install jekyll.
Para instalar Jekyll en el sistema de Microsoft puedes seguir este tutorial.
Puede instalarse usando las gems de ruby, gem install jekyll. Requiere las Command Line Tools de XCode.
Bastará con ir a la carpeta raíz de la web y ejecutar jekyll serve.
Para crear una nueva actividad, debes copiar unas de las plantillas (preferiblementeejemplo-jsonlp) del directorio _drafts y nombrar el fichero siguiendo el esquema de fecha+nombre, como en el resto. Por ejemplo:
2014-03-29-dia-arduino.md
Para poder ver los borradores, deberás ejecutar Jekyll en modo draft con jekyll serve --drafts
Una vez hayas terminado la actividad y quieras publicarla, símplemente debes moverla a la carpeta _posts.
├── _posts
│ ├── 2014-03-29-dia-arduino.md
Una vez esté en publicada en actividades, Discourse está configurado para crear automáticamente una entrada en https://foro.hacklabalmeria.net/c/actividades
Consulta la sección de automatismos para saber qué otras cosas ocurren automágicamente.
Es aconsejable comprobar que la página de actividad que acabas de crear, antes de subirla. Normalmente con un vistazo y ver que se genera todo bien, bastará.
Sin embargo, si quieres ir más allá, o has realizado cambios mayores en la web, puedes realizar tests unitarios en local, antes de hacer una subida.
$ bundle install
$ rake test
Sólo podrán hacerlos aquellos con permisos de Administración.
Deberán ir a: Administrar -> Personalizar -> Contenido de Texto -> Encabezado de página
Si necesitan modificar el CSS: Administrar -> Personalizar -> CSS/HTML -> Estilo Hacklab
Estos automatismos están relacionados directamente con acciones automáticas generadas a partir de cambios en nuestra web:
Para las actividades publicadas en esta web (contenidas en _posts/).
- «Prepara los eventos sociales» que se encarga de mandar anuncios programados para las rrss (a partir de http://hacklabalmeria.net/social.xml)
- «Añade los eventos», que añade las actividades al calendario (a partir de http://hacklabalmeria.net/calendar.xml)
© Los respectivos autores, 2015, 2016, 2017, 2018, 2019.
Licencia Attribution 4.0 International (CC BY 4.0)
