name=Dimostrazione OAI
Rights=Diritti
Caption=Didascalia
Publisher=Editore
original=originale
Subject=Oggetto
available=disponibile
sampleoid=01dle6
index_Description=didascalie delle foto
document=Documento

shortDescription=Questa collezione dimostra la capacità di Greenstone di scaricare metadati OAI e creare una collezione a partire da essi.
description1a=<p>Questa collezione dimostra la funzionalità <i>ImportFrom</i> di Greenstone. Utilizzando il <a href="http\://www.openarchives.org">Open Archive Protocol</a> (versione 1.1), recupera i metadati da <a href="http\://rocky.dlib.vt.edu/~jcdlpix">rocky.dlib.vt.edu/~jcdlpix</a>, una collezione di fotografie scattate in occasione della conferenza inaugurale <a href="http\://www.acm.org/jcdl/jcdl01/">Joint Conference on Digital Libraries</a>. 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=<h3>Come funziona la collezione</h3><p>Il file di configurazione della collezione, <tt>collectionConfig.xml</tt>, include una riga <i>acquire</i> che viene interpretata da un programma speciale chiamato <i>importfrom.pl</i>. 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 <i>-help</i>. Legge il file di configurazione della collezione, trova la riga acquire e la elabora. In questo caso, viene eseguito con il comando\: <pre> importfrom.pl oai-e </pre> (il nome della collezione è <i>oai-e</i>).</p>

description2=<p>La riga <i>acquire</i> nel file di configurazione specifica il protocollo OAI e fornisce l'URL di base di un repository OAI. Il programma <i>importfrom</i> scarica tutti i metadati presenti in quel repository nella directory <i>import</i> della collezione. L'argomento <i>getdoc</i> indica di scaricare anche i documenti sorgente della collezione, i cui URL sono indicati nel campo <i>Identifier</i> 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 <i>import</i> insieme ai documenti stessi, e il nome del file del documento è lo stesso del nome del file nell'URL. Il campo <i>Identifier</i> viene sovrascritto per fornire il nome del file locale, e il suo valore originale viene conservato in un nuovo campo chiamato <i>OrigURL</i>.</p>

description3=<p>Il file <tt>etc/oai.txt</tt> della collezione <i>oai-e</i> è un esempio di file di metadati scaricato.

description4=<p>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 <i>input_encoding</i> perché i dati in questo archivio contengono caratteri estesi. Ha anche un argomento <i>default_language</i>. 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 <i>language</i>. 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 <i>ImagePlugin</i>. Questo plugin specifica la risoluzione per le versioni schermo delle immagini.

description5=<p>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=<p>Il file di configurazione della collezione, <tt>collectionConfig.xml</tt>, specifica un unico indice full-text contenente i metadati <i>dc.Description</i> e sovrascrive i modelli di formato personalizzati <i>gsf</i> di Greenstone <tt>DocumentHeading</tt> e <tt>DocumentContent</tt> (XSL). Quando viene visualizzato un documento, l'istruzione di formato <i>DocumentHeading</i> ne mostra il <i>dc.Subject</i>. Segue poi l'istruzione <i>DocumentContent</i> con <i>screenicon</i>, generata da <i>ImagePlugin</i> e che fornisce una versione dell'immagine adatta alla risoluzione dello schermo; può essere collegata tramite hyperlink ai metadati <i>dc.OrigURL</i>, 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 <i>dc.Description</i> dell'immagine, anch'essa con un collegamento ipertestuale; la dimensione e il tipo dell'immagine, generati nuovamente come metadati da <i>ImagePlugin</i>; e infine <i>dc.Subject</i>, <i>dc.Publisher</i> e <i>dc.Rights</i>. <a href="library/collection/oai-e/document/01dle6">Questo</a> è il risultato.

description7=<p>Esistono due classificatori di navigazione, uno basato sui metadati <i>dc.Subject</i> e l'altro sui metadati <i>dc.Description</i> (ma con un pulsante denominato “didascalie”). Ricordiamo che il classificatore <i>AZCompactList</i> è simile a <i>AZList</i> ma genera una libreria per gli elementi duplicati. In questa collezione ci sono molte immagini ma solo pochi valori diversi per i metadati <i>dc.Subject</i>.</p>

description8=È un po' sorprendente che <i>AZCompactList</i> sia utilizzato (anziché <i>AZList</i>) anche per l'indice <i>dc.Description</i>, poiché i metadati <i>dc.Description</i> 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 <i>AZList</i> 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 (<i>mincompact</i>, <i>maxcompact</i>, <i>mingroup</i>, <i>minnesting</i>) per controllare la visualizzazione, ad esempio i gruppi (rappresentati da scaffali) non vengono formati a meno che non contengano almeno 5 (<i>mingroup</i>) elementi. Per scoprire il significato degli altri argomenti di questo classificatore, eseguire il comando <i>classinfo.pl AZCompactList</i>. I programmi <i>classinfo.pl</i> (per i classificatori) e <i>pluginfo.pl</i> (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.</p>

description9=<p>La specifica del formato <i>VList</i> mostra la miniatura dell'immagine, collegata tramite hyperlink al documento associato, seguita dai metadati <i>dc.Description</i>; il risultato può essere visualizzato <a href="library/collection/oai-e/browse/CL2">qui</a>. Le <i>Vlist</i> per i classificatori utilizzano <i>numleafdocs</i> per passare da un'icona che rappresenta diversi documenti (che apparirà come una libreria) alla miniatura stessa, se è presente una sola immagine.

description10=<h3>Il server OAI Greenstone</h3><p>Greenstone è dotato di un provider di dati OAI integrato. Questo funziona come un programma CGI chiamato “oaiserver.cgi” ed è installato nella directory <i>cgi-bin</i> 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=<p>La configurazione del server viene effettuata tramite il file <i>oai.cfg</i> nella directory Greenstone <i>etc</i>. 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 <i>oaicollection</i>.</p>

description12=<p>Il server OAI di Greenstone attualmente supporta i set di metadati Dublin Core, Dublin Core qualificato e rfc1807. La riga <i>oaimetadata</i> 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 <i>oai.cfg</i>.</p>
