109 lines
3.3 KiB
Markdown
109 lines
3.3 KiB
Markdown
# Página web del hackmeeting
|
|
|
|
La principal ventaja de esta web con respecto a la que hay actualmente es que
|
|
no necesita mantenimiento, mantiene la posibilidad de editar contenido por
|
|
varias personas y simplifica el backup.
|
|
|
|
El flujo de trabajo típico para añadir contenido a la web sería este:
|
|
|
|
1. Crear o editar un fichero en la carpeta `content`
|
|
2. Comprobar en local que la modificación es correcta
|
|
3. Hacer un commit con las modificaciones
|
|
4. Subir el commit al repositorio de git
|
|
5. Compilar la web
|
|
6. Enviar los ficheros al servidor web.
|
|
|
|
Los pasos 5 y 6 se pueden automatizar con alguna herramienta de integración
|
|
continua. En este ejemplo se usa drone.io. Para simplificar el resto de los
|
|
pasos la idea es preparar scripts u otro tipo de programas, que ayuden a
|
|
generar el contenido de manera más interactiva.
|
|
|
|
Este proceso puede ser demasiado complicado para personas sin experiencia en
|
|
git o markdown, sobre todo las integrantes del grupo local, que además no
|
|
conocen el funcionamiento de esta herramienta. Propongo instaurar el rol de
|
|
"madrina(s) de grupo local", gente que se encargue de asistir al grupo local y
|
|
en caso necesario de encargarse de subir los contenidos a la web.
|
|
|
|
Los datos que son más útiles para el grupo local se guardan en ficheros csv,
|
|
que es fácil de modificar en una hoja de cálculo, y permite un postpropceso
|
|
sencillo para obtener datos interesantes. Por ejemplo la cantidad de asistentes
|
|
que hay apuntados para cenar el sábado.
|
|
|
|
## 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" >}}
|