wiki-hackmeeting/README.md

# Wiki Hackmeeting 2024

Este es el repositorio de la wiki del Hackmeeting 2024. Está creada con Hugo y el tema Blowfish, es la primera vez que 
probamos estas tecnologías para la wiki, ¡no dudéis en dar vuestras opiniones!

## Contribuir 

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 `content` y haciendo un pull request es suficiente.

## Run

Para correr la wiki en local, es necesario tener instalado Hugo, [sigue estas instrucciones](https://gohugo.io/installation/linux/), para debian:

```bash
sudo apt install hugo
```

Para **instalar el tema Blowfish** hay **dos opciones**: i) instalándolo como módulo de Hugo o ii) como submódulo de git.

i) Añadir el tema como módulo de hugo:

```bash
hugo mod get github.com/nunocoracao/blowfish/v2
```

ii) O descargando el submódulo de git:

```bash
git submodule update --init --recursive --progress
```

El tema del Hackmeeting usa una template `custom.html` para la landing page. A vistas de encontrar una forma mejor de 
hacerlo, se tiene que copiar manualmente dentro del tema. Ideas para mejorar esto are welcome!

```bash
cp custom.html themes/blowfish/layouts/partials/home/custom.html
```

Luego simplemente ejecuta el comando:

```bash
hugo server -t blowfish
``` 

Y accede a `http://localhost:1313/`.

## Build

Para generar el sitio estático, simplemente ejecuta el comando 

```bash
hugo --baseURL="https://es.hackmeeting.org/latest/hugo"
``` 

Y se generará la carpeta `public` con el contenido