Questa collezione dimostra la funzionalità ImportFrom di Greenstone. Utilizzando il Open Archive Protocol (versione 1.1), recupera i metadati da rocky.dlib.vt.edu/~jcdlpix, una collezione di fotografie scattate in occasione della conferenza inaugurale Joint Conference on Digital Libraries. Una collezione Greenstone è costruita dai record esportati da questo fornitore di dati OAI. L'implementazione è sufficientemente flessibile da poter gestire le piccole differenze sintattiche tra OAI 1.1 e OAI 2.0. description1=
Il file di configurazione della collezione, collectionConfig.xml, include una riga acquire che viene interpretata da un programma speciale chiamato importfrom.pl. Come altri programmi Greenstone, questo prende come argomento il nome della collezione e fornisce un riepilogo degli altri argomenti quando viene richiamato con l'argomento -help. Legge il file di configurazione della collezione, trova la riga acquire e la elabora. In questo caso, viene eseguito con il comando\:
importfrom.pl oai-e(il nome della collezione è oai-e). description2=
La riga acquire nel file di configurazione specifica il protocollo OAI e fornisce l'URL di base di un repository OAI. Il programma importfrom scarica tutti i metadati presenti in quel repository nella directory import della collezione. L'argomento getdoc indica di scaricare anche i documenti sorgente della collezione, i cui URL sono indicati nel campo Identifier del Dublin Core di ciascun documento (si tratta di una convenzione comune). I file di metadati, ciascuno contenente un record XML per un documento sorgente, vengono inseriti nella struttura di file import insieme ai documenti stessi, e il nome del file del documento è lo stesso del nome del file nell'URL. Il campo Identifier viene sovrascritto per fornire il nome del file locale, e il suo valore originale viene conservato in un nuovo campo chiamato OrigURL.
description3=Il file etc/oai.txt della collezione oai-e è un esempio di file di metadati scaricato. description4=
Una volta importate le informazioni OAI, la collezione viene elaborata nel modo consueto. Oltre ai quattro plugin standard (GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin e DirectoryPlugin), il file di configurazione specifica il plugin OAI, che elabora i metadati OAI, e il plugin immagine, poiché in questo caso i documenti sorgente della collezione sono file immagine. Il plugin OAI è stato fornito con un argomento input_encoding perché i dati in questo archivio contengono caratteri estesi. Ha anche un argomento default_language. Greenstone normalmente determina automaticamente la lingua dei documenti, ma questi record di metadati sono troppo piccoli per poterlo fare in modo affidabile, quindi l'inglese è specificato esplicitamente nell'argomento language. Il plugin OAI analizza i metadati e li passa al file del documento sorgente appropriato, che viene poi elaborato da un plugin appropriato, in questo caso ImagePlugin. Questo plugin specifica la risoluzione per le versioni schermo delle immagini. description5=
I metadati estratti dai record OAI vengono mappati per impostazione predefinita al Dublin Core Metadata Set. Di conseguenza, i classificatori e gli indici di questa collezione sono costruiti con elementi di metadati Dublin Core. description6=
Il file di configurazione della collezione, collectionConfig.xml, specifica un unico indice full-text contenente i metadati dc.Description e sovrascrive i modelli di formato personalizzati gsf di Greenstone DocumentHeading e DocumentContent (XSL). Quando viene visualizzato un documento, l'istruzione di formato DocumentHeading ne mostra il dc.Subject. Segue poi l'istruzione DocumentContent con screenicon, generata da ImagePlugin e che fornisce una versione dell'immagine adatta alla risoluzione dello schermo; può essere collegata tramite hyperlink ai metadati dc.OrigURL, ovvero alla versione originale dell'immagine sul sito OAI remoto. Poiché questa non è più disponibile sul web, ora è collegata tramite collegamento ipertestuale alla versione completa del file immagine. Segue la dc.Description dell'immagine, anch'essa con un collegamento ipertestuale; la dimensione e il tipo dell'immagine, generati nuovamente come metadati da ImagePlugin; e infine dc.Subject, dc.Publisher e dc.Rights. Questo è il risultato. description7=
Esistono due classificatori di navigazione, uno basato sui metadati dc.Subject e l'altro sui metadati dc.Description (ma con un pulsante denominato “didascalie”). Ricordiamo che il classificatore AZCompactList è simile a AZList ma genera una libreria per gli elementi duplicati. In questa collezione ci sono molte immagini ma solo pochi valori diversi per i metadati dc.Subject.
description8=È un po' sorprendente che AZCompactList sia utilizzato (anziché AZList) anche per l'indice dc.Description, poiché i metadati dc.Description sono solitamente univoci per ciascuna immagine. Tuttavia, in questa collezione la stessa descrizione è stata occasionalmente assegnata a più immagini e alcune delle divisioni in un AZList conterrebbero un numero elevato di immagini, rallentando la trasmissione di quella pagina. Per evitare questo problema, viene utilizzata la versione compatta dell'elenco con alcuni argomenti (mincompact, maxcompact, mingroup, minnesting) per controllare la visualizzazione, ad esempio i gruppi (rappresentati da scaffali) non vengono formati a meno che non contengano almeno 5 (mingroup) elementi. Per scoprire il significato degli altri argomenti di questo classificatore, eseguire il comando classinfo.pl AZCompactList. I programmi classinfo.pl (per i classificatori) e pluginfo.pl (per i plugin) sono strumenti utili per conoscere le funzionalità dei moduli Greenstone. Si noti, per inciso, la barra rovesciata nel file di configurazione, utilizzata per indicare la continuazione della riga precedente. description9=La specifica del formato VList mostra la miniatura dell'immagine, collegata tramite hyperlink al documento associato, seguita dai metadati dc.Description; il risultato può essere visualizzato qui. Le Vlist per i classificatori utilizzano numleafdocs per passare da un'icona che rappresenta diversi documenti (che apparirà come una libreria) alla miniatura stessa, se è presente una sola immagine. description10=
Greenstone è dotato di un provider di dati OAI integrato. Questo funziona come un programma CGI chiamato “oaiserver.cgi” ed è installato nella directory cgi-bin di Greenstone. È possibile accedervi tramite lo stesso URL della libreria Greenstone (sostituendo “library.cgi” con “oaiserver.cgi”). Se si utilizza il server di libreria locale di Windows, è necessario installare un server web (come Apache) per eseguire il server OAI. description11=
La configurazione del server viene effettuata tramite il file oai.cfg nella directory Greenstone etc. Questo file specifica le informazioni generali sul repository ed elenca le collezioni che devono essere rese accessibili ai client OAI. Per impostazione predefinita, le collezioni non sono accessibili. Per abilitare una collezione, aggiungere il suo nome all'elenco oaicollection.
description12=Il server OAI di Greenstone attualmente supporta i set di metadati Dublin Core, Dublin Core qualificato e rfc1807. La riga oaimetadata specifica quali set devono essere utilizzati. Per le collezioni che utilizzano altri set di metadati, è necessario fornire regole di mappatura dei metadati per mappare i metadati esistenti ai set in uso. Per ulteriori dettagli, consultare il file oai.cfg.