source: collections/documented-examples/trunk/dls-e/etc/collect.cfg@ 19198

Last change on this file since 19198 was 19198, checked in by kjdon, 12 years ago

updated some of the description. not finished yet

  • Property svn:executable set to *
File size: 65.9 KB
Line 
1creator greenstone@cs.waikato.ac.nz
2public true
3
4
5plugin HTMLPlugin -description_tags -input_encoding iso_8859_1 -OIDtype dirname
6plugin GreenstoneXMLPlugin
7plugin MetadataXMLPlugin
8plugin ArchivesInfPlugin
9plugin DirectoryPlugin
10
11indexes section:text section:Title document:text
12
13classify Hierarchy -metadata dls.Subject -sort Title -buttonname Subject -hfile dls.Subject.txt
14classify Hierarchy -hlist_at_top -metadata dls.AZList -sort Title -buttonname Title -hfile dls.AZList.txt
15classify Hierarchy -metadata dls.Organization -sort Title -buttonname Organization -hfile dls.Organization.txt
16classify Hierarchy -metadata dls.Keyword -sort Title -buttonname Howto -hfile dls.Keyword.txt
17
18format VList "<td valign=top>[link][icon][/link]</td>
19<td valign=top>[highlight]{Or}{[Title],Untitled}[/highlight]
20<i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages],
21<br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i>
22</td>"
23
24format SearchVList "<td valign=top>[link][icon][/link]</td>
25<td>{If}{[parent(All\': \'):Title],
26[parent(All\': \'):Title]:}
27[link][Title][/link]</td>"
28
29format DocumentText "<h3>[Title]</h3>\\n\\n<p>[Text]"
30format DocumentImages true
31format DocumentButtons "Expand Text|Expand Contents|Detach|Highlight"
32
33
34# -- English strings ----------------
35collectionmeta collectionname [l=en] "Development Library Subset collection"
36
37collectionmeta .section:text [l=en] "chapters"
38collectionmeta .section:Title [l=en] "section titles"
39collectionmeta .document:text [l=en] "entire documents"
40
41# -- French strings ----------------
42collectionmeta collectionname [l=fr] "Sous-ensemble de la collection BibliothÚque de Développement"
43
44collectionmeta .section:text [l=fr] "chapitres"
45collectionmeta .section:Title [l=fr] "titres des sections"
46collectionmeta .document:text [l=fr] "documents entiers"
47
48# -- Spanish strings ----------------
49collectionmeta collectionname [l=es] "Subconjunto de la Biblioteca para el Desarrollo"
50
51collectionmeta .section:text [l=es] "capítulos"
52collectionmeta .section:Title [l=es] "títulos de las secciones"
53collectionmeta .document:text [l=es] "documentos completos"
54
55# -- Russian strings ----------------
56collectionmeta collectionname [l=ru] "СубкПллекцОя БОблОПтекО развОтОя"
57
58collectionmeta .section:text [l=ru] "Главы"
59collectionmeta .section:Title [l=ru] "НазваМОя разЎелПв"
60collectionmeta .document:text [l=ru] "ППлМые ЎПкуЌеМты"
61
62# -- English text ----------------
63collectionmeta collectionextra [l=en] "The Humanitarian Development Libraries
64represent a large collection of practical information aimed at helping
65reduce poverty, increasing human potential, and providing a practical and
66useful education for all. This subset contains about 25
67publications--documents, reports, and periodical articles--in various areas
68of human development, from agricultural practice to economic policies, from
69water and sanitation to society and culture, from education to
70manufacturing, from disaster mitigation to micro-enterprises.
71
72<p> The editors of this collection are Human Info NGO, HumanityCD Ltd, and
73participating organizations. Contact us at Humanitarian and Development
74Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
7532-3-448.05.54, Fax 32-3-449.75.74,
76email <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.\n
77
78<h3>How the collection works</h3>\n
79
80<p>
81The DLS collection is fairly complex. If you\'re
82just starting out you might prefer to look at some other
83collections first (e.g.
84<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Word and PDF demonstration</a>, or the
85<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Greenstone Archives</a>, or the
86<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">Simple Image collection</a>).\n
87
88<p>
89The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
90configuration file</a>, like all collection configuration files, begins with a
91line (\"creator\") that gives the email address of the collection\'s creator, and
92another (\"public\") that determines whether the collection will appear on the
93home page of the Greenstone installation.\n
94
95<p>
96<b>Collection-level metadata</b>. The <i>collectionmeta</i> lines in the
97configuration file are also standard in all Greenstone collections. They give
98general information about the collection, defining its name, and a
99description that appears on its home page. The description (in <i>collectionextra</i>) can be
100seen on the DLS collection\'s home page (this text is part of it).\n
101
102<p>
103<b>Plugins</b>. The third block of lines in the
104<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>configuration file</a>
105gives the plugins used by the collection. The documents in the DLS collection
106are in HTML, so <i>HTMLPlugin</i> must be included. The <i>description_tags</i>
107option processes tags in the text that define sections and section titles as
108described below. \n
109
110<p>
111The other plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, and DirectoryPlugin</i>, are used by Greenstone
112for internal purposes and are standard in almost all collections.
113
114<p>
115<b>Searchable indexes</b>. The block of lines starting with <i>indexes</i>
116specifies what searchable indexes will be available. In this collection there
117are three: you can see them when you pull down the \"Search for\" menu on the
118<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>.
119The first index is called \"chapters\", the second \"section titles\",
120and the third \"entire documents\". The names of these three indexes are given by
121three <i>collectionmeta</i> statements.\n
122
123<p>
124The contents of the indexes -- that is, the specification of what it is that
125will be searched -- are defined by the <i>indexes</i> line at the beginning of
126this block. This specifies three indexes, two at the section level (beginning
127with <i>section:</i>) and one at the document level (beginning with
128<i>document:</i>). The difference is that a multi-word query will only match a
129section-level index if all query terms appear in the same section, whereas it
130will match a document-level index if the terms appear anywhere within the
131document (which typically comprises several sections). The first and third
132indexes are <i>section:text</i> and <i>document:text</i>, and the <i>:text</i>
133means that the full text of sections and documents respectively will be
134searched. The second is <i>section:Title</i>, which means that <i>Title</i>
135metadata will be searched -- in this case, section titles (rather than document
136titles). The three indexes appear in the order in which they are specified on
137the <i>indexes</i> line.\n
138
139<p>
140<b>Classifiers</b>. The block of lines labeled <i>classify</i> define the
141browsing indexes, called \"classifiers\" in Greenstone. There are four of them,
142corresponding to four buttons on the navigation bar at the top of each page in
143the collection (e.g. the <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>):
144<i>subjects</i>, <i>titles</i>, <i>organisations</i>, and <i>keywords</i>
145The <i>search</i> button comes first, then come the four classifiers, in order.\n
146
147******* updated to here*******
148<p>
149The first classifier provides access by subject. It is a <i>Hierarchy</i>
150classifier whose hierarchy is defined in the file
151<a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>
152(the <i>hfile</i> argument); this file is discussed below. This classifier is
153based on <i>Subject</i> metadata, and when several books appear at a leaf of
154the hierarchy they are sorted by <i>Title</i> metadata (as you can see
155<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">here</a>).
156
157The second provides access by title: it is an <i>AZList</i> classifier based on
158<i>Title</i> metadata. The third provides access by organization: it is a
159<i>Hierarchy</i> classifier based on <i>Organization</i> metadata whose
160hierarchy is defined in
161<a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a>;
162this file is discussed below. Again, the leaves of the hierarchy are sorted by
163<i>Title</i> metadata. The fourth provides access by <i>Keyword</i> metadata:
164it also is a <i>Hierarchy classifer</i> (see below).\n
165
166<p>
167<b>Cover images</b>. Greenstone looks for a cover image for each document, whose name is the same as the document\'s but with a <i>.jpg</i>
168extension. This image is associated with the document, and may be displayed on the document page (see below). Cover images can be switched off by setting the -no_cover_image flag for each plugin. \n
169
170<p>
171<b>Format statements</b>. The next block contains five format statements. The
172first applies to <i>Vlists</i>. These are lists of items displayed vertically
173down the page, like the the lists displayed by the <i>titles</i> browser,
174those at the leaves of the <i>subject</i> and <i>organisation</i> hierarchies,
175and the tables of contents of the target documents themselves. However, for the
176search results page it is overridden by the second format statement
177(<i>SearchVList</i>). The third governs how the document text is formatted,
178with <i>Title</i> metadata ([<i>Title</i>]) in HTML &lt;<i>h3</i>&gt; format
179followed by the text of the document [<i>Text</i>]. The fourth ensures that
180cover images are shown with each document. The fifth calls for the <i>Expand
181Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with
182each document.\n
183
184<p>
185Most format statements contain a string specified in an augmented form of
186HTML. Metadata names in square brackets (e.g. [<i>Title</i>], [<i>Creator</i>])
187give the value of that metadata; [<i>Text</i>] gives the document text. A
188hyperlink to the document can be made using [<i>link</i>] ...[<i>/link</i>]; an
189appropriate icon is produced by [<i>icon</i>]. Format strings can include
190{<i>If</i>}{... , ...} and {<i>Or</i>}{... , ...}; the first two give
191examples. These two are fairly complex format statements; we will not explain
192them here. In Greenstone, changes in format strings take effect immediately
193unless you are using the local library server, in which case the server needs
194to be restarted. This makes it easy to experiment with different versions of a
195format statement and see what happens.\n
196
197<p>
198<b>Language translations</b>. The last part of the
199<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
200configuration file</a> gives the collection-level metadata in French and
201Spanish respectively. The languages are indicated by square brackets:
202[<i>fr</i>] and [<i>es</i>]. If there is no language specification, English is
203assumed by default. The configuration file shows accented characters
204(e.g. French <i>é</i>). This file is in UTF-8, and these characters are
205represented by multi-byte sequences (&lt;C3&gt;&lt;A9&gt; in this
206case). Alternatively they could be represented by their HTML entity names (like
207<i>&amp;eacute</i>). It makes no difference: they look the same on the
208screen. However, if the text were <i>searchable</i> it would make a difference;
209Greenstone uses Unicode internally to ensure that searching works as expected
210for non-English languages.\n
211
212<p>
213<b>Description tags</b>. The description tags recognized by <i>HTMLPlug</i>
214are inserted into the HTML source text of the documents to define where
215sections begin and end, and to specify section titles. They look like this:
216<pre>
217&lt;!--\n
218&lt;Section&gt;\n
219&lt;Description&gt;\n
220&lt;Metadata name=\"Title\"&gt;\n
221Realizing human rights for poor people: Strategies\n
222for achieving the international development targets\n
223&lt;/Metadata&gt;\n
224&lt;/Description&gt;\n
225--&gt;\n
226(text of section goes here)\n
227&lt;!--\n
228&lt;/Section&gt;\n
229-->\n
230</pre>
231The &lt;!-- ... --&gt; markers are used to ensure that these tags are marked as
232comments in HTML and therefore do not affect document formatting. In the
233<i>Description</i> part other kinds of metadata can be specified, but this is
234not done for the style of collection we are describing here. Exactly the same
235specification (including the &lt;!-- ... --&gt markers) can be used in Word
236documents too.\n
237
238<p>
239<b>Metadata Files</b>. Metadata for all documents in the DLS collection
240is provided in metadata.xml files, one per document folder.
241The <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> file for one book -- <i>Go Between 64, June-July 1997</i>
242-- is a block of about ten lines encased in &lt;<i>FileSet</i>&gt; ...
243&lt;<i>/FileSet</i>&gt; tags. It defines
244<i>Title</i>, <i>Language</i>, <i>Subject</i> and <i>AZList</i> metadata. More
245than one value can be specified for any metadata item. For example, a little
246further down the file (in the fourth <i>FileSet</i> block) is a book called
247<i>Animation skills</i> which has two values for <i>Subject</i>. Both of these
248are stored as metadata values for this particular document (because
249<i>mode=accumulate</i> is specified; the alternative, and the default, is
250<i>mode=override</i>).\n
251
252<p>
253<i>Title</i> metadata is specified in the metadata file. However, in this
254collection it is also given in the text of each document, using description
255tags. Since it appears in both places, Greenstone uses the version defined
256in the documents in preference to that in the <i>metadata.xml</i> file.\n
257
258<p><b>Hierarchy files</b>. The subject hierarchy file <a
259href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> contains a
260succession of lines each of which has three items. The first and last items
261are text strings, and they are the same. The middle item is a number that
262defines the position in the hierarchy. The first string is matched against the
263metadata that occurs in the <i>metadata.xml</i> file described above; the last
264one is the string that describes that node of the hierarchy on the web pages
265that Greenstone generates.\n
266
267<p>
268For example, the first line contains the three items \"Industry, Manufacture
269and Services\", 1, and \"Industry, Manufacture and Services\". The middle one,
270the numeral 1, indicates that this subject appears at the first position of the
271<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1\">subject hierarchy</a>).
272The first item, the string \"Industry, Manufacture and Services\", is what appears in
273the <a href=\"_httpcollection_/import/t0021e/metadata.xml\" target=text>metadata.xml</a> file
274as <i>Subject</i> metadata. The third item, which happens to be the same string,
275is what appears as the text in the first position of the subject hierarchy.
276
277<p>
278The organization hierarchy file
279<a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a>
280has exactly the same structure. Again, the first and last text strings on each
281line are the same because the metadata values in <i>metadata.xml</i> are
282exactly what should be shown on the Greenstone web pages. The number between
283defines the position in the hierarchy: in this case the hierarchy is flat and
284the position is simply an integer that determines the order of the list.\n
285
286<p>
287The <i>Keyword</i> classifier is also a hierarchy classifier, in this case
288based on <i>Keyword</i> metadata. This is to allow for the possibility that two
289different documents have the same keyword.\n
290"
291
292# -- French text ----------------
293collectionmeta collectionextra [l=fr] "Les BibliothÚques humanitaires pour le
294Développement constituent une collection importante dont les objectifs sont
295d\'aider à réduire la pauvreté, de promouvoir l\'accroissement du
296potentiel humain, et d\'offrir une éducation pratique et utile à tous.
297Cette collection contient environ 25 publications -- documents, rapports, et
298articles de périodiques -- qui traitent de différents sujets liés au
299développement humain. On y trouve des informations concernant les pratiques
300agricoles aussi bien que les politiques économiques; les mesures d\'hygiÚne
301pour l\'eau et la société et la culture; l\'éducation et la petite
302industrie; la prévention des désastres et les micro-entreprises.
303<p>
304Les éditeurs
305de cette collection sont Human Info NGO, HumanityCD Ltd, and organisations
306ayant contribué. Vous pouvez nous contacter à Humanitarian and Development
307Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
30832-3-448.05.54, Fax 32-3-449.75.74, courriel <a
309href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.
310
311<h3>Comment, marche la collection</h3>
312
313<p>
314La collection DLS est assez
315complexe. Pour un débutant, il serait préférable de consulter d\'abord d\'autres collections
316(par exemple <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Démonstration Word et PDF</a> ou les <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Greenstone Archives</a> ou la collection <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">Simple Image</a>).
317
318<p>
319Le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration</a> de la collection, comme tous les fichiers de configuration de collection, commence avec une ligne (\"creator\") qui donne l\'adresse e-mail du créateur de la collection et une autre ligne (\"public\") qui détermine la maniÚre d\'apparition de la collection sur la page d\'accueil de Greenstone.
320
321<p>
322<b>Méta-données de niveau collection</b>. Les lignes <i>collectionmeta </i> dans le fichier de configuration sont aussi standard dans toutes les collections Greenstone.
323Elles donnent une information générale sur la collection par la définition de son nom, et par une description qui apparaît sur la page d\'accueil. La description (dans <i>collectionextra</i>) peut être vue sur la page
324d\'accueil de la collection (_text2_).
325
326<p>
327<b>Plugins</b>. Le troisiÚme bloc de lignes dans le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration</a> donne les plugins utilisés par cette collection. Les documents dans la collection DLS sont en HTML, ainsi <i>HTMLPlug</i> doit être inclus. L\'option <i>description_tags</i> traite des onglets dans le texte qui définissent les sections et les titres de section comme décrit ci-dessous.
328
329<p>
330Les autres plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin et DirectoryPlugin</i> sont utilisés par Greenstone pour des objectifs internes et sont des références dans presque toutes les collections.
331
332<p>
333<b>Index recherchables</b>. Le bloc de lignes qui commence avec <i>index</i>
334précise les type d\'index de recherche disponibles. Dans cette collection on en compte trois. Vous pouvez les voir en déroulant le menu \"Rechercher des\" sur la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>. Le premier index est appelé \"chapitre\" , le second \"titres de section\" et le troisiÚme \"documents entiers\". Les noms de ces trois index sont donnés par les trois déclarations <i>collectionmeta</i>.
335
336<p>
337Les contenus des trois index, à savoir la spécification de ce qui sera recherché, sont définies
338par la ligne des <i>index</i> au début de ce bloc. Trois index sont spécifiés, deux au niveau section (commençant par <i>section:</i>) et un autre au niveau document (commençant par <i>document:</i>.) La différence est qu\'une requête à mots multiples ne conviendra qu\'à un index de niveau section si tous les termes recherchés se trouvent dans la même section, tandis qu\'elle conviendra à un index de niveau document si les termes apparaissent n\'importe où dans le document
339(qui typiquement, comprend plusieurs sections). Le premier et le troisiÚme index sont
340<i>section:text</i> et <i>document:text</i>, et <i>:text</i> signifie que le texte complet des sections et celui des documents seront respectivement recherchés. Le second est <i>section:Title</i>, qui signifie que la méta-donnée <i>Title</i> sera recherchée -- dans ce cas, les titres de section (plutÎt que les titres de document). Les trois index apparaissent dans l\'ordre dans lequel ils sont précisés sur la ligne <i>indexes</i>.
341
342<p>
343<b>Classificateurs</b>. Le bloc de lignes libellé <i>classify</i> définit les index de navigation appelés \"classifiers\" dans Greenstone. Ils sont quatre, correspondant aux quatre boutons sur la barre de navigation en haut de chaque page dans la collection (c\'est à dire la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>): <i>thÚmes</i>, <i>titres</i>, <i>organisation</i> et <i>comment faire</i>. Le bouton de <i>recherche</i> vient en premier, les quatre classificateurs.
344
345<p>
346Le premier classificateur fournit un accÚs par sujet. C\'est un classificateur <i>Hierarchy</i> dont la hiérarchie est définie dans le fichier <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> (l\'argument \"<i>hfile</i>\"); ce fichier est présenté ci-dessous. Ce classificateur est basé sur la méta-donnée <i>Subject</i> et quand plusieurs livres apparaissent sur une feuille de la hiérarchie, ils sont triés suivant la méta-donnée <i>Title</i> (comme visible <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">ici</a>). Le second fournit un accÚs par titre: c\'est un classificateur <i>AZList</i> basé sur les méta-données <i>Title</i>. Le troisiÚme fournit un accÚs par organisation: c\'est un classificateur <i>Hierarchy</i> basé sur les méta-données <i>Organization</i> dont la hiérarchie est définie dans <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a>; ce fichier est présenté ci-dessous. De même, les feuilles de la hiérarchie sont triées suivant les meta-données <i>Title</i>. Le quatriÚme fournit un accÚs par méta-donnée <i>Keyword</i>: c\'est aussi un classificateur <i>Hierarchy</i> (voir ci-dessous).
347
348<p>
349<b>Images Couverture</b>. Greenstone cherche une image couverture pour chaque document, dont le nom est le même que le document\'s mais avec une extension <i>.jpg</i>. Cette image est associée avec le document et pourrais être visualisé sur la page du document (voir ce-dessous). Les images couverture peuvent-être éteintes en réglant le drapeau -no_cover_image pour chauqe plug-in. \n
350
351<p>
352<b>Déclarations de format</b>. Le bloc suivant contient cinq déclarations de format. La premiÚre s\'applique à <i>Vlists</i>. Ce sont des listes d\'articles affichés verticalement vers le bas de la page, comme les listes visualisées par le navigateur <i>titres</i>, celles qui sont sur les feuilles de hiérarchie <i>thÚmes</i> et <i>organisation</i>, et les tables des matiÚres des documents cibles eux-mêmes. Cependant, la page des résultats de recherche est écrasée par la seconde déclaration de format (<i>SearchVList</i>). La troisiÚme gouverne le formatage du texte du document avec des méta-données <i>Title</i> ([<i>Title</i>]) au format HTML &lt;<i>h3</i>&gt suivi du texte du document [<i>Text</i>]. La quatriÚme assure que les images de couverture
353sont affichées avec chaque document. La cinquiÚme exige que les boutons <i>Expand text</i>,
354<i>Expand contents</i>, <i>Detach</i> et <i>Highlight</i> soient affichés avec chaque document.
355
356
357<p>
358La plupart des déclarations de format contiennent une chaîne spécifiée en HTML mise en valeur.
359Les noms de méta-données entre crochets (c\'et à dire [<i>Title</i>], [<i>Creator</i>]), donne la valeur de ces méta-données; [<i>Text</i>] donne le document texte. Un hyperlien au document peut être obtenu en utilisant [<i>link</i>] ... [<i>/link</i>]; une icÎne appropriée est générée par [<i>icon</i>]. Des chaînes de format peuvent inclure {<i>If</i>} {...,...} et {<i>Or</i>} {...,...}; les deux premiÚres en donnent des exemples. Ces deux sont des déclarations de format assez complexes qui ne seront pas expliquées ici. Dans Greenstone, les changements dans les chaînes de format prennent effet immédiatement à moins que vous n\'utilisiez le serveur de la bibliothÚque locale, auquel cas, le serveur à besoin d\'être réinitialisé. Cela rend facile l\'expérimentation de versions différentes d\'une déclaration de format et de voir ce qui se passe.
360
361<p>
362<b>Traduction de langues</b>. La derniÚre partie du <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration de la collection</a> donne les méta-données de niveau collection en Français et en Espagnol respectivement. Les langues sont indiquées par des crochets:[<i>fr</i>] et [<i>es</i>]. Si aucune langue n\'est spécifiée, l\'Anglais est supposé par défaut. Le fichier de configuration montre des caractÚres mis en valeur (par exemple le \"<i>é</i>\" français). Ce fichier est en UTF-8, et ces caractÚres sont représentés par des séquences multi-octets (&lt;C3&gt;&lt;A9&gt) dans ce cas). Autrement, elles pourraient être représentées par leurs noms d\'entité (comme <i>&amp;eacute</i>). Cela ne présente aucune différence: ils sont identiques à l\'écran. Cependant si les textes faisaient l\'objet d\'une recherche, une différence aurait été notée; Greenstone utilise Unicode de façon interne pour s\'assurer que le processus de recherche fonctionne comme prévu pour les langues autre que l\'anglais.
363
364<p>
365<b>Etiquettes de description</b>. Les étiquettes de description identifiées par \"HTMLPlug\" sont insÚrées dans le texte source HTML des documents pour délimiter le début et la fin des sections et pour spécifier les titres de section. Ils se présentent comme suit:
366<pre>
367&lt;!--\n
368&lt;Section&gt;\n
369&lt;Description&gt;\n
370&lt;Metadata name=\"Title\"&gt;\n
371Realizing human rights for poor people: Strategies\n
372for achieving the international development targets\n
373&lt;/Metadata&gt;\n
374&lt;/Description&gt;\n
375--&gt;\n
376(text of section goes here)\n
377&lt;!--\n
378&lt;/Section&gt;\n
379-->\n
380</pre>
381Les marqueurs &lt;!-- ... --&gt; sont utilisés pour assurer que ces étiquettes sont indiquées comme
382commentaires dans HTML et par conséquent n\'ont aucun effet sur le formatage. Dans la partie
383<i>Description</i>, d\'autres types de méta-données peuvent être spécifiés mais ceci n\'est pas fait pour le style de collection décrit ici. La même spécification (y compris les marqueurs &lt;!-- ... --&gt;) peut être utilisée de façon tout à fait identique dans les documents Word.
384
385<p>
386<b>Fichiers de méta-données</b>. Les méta-données pour tous les documents de la collection DLS sont fournies dans le fichier metadata.xml. Le fichier <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> pour le livre--<i>Go Between 64, June-July 1997</i> --est un bloc de dix lignes comprises entre les étiquettes &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. Les méta-données pour tous les documents de la collection DLS sont
387fournies dans un fichier unique <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> du le répertoire import. L\'entrée pour le premier élément --le livre <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&d=HASH01a447a74ff648e6c09e0352\">Go Between 64, June-July 1997</a> --est un bloc de dix lignes comprises entre les étiquettes &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. <!-- end --> Elle définit les méta-données <i>Title</i>, <i>Language</i>, <i>Subject</i> et <i>AZlist</i>. Plus d\'une valeur peut être spécifiée pour n\'importe quel élément de méta-donnée. Par exemple, un peu plus bas dans le fichier (dans le quatriÚme bloc) il y a un livre appelé <i>Animation skills</i> qui a deux valeurs pour <i>Subject</i>. Toutes les deux sont enregistrées comme comme valeurs de méta-donnée pour ce document particulier (parce que <i>mode=accumulate</i> est spécifié; autrement, le défaut est <i>mode=override</i>).
388
389<p>
390La méta-donnée <i>Title</i> est spécifiée dans le fichier métadata. Cependant dans cette collection, elle est fournie dans le texte de chaque document, par le biais des étiquettes de description. Dans la mesure où elle apparaît en deux endroits, Greenstone utilise de préférence la version définie dans les documents plutÎt que celle présente dans le fichier <i>metadata.xml</i>.
391
392<p>
393<b>Fichiers d\'hiérarchie</b>. Le fichier d\'hiérarchie de sujet <a
394href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> contient
395une suite de lignes dont chacune a trois éléments. Le premier et le dernier élément sont
396des chaînes de textes, et ils sont identiques. L\'élément du milieu est un nombre qui définit la position dans la hiérarchie. La premiÚre chaîne est ajustée sur la méta-donnée qui intervient dans le fichier <i>metadata.xml</i> décrit ci-dessus; la derniÚre est la chaîne qui décrit le n\'ud de la
397hiérarchie sur les pages web que Greenstone génÚre.
398
399<p>
400Par exemple, la premiÚre ligne contient les trois éléments \"Industry, Manufacture, and Services\", 1, et \"Industry, Manufacture and Services\". Celui du milieu, le nombre 1, indique que ce sujet apparaît en premiÚre position de <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1\">subject Hierarchy</a>). Le premier élément, la chaîne \"Industry, Manufacture and Services\", apparaît dans le fichier <a href=\"_httpcollection_/import/t0021e/metadata.xml\" target=text>metadata.xml</a> comme méta-donnée <i>Subject</i>. Le troisiÚme élément qui se trouve être la même chaîne, apparaît dans le texte en premiÚre position de la hiérarchie de sujet.
401
402<p>
403Le fichier d\'hiérarchie d\'organisation <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a> a exactement la même structure. De nouveau, les premiÚres et derniÚres chaînes de texte sont les mêmes sur chaque ligne parce que les valeurs de méta-donnée dans <i>metadata.xml</i> sont exactement ce qui doit être affiché sur les pages d\'accueil de Greenstone. Le nombre intermédiaire définit la position dans la hiérarchie: dans ce cas-ci, la hiérarchie est plate et la position est tout simplement un entier qui détermine l\'ordre de la liste.
404
405<p>
406Le classificateur <i>Keyword</i> est aussi un classificateur de hiérarchie, basé dans ce cas-ci sur la méta-donnée <i>Keyword</i>. Ceci pour offrir la possibilité à deux documents différents d\'avoir le même mot-clé.
407"
408
409# -- Spanish text ----------------
410collectionmeta collectionextra [l=es] "
411Las Bibliotecas sobre Aspectos
412Humanitarios y de Desarrollo representan una extensa colecci&oacute;n de
413informaci&oacute;n pr&aacute;ctica cuyo prop&oacute;sito es ayudar a
414reducir la pobreza, acrecentar el potencial humano y proveer una
415educaci&oacute;n pr&aacute;ctica y &uacute;til para todos. Este subconjunto
416comprende unas 25 publicaciones - documentos, informes t&eacute;cnicos y
417art&iacute;culos de publicaciones peri&oacute;dicas - en varias
418&aacute;reas del desarrollo humano, desde pr&aacute;cticas agr&iacute;colas
419a pol&iacute;ticas econ&oacute;micas, desde agua y saneamiento a sociedad y
420cultura, desde educaci&oacute;n a manufactura, desde mitigaci&oacute;n de
421desastres a microemprendimientos.\n<p>\nLos editores de esta
422colecci&oacute;n son la ONG Human Info, HumanityCD Ltd y dem&aacute;s
423organizaciones participantes. Cont&aacute;ctenos en: Proyecto de
424Bibliotecas sobre Aspectos Humanitarios y de Desarrollo , Oosterveldiaan
425196, B-2610 Antwerp, B&eacute;lgica, Tel 32-3-448.05.54, Fax
42632-3-449.75.74, correo electr&oacute;nico <a
427href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.
428
429<h3>Cómo trabaja esta colección</h3>
430
431La colección DLS es bastante compleja. Si apenas está empezando a familiarizarse con su uso quizá fuera mejor que se fijara primero en alguna otra colección (como la <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Demostración en Word y PDF</a>, los <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Archivos Greenstone</a> o la <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">colección de imágenes sencillas</a>).
432<p>
433
434Al igual que todos los archivos de configuración de colecciones, el <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración de esta colección</a>, empieza con una línea (\"creador\") que proporciona la dirección de correo electrónico del creador de la colección y otra (\"pública\") que determina si la colección aparecerá en la página principal del programa Greenstone.
435<p>
436
437<b>Metadatos a nivel de colección</b>. Las líneas de <i>collectionmeta</i> en el archivo de configuración también son estándar en todas las colecciones Greenstone. Contienen información general acerca de la colección definiendo su nombre, y una descripción que aparece en su página inicial. La descripción (en <i>collectionextra</i>) se puede ver en la página inicial de la colección DLS (_text2_).
438<p>
439
440<b>Plugins</b>. El tercer bloque de líneas en el <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración</a> proporciona los plugins que usa esta colección. Los documentos en la colección DLS están en HTML, por lo que se deberá incluir <i>HTMLPlug</i>. La opción <i>description_tags</i> procesa las etiquetas en el texto que definen secciones y títulos de secciones tal como se describe a continuación.
441<p>
442
443Los otros plugins, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, y DirectoryPlugin, son empleados por Greenstone con fines particulares y son estándar en casi todas las colecciones.
444<p>
445
446<b>Índices de búsqueda</b>. El bloque de líneas que empieza con <i>índices</i> especifica los índices de búsqueda que están disponibles. En esta colección hay tres, los cuales se pueden ver al momento de desplegar el menú \"Buscar\" en la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">página de búsqueda</a>. El primer índice se llama \"capítulos\", el segundo \"títulos de sección\" y el tercero \"documentos enteros\". Los nombres de estos tres índices están dados por tres enunciados <i>collectionmeta</i>.
447<p>
448
449El contenido de los índices -- es decir, la especificación de lo que se va a buscar -- se define por medio de la línea que se encuentra al principio de este bloque. Esta especifica tres índices, dos a nivel de sección (los cuales empiezan con <i>section:</i>) y uno a nivel de documento (el cual empieza con <i>document:</i>). La diferencia está en que una consulta de varias palabras únicamente encontrará una correspondencia en un índice a nivel de sección si todos los términos de la consulta aparecen en la misma sección, mientras que encontrará la correspondencia en un índice a nivel de documento si los términos aparecen en cualquier parte del documento (el cual consiste normalmente de varias secciones). El primero y tercer índices son <i>section:text</i> y <i>document:text</i>, donde <i>:text</i> significa que se buscará en todo el texto de la sección o el documento, respectivamente. El segundo es <i>section:Title</i>, el cual indica que se buscarán metadatos de <i>Título</i>, en este caso títulos de secciones (más que títulos de documentos). Los tres índices aparecerán en el orden en que se especificaron en la línea de <i>índices</i>.
450<p>
451
452<b>Clasificadores</b>. El bloque de líneas con la etiqueta <i>clasificar</i> define los índices de exploración, llamados \"clasificadores\" en Greenstone. Hay cuatro de ellos correspondientes a los cuatro botones en la barra de navegación que se encuentra en la parte superior de cada página de la colección (p. ej. la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">página de búsqueda</a>): <i>asuntos, títulos de la \"a\" a la \"z\", organizaciones y palabras clave</i>. El botón de <i>búsqueda</i> aparece primero y a continuación los cuatro clasificadores en orden.
453<p>
454
455El primer clasificador le da acceso al asunto. Es un clasificador <i>de Jerarquía</i>, el cual se define en el archivo <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> (el argumento <i>hfile</i>); este archivo se describe más adelante. El clasificador se basa en el metadato <i>Sujeto</i> y cuando varios libros aparecen en una hoja de la jerarquía se ordenan por medio del metadato <i>Título</i> (como se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">aquí</a>). El segundo le da acceso al título. Es un clasificador <i>AZList</i> basado en el metadato <i>Título</i>. El tercero le da acceso a la organización. Es un clasificador <i>de Jerarquía</i> basado en el metadato Organización, cuya jerarquía se define en <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a>; este archivo se describe más adelante. Nuevamente, las hojas de la jerarquía se ordenan por medio del metadato <i>Título</i>. El cuarto le da acceso por medio del metadato de <i>palabra clave</i>. También es un <i>clasificador de Jerarquía</i> (véase más adelante).
456<p>
457
458<p>
459<b>Imágenes de Portada</b>. Greenstone buscar una imágen de portada para cada documento cuyo nombre sea el mismo al documento pero con una extensión <i>.jpg</i>. Esta imágen está asociada con el documento, y puede ser mostrada en la página del documento (ver aqui abajo). Las imágenes de portada pueden ser apagadas al ajustar el -no_imágen_de_portada para cada entrada. \n
460
461
462<b>Enunciados de formato</b>. El siguiente bloque contiene cinco enunciados de formato. El primero es aplicable a las <i>Vlists</i>. Éstas son listas de ítems que se despliegan verticalmente en la página, al igual que las listas desplegadas por el explorador de <i>títulos de la \"a\" a la \"z\"</i>, las que se encuentran en el último nodo de las jerarquías de <i>asunto y organización</i>, y las tablas de contenidos de los documentos mismos. Sin embargo, para la página de resultados de la búsqueda el segundo enunciado de formato (<i>SearchVList</i>) tiene la preferencia. El tercero rige la forma en que el texto del documento se formatea, con el metadato <i>Título</i> ([<i>Title</i>]) en formato HTML &lt;<i>h3</i>&gt;, seguido por el texto del documento [<i>Text</i>]. El cuarto asegura que las imágenes de la portada aparezcan con cada documento. El quinto hace que los botones <i>Extender Texto, Extender Contenido, Separar y Resaltar</i> aparezcan con cada documento.
463<p>
464
465La mayoría de los enunciados de formato contienen una cadena escrita en una forma aumentada de HTML. Los nombres de los metadatos entre corchetes (p. ej. [<i>Title</i>], [<i>Creator</i>]) dan el valor de dicho metadato. [<i>Text</i>] da el texto del documento. También se puede establecer un hipervínculo con el documento por medio de [link] ...[/link]. Un icono apropiado es producido por [<i>icon</i>]. Las cadenas de formato pueden incluir {<i>If</i>}{... , ...} y {<i>Or</i>}{... , ...}. Los primeros dos contienen ejemplos. Estos dos son enunciados de formato demasiado complejos, por lo que no los explicaremos aquí. En Greenstone los cambios en las cadenas de formato tienen efecto inmediatamente a menos que se esté usando el servidor local, en cuyo caso el servidor necesitará reiniciarse. Esto hace que sea fácil experimentar con diferentes versiones de un enunciado de formato y ver qué pasa.
466<p>
467
468<b>Traducción de idioma</b>. La última parte del <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración de la colección</a> proporciona los metadatos a nivel de colección en francés y español, respectivamente. Estos idiomas se indican por medio de corchetes: [<i>fr</i>] y [<i>es</i>]. Si no hay ninguna especificación del idioma, entonces el inglés se asume por omisión. El archivo de configuración muestra los caracteres que se acentúan (p. ej. la é francesa). Este archivo está en UTF-8 y los caracteres se representan por medio de secuencias de varios bytes (&lt;C3&gt;&lt;A9&gt; en este caso). De forma alternativa se pueden representar por medio de nombres de entes HTML (como &amp;eacute). No hay ninguna diferencia y se ven igual en la pantalla. Sin embargo, esto sí representaría una diferencia en el caso de que el texto se buscara. Greenstone utiliza Unicode internamente para asegurarse que las búsquedas trabajen tal como se espera con idiomas diferentes al inglés.
469<p>
470
471<b>Etiquetas de descripción</b>. Las etiquetas de descripción reconocidas por <i>HTMLPlug</i> se insertan en el texto fuente HTML de los documentos para definir el lugar en el que las secciones empiezan y terminan y para especificar los títulos de sección. Se ven de la siguiente manera:
472<p>
473
474<pre>
475&lt;!--\n
476&lt;Section&gt;\n
477&lt;Description&gt;\n
478&lt;Metadata name=\"Title\"&gt;\n
479Haciendo realidad los derechos humanos para la gente pobre: Estrategias\n
480para lograr los objetivos de desarrollo mundial\n
481&lt;/Metadata&gt;\n
482&lt;/Description&gt;\n
483--&gt;\n
484(el texto de la sección va aquí)\n
485&lt;!--\n
486&lt;/Section&gt;\n
487-->\n
488</pre>
489<p>
490
491Los marcadores &lt;!-- ... --&gt se utilizan para asegurarse que estas etiquetas estén marcadas como comentarios en HTML y por lo tanto que no afecten el formato del documento. En la parte de <i>Descripción</i> se pueden especificar otros tipos de metadatos, pero esto no se hace para el estilo de colección que estamos describiendo aquí. Exactamente la misma especificación (incluyendo los marcadores &lt;!-- ... --&gt) se puede usar también en los documentos Word.
492<p>
493
494<b>Archivos de metadatos</b>. Los metadatos para todos los documentos de la colección DLS se proporcionan en documentos metadata.xml, un documento por folder. El documento <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> para el libro--<i>Go Between 64, June-July 1997 </i> -- es un bloque de alrededor diez lineas encerradas en las etiquetas &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. Los metadatos para todos los documentos de la colección DLS se proporcionan en un solo archivo <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> que se encuentra en el directorio importar. La entrada para el primer ítem -- el libro <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&d=HASH01a447a74ff648e6c09e0352\">Go Between 64, June-July 1997</a> -- es un bloque de aproximadamente diez líneas enmarcado por las etiquetas &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;, <!-- end-->el cual define los metadatos <i>Título, Idioma, Asunto y AZList</i>. Se puede especificar más de un valor para cualquier ítem del metadato. Por ejemplo, un poco más adelante en el archivo (en el cuarto bloque <i>FileSet</i>) se encuentra un libro llamado <i>Animation skills</i> que tiene dos valores para el Asunto. Ambos se almacenan como valores del metadato para este documento en particular (ya que se especifica <i>mode=accumulate</i>; la alternativa y el valor por omisión es <i>mode=override</i>).
495<p>
496
497El metadato de <i>Título</i> se especifica en el archivo de metadatos. Sin embargo, en esta colección también se da en el texto de cada documento por medio de etiquetas de descripción. Puesto que aparece en ambos lugares, Greenstone utiliza de preferencia la versión definida en los documentos en vez de la que se encuentra en el archivo <i>metadata.xml</i>.
498<p>
499
500<b>Archivos de jerarquía</b>. El archivo de jerarquía del asunto <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> contiene una serie de líneas cada una de las cuales tiene tres ítems. El primero y último son cadenas de texto y son iguales. El ítem intermedio es un número que define la posición en la jerarquía. La primer cadena corresponde al metadato que ocurre en el archivo <i>metadata.xml</i> que se describe arriba, mientras que la última describe el nodo de la jerarquía en las páginas Web que Greenstone genera.
501<p>
502
503Por ejemplo, la primera línea contiene los tres ítems \"Industria, Manufactura y Servicios\", 1 y finalmente \"Industria, Manufactura y Servicios\". El ítem intermedio con el numeral 1 indica que este asunto aparece en la primera posición de la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1\">jerarquía de asunto</a>. El primer ítem con la cadena \"Industria, Manufactura y Servicios\" es lo que aparece en el archivo <a href=\"_httpcollection_/import/t0021e/metadata.xml\" target=text>metadata.xml</a> como <i>Asunto</i>. El tercer ítem es el mismo y es lo que aparece como texto en la primera posición de la jerarquía del asunto.
504<p>
505
506El archivo de jerarquía de la organización <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a> tiene exactamente la misma estructura. Nuevamente la primera y última cadena de texto en cada línea son las mismas, ya que los valores de los metadatos que se encuentran en <i>metadata.xml</i> son exactamente lo que se va a mostrar en las páginas Web de Greenstone. El número entre ambas define la posición en la jerarquía: en este caso la jerarquía es plana y la posición es simplemente un número entero que determina el orden de la lista.
507<p>
508
509El clasificador de <i>Palabras Clave</i> también es un clasificador de jerarquía, en este caso basado en el metadato <i>Palabra Clave</i>. Esto permite la posibilidad de que dos documentos diferentes tengan la misma palabra clave.
510"
511
512# -- Russian text ----------------
513collectionmeta collectionextra [l=ru] "
514БОблОПтекО гуЌаМОтарМПгП развОтОя преЎставляют бПльшую кПллекцОю практОческПй ОМфПрЌацОО, пПлезМПй прО ПказаМОО пПЌПщО Ўля уЌеМьшеМОя беЎМПстО, увелОчеМОя гуЌаМОтарМПгП пПтеМцОала, а также ПбеспечеМОя практОчМПгП О пПлезМПгП ПбразПваМОя Ўля всех
515. ЭтП пПЎЌМПжествП сПЎержОт прОблОзОтельМП 25 публОкацОй -- ЎПкуЌеМтПв, сППбщеМОй О перОПЎОческОх
516 статей -- в разлОчМых
517 Пбластях
518 челПвеческПгП развОтОя, Пт сельскПх
519ПзяйствеММПй практОкО ЎП экПМПЌОческПй пПлОтОкО, Пт вПЎы О ПчОсткО ЎП Пбщества О культуры, Пт ПбразПваМОя ЎП прПОзвПЎства, Пт уЌеМьшеМОя беЎствОй ЎП Ќалых
520 преЎпрОятОй.
521<p>
522
523ИзЎателО этПй кПллекцОО -- ГуЌаМОтарМая ОМфПрЌацОПММая МеправОтельствеММая ПргаМОзацОя Human Info NGO, Humanity CD Ltd, О ЎругОе сПтруЎМОчающОе ПргаМОзацОО. КПМтакты с МОЌО вПзЌПжМы через ПрПект гуЌаМОтарМых
524 О развОвающОх
525ся бОблОПтек: Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel 32-3-448.05.54, Fax 32-3-449.75.74, email <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.
526<p>
527
528<h3>Как рабПтает кПллекцОя</h3>
529<p>
530
531_text1_
532еслО Вы являетесь тПлькП МачОМающОЌ пПльзПвателеЌ, тП лучше вМачале ПзМакПЌОться с МекПтПрыЌО ЎругОЌО кПллекцОяЌО (МапрОЌер, с <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">msword О pdf ЎеЌПМстрацОяЌО</a> ОлО же с арх
533ОваЌО ОлО с прПстПй графОческПй кПллекцОей).
534<p>
535
536<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл</a> кПллекцОО, пПЎПбМП всеЌ кПМфОгурацОПММыЌ файлаЌ ЎругОх
537 кПллекцОй, МачОМается сП стрПкО «СПзЎатель» (\"Сreator\"), кПтПрая сППбщает аЎрес электрПММПй пПчты СПзЎателя кПллекцОО, О ЎругПй -- «ПублОка» (\"Public\"), кПтПрая ПпреЎеляет, пПявОтся лО кПллекцОя Ма ЎПЌашМей страМОце устаМПвкО Greenstone.
538<p>
539
540<b>МетаЎаММые урПвМя кПллекцОО</b>. СтрПкО <i>collectionmeta</i> в кПМфОгурацОПММПЌ файле также стаМЎартМы вП всех
541 кПллекцОях
542 Greenstone. ОМО Ўают Пбщую ОМфПрЌацОю П кПллекцОО, ПпреЎеляя ее МазваМОе (ОЌя), преЎставляют краткПе ПпОсаМОе, кПтПрПе пПявляется Ма ее ЎПЌашМей страМОце. КраткПе ПпОсаМОе (в <i>collectionextra</i>) ЌПжМП вОЎеть Ма ЎПЌашМей страМОце кПллекцОО (_text2_)
543<p>
544
545
546<b>ПлагОМы</b>. ТретОй блПк стрПк в кПМфОгурацОПММПЌ файле преЎставляет плагОМы, ОспПльзуеЌые кПллекцОей. ДПкуЌеМты в кПллекцОО DLS преЎставлеМы в HTML-фПрЌате, так чтП <i>HTMLPlug</i> ЎПлжеМ быть включеМ. ОпцОя <i>description_tags</i> Пбрабатывает тэгО (прОзМакО) в тексте, кПтПрые ПпреЎеляют разЎелы О МаОЌеМПваМОя разЎелПв, как ПпОсаМП МОже.
547<p>
548
549ДругОе плагОМы <i>GreenstoneXMLPlugin</i>, <i>MetadataXMLPlugin</i>,<i>ArchivesInfPlugin</i> О <i>DirectoryPlugin</i> ОспПльзуются в Greenstone Ўля вМутреММОх
550 целей О являются стаМЎартМыЌО пПчтО вП всех
551 кПллекцОях
552.
553<p>
554
555<b>ИМЎексы пПОска</b>. БлПк стрПк, МачОМающОйся с <i>indexes</i>, ПпреЎеляет, какОе пПОскПвые ОМЎексы буЎут ЎПступМы. В этПй кПллекцОО есть трО ОМЎекса. Вы ЌПжете Ох
556 вОЎеть в МОспаЎающеЌ ЌеМю «ППОск» Ма <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">страМОце пПОска</a>. Первый ОМЎекс Мазывается «Главы», втПрПй -- «НазваМОя разЎелПв» О третОй -- «ППлМые ЎПкуЌеМты». НазваМОя этОх
557 трех
558 ОМЎексПв Ўаются треЌя ПператПраЌО <i>collectionmeta</i>.
559<p>
560
561СПЎержаМОе ОМЎексПв -- тП есть ПпОсаМОе тПгП, чтП буЎет являться преЎЌетПЌ пПОска -- ПпреЎеляется стрПкПй <i>indexes</i> в Мачале этПгП блПка. ОМа ПпреЎеляет трО ОМЎекса, Ўва Оз МОх
562 -- Ма урПвМе разЎела (МачОМающОеся с <i>section:</i>) О ПЎОМ Ма урПвМе ЎПкуЌеМта (МачОМающОйся с <i>document:</i>). РазлОчОе сПстПОт в тПЌ, чтП запрПс, сПстПящОй Оз МескПлькОх
563 слПв, буЎет сППтветствПвать тПлькП ОМЎексу урПвМя разЎела, еслО все терЌОМы запрПса пПявляются в тПЌ же саЌПЌ разЎеле, тПгЎа как ПМ буЎет сППтветствПвать урПвМю ЎПкуЌеМта, еслО терЌОМы пПявляются гЎе-лОбП в преЎелах
564 ЎПкуЌеМта, кПтПрый ПбычМП включает МескПлькП разЎелПв. Первый О третОй ОМЎексы -- этП <i>section:text</i> О <i>document:text</i>, гЎе <i>:text</i> ПзМачает, чтП пПлМый текст разЎелПв О ЎПкуЌеМтПв сППтветствеММП буЎет преЎЌетПЌ пПОска. ВтПрПй ОМЎекс -- <i>section:Title</i> ПзМачает, чтП ЌетаЎаММые НазваМОя (<i>Title</i>) буЎут пПЎвергМуты пПОску. В этПЌ случае МазваМОя разЎелПв скПрее, чеЌ МазваМОя ЎПкуЌеМтПв. ЭтО трО ОМЎекса пПявляются в пПряЎке, в кПтПрПЌ ПМО ПпреЎелеМы в стрПке <i>indexes</i>.
565<p>
566
567<b>КлассОфОкатПры</b>. БлПк стрПк, пПЌечеММых
568 <i>classify</i>, ПпреЎеляющОе ОМЎексы прПсЌПтра, в Greenstone Мазываются КлассОфОкатПраЌО. ИЌеется четыре классОфОкатПра, сППтветствующОе четыреЌ кМПпкаЌ Ма МавОгацОПММПй лОМейке Маверх
569у кажЎПй страМОцы в кПллекцОО (МапрОЌер, <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">пПОскПвая страМОца</a>): <i>ПреЎЌеты, НазваМОя, ОргаМОзацОО О Ключевые слПва</i>. ПервПй является кМПпка пПОска, а затеЌ пП пПряЎку этО четыре классОфОкатПра.
570<p>
571
572Первый классОфОкатПр ПбеспечОвает ЎПступ к преЎЌетаЌ. ЭтП Оерарх
573ОческОй классОфОкатПр, кПтПрый ПпреЎеляет Оерарх
574Ою в файле <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> (параЌетр <i>hfile</i>); этПт файл ПбсужЎается МОже. ЭтПт классОфОкатПр базОруется Ма ЌетаЎаММых
575 <i>ПреЎЌета</i>. КПгЎа МескПлькП кМОг пПявляются в лОсте Оерарх
576ОО, ПМО сПртОруются с пПЌПщью ЌетаЎаММых
577 <i>НазваМОя</i> (как Вы ЌПжете вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">зЎесь</a>). ВтПрПй классОфОкатПр ПбеспечОвает ЎПступ к МазваМОяЌ: этП классОфОкатПр <i>AZList</i>, базОрующОйся Ма ЌетаЎаММых
578 <i>НазваМОя</i>. ТретОй ПбеспечОвает ЎПступ к перечМю ПргаМОзацОй: этП Оерарх
579ОческОй классОфОкатПр, ОспПльзующОй ЌетаЎаММые <i>ОргаМОзацОО</i>, Оерарх
580Оя кПтПрых
581 заЎаМа в <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a>; этПт файл ПбсужЎается МОже. Еще раз лОстья Оерарх
582ОО сПртОруются пП ЌетаЎаММыЌ <i>НазваМОя</i>. Четвертый ПбеспечОвает ЎПступ к ЌетаЎаММыЌ <i>Ключевых
583 слПв</i>. ЭтП также Оерарх
584ОческОй классОфОкатПр (сЌ. МОже).
585
586<p>
587<b>ИзПбражеМОя ПблПжкО</b>. ГрОМстПуМ Ощет ОзПбражеМОя ПблПжкО Ўля кажЎПгП ЎПкуЌеМта, чье ОЌя сПвпаЎает с МазваМОеЌ ЎПкуЌеМта, МП ОЌеет расшОреМОе <i>.jpg</i>. ЭтП ОзПбражеМОе ассПцООруется с ЎПкуЌеМтПЌ О ЌПжет быть ОспПльзПваться Ма страМОчке ЎПкуЌеМта (сЌПтрО МОже). ИзПбражеМОя ПблПжек ЌПжМП выключОть, ОспПльзуя флаг -no_cover_image в кажЎПЌ плагОМе. \n
588
589<p>
590<b>ОператПры фПрЌата</b>. СлеЎующОй блПк сПЎержОт пять ПператПрПв фПрЌата. Первый Оз МОх
591 Пбращается к <i>Vlist</i>. ЗЎесь ОЌеются спОскО пуМктПв, распПлПжеММых
592 вертОкальМП к МОзу таблОцы, пПЎПбМП тПЌу, как разЌещаются спОскО Ўля прПсЌПтра <i>НазваМОй</i>, так же, как О Оерарх
593ОческОе спОскО <i>ПреЎЌетПв О ОргаМОзацОй О ОглавлеМОй</i> саЌОх
594 целевых
595 ЎПкуЌеМтПв. ОЎМакП Ўля страМОцы результатПв пПОска этП ПтвергМутП втПрыЌ ПператПрПЌ фПрЌата (<i>SearchVList</i>). ТретОй управляет фПрЌатОрПваМОеЌ текста ЎПкуЌеМта с ЌетаЎаММыЌО <i>НазваМОя</i> (<i>Title</i>) в HTML &lt;<i>h3</i>&gt; фПрЌате, сПпрПвПжЎаеЌПЌ текстПЌ ЎПкуЌеМта [<i>Text</i>]. Четвертый гараМтОрует, чтП ОзПбражеМОя ПблПжек пПказываются с кажЎыЌ ЎПкуЌеМтПЌ. Пятый вызывает кМПпкО <i>РасшОреММый текст (Expand text), РасшОреММПе сПЎержаМОе (Expand Context), ОтЎелОть (Detach) О ППЎсвечОвать (Highlight)</i>, кПтПрые пПказываются с кажЎыЌ ЎПкуЌеМтПЌ.
596<p>
597
598БПльшОМствП ПператПрПв фПрЌата сПЎержат стрПку, указаММую в пПпПлМеММПй фПрЌе HTML. ИЌя ЌетаЎаММых
599 в кваЎратМых
600 скПбках
601 (МапрОЌер, [<i>НазваМОе</i>], [<i>СПзЎатель</i>]) Ўают зМачеМОя этОЌ ЌетаЎаММыЌ. [<i>Текст</i>] Ўает текст ЎПкуЌеМта. ГОперссылка к ЎПкуЌеМту ЌПжет быть сПзЎаМа, ОспПльзуя [<i>link</i>]...[<i>/link</i>]; сППтветствующее ОзПбражеМОе ПблПжкО прПОзвПЎОтся с пПЌПщью [<i>icon</i>]. СтрПкО фПрЌата ЌПгут включать {<i>If</i>} {...,...}О {<i>Or</i>} {...,...}; Ўля первых
602 Ўвух
603 Ўаются прОЌеры. ЭтО Ўва -- ЎПвПльМП слПжМые ПператПры фПрЌата. Мы Ме буЎеЌ ПбъясМять Ох
604 зЎесь. В Greenstone ОзЌеМеМОя в стрПках
605 фПрЌата вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете ЌестМый сервер бОблОПтекО, кПгЎа сервер ЎПлжеМ быть пПвтПрМП запущеМ. ЭтП ПблегчОт эксперОЌеМты с разлОчМыЌО версОяЌО ПператПра фПрЌата О МаблюЎеМОе за теЌ, чтП прО этПЌ прПОсх
606ПЎОт.
607<p>
608
609<b>ПеревПЎы с ПЎМПгП языка Ма ЎругПй</b>. ППслеЎМяя часть <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>кПМфОгурацОПММПгП файла</a> кПллекцОО преЎставляет ЌетаЎаММые Ма урПвМе кПллекцОО Ма фраМцузскПЌ О ОспаМскПЌ языках
610 сППтветствеММП. ЯзыкО ПбПзМачеМы в кваЎратМых
611 скПбках
612: [<i>fr</i>] О [<i>es</i>]. ЕслО Птсутствует указаМОе спецОфОкацОО языка, аМглОйскОй язык прОМят пП уЌПлчаМОю. КПМфОгурацОПММый файл пПказывает х
613арактерМые ПсПбеММПстО зМакПв (МапрОЌер, вП фраМцузскПЌ языке). ЭтПт файл Мах
614ПЎОтся в UTF-8, гЎе этО зМакО преЎставлеМы ЌультОбайтМыЌ пПряЎкПЌ слеЎПваМОя (&lt;C3&gt;&lt;A9&gt; в этПЌ случае). АльтерМатОвМП ПМО ЌПгут быть преЎставлеМы Ох
615 HTML МазваМОяЌО Пбъекта (пПЎПбМП <i>&amp;eacute</i>). В этПЌ Мет МОкакПгП разлОчОя: ПМО выгляЎят Ма экраМе ПЎОМакПвП. ОЎМакП, еслО бы текст был ЎПступеМ <i>Ўля пПОска</i>, тП разлОчОе ОЌелП бы ЌестП. Greenstone ОспПльзует вМутреММОй Unicode, чтПбы гараМтОрПвать вПзЌПжМПсть пПОска О Ўля МеаМглОйскОх
616 языкПв.
617<p>
618
619<b>ОпОсаМОе ЎескрОптПрПв</b>. ОпОсаМОе ЎескрОптПрПв, распПзМаваеЌых
620 <i>HTMLPlug</i>, вставлеМы в HTML текста ЎПкуЌеМтПв, чтПбы ПпреЎелОть, гЎе МачОМаются О закаМчОваются разЎелы, О ПпреЎелОть МазваМОя разЎелПв. ОМО выгляЎят такОЌ ПбразПЌ:
621<p>
622<pre>
623&lt;!--\n
624&lt;Section&gt;\n
625&lt;Description&gt;\n
626&lt;Metadata name=\"Title\"&gt;\n
627Realizing human rights for poor people: Strategies\n
628for achieving the international development targets\n
629&lt;/Metadata&gt;\n
630&lt;/Description&gt;\n
631--&gt;\n
632(текст разЎела ОЎет сюЎа)\n
633&lt;!--\n
634&lt;/Section&gt;\n
635-->\n
636</pre>
637<p>
638
639Маркеры &lt;!-...-&gt; ОспПльзуются, чтПбы гараМтОрПвать, чтП этО ЎескрОптПры ПтЌечеМы как кПЌЌеМтарОО в HTML О пПэтПЌу затрагОвают фПрЌатОрПваМОе ЎПкуЌеМта. В <i>ОпОсаМОО</i> ЌПгут быть ПпреЎелеМы ЎругОе вОЎы ЌетаЎаММых
640, МП этП Ме сЎелаМП Ўля стОля кПллекцОО, кПтПрую Ќы ПпОсываеЌ зЎесь. ТПчМП такая же спецОфОкацОя (включая О &lt;!-...-&gt; Ќаркеры) ЌПгут ОспПльзПваться также в ЎПкуЌеМтах
641 Word.
642<p>
643
644<b>Ѐайлы ЌетаЎаММых
645</b>. МетаЎаММые Ўля всех
646 ЎПкуЌеМтПв в DLS-кПллекцОО распПлПжеМы в файлах
647 metadata.xml, пП файлу в папке ЎПкуЌеМта. Ѐайл <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> Ўля кМОгО -- <i>Go Between 64, June-July 1997</i> -- преЎставляет сПбПй блПк Оз 10 стрПк заключеММых
648 в тэгах
649 &lt;<i>FileSet</i>&gt; ... &lt;<i>FileSet</i>&gt;. МетаЎаММые Ўля всех
650 ЎПкуЌеМтПв в DLS-кПллекцОО распПлПжеМы в файле <a href=\"_httpcollection_/import/ng064e/metadata.xml\" target=text>metadata.xml</a> в ЎОректПрОО ОЌпПрта. Вх
651ПЎ к первПЌу пуМкту - кМОге <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&d=HASH01a447a74ff648e6c09e0352\">Go Between 64, June-July 1997</a> -- является блПкПЌ Оз прОблОзОтельМП ЎесятО стрПк, заключеММых
652 в тэгах
653 </FileSet>. <!-- end-->ОМО ПпреЎеляют <i>НазваМОе, Язык, ПреЎЌет</i> О ЌетаЎаММые <i>AZList</i>. БПльше чеЌ ПЎМП зМачеМОе ЌПжет быть ПпреЎелеМП Ўля любых
654 пуМктПв ЌетаЎаММых
655. НапрОЌер, чуть Ўалее вМОз файла (в четвертПЌ блПке <i>FileSet</i> Мах
656ПЎОтся кМОга с МазваМОеЌ <i>НавыкО ЌультОплОкацОО</i>, кПтПрая ОЌеет Ўва зМачеМОя Ўля <i>ПреЎЌета</i>. Оба сПх
657раМеМы в качестве ЌетаЎаММых
658 Ўля этПгП спецОфОческПгП ЎПкуЌеМта, пПтПЌу чтП сПстПяМОе=МакаплОвать (<i>mode=accumulate</i>) ПпреЎелеМП, а в качестве альтерМатОвы - зМачеМОе пП уЌПлчаМОю, кПтПрыЌ является <i>mode=override</i>.
659<p>
660
661МетаЎаММые <i>НазваМОя</i> ПпреЎелеМы в файле ЌетаЎаММых
662. ОЎМакП, в ЎаММПй кПллекцОО ПМП также Ўается в тексте кажЎПгП ЎПкуЌеМта, ОспПльзуя тэгО ПпОсаМОя. Так ПМП пПявляется в Ўвух
663 Ќестах
664, пПскПльку Greenstone ОспПльзует версОю, ПпреЎелеММую в ЎПкуЌеМтах
665, преЎпПчтОтельМую пП ПтМПшеМОю к файлу <i>metadata.xml</i>.
666<p>
667
668<b>Иерарх
669ОческОе файлы</b>. ПреЎЌет Оерарх
670ОческПгП файла <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> сПЎержОт пПслеЎПвательМПсть стрПк, кажЎая Оз кПтПрых
671 ОЌеет трО пуМкта. Первый О пПслеЎМОй пуМкты являются текстПвыЌО стрПкаЌО О ПМО ПЎОМакПвы. СреЎМОй пуМкт является чОслПЌ, кПтПрПе ПпреЎеляет пПзОцОю в Оерарх
672ОО. Первая стрПка сППтветствует ЌетаЎаММыЌ, кПтПрые Мах
673ПЎятся в файле ,<i>metadata.xml</i>, ПпОсаММПЌ выше; пПслеЎМяя стрПка ПпОсывает тПт узел Оерарх
674ОО Ма web-страМОцах
675 сетО, кПтПрые геМерОрует Greenstone.
676<p>
677
678НапрОЌер, первая стрПка сПЎержОт трО пуМкта «ПрПЌышлеММПсть, ИзгПтПвлеМОе О УслугО», 1, О «ПрПЌышлеММПсть, ИзгПтПвлеМОе О УслугО». СреЎМОй пуМкт, цОфра 1, указывает, чтП этПт преЎЌет пПявляется Ма первПй пПзОцОО в <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1\">сОстеЌе Оерарх
679ОО</a>. Первый пуМкт, стрПка «ПрПЌышлеММПсть, ИзгПтПвлеМОе О УслугО» является теЌ, чтП пПявляется в файле <i>metadata.xml</i> как ЌетаЎаММые <i>ПреЎЌета</i>. ТретОй пуМкт, кПтПрый преЎставлеМ аМалПгОчМПй стрПкПй, - этП тП, чтП пПявляется в вОЎе текста в первПй пПзОцОО преЎЌета Оерарх
680ОО.
681<p>
682
683Ѐайл ПргаМОзацОО Оерарх
684ОО <a href=\"_httpcollection_/etc/dls.Organization.txt\" target=text>dls.Organization.txt</a> ОЌеет тПчМП такую же структуру. Так же, первые О пПслеЎМОе стрПкО текста Ма кажЎПй лОМОО те же саЌые, пПтПЌу чтП зМачеМОя ЌетаЎаММых
685 в <i>metadata.xml</i> -- тПчМП те же, чтП ЎПлжМы быть пПказаМы Ма web-страМОцах
686 Greenstone. ЧОслП ЌежЎу этОЌО стрПкаЌО ПпреЎеляет пПзОцОю в Оерарх
687ОО: в этПЌ случае Оерарх
688Оя является плПскПй, О пПзОцОя -- прПстП целПе чОслП, кПтПрПе ПпреЎеляет пПряЎПк в спОске.
689<p>
690
691КлассОфОкатПр <i>КлючевПе слПвП</i> также является классОфОкатПрПЌ Оерарх
692ОО, в этПЌ случае ПсМПваММПЌ Ма ЌетаЎаММых
693 <i>КлючевПгП слПва</i>. ЭтП ЎПлжМП пПзвПлОть учесть вПзЌПжМПсть тПгП, чтП Ўва разлОчМых
694 ЎПкуЌеМта сПЎержат ПЎОМакПвПе ключевПе слПвП.
695"
Note: See TracBrowser for help on using the repository browser.