Web Hackmeeting
Este es el repositorio de la web del Hackmeeting!
Carpetas
Te encontrarás:
-
scripts: pequeños programas para facilitar el mantenimiento de la página -
static: lo que haya aquí se publicará sin modificaciones en https://es.hackmeeting.org-
historico: aquí archivamos las páginas de años anteriores -
latestolatest-disabled: la página temporal entre HMs que sólo anuncia la fecha y lugar del siguiente HM
-
-
web-hugo: el origen de la página del HM actual / siguiente- Si la página temporal está activada (entre HMs), la encontraremos en: https://es.hackmeeting.org/next/
- En cambio si está desactivada (ya hemos publicado la página), la encontraremos en: https://es.hackmeeting.org/latest/
Contribuir
Textos y traducciones
Para contribuir en el proyecto no es necesario tener Hugo instalado, ni ningún otro requisito especial.
Simplemente modificando los archivos markdown que se encuentran en la carpeta web-hugo/content y haciendo un pull request es suficiente.
Se puede editar desde el IDE Web integrado en Oxacab para abrir el entorno de desarrollo o descargando y ejecutando el proyecto en local.
Podremos observar la estructura de directorios de un proyecto creado con Hugo. Si se quiere saber más sobre esta estructura, la mejor opción es ir directamente a la documentación de Hugo sobre la estructura de directorios.
Para editar la web, se requiere conocimientos básicos del lenguaje de marcado Markdown1 y de su sintaxis2, además de una en cuenta en 0xacab (instancia de GitLab donde se aloja la página web).
Diseño y estructura
Si queremos contribuir con el diseño y la estructura, necesitaremos instalado Hugo, sigue estas instrucciones, para debian:
sudo apt install hugoTema Blowfish
Para instalar el tema Blowfish hay dos opciones: i) instalándolo como módulo de Hugo o ii) como submódulo de git (está así en este repositorio).
i) Actualizar el tema Blowfish ya instalado o añadir el tema como módulo de hugo:
# Actualizar el tema de hugo
hugo mod get -u
# [OPCIONAL] O añadir el tema (si no está instalado o se quiere añadir otro módulo)
hugo mod get github.com/nunocoracao/blowfish/v2ii) O descargando el submódulo de git:
git submodule update --init --recursive --progressTema Hackmeeting
El tema del Hackmeeting usa una template custom.html para la landing page ubicada en partials/home/custom.html.
Para usar los layouts por defecto de blowfish puedes cambiar la propiedad layout en el config/_default/_params.yaml.
Para correr el server en local con la página actual del HM simplemente ejecuta el comando:
cd hugo-web
hugo server -p 1312Y accede a http://localhost:1312/.
Generar todo en local
Para generar el sitio estático, simplemente ejecuta el comando
./scripts/build.sh
# Alternativamente, puedes ejecutar sólo hugo, sin generar históricos, con:
# cd web-hugo
# hugo --baseURL=https://es.hackmeeting.org/latestY se generará la carpeta public con todo el contenido, incluyendo los
históricos de años anteriores.
Publicar la web de un HM
Esto lo podemos hacer con:
./scripts/publish-hm.sh 2025De esta forma se desactivará la página temporal que sólo incluye la fecha y ciudad del siguiente Hackmeeting, y nuestra web estará disponible en:
https://es.hackmeeting.org/latest
Archivar la web de un HM
Pasado el Hackmeeting, cuando tengamos la fecha y la ciudad confirmadas podremos archivar la página del Hackmeeting anterior con:
./scripts/archive-hm.sh 2025Que generará el archivo estático de ese año, activará la página temporal y nos guiará con los siguientes pasos para finalizar el proceso.
A partir de aquí, la página del directorio web-hugo se publicará en:
https://es.hackmeeting.org/next