From 226021a20334cc0f484b4f7ee1d091465f3d9b7f Mon Sep 17 00:00:00 2001 From: shagi Date: Tue, 9 Nov 2021 13:01:56 +0100 Subject: [PATCH] Explicar la idea de la web en el readme --- README.md | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6d1aa48..4cfee4d 100644 --- a/README.md +++ b/README.md @@ -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" >}} -