Esta colección demuestra la función ImportFrom de Greenstone. Por medio del Protocolo de Archivo Abierto (versión 1.1) recupera metadatos de rocky.dlib.vt.edu/~jcdlpix, una colección de fotografías tomadas durante la Conferencia inaugural conjunta de Bibliotecas Digitales. Se creó una colección Greenstone a partir de los registros exportados por este proveedor de datos OAI. La implementación es lo suficientemente flexible para enfrentar diferencias menores de sintaxis entre OAI 1.1 y OAI 2.0.
description1=El archivo de configuración de la colección incluye una línea acquire (adquirir) que es interpretada por un programa especial llamado importfrom.pl. Al igual que otros programas Greenstone, este toma como argumento el nombre de la colección y proporciona un resumen de otros argumentos cuando se les llama con el argumento -help. El programa lee el archivo de configuración de la colección, busca la línea acquire y la procesa. En este caso, se ejecuta por medio del siguiente comando\:
importfrom.pl oai-e(donde el nombre de la colección es oai-e). description2=
La línea acquire en el archivo de configuración especifica el protocolo OAI y proporciona el URL base de un repositorio OAI. El programa importfrom baja todos los metadatos del repositorio en el directorio importar de la colección. El argumento getdoc lo instruye también para que baje los documentos fuente de la colección, cuyos URLs están dados en el campo Identificador de Dublin Core de cada documento (ésta es una convención). Los archivos de metadatos, cada uno de los cuales contiene un registro XML para un documento fuente, se colocan en la estructura de archivos importar junto con los documentos mismos y el nombre de archivo del documento es igual al nombre de archivo en el URL. El campo Identificador se sustituye por el nombre de archivo local y su valor original es conservado en un nuevo campo llamado OrigURL.
description3=He collect/oai-e/etc/oai.txt es un ejemplo de un archivo de metadatos bajados del repositorio.
description4=Una vez que la información OAI se ha importado, la colección se procesa de forma normal. Además de los cuatro plugins estándar (GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin y DirectoryPlugin), el archivo de configuración especifica al plugin OAI, el cual procesa metadatos OAI, y también el plugin para imágenes, porque en este caso los documentos fuente de la colección son imágenes. El plugin OAI tiene una opción llamada input_encoding porque los datos del archivo contienen caracteres extendidos. También tiene un argumento default_language. Normalmente Greenstone determina el idioma de los documentos automáticamente, pero estos registros de metadatos son demasiado pequeños para poder hacerlo de manera confiable, por lo que el inglés se especifica de manera explícita en el argumento language. El plugin OAI descompone y analiza los metadatos y los pasa al correspondiente archivo de documento fuente, el cual es procesado a continuación por un plugin apropiado, que en este caso es ImagePlugin. Este plugin especifica la resolución de las imágenes en pantalla.
description5=Los metadatos extractados de registros OAI son mapeados al esquema de metadatos Dublin Core por defecto. Como resultado, los clasificadores y los índices en esta colección son construídos con elementos de metadatos Dublin Core.
description6=El archivo de configuración de la colección tiene un solo índice de texto completo, el cual contiene el metadato dc.Descripción. Cuando un documento se despliega en pantalla el enunciado de formato DocumentHeading muestra su dc.Asunto. A continuación le sigue el enunciado DocumentContent con screenicon, el cual es producido por ImagePlugin y proporciona una versión en pantalla de la imagen. Ésta cuenta con un hipervínculo al metadato dc.OrigURL, es decir, a la versión original de la imagen en el sitio OAI remoto. Le sigue la dc.Descripción de la imagen, también con un hipervínculo, el tamaño y tipo de la imagen, nuevamente generados como metadatos por ImagePlugin, y finalmente los metadatos de dc.Asunto, dc.Editorial y dc.Derechos de Autor. Éste es el resultado.
description7=Existen dos clasificadores de exploración, uno basado en el metadato dc.Asunto y el otro en el metadato dc.Descripción (pero con un botón llamado "pies de foto"). Recuerde que el clasificador AZCompactList es como AZList, pero genera un estante para los ítems duplicados. En esta colección hay una gran cantidad de imágenes, pero sólo unos cuantos valores diferentes para el metadato dc.Asunto.
description8=Resulta un tanto sorprendente que el clasificador AZCompactList también se utilice (en vez de AZList) para el índice de dc.Descripción, ya que por lo general el metadato dc.Descripción es exclusivo para cada imagen. Sin embargo, en esta colección la misma descripción se emplea en ocasiones para varias imágenes, por lo que algunas de las divisiones en una AZList contendrían un gran número de imágenes, haciendo que la transmisión de esa página fuera más lenta. Para evitarlo se utiliza la versión compacta de la lista con algunos argumentos (mincompact, maxcompact, mingroup, minnesting) para controlar la presentación en pantalla. Por ejemplo, los grupos (representados por estantes) no se forman a menos que tengan al menos 5 (mingroup) ítems. A fin de conocer el significado de los otros argumentos para este clasificador ejecute el comando classinfo.pl AZCompactList. Los programas classinfo.pl (para los clasificadores) y pluginfo.pl (para los plugins) son herramientas sumamente útiles para conocer las funciones de los módulos Greenstone. Fíjese además en la barra de directorios en el archivo de configuración, usada para indicar la continuación de la línea anterior.
description9=La especificación de formato VList muestra la miniatura de la imagen con hipervínculos al documento asociado, seguida por el metadato dc.Description. El resultado se puede ver aquí. Las Vlists para los clasificadores utilizan numleafdocs para cambiar entre un icono que representa varios documentos (el cual aparecerá como un estante) y la miniatura, si sólo hay una imagen.
description10=Greenstone incorpora un servidor/proveedor de datos OAI. Se ejecuta mediante un programa CGI llamado "oaiserver.cgi", y se encuentra en el directorio cgi-bin de Greenstone. Se accede a él utilizando el mismo URL que para la biblioteca Greentone (reemplazando "library.cgi" por "oaiserver.cgi"). Si usted está usando el servidor de biblioteca local, debe instalar un servidor web (como Apache) para poder ejecutar el servidor OAI.
description11=La configuración del servidor se hace mediante el archivo oai.cfg que se encuentra en el directorio etc de Greenstone. Este fichero especifica la información general sobre el repositorio, e incluye un listado de las colecciones accesibles para los clientes OAI. En principio, las coleccciones no son accesibles. Para permitir el acceso a una colección, añada su nombre a la lista oaicollection. Las colecciones construidas con versiones de Greenstone anteriores a la 2.52 deben ser reconstruidas antes de que puedan ser accesibles.
description12=El servidor OAI de Greenstone actualmente soporta Dublin Core, qualified Dublin Core y rfc1807. La línea oaimetadata especifica qué conjuntos deberían ser usados. Para las colecciones que usan otros conjuntos de metadatos, deben indicarse reglas de mapeo de metadatos para asociar los metadatos existentes con los esquemas utilizados. Vea el archivo oai.cfg para mayores detalles.