Este repositorio contiene el código fuente y el contenido de mi blog personal construido mediante Hugo y Bulma.
Para montar este blog en un entorno de desarrollo es necesario:
- Instalar Hugo en su versión extended.
- Clonar este mismo repositorio.
Si no quieres instalar Hugo, puedes usar Visual Studio Code. En el repositorio verás la carpeta .devcontainer que contiene la configuración necesaria para ejecutar Hugo desde un contenedor.
Este blog se publica en Netlify de forma automática cada vez que se hace un push a main a modo de Continuous Deployment. La URL de este blog es https://anedonia.website/.
Cualquier aportación, a modo de pull request será bienvenida. Este repositorio utiliza Conventional Commits.
Una vez se tiene el entorno de desarrollo se puede contribuir de dos formas, mejorando el aspecto visual o mejorando/aportando contenidos.
Para hacer cambios en el aspecto visual el directorio que te interesa es themes/anedonia y la documentación de Hugo al respecto de los Templates.
Para mejorar o aportar contenidos el directorio que te interesa es content y la documentación de Hugo al respecto del Content Management.
A modo de rápido resumen, en el directorio content hay tantos archivos Markdown como entradas en el blog. A parte del contenido de la entrada, cada archivo tiene una cabecera, conocida como Front Matter, que contiene ciertos metadatos que ayudan a Hugo a tomar cada archivo y darle forma de entrada de un blog.
Para ver el blog en el entorno de desarrollo hay que ejecutar:
~ hugo server -DAbrir en un navegador la URL: http://localhost:1313/.
Todo cambio que se haga tanto en los contenidos como en el aspecto visual se verá reflejado en el navegador.
Si se quiere acceder desde otra máquina, hay que ejecutar:
hugo server -D --bind=0.0.0.0 --baseURL=<IP>
# Donde IP puede ser, por ejemplo, http://192.168.1.20Desde otra máquina, con acceso a la red 192.168.1.x, abrir en un navegador la URL: http://192.168.1.20:1313.