Integración de Internet Archive BookReader
El Internet Archive BookReader es un visor de cambio de página de código abierto muy popular. Similar a la integración del visor Mirador, esta receta permite al usuario agregar un botón en la página de detalles del documento, que abre una página personalizada con el visor BookReader lanzado. También utiliza la compatibilidad integrada con IIIF en CONTENTdm, y es similar pero más sencillo de implementar en comparación con el visor Mirador. El BookReader solo funciona con archivos de imagen y aparecerá en la página cuando se muestren los tipos de archivo correctos. Los pasos básicos son:
- Cree y suba una página personalizada vacía como contenedor para el visor de BookReader.
- Descargue el código de Internet Archive BookReader desde Github y suba los archivos a CONTENTdm.
- Cargue el JavaScript que inserta el botón BookReader y carga el visor.
Paso 1: Cree el contenedor de página personalizado
Este paso es muy similar a la página personalizada del visor de Mirador. Puede descargar BookReader.html (use el sitio de demostración de CONTENTdm Cookbook para descargar el código fuente) y subirlo al nivel superior en FileManager: Herramienta de configuración del sitio web > Global > Personalizado > Páginas personalizadas > gestionar archivos.
Paso 2: agregue el paquete BookReader a CONTENTdm
Descargue el BookReader de Internet Archives desde su Github. Navegue haciendo clic en Siguiente en la parte inferior de la página donde está presente v4.18.5.
Nota: Esta receta fue desarrollada y probada con IA BookReader 4.18.5. Otras versiones o más recientes también pueden funcionar, pero no han sido verificadas.
Haga clic en zip debajo de v4.18.5 y descargue el archivo zip. Descomprima el archivo. Solo necesita el directorio BookReader dentro del archivo descomprimido. Suba el directorio de BookReader al nivel superior en fileManager: Herramienta de configuración del sitio web > Global > Personalizar > Páginas personalizadas > gestionar archivos. Puede arrastrar y soltar para subir un directorio completo.
Paso 3: archivo JavaScript personalizado
Hay un archivo JavaScript que debe cargarse. Descargue el archivo bookreader-cp.js y súbalo a: Herramienta de configuración de sitios web > Global > Personalizado > Scripts personalizados.
Nota: Si desea que esta receta admita el zoom, experimente con modificar los parámetros de tamaño en la receta. Está controlado por estas dos líneas en el archivo principal de JS de la receta:
let canvasHeight = canvases[i].height || 1200
let canvasWidth = canvases[i].width || 800
El tamaño está limitado en la receta porque BookReader descarga muchos datos de una vez.
Verificación
Guarde y publique los cambios que realizó en la herramienta de configuración de sitios web.
Para verificar esta receta, primero borre la memoria caché de su navegador local (o use una ventana privada/de incógnito) para asegurarse de que tiene la versión más reciente de sus archivos JavaScript personalizados. Navegue hasta un documento en su sitio web que sea un archivo de imagen (para asegurarse de que tenga soporte para la API de IIIF). Debería ver el icono de BookReader en el lado derecho y a la derecha de los iconos de Descargar o Imprimir. Haga clic en el icono de BookReader. Se abrirá una ventana aparte con ese registro cargado dentro del visor de BookReader.
Imagen 1: icono de BookReader
Imagen 2: El visor de BookReader muestra el archivo de imagen seleccionado
Nota: Solía haber un error por el cual FileManager cambiaba automáticamente «.» por «-» en los nombres de los archivos cargados (no el «.» antes de la extensión), pero se solucionó en octubre de 2021. Esta receta fue actualizada para corregir ese error; por ejemplo, el archivo JS personalizado ahora busca jquery.browser.min.js en lugar de jquery-browser-min.js.