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,,,

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