Objetos

Los objetos son los materiales en el centro de tu sitio Telar — imágenes, videos, grabaciones de audio, documentos y otros materiales que tus historias exploran.

El Compositor ofrece una interfaz visual para gestionar objetos — incluyendo obtención automática de manifiestos IIIF, carga de imágenes y edición de metadatos.

Definir objetos

Cada objeto de tu sitio se define como una fila en tu hoja de cálculo de objetos — ya sea en la pestaña de objetos de tu Google Sheet, o en objects.csv (u objetos.csv) en telar-content/spreadsheets/.

Como mínimo, cada objeto necesita un object_id y un title:

object_id,title
textile-001,Fragmento de Textil Colonial
map-lima,Mapa de Lima

• object_id — Un identificador único (minúsculas, guiones, guiones bajos). Se convierte en la URL del objeto: /objects/textile-001/
• title — El nombre visible
• alt_text — Texto alternativo para accesibilidad (opcional). Si se deja vacío, se usa el title del objeto.

Detección del tipo de medio

Telar determina automáticamente si un objeto es una imagen, un video o un archivo de audio según su fuente — no se necesita configuración adicional:

• Imagen — Un archivo autoalojado (JPG, PNG, etc.) en telar-content/objects/, o un manifiesto IIIF externo en source_url
• Video — Una URL de YouTube, Vimeo o Google Drive en source_url
• Audio — Un archivo de audio autoalojado (MP3, OGG, M4A) en telar-content/objects/

Para las imágenes, tienes dos opciones:

• Autoalojadas: Pon los archivos de imagen en telar-content/objects/ con nombres que coincidan con el object_id. Telar genera las teselas (tiles) IIIF automáticamente.
• IIIF externas: Agrega una columna source_url con la URL de la imagen IIIF (info.json o manifiesto).

Para videos y audio, consulta Objetos de video y Objetos de audio.

Puedes agregar metadatos más detallados para cada objeto — descripción, creador, periodo, año, medium (el género o medio del objeto, p. ej. “Fotografía”, “Óleo”, “Historia oral”), dimensiones, fuente, crédito y más. Consulta la referencia de Columnas de objetos para la lista completa de columnas.

La columna medium (antes object_type) describe el género o medio del objeto — no el tipo de medio (Imagen, Video, Audio), que Telar detecta automáticamente. El nombre de columna object_type sigue funcionando por compatibilidad. En español, también se acepta medio_genero.

Páginas de objetos

Cada objeto tiene su propia página en /objects/{object_id}/. La página muestra:

• Un visor — un visor IIIF con zoom profundo para imágenes, un reproductor integrado para videos o un reproductor de audio para archivos de audio
• Una tabla de metadatos con todos los campos disponibles (creador, periodo, medio, dimensiones, fuente, crédito)
• Un selector de coordenadas (imágenes) o selector de tiempo de clip (videos y audio) para capturar valores que se usan en los pasos de las historias
• Las historias relacionadas que hacen referencia al objeto
• Una sección de descripción, si proporcionaste una en la hoja de cálculo

Selector de coordenadas

El selector de coordenadas es una herramienta de desarrollo en cada página de objeto. Haz clic o aplica zoom en la imagen y luego lee las coordenadas normalizadas (rango de 0 a 1) que aparecen debajo del visor. Usa los botones Copy para copiar las coordenadas directamente en el CSV de tu historia.

Véase también

• Galería de objetos — Explora, busca y filtra tu colección
• Columnas de objetos — Referencia completa de columnas para objects.csv
• Imágenes autoalojadas — Sube y procesa tus propias imágenes
• Imágenes IIIF externas — Usa imágenes de museos y bibliotecas
• Objetos de video — Agregar videos de YouTube, Vimeo y Google Drive
• Objetos de audio — Agregar archivos de audio autoalojados
• Historias y paneles — Cómo se usan los objetos en las historias