hugohm/README.md

70 lines
1.6 KiB
Markdown

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