root/collections/documented-examples/trunk/dls-e/etc/collect.cfg @ 19786

Revision 19786, 76.7 KB (checked in by anna, 10 years ago)

display English text where translations are missing.

  • Property svn:executable set to *
Line 
1creator     greenstone@cs.waikato.ac.nz
2public      true
3
4buildtype   mg
5
6plugin  HTMLPlugin -input_encoding iso_8859_1 -description_tags -OIDtype dirname
7plugin  GreenstoneXMLPlugin
8plugin  MetadataXMLPlugin
9plugin  ArchivesInfPlugin
10plugin  DirectoryPlugin
11
12indexes     section:text section:Title document:text
13
14classify    Hierarchy -metadata "dls.Subject" -buttonname Subject -hfile dls.Subject.txt -sort dls.Title
15classify    Hierarchy -metadata dls.AZList -buttonname Title -hfile dls.AZList.txt -hlist_at_top -sort dls.Title
16classify    List -metadata dls.Organization -sort_leaf_nodes_using dls.Title -buttonname Organization -bookshelf_type always
17classify    List -metadata dls.Keyword -buttonname Howto -bookshelf_type never
18
19format VList "<td valign=top>[link][icon][/link]</td>
20<td valign=top>[highlight]{Or}{[dls.Title],[Title],Untitled}[/highlight]
21<i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages],
22<br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i>
23</td>"
24
25format SearchVList "<td valign=top>[link][icon][/link]</td>
26<td>{If}{[parent(All\': \'):Title],
27[parent(All\': \'):Title]:}
28[link][Title][/link]</td>"
29
30format CL4VList "<td valign=top>[link][dls.Keyword][/link]</td>"
31
32format DocumentText "<h3>[Title]</h3>\\n\\n<p>[Text]"
33format DocumentImages true
34format DocumentButtons "Expand Text|Expand Contents|Detach|Highlight"
35
36format HList "[link][highlight][ex.Title][/highlight][/link]"
37
38format DocumentHeading "{Or}{[parent(Top):Title],[Title],untitled}<br>"
39
40# -- English strings ----------------
41collectionmeta  collectionname [l=en] "Development Library Subset collection"
42
43collectionmeta  .section:text [l=en] "chapters"
44collectionmeta  .section:Title [l=en] "section titles"
45collectionmeta  .document:text [l=en] "entire documents"
46
47# -- French strings ----------------
48collectionmeta  collectionname [l=fr] "Sous-ensemble de la collection BibliothÚque de Développement"
49
50collectionmeta  .section:text [l=fr] "chapitres"
51collectionmeta  .section:Title [l=fr] "titres des sections"
52collectionmeta  .document:text [l=fr] "documents entiers"
53
54# -- Spanish strings ----------------
55collectionmeta  collectionname [l=es] "Subconjunto de la Biblioteca para el Desarrollo"
56
57collectionmeta  .section:text [l=es] "capítulos"
58collectionmeta  .section:Title [l=es] "títulos de las secciones"
59collectionmeta  .document:text [l=es] "documentos completos"
60
61# -- Russian strings ----------------
62collectionmeta  collectionname [l=ru] "СубкПллекцОя БОблОПтекО развОтОя"
63
64collectionmeta  .section:text [l=ru] "Главы"
65collectionmeta  .section:Title [l=ru] "НазваМОя разЎелПв"
66collectionmeta  .document:text [l=ru] "ППлМые ЎПкуЌеМты"
67
68# -- Simplified Chinese strings ----------------
69collectionmeta  collectionname [l=zh] "发展囟乊銆子銆藏"
70
71collectionmeta  .section:text [l=zh] "ç« "
72collectionmeta  .section:Title [l=zh] "节标题"
73collectionmeta  .document:text [l=zh] "敎䞪文档"
74
75# -- English text ----------------
76collectionmeta  collectionextra [l=en] "The Humanitarian Development Libraries
77represent a large collection of practical information aimed at helping
78reduce poverty, increasing human potential, and providing a practical and
79useful education for all. This subset contains about 25
80publications--documents, reports, and periodical articles--in various areas
81of human development, from agricultural practice to economic policies, from
82water and sanitation to society and culture, from education to
83manufacturing, from disaster mitigation to micro-enterprises.
84
85<p> The editors of this collection are Human Info NGO, HumanityCD Ltd, and
86participating organizations. Contact us at Humanitarian and Development
87Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
8832-3-448.05.54, Fax 32-3-449.75.74,
89email <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.\n
90
91<h3>How the collection works</h3>\n
92
93<p>
94The DLS collection is fairly complex. If you\'re
95just starting out you might prefer to look at some other
96collections first (e.g.
97<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Word and PDF demonstration</a>, or the
98<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Greenstone Archives</a>, or the
99<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">Simple Image collection</a>).\n
100
101<p>
102The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
103configuration file</a>, like all collection configuration files, begins with a
104line (\"creator\") that gives the email address of the collection\'s creator, and
105another (\"public\") that determines whether the collection will appear on the
106home page of the Greenstone installation. Note that setting \"public\" to \"false\" only removes it from the home page; it will still be accessible in the library to anyone that knows the URL (a=p&p=about&c=coll-shortname). \n
107
108<p>
109<b>Plugins</b>. The \"plugin\" lines in the
110<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>configuration file</a>
111give the plugins used by the collection. The documents in the DLS collection
112are in HTML, so <i>HTMLPlugin</i> must be included. The <i>description_tags</i>
113option processes tags in the text that define sections and section titles as
114described below. \n
115
116<p>
117The other plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, and DirectoryPlugin</i>, are used by Greenstone
118for internal purposes and are standard in almost all collections.
119
120<p>
121<b>Searchable indexes</b>. The block of lines starting with <i>indexes</i>
122specifies what searchable indexes will be available. In this collection there
123are three: you can see them when you pull down the \"Search for\" menu on the
124<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>.
125The first index is called \"chapters\", the second \"section titles\",
126and the third \"entire documents\". The names of these three indexes are given by
127three <i>collectionmeta</i> statements.\n
128
129<p>
130The contents of the indexes -- that is, the specification of what it is that
131will be searched -- are defined by the <i>indexes</i> line at the beginning of
132this block. This specifies three indexes, two at the section level (beginning
133with <i>section:</i>) and one at the document level (beginning with
134<i>document:</i>). The difference is that a multi-word query will only match a
135section-level index if all query terms appear in the same section, whereas it
136will match a document-level index if the terms appear anywhere within the
137document (which typically comprises several sections). The first and third
138indexes are <i>section:text</i> and <i>document:text</i>, and the <i>:text</i>
139means that the full text of sections and documents respectively will be
140searched. The second is <i>section:Title</i>, which means that <i>Title</i>
141metadata will be searched -- in this case, section titles (rather than document
142titles). The three indexes appear in the order in which they are specified on
143the <i>indexes</i> line.\n
144
145<p>
146<b>Classifiers</b>. The block of lines labeled <i>classify</i> define the
147browsing indexes, called \"classifiers\" in Greenstone. There are four of them,
148corresponding to four buttons on the navigation bar at the top of each page in
149the collection (e.g. the <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>):
150<i>subjects</i>, <i>titles</i>, <i>organisations</i>, and <i>howto</i>
151The <i>search</i> button comes first, then come the four classifiers, in order.\n
152
153<p>
154The first classifier provides access by subject. It is a <i>Hierarchy</i>
155classifier whose hierarchy is defined in the file
156<a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>
157(the <i>hfile</i> argument); this file is discussed below. This classifier is
158based on <i>dls.Subject</i> metadata, and when several books appear at a leaf of
159the hierarchy they are sorted by <i>dls.Title</i> metadata (as you can see
160<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">here</a>).
161
162The second classifier provides access by title. It is also a <i>Hierarchy</i> classifier, this time based on
163<i>dls.AZList</i> metadata, whose hierarchy is defined in <a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>. This file is discussed below.
164
165The third provides access by organization: it is a
166<i>List</i> classifier based on <i>dls.Organization</i> metadata. The <i>-bookshelf_type always</i> option creates a new bookshelf for each organization, even if only one document belongs to that category.
167
168The fourth provides access by \"Howto\" text: it is a <i>List</i> classifier based on <i>dls.Keyword</i> metadata. The <i>-bookshelf_type never</i> option prevents bookshelves being created even if two documents share the same keywords.
169
170<p>
171<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>
172extension. 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
173
174<p>
175<b>Format statements</b>. The lines beginning with <i>format</i>, called \"format statements\", govern how various parts of the collection should be displayed. The <i>VList</i> format statement applies to lists of items displayed vertically, such as the lists of titles, subjects and organisations, and the table of contents for the target documents. It is overridden for the search results list by the <i>SearchVList</i> format statement, and also for the <i>Howto</i> classifier by the <i>CL4VList</i> statement (CL4 specifies the fourth classifier).
176<p>
177The <i>DocumentText</i> statement 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>]. Setting the <i>DocumentImages</i> format statement to <i>true</i> ensures that cover images are shown with each document. The <i>DocumentButtons</i> statement calls for the <i>Expand
180Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with each document.
181
182<p>
183Most format statements contain a string specified in an augmented form of
184HTML. Metadata names in square brackets (e.g. [<i>Title</i>], [<i>Creator</i>])
185give the value of that metadata; [<i>Text</i>] gives the document text. A
186hyperlink to the document can be made using [<i>link</i>] ...[<i>/link</i>]; an
187appropriate icon is produced by [<i>icon</i>]. Format strings can include
188{<i>If</i>}{... , ...} and {<i>Or</i>}{... , ...}; the first two give
189examples. These two are fairly complex format statements; we will not explain
190them here. In Greenstone, changes in format strings take effect immediately
191unless you are using the local library server, in which case the server needs
192to be restarted. This makes it easy to experiment with different versions of a
193format statement and see what happens.\n
194
195
196<p>
197<b>Collection-level metadata</b>. The <i>collectionmeta</i> lines in the
198configuration file are also standard in all Greenstone collections. They give
199general information about the collection, defining its name, and a
200description that appears on its home page. The description (in <i>collectionextra</i>) can be
201seen on the DLS collection\'s home page (this text is part of it).\n
202
203
204<p>
205<b>Language translations</b>. The last part of the
206<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
207configuration file</a> gives the collection-level metadata in French and
208Spanish respectively. The languages are indicated by square brackets:
209[<i>fr</i>] and [<i>es</i>]. If there is no language specification, English is
210assumed by default. The configuration file shows accented characters
211(e.g. French <i>é</i>). This file is in UTF-8, and these characters are
212represented by multi-byte sequences (&lt;C3&gt;&lt;A9&gt; in this
213case). Alternatively they could be represented by their HTML entity names (like
214<i>&amp;eacute</i>). It makes no difference: they look the same on the
215screen. However, if the text were <i>searchable</i> it would make a difference;
216Greenstone uses Unicode internally to ensure that searching works as expected
217for non-English languages.\n
218
219<p>
220<b>Description tags</b>. The description tags recognized by <i>HTMLPlugin</i>
221are inserted into the HTML source text of the documents to define where
222sections begin and end, and to specify section titles. They look like this:
223<pre>
224&lt;!--\n
225&lt;Section&gt;\n
226&lt;Description&gt;\n
227&lt;Metadata name=\"Title\"&gt;\n
228Realizing human rights for poor people: Strategies\n
229for achieving the international development targets\n
230&lt;/Metadata&gt;\n
231&lt;/Description&gt;\n
232--&gt;\n
233(text of section goes here)\n
234&lt;!--\n
235&lt;/Section&gt;\n
236-->\n
237</pre>
238The &lt;!-- ... --&gt; markers are used to ensure that these tags are marked as
239comments in HTML and therefore do not affect document formatting. In the
240<i>Description</i> part other kinds of metadata can be specified, but this is
241not done for the style of collection we are describing here. Exactly the same
242specification (including the &lt;!-- ... --&gt markers) can be used in Word
243documents too.\n
244
245<p>
246<b>Metadata Files</b>. Metadata for all documents in the DLS collection
247is provided in metadata.xml files, one per document folder.
248The <a href=\"_httpcollection_/import/r0087e/metadata.xml\" target=text>metadata.xml</a> file for one book -- <i>Income generation and money management: training women as entrepreneurs</i>
249-- is a block of about ten lines encased in &lt;<i>FileSet</i>&gt; ...
250&lt;<i>/FileSet</i>&gt; tags. It defines
251<i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> and <i>dls.AZList</i> metadata. More
252than one value can be specified for any metadata item. For example, this book has two dls.Subject classifications. Both of these
253are stored as metadata values for this particular document (because
254<i>mode=accumulate</i> is specified; the alternative, and the default, is
255<i>mode=override</i>).\n
256
257<p><b>Hierarchy files</b>. Hierarchy files contain a
258succession of lines each of which has three items. The first item is a text string which is matched against the metadata that occurs in the <i>metadata.xml</i> file described above. The second item is a number that defines the position in the hierarchy. The third item is a text string that describes the node of the hierarchy on the web pages that Greenstone generates.
259<p>
260For example, the following shows three lines from the subject hierarchy file <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>.
261
262<pre>
263\"Animal Husbandry and Animal Product Processing\" 7 \"Animal Husbandry and Animal Product Processing\" \n
264\"Animal Husbandry and Animal Product Processing|Cattle\" 7.1 \"Cattle\" \n
265\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" 7.2 \"Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" \n
266</pre>
267
268<p>
269These three lines define one top level bookshelf (at position 7), titled \"Animal Husbandry and Animal Product Processing\", with two bookshelves underneath it, titled \"Cattle\" and \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\" respectively.
270<p>
271In this case, the first strings (and therefore the entries in metadata.xml files) contain the entire hierarchy values. Levels in the hierarchy are separated by \"|\". They could be used directly by a <i>Hierarchy</i> classifier without the use of the hierarchy file. However, then the entries would be ordered alphabetically, not in the special order defined by the file.
272<p>
273The <a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a> hierarchy file used by the titles classifier contains a similar structure. Ordinarily, a titles browser would use a <i>List</i> (or <i>AZList</i>) classifier. In this case, we want to predefine the A-Z groupings, and include a separate entry for periodicals, as can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">here</a>.
274"
275
276# -- French text ----------------
277collectionmeta  collectionextra [l=fr] "Les BibliothÚques humanitaires pour le
278Développement constituent une collection importante dont les objectifs sont
279d\'aider à réduire la pauvreté, de promouvoir l\'accroissement du
280potentiel humain, et d\'offrir une éducation pratique et utile à tous.
281Cette collection contient environ 25 publications -- documents, rapports, et
282articles de périodiques -- qui traitent de différents sujets liés au
283développement humain. On y trouve des informations concernant les pratiques
284agricoles aussi bien que les politiques économiques; les mesures d\'hygiÚne
285pour l\'eau et la société et la culture; l\'éducation et la petite
286industrie; la prévention des désastres et les micro-entreprises.
287<p>
288Les éditeurs
289de cette collection sont Human Info NGO, HumanityCD Ltd, and organisations
290ayant contribué. Vous pouvez nous contacter à Humanitarian and Development
291Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
29232-3-448.05.54, Fax 32-3-449.75.74, courriel <a
293href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.
294
295<h3>Comment, marche la collection</h3>
296
297<p>
298La collection DLS est assez
299complexe. Pour un débutant, il serait préférable de consulter d\'abord d\'autres collections
300(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>).
301
302<p>
303Le <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. Noter que paramétrer \"public\" à \"false\" ne supprime le lien vers la collection que sur la page d'accueil; la collection reste accessible via la bibliothÚque numérique à toute personne qui en connaît l'URL (a=p&p=about&c=nom-abrégé-collection).
304
305<p>
306<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 la liste des plugins utilisés par cette collection. Les documents dans la collection DLS sont en HTML, ainsi <i>HTMLPlugin</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.
307
308<p>
309Les 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.
310
311<p>
312<b>Index recherchables</b>. Le bloc de lignes qui commence avec <i>index</i>
313pré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>.
314
315<p>
316Les contenus des trois index, à savoir la spécification de ce qui sera recherché, sont définies
317par 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
318(qui typiquement, comprend plusieurs sections). Le premier et le troisiÚme index sont
319<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>.
320
321<p>
322<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>sujets</i>, <i>titres</i>, <i>organisations</i> et <i>comment</i>. Le bouton de <i>recherche</i> vient en premier, les quatre classificateurs.
323
324<p>
325Le 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>dls.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>dls.Title</i> (comme visible <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">ici</a>).
326
327Le second classificateur fournit un accÚs par titre. C'est aussi un classificateur de la <i>Hierarchy</i>, basé cette fois sur la métadonnée <i>dls.AZList</i>, dont la hiérarchie est définie dans le fichier <a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>. Ce fichier est décrit plus loin.
328
329Le troisiÚme fournit un accÚs par organisation: c\'est un classificateur <i>List</i> basé sur les méta-données <i>Organization</i>. L'option <i>-bookshelf_type always</i> crée une nouvelle étagÚre pour chaque organisation, même s'il n'existe qu'un seul document appartenant à cette catégorie.
330
331Le quatriÚme fournit un accÚs par \"Howto\" : c'est un classificateur <i>List</i> basé sur les métadonnées <i>dls.Keyword</i>. L'option <i>-bookshelf_type never</i> permet d'éviter la création des étagÚres même si deux documents ont les mêmes mots-clés.
332
333
334<p>
335<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
336
337<p>
338<b>Déclarations de format</b>. Les lignes commençant par <i>format</i>, appelées \"format statements\", déterminent la façon dont certaines parties de la collection seront affichées. Le format <i>VList</i> est appliqué aux listes d'éléments présentés verticalement, comme les listes de titres, de sujets ou d'organisations, et la table des matiÚres pour les documents cibles. Il est modifié pour les liste de résultats de recherche par le format <i>SearchVList</i>, ainsi que par le format <i>CL4VList</i> pour le classificateur <i>Howto</i> (CL4 détermine le quatriÚme classificateur).
339
340<p>
341L'enregistrement <i>DocumentText</i> détermine la façon de formater le document textuel, avec la métadonnée <i>Title</i> ([<i>Title</i>]) insérée dans la balise HTML &lt;<i>h3</i>&gt; suivie par le texte du document ([<i>Text</i>]). Positionner la variable <i>DocumentImages</i> sur <i>true</i> entraîne l'affichage des images de couverture pour chaque document. La variable <i>DocumentButtons</i> permet l'affichage des boutons <i>Expand Text, Expand Contents, Detach</i> et <i>Highlight</i> avec chaque document.
342
343
344<p>
345La plupart des déclarations de format contiennent une chaîne spécifiée en HTML mise en valeur.
346Les 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.
347
348<p>
349<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.
350Elles 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
351d\'accueil de la collection (ce texte en fait partie).
352
353<p>
354<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.
355
356<p>
357<b>Etiquettes de description</b>. Les étiquettes de description identifiées par \"HTMLPlugin\" 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:
358<pre>
359&lt;!--\n
360&lt;Section&gt;\n
361&lt;Description&gt;\n
362&lt;Metadata name=\"Title\"&gt;\n
363Realizing human rights for poor people: Strategies\n
364for achieving the international development targets\n
365&lt;/Metadata&gt;\n
366&lt;/Description&gt;\n
367--&gt;\n
368(text of section goes here)\n
369&lt;!--\n
370&lt;/Section&gt;\n
371-->\n
372</pre>
373Les marqueurs &lt;!-- ... --&gt; sont utilisés pour assurer que ces étiquettes sont indiquées comme
374commentaires dans HTML et par conséquent n\'ont aucun effet sur le formatage. Dans la partie
375<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.
376
377<p>
378<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/r0087e/metadata.xml\" target=text>metadata.xml</a> pour le livre--<i>Income generation and money management: training women as entrepreneurs</i> --est un bloc de dix lignes comprises entre les étiquettes &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. Elle définit les méta-données <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> et <i>dls.AZList</i>. Plus d\'une valeur peut être spécifiée pour n\'importe quel élément de méta-donnée. Par exemple, ce livre a deux classifications dls.Subject. 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>).
379
380<p>
381<b>Fichiers d\'hiérarchie</b>. Les fichiers de hiérarchie contiennent une succession de lignes qui comportent chacune trois éléments. Le premier élément est une chaîne de caractÚres pour laquelle une correspondance sera recherchée avec les métadonnées présentes dans le fichier <i>metadata.xml</i> décrit ci-dessus. Le second élément est un nombre qui détermine la position dans la hiérarchie. Le troisiÚme élément est une chaîne de caractÚres qui décrit le noeud de la hiérarchie sur les pages que Greenstone génÚre.
382
383<p>
384Par exemple, ce qui suit représente trois lignes du fichier <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> qui organise la hiérarchie des sujets.
385
386<pre>
387\"Animal Husbandry and Animal Product Processing\" 7 \"Animal Husbandry and Animal Product Processing\" \n
388\"Animal Husbandry and Animal Product Processing|Cattle\" 7.1 \"Cattle\" \n
389\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" 7.2 \"Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" \n
390</pre>
391
392<p>
393Ces trois lignes définissent une étagÚre située au plus haut niveau (à la position 7), intitulée  \"Animal Husbandry and Animal Product Processing\", contenant deux étagÚres, intitulées respectivement \"Cattle\" et \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\".
394
395<p>
396Dans ce cas, les premiÚres chaînes (et par conséquent les entrées dans le fichier metadata.xml) contiennent les valeurs de toute la hiérarchie. Les niveaux sont séparés dans la hiérarchie par \"|\". Elles peuvent être utilisées directement par un classificateur <i>Hierarchy</i>, sans passer par le fichier de hiérarchie. Cependant, les entrées seront ordonnées dans ce cas alphabétiquement, et non dans l'ordre défini dans le fichier.
397
398<p>
399Le fichier de hiérarchie <a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a> utilisé par le classificateur de titres obéit à une structure similaire. Normalement, un feuilletage des titres devrait utiliser un classificateur de <i>List</i> (ou de <i>AZList</i>). Dans ce cas, nous voulons prédéfinir les regroupements A-Z et inclure une entrée séparée pour les périodiques, comme cela se voit <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">ici</a>.
400"
401
402# -- Spanish text ----------------
403collectionmeta  collectionextra [l=es] "
404Las Bibliotecas sobre Aspectos
405Humanitarios y de Desarrollo representan una extensa colecci&oacute;n de
406informaci&oacute;n pr&aacute;ctica cuyo prop&oacute;sito es ayudar a
407reducir la pobreza, acrecentar el potencial humano y proveer una
408educaci&oacute;n pr&aacute;ctica y &uacute;til para todos. Este subconjunto
409comprende unas 25 publicaciones - documentos, informes t&eacute;cnicos y
410art&iacute;culos de publicaciones peri&oacute;dicas - en varias
411&aacute;reas del desarrollo humano, desde pr&aacute;cticas agr&iacute;colas
412a pol&iacute;ticas econ&oacute;micas, desde agua y saneamiento a sociedad y
413cultura, desde educaci&oacute;n a manufactura, desde mitigaci&oacute;n de
414desastres a microemprendimientos.\n<p>\nLos editores de esta
415colecci&oacute;n son la ONG Human Info, HumanityCD Ltd y dem&aacute;s
416organizaciones participantes. Cont&aacute;ctenos en: Proyecto de
417Bibliotecas sobre Aspectos Humanitarios y de Desarrollo , Oosterveldiaan
418196, B-2610 Antwerp, B&eacute;lgica, Tel 32-3-448.05.54, Fax
41932-3-449.75.74, correo electr&oacute;nico <a
420href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.
421
422<h3>Cómo trabaja esta colección</h3>
423
424La 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>).
425<p>
426
427Al 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. Note que configurando la opción \"public\" como \"false\" solo la quita de la página home, pero permanecerá accesible en la biblioteca para cualquiera que conozca la URL (a=p&p=about&c=coll-shortname).
428
429<p>
430
431<b>Plugins</b>. Las líneas \"plugin\" en el <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración</a> indican los plugins usados en la colección. Los documentos en la colección DLS están en HTML, por lo que se deberá incluir <i>HTMLPlugin</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.
432<p>
433
434Los otros plugins, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, y DirectoryPlugin, son empleados por Greenstone con fines particulares y son estándar en casi todas las colecciones.
435<p>
436
437<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>.
438<p>
439
440El 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>.
441<p>
442
443<b>Clasificadores</b>. El bloque de líneas con la etiqueta <i>classifier</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>temas, títulos, organización</i> y <i>cómo</i>. El botón de <i>búsqueda</i> aparece primero y a continuación los cuatro clasificadores en orden.
444<p>
445
446El primer clasificador le da acceso al asunto. Es un clasificador <i>Hierarchy</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>dls.Subject</i> y cuando varios libros aparecen en una hoja de la jerarquía se ordenan por medio del metadato <i>dls.Title</i> (como se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">aquí</a>).
447
448El segundo clasificador provee acceso por título. Es un clasificador <i>Hierarchy</i> también, pero esta vez basado en el metadato <i>dls.AZList</i>, cuya jerarquía está definida en <a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>. Este archivo se describe abajo.
449
450El tercero le da acceso a la organización. Es un clasificador <i>List</i> basado en el metadato <i>dls.Organization</i>. La opción <i>-bookshelf_type always</i> crea un estante para cada organización, aún cuando un solo documento pertenezca a esa categoría.
451
452El cuarto provee acceso por el texto \"Howto\": es una clasificador <i>List</i> basado en el metadato <i>dls.Keyword</i>. La opción <i>-bookshelf_type never</i> previene la creación del estante aún cuando dos documentos compartan las mismas keywords.
453
454<p>
455
456<p>
457<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
458
459
460<b>Enunciados de formato</b>. La líneas que comienzan con <i>format</i>, llamadas \"sentencias de formateo\", determinan la forma en la que deben mostrarse muchas de las partes de la colección. La sentencia de formato de <i>VList</i> se aplica a las listas de items mostrados verticalmente, como por ejemplo listas de títulos, temas y organizaciones y la tabla de contenidos de los documentos. Es omitida para la lista de resultados mediante la sentencia <i>SearchVList</i>, y también para el clasificador <i>Howto</i>  a través de la sentencia <i>CL4VList</i> (CL4 especifica el cuarto clasificador).
461<p>
462La sentencia <i>DocumentText</i> determina el modo en el que se formatea el texto, con el metadato <i>Title</i> ([<i>Title</i>]) en formato HTML &lt;<i>h3</i>&gt; seguido por el texto del documento [<i>Text</i>]. Configurando la sentencia <i>DocumentImages</i> como <i>true</i> aseguramos que las imágenes de portada se visualicen en cada documento. <i>DocumentButtons</i> indica cuales botones se muestran en cada documento. Las opciones son: <i>ExpandText, Expand Contents, Detach</i> y <i>Highlight</i>.
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
467<p>
468
469<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 (este texto es parte de él).
470<p>
471
472<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.
473<p>
474
475<b>Etiquetas de descripción</b>. Las etiquetas de descripción reconocidas por <i>HTMLPlugin</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:
476<p>
477
478<pre>
479&lt;!--\n
480&lt;Section&gt;\n
481&lt;Description&gt;\n
482&lt;Metadata name=\"Title\"&gt;\n
483Haciendo realidad los derechos humanos para la gente pobre: Estrategias\n
484para lograr los objetivos de desarrollo mundial\n
485&lt;/Metadata&gt;\n
486&lt;/Description&gt;\n
487--&gt;\n
488(el texto de la sección va aquí)\n
489&lt;!--\n
490&lt;/Section&gt;\n
491-->\n
492</pre>
493<p>
494
495Los 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.
496<p>
497
498<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/r0087e/metadata.xml\" target=text>metadata.xml</a> para el libro--<i>Income generation and money management: training women as entrepreneurs</i> -- es un bloque de alrededor diez lineas encerradas en las etiquetas &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. El cual define los metadatos <i>dls.Title, dls.Language, dls.Subject</i> y <i>dls.AZList</i>. Se puede especificar más de un valor para cualquier ítem del metadato. Por ejemplo, este libro tiene dos clasificaciones dls.Subject. 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>).
499<p>
500
501<b>Archivos de jerarquía</b>. Los archivos de Hierarchy contienen una sucesión de líneas, cada una de las cuales tiene tres items. El primer item es una cadena de texto que es confrontada con el metadato que aparece en el archivo <i>metadata.xml</i> descrito arriba. El segundo item es un número que define la posición en la jerarquía. El tercer item es una cadena de texto que describe al nodo de la jerarquía de la página web que genera Greenstone.
502<p>
503
504Por ejemplo, las siguientes tres líneas pertenecen al archivo de jerarquia <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>.
505
506<pre>
507\"Animal Husbandry and Animal Product Processing\" 7 \"Animal Husbandry and Animal Product Processing\" \n
508\"Animal Husbandry and Animal Product Processing|Cattle\" 7.1 \"Cattle\" \n
509\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" 7.2 \"Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" \n
510</pre>
511
512<p>
513Estas tres líneas definen un estante de nivel superior (en la posición 7), titulado \"Animal Husbandry and Animal Product Processing\", con dos estantes bajo él, \"Cattle\"  y \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\" respectivamente.
514
515<p>
516En este caso, las primeras cadenas de texto (y por consiguiente las entradas en el archivo metadata.xml) contienen todos los valores de la jerarquía. Los niveles en una jerarquía se separan con \"|\". Estos niveles pueden usarse directamente con el clasificador <i>Hierarchy</i> sin tener que usar el archivo de jerarquía. Sin embargo, de esta manera las entradas serían ordenadas alfabéticamente, y no en el orden particular definido en el archivo.
517
518<p>
519El archivo de jerarquía <a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a> usado por el clasificador por títulos contiene una estructura similar. Ordinariamente, un navegador por títulos usaría un clasificador <i>List</i> (o <i>AZList</i>). En este caso, queremos predefinir el agrupamiento A-Z, e incluye una entrada separada para periódicos, como puede verse <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">aquí</a>.
520"
521
522# -- Russian text ----------------
523collectionmeta  collectionextra [l=ru] "
524БОблОПтекО гуЌаМОтарМПгП развОтОя преЎставляют бПльшую кПллекцОю практОческПй ОМфПрЌацОО, пПлезМПй прО ПказаМОО пПЌПщО Ўля уЌеМьшеМОя беЎМПстО, увелОчеМОя гуЌаМОтарМПгП пПтеМцОала, а также ПбеспечеМОя практОчМПгП О пПлезМПгП ПбразПваМОя Ўля всех. ЭтП пПЎЌМПжествП сПЎержОт прОблОзОтельМП 25 публОкацОй -- ЎПкуЌеМтПв, сППбщеМОй О перОПЎОческОх ÑÑ‚атей -- в разлОчМых ÐŸÐ±Ð»Ð°ÑÑ‚ях Ñ‡ÐµÐ»ÐŸÐ²ÐµÑ‡ÐµÑÐºÐŸÐ³ÐŸ развОтОя, Пт сельскПхПзяйствеММПй практОкО ЎП экПМПЌОческПй пПлОтОкО, Пт вПЎы О ПчОсткО ЎП Пбщества О культуры, Пт ПбразПваМОя ЎП прПОзвПЎства, Пт уЌеМьшеМОя беЎствОй ЎП Ќалых Ð¿Ñ€ÐµÐŽÐ¿Ñ€ÐžÑÑ‚Ой.
525<p>
526
527ИзЎателО этПй кПллекцОО -- ГуЌаМОтарМая ОМфПрЌацОПММая МеправОтельствеММая ПргаМОзацОя Human Info NGO, Humanity CD Ltd, О ЎругОе сПтруЎМОчающОе ПргаМОзацОО. КПМтакты с МОЌО вПзЌПжМы через ПрПект гуЌаМОтарМых Ðž развОвающОхся бОблОПтек: 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>.
528<p>
529
530<h3>Как рабПтает кПллекцОя</h3>
531<p>
532
533<!-- _text1_ -->
534The DLS collection is fairly complex.
535еслО Вы являетесь тПлькП МачОМающОЌ пПльзПвателеЌ, тП лучше вМачале ПзМакПЌОться с МекПтПрыЌО ЎругОЌО кПллекцОяЌО (МапрОЌер, с <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">msword О pdf ЎеЌПМстрацОяЌО</a> ОлО же с архОваЌО ОлО с прПстПй графОческПй кПллекцОей).
536<p>
537
538<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл</a> ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐž, пПЎПбМП всеЌ кПМфОгурацОПММыЌ файлаЌ ЎругОх ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹, МачОМается сП стрПкО «СПзЎатель» (\"Сreator\"), кПтПрая сППбщает аЎрес электрПММПй пПчты СПзЎателя кПллекцОО, О ЎругПй -- «ПублОка» (\"Public\"), кПтПрая ПпреЎеляет, пПявОтся лО кПллекцОя Ма ЎПЌашМей страМОце устаМПвкО Greenstone. <!-- _text3_ -->Note that setting \"public\" to \"false\" only removes it from the home page; it will still be accessible in the library to anyone that knows the URL (a=p&p=about&c=coll-shortname).
539
540<p>
541
542
543<b>ПлагОМы</b>. БлПк стрПк \"plugin\" в <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>кПМфОгурацОПММПЌ файле</a> Ð¿Ñ€ÐµÐŽÑÑ‚авляет плагОМы, ОспПльзуеЌые кПллекцОей. ДПкуЌеМты в кПллекцОО DLS преЎставлеМы в HTML-фПрЌате, так чтП <i>HTMLPlugin</i> ЎПлжеМ быть включеМ. ОпцОя <i>description_tags</i> Пбрабатывает тэгО (прОзМакО) в тексте, кПтПрые ПпреЎеляют разЎелы О МаОЌеМПваМОя разЎелПв, как ПпОсаМП МОже.
544<p>
545
546ДругОе плагОМы <i>GreenstoneXMLPlugin</i>, <i>MetadataXMLPlugin</i>,<i>ArchivesInfPlugin</i> О <i>DirectoryPlugin</i> ОспПльзуются в Greenstone Ўля вМутреММОх Ñ†ÐµÐ»ÐµÐ¹ О являются стаМЎартМыЌО пПчтО вП всех ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÑÑ….
547<p>
548
549<b>ИМЎексы пПОска</b>. БлПк стрПк, МачОМающОйся с <i>indexes</i>, ПпреЎеляет, какОе пПОскПвые ОМЎексы буЎут ЎПступМы. В этПй кПллекцОО есть трО ОМЎекса. Вы ЌПжете Ох Ð²ÐžÐŽÐµÑ‚ÑŒ в МОспаЎающеЌ ЌеМю «ППОск» Ма <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">страМОце пПОска</a>. Первый ОМЎекс Мазывается «Главы», втПрПй -- «НазваМОя разЎелПв» О третОй -- «ППлМые ЎПкуЌеМты». НазваМОя этОх Ñ‚рех ÐžÐœÐŽÐµÐºÑÐŸÐ² Ўаются треЌя ПператПраЌО <i>collectionmeta</i>.
550<p>
551
552СПЎержаМОе ОМЎексПв -- тП есть ПпОсаМОе тПгП, чтП буЎет являться преЎЌетПЌ пПОска -- ПпреЎеляется стрПкПй <i>indexes</i> в Мачале этПгП блПка. ОМа ПпреЎеляет трО ОМЎекса, Ўва Оз МОх -- Ма урПвМе разЎела (МачОМающОеся с <i>section:</i>) О ПЎОМ Ма урПвМе ЎПкуЌеМта (МачОМающОйся с <i>document:</i>). РазлОчОе сПстПОт в тПЌ, чтП запрПс, сПстПящОй Оз МескПлькОх ÑÐ»ÐŸÐ², буЎет сППтветствПвать тПлькП ОМЎексу урПвМя разЎела, еслО все терЌОМы запрПса пПявляются в тПЌ же саЌПЌ разЎеле, тПгЎа как ПМ буЎет сППтветствПвать урПвМю ЎПкуЌеМта, еслО терЌОМы пПявляются гЎе-лОбП в преЎелах ÐŽÐŸÐºÑƒÐŒÐµÐœÑ‚а, кПтПрый ПбычМП включает МескПлькП разЎелПв. Первый О третОй ОМЎексы -- этП <i>section:text</i> О <i>document:text</i>, гЎе <i>:text</i> ПзМачает, чтП пПлМый текст разЎелПв О ЎПкуЌеМтПв сППтветствеММП буЎет преЎЌетПЌ пПОска. ВтПрПй ОМЎекс -- <i>section:Title</i> ПзМачает, чтП ЌетаЎаММые НазваМОя (<i>Title</i>) буЎут пПЎвергМуты пПОску. В этПЌ случае МазваМОя разЎелПв скПрее, чеЌ МазваМОя ЎПкуЌеМтПв. ЭтО трО ОМЎекса пПявляются в пПряЎке, в кПтПрПЌ ПМО ПпреЎелеМы в стрПке <i>indexes</i>.
553<p>
554
555<b>КлассОфОкатПры</b>. БлПк стрПк, пПЌечеММых <i>classify</i>, ПпреЎеляющОе ОМЎексы прПсЌПтра, в Greenstone Мазываются КлассОфОкатПраЌО. ИЌеется четыре классОфОкатПра, сППтветствующОе четыреЌ кМПпкаЌ Ма МавОгацОПММПй лОМейке Маверху кажЎПй страМОцы в кПллекцОО (МапрОЌер, <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">пПОскПвая страМОца</a>): <i>Указатель, НазваМОя, ОргаМОзацОО О Как</i>. ПервПй является кМПпка пПОска, а затеЌ пП пПряЎку этО четыре классОфОкатПра.
556<p>
557
558Первый классОфОкатПр ПбеспечОвает ЎПступ к преЎЌетаЌ. ЭтП ОерархОческОй классОфОкатПр, кПтПрый ПпреЎеляет ОерархОю в файле <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a> (параЌетр <i>hfile</i>); этПт файл ПбсужЎается МОже. ЭтПт классОфОкатПр базОруется Ма ЌетаЎаММых <i>dls.Subject</i>(ПреЎЌета). КПгЎа МескПлькП кМОг пПявляются в лОсте ОерархОО, ПМО сПртОруются с пПЌПщью ЌетаЎаММых <i>dls.Title</i> (НазваМОя) (как Вы ЌПжете вОЎеть <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">зЎесь</a>).
559
560<!-- _text6_ -->
561The second classifier provides access by title. It is also a <i>Hierarchy</i> classifier, this time based on
562<i>dls.AZList</i> metadata, whose hierarchy is defined in <a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>. This file is discussed below.
563
564ТретОй Ўает ЎПступ пП ПргаМОзацОяЌ: этП классОфОкатПр <i>СпОсПк</i> ПсМПваММый Ма ЌетаЎаММых <i>dls.Organization</i>. <!-- _text8_ -->The <i>-bookshelf_type always</i> option creates a new bookshelf for each organization, even if only one document belongs to that category.
565
566<!-- _text9_ -->The fourth provides access by \"Howto\" text: it is a <i>List</i> classifier based on <i>dls.Keyword</i> metadata. The <i>-bookshelf_type never</i> option prevents bookshelves being created even if two documents share the same keywords.
567
568<p>
569<b>ИзПбражеМОя ПблПжкО</b>. ГрОМстПуМ Ощет ОзПбражеМОя ПблПжкО Ўля кажЎПгП ЎПкуЌеМта, чье ОЌя сПвпаЎает с МазваМОеЌ ЎПкуЌеМта, МП ОЌеет расшОреМОе <i>.jpg</i>. ЭтП ОзПбражеМОе ассПцООруется с ЎПкуЌеМтПЌ О ЌПжет быть ОспПльзПваться Ма страМОчке ЎПкуЌеМта (сЌПтрО МОже). ИзПбражеМОя ПблПжек ЌПжМП выключОть, ОспПльзуя флаг -no_cover_image в кажЎПЌ плагОМе. \n
570
571<p>
572<b>ОператПры фПрЌата</b>.
573<!-- _text10_ -->
574The lines beginning with <i>format</i>, called \"format statements\", govern how various parts of the collection should be displayed. The <i>VList</i> format statement applies to lists of items displayed vertically, such as the lists of titles, subjects and organisations, and the table of contents for the target documents. It is overridden for the search results list by the <i>SearchVList</i> format statement, and also for the <i>Howto</i> classifier by the <i>CL4VList</i> statement (CL4 specifies the fourth classifier).
575<p>
576<!--_text11_ -->
577The <i>DocumentText</i> statement governs how the document text is formatted,
578with <i>Title</i> metadata ([<i>Title</i>]) in HTML &lt;<i>h3</i>&gt; format
579followed by the text of the document [<i>Text</i>]. Setting the <i>DocumentImages</i> format statement to <i>true</i> ensures that cover images are shown with each document. The <i>DocumentButtons</i> statement calls for the <i>Expand
580Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with each document.
581
582<p>
583
584БПльшОМствП ПператПрПв фПрЌата сПЎержат стрПку, указаММую в пПпПлМеММПй фПрЌе HTML. ИЌя ЌетаЎаММых Ð² кваЎратМых ÑÐºÐŸÐ±ÐºÐ°Ñ… (МапрОЌер, [<i>НазваМОе</i>], [<i>СПзЎатель</i>]) Ўают зМачеМОя этОЌ ЌетаЎаММыЌ. [<i>Текст</i>] Ўает текст ЎПкуЌеМта. ГОперссылка к ЎПкуЌеМту ЌПжет быть сПзЎаМа, ОспПльзуя [<i>link</i>]...[<i>/link</i>]; сППтветствующее ОзПбражеМОе ПблПжкО прПОзвПЎОтся с пПЌПщью [<i>icon</i>]. СтрПкО фПрЌата ЌПгут включать {<i>If</i>} {...,...}О {<i>Or</i>} {...,...}; Ўля первых ÐŽÐ²ÑƒÑ… ÐŽÐ°ÑŽÑ‚ся прОЌеры. ЭтО Ўва -- ЎПвПльМП слПжМые ПператПры фПрЌата. Мы Ме буЎеЌ ПбъясМять Ох Ð·ÐŽÐµÑÑŒ. В Greenstone ОзЌеМеМОя в стрПках Ñ„ПрЌата вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете ЌестМый сервер бОблОПтекО, кПгЎа сервер ЎПлжеМ быть пПвтПрМП запущеМ. ЭтП ПблегчОт эксперОЌеМты с разлОчМыЌО версОяЌО ПператПра фПрЌата О МаблюЎеМОе за теЌ, чтП прО этПЌ прПОсхПЎОт.
585
586<p>
587
588<b>МетаЎаММые урПвМя кПллекцОО</b>. СтрПкО <i>collectionmeta</i> Ð² кПМфОгурацОПММПЌ файле также стаМЎартМы вП всех ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÑÑ… Greenstone. ОМО Ўают Пбщую ОМфПрЌацОю П кПллекцОО, ПпреЎеляя ее МазваМОе (ОЌя), преЎставляют краткПе ПпОсаМОе, кПтПрПе пПявляется Ма ее ЎПЌашМей страМОце. КраткПе ПпОсаМОе (в <i>collectionextra</i>) ЌПжМП вОЎеть Ма ЎПЌашМей страМОце кПллекцОО <!-- (_text2_) -->(this text is part of it)
589<p>
590
591<b>ПеревПЎы с ПЎМПгП языка Ма ЎругПй</b>. ППслеЎМяя часть <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>кПМфОгурацОПММПгП файла</a> ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐž преЎставляет ЌетаЎаММые Ма урПвМе кПллекцОО Ма фраМцузскПЌ О ОспаМскПЌ языках ÑÐŸÐŸÑ‚ветствеММП. ЯзыкО ПбПзМачеМы в кваЎратМых ÑÐºÐŸÐ±ÐºÐ°Ñ…: [<i>fr</i>] О [<i>es</i>]. ЕслО Птсутствует указаМОе спецОфОкацОО языка, аМглОйскОй язык прОМят пП уЌПлчаМОю. КПМфОгурацОПММый файл пПказывает характерМые ПсПбеММПстО зМакПв (МапрОЌер, вП фраМцузскПЌ языке). ЭтПт файл МахПЎОтся в UTF-8, гЎе этО зМакО преЎставлеМы ЌультОбайтМыЌ пПряЎкПЌ слеЎПваМОя (&lt;C3&gt;&lt;A9&gt; в этПЌ случае). АльтерМатОвМП ПМО ЌПгут быть преЎставлеМы Ох HTML МазваМОяЌО Пбъекта (пПЎПбМП <i>&amp;eacute</i>). В этПЌ Мет МОкакПгП разлОчОя: ПМО выгляЎят Ма экраМе ПЎОМакПвП. ОЎМакП, еслО бы текст был ЎПступеМ <i>Ўля пПОска</i>, тП разлОчОе ОЌелП бы ЌестП. Greenstone ОспПльзует вМутреММОй Unicode, чтПбы гараМтОрПвать вПзЌПжМПсть пПОска О Ўля МеаМглОйскОх ÑÐ·Ñ‹ÐºÐŸÐ².
592<p>
593
594<b>ОпОсаМОе ЎескрОптПрПв</b>. ОпОсаМОе ЎескрОптПрПв, распПзМаваеЌых <i>HTMLPlugin</i>, вставлеМы в HTML текста ЎПкуЌеМтПв, чтПбы ПпреЎелОть, гЎе МачОМаются О закаМчОваются разЎелы, О ПпреЎелОть МазваМОя разЎелПв. ОМО выгляЎят такОЌ ПбразПЌ:
595<p>
596<pre>
597&lt;!--\n
598&lt;Section&gt;\n
599&lt;Description&gt;\n
600&lt;Metadata name=\"Title\"&gt;\n
601Realizing human rights for poor people: Strategies\n
602for achieving the international development targets\n
603&lt;/Metadata&gt;\n
604&lt;/Description&gt;\n
605--&gt;\n
606(текст разЎела ОЎет сюЎа)\n
607&lt;!--\n
608&lt;/Section&gt;\n
609-->\n
610</pre>
611<p>
612
613Маркеры &lt;!-...-&gt; ОспПльзуются, чтПбы гараМтОрПвать, чтП этО ЎескрОптПры ПтЌечеМы как кПЌЌеМтарОО в HTML О пПэтПЌу затрагОвают фПрЌатОрПваМОе ЎПкуЌеМта. В <i>ОпОсаМОО</i> ЌПгут быть ПпреЎелеМы ЎругОе вОЎы ЌетаЎаММых, МП этП Ме сЎелаМП Ўля стОля кПллекцОО, кПтПрую Ќы ПпОсываеЌ зЎесь. ТПчМП такая же спецОфОкацОя (включая О &lt;!-...-&gt; Ќаркеры) ЌПгут ОспПльзПваться также в ЎПкуЌеМтах Word.
614<p>
615
616<b>Ѐайлы ЌетаЎаММых</b>. МетаЎаММые Ўля всех ÐŽÐŸÐºÑƒÐŒÐµÐœÑ‚Пв в DLS-кПллекцОО распПлПжеМы в файлах metadata.xml, пП файлу в папке ЎПкуЌеМта. Ѐайл <a href=\"_httpcollection_/import/r0087e/metadata.xml\" target=text>metadata.xml</a> Ўля кМОгО -- <i>Income generation and money management: training women as entrepreneurs</i> -- преЎставляет сПбПй блПк Оз 10 стрПк заключеММых Ð² тэгах &lt;<i>FileSet</i>&gt; ... &lt;<i>FileSet</i>&gt;. ОМО ПпреЎеляют <i>dls.Title, dls.Language, dls.Subject</i> О ЌетаЎаММые <i>dls.AZList</i>. БПльше чеЌ ПЎМП зМачеМОе ЌПжет быть ПпреЎелеМП Ўля любых Ð¿ÑƒÐœÐºÑ‚Пв ЌетаЎаММых. <!-- _text5_ -->For example, this book has two dls.Subject classifications. Оба сПхраМеМы в качестве ЌетаЎаММых ÐŽÐ»Ñ этПгП спецОфОческПгП ЎПкуЌеМта, пПтПЌу чтП сПстПяМОе=МакаплОвать (<i>mode=accumulate</i>) ПпреЎелеМП, а в качестве альтерМатОвы - зМачеМОе пП уЌПлчаМОю, кПтПрыЌ является <i>mode=override</i>.
617<p>
618
619<b>ИерархОческОе файлы</b>.
620<!-- _text12_ -->
621Hierarchy files contain a
622succession of lines each of which has three items. The first item is a text string which is matched against the metadata that occurs in the <i>metadata.xml</i> file described above. The second item is a number that defines the position in the hierarchy. The third item is a text string that describes the node of the hierarchy on the web pages that Greenstone generates.
623
624<p>
625<!-- _text13_ -->
626For example, the following shows three lines from the subject hierarchy file <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>.
627
628<pre>
629\"Animal Husbandry and Animal Product Processing\" 7 \"Animal Husbandry and Animal Product Processing\" \n
630\"Animal Husbandry and Animal Product Processing|Cattle\" 7.1 \"Cattle\" \n
631\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" 7.2 \"Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" \n
632</pre>
633
634<p>
635<!--_text14_ -->
636These three lines define one top level bookshelf (at position 7), titled \"Animal Husbandry and Animal Product Processing\", with two bookshelves underneath it, titled \"Cattle\" and \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\" respectively.
637
638<p>
639<!--_text15_-->
640In this case, the first strings (and therefore the entries in metadata.xml files) contain the entire hierarchy values. Levels in the hierarchy are separated by \"|\". They could be used directly by a <i>Hierarchy</i> classifier without the use of the hierarchy file. However, then the entries would be ordered alphabetically, not in the special order defined by the file.
641
642<p>
643<!--_text16_ -->
644The <a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a> hierarchy file used by the titles classifier contains a similar structure. Ordinarily, a titles browser would use a <i>List</i> (or <i>AZList</i>) classifier. In this case, we want to predefine the A-Z groupings, and include a separate entry for periodicals, as can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">here</a>.
645"
646
647# -- Simplified Chinese text ----------------
648collectionmeta  collectionextra [l=zh] "
649人类发展囟乊銆是䞀䞪有倧量实甚信息的倧型銆藏旚圚垮助减少莫困提升人类朜胜以及䞺所以人提䟛䞀䞪实际䞔有甚的教育。
650这䞪子集包含25䞪出版物——文档、报告以及定期发衚的文章——芆盖了人类发展的倚䞪领域从农䞚行䞺到经济政策从氎䞎
651卫生到瀟䌚䞎文化从教育到制造从灟隟恢倍到埮观䌁䞚。
652
653<p>本銆藏的猖蟑者是Human Info NGOHumanityCD Ltd以及参䞎的组织。我们的联系方匏是人类䞎发展囟乊銆项目
654Humanitarian and Development Libraries ProjectOosterveldiaan 196B-2610 AntwerpBelgium。
655电话 32-3-448.05.54䌠真 32-3-449.75.74电邮 <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.\n
656 
657<h3>本銆藏劂䜕工䜜</h3>\n 
658 
659<p> DLS銆藏比蟃倍杂。劂果䜠刚匀始接觊銆藏其他䞀些銆藏可胜曎适合䜠
660比劂<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Word侎PDF挔瀺</a>或者
661<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Greenstone存档</a>或者 
662<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">简单囟像銆藏</a>。\n
663
664<p> 
665本銆藏的<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>配眮文件</a>跟其他配眮文件䞀样匀始是给出銆藏创建者email地址的行
666\"creator\"及倖䞀行\"public\"决定是吊圚Greenstone䞻页䞊星瀺本銆藏。 请泚意将\"public\"讟眮成\"false\"只䌚将銆藏从䞻页星瀺䞊删陀
667任䜕知道URLa=p&p=about&c=coll-shortname的人仍将胜访问该銆藏。\n
668
669<p> 
670<b>插件</b>。<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>配眮文件</a>侭的\"plugin\"插件行给出了本銆藏甚到的插件。
671DLS銆藏里的文档是HTML所以<i>HTMLPlugin</i>HTML 插件必须包括圚内。<i>description_tags</i>选项倄理文本䞭定义章节䞎章节标题的标筟劂䞋所述。\n
672 
673<p> 
674及倖的插件<i>GreenstoneXMLPlugin、MetadataXMLPlugin、ArchivesInfPlugin侎DirectoryPlugin</i>
675圚Greenstone䞭被甚于内郚倄理并䞔圚几乎所有銆藏䞭郜是标准插件。
676 
677<p> 
678<b>可检玢的玢匕</b>。这䞀段始于<i>indexes</i>配眮这䞀行指定了可检玢的玢匕。圚本銆藏䞭有䞉䞪可检玢的玢匕
679䜠可圚<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">搜玢页面</a>䞭打匀“搜玢”䞋拉列衚菜单时看到。
680第䞀䞪玢匕称䞺\"ç« \"第二䞪\"节标题\"第䞉䞪是\"敎䞪文档\"。这䞉䞪玢匕的名字由䞉䞪
681<i>collectionmeta</i>定义。\n
682
683<p> 
684玢匕的内容——即对可检玢内容的指定——是由这段最匀始的<i>indexes</i>玢匕行定义的。
685这行定义了䞉䞪玢匕䞀䞪圚节级以<i>section:</i>匀始及䞀䞪圚文档级以
686<i>document:</i>匀始。区别圚于圓查询匏有倚䞪词时若所有查询词郜出现圚同䞀节䞭
687这将只匹配节级别的玢匕而若所有词出现圚文档的任䜕郚分通垞郜由若干节组成将匹配
688䞀䞪文档级的玢匕。第䞀䞪和第䞉䞪玢匕是<i>section:text</i>侎<i>document:text</i><i>:text</i>
689意味着节䞎文档的党文将被搜玢。第二䞪玢匕是<i>section:Title</i>意味着<i>Title</i>标题
690元数据将被检玢——圚这种情况䞋检玢的是节标题而䞍是文档标题。这䞉䞪玢匕将按照<i>indexes</i>行䞭定义的顺序出现。\n
691
692<p> 
693<b>分类噚</b>。<i>classify</i>行定义了浏览的玢匕圚Greenstone䞭称䞺\"分类噚\"。本銆藏有四䞪分类噚
694这䞎銆藏䞭每页最顶端浏览条䞭的四䞪按钮对应比劂<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">检玢页面</a>
695<i>䞻题</i><i>标题</i><i>组织</i>侎<i>指南</i>。<i>搜玢</i>按钮排圚最前面然后按顺序星瀺这四䞪分类噚。\n
696
697<p>
698第䞀䞪分类噚提䟛按䞻题的访问。这是䞀䞪<i>层级</i>分类噚<a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>
699文件<i>hfile</i>参数定义了这些层级䞋面将讚论这䞪文件。这䞪分类噚基于<i>dls.Subject</i>元数据
700而圓倚本乊出现圚层级䞭的䞀䞪叶子节点䞭时它们将按<i>dls.Title</i>元数据排序正劂<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">这里</a>所瀺。
701 
702第二䞪分类噚提䟛按题名的访问。这也是䞀䞪<i>层级</i>分类噚是基于<i>dls.AZList</i>元数据其层级定义圚
703<a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>文件䞭。䞋面䌚讚论这䞪文件。
704 
705第䞉䞪分类噚提䟛按组织的访问它是基于<i>dls.Organization</i>元数据构建的<i>List</i>分类噚。<i>-bookshelf_type always</i>选项
706䞺每䞪组织创建䞀䞪新的乊架即䜿圓只有䞀䞪文档属于那䞪目圕时。
707 
708第四䞪分类噚按\"指南\"提䟛访问它是基于<i>dls.Keyword</i>元数据的<i>List</i>分类噚。
709<i>-bookshelf_type never</i>选项衚明即䜿圓䞀䞪文档拥有同样的关键词时也䞍䌚䞺其创建乊架。
710
711<p>
712<b>封面囟片</b>。Greenstone检查每䞪文档的封面囟片该封面囟片䞎该文档同名䜆是是<i>.jpg</i>文件类型。这䞪囟片将被铟接到该文档
713而䞔可圚文档页面劂䞋所瀺䞭星瀺。通过讟眮每䞪插件的-no_cover_image标识可取消星瀺封面囟片。\n
714 
715<p>
716<b>栌匏变量</b>。这些行以<i>format</i>匀倎称䞺\"栌匏变量\"控制銆藏的各䞪郚分应劂䜕星瀺。<i>VList</i>栌匏变量䜜甚于所有竖向星瀺条目
717的列衚比劂题名列衚、䞻题列衚和组织列衚以及目标文档的内容倧纲。对于搜玢结果列衚而蚀这䞪栌匏变量被<i>SearchVList</i>栌匏变量所重写
718同样的<i>指南</i>分类噚的栌匏由<i>CL4VList</i>变量重写CL4指第四䞪分类噚。
719 
720<p>
721<i>DocumentText</i>文档文本栌匏变量控制文档文本的栌匏即HTMLäž­&lt;<i>h3</i>&gt;侭的<i>题名</i>元数据[<i>Title</i>]接䞋来星瀺
722文档文本[<i>Text</i>]。将<i>DocumentImages</i>栌匏变量讟䞺<i>true</i>确保圚每䞪文档䞭郜星瀺封面囟片。<i>DocumentButtons</i>变量确定圚每䞪文档䞭星瀺<i>星瀺所有文本、
723扩展目圕衚、圚新窗口星瀺本页</i>以及<i>突出星瀺查询项</i>按钮。
724
725<p>
726倚数栌匏变量本身包含修改后的HTML代码。方括号括起来的元数据名比劂[<i>Title</i>][<i>Creator</i>]
727给出了该元数据的倌。[<i>Text</i>]文本代衚文档文本。文档的铟接可甚[<i>link</i>]

[<i>/link</i>]指定
728[<i>icon</i>]代衚䞀䞪合适的囟标。栌匏字䞲可包含{<i>If</i>}{... , ...}侎{<i>Or</i>}{... , ...}最前面的䞀䞪给出了瀺䟋。
729这䞀䞪栌匏变量盞对比蟃倍杂圚这里我们就䞍曎倚解释了。圚Greenstone䞭栌匏字䞲䞭的曎改可以立即起效陀非
730圓前䜿甚的是本地服务噚而圚这种情况䞋需芁重启服务噚。这䜿埗调试栌匏变量以及它们的效果变埗盞对比蟃容易。\n
731 
732<p>
733<b>銆藏级的元数据</b>。配眮文件䞭的<i>collectionmeta</i>行同样也是所有Greenstone銆藏䞭的标准化讟眮。它们
734描述了銆藏的䞀般性信息定义了銆藏的名字以及圚该銆藏䞻页䞊星瀺的描述。这里的描述信息定义圚<i>collectionextra</i>䞭
735可圚DLS銆藏的䞻页䞊看到这里的文本是其䞭的䞀郚分。\n<p>
736
737<p>
738<b>语蚀翻译</b>。<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>銆藏配眮文件</a>的最后郚分
739分别给出了法语和西班牙语的銆藏级元数据。方括号䞭的内容指定语种[<i>fr</i>]和[<i>es</i>]。劂果没有指定语种
740则猺省假讟是英语。配眮文件䞭有垊沉音字笊比劂法语䞭的<i>é</i>。这䞪文件是UTF-8猖码的因歀这些字笊由
741倚字节序列衚瀺这里是&lt;C3&gt;&lt;A9&gt;。或者它们可由其HTML实䜓名称所衚瀺比劂<i>&amp;eacute</i>。
742这䞀者没有任䜕差别它们圚屏幕䞊的星瀺郜是䞀样的。然而劂果文本是<i>可检玢的</i>那么还是有䞀点䞍同
743Greenstone内郚䜿甚Unicode来保证所有非英语语蚀而蚀搜玢功胜郜胜正垞工䜜。
744
745<p>
746<b>描述标筟</b>。<i>HTMLPlugin</i>HTML插件识别的描述标筟是被插入到文档的HTML源文本䞭
747甚来定义每节的匀倎䞎结尟以及每节的标题。比劂
748<pre> 
749&lt;!--\n
750&lt;Section&gt;\n
751&lt;Description&gt;\n
752&lt;Metadata name=\"Title\"&gt;\n
753Realizing human rights for poor people: Strategies\n
754for achieving the international development targets\n
755&lt;/Metadata&gt;\n
756&lt;/Description&gt;\n
757--&gt;\n
758(text of section goes here)\n
759&lt;!--\n
760&lt;/Section&gt;\n
761-->\n
762</pre>
763&lt;!-- ... --&gt;标记甚来保证这些标筟圚HTML䞭被讀䞺是泚释因歀䞍䌚圱响到文档的栌匏。
764圚<i>Description</i>描述郚分可以讟眮其他类型的元数据䜆是圚我们这里所描述的銆藏䞭
765并没有这样的讟眮。同样的这些讟眮包括&lt;!-- ... --&gt标筟也可甚圚Word文档䞭。\n
766
767<p>
768<b>元数据文件</b>。DLS銆藏䞭所有文档的元数据郜圚metadata.xml文件䞭每䞪文件对应于䞀䞪文件倹。
769这䞪<a href=\"_httpcollection_/import/r0087e/metadata.xml\" target=text>metadata.xml</a>文件是附属于这本乊
770——<i>Income generation and money management: training women as entrepreneurs</i>
771创收䞎金钱管理将劇女训练䞺䌁䞚家——其&lt;<i>FileSet</i>&gt;

&lt;<i>/FileSet</i>&gt;标筟䞭有倧抂十行。
772它定义了<i>dls.Title</i>、<i>dls.Language</i>、<i>dls.Subject</i>和<i>dls.AZList</i>元数据。每䞪元数据条目可以有倚䞪倌。比劂这本乊
773就有䞀䞪dls.Subject分类。这䞀䞪郜将甚䜜这䞪文档的元数据倌因䞺讟眮了<i>mode=accumulate</i>
774䞎之对立的是<i>mode=override</i>这也是猺省倌。\n
775
776<p>
777<b>层级文件</b>。层级文件有若干行每行由䞉䞪条目组成。第䞀䞪条目是字笊䞲它将匹配前面所描述 的<i>metadata.xml</i>
778文件䞭的元数据。第二䞪条目是䞀䞪数字它定义了层级䞭的䜍眮。第䞉䞪条目是字笊䞲 它描述了所生成的眑页䞭该层级节点的䜍眮。
779 
780<p>
781比劂䞋面星瀺了䞻题层级文件<a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>䞭的䞉行。
782
783<pre>
784\"Animal Husbandry and Animal Product Processing\" 7 \"Animal Husbandry and Animal Product Processing\" \n
785\"Animal Husbandry and Animal Product Processing|Cattle\" 7.1 \"Cattle\" \n
786\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" 7.2 \"Other animals (micro-livestock, little known animals, \n      silkworms, reptiles, frogs, snails, game, etc.)\" \n
787</pre>
788
789<p>
790这䞉行定义了䞀䞪顶层乊架䜍眮7题名䞺\"Animal Husbandry and Animal Product Processing\"
791其䞋有䞀䞪乊架题名分别䞺\"Cattle\"和\"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\"。
792 
793<p>
794圚这䞭情况䞋第䞀䞪字笊䞲即metadata.xml文件䞭的条目包含了敎䞪层级倌。层级䞭的各䞪层次由\"|\"分隔。它们可以盎接䜿甚䞀䞪
795<i>Hierarchy</i>分类噚而䞍甚层级文件。然而歀时所有条目将按字笊顺序排序而䞍是以那䞪文件䞭定义的特别顺序。
796 
797<p>
798这些标题分类噚䜿甚的<a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a>层级文件有着类䌌的结构。通垞情况䞋
799题名浏览噚䌚䜿甚<i>List</i>或<i>AZList</i>分类噚。圚这种情况䞋我们预先定义A到Z的分组并䞺期刊䞓闚讟眮䞀䞪独立的条目劂
800<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">这里</a>所瀺。
801"
Note: See TracBrowser for help on using the browser.