Documentación

Versión actual: v1.2.0 (abril 2026) Esta documentación corresponde a Telar v1.2.0. 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í:

• Primeros pasos - Elige tu método de configuración
• Usa el Compositor - Configuración visual, sin necesidad de programar
• Configura con Google Sheets - Configuración guiada con herramientas interactivas
• Desarrollo local - CSV + Jekyll para control total
• 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
• 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