Contenido

Guía Completa: Cómo Crear un Blog en Hugo desde Cero

/images/posts/6.png

Hugo es un generador de sitios estáticos rápido y flexible, ideal para crear blogs. En esta guía, aprenderás a instalar Hugo, crear un blog y desplegarlo en la web.


🚀 1. Instalación de Hugo

🔹 Windows

  1. Descarga el instalador desde Hugo Releases.
  2. Extrae el archivo y agrega la ruta al PATH del sistema.
  3. Verifica la instalación ejecutando:
    hugo version

🔹 Linux & macOS

  1. Usa Homebrew (macOS) o el gestor de paquetes de tu sistema:
    brew install hugo  # macOS
    sudo apt install hugo  # Debian/Ubuntu
    sudo pacman -S hugo  # Arch Linux
  2. Verifica la instalación:
    hugo version

📂 2. Crear un Nuevo Proyecto en Hugo

  1. Abre una terminal y ejecuta:
    hugo new site mi-blog
  2. Entra al directorio del blog:
    cd mi-blog
  3. Descarga un theme, por ejemplo, el theme LoveIt:
    git clone --depth=1 https://github.com/dillonzq/LoveIt themes/LoveIt
  4. Configura el theme en config.toml:
    theme = "LoveIt"

✍️ 3. Crear un Post en Hugo

Para agregar una nueva entrada al blog:

hugo new posts/mi-primer-post.md

Edita el archivo content/posts/mi-primer-post.md y agrégale contenido:

---
title: "Mi Primer Post en Hugo"
date: 2025-02-24T12:00:00
description: "Este es mi primer post creado en Hugo."
draft: false
---

Bienvenido a mi blog en Hugo 🚀. Esta es una prueba de contenido para ver cómo funciona.

Para que el post sea visible, asegúrate de que draft: false.


🎨 4. Configurar el Tema y Personalizar el Blog

  1. Edita config.toml y agrega configuraciones básicas:
    baseURL = "https://tublog.com/"
    languageCode = "es"
    title = "Mi Blog con Hugo"
    theme = "LoveIt"
  2. Agrega redes sociales:
    [params.social]
      twitter = "tuusuario"
      github = "tuusuario"
      linkedin = "tuusuario"
  3. Cambia la imagen de portada:
    • Guarda tu imagen en static/images/.
    • Edita featured_image en los posts.

🌎 5. Ejecutar y Visualizar el Blog

Para probar el blog en tu navegador:

hugo server -D

Abre http://localhost:1313 y revisa tu blog.


🚀 6. Desplegar el Blog en GitHub Pages

  1. Crea un repositorio en GitHub.
  2. Genera el sitio estático:
    hugo
  3. Sube los archivos de public/ a GitHub Pages:
    cd public
    git init
    git remote add origin https://github.com/tuusuario/tu-blog.git
    git branch -M main
    git add .
    git commit -m "Publicar blog en Hugo"
    git push -u origin main

Tu blog estará disponible en https://tuusuario.github.io/tu-blog 🚀.


✅ Conclusión

Ahora tienes un blog funcional con Hugo. Puedes personalizar el tema, agregar más posts y desplegarlo en Netlify, Vercel u otros servicios.

🔹 Si necesitas ayuda con diseño o funcionalidades, comenta abajo! 🚀