Hugo es:
- Un generador de sitios estáticos rápido y flexible, escrito completamente en Go.
- Un proyecto de código abierto.
En términos técnicos, Hugo toma un directorio fuente de archivos y plantillas y los usa como entrada para crear un sitio web completo. Los contenido son creados por el usuario en lenguaje markdown.
Crear un nuevo sitio con Hugo
Una vez instalado Hugo, El primer paso es crear un sitio Web; para ello, solo debes ejecutar:
hugo new site miSitioEllo creará una carpeta llamada miSitio; la cual contiene a su vez, una serie de carpetas y archivos:
- El archivo "config.toml", que encontramos en la raíz del proyecto; es el archivo global de configuración de un sitio en Hugo.
Añadir un tema
El siguiente paso es instalar un tema; para ello, tenemos que que guardar el tema (la carpeta con los archivos) en un subdirectorio de nuestro proyecto llamado "themes"
Puedes encontrar varias opciones de temas en gohugo.io.
- Slate | Hugo Themes
- Bootstrap Bp Hugo Startpage | Hugo Themes
- Hugo Theme Freshstart | Hugo Themes
- Almeida Cv | Hugo Themes
- Github Style | Hugo Themes
- Hugo Changelog Theme | Hugo Themes
- Hugo Identity Theme | Hugo Themes
- Hugo PaperMod | Hugo Themes
- Influencer Hugo | Hugo Themes
- Hugo Geekdoc | Hugo Themes
- Hugo Book | Hugo Themes
cd themes
git clone https://github.com/themefisher/restaurant-hugo.git- Cada tema tiene aspectos de personalización que pueden ser muy variados, de mayor y menor complejidad.
- La gran mayoría de los temas, tiene una web de ejemplo, para conocer las configuraciones básicas y a partir de allí personalizarlo. Para este tema en particular está en la ruta restaurant-hugo/exampleSite/
Un detalle importante“config.toml”toml", se debe indicar el tema que vamos usar.
Añadir contenido al sitio web
El comando para crear un nuevo contenido es hugo new seguido de la ruta donde estará ese contenido.
hugo new contacto.mdArrancar el servidor para desarrollo
El comando hugo server sirve para arrancar el servidor de desarrollo, que nos permitirá ver el sitio en local a medida que lo vamos construyendo.
Si quieres puedes arrancar el servidor de desarrollo de Hugo con la opción -D para que te muestre también los archivos aunque se encuentren en estado borrador (draft: true).
Generar el sitio para llevar a producción
El comando que nos permite generar todos los archivos estáticos de nuestro sitio es hugo, a secas.
Esto nos creará una carpeta llamada "public". En ella aparecerán todos los archivos de nuestro sitio web, listos para subir a cualquier espacio de alojamiento.
Un detalle importante. Para que las rutas nos funcionen no se nos puede olvidar cambiar
baseURL, es decir, la URL del sitio web, en el archivoconfig.toml.