Docs Documentación

Imágenes IIIF externas

Muchos museos, bibliotecas y archivos ponen sus colecciones a disposición a través de una tecnología llamada IIIF (Marco Internacional de Interoperabilidad de Imágenes). Esto significa que puedes construir historias en Telar usando imágenes de alta resolución de instituciones de todo el mundo, sin descargar ni alojar las imágenes.

Encontrar imágenes IIIF

Busca recursos IIIF en:

Cuando una institución ofrece IIIF, generalmente encontrarás una URL de manifiesto — un enlace que describe la imagen y sus metadatos. Normalmente termina en info.json o manifest.json.

Agregar una imagen externa

En tu hoja de cálculo de objetos (Google Sheet u objects.csv):

  1. Crea una fila con un object_id único (ej., museum-textile-001)
  2. Agrega la URL del manifiesto IIIF en la columna source_url: 
    https://example.org/iiif/image/abc123/info.json

Eso es todo. Telar obtendrá la imagen directamente del servidor de la institución cuando alguien visite tu sitio.

Formatos de URL de manifiesto

Las URLs IIIF normalmente se ven así:

Telar es compatible con ambos formatos y con las dos versiones de IIIF (2.0 y 3.0).

Combinar imágenes propias y externas

Puedes usar tus propias imágenes e imágenes IIIF externas en el mismo proyecto. Deja source_url en blanco para los objetos con imágenes autoalojadas:

object_id,title,...,source_url
mi-textil,Mi textil,,,
mapa-museo,Mapa del museo,...,https://example.org/iiif/manifest.json
mi-ceramica,Mi cerámica,,,

Documentos de múltiples páginas

Algunos manifiestos IIIF describen documentos de múltiples páginas — libros digitalizados, manuscritos, registros legales o mapas con varias hojas. Estos manifiestos contienen múltiples canvases, uno por página.

Telar maneja los manifiestos de múltiples páginas de la misma manera que los de una sola imagen. Agrega la URL del manifiesto a la columna source_url en tu hoja de cálculo de objetos:

object_id,title,source_url
leyes-nuevas,Recopilación de leyes,https://example.org/iiif/presentation/3/leyes-nuevas/manifest.json

Páginas de objetos

En las páginas de objetos, el visor muestra el documento completo con controles de navegación — flechas de avance y retroceso y un selector de página — para que quienes visitan puedan recorrer todas las páginas.

Historias

En las historias, cada paso puede hacer referencia a una página específica usando la columna pagina:

paso,objeto,x,y,zoom,pagina,pregunta,respuesta
1,leyes-nuevas,0.5,0.5,1,1,¿Qué es este documento?,Un código legal clave del periodo colonial.
2,leyes-nuevas,0.4,0.15,2.5,10,Una disposición clave,Esta página detalla el marco legal que gobernaba la administración colonial.

La columna pagina indica qué canvas (página) del manifiesto mostrar. Los números de página comienzan en 1.

Encontrar coordenadas para una página específica. Navega a la página de objeto de tu documento de múltiples páginas. Usa los controles de navegación para ir a la página que deseas. Luego usa el selector de coordenadas — incluye automáticamente el número de página actual en los valores copiados.

Encontrar manifiestos de múltiples páginas

Los manifiestos IIIF de múltiples páginas son comunes en instituciones que han digitalizado libros y manuscritos:

Busca un enlace de “manifiesto IIIF” en la página del objeto, o consulta la documentación IIIF de la institución.

Extracción automática de metadatos

Cuando proporcionas una source_url, Telar puede llenar automáticamente los metadatos a partir del manifiesto IIIF — título, descripción, creador, periodo, ubicación y crédito. Esto te ahorra escribir información que la institución ya tiene registrada.

Cómo usarlo

Agrega la URL del manifiesto IIIF a tu hoja de cálculo y deja los campos de metadatos vacíos:

object_id,title,description,source_url,creator,period,location,credit
map-001,,,https://example.org/iiif/manifest.json,,,,

Cuando tu sitio se compile, Telar:

  1. Obtendrá el manifiesto IIIF
  2. Extraerá los metadatos disponibles
  3. Llenará los campos que dejaste vacíos
  4. Conservará los valores que hayas escrito

Tus datos siempre tienen prioridad

Tienes control total sobre lo que se extrae:

Ejemplo — sobrescritura parcial:

object_id,title,description,source_url,creator,period,location,credit
map-001,Mi título personalizado,,https://example.org/manifest.json,,,,

Telar usará “Mi título personalizado” (tu valor) y extraerá la descripción, creador, periodo, ubicación y crédito del manifiesto.

Detección de idioma

La extracción respeta la configuración de idioma de tu sitio (telar_language en _config.yml):

Detección inteligente de créditos

Para el campo credit, Telar filtra textos legales genéricos (URLs de Creative Commons, avisos de derechos) y busca líneas de atribución significativas — el nombre de la institución, el titular de los derechos o la línea de crédito.

Qué busca Telar

Cada institución nombra sus metadatos de manera diferente. Telar busca variaciones comunes:

Campo Busca
title Title, Label, Name
description Description, Summary, Note
creator Creator, Artist, Maker, Author
period Date, Period, Creation Date, Date Created
location Repository, Holding Institution, Current Location
credit Attribution, Rights Holder, Credit Line, Provider

Cuándo escribir tus propios valores

Quizás quieras ingresar tus propios valores cuando:

Procesamiento durante la compilación

La extracción de metadatos ocurre automáticamente al compilar el sitio:

Validación

Durante la compilación, Telar verifica cada manifiesto:

Revisa los registros de la compilación para ver el estado de la extracción.

Limitaciones

Solución de problemas

La imagen no carga

Los metadatos no aparecen

Carga lenta

Véase también