Trabaje con el administrador de archivos
La sección Páginas personalizadas de la Herramienta de configuración del sitio web proporciona un administrador de archivos general (enlace «administrar archivos») para trabajar con personalizaciones. Aunque este administrador de archivos le permite cargar archivos HTML de páginas personalizadas, también proporciona herramientas para crear subdirectorios y cargar cualquier archivo de recursos que no sea ejecutable. Puede cargar imágenes, archivos de vídeo y audio, archivos CSS y JS complementarios, etc.
Si usted está creando personalizaciones en las que varios archivos trabajan juntos, el administrador de archivos le proporciona las herramientas para organizar esos archivos como prefiera. Por ejemplo, es común crear un subdirectorio «js» para almacenar archivos JavaScript incluidos y un subdirectorio «img» para cualquier archivo de imagen vinculados desde HTML personalizado.
Rutas de archivos
Si utiliza el administrador de archivos para subir páginas HTML personalizadas, hay reglas especiales sobre cómo se forma la ruta a esas páginas. Consulte el resumen de páginas personalizadas para más detalles.
Si está utilizando el administrador de archivos para cargar recursos estáticos que serán referenciados por otro código personalizado, necesitará conocer la ruta para poder vincular estos archivos. Para la sección Páginas Personalizadas de la pestaña Configuración Global en la Herramienta de Configuración del Sitio Web, la ruta base utilizada para los archivos cargados en el administrador de archivos es /customizations/global/pages/. Cuando usted accede a los archivos utilizando esta forma de la ruta, se transfieren directamente en lugar de ser analizados por la aplicación CONTENTdm. Por ejemplo, aquí tiene un enlace directo a un archivo JavaScript personalizado:
https://cdmdemo.contentdm.oclc.org/customizations/global/pages/js/open-external.js
Esto no está siendo ejecutado por el navegador, sino que simplemente se muestra. Tenga en cuenta que este archivo se ha colocado en el subdirectorio «js» del administrador de archivos. Si va a incluir este JavaScript en otro archivo HTML o JS, esta es la forma de la ruta que debe utilizar.
Lo mismo es cierto para otros tipos de recursos estáticos. Si tiene una imagen referenciada por su HTML personalizado, su etiqueta img tendría un valor src que se vería así:
https://cdmdemo.contentdm.oclc.org/customizations/global/pages/img/iiif-logo-sm.png
Esta es la forma absoluta de URL para mostrar la relación con toda la ruta. Para la mayoría de las personalizaciones, es mejor utilizar rutas relativas siempre que sea posible. Para el ejemplo de la imagen anterior, la ruta relativa sería /customizations/global/pages/img/iiif-logo-sm.png. Para el ejemplo de archivo JavaScript personalizado mostrado anteriormente, la ruta relativa sería /customizations/global/pages/js/open-external.js.
La funcionalidad de Páginas Personalizadas también existe en la pestaña Configuración a nivel de colección de la Herramienta de Configuración del Sitio Web. La ruta base para los gestores de archivos específicos de la colección incluirá el alias de CONTENTdm de la colección en cuestión. Por ejemplo, si utilizo el administrador de archivos de la Colección de Muestras de OCLC para cargar un archivo de imagen (el alias de la colección es «oclcsample»), entonces este archivo será directamente accesible aquí:
https://cdmdemo.contentdm.oclc.org/customizations/collection/oclcsample/pages/example-image.png
La ruta relativa a este archivo es /customizations/collection/oclcsample/pages/example-image.png.
Nota: Trabajar con rutas de archivo puede resultar confuso a veces, ya que una forma de la ruta accede al contenido a través de la aplicación CONTENTdm (e incluye cualquier modificación o representación dinámica necesaria) y otra forma de la ruta proporciona acceso directo y sin procesar al archivo. La clave es que los archivos a los que se accede a través de una ruta que comienza con /digital/ se ejecutan a través de la aplicación React de CONTENTdm y pueden tener encabezados o pies de página adjuntos, o el código de script puede ejecutarse inmediatamente. Por otro lado, las rutas que comienzan con /customizations/ generalmente serán enlaces directos al archivo sin procesamiento ni interpretación del contenido por parte de CONTENTdm.