wiki-hackmeeting/README.md

1.6 KiB

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, para debian:

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:

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

ii) O descargando el submódulo de git:

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!

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

Luego simplemente ejecuta el comando:

hugo server -t blowfish

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

Build

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

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

Y se generará la carpeta public con el contenido