hugohm/README.md

# Página web del hackmeeting

## Crear contenido

Para crear un nodo que se llame `nodo1` para el 2019:

    hugo new 2019/nodos/nodo1.md -k nodo

Para apuntarse como asistente:

    hugo new 2019/asistencia/persona.md -k asistencia

Para crear una página corriente:

    hugo new 2019/como-llegar.md

Para empezar un nuevo hackmeeting:

    hugo new 2022 -k hm


## Mini intro a Hugo

Para probar la web en local hay que instalarse hugo:
https://gohugo.io/getting-started/installing/

Para poner en marcha la web en modo desarrollo:

    hugo server -D

Para compilar la web ejecutar el comando `hugo` sin parámetros, luego
basta con copiar el contenido de la carpeta `public` al servidor web.

Todo el contenido de la web está en la carpeta `content`.

Las plantillas para renderizar el contenido están en la carpeta `layouts`.

Las plantillas para generar contenido están en la carpeta `archetypes`.

Los ficheros estáticos están en la carpeta `static`, se copian tal cual a la
carpeta `public`.

Más información: https://gohugo.io/documentation/


## Estructura básica del contenido

Cada año creamos una carpeta nueva dentro de `content`, usando el archetypes `hm`.
Esta carpeta tiene la página inicial, el manifiesto, el listado de nodos y la
página de asistencia.


## Shortcodes

Estos son los shortcodes definidos para el hackmeeting:

### rawHTML

Renderiza el contenido del shortcode sin procesar, por lo que se puede meter html arbitrario.

Ejemplo:

    {{< rawHTML >}}
    <table>
        <tr><td>Una tabla</td></tr>
    </table>
    {{< /rawHTML >}}

### csvTable

Renderiza un csv como una tabla HTML. Hay que pasarle dos parámetros, el path
del csv relativo a la raíz del proyecto y la clase css que se le asignará a la
tabla.

Hay que generar un fichero csv separado por comas.

Ejemplo, para un fichero `content/2019/nodos/parrilla_viernes.csv':

    {{< csvTable file="/content/2019/nodos/parrilla_viernes.csv" class="parrilla" >}}