Saltar al contenido principal
Inicio - Soporte de OCLC

Integración de Universal Viewer

  1. Última actualización
  2. Guardar como PDF
La traducción de este sitio web se genera mediante traducción automática. La calidad y precisión de la traducción automática pueden variar significativamente de un texto a otro.

 

 Enlace:  Vea un ejemplo en vivo.

 Descargar:  Vea y descargue el código fuente en el sitio de demostración de CONTENTdm Cookbook.

 

Universal Viewer es un visor desarrollado por la comunidad basado en IIIF que ofrece una funcionalidad similar a la de Mirador. Cualquier contenido de IIIF puede cargarse y mostrarse en Universal Viewer. Esta receta utiliza la versión 4 de Universal Viewer e integra esta en CONTENTdm de la misma manera que las otras recetas de visor basadas en IIIF.

El diseño de esta receta es más sencillo que el de la receta de Mirador porque carga la aplicación Universal Viewer desde una red de entrega de contenido pública llamada jsDelivr en lugar de servirla directamente desde CONTENTdm. Los archivos utilizados en esta receta se pueden ver y descargar desde el portal de descarga de CONTENTdm Cookbook en la sección Universal Viewer.

Se requieren dos elementos para integrar Universal Viewer. El proceso general se ve así:

  1. Cree una página personalizada vacía que sirva como contenedor para Universal Viewer.
  2. Cargue el archivo JavaScript personalizado que inserta un botón de Visor Universal y carga el visor.

Paso 1: Cree el contenedor de página personalizado

La base para esta receta será una página personalizada estándar que servirá como contenedor para el visor universal (consulte Crear una página personalizada para obtener más información). Esta página HTML tiene CSS en línea para eliminar todos los márgenes y el relleno.

Descargue el archivo de página personalizada uv.html para esta integración. Puede modificar este archivo HTML como mejor le parezca. Por ejemplo, si desea mostrar un título de página diferente cuando se carga Universal Viewer, edite el título en el encabezado YAML en la parte superior del código HTML.

Suba su archivo uv.html en la herramienta de Configuración de Sitios Web en el diálogo Configuración Global > Personalizar > Páginas Personalizadas usando la herramienta de gestión de archivos. Esta receta asume que el archivo HTML se sube al nivel superior de la estructura de archivos (no en un subdirectorio) y que el archivo se llama uv.html. Si renombra el archivo, también deberá modificar el archivo JavaScript utilizado en el paso 2.

Paso 2: Añada el archivo JS personalizado

Esta receta requiere únicamente un archivo JavaScript que se utiliza junto con el archivo uv.html mencionado anteriormente. Este script hace dos cosas:

  • Inserta un botón de visor universal en la página del documento de cualquier registro que tenga soporte para la API de IIIF, y
  • Carga el Universal Viewer y lo renderiza en el contenedor de página personalizado con el Manifiesto IIIF del documento.

Este archivo JavaScript se llama uv-cp.js y puede descargarse desde la sección Universal Viewer del portal de recetas de cocina. Tenga en cuenta que el nombre de este archivo podría cambiar en el futuro para incluir un número de versión si hay actualizaciones en el código del script.

Si no tiene ningún otro JavaScript personalizado ejecutándose en su sitio web, suba el uv-cp.js archivo en la herramienta de configuración del sitio web en el cuadro de diálogo Personalizado > Scripts personalizados. Si ya tiene un archivo JavaScript añadido en la página de Scripts Personalizados, deberá modificar ese archivo JavaScript y copiar todo el contenido de uv-cp.js. en el archivo JS personalizado principal para su sitio de CONTENTdm. El código en uv-cp.js está contenido en una sola función, por lo que puede convivir de forma segura con otro código JavaScript. Si está utilizando la receta Cargar varios archivos JavaScript, puede agregar uv-cp.js a su lista de archivos para cargar.

Después de que haya subido uv-cp.js, Guarde y publique en la herramienta de configuración del sitio web para completar la instalación de la receta.

Verificación

Para verificar esta receta, abra su navegador y navegue hasta un documento de CONTENTdm en su sitio web que sepa que tiene soporte para la API de IIIF. Esto podría ser una imagen o un PDF si su sitio está ejecutando Cantaloupe. Borre la caché de su navegador local (o use una ventana privada/incógnito) para asegurarse de que tiene la versión más reciente de sus archivos JavaScript personalizados. Debería ver el ícono del Visor Universal (las letras «UV») a la derecha de los íconos de Descargar o Imprimir en la página del documento en CONTENTdm. Haga clic en el botón y se abrirá una ventana aparte con ese registro cargado dentro de Universal Viewer.