Wavecast se puede usar de dos maneras. Elige la que mejor se adapte a tu proyecto.
Requisitos Previos
- Hugo v0.146.0 o superior
- Go 1.23 o superior (solo si usas la instalación como módulo)
Opción A: Instalar como Tema de Hugo
Recomendado para la mayoría de los sitios. Clona Wavecast en tu directorio themes/:
Luego añade a tu hugo.toml:
Eso es todo. Hugo descubre automáticamente el shortcode (layouts/_shortcodes/podcast-player.html), JS (assets/js/podcast-player.js) y CSS (assets/css/podcast-player.css) desde el directorio del tema.
Opción B: Instalar como Módulo de Hugo
Si ya usas módulos de Hugo o necesitas combinar Wavecast con otros módulos:
Luego en tu hugo.toml:
Hugo resuelve el módulo y hace que el shortcode, JS y CSS estén disponibles automáticamente.
¿Qué Opción Debo Elegir?
| Quieres… | Usa |
|---|---|
| Configuración simple, un solo tema | Tema (theme = "wavecast") |
| Usar Wavecast junto a otros módulos | Módulo ([module.imports]) |
| Sobrescribir plantillas de Wavecast en tu proyecto | Tema (la cascada de temas de Hugo maneja las sobrescrituras) |
| Construcciones reproducibles y fijadas | Cualquiera: ambas soportan fijar versiones |
| Sin submodulo git ni clon en tu repositorio | Módulo (hugo mod get) |
Desarrollo Local / Demo
Clona el repositorio y ejecuta el sitio de ejemplo incluido:
Abre tu navegador en la URL mostrada por el servidor (ej. http://localhost:1313/wavecast/). El primer reproductor demo usa un archivo .wav local, por lo que funciona inmediatamente sin dependencias externas.
Verificar Instalación
Después de instalar, verifica que el shortcode es reconocido:
Crea una página de prueba y añade un shortcode podcast-player. Si el reproductor se renderiza, está todo listo.