root/collections/documented-examples/trunk/oai-e/etc/collect.cfg @ 19363

Revision 19363, 36.4 KB (checked in by anna, 10 years ago)

oai collection

  • Property svn:executable set to *
Line 
1creator     greenstone@cs.waikato.ac.nz
2public      true
3
4
5acquire OAI -src rocky.dlib.vt.edu/~jcdlpix/cgi-bin/OAI1.1/jcdlpix.pl -getdoc
6
7indexes     document:dc.Description
8
9plugin      OAIPlugin -input_encoding iso_8859_1 -default_language en -document_field dc.Identifier
10plugin      ImagePlugin -screenviewsize 300 -OIDtype assigned -OIDmetadata dc.Title
11plugin      GreenstoneXMLPlugin
12plugin      MetadataXMLPlugin
13plugin      ArchivesInfPlugin
14plugin      DirectoryPlugin
15
16classify    AZCompactList -metadata dc.Subject -doclevel top
17classify    AZCompactList -mincompact 5 -maxcompact 10 -metadata dc.Description -mingroup 10 -buttonname Captions -minnesting 7
18
19format VList "<td>[link][thumbicon][/link]</td>
20<td valign=middle><i>[dc.Description]</i></td>"
21
22format CL1VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[dc.Description]</i>}</td>"
23
24format CL2VList "<td>{If}{[numleafdocs],[link][icon][/link],[link][thumbicon][/link]}</td><td valign=middle>{If}{[numleafdocs],[Title],<i>[dc.Description]</i>}</td>"
25
26format DocumentHeading "<h3>[dc.Subject]</h3>"
27
28format DocumentText "<center><table width=_pagewidth_ border=1>
29<tr><td colspan=2 align=center>
30<a href=[dc.OrigURL]>[screenicon]</a></td></tr>
31<tr><td>_Caption_:</td><td> <i>[dc.Description]</i> <br>
32(<a href=[dc.OrigURL]>_original_ [ImageWidth]x[ImageHeight] [ImageType] _available_</a>)
33</td></tr>
34<tr><td>_Subject_:</td><td> [dc.Subject]</td></tr>
35<tr><td>_Publisher_:</td><td> [dc.Publisher]</td></tr>
36<tr><td>_Rights_:<td> [dc.Rights]</td></tr>
37</table></center>"
38
39collectionmeta sampleoid "01dle6"
40
41# -- English strings ----------------
42collectionmeta  collectionname [l=en] "OAI demo"
43
44collectionmeta  .document:dc.Description [l=en] "photo captions"
45
46collectionmeta  Caption [l=en] "Caption"
47collectionmeta  Subject [l=en] "Subject"
48collectionmeta  Publisher [l=en] "Publisher"
49collectionmeta  Rights [l=en] "Rights"
50collectionmeta  original [l=en] "original"
51collectionmeta  available [l=en] "available"
52
53
54# -- French strings ----------------
55collectionmeta  collectionname [l=fr] "Démo OAI"
56
57collectionmeta  .document:Description [l=fr] "Légendes de photos"
58
59collectionmeta  Caption [l=fr] "Légende"
60collectionmeta  Subject [l=fr] "Sujet"
61collectionmeta  Publisher [l=fr] "Editeur"
62collectionmeta  Rights [l=fr] "Droits"
63collectionmeta  original [l=fr] "original"
64collectionmeta  available [l=fr] "disponible"
65
66
67# -- Spanish strings ----------------
68collectionmeta  collectionname [l=es] "Colección de muestra OAI"
69
70collectionmeta  .document:Description [l=es] "Pies de foto"
71
72collectionmeta  Caption [l=es] "Título de la ilustración"
73collectionmeta  Subject [l=es] "Asunto"
74collectionmeta  Publisher [l=es] "Editorial"
75collectionmeta  Rights [l=es] "Derecho de autor"
76collectionmeta  original [l=es] "original"
77collectionmeta  available [l=es] "disponible"
78
79
80# -- Russian strings ----------------
81collectionmeta  collectionname [l=ru] "ДеЌПМстрацО-ПММая кПллекцОя OAI"
82
83collectionmeta  .document:Description [l=ru] "ЗагПлПвкО фПтПграфОй"
84
85collectionmeta  Caption [l=ru] "ЗагПлПвПк (НаЎпОсь)"
86collectionmeta  Subject [l=ru] "ПреЎЌет"
87collectionmeta  Publisher [l=ru] "ИзЎатель"
88collectionmeta  Rights [l=ru] "Права"
89collectionmeta  original [l=ru] "ОрОгОМал"
90collectionmeta  available [l=ru] "ДПступМый"
91
92
93# -- English text ----------------
94collectionmeta  collectionextra [l=en] "This collection demonstrates Greenstone\'s
95<i>ImportFrom</i> feature. Using the <a href=http://www.openarchives.org>Open
96Archive Protocol</a> (version 1.1), it retrieves metadata from
97<a href=http://rocky.dlib.vt.edu/~jcdlpix>rocky.dlib.vt.edu/~jcdlpix</a>,
98a collection of photographs taken at the inaugural
99<a href=http://www.acm.org/jcdl/jcdl01/>Joint Conference on Digital
100Libraries</a>. A Greenstone collection is built from the records exported
101from this OAI data provider. The implementation is flexible enough to
102cope with the minor syntax differences between OAI 1.1 and OAI 2.0.\n
103
104<h3>How the collection works</h3>\n
105
106<p>
107The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
108configuration file</a> includes an <i>acquire</i> line that is
109interpreted by a special program called <i>importfrom.pl</i>. Like other
110Greenstone programs, this takes as argument the name of the collection, and
111provides a summary of other arguments when invoked with argument <i>-help</i>.
112It reads the collection configuration file, finds the acquire line, and
113processes it. In this case, it is run with the command:\n
114<pre>
115importfrom.pl oai-e
116</pre>\n
117
118<p>
119(the collection\'s name is <i>oai-e</i>).
120The <i>acquire</i> line in the configuration file specifies the OAI protocol
121and gives the base URL of an OAI repository. The <i>importfrom</i> program
122downloads all the metadata in that repository into the collection\'s
123<i>import</i> directory. The <i>getdoc</i> argument instructs it to also
124download the collection\'s source documents, whose URLs are given in each
125document\'s Dublin Core <i>Identifier</i> field (this is a common
126convention). The metadata files, which each contain an XML record for one
127source document, are placed in the <i>import</i> file structure along with the
128documents themselves, and the document filename is the same as the filename in
129the URL. The <i>Identifier</i> field is overridden to give the local filename,
130and its original value is retained in a new field called <i>OrigURL</i>.\n
131
132<p>
133<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Here</a>
134is an example of a downloaded metadata file.\n
135
136<p>
137Once the OAI information has been imported, the collection is processed in the
138usual way. Besides the four standard plugins (GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin and DirectoryPlugin),
139the configuration file specifies the OAI plugin, which processes OAI
140metadata, and the image plugin, because in this case the collection\'s source
141documents are image files. The OAI plugin has been supplied with an
142<i>input_encoding</i> argument because data in this archive contains extended
143characters. It also has a <i>default_language</i> argument. Greenstone normally
144determines the language of documents automatically, but these metadata records
145are too small for this to be done reliably: hence English is specified
146explicitly in the <i>language</i> argument. The OAI plugin parses the metadata
147and passes it to the appropriate source document file, which is then processed
148by an appropriate plugin -- in this case <i>ImagePlugin</i>. This plugin specifies
149the resolution for the screen versions of the images.\n
150
151<p>
152Extracted metadata from OAI records are mapped to Dublin Core Metadata Set by default.
153As a result, classifiers and indexes in this collection are built with Dublin meatadata elements.
154
155<p>
156The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
157configuration file</a> has a single full-text index containing
158<i>dc.Description</i> metadata. When a document is displayed, the
159<i>DocumentHeading</i> format statement puts out its <i>dc.Subject</i>. Then the
160<i>DocumentText</i> statement follows this with <i>screenicon</i>, which is
161produced by <i>ImagePlugin</i> and gives a screen-resolution version of the
162image; it is hyperlinked to the <i>dc.OrigURL</i> metadata -- that is, the original
163version of the image on the remote OAI site. This is followed by the image\'s
164<i>dc.Description</i>, also with a hyperlink; the image\'s size and type, again
165generated as metadata by <i>ImagePlugin</i>; and then <i>dc.Subject</i>,
166<i>dc.Publisher</i>,
167and <i>dc.Rights</i> metadata.
168<a href=_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=_sampleoid_>This</a>
169is the result.\n
170
171<p>
172There are two browsing classifiers, one based on <i>dc.Subject</i> metadata and
173the other on <i>dc.Description</i> metadata (but with a button named
174\"captions\"). Recall that the <i>AZCompactList</i> classifier is like
175<i>AZList</i> but generates a bookshelf for duplicate items. In this
176collection there are a lot of images but only a few different values for
177<i>dc.Subject</i> metadata.\n
178
179<p>
180It\'s a little surprising that <i>AZCompactList</i> is used (instead of
181<i>AZList</i>) for the <i>dc.Description</i> index too, because <i>dc.Description</i>
182metadata is usually unique for each image. However, in this collection the same
183description has occasionally been given to several images, and some of the
184divisions in an <i>AZList</i> would contain a large number of images, slowing
185down transmission of that page. To avoid this, the compact version of the list
186is used with some arguments (<i>mincompact</i>, <i>maxcompact</i>,
187<i>mingroup</i>, <i>minnesting</i>) to control the display -- e.g. groups (represented by
188bookshelves) are not formed unless they have at least 5 (<i>mingroup</i>)
189items. To find out the meaning of the other arguments for this classifier,
190execute the command <i>classinfo.pl AZCompactList</i>. The programs
191<i>classinfo.pl</i> (for classifiers) and <i>pluginfo.pl</i> (for plugins) are
192useful tools for learning about the capabilities of Greenstone modules. Note
193incidentally the backslash in the configuration file, used to indicate a
194continuation of the previous line.\n
195
196<p>
197The <i>VList</i> format specification shows the image thumbnail, hyperlinked to
198the associated document, followed by <i>dc.Description</i> metadata; the result
199can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">here</a>. The <i>Vlists</i>
200for the classifiers use <i>numleafdocs</i> to switch between an icon
201representing several documents (which will appear as a bookshelf) and the
202thumbnail itself, if there is only one image.\n
203
204<h3>The Greenstone OAI server</h3>\n
205
206<p>
207From version 2.52, Greenstone comes with a built-in OAI data provider.
208This runs as a CGI program called \"oaiserver\", and is installed
209in the Greenstone <i>cgi-bin</i> directory. It can be accessed via the same
210URL as the Greenstone library (replacing \"library\" with \"oaiserver\"). If you
211are using the Windows local library server, you must install a
212web server (such as Apache) to run the OAI server.\n
213
214<p>
215Configuration of the server is done via the <i>oai.cfg</i> file in the
216Greenstone <i>etc</i> directory. This file specifies general information
217about the repository, and lists collections to be made accessible to OAI
218clients. By default, collections are not accessible. To enable a
219collection, add its name to the <i>oaicollection</i> list. Collections built
220with versions of Greenstone earlier than 2.52 must be rebuilt before
221they can be served.\n
222
223<p>
224Greenstone's OAI server only supports Dublin Core
225metadata at present. For collections that use other metadata sets,
226metadata mapping rules should be provided to map the existing metadata
227to Dublin Core. See the <i>oai.cfg</i> file for details.\n
228"
229
230
231# -- French text ----------------
232collectionmeta  collectionextra [l=fr] "
233Cette 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.
234
235<h3>Comment fonctionne cette collection ?</h3>
236
237<p>
238Le <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:
239
240<pre>
241importfrom.pl oai-e
242</pre>
243
244<p>
245(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>.
246
247<p>
248<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Voici</a> un exemple de fichier de méta-données téléchargé.
249
250<p>
251Une 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. _text1_ 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>ImagePlugin</i>. Ce plugin spécifie la résolution pour les versions écran des images.
252
253<p>
254_text2_
255
256<p>
257Le <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>dc.Description</i>. Quand un document est affiché, la déclaration de format <i>DocumentHeading</i> révÚle son <i>dc.Subject</i> (Sujet). Elle est ensuite suivie de la déclaration <i>DocumentText</i> avec <i>screenicon</i> produit par <i>ImagePlugin</i> et qui donne une version résolution d'écran de l'image; elle est liée à la méta-donnée <i>dc.OrigURL</i>, c'est à dire la version originale de
258l'image sur le site OAI distant. Elle est suivie par <i>dc.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>ImagePlugin</i>; et enfin les méta-données <i>dc.Subject</i>, <i>dc.Publisher</i> et <i>dc.Rights</i>. <a href=\"_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=_sampleoid_\">Voici</a> le résultat.
259
260<p>
261Il y a deux classificateurs de navigation, l'un basé sur la méta-donnée <i>dc.Subject</i> et l'autre sur la méta-donnée <i>dc.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>dc.Subject</i>.
262
263<p>
264C'est un peu surprenant que <i>AZCompactList</i> soit utilisé (au lieu de <i>AZList</i>) pour l'index <i>dc.Description</i> aussi, car la méta-donnée <i>dc.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.
265
266<p>
267La 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>dc.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.
268
269<h3>Le serveur OAI de Greenstone</h3>
270
271<p>
272Depuis la version 2.52, Greenstone inclus un fournisseur de donné de type OAI.
273Il 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.
274
275<p>
276La 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.
277Afin de rendre une collection accessible, ajoutez son nom à la liste <i>oaicollection</i>.
278Les 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.
279
280<p>
281La 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.
282"
283
284
285# -- Spanish text ----------------
286collectionmeta  collectionextra [l=es] "
287Esta 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.
288<p>
289
290<h3>Cómo trabaja esta colección</h3>
291
292
293El <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:
294<p>
295
296<pre>
297importfrom.pl oai-e
298</pre>\n
299<p>
300
301(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>dc.OrigURL</i>.
302<p>
303
304He <a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>aquí</a> un ejemplo de un archivo de metadatos bajados del repositorio.
305<p>
306
307Una 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. _text1_  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>ImagePlugin</i>. Este plugin especifica la resolución de las imágenes en pantalla.
308
309<p>
310_text2_
311
312<p>
313El <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>dc.Descripción</i>. Cuando un documento se despliega en pantalla el enunciado de formato <i>DocumentHeading</i> muestra su <i>dc.Asunto</i>. A continuación le sigue el enunciado <i>DocumentText</i> con <i>screenicon</i>, el cual es producido por <i>ImagePlugin</i> y proporciona una versión en pantalla de la imagen. Ésta cuenta con un hipervínculo al metadato <i>dc.OrigURL</i>, es decir, a la versión original de la imagen en el sitio OAI remoto. Le sigue la <i>dc.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>ImagePlugin</i>, y finalmente los metadatos de <i>dc.Asunto</i>, <i>dc.Editorial</i> y <i>dc.Derechos de Autor</i>. <a href=\"_gwcgi_?l=_cgiargl_&a=d&c=oai-e&cl=search&d=_sampleoid_\">Éste</a> es el resultado.
314<p>
315
316Existen dos clasificadores de exploración, uno basado en el metadato <i>dc.Asunto</i> y el otro en el metadato <i>dc.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>dc.Asunto</i>.
317<p>
318
319Resulta un tanto sorprendente que el clasificador <i>AZCompactList</i> también se utilice (en vez de <i>AZList</i>) para el índice de <i>dc.Descripción</i>, ya que por lo general el metadato <i>dc.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.
320<p>
321
322La 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>dc.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.
323
324<h3>El servidor OAI de Greenstone</h3>
325
326<p>
327Desde la versión 2.52, Greenstone incorpora un servidor/proveedor de datos OAI.
328Se ejecuta mediante un programa CGI llamado \"oaiserver\", y se encuentra
329en el directorio <i>cgi-bin</i> de Greenstone. Se accede a él utilizando el mismo
330URL que para la biblioteca Greentone (reemplazando \"library\" por \"oaiserver\").
331Si usted está usando el servidor de biblioteca local, debe instalar un servidor
332web (como Apache) para poder ejecutar el servidor OAI.\n
333
334<p>
335La configuración del servidor se hace mediante el fichero <i>oai.cfg</i> que se
336encuentra en el directorio <i>etc</i> de Greenstone. Este fichero especifica la información
337general sobre el repositorio, e incluye un listado de las colecciones accesibles
338para los clientes OAI. En principio, las coleccciones no son accesibles. Para permitir
339el acceso a una colección, añada su nombre a la lista <i>oaicollection</i>. Las colecciones
340construidas con versiones de Greenstone anteriores a la 2.52 deben ser reconstruidas
341antes de que puedan ser accesibles.\n
342
343<p>
344El servidor OAI de Greenstone sólo soporta metadatos Dublin Core por el momento.
345Para colecciones que usen otros conjuntos de metadatos, se deben establecer reglas
346de equivalencias de metadatos entre esos conjuntos y Dublin Core.
347Consulte el fichero <i>oai.cfg</i> para mayor información.\n
348"
349
350
351# -- Russian text ----------------
352collectionmeta  collectionextra [l=ru] "
353Эта кПллекцОя ЎеЌПМстрОрует ПсПбеММПстО  <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.
354<p>
355
356<h3>Как рабПтает кПллекцОя</h3>
357
358<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>). ОМа счОтывает кПМфОгурацОПММый файл кПллекцОО, МахПЎОт стрПку ОЌпПрта О Пбрабатывает её. В этПЌ случае ПМа запускается кПЌаМЎПй:
359<p>
360<pre>
361importfrom.pl oai-e
362</pre>\n
363гЎе oai-e - ОЌя кПллекцОО.
364<p>
365
366
367СтрПка <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>dc.OrigURL</i>.
368<p>
369
370<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>ЗЎесь</a> Ð¿ÐŸÐºÐ°Ð·Ð°Ðœ прОЌер разгрузкО файла ЌетаЎаММых.
371<p>
372
373Как тПлькП ОМфПрЌацОя Оз ОAI ОЌпПртОрПваМа, кПллекцОя Пбрабатывается ПбычМыЌ спПсПбПЌ. КПМфОгурацОПММый файл ПпреЎеляет плагОМ OAI, кПтПрый Пбрабатывает ЌетаЎаММые OAI, О плагОМ ОзПбражеМОй, пПскПльку в этПЌ случае ЎПкуЌеМты ОсхПЎМПй кПллекцОО  - этП файлы ОзПбражеМОй. _text1_ Greenstone ПбычМП ПпреЎеляет язык ЎПкуЌеМтПв автПЌатОческО, МП этО запОсО ЌетаЎаММых ÑÐ²Ð»ÑÑŽÑ‚ся слОшкПЌ МебПльшОЌО Ўля тПгП, чтПбы этП сЎелать МаЎежМП: пПэтПЌу аМглОйскОй язык ПпреЎелеМ явМП в параЌетре <i>языка</i> (<i>language</i>). ПлагОМы ОAI аМалОзОруют  ЌетаЎаММые О пересылают Ох Ðº сППтветствующеЌу файлу ОсхПЎМПгП ЎПкуЌеМта, кПтПрый затеЌ Пбрабатывается сППтветствующОЌ плагОМПЌ -- в ЎаММПЌ случае <i>ImagePlugin</i>. ЭтПт плагОМ ПпреЎеляет разлОчМые версОО разрешеМОя ОзПбражеМОя Ма экраМе.
374
375<p>
376_text2_
377
378<p>
379_text3_
380
381<p>
382
383ИЌеется Ўва классОфОкатПра прПсЌПтра, ПЎОМ Оз кПтПрых ÐŸÑÐœÐŸÐ²Ð°Ðœ Ма ЌетаЎаММых <i>ПреЎЌета</i>, а ЎругПй -- Ма ЌетаЎаММых <i>ОпОсаМОя</i>, МП с ОкПМкПй, МазваММПй «ЗагПлПвкО». ВспПЌМОте, чтП классОфОкатПр <i>AZCompactList</i> пПхПж Ма <i>AZList</i>, МП прПОзвПЎОт кМОжМую пПлку Ўля ЎублОкатПв элеЌеМтПв. В этПй кПллекцОО ОЌеется ЌМПгП ОзПбражеМОй, МП лОшь МескПлькП Оз МОх ÐžÐŒÐµÑŽÑ‚ разлОчМые зМачеМОя Ўля ЌетаЎаММых <i>ПреЎЌета</i>.
384<p>
385
386МПжМП уЎОвляться, чтП <i>AZCompactList</i> ОспПльзуется вЌестП  <i>AZList</i> также Ўля ОМЎекса <i>ОпОсаМОя</i> (<i>dc.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. ОбратОте кстатО вМОЌаМОе Ма ПбратМый слеш в кПМфОгурацОПММПЌ файле, ОспПльзуеЌый Ўля указаМОя Ма прПЎПлжеМОе преЎыЎущей стрПкО.
387<p>
388
389ОпреЎелеМОе фПрЌата <i>VList</i> пПказывает уЌеМьшеММПе ОзПбражеМОе, ОЌеющее гОперсвязь с ОсхПЎМыЌ ЎПкуЌеМтПЌ, в сППтветствОО с ЌетаЎаММыЌО <i>ОпОсаМОя</i>; результат чегП ЌПжМП вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=oai-e&a=d&cl=CL2\">зЎесь</a>. <i>Vlists</i> Ўля классОфОкатПрПв ОспПльзует <i>numleafdocs</i> Ўля переключеМОя ЌежЎу ОкПМкаЌО, преЎставляющОЌО МескПлькП ЎПкуЌеМтПв (кПтПрый пПявОтся в вОЎе кМОжМПй пПлкО), О МепПсреЎствеММП уЌеМьшеММПе ОзПбражеМОе, еслО ПМП тПлькП ПЎМП.
390
391<h3>Greenstone OAI сервер</h3>
392
393<p>
394Пт версОО 2.52, Greenstone ПтлОчается встрПеММыЌ OAI пПставщОкПЌ ЎаММых. ЭтП запускается как CGI прПграЌЌа, МазываеЌая \"oaiserver\", О устаМПвлеМа в <i>cgi-bin</i> ЎОректПрОО Greenstone. К этПЌу ЌПжМП ПбратОться через тП же саЌый URL как бОблОПтека Greenstone (заЌеМяющОй \"library\" с \"oaiserver\"). ЕслО Вы ОспПльзуете Windows лПкальМый сервер бОблОПтекО, Вы ЎПлжМы устаМПвОть web сервер (такПй как Apache), чтПбы управлять OAI серверПЌ.
395
396<p>
397КПМфОгурацОя сервера сЎелаМа через <i>oai.cfg</i> файл в ЎОректПрОО Greenstone. ЭтПт файл ПпреЎеляет главМую ОМфПрЌацОю П сОстеЌе храМеМОя, О спОсках ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹, кПтПрые буЎут ЎПступМы Ўля OAI клОеМтПв. ПП уЌПлчаМОю, кПллекцОО Ме ЎПступМы. ЧтПбы включОть кПлекцОю, ЎПбавьте этП МазваМОе(ОЌя) к спОску <i>oaicollection</i>. КПллекцОО пПстрПеММые с версОяЌО Greenstone раМее чеЌ 2.52 ЎПлжМы быть перестрПеМы прежЎе ПМО ЌПгут ПбслужОваться.
398
399<p>
400OAI сервер Greenstone в МастПящее вреЌя пПЎЎержОвает тПлькП Dublin Core ЌетаЎаММые. Для кПллекцОй, кПтПрые ОспПльзуют ЎругОе МабПры ЌетаЎаММых, ЌетаЎаММые ЎПлжМы быть преПбразПваМы в фПрЌат ЌетаЎаММых, кПтПрые ОспПльзуются Ўля Dublin Core. ППЎрПбМее сЌПтрО файл <i>oai.cfg</i>.
401"
Note: See TracBrowser for help on using the browser.