56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# 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 |