81 lines
1.9 KiB
Markdown
81 lines
1.9 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 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" >}}
|
|
|