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" >}}