source: documented-example-collections/trunk/oai-e/etc/collect.cfg@ 19060

creator     [email protected]
public      true


acquire OAI -src rocky.dlib.vt.edu/~jcdlpix/cgi-bin/OAI1.1/jcdlpix.pl -getdoc

indexes     document:Description

plugin      OAIPlugin -input_encoding iso_8859_1 -default_language en
plugin      ImagePlugin -screenviewsize 300
plugin      GreenstoneXMLPlugin
plugin      MetadataXMLPlugin
plugin      ArchivesInfPlugin
plugin      DirectoryPlugin

classify    AZCompactList -metadata Subject -doclevel top 
classify    AZCompactList -mincompact 5 -maxcompact 10 -metadata Description -mingroup 10 -buttonname Captions -minnesting 7 

format VList "<td>[link][thumbicon][/link]</td>
<td valign=middle><i>[Description]</i></td>"

format CL1VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[Description]</i>}</td>"

format CL2VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[Description]</i>}</td>"

format DocumentHeading "<h3>[Subject]</h3>"

format DocumentText "<center><table width=_pagewidth_ border=1>
<tr><td colspan=2 align=center>
<a href=[OrigURL]>[screenicon]</a></td></tr>
<tr><td>_Caption_:</td><td> <i>[Description]</i> <br>
(<a href=[OrigURL]>_original_ [ImageWidth]x[ImageHeight] [ImageType] _available_</a>)
</td></tr>
<tr><td>_Subject_:</td><td> [Subject]</td></tr>
<tr><td>_Publisher_:</td><td> [Publisher]</td></tr>
<tr><td>_Rights_:<td> [Rights]</td></tr>
</table></center>"


# -- English strings ----------------
collectionmeta  collectionname [l=en] "OAI demo"

collectionmeta  .document:Description [l=en] "photo captions"

collectionmeta  Caption [l=en] "Caption"
collectionmeta  Subject [l=en] "Subject"
collectionmeta  Publisher [l=en] "Publisher"
collectionmeta  Rights [l=en] "Rights"
collectionmeta  original [l=en] "original"
collectionmeta  available [l=en] "available"


# -- French strings ----------------
collectionmeta  collectionname [l=fr] "Démo OAI"

collectionmeta  .document:Description [l=fr] "Légendes de photos"

collectionmeta  Caption [l=fr] "Légende"
collectionmeta  Subject [l=fr] "Sujet"
collectionmeta  Publisher [l=fr] "Editeur"
collectionmeta  Rights [l=fr] "Droits"
collectionmeta  original [l=fr] "original"
collectionmeta  available [l=fr] "disponible"


# -- Spanish strings ----------------
collectionmeta  collectionname [l=es] "Colección de muestra OAI"

collectionmeta  .document:Description [l=es] "Pies de foto"

collectionmeta  Caption [l=es] "Título de la ilustración"
collectionmeta  Subject [l=es] "Asunto"
collectionmeta  Publisher [l=es] "Editorial"
collectionmeta  Rights [l=es] "Derecho de autor"
collectionmeta  original [l=es] "original"
collectionmeta  available [l=es] "disponible"


# -- Russian strings ----------------
collectionmeta  collectionname [l=ru] "ДеЌПМстрацО-ПММая кПллекцОя OAI"

collectionmeta  .document:Description [l=ru] "ЗагПлПвкО фПтПграфОй"

collectionmeta  Caption [l=ru] "ЗагПлПвПк (НаЎпОсь)"
collectionmeta  Subject [l=ru] "ПреЎЌет"
collectionmeta  Publisher [l=ru] "ИзЎатель"
collectionmeta  Rights [l=ru] "Права"
collectionmeta  original [l=ru] "ОрОгОМал"
collectionmeta  available [l=ru] "ДПступМый"


# -- English text ----------------
collectionmeta  collectionextra [l=en] "This collection demonstrates Greenstone\'s
<i>ImportFrom</i> feature. Using the <a href=http://www.openarchives.org>Open
Archive Protocol</a> (version 1.1), it retrieves metadata from
<a href=http://rocky.dlib.vt.edu/~jcdlpix>rocky.dlib.vt.edu/~jcdlpix</a>,
a collection of photographs taken at the inaugural
<a href=http://www.acm.org/jcdl/jcdl01/>Joint Conference on Digital
Libraries</a>. A Greenstone collection is built from the records exported
from this OAI data provider. The implementation is flexible enough to
cope with the minor syntax differences between OAI 1.1 and OAI 2.0.\n

<h3>How the collection works</h3>\n

<p>
The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
configuration file</a> includes an <i>acquire</i> line that is
interpreted by a special program called <i>importfrom.pl</i>. Like other
Greenstone programs, this takes as argument the name of the collection, and
provides a summary of other arguments when invoked with argument <i>-help</i>.
It reads the collection configuration file, finds the acquire line, and
processes it. In this case, it is run with the command:\n
<pre>
importfrom.pl oai-e
</pre>\n

<p>
(the collection\'s name is <i>oai-e</i>).
The <i>acquire</i> line in the configuration file specifies the OAI protocol
and gives the base URL of an OAI repository. The <i>importfrom</i> program
downloads all the metadata in that repository into the collection\'s
<i>import</i> directory. The <i>getdoc</i> argument instructs it to also
download the collection\'s source documents, whose URLs are given in each
document\'s Dublin Core <i>Identifier</i> field (this is a common
convention). The metadata files, which each contain an XML record for one
source document, are placed in the <i>import</i> file structure along with the
documents themselves, and the document filename is the same as the filename in
the URL. The <i>Identifier</i> field is overridden to give the local filename,
and its original value is retained in a new field called <i>OrigURL</i>.\n

<p>
<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Here</a>
is an example of a downloaded metadata file.\n

<p>
Once the OAI information has been imported, the collection is processed in the
usual way. The configuration file specifies the OAI plugin, which processes OAI
metadata, and the image plugin, because in this case the collection\'s source
documents are image files. The OAI plugin has been supplied with an
<i>input_encoding</i> argument because data in this archive contains extended
characters. It also has a <i>default_language</i> argument. Greenstone normally
determines the language of documents automatically, but these metadata records
are too small for this to be done reliably: hence English is specified
explicitly in the <i>language</i> argument. The OAI plugin parses the metadata
and passes it to the appropriate source document file, which is then processed
by an appropriate plugin -- in this case <i>ImagePlug</i>. This plugin specifies
the resolution for the screen versions of the images.\n

<p>
The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
configuration file</a> has a single full-text index containing
<i>Description</i> metadata. When a document is displayed, the
<i>DocumentHeading</i> format statement puts out its <i>Subject</i>. Then the
<i>DocumentText</i> statement follows this with <i>screenicon</i>, which is
produced by <i>ImagePlug</i> and gives a screen-resolution version of the
image; it is hyperlinked to the <i>OrigURL</i> metadata -- that is, the original
version of the image on the remote OAI site. This is followed by the image\'s
<i>Description</i>, also with a hyperlink; the image\'s size and type, again
generated as metadata by <i>ImagePlug</i>; and then <i>Subject</i>,
<i>Publisher</i>,
and <i>Rights</i> metadata.
<a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=HASH01fcd4cc18fa29bc78c06c6a>This</a>
is the result.\n

<p>
There are two browsing classifiers, one based on <i>Subject</i> metadata and
the other on <i>Description</i> metadata (but with a button named
\"captions\"). Recall that the <i>AZCompactList</i> classifier is like
<i>AZList</i> but generates a bookshelf for duplicate items. In this
collection there are a lot of images but only a few different values for
<i>Subject</i> metadata.\n

<p>
It\'s a little surprising that <i>AZCompactList</i> is used (instead of
<i>AZList</i>) for the <i>Description</i> index too, because <i>Description</i>
metadata is usually unique for each image. However, in this collection the same
description has occasionally been given to several images, and some of the
divisions in an <i>AZList</i> would contain a large number of images, slowing
down transmission of that page. To avoid this, the compact version of the list
is used with some arguments (<i>mincompact</i>, <i>maxcompact</i>,
<i>mingroup</i>, <i>minnesting</i>) to control the display -- e.g. groups (represented by
bookshelves) are not formed unless they have at least 5 (<i>mingroup</i>)
items. To find out the meaning of the other arguments for this classifier,
execute the command <i>classinfo.pl AZCompactList</i>. The programs
<i>classinfo.pl</i> (for classifiers) and <i>pluginfo.pl</i> (for plugins) are
useful tools for learning about the capabilities of Greenstone modules. Note
incidentally the backslash in the configuration file, used to indicate a
continuation of the previous line.\n

<p>
The <i>VList</i> format specification shows the image thumbnail, hyperlinked to
the associated document, followed by <i>Description</i> metadata; the result
can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">here</a>. The <i>Vlists</i>
for the classifiers use <i>numleafdocs</i> to switch between an icon
representing several documents (which will appear as a bookshelf) and the
thumbnail itself, if there is only one image.\n

<h3>The Greenstone OAI server</h3>\n

<p>
From version 2.52, Greenstone comes with a built-in OAI data provider. 
This runs as a CGI program called \"oaiserver\", and is installed 
in the Greenstone <i>cgi-bin</i> directory. It can be accessed via the same 
URL as the Greenstone library (replacing \"library\" with \"oaiserver\"). If you 
are using the Windows local library server, you must install a 
web server (such as Apache) to run the OAI server.\n

<p>
Configuration of the server is done via the <i>oai.cfg</i> file in the 
Greenstone <i>etc</i> directory. This file specifies general information 
about the repository, and lists collections to be made accessible to OAI 
clients. By default, collections are not accessible. To enable a 
collection, add its name to the <i>oaicollection</i> list. Collections built 
with versions of Greenstone earlier than 2.52 must be rebuilt before 
they can be served.\n

<p>
Greenstone's OAI server only supports Dublin Core 
metadata at present. For collections that use other metadata sets, 
metadata mapping rules should be provided to map the existing metadata 
to Dublin Core. See the <i>oai.cfg</i> file for details.\n
"


# -- French text ----------------
collectionmeta  collectionextra [l=fr] "
Cette collection montre la fonctionnalité <i>ImportFrom</i> de Greenstone. Par le biais de <a href=http://www.openarchives.org>Open Archive Protocol</a> (version 1.1), elle récupÚre des méta-données de <a href=\"http://rocky.dlib.vt.edu/~jcdlpix\">rocky.dlib.vt.edu/~jcdlpix</a>, une collection de photos prise lors de la cérémonie inaugurale de <a href=\"http://www.acm.org/jcdl/jcdl01/\">Joint Conference on Digital Libraries</a>. 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.

<h3>Comment fonctionne cette collection ?</h3>

<p>
Le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration de la collection</a> comprend une ligne <i>acquire</i> (acquérir) qui est interprétée par un programme spécial appelé <i>importfrom.pl</i>. 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 <i>-help</i>. Il lit le fichier de configuration de la collection, trouve la ligne <i>acquire</i> et en fait le traitement. Dans ce cas, il démarre avec la commande: 

<pre>
importfrom.pl oai-e
</pre>

<p>
(le nom de la collection est <i>oai-e</i>). La ligne <i>acquire</i> dans le fichier de configuration spécifie le protocole OAI et donne l'URL de base d'un répertoire OAI. Le programme <i>importfrom</i> télécharge toutes les méta-données de ce entrepÎt dans le dossier <i>import</i> de la collection. L'argument <i>getdoc</i>  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 <i>Identifier</i> (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 <i>import</i> 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 <i>Identifier</i> est écrasé pour donner le nom de fichier local et sa valeur originale est retenue dans le nouveau champ appelé <i>OrigURL</i>. 

<p>
<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Voici</a> un exemple de fichier de méta-données téléchargé.

<p>
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. Le plugin OAI  a été fourni avec un argument <i>input_encoding</i> parce que les données dans cette archive contiennent des caractÚres étendus. Il a aussi un argument <i>default_language</i>. 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 <i>language</i>. 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 <i>ImagePlug</i>. Ce plugin spécifie la résolution pour les versions écran des images. 

<p>
Le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration de la collection</a> a un index \"full-text\" unique contenant la méta-donnée <i>Description</i>. Quand un document est affiché, la déclaration de format <i>DocumentHeading</i> révÚle son <i>Subject</i> (Sujet). Elle est ensuite suivie de la déclaration <i>DocumentText</i> avec <i>screenicon</i> produit par <i>ImagePlug</i> et qui donne une version résolution d'écran de l'image; elle est liée à la méta-donnée <i>OrigURL</i>, c'est à dire la version originale de 
l'image sur le site OAI distant. Elle est suivie par <i>Description</i> 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 <i>ImagePlug</i>; et enfin les méta-données <i>Subject</i>, <i>Publisher</i> et <i>Rights</i>. <a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=HASH01fcd4cc18fa29bc78c06c6a>Voici</a> le résultat. 

<p>
Il y a deux classificateurs de navigation, l'un basé sur la méta-donnée <i>Subject</i> et l'autre sur la méta-donnée <i>Description</i> (mais avec un bouton dénommé \"légends\"). On rappelle que le classificateur <i>AZCompactList</i> est identique à <i>AZList</i> 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 <i>Subject</i>. 

<p>
C'est un peu surprenant que <i>AZCompactList</i> soit utilisé (au lieu de <i>AZList</i>) pour l'index <i>Description</i> aussi, car la méta-donnée <i>Description</i> 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 <i>AZList</i> 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 (<i>mincompact</i>, <i>maxcompact</i>, <i>mingroup</i>, <i>minnesting</i>) 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 (<i>mingroup</i>). Pour trouver la signification des autres arguments pour ce classificateur, il faut exécuter la commande <i>classinfo.pl AZCompactList</i>. Les programmes <i>classinfo.pl</i> (pour classificateurs) et <i>pluginfo.pl</i> (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. 

<p>
La spécification du format <i>Vlist</i> montre l'onglet de l'image, lié (hyperlien) au document associé, suivi de la méta-donnée <i>Description</i>; le résultat peut être vu <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">ici</a>. <i>Vlist</i> pour les classificateurs utilise <i>numleafdocs</i> 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.

<h3>Le serveur OAI de Greenstone</h3>

<p>
Depuis la version 2.52, Greenstone inclus un fournisseur de donné de type OAI.
Il fonctionne par le biais d'un programme CGI nommé \"oaiserver\" lequel se trouve dans le fichier <i>cgi-bin</i> de Greenstone. On peut y accéder au moyen de la même URL que la librairie de Greenstone (en remplacant \"library\" par \"oaiserver\"). 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.

<p>
La configuration du serveur est réalisée au moyen du fichier <i>oai.cfg</i> se trouvant dans le dossier <i>etc</i> 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 <i>oaicollection</i>.
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.

<p>
La serveur OAI de Greenstone ne peut, pour l'instant, utiliser que des métadonnées du jeu Dublin Core. Pour des collections utilisant d'autres types de métadonnées, des rÚgles d'expolitation doivent être fournies afin de les rendres compatibles aux standard Dublin core. Voyez le fichier <i>oai.cfg</i> pour plus de détails.
"


# -- Spanish text ----------------
collectionmeta  collectionextra [l=es] "
Esta colección demuestra la función <i>ImportFrom</i> de Greenstone. Por medio del <a href=http://www.openarchives.org>Protocolo de Archivo Abierto</a> (versión 1.1) recupera metadatos de <a href=http://rocky.dlib.vt.edu/~jcdlpix>rocky.dlib.vt.edu/~jcdlpix</a>, una colección de fotografías tomadas durante la <a href=http://www.acm.org/jcdl/jcdl01/>Conferencia inaugural conjunta de Bibliotecas Digitales</a>. 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.
<p>

<h3>Cómo trabaja esta colección</h3>


El <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración de la colección</a> incluye una línea <i>acquire</i> (adquirir) que es interpretada por un programa especial llamado <i>importfrom.pl</i>. 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 <i>-help</i>. El programa lee el archivo de configuración de la colección, busca la línea <i>acquire</i> y la procesa. En este caso, se ejecuta por medio del siguiente comando:
<p>

<pre>
importfrom.pl oai-e
</pre>\n
<p>

(donde el nombre de la colección es oai-e). La línea <i>acquire</i> en el archivo de configuración especifica el protocolo OAI y proporciona el URL base de un repositorio OAI. El programa <i>importfrom</i> baja todos los metadatos del repositorio en el directorio <i>importar</i> de la colección. El argumento <i>getdoc</i> lo instruye también para que baje los documentos fuente de la colección, cuyos URLs están dados en el campo <i>Identificador</i> 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 <i>importar</i> junto con los documentos mismos y el nombre de archivo del documento es igual al nombre de archivo en el URL. El campo <i>Identificador</i> se sustituye por el nombre de archivo local y su valor original es conservado en un nuevo campo llamado <i>OrigURL</i>.
<p>

He <a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>aquí</a> un ejemplo de un archivo de metadatos bajados del repositorio.
<p>

Una vez que la información OAI se ha importado, la colección se procesa de forma normal. El archivo de configuración especifica el plugin OAI, el cual procesa los metadatos OAI y el plugin de imágenes, ya que en este caso los documentos fuente de la colección son archivos de imágenes. El plugin OAI ha sido suministrado con un argumento <i>input_encoding</i>, debido a que los datos en este archivo contienen caracteres extendidos. También tiene un argumento <i>default_language</i>. 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 de <i>idioma</i>. El plugin OAI descompone y analiza los metadatos y los pasa al correspondiente archivo de documentos fuente, el cual es procesado a continuación por un plugin apropiado, que en este caso es <i>ImagePlug</i>. Este plugin especifica la resolución de las imágenes en pantalla. 
<p>

El <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración de la colección</a> tiene un solo índice de texto completo, el cual contiene el metadato <i>Descripción</i>. Cuando un documento se despliega en pantalla el enunciado de formato <i>DocumentHeading</i> muestra su <i>Asunto</i>. A continuación le sigue el enunciado <i>DocumentText</i> con <i>screenicon</i>, el cual es producido por <i>ImagePlug</i> y proporciona una versión en pantalla de la imagen. Ésta cuenta con un hipervínculo al metadato <i>OrigURL</i>, es decir, a la versión original de la imagen en el sitio OAI remoto. Le sigue la <i>Descripción</i> de la imagen, también con un hipervínculo, el tamaño y tipo de la imagen, nuevamente generados como metadatos por <i>ImagePlug</i>, y finalmente los metadatos de <i>Asunto</i>, <i>Editorial</i> y <i>Derechos de Autor</i>. <a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=HASH01fcd4cc18fa29bc78c06c6a>Éste</a> es el resultado.
<p>

Existen dos clasificadores de exploración, uno basado en el metadato <i>Asunto</i> y el otro en el metadato <i>Descripción</i> (pero con un botón llamado \"pies de foto\"). Recuerde que el clasificador <i>AZCompactList</i> es como <i>AZList</i>, 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 <i>Asunto</i>. 
<p>

Resulta un tanto sorprendente que el clasificador <i>AZCompactList</i> también se utilice (en vez de <i>AZList</i>) para el índice de <i>Descripción</i>, ya que por lo general el metadato <i>Descripción</i> 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 <i>AZList</i> 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 (<i>mincompact, maxcompact, mingroup, minnesting</i>)  para controlar la presentación en pantalla. Por ejemplo, los grupos (representados por estantes) no se forman a menos que tengan al menos 5 (<i>mingroup</i>) ítems. A fin de conocer el significado de los otros argumentos para este clasificador ejecute el comando <i>classinfo.pl AZCompactList</i>. Los programas <i>classinfo.pl</i> (para los clasificadores) y <i>pluginfo.pl</i> (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.
<p>

La especificación de formato VList muestra la reducción de cuadro de la imagen con hipervínculos al documento asociado, seguida por el metadato <i>Descripción</i>. El resultado se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">aquí</a>. Las <i>Vlists</i> para los clasificadores utilizan <i>numleafdocs</i> para cambiar entre un icono que representa varios documentos (el cual aparecerá como un estante) y la reducción de cuadro, si sólo hay una imagen. 

<h3>El servidor OAI de Greenstone</h3>

<p>
Desde la versión 2.52, Greenstone incorpora un servidor/proveedor de datos OAI.
Se ejecuta mediante un programa CGI llamado \"oaiserver\", y se encuentra
en el directorio <i>cgi-bin</i> de Greenstone. Se accede a él utilizando el mismo 
URL que para la biblioteca Greentone (reemplazando \"library\" por \"oaiserver\").
Si usted está usando el servidor de biblioteca local, debe instalar un servidor 
web (como Apache) para poder ejecutar el servidor OAI.\n

<p>
La configuración del servidor se hace mediante el fichero <i>oai.cfg</i> que se
encuentra en el directorio <i>etc</i> 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 <i>oaicollection</i>. Las colecciones
construidas con versiones de Greenstone anteriores a la 2.52 deben ser reconstruidas 
antes de que puedan ser accesibles.\n

<p>
El servidor OAI de Greenstone sólo soporta metadatos Dublin Core por el momento.
Para colecciones que usen otros conjuntos de metadatos, se deben establecer reglas
de equivalencias de metadatos entre esos conjuntos y Dublin Core.
Consulte el fichero <i>oai.cfg</i> para mayor información.\n
"


# -- Russian text ----------------
collectionmeta  collectionextra [l=ru] "
Эта кПллекцОя ЎеЌПМстрОрует ПсПбеММПстО  <i>ImportFrom</i> Greenstone, ОспПльзуя <a href=http://www.openarchives.org>Открытый Арх
ОвМый ПрПтПкПл</a> OAI (версОя 1.1). ОМа вПсстаМавлОвает ЌетаЎаММые Оз <a href=http://rocky.dlib.vt.edu/~jcdlpix>rocky.dlib.vt.edu/~jcdlpix</a>, кПллекцОю фПтПграфОй, пПлучеММых
 прО ОМаугурацОО <a href=http://www.acm.org/jcdl/jcdl01/>ОбъеЎОМеММПй КПМфереМцОО пП ЊОфрПвыЌ БОблОПтекаЌ</a>. КПллекцОя  Greenstone пПстрПеМа пП запОсяЌ, экспПртОрПваММыЌ Оз этПгП OAI пПставщОка ЎаММых
. ИМструЌеМт является ЎПстатПчМП гОбкОЌ, чтПбы справОться с МезМачОтельМыЌО сОМтаксОческОЌО разлОчОяЌО ЌежЎу версОяЌО OAI 1.1 О OAI 2.0.
<p>

<h3>Как рабПтает кПллекцОя</h3>

<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл</a> кПллекцОО включает стрПку <i>ОЌпПрт</i> (<i>acquire</i>), кПтПрая ОМтерпретОруется спецОальМПй прПграЌЌПй, МазываеЌПй <i>importfrom.pl</i>. ППЎПбМП ЎругОЌ прПграЌЌаЌ Greenstone, ПМа берет в качестве параЌетра МазваМОе (ОЌя) кПллекцОО О ОспПльзует резюЌе ЎругОх
 параЌетрПв, кПгЎа запускается параЌетр <i>пПЌПщь</i> (<i>help</i>). ОМа счОтывает кПМфОгурацОПММый файл кПллекцОО, Мах
ПЎОт стрПку ОЌпПрта О Пбрабатывает её. В этПЌ случае ПМа запускается кПЌаМЎПй:
<p>
<pre>
importfrom.pl oai-e
</pre>\n
гЎе oai-e - ОЌя кПллекцОО.
<p>


СтрПка <i>acquire</i> в кПМфОгурацОПММПЌ файле заЎает прПтПкПл OAI О выЎает базПвый аЎрес URL х
раМОлОща OAI. ПрПграЌЌа <i>importfrom</i> выгружает все ЌетаЎаММые этПгП х
раМОлОща в ЎОректПрОю кПллекцОО <i>import</i>. ПараЌетр <i>getdoc</i> Ўаёт кПЌаМЎу выгружать ЎПкуЌеМты Оз Осх
ПЎМПй кПллекцОО, чьО URL прОвПЎятся в кажЎПЌ пПле ЎПкуЌеМта ОЎеМтОфОкатПра <i>Dublin Core</i> (этП -- Пбщее сПглашеМОе). Ѐайлы ЌетаЎаММых
, кажЎый Оз кПтПрых
 сПЎержОт XML-запОсь ПЎМПгП Осх
ПЎМПгП ЎПкуЌеМта, пПЌещеМы в структуру файла <i>import</i> МаряЎу с саЌОЌО ЎПкуЌеМтаЌО, О ОЌя файла ЎПкуЌеМта такПе же, чтП О файла в URL. ППле <i>Identifier</i> переПпреЎелеМП, чтПбы Ўать лПкальМПе ОЌя файлу, а егП первПМачальМПе зМачеМОе сПх
раМяется в МПвПЌ пПле пП ОЌеМО <i>OrigURL</i>.
<p>

<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>ЗЎесь</a> пПказаМ прОЌер разгрузкО файла ЌетаЎаММых
.
<p>

Как тПлькП ОМфПрЌацОя Оз ОAI ОЌпПртОрПваМа, кПллекцОя Пбрабатывается ПбычМыЌ спПсПбПЌ. КПМфОгурацОПММый файл ПпреЎеляет плагОМ OAI, кПтПрый Пбрабатывает ЌетаЎаММые OAI, О плагОМ ОзПбражеМОй, пПскПльку в этПЌ случае ЎПкуЌеМты Осх
ПЎМПй кПллекцОО  - этП файлы ОзПбражеМОй. ПлагОМ OAI сПЎержОт параЌетр <i>input_encoding</i>, пПтПЌу чтП ЎаММые в этПЌ арх
Ове ОЌеют сОЌвПлы расшОреМОя. ОМ также ОЌеет параЌетр языка пП уЌПлчаМОю <i>default_language</i>. Greenstone ПбычМП ПпреЎеляет язык ЎПкуЌеМтПв автПЌатОческО, МП этО запОсО ЌетаЎаММых
 являются слОшкПЌ МебПльшОЌО Ўля тПгП, чтПбы этП сЎелать МаЎежМП: пПэтПЌу аМглОйскОй язык ПпреЎелеМ явМП в параЌетре <i>языка</i> (<i>language</i>). ПлагОМы ОAI аМалОзОруют  ЌетаЎаММые О пересылают Ох
 к сППтветствующеЌу файлу Осх
ПЎМПгП ЎПкуЌеМта, кПтПрый затеЌ Пбрабатывается сППтветствующОЌ плагОМПЌ -- в ЎаММПЌ случае <i>ImagePlug</i>. ЭтПт плагОМ ПпреЎеляет разлОчМые версОО разрешеМОя ОзПбражеМОя Ма экраМе.
<p>

<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл кПллекцОО</a> ОЌеет еЎОМствеММый пПлМПтекстПвый ОМЎекс, сПЎержащОй ЌетаЎаММые <i>ОпОсаМОя</i> (<i>description</i>). КПгЎа ЎПкуЌеМт вывеЎеМ Ма экраМ, ПператПр фПрЌата <i>DocumentHeading</i> вывПЎОт <i>ПреЎЌет</i> (<i>subject</i>) ЎПкуЌеМта. ЗатеЌ слеЎует ПператПр <i>DocumentText</i> вЌесте с <i>screenicon</i>, кПтПрый сПзЎается с пПЌПщью <i>ImagePlug</i> О устаМавлОвает версОю МеПбх
ПЎОЌПгП  разрешеМОя Ма экраМе ОзПбражеМОя. ОМП гОперсвязаМП с ЌетаЎаММыЌО <i>OrigURL</i>, тП есть ПрОгОМальМыЌ ОзПбражеМОеЌ Ма уЎалеММПЌ сайте ОAI. ОМП сПпрПвПжЎается <i>ОпОсаМОеЌ</i> (<i>description</i>) ОзПбражеМОя также с гОперсвязью; разЌеры О тОп ОзПбражеМОя сМПва геМерОруются, как ЌетаЎаММые <i>ImagePlug</i>, а затеЌ ЌетаЎаММыЌО <i>ПреЎЌета, ИзЎателя О Прав</i>. <a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=HASH01fcd4cc18fa29bc78c06c6a>ТП, чтП пПказаМП,</a> является кПМечМыЌ результатПЌ.
<p>

ИЌеется Ўва классОфОкатПра прПсЌПтра, ПЎОМ Оз кПтПрых
 ПсМПваМ Ма ЌетаЎаММых
 <i>ПреЎЌета</i>, а ЎругПй -- Ма ЌетаЎаММых
 <i>ОпОсаМОя</i>, МП с ОкПМкПй, МазваММПй «ЗагПлПвкО». ВспПЌМОте, чтП классОфОкатПр <i>AZCompactList</i> пПх
Пж Ма <i>AZList</i>, МП прПОзвПЎОт кМОжМую пПлку Ўля ЎублОкатПв элеЌеМтПв. В этПй кПллекцОО ОЌеется ЌМПгП ОзПбражеМОй, МП лОшь МескПлькП Оз МОх
 ОЌеют разлОчМые зМачеМОя Ўля ЌетаЎаММых
 <i>ПреЎЌета</i>.
<p>

МПжМП уЎОвляться, чтП <i>AZCompactList</i> ОспПльзуется вЌестП  <i>AZList</i> также Ўля ОМЎекса <i>ОпОсаМОя</i> (<i>description</i>), пПтПЌу чтП ЌетаЎаММые <i>ОпОсаМОя</i> ПбычМП уМОкальМы Ўля кажЎПгП ОзПбражеМОя. ОЎМакП в ЎаММПй кПллекцОО ПЎМП О тП же ПпОсаМОе ОМПгЎа ЎавалПсь МескПлькОЌ ОзПбражеМОяЌ, О МекПтПрые Оз разЎелПв <i>AZList</i> сПЎержат бПльшПе чОслП ОзПбражеМОй, заЌеЎляя переЎачу этПй страМОцы. ЧтПбы Озбежать этПгП, ОспПльзуется кПЌпактМая версОя спОска с ряЎПЌ параЌетрПв (<i>mincompact, maxcompact, mingroup, minnesting</i>), чтПбы управлять пПказПЌ. Так, группы, преЎставлеММые кМОжМыЌО пПлкаЌО, Ме сфПрЌОруются ЎП тех
 пПр, пПка ПМО Ме буЎут ОЌеть пП крайМей Ќере 5 элеЌеМтПв (<i>mingroup</i>). ЧтПбы узМать зМачеМОя ЎругОх
 параЌетрПв Ўля этПгП классОфОкатПра, выпПлМОте кПЌаМЎу <i>classinfo.pl AZCompactList</i>. ПрПграЌЌы <i>classinfo</i>.pl (Ўля классОфОкатПрПв) О <i>pluginfo.pl</i> (Ўля плагОМПв) являются пПлезМыЌО ОМструЌеМтаЌО, кПгЎа МаЎП узМать П вПзЌПжМПстях
 ЌПЎулей Greenstone. ОбратОте кстатО вМОЌаМОе Ма ПбратМый слеш в кПМфОгурацОПММПЌ файле, ОспПльзуеЌый Ўля указаМОя Ма прПЎПлжеМОе преЎыЎущей стрПкО.
<p>

ОпреЎелеМОе фПрЌата <i>VList</i> пПказывает уЌеМьшеММПе ОзПбражеМОе, ОЌеющее гОперсвязь с Осх
ПЎМыЌ ЎПкуЌеМтПЌ, в сППтветствОО с ЌетаЎаММыЌО <i>ОпОсаМОя</i>; результат чегП ЌПжМП вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">зЎесь</a>. <i>Vlists</i> Ўля классОфОкатПрПв ОспПльзует <i>numleafdocs</i> Ўля переключеМОя ЌежЎу ОкПМкаЌО, преЎставляющОЌО МескПлькП ЎПкуЌеМтПв (кПтПрый пПявОтся в вОЎе кМОжМПй пПлкО), О МепПсреЎствеММП уЌеМьшеММПе ОзПбражеМОе, еслО ПМП тПлькП ПЎМП.

<h3>Greenstone OAI сервер</h3>

<p>
Пт версОО 2.52, Greenstone ПтлОчается встрПеММыЌ OAI пПставщОкПЌ ЎаММых
. ЭтП запускается как CGI прПграЌЌа, МазываеЌая \"oaiserver\", О устаМПвлеМа в <i>cgi-bin</i> ЎОректПрОО Greenstone. К этПЌу ЌПжМП ПбратОться через тП же саЌый URL как бОблОПтека Greenstone (заЌеМяющОй \"library\" с \"oaiserver\"). ЕслО Вы ОспПльзуете Windows лПкальМый сервер бОблОПтекО, Вы ЎПлжМы устаМПвОть web сервер (такПй как Apache), чтПбы управлять OAI серверПЌ.

<p>
КПМфОгурацОя сервера сЎелаМа через <i>oai.cfg</i> файл в ЎОректПрОО Greenstone. ЭтПт файл ПпреЎеляет главМую ОМфПрЌацОю П сОстеЌе х
раМеМОя, О спОсках
 кПллекцОй, кПтПрые буЎут ЎПступМы Ўля OAI клОеМтПв. ПП уЌПлчаМОю, кПллекцОО Ме ЎПступМы. ЧтПбы включОть кПлекцОю, ЎПбавьте этП МазваМОе(ОЌя) к спОску <i>oaicollection</i>. КПллекцОО пПстрПеММые с версОяЌО Greenstone раМее чеЌ 2.52 ЎПлжМы быть перестрПеМы прежЎе ПМО ЌПгут ПбслужОваться.

<p>
OAI сервер Greenstone в МастПящее вреЌя пПЎЎержОвает тПлькП Dublin Core ЌетаЎаММые. Для кПллекцОй, кПтПрые ОспПльзуют ЎругОе МабПры ЌетаЎаММых
, ЌетаЎаММые ЎПлжМы быть преПбразПваМы в фПрЌат ЌетаЎаММых
, кПтПрые ОспПльзуются Ўля Dublin Core. ППЎрПбМее сЌПтрО файл <i>oai.cfg</i>.
"