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

Revision 19393, 35.5 KB (checked in by kjdon, 10 years ago)

some updates

  • 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=_cgiargc_&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=_cgiargc_&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>
207Greenstone comes with a built-in OAI data provider.
208This runs as a CGI program called \"oaiserver.cgi\", 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.cgi\" with \"oaiserver.cgi\"). 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 currently supports Dublin Core, qualified Dublin Core and rfc1807 metadata sets. The <i>oaimetadata</i> line specifies which sets should be used. For collections that use other metadata sets,
225metadata mapping rules should be provided to map the existing metadata
226to the sets in use. See the <i>oai.cfg</i> file for details.\n
227"
228
229
230# -- French text ----------------
231collectionmeta  collectionextra [l=fr] "
232Cette 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.
233
234<h3>Comment fonctionne cette collection ?</h3>
235
236<p>
237Le <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:
238
239<pre>
240importfrom.pl oai-e
241</pre>
242
243<p>
244(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>.
245
246<p>
247<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>Voici</a> un exemple de fichier de méta-données téléchargé.
248
249<p>
250Une 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.
251
252<p>
253_text2_
254
255<p>
256Le <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
257l'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=_cgiargc_&cl=search&d=_sampleoid_\">Voici</a> le résultat.
258
259<p>
260Il 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>.
261
262<p>
263C'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.
264
265<p>
266La 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=_cgiargc_&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.
267
268<h3>Le serveur OAI de Greenstone</h3>
269
270<p>
271Greenstone inclus un fournisseur de donné de type OAI.
272Il fonctionne par le biais d'un programme CGI nommé \"oaiserver.cgi\" 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.cgi\" par \"oaiserver.cgi\"). 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.
273
274<p>
275La 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.
276Afin de rendre une collection accessible, ajoutez son nom à la liste <i>oaicollection</i>.
277Les 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.
278
279<p>
280_text3_
281"
282
283
284# -- Spanish text ----------------
285collectionmeta  collectionextra [l=es] "
286Esta 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.
287<p>
288
289<h3>Cómo trabaja esta colección</h3>
290
291
292El <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:
293<p>
294
295<pre>
296importfrom.pl oai-e
297</pre>\n
298<p>
299
300(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>.
301<p>
302
303He <a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>aquí</a> un ejemplo de un archivo de metadatos bajados del repositorio.
304<p>
305
306Una 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.
307
308<p>
309_text2_
310
311<p>
312El <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=_cgiargc_&cl=search&d=_sampleoid_\">Éste</a> es el resultado.
313<p>
314
315Existen 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>.
316<p>
317
318Resulta 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.
319<p>
320
321La 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=_cgiargc_&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.
322
323<h3>El servidor OAI de Greenstone</h3>
324
325<p>
326Greenstone incorpora un servidor/proveedor de datos OAI.
327Se ejecuta mediante un programa CGI llamado \"oaiserver.cgi\", y se encuentra
328en el directorio <i>cgi-bin</i> de Greenstone. Se accede a él utilizando el mismo
329URL que para la biblioteca Greentone (reemplazando \"library.cgi\" por \"oaiserver.cgi\").
330Si usted está usando el servidor de biblioteca local, debe instalar un servidor
331web (como Apache) para poder ejecutar el servidor OAI.\n
332
333<p>
334La configuración del servidor se hace mediante el fichero <i>oai.cfg</i> que se
335encuentra en el directorio <i>etc</i> de Greenstone. Este fichero especifica la información
336general sobre el repositorio, e incluye un listado de las colecciones accesibles
337para los clientes OAI. En principio, las coleccciones no son accesibles. Para permitir
338el acceso a una colección, añada su nombre a la lista <i>oaicollection</i>. Las colecciones
339construidas con versiones de Greenstone anteriores a la 2.52 deben ser reconstruidas
340antes de que puedan ser accesibles.\n
341
342<p>
343_text3_
344"
345
346
347# -- Russian text ----------------
348collectionmeta  collectionextra [l=ru] "
349Эта кПллекцОя ЎеЌПМстрОрует ПсПбеММПстО  <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.
350<p>
351
352<h3>Как рабПтает кПллекцОя</h3>
353
354<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>). ОМа счОтывает кПМфОгурацОПММый файл кПллекцОО, МахПЎОт стрПку ОЌпПрта О Пбрабатывает её. В этПЌ случае ПМа запускается кПЌаМЎПй:
355<p>
356<pre>
357importfrom.pl oai-e
358</pre>\n
359гЎе oai-e - ОЌя кПллекцОО.
360<p>
361
362
363СтрПка <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>.
364<p>
365
366<a href=\"_httpcollection_/etc/oai.txt\" target=oai.txt>ЗЎесь</a> Ð¿ÐŸÐºÐ°Ð·Ð°Ðœ прОЌер разгрузкО файла ЌетаЎаММых.
367<p>
368
369Как тПлькП ОМфПрЌацОя Оз ОAI ОЌпПртОрПваМа, кПллекцОя Пбрабатывается ПбычМыЌ спПсПбПЌ. КПМфОгурацОПММый файл ПпреЎеляет плагОМ OAI, кПтПрый Пбрабатывает ЌетаЎаММые OAI, О плагОМ ОзПбражеМОй, пПскПльку в этПЌ случае ЎПкуЌеМты ОсхПЎМПй кПллекцОО  - этП файлы ОзПбражеМОй. _text1_ Greenstone ПбычМП ПпреЎеляет язык ЎПкуЌеМтПв автПЌатОческО, МП этО запОсО ЌетаЎаММых ÑÐ²Ð»ÑÑŽÑ‚ся слОшкПЌ МебПльшОЌО Ўля тПгП, чтПбы этП сЎелать МаЎежМП: пПэтПЌу аМглОйскОй язык ПпреЎелеМ явМП в параЌетре <i>языка</i> (<i>language</i>). ПлагОМы ОAI аМалОзОруют  ЌетаЎаММые О пересылают Ох Ðº сППтветствующеЌу файлу ОсхПЎМПгП ЎПкуЌеМта, кПтПрый затеЌ Пбрабатывается сППтветствующОЌ плагОМПЌ -- в ЎаММПЌ случае <i>ImagePlugin</i>. ЭтПт плагОМ ПпреЎеляет разлОчМые версОО разрешеМОя ОзПбражеМОя Ма экраМе.
370
371<p>
372_text2_
373
374<p>
375_text3_
376
377<p>
378
379ИЌеется Ўва классОфОкатПра прПсЌПтра, ПЎОМ Оз кПтПрых ÐŸÑÐœÐŸÐ²Ð°Ðœ Ма ЌетаЎаММых <i>ПреЎЌета</i>, а ЎругПй -- Ма ЌетаЎаММых <i>ОпОсаМОя</i>, МП с ОкПМкПй, МазваММПй «ЗагПлПвкО». ВспПЌМОте, чтП классОфОкатПр <i>AZCompactList</i> пПхПж Ма <i>AZList</i>, МП прПОзвПЎОт кМОжМую пПлку Ўля ЎублОкатПв элеЌеМтПв. В этПй кПллекцОО ОЌеется ЌМПгП ОзПбражеМОй, МП лОшь МескПлькП Оз МОх ÐžÐŒÐµÑŽÑ‚ разлОчМые зМачеМОя Ўля ЌетаЎаММых <i>ПреЎЌета</i>.
380<p>
381
382МПжМП уЎОвляться, чтП <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. ОбратОте кстатО вМОЌаМОе Ма ПбратМый слеш в кПМфОгурацОПММПЌ файле, ОспПльзуеЌый Ўля указаМОя Ма прПЎПлжеМОе преЎыЎущей стрПкО.
383<p>
384
385ОпреЎелеМОе фПрЌата <i>VList</i> пПказывает уЌеМьшеММПе ОзПбражеМОе, ОЌеющее гОперсвязь с ОсхПЎМыЌ ЎПкуЌеМтПЌ, в сППтветствОО с ЌетаЎаММыЌО <i>ОпОсаМОя</i>; результат чегП ЌПжМП вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">зЎесь</a>. <i>Vlists</i> Ўля классОфОкатПрПв ОспПльзует <i>numleafdocs</i> Ўля переключеМОя ЌежЎу ОкПМкаЌО, преЎставляющОЌО МескПлькП ЎПкуЌеМтПв (кПтПрый пПявОтся в вОЎе кМОжМПй пПлкО), О МепПсреЎствеММП уЌеМьшеММПе ОзПбражеМОе, еслО ПМП тПлькП ПЎМП.
386
387<h3>Greenstone OAI сервер</h3>
388
389<p>
390Greenstone ПтлОчается встрПеММыЌ OAI пПставщОкПЌ ЎаММых. ЭтП запускается как CGI прПграЌЌа, МазываеЌая \"oaiserver.cgi\", О устаМПвлеМа в <i>cgi-bin</i> ЎОректПрОО Greenstone. К этПЌу ЌПжМП ПбратОться через тП же саЌый URL как бОблОПтека Greenstone (заЌеМяющОй \"library.cgi\" с \"oaiserver.cgi\"). ЕслО Вы ОспПльзуете Windows лПкальМый сервер бОблОПтекО, Вы ЎПлжМы устаМПвОть web сервер (такПй как Apache), чтПбы управлять OAI серверПЌ.
391
392<p>
393КПМфОгурацОя сервера сЎелаМа через <i>oai.cfg</i> файл в ЎОректПрОО Greenstone. ЭтПт файл ПпреЎеляет главМую ОМфПрЌацОю П сОстеЌе храМеМОя, О спОсках ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹, кПтПрые буЎут ЎПступМы Ўля OAI клОеМтПв. ПП уЌПлчаМОю, кПллекцОО Ме ЎПступМы. ЧтПбы включОть кПлекцОю, ЎПбавьте этП МазваМОе(ОЌя) к спОску <i>oaicollection</i>. КПллекцОО пПстрПеММые с версОяЌО Greenstone раМее чеЌ 2.52 ЎПлжМы быть перестрПеМы прежЎе ПМО ЌПгут ПбслужОваться.
394
395<p>
396_text3_
397"
Note: See TracBrowser for help on using the browser.