Cette collection montre la fonctionnalité ImportFrom de Greenstone. Par le biais de Open Archive Protocol (version 1.1), elle récupère des méta-données de rocky.dlib.vt.edu/~jcdlpix, une collection de photos prise lors de la cérémonie inaugurale de Joint Conference on Digital Libraries. Une collection Greenstone est créée à partir d'articles exportés du pourvoyeur de données OAI. L'implémentation est assez flexible pour s'accomoder des différences négligeables de syntaxes entre OAI 1.1 et OAI 2.0.
description1=Le fichier de configuration de la collection comprend une ligne acquire (acquérir) qui est interprétée par un programme spécial appelé importfrom.pl. A l'instar des autres programmes Greenstone, celui-ci prend comme argument le nom de la collection et fournit un résumé des autres arguments quand ils sont appelés avec l'argument -help. Il lit le fichier de configuration de la collection, trouve la ligne acquire et en fait le traitement. Dans ce cas, il démarre avec la commande\:
importfrom.pl oai-e(le nom de la collection est oai-e). description2=
La ligne acquire dans le fichier de configuration spécifie le protocole OAI et donne l'URL de base d'un répertoire OAI. Le programme importfrom télécharge toutes les méta-données de ce entrepôt dans le dossier import de la collection. L'argument getdoc lui donne les instructions de télécharger aussi les documents sources de la collection dont les URL sont données dans le champ Dublin Core Identifier (Identificateur) de chaque document (ceci est une convention générale). Les fichiers de méta-données, dont chacun contient un enregistrement XML pour un document source, sont placés dans la structure de fichiers import avec les documents eux-mêmes, et le nom de fichier du document est le même que le nom de fichier dans l'URL. Le champ Identifier est écrasé pour donner le nom de fichier local et sa valeur originale est retenue dans le nouveau champ appelé OrigURL.
description3=collect/oai-e/etc/oai.txt est un exemple de fichier de méta-données téléchargé.
description4=Une fois que l'information OAI a été importée, la collection est traitée de façon usuelle. Le fichier de configuration précise le plugin OAI, qui traite la méta-donnée OAI et le plugin de l'image, car dans ce cas les documents source de la collection sont des fichiers d'images. En plus des quatre plugiciels de base (GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin and DirectoryPlugin), le fichier de configuration détermine le comportement du plugiciel OAI, qui traite les métadonnées OAI, ainsi que celui du plugiciel Image, puisque dans ce cas, les documents sources de la collection sont des fichiers images. Il a aussi un argument default_language. Normalement, Greenstone détermine automatiquement la langue des documents, mais ces enregistrements de méta-données sont très insuffisants pour que ceci soit fait de manière fiable\: dès lors, l'anglais est spécifié explicitement dans l'argument language. Le plugin OAI analyse la méta-donnée et la transmet au fichier du document source approprié, qui est ainsi traité par un plugin approprié --- dans ce cas-ci par ImagePlugin. Ce plugin spécifie la résolution pour les versions écran des images.
description5=Par défaut, les métadonnées extraites d'enregistrements OAI sont converties en métadonnées Dublin Core. Par conséquent, les classificateurs et les index de cette collection sont construits à partir des éléments de métadonnées Dublin Core.
description6=Le fichier de configuration de la collection a un index "full-text" unique contenant la méta-donnée dc.Description. Quand un document est affiché, la déclaration de format DocumentHeading révèle son dc.Subject (Sujet). Elle est ensuite suivie de la déclaration DocumentContent avec screenicon produit par ImagePlugin et qui donne une version résolution d'écran de l'image; elle est liée à la méta-donnée dc.OrigURL, c'est à dire la version originale de l'image sur le site OAI distant. Elle est suivie par dc.Description de l'image, aussi avec un lien; le type et la taille de l'image, générés également comme méta-données par ImagePlugin; et enfin les méta-données dc.Subject, dc.Publisher et dc.Rights. Voici le résultat.
description7=Il y a deux classificateurs de navigation, l'un basé sur la méta-donnée dc.Subject et l'autre sur la méta-donnée dc.Description (mais avec un bouton dénommé "légends"). On rappelle que le classificateur AZCompactList est identique à AZList mais produit un rayon pour dupliquer les articles. Cette collection contient plusieurs images mais seulement peu de valeurs différentes pour la méta-donnée dc.Subject.
description8=C'est un peu surprenant que AZCompactList soit utilisé (au lieu de AZList) pour l'index dc.Description aussi, car la méta-donnée dc.Description est usuellement unique pour chaque image. Cependant, dans cette collection, la même description a été occasionnellement donnée à plusieurs images, et certaines des divisions dans AZList contiendraient un grand nombre d'images, ralentissant la transmission de cette page. Pour éviter cela, la version compact de la liste est utilisée avec quelques arguments (mincompact, maxcompact, mingroup, minnesting) pour contrôler l'affichage ' c'est à dire des groupes (représentés par les rayons de bibliothèque) ne sont formés qu'à condition qu'il aient au moins cinq éléments (mingroup). Pour trouver la signification des autres arguments pour ce classificateur, il faut exécuter la commande classinfo.pl AZCompactList. Les programmes classinfo.pl (pour classificateurs) et pluginfo.pl (pour plugins) sont des outils précieux pour connaître les capacités des modules de Greenstone. Il faut noter que le "backslash" (\\\\) dans le fichier de configuration est généralement utilisé pour indiquer une continuation de la ligne précédente.
description9=La spécification du format Vlist montre l'onglet de l'image, lié (hyperlien) au document associé, suivi de la méta-donnée dc.Description; le résultat peut être vu ici. Vlist pour les classificateurs utilise numleafdocs pour commuter d'une icône représentant plusieurs documents (ce qui apparaîtra dans le rayon de livres) à l'onglet lui-même, si une seule image est présente.
description10=Greenstone inclus un fournisseur de donné de type OAI. Il fonctionne par le biais d'un programme CGI nommé "oaiserver.cgi" lequel se trouve dans le fichier cgi-bin de Greenstone. On peut y accéder au moyen de la même URL que la librairie de Greenstone (en remplacant "library.cgi" par "oaiserver.cgi"). Si vous utilisez le serveur local de librairie de windows, vous devez installer un serveur internet (tel qu'Apache) pour pouvoir utiliser ce serveur OAI.
description11=La configuration du serveur est réalisée au moyen du fichier oai.cfg se trouvant dans le dossier etc de Greenstone. Ce fichier spécifie des informations générales sur le dossier et fait la liste des collections à rendre accessibles aux clients OAI. Par défaut, les collections ne sont pas accéssibles. Afin de rendre une collection accessible, ajoutez son nom à la liste oaicollection. Les collections construites avec des version de Greenstone antérieures à la version 2.52 doivent être recompilée avant de pouvoir être utilisée par le serveur.
description12=A ce jour, le serveur OAI de Greenstone gère les jeux de métadonnées Dublin Core, Dublin Core qualifié, et rfc1807. La ligne oaimetadata définit les jeux de métadonnées à utiliser. Pour les collections utilisant d'autres jeux de métadonnées, des règles de correspondance des métadonnées peuvent être ajoutées pour faire correspondre les métadonnées existantes avec les jeux disponibles. Voir le fichier oai.cfg pour plus d'informations.