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

Revision 19060, 37.9 KB (checked in by oranfry, 11 years ago)

using new plugin names to get the example collections to build

  • Property svn:executable set to *
2public      true
5acquire OAI -src -getdoc
7indexes     document:Description
9plugin      OAIPlugin -input_encoding iso_8859_1 -default_language en
10plugin      ImagePlugin -screenviewsize 300
11plugin      GreenstoneXMLPlugin
12plugin      MetadataXMLPlugin
13plugin      ArchivesInfPlugin
14plugin      DirectoryPlugin
16classify    AZCompactList -metadata Subject -doclevel top
17classify    AZCompactList -mincompact 5 -maxcompact 10 -metadata Description -mingroup 10 -buttonname Captions -minnesting 7
19format VList "<td>[link][thumbicon][/link]</td>
20<td valign=middle><i>[Description]</i></td>"
22format CL1VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[Description]</i>}</td>"
24format CL2VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[Description]</i>}</td>"
26format DocumentHeading "<h3>[Subject]</h3>"
28format DocumentText "<center><table width=_pagewidth_ border=1>
29<tr><td colspan=2 align=center>
30<a href=[OrigURL]>[screenicon]</a></td></tr>
31<tr><td>_Caption_:</td><td> <i>[Description]</i> <br>
32(<a href=[OrigURL]>_original_ [ImageWidth]x[ImageHeight] [ImageType] _available_</a>)
34<tr><td>_Subject_:</td><td> [Subject]</td></tr>
35<tr><td>_Publisher_:</td><td> [Publisher]</td></tr>
36<tr><td>_Rights_:<td> [Rights]</td></tr>
40# -- English strings ----------------
41collectionmeta  collectionname [l=en] "OAI demo"
43collectionmeta  .document:Description [l=en] "photo captions"
45collectionmeta  Caption [l=en] "Caption"
46collectionmeta  Subject [l=en] "Subject"
47collectionmeta  Publisher [l=en] "Publisher"
48collectionmeta  Rights [l=en] "Rights"
49collectionmeta  original [l=en] "original"
50collectionmeta  available [l=en] "available"
53# -- French strings ----------------
54collectionmeta  collectionname [l=fr] "Démo OAI"
56collectionmeta  .document:Description [l=fr] "Légendes de photos"
58collectionmeta  Caption [l=fr] "Légende"
59collectionmeta  Subject [l=fr] "Sujet"
60collectionmeta  Publisher [l=fr] "Editeur"
61collectionmeta  Rights [l=fr] "Droits"
62collectionmeta  original [l=fr] "original"
63collectionmeta  available [l=fr] "disponible"
66# -- Spanish strings ----------------
67collectionmeta  collectionname [l=es] "Colección de muestra OAI"
69collectionmeta  .document:Description [l=es] "Pies de foto"
71collectionmeta  Caption [l=es] "Título de la ilustración"
72collectionmeta  Subject [l=es] "Asunto"
73collectionmeta  Publisher [l=es] "Editorial"
74collectionmeta  Rights [l=es] "Derecho de autor"
75collectionmeta  original [l=es] "original"
76collectionmeta  available [l=es] "disponible"
79# -- Russian strings ----------------
80collectionmeta  collectionname [l=ru] "ДеЌПМстрацО-ПММая кПллекцОя OAI"
82collectionmeta  .document:Description [l=ru] "ЗагПлПвкО фПтПграфОй"
84collectionmeta  Caption [l=ru] "ЗагПлПвПк (НаЎпОсь)"
85collectionmeta  Subject [l=ru] "ПреЎЌет"
86collectionmeta  Publisher [l=ru] "ИзЎатель"
87collectionmeta  Rights [l=ru] "Права"
88collectionmeta  original [l=ru] "ОрОгОМал"
89collectionmeta  available [l=ru] "ДПступМый"
92# -- English text ----------------
93collectionmeta  collectionextra [l=en] "This collection demonstrates Greenstone\'s
94<i>ImportFrom</i> feature. Using the <a href=>Open
95Archive Protocol</a> (version 1.1), it retrieves metadata from
96<a href=></a>,
97a collection of photographs taken at the inaugural
98<a href=>Joint Conference on Digital
99Libraries</a>. A Greenstone collection is built from the records exported
100from this OAI data provider. The implementation is flexible enough to
101cope with the minor syntax differences between OAI 1.1 and OAI 2.0.\n
103<h3>How the collection works</h3>\n
106The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
107configuration file</a> includes an <i>acquire</i> line that is
108interpreted by a special program called <i></i>. Like other
109Greenstone programs, this takes as argument the name of the collection, and
110provides a summary of other arguments when invoked with argument <i>-help</i>.
111It reads the collection configuration file, finds the acquire line, and
112processes it. In this case, it is run with the command:\n
113<pre> oai-e
118(the collection\'s name is <i>oai-e</i>).
119The <i>acquire</i> line in the configuration file specifies the OAI protocol
120and gives the base URL of an OAI repository. The <i>importfrom</i> program
121downloads all the metadata in that repository into the collection\'s
122<i>import</i> directory. The <i>getdoc</i> argument instructs it to also
123download the collection\'s source documents, whose URLs are given in each
124document\'s Dublin Core <i>Identifier</i> field (this is a common
125convention). The metadata files, which each contain an XML record for one
126source document, are placed in the <i>import</i> file structure along with the
127documents themselves, and the document filename is the same as the filename in
128the URL. The <i>Identifier</i> field is overridden to give the local filename,
129and its original value is retained in a new field called <i>OrigURL</i>.\n
132<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Here</a>
133is an example of a downloaded metadata file.\n
136Once the OAI information has been imported, the collection is processed in the
137usual way. The configuration file specifies the OAI plugin, which processes OAI
138metadata, and the image plugin, because in this case the collection\'s source
139documents are image files. The OAI plugin has been supplied with an
140<i>input_encoding</i> argument because data in this archive contains extended
141characters. It also has a <i>default_language</i> argument. Greenstone normally
142determines the language of documents automatically, but these metadata records
143are too small for this to be done reliably: hence English is specified
144explicitly in the <i>language</i> argument. The OAI plugin parses the metadata
145and passes it to the appropriate source document file, which is then processed
146by an appropriate plugin -- in this case <i>ImagePlug</i>. This plugin specifies
147the resolution for the screen versions of the images.\n
150The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
151configuration file</a> has a single full-text index containing
152<i>Description</i> metadata. When a document is displayed, the
153<i>DocumentHeading</i> format statement puts out its <i>Subject</i>. Then the
154<i>DocumentText</i> statement follows this with <i>screenicon</i>, which is
155produced by <i>ImagePlug</i> and gives a screen-resolution version of the
156image; it is hyperlinked to the <i>OrigURL</i> metadata -- that is, the original
157version of the image on the remote OAI site. This is followed by the image\'s
158<i>Description</i>, also with a hyperlink; the image\'s size and type, again
159generated as metadata by <i>ImagePlug</i>; and then <i>Subject</i>,
161and <i>Rights</i> metadata.
162<a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=HASH01fcd4cc18fa29bc78c06c6a>This</a>
163is the result.\n
166There are two browsing classifiers, one based on <i>Subject</i> metadata and
167the other on <i>Description</i> metadata (but with a button named
168\"captions\"). Recall that the <i>AZCompactList</i> classifier is like
169<i>AZList</i> but generates a bookshelf for duplicate items. In this
170collection there are a lot of images but only a few different values for
171<i>Subject</i> metadata.\n
174It\'s a little surprising that <i>AZCompactList</i> is used (instead of
175<i>AZList</i>) for the <i>Description</i> index too, because <i>Description</i>
176metadata is usually unique for each image. However, in this collection the same
177description has occasionally been given to several images, and some of the
178divisions in an <i>AZList</i> would contain a large number of images, slowing
179down transmission of that page. To avoid this, the compact version of the list
180is used with some arguments (<i>mincompact</i>, <i>maxcompact</i>,
181<i>mingroup</i>, <i>minnesting</i>) to control the display -- e.g. groups (represented by
182bookshelves) are not formed unless they have at least 5 (<i>mingroup</i>)
183items. To find out the meaning of the other arguments for this classifier,
184execute the command <i> AZCompactList</i>. The programs
185<i></i> (for classifiers) and <i></i> (for plugins) are
186useful tools for learning about the capabilities of Greenstone modules. Note
187incidentally the backslash in the configuration file, used to indicate a
188continuation of the previous line.\n
191The <i>VList</i> format specification shows the image thumbnail, hyperlinked to
192the associated document, followed by <i>Description</i> metadata; the result
193can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">here</a>. The <i>Vlists</i>
194for the classifiers use <i>numleafdocs</i> to switch between an icon
195representing several documents (which will appear as a bookshelf) and the
196thumbnail itself, if there is only one image.\n
198<h3>The Greenstone OAI server</h3>\n
201From version 2.52, Greenstone comes with a built-in OAI data provider.
202This runs as a CGI program called \"oaiserver\", and is installed
203in the Greenstone <i>cgi-bin</i> directory. It can be accessed via the same
204URL as the Greenstone library (replacing \"library\" with \"oaiserver\"). If you
205are using the Windows local library server, you must install a
206web server (such as Apache) to run the OAI server.\n
209Configuration of the server is done via the <i>oai.cfg</i> file in the
210Greenstone <i>etc</i> directory. This file specifies general information
211about the repository, and lists collections to be made accessible to OAI
212clients. By default, collections are not accessible. To enable a
213collection, add its name to the <i>oaicollection</i> list. Collections built
214with versions of Greenstone earlier than 2.52 must be rebuilt before
215they can be served.\n
218Greenstone's OAI server only supports Dublin Core
219metadata at present. For collections that use other metadata sets,
220metadata mapping rules should be provided to map the existing metadata
221to Dublin Core. See the <i>oai.cfg</i> file for details.\n
225# -- French text ----------------
226collectionmeta  collectionextra [l=fr] "
227Cette collection montre la fonctionnalité <i>ImportFrom</i> de Greenstone. Par le biais de <a href=>Open Archive Protocol</a> (version 1.1), elle récupÚre des méta-données de <a href=\"\"></a>, une collection de photos prise lors de la cérémonie inaugurale de <a href=\"\">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.
229<h3>Comment fonctionne cette collection ?</h3>
232Le <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></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:
234<pre> oai-e
239(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>.
242<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Voici</a> un exemple de fichier de méta-données téléchargé.
245Une 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.
248Le <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
249l'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.
252Il 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>.
255C'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> AZCompactList</i>. Les programmes <i></i> (pour classificateurs) et <i></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.
258La 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.
260<h3>Le serveur OAI de Greenstone</h3>
263Depuis la version 2.52, Greenstone inclus un fournisseur de donné de type OAI.
264Il 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.
267La 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.
268Afin de rendre une collection accessible, ajoutez son nom à la liste <i>oaicollection</i>.
269Les 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.
272La 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.
276# -- Spanish text ----------------
277collectionmeta  collectionextra [l=es] "
278Esta colección demuestra la función <i>ImportFrom</i> de Greenstone. Por medio del <a href=>Protocolo de Archivo Abierto</a> (versión 1.1) recupera metadatos de <a href=></a>, una colección de fotografías tomadas durante la <a href=>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.
281<h3>Cómo trabaja esta colección</h3>
284El <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></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:
287<pre> oai-e
292(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>.
295He <a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>aquí</a> un ejemplo de un archivo de metadatos bajados del repositorio.
298Una 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.
301El <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.
304Existen 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>.
307Resulta 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> AZCompactList</i>. Los programas <i></i> (para los clasificadores) y <i></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.
310La 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.
312<h3>El servidor OAI de Greenstone</h3>
315Desde la versión 2.52, Greenstone incorpora un servidor/proveedor de datos OAI.
316Se ejecuta mediante un programa CGI llamado \"oaiserver\", y se encuentra
317en el directorio <i>cgi-bin</i> de Greenstone. Se accede a él utilizando el mismo
318URL que para la biblioteca Greentone (reemplazando \"library\" por \"oaiserver\").
319Si usted está usando el servidor de biblioteca local, debe instalar un servidor
320web (como Apache) para poder ejecutar el servidor OAI.\n
323La configuración del servidor se hace mediante el fichero <i>oai.cfg</i> que se
324encuentra en el directorio <i>etc</i> de Greenstone. Este fichero especifica la información
325general sobre el repositorio, e incluye un listado de las colecciones accesibles
326para los clientes OAI. En principio, las coleccciones no son accesibles. Para permitir
327el acceso a una colección, añada su nombre a la lista <i>oaicollection</i>. Las colecciones
328construidas con versiones de Greenstone anteriores a la 2.52 deben ser reconstruidas
329antes de que puedan ser accesibles.\n
332El servidor OAI de Greenstone sólo soporta metadatos Dublin Core por el momento.
333Para colecciones que usen otros conjuntos de metadatos, se deben establecer reglas
334de equivalencias de metadatos entre esos conjuntos y Dublin Core.
335Consulte el fichero <i>oai.cfg</i> para mayor información.\n
339# -- Russian text ----------------
340collectionmeta  collectionextra [l=ru] "
341Эта кПллекцОя ЎеЌПМстрОрует ПсПбеММПстО  <i>ImportFrom</i> Greenstone, ОспПльзуя <a href=>Открытый АрхОвМый ПрПтПкПл</a> OAI (версОя 1.1). ОМа вПсстаМавлОвает ЌетаЎаММые Оз <a href=></a>, кПллекцОю фПтПграфОй, пПлучеММых Ð¿Ñ€Ðž ОМаугурацОО <a href=>ОбъеЎОМеММПй КПМфереМцОО пП ЊОфрПвыЌ БОблОПтекаЌ</a>. КПллекцОя  Greenstone пПстрПеМа пП запОсяЌ, экспПртОрПваММыЌ Оз этПгП OAI пПставщОка ЎаММых. ИМструЌеМт является ЎПстатПчМП гОбкОЌ, чтПбы справОться с МезМачОтельМыЌО сОМтаксОческОЌО разлОчОяЌО ЌежЎу версОяЌО OAI 1.1 О OAI 2.0.
344<h3>Как рабПтает кПллекцОя</h3>
346<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл</a> ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐž включает стрПку <i>ОЌпПрт</i> (<i>acquire</i>), кПтПрая ОМтерпретОруется спецОальМПй прПграЌЌПй, МазываеЌПй <i></i>. ППЎПбМП ЎругОЌ прПграЌЌаЌ Greenstone, ПМа берет в качестве параЌетра МазваМОе (ОЌя) кПллекцОО О ОспПльзует резюЌе ЎругОх Ð¿Ð°Ñ€Ð°ÐŒÐµÑ‚рПв, кПгЎа запускается параЌетр <i>пПЌПщь</i> (<i>help</i>). ОМа счОтывает кПМфОгурацОПММый файл кПллекцОО, МахПЎОт стрПку ОЌпПрта О Пбрабатывает её. В этПЌ случае ПМа запускается кПЌаМЎПй:
348<pre> oai-e
351гЎе oai-e - ОЌя кПллекцОО.
355СтрПка <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>.
358<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>ЗЎесь</a> Ð¿ÐŸÐºÐ°Ð·Ð°Ðœ прОЌер разгрузкО файла ЌетаЎаММых.
361Как тПлькП ОМфПрЌацОя Оз ОAI ОЌпПртОрПваМа, кПллекцОя Пбрабатывается ПбычМыЌ спПсПбПЌ. КПМфОгурацОПММый файл ПпреЎеляет плагОМ OAI, кПтПрый Пбрабатывает ЌетаЎаММые OAI, О плагОМ ОзПбражеМОй, пПскПльку в этПЌ случае ЎПкуЌеМты ОсхПЎМПй кПллекцОО  - этП файлы ОзПбражеМОй. ПлагОМ OAI сПЎержОт параЌетр <i>input_encoding</i>, пПтПЌу чтП ЎаММые в этПЌ архОве ОЌеют сОЌвПлы расшОреМОя. ОМ также ОЌеет параЌетр языка пП уЌПлчаМОю <i>default_language</i>. Greenstone ПбычМП ПпреЎеляет язык ЎПкуЌеМтПв автПЌатОческО, МП этО запОсО ЌетаЎаММых ÑÐ²Ð»ÑÑŽÑ‚ся слОшкПЌ МебПльшОЌО Ўля тПгП, чтПбы этП сЎелать МаЎежМП: пПэтПЌу аМглОйскОй язык ПпреЎелеМ явМП в параЌетре <i>языка</i> (<i>language</i>). ПлагОМы ОAI аМалОзОруют  ЌетаЎаММые О пересылают Ох Ðº сППтветствующеЌу файлу ОсхПЎМПгП ЎПкуЌеМта, кПтПрый затеЌ Пбрабатывается сППтветствующОЌ плагОМПЌ -- в ЎаММПЌ случае <i>ImagePlug</i>. ЭтПт плагОМ ПпреЎеляет разлОчМые версОО разрешеМОя ОзПбражеМОя Ма экраМе.
364<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> является кПМечМыЌ результатПЌ.
367ИЌеется Ўва классОфОкатПра прПсЌПтра, ПЎОМ Оз кПтПрых ÐŸÑÐœÐŸÐ²Ð°Ðœ Ма ЌетаЎаММых <i>ПреЎЌета</i>, а ЎругПй -- Ма ЌетаЎаММых <i>ОпОсаМОя</i>, МП с ОкПМкПй, МазваММПй «ЗагПлПвкО». ВспПЌМОте, чтП классОфОкатПр <i>AZCompactList</i> пПхПж Ма <i>AZList</i>, МП прПОзвПЎОт кМОжМую пПлку Ўля ЎублОкатПв элеЌеМтПв. В этПй кПллекцОО ОЌеется ЌМПгП ОзПбражеМОй, МП лОшь МескПлькП Оз МОх ÐžÐŒÐµÑŽÑ‚ разлОчМые зМачеМОя Ўля ЌетаЎаММых <i>ПреЎЌета</i>.
370МПжМП уЎОвляться, чтП <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> AZCompactList</i>. ПрПграЌЌы <i>classinfo</i>.pl (Ўля классОфОкатПрПв) О <i></i> (Ўля плагОМПв) являются пПлезМыЌО ОМструЌеМтаЌО, кПгЎа МаЎП узМать П вПзЌПжМПстях ÐŒÐŸÐŽÑƒÐ»ÐµÐ¹ Greenstone. ОбратОте кстатО вМОЌаМОе Ма ПбратМый слеш в кПМфОгурацОПММПЌ файле, ОспПльзуеЌый Ўля указаМОя Ма прПЎПлжеМОе преЎыЎущей стрПкО.
373ОпреЎелеМОе фПрЌата <i>VList</i> пПказывает уЌеМьшеММПе ОзПбражеМОе, ОЌеющее гОперсвязь с ОсхПЎМыЌ ЎПкуЌеМтПЌ, в сППтветствОО с ЌетаЎаММыЌО <i>ОпОсаМОя</i>; результат чегП ЌПжМП вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">зЎесь</a>. <i>Vlists</i> Ўля классОфОкатПрПв ОспПльзует <i>numleafdocs</i> Ўля переключеМОя ЌежЎу ОкПМкаЌО, преЎставляющОЌО МескПлькП ЎПкуЌеМтПв (кПтПрый пПявОтся в вОЎе кМОжМПй пПлкО), О МепПсреЎствеММП уЌеМьшеММПе ОзПбражеМОе, еслО ПМП тПлькП ПЎМП.
375<h3>Greenstone OAI сервер</h3>
378Пт версОО 2.52, Greenstone ПтлОчается встрПеММыЌ OAI пПставщОкПЌ ЎаММых. ЭтП запускается как CGI прПграЌЌа, МазываеЌая \"oaiserver\", О устаМПвлеМа в <i>cgi-bin</i> ЎОректПрОО Greenstone. К этПЌу ЌПжМП ПбратОться через тП же саЌый URL как бОблОПтека Greenstone (заЌеМяющОй \"library\" с \"oaiserver\"). ЕслО Вы ОспПльзуете Windows лПкальМый сервер бОблОПтекО, Вы ЎПлжМы устаМПвОть web сервер (такПй как Apache), чтПбы управлять OAI серверПЌ.
381КПМфОгурацОя сервера сЎелаМа через <i>oai.cfg</i> файл в ЎОректПрОО Greenstone. ЭтПт файл ПпреЎеляет главМую ОМфПрЌацОю П сОстеЌе храМеМОя, О спОсках ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹, кПтПрые буЎут ЎПступМы Ўля OAI клОеМтПв. ПП уЌПлчаМОю, кПллекцОО Ме ЎПступМы. ЧтПбы включОть кПлекцОю, ЎПбавьте этП МазваМОе(ОЌя) к спОску <i>oaicollection</i>. КПллекцОО пПстрПеММые с версОяЌО Greenstone раМее чеЌ 2.52 ЎПлжМы быть перестрПеМы прежЎе ПМО ЌПгут ПбслужОваться.
384OAI сервер Greenstone в МастПящее вреЌя пПЎЎержОвает тПлькП Dublin Core ЌетаЎаММые. Для кПллекцОй, кПтПрые ОспПльзуют ЎругОе МабПры ЌетаЎаММых, ЌетаЎаММые ЎПлжМы быть преПбразПваМы в фПрЌат ЌетаЎаММых, кПтПрые ОспПльзуются Ўля Dublin Core. ППЎрПбМее сЌПтрО файл <i>oai.cfg</i>.
Note: See TracBrowser for help on using the browser.