Explicar la idea de la web en el readme
continuous-integration/drone/push Build is passing Details

This commit is contained in:
Ales (Shagi) Zabala Alava 2021-11-09 13:01:56 +01:00
parent aa5a159df1
commit 226021a203
1 changed files with 29 additions and 1 deletions

View File

@ -1,5 +1,34 @@
# 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:
@ -77,4 +106,3 @@ 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" >}}