Documentación
Versión actual: v0.9.0-beta (marzo 2026) Esta documentación corresponde a Telar v0.9.0-beta. Consulta el CHANGELOG de Telar para notas de la versión.
Bienvenido a la documentación de Telar. Esta guía te ayudará a crear narrativas visuales usando imágenes IIIF y scrollytelling.
Primeros pasos
¿Nuevo en Telar? Comienza aquí:
- Inicio rápido - Crea tu primera exhibición paso a paso
- Planea tu narrativa - Conoce el modelo narrativo
- Agrega tu contenido - Sube imágenes, crea historias
- Revisa y perfecciona - Dale los toques finales
Configura tu sitio
- Configuración manual - Google Sheets + GitHub, no necesitas instalar nada
- Desarrollo local - CSV + Jekyll para control total
- Actualización - Mantén tu sitio al día
Configura tu proyecto
- Generador y editor de configuración - Crea o edita tu _config.yml
- Referencia de configuración - Lista completa de ajustes
- Validador de configuración - Verifica errores antes de hacer commit
Tu contenido
- Objetos - Define objetos en tu hoja de cálculo con metadatos como título, creador y periodo
- Imágenes autoalojadas - Sube imágenes y Telar genera teselas IIIF ampliables automáticamente
- Imágenes IIIF externas - Usa imágenes de museos, bibliotecas y otros proveedores IIIF
- Historias y paneles - Narrativas paso a paso con paneles de detalle
- Contenido enriquecido - Archivos markdown para paneles más ricos
- Sintaxis de Markdown - Referencia de formato
- Widgets - Carruseles, pestañas, acordeones
Tus datos
- Google Sheets - Configuración y flujo de trabajo
- Columnas del proyecto - Referencia de project.csv
- Columnas de objetos - Referencia de objects.csv
- Columnas de historias - Referencia de CSV de historias
- Columnas del glosario - Referencia de glossary.csv
Funciones del sitio
- Galería de objetos - Navega, busca y filtra tu colección
- Glosario - Términos consultables en línea
- Historias privadas - Encripta historias con una clave
- Páginas personalizadas - Páginas independientes fuera de las historias
- Insertar en Canvas - Inserta en plataformas LMS
Personalización
- Temas - Elige o crea temas visuales
- Página de inicio - Personaliza la página principal
- Menú de navegación - Configura el menú de navegación
- Contenido de demostración - Historias de demostración integradas
Para desarrolladores
- Configuración local - Configuración de Ruby, Jekyll y Python
- GitHub Actions - Referencia del flujo CI/CD
- Sistema de demostración - Cómo funciona el sistema de contenido demo
- Sistema de inserción - Arquitectura de inserción en LMS
- Estilos avanzados - CSS personalizado y diseños
- Optimización móvil - Guía de diseño responsive