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

Revision 18807, 37.8 KB (checked in by kjdon, 10 years ago)

removed beta lines and collectionicon lines from collect.cfg files

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