barrantesgerman/barrantesgerman.github.io

HABV Site

Sitio web de habv.org

Blog personal de Herman Barrantes sobre Java, Linux, Tecnología y Cultura Geek.

El sitio está hospedado en Github Pages y el contenido es construido con el generador de sitios estáticos JBake.

Instalar JBake

En el sitio oficial de JBake están las instrucciones para los diferentes sistemas operativos, los siguientes comandos son para el caso de Linux:

$ curl -s "https://get.sdkman.io" | bash
$ sdk install jbake

Descargar el repositorio

Para descargar el repositorio de Github se debe ejecutar el siguiente comando:

$ git clone https://github.com/barrantesgerman/barrantesgerman.github.io.git habv

Agregar contenido al sitio

JBake soporta varios formatos, para este sitio en particular se prefiere el uso de Markdown, por lo que se recomienda el uso de editores de texto que soporte el formato, como Typora.

Dado que JBake requiere un formato especial al inicio del documento, se creó una carpeta en habv/jbake/original/ para guardar el contenido original sin este formato especial.

Cuando el contenido está listo para publicar, se mueve a la carpeta habv/jbake/content/blog/año/mes/día/ y se coloca el formato especial al inicio del documento.

Compilar y ejecutar el sitio localmente

Para compilar y ejecutar el sitio localmente se deben ejecutar los siguientes comandos:

# colocarse dentro de la carpeta jbake
$ cd habv
$ cd jbake
# ejecutar JBake
$ jbake -b . .. -s
# esperar a que JBake indique que ya se puede acceder a http://localhost:8820/

Compilar y subir los cambios del sitio

Para compilar y subir los cambios del sitio se deben ejecutar los siguientes comandos

# colocarse dentro de la carpeta jbake
$ cd habv
$ cd jbake
# ejecutar JBake
$ jbake -b . ..
# esperar a que JBake indique terminó
# retroceder una carpeta
$ cd ..
# agregar los cambios a git y subirlos
$ git add -A
$ git commit -m "mensaje descriptivo de los cambios"
$ git push origin master