Repolode
alex-shpak

alex-shpak/hugo-book

Un tema sencillo y adaptable a móviles para Hugo, el generador de sitios estáticos, con el estilo sobrio de un libro.

Estrellas
4,097
Forks
1,311
Issues abiertos
8
Último commit
ayer

¿Qué es?

Hugo Book es un tema para el generador de sitios estáticos Hugo que convierte contenido Markdown en un sitio de documentación con un diseño limpio, similar al de un libro. Incluye un árbol de navegación en la barra lateral, una estructura optimizada para las búsquedas y modos claro y oscuro. Está diseñado para funcionar sin configuración inicial.

El tema incluye shortcodes integrados para elementos habituales de la documentación, admite sitios multilingües y ofrece páginas sencillas para blogs y taxonomías. Sus funciones principales funcionan sin JavaScript, y el proyecto busca evitar interferir con los diseños definidos por los usuarios y priorizar CSS sobre JS siempre que sea posible.

Hay un repositorio de inicio para ponerlo en marcha rápidamente. El tema requiere Hugo v0.158 o superior y utiliza versiones menores al estilo SemVer; se esperan cambios incompatibles entre versiones.

Funciones clave

  • 01Diseño limpio, con estilo de libro y navegación en la barra lateral
  • 02Diseño adaptable y optimizado para móviles
  • 03Compatibilidad con sitios multilingües
  • 04Shortcodes integrados para elementos habituales de la documentación
  • 05Las funciones principales funcionan sin JavaScript
  • 06Modos claro y oscuro

Casos de uso

  • Crear documentación de proyectos o productos con Hugo
  • Crear un sitio de documentación multilingüe
  • Publicar un manual técnico sencillo o una base de conocimiento

Inicio rápido

  1. 1

    Clona el repositorio inicial

    git clone https://github.com/alex-shpak/hugo-book-starter my-docs
  2. 2

    Entra en la carpeta del proyecto

    cd my-docs
  3. 3

    Obtén el submódulo del tema

    git submodule update --init --remote
  4. 4

    Inicia el servidor de desarrollo de Hugo

    hugo server --minify

Antes de usarlo

  • Se esperan cambios incompatibles entre versiones, por lo que las actualizaciones pueden requerir cambios en el sitio.

Temas

Preguntas frecuentes

¿Qué es hugo-book?
Un tema sencillo y adaptable a móviles para Hugo, el generador de sitios estáticos, con el estilo sobrio de un libro. Hugo Book es un tema para el generador de sitios estáticos Hugo que convierte contenido Markdown en un sitio de documentación con un diseño limpio, similar al de un libro. Incluye un árbol de navegación en la barra lateral, una estructura optimizada para las búsquedas y modos claro y oscuro. Está diseñado para funcionar sin configuración inicial.
¿hugo-book es gratuito? ¿Qué licencia tiene?
hugo-book es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿hugo-book sigue mantenido?
Mantenimiento activo. El último commit de hugo-book fue el 21 oct 2026.
¿Para qué puedo usar hugo-book?
Crear documentación de proyectos o productos con Hugo Crear un sitio de documentación multilingüe Publicar un manual técnico sencillo o una base de conocimiento
¿Cómo se instala hugo-book?
Clona el repositorio inicial: git clone https://github.com/alex-shpak/hugo-book-starter my-docs Entra en la carpeta del proyecto: cd my-docs Obtén el submódulo del tema: git submodule update --init --remote Inicia el servidor de desarrollo de Hugo: hugo server --minify
¿Dónde consigo hugo-book?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/alex-shpak/hugo-book

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados