hacklab-almeria / hacklab-almeria.github.io

Web en producción del HackLab Almería

Web del Hacklab Almería

Este es el repositorio de la nueva web del Hacklab Almería, creada mediante Jekyll, Markdown y HTML/CSS.

¿Cómo está construida?

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.

¿Cómo instalar Jekyll?

GNU/Linux

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.

Windows

Para instalar Jekyll en el sistema de Microsoft puedes seguir este tutorial.

Mac OS X

Puede instalarse usando las gems de ruby, gem install jekyll. Requiere las Command Line Tools de XCode.

¿Cómo usar Jekyll?

Bastará con ir a la carpeta raíz de la web y ejecutar jekyll serve.

¿Cómo crear un nueva actividad?

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.

Tests

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

¿Cómo se modifica el menú del foro?

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

Automatismos:

Estos automatismos están relacionados directamente con acciones automáticas generadas a partir de cambios en nuestra web:

Zapier

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)

Referencia.

Licencia

© Los respectivos autores, 2015, 2016, 2017, 2018, 2019. Licencia Attribution 4.0 International (CC BY 4.0)