Wavecast usa el front matter de Hugo para configurar episodios tanto para el reproductor como para el feed RSS del podcast.
Front Matter del Reproductor de Audio
Añade una clave podcast: al front matter YAML de cualquier página para renderizar un reproductor:
Campos del Reproductor
| Campo | Requerido | Descripción |
|---|---|---|
podcast.src | sí | URL de audio o ruta de archivo local |
podcast.poster | no | URL de imagen de portada |
podcast.chapters | no | Pares HH:MM:SS-Etiqueta separados por comas |
podcast.description | no | Notas en Markdown renderizadas debajo del reproductor |
podcast.source | no | Adaptador de fuente: "local", "azuracast", "ivoox" |
podcast.persistent | no | Establecer en false para desactivar persistencia |
También puedes pasarlos directamente como parámetros del shortcode:
Campos RSS del Podcast
Para feeds RSS de podcast compatibles con iTunes, añade campos adicionales a podcast: en tu front matter:
Referencia de Campos RSS
| Campo | Tipo | Por defecto | Descripción |
|---|---|---|---|
podcast.src | string | : | URL del archivo (requerido para inclusión en feed) |
podcast.type | string | "audio/mpeg" | Tipo MIME |
podcast.duration | string | : | Duración como HH:MM:SS o segundos |
podcast.season | int | : | Número de temporada iTunes |
podcast.episode | int | : | Número de episodio iTunes |
podcast.explicit | bool | : | Sobrescribe indicador explícito del sitio |
podcast.author | string | : | Sobrescribe autor del podcast del sitio |
podcast.guid | string | Enlace permanente | Identificador único |
podcast.episodeType | string | "full" | "full", "trailer", o "bonus" |
podcast.subtitle | string | : | Avance breve (máx 255 caracteres) |
podcast.summary | string | : | Descripción completa (máx 4000 caracteres) |
Configuración Global del Podcast
Los metadatos globales del podcast van en hugo.toml bajo [params.podcast]:
Cómo Funciona la Detección RSS
| Escenario | Salida RSS |
|---|---|
Sin [params.podcast] en config | RSS 2.0 estándar (para blogs) |
[params.podcast] con author, image o description | RSS de podcast iTunes completo con namespace itunes: |
Episodio tiene podcast.src (archivo local) | Enclosure con length resuelto desde recursos Hugo |
Episodio tiene podcast.src (URL remota) | Enclosure con length="0" |
Episodio NO tiene podcast.src | Omitido del feed |
El feed está disponible en /index.xml. Valídalo en validator.w3.org/feed.
Próximos Pasos
- Configurar página de inicio y pie
- Aprender sobre adaptadores de fuente para AzuraCast e iVoox
- Ver todos los shortcodes para contenido enriquecido