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

creator     [email protected]
public      true

buildtype   mg

plugin  HTMLPlugin -input_encoding iso_8859_1 -description_tags -OIDtype dirname
plugin  GreenstoneXMLPlugin
plugin  MetadataXMLPlugin
plugin  ArchivesInfPlugin
plugin  DirectoryPlugin

indexes     section:text section:Title document:text

classify    Hierarchy -metadata "dls.Subject" -sort dls.Title -buttonname Subject -hfile dls.Subject.txt
classify    Hierarchy -metadata dls.AZList -hlist_at_top -sort dls.Title -buttonname Title -hfile dls.AZListtxt
classify    List -sort_leaf_nodes_using dls.Title -metadata dls.Organization -bookshelf_type always -buttonname Organization
classify    List -metadata dls.Keyword -bookshelf_type never -buttonname Howto

format VList "<td valign=top>[link][icon][/link]</td>
<td valign=top>[highlight]{Or}{[dls.Title],[Title],Untitled}[/highlight]
<i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages],
<br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i>
</td>"

format SearchVList "<td valign=top>[link][icon][/link]</td>
<td>{If}{[parent(All\': \'):Title],
[parent(All\': \'):Title]:}
[link][Title][/link]</td>"

format CL4VList "<td valign=top>[link][dls.Keyword][/link]</td>"

format DocumentText "<h3>[Title]</h3>\\n\\n<p>[Text]"
format DocumentImages true
format DocumentButtons "Expand Text|Expand Contents|Detach|Highlight"

format HList "[link][highlight][ex.Title][/highlight][/link]"

format DocumentHeading "{Or}{[parent(Top):Title],[Title],untitled}<br>"

# -- English strings ----------------
collectionmeta  collectionname [l=en] "Development Library Subset collection"

collectionmeta  .section:text [l=en] "chapters"
collectionmeta  .section:Title [l=en] "section titles"
collectionmeta  .document:text [l=en] "entire documents"

# -- French strings ----------------
collectionmeta  collectionname [l=fr] "Sous-ensemble de la collection BibliothÚque de Développement"

collectionmeta  .section:text [l=fr] "chapitres"
collectionmeta  .section:Title [l=fr] "titres des sections"
collectionmeta  .document:text [l=fr] "documents entiers"

# -- Spanish strings ----------------
collectionmeta  collectionname [l=es] "Subconjunto de la Biblioteca para el Desarrollo"

collectionmeta  .section:text [l=es] "capítulos"
collectionmeta  .section:Title [l=es] "títulos de las secciones"
collectionmeta  .document:text [l=es] "documentos completos"

# -- Russian strings ----------------
collectionmeta  collectionname [l=ru] "СубкПллекцОя БОблОПтекО развОтОя"

collectionmeta  .section:text [l=ru] "Главы"
collectionmeta  .section:Title [l=ru] "НазваМОя разЎелПв"
collectionmeta  .document:text [l=ru] "ППлМые ЎПкуЌеМты"

# -- English text ----------------
collectionmeta  collectionextra [l=en] "The Humanitarian Development Libraries
represent a large collection of practical information aimed at helping
reduce poverty, increasing human potential, and providing a practical and
useful education for all. This subset contains about 25
publications--documents, reports, and periodical articles--in various areas
of human development, from agricultural practice to economic policies, from
water and sanitation to society and culture, from education to
manufacturing, from disaster mitigation to micro-enterprises.

<p> The editors of this collection are Human Info NGO, HumanityCD Ltd, and
participating organizations. Contact us at Humanitarian and Development
Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
32-3-448.05.54, Fax 32-3-449.75.74,
email <a href=mailto:[email protected]>[email protected]</a>.\n

<h3>How the collection works</h3>\n

<p>
The DLS collection is fairly complex. If you\'re
just starting out you might prefer to look at some other
collections first (e.g.
<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">Word and PDF demonstration</a>, or the
<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/gsarch-e&a=p&p=about\">Greenstone Archives</a>, or the
<a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/image-e&a=p&p=about\">Simple Image collection</a>).\n

<p>
The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
configuration file</a>, like all collection configuration files, begins with a
line (\"creator\") that gives the email address of the collection\'s creator, and
another (\"public\") that determines whether the collection will appear on the
home 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

<p>
<b>Plugins</b>. The \"plugin\" lines in the
<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>configuration file</a>
give the plugins used by the collection. The documents in the DLS collection
are in HTML, so <i>HTMLPlugin</i> must be included. The <i>description_tags</i>
option processes tags in the text that define sections and section titles as
described below. \n

<p>
The other plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, and DirectoryPlugin</i>, are used by Greenstone
for internal purposes and are standard in almost all collections.

<p>
<b>Searchable indexes</b>. The block of lines starting with <i>indexes</i>
specifies what searchable indexes will be available. In this collection there
are three: you can see them when you pull down the \"Search for\" menu on the
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>.
The first index is called \"chapters\", the second \"section titles\",
and the third \"entire documents\". The names of these three indexes are given by
three <i>collectionmeta</i> statements.\n

<p>
The contents of the indexes -- that is, the specification of what it is that
will be searched -- are defined by the <i>indexes</i> line at the beginning of
this block. This specifies three indexes, two at the section level (beginning
with <i>section:</i>) and one at the document level (beginning with
<i>document:</i>). The difference is that a multi-word query will only match a
section-level index if all query terms appear in the same section, whereas it
will match a document-level index if the terms appear anywhere within the
document (which typically comprises several sections). The first and third
indexes are <i>section:text</i> and <i>document:text</i>, and the <i>:text</i>
means that the full text of sections and documents respectively will be
searched. The second is <i>section:Title</i>, which means that <i>Title</i>
metadata will be searched -- in this case, section titles (rather than document
titles). The three indexes appear in the order in which they are specified on
the <i>indexes</i> line.\n

<p>
<b>Classifiers</b>. The block of lines labeled <i>classify</i> define the
browsing indexes, called \"classifiers\" in Greenstone. There are four of them,
corresponding to four buttons on the navigation bar at the top of each page in
the collection (e.g. the <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>):
<i>subjects</i>, <i>titles</i>, <i>organisations</i>, and <i>howto</i>
The <i>search</i> button comes first, then come the four classifiers, in order.\n

<p>
The first classifier provides access by subject. It is a <i>Hierarchy</i>
classifier whose hierarchy is defined in the file
<a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>
(the <i>hfile</i> argument); this file is discussed below. This classifier is
based on <i>dls.Subject</i> metadata, and when several books appear at a leaf of
the hierarchy they are sorted by <i>dls.Title</i> metadata (as you can see
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1.4.1\">here</a>).

The second classifier provides access by title. It is also a <i>Hierarchy</i> classifier, this time based on
<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.

The third provides access by organization: it is a
<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.

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.

<p>
<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>
extension. 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

<p>
<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). 
<p>
The <i>DocumentText</i> statement governs how the document text is formatted,
with <i>Title</i> metadata ([<i>Title</i>]) in HTML &lt;<i>h3</i>&gt; format
followed 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
Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with each document.

<p>
Most format statements contain a string specified in an augmented form of
HTML. Metadata names in square brackets (e.g. [<i>Title</i>], [<i>Creator</i>])
give the value of that metadata; [<i>Text</i>] gives the document text. A
hyperlink to the document can be made using [<i>link</i>] ...[<i>/link</i>]; an
appropriate icon is produced by [<i>icon</i>]. Format strings can include
{<i>If</i>}{... , ...} and {<i>Or</i>}{... , ...}; the first two give
examples. These two are fairly complex format statements; we will not explain
them here. In Greenstone, changes in format strings take effect immediately
unless you are using the local library server, in which case the server needs
to be restarted. This makes it easy to experiment with different versions of a
format statement and see what happens.\n


<p>
<b>Collection-level metadata</b>. The <i>collectionmeta</i> lines in the
configuration file are also standard in all Greenstone collections. They give
general information about the collection, defining its name, and a
description that appears on its home page. The description (in <i>collectionextra</i>) can be
seen on the DLS collection\'s home page (this text is part of it).\n


<p>
<b>Language translations</b>. The last part of the
<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
configuration file</a> gives the collection-level metadata in French and
Spanish respectively. The languages are indicated by square brackets:
[<i>fr</i>] and [<i>es</i>]. If there is no language specification, English is
assumed by default. The configuration file shows accented characters
(e.g. French <i>é</i>). This file is in UTF-8, and these characters are
represented by multi-byte sequences (&lt;C3&gt;&lt;A9&gt; in this
case). Alternatively they could be represented by their HTML entity names (like
<i>&amp;eacute</i>). It makes no difference: they look the same on the
screen. However, if the text were <i>searchable</i> it would make a difference;
Greenstone uses Unicode internally to ensure that searching works as expected
for non-English languages.\n

<p>
<b>Description tags</b>. The description tags recognized by <i>HTMLPlugin</i>
are inserted into the HTML source text of the documents to define where
sections begin and end, and to specify section titles. They look like this:
<pre>
&lt;!--\n
&lt;Section&gt;\n
&lt;Description&gt;\n
&lt;Metadata name=\"Title\"&gt;\n
Realizing human rights for poor people: Strategies\n
for achieving the international development targets\n
&lt;/Metadata&gt;\n
&lt;/Description&gt;\n
--&gt;\n
(text of section goes here)\n
&lt;!--\n
&lt;/Section&gt;\n
-->\n
</pre>
The &lt;!-- ... --&gt; markers are used to ensure that these tags are marked as
comments in HTML and therefore do not affect document formatting. In the
<i>Description</i> part other kinds of metadata can be specified, but this is
not done for the style of collection we are describing here. Exactly the same
specification (including the &lt;!-- ... --&gt markers) can be used in Word
documents too.\n

<p>
<b>Metadata Files</b>. Metadata for all documents in the DLS collection
is provided in metadata.xml files, one per document folder.
The <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>
-- is a block of about ten lines encased in &lt;<i>FileSet</i>&gt; ...
&lt;<i>/FileSet</i>&gt; tags. It defines
<i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> and <i>dls.AZList</i> metadata. More
than one value can be specified for any metadata item. For example, this book has two dls.Subject classifications. Both of these
are stored as metadata values for this particular document (because
<i>mode=accumulate</i> is specified; the alternative, and the default, is
<i>mode=override</i>).\n

<p><b>Hierarchy files</b>. Hierarchy files contain a
succession of lines each of which has three items. **_text12_ starts here. **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.
<p>
For example, the following shows three lines from the subject hierarchy file <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>.

<pre>
\"Animal Husbandry and Animal Product Processing\"  7   \"Animal Husbandry and Animal Product Processing\"
\"Animal Husbandry and Animal Product Processing|Cattle\"   7.1 \"Cattle\"
\"Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\"    7.2 \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\"
</pre>

These 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.

In 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.

The <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>.
"

# -- French text ----------------
collectionmeta  collectionextra [l=fr] "Les BibliothÚques humanitaires pour le
Développement constituent une collection importante dont les objectifs sont
d\'aider à réduire la pauvreté, de promouvoir l\'accroissement du
potentiel humain, et d\'offrir une éducation pratique et utile à tous.
Cette collection contient environ 25 publications -- documents, rapports, et
articles de périodiques -- qui traitent de différents sujets liés au
développement humain. On y trouve des informations concernant les pratiques
agricoles aussi bien que les politiques économiques; les mesures d\'hygiÚne
pour l\'eau et la société et la culture; l\'éducation et la petite
industrie; la prévention des désastres et les micro-entreprises.
<p>
Les éditeurs
de cette collection sont Human Info NGO, HumanityCD Ltd, and organisations
ayant contribué. Vous pouvez nous contacter à Humanitarian and Development
Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel
32-3-448.05.54, Fax 32-3-449.75.74, courriel <a
href=mailto:[email protected]>[email protected]</a>.

<h3>Comment, marche la collection</h3>

<p>
La collection DLS est assez
complexe. Pour un débutant, il serait préférable de consulter d\'abord d\'autres collections
(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>).

<p>
Le <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. _text3_

<p>
<b>Plugins</b>. _text4_ 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.

<p>
Les 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.

<p>
<b>Index recherchables</b>. Le bloc de lignes qui commence avec <i>index</i>
pré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>.

<p>
Les contenus des trois index, à savoir la spécification de ce qui sera recherché, sont définies
par 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
(qui typiquement, comprend plusieurs sections). Le premier et le troisiÚme index sont
<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>.

<p>
<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.

<p>
Le 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>).

_text6_

Le 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>. _text8_

_text9_


<p>
<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

<p>
<b>Déclarations de format</b>. _text10_

<p>
_text11_


<p>
La plupart des déclarations de format contiennent une chaîne spécifiée en HTML mise en valeur.
Les 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.

<p>
<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.
Elles 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
d\'accueil de la collection (_text2_).

<p>
<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.

<p>
<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:
<pre>
&lt;!--\n
&lt;Section&gt;\n
&lt;Description&gt;\n
&lt;Metadata name=\"Title\"&gt;\n
Realizing human rights for poor people: Strategies\n
for achieving the international development targets\n
&lt;/Metadata&gt;\n
&lt;/Description&gt;\n
--&gt;\n
(text of section goes here)\n
&lt;!--\n
&lt;/Section&gt;\n
-->\n
</pre>
Les marqueurs &lt;!-- ... --&gt; sont utilisés pour assurer que ces étiquettes sont indiquées comme
commentaires dans HTML et par conséquent n\'ont aucun effet sur le formatage. Dans la partie
<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.

<p>
<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. _text5_ 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>).

<p>
<b>Fichiers d\'hiérarchie</b>. _text12_


"

# -- Spanish text ----------------
collectionmeta  collectionextra [l=es] "
Las Bibliotecas sobre Aspectos
Humanitarios y de Desarrollo representan una extensa colecci&oacute;n de
informaci&oacute;n pr&aacute;ctica cuyo prop&oacute;sito es ayudar a
reducir la pobreza, acrecentar el potencial humano y proveer una
educaci&oacute;n pr&aacute;ctica y &uacute;til para todos. Este subconjunto
comprende unas 25 publicaciones - documentos, informes t&eacute;cnicos y
art&iacute;culos de publicaciones peri&oacute;dicas - en varias
&aacute;reas del desarrollo humano, desde pr&aacute;cticas agr&iacute;colas
a pol&iacute;ticas econ&oacute;micas, desde agua y saneamiento a sociedad y
cultura, desde educaci&oacute;n a manufactura, desde mitigaci&oacute;n de
desastres a microemprendimientos.\n<p>\nLos editores de esta
colecci&oacute;n son la ONG Human Info, HumanityCD Ltd y dem&aacute;s
organizaciones participantes. Cont&aacute;ctenos en: Proyecto de
Bibliotecas sobre Aspectos Humanitarios y de Desarrollo , Oosterveldiaan
196, B-2610 Antwerp, B&eacute;lgica, Tel 32-3-448.05.54, Fax
32-3-449.75.74, correo electr&oacute;nico <a
href=mailto:[email protected]>[email protected]</a>.

<h3>Cómo trabaja esta colección</h3>

La 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>).
<p>

Al 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. _text3_

<p>

<b>Plugins</b>. _text4_ 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.
<p>

Los otros plugins, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, y DirectoryPlugin, son empleados por Greenstone con fines particulares y son estándar en casi todas las colecciones.
<p>

<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>.
<p>

El 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>.
<p>

<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.
<p>

El 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>).

_text6_

El tercero le da acceso a la organización. Es un clasificador <i>List</i> basado en el metadato <i>dls.Organization</i>. _text8_

_text9_

<p>

<p>
<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


<b>Enunciados de formato</b>. _text10_
<p>
_text11_
<p>

La 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.

<p>

<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). 
<p>

<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.
<p>

<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:
<p>

<pre>
&lt;!--\n
&lt;Section&gt;\n
&lt;Description&gt;\n
&lt;Metadata name=\"Title\"&gt;\n
Haciendo realidad los derechos humanos para la gente pobre: Estrategias\n
para lograr los objetivos de desarrollo mundial\n
&lt;/Metadata&gt;\n
&lt;/Description&gt;\n
--&gt;\n
(el texto de la sección va aquí)\n
&lt;!--\n
&lt;/Section&gt;\n
-->\n
</pre>
<p>

Los 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.
<p>

<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. _text5_ 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>).
<p>

<b>Archivos de jerarquía</b>. 
"

# -- Russian text ----------------
collectionmeta  collectionextra [l=ru] "
БОблОПтекО гуЌаМОтарМПгП развОтОя преЎставляют бПльшую кПллекцОю практОческПй ОМфПрЌацОО, пПлезМПй прО ПказаМОО пПЌПщО Ўля уЌеМьшеМОя беЎМПстО, увелОчеМОя гуЌаМОтарМПгП пПтеМцОала, а также ПбеспечеМОя практОчМПгП О пПлезМПгП ПбразПваМОя Ўля всех
. ЭтП пПЎЌМПжествП сПЎержОт прОблОзОтельМП 25 публОкацОй -- ЎПкуЌеМтПв, сППбщеМОй О перОПЎОческОх
 статей -- в разлОчМых
 Пбластях
 челПвеческПгП развОтОя, Пт сельскПх
ПзяйствеММПй практОкО ЎП экПМПЌОческПй пПлОтОкО, Пт вПЎы О ПчОсткО ЎП Пбщества О культуры, Пт ПбразПваМОя ЎП прПОзвПЎства, Пт уЌеМьшеМОя беЎствОй ЎП Ќалых
 преЎпрОятОй.
<p>

ИзЎателО этПй кПллекцОО -- ГуЌаМОтарМая ОМфПрЌацОПММая МеправОтельствеММая ПргаМОзацОя 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:[email protected]>[email protected]</a>.
<p>

<h3>Как рабПтает кПллекцОя</h3>
<p>

_text1_
еслО Вы являетесь тПлькП МачОМающОЌ пПльзПвателеЌ, тП лучше вМачале ПзМакПЌОться с МекПтПрыЌО ЎругОЌО кПллекцОяЌО (МапрОЌер, с <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">msword О pdf ЎеЌПМстрацОяЌО</a> ОлО же с арх
ОваЌО ОлО с прПстПй графОческПй кПллекцОей).
<p>

<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>КПМфОгурацОПММый файл</a> кПллекцОО, пПЎПбМП всеЌ кПМфОгурацОПММыЌ файлаЌ ЎругОх
 кПллекцОй, МачОМается сП стрПкО «СПзЎатель» (\"Сreator\"), кПтПрая сППбщает аЎрес электрПММПй пПчты СПзЎателя кПллекцОО, О ЎругПй -- «ПублОка» (\"Public\"), кПтПрая ПпреЎеляет, пПявОтся лО кПллекцОя Ма ЎПЌашМей страМОце устаМПвкО Greenstone. _text3_

<p>


<b>ПлагОМы</b>. _text4_ ДПкуЌеМты в кПллекцОО DLS преЎставлеМы в HTML-фПрЌате, так чтП <i>HTMLPlugin</i> ЎПлжеМ быть включеМ. ОпцОя <i>description_tags</i> Пбрабатывает тэгО (прОзМакО) в тексте, кПтПрые ПпреЎеляют разЎелы О МаОЌеМПваМОя разЎелПв, как ПпОсаМП МОже.
<p>

ДругОе плагОМы <i>GreenstoneXMLPlugin</i>, <i>MetadataXMLPlugin</i>,<i>ArchivesInfPlugin</i> О <i>DirectoryPlugin</i> ОспПльзуются в Greenstone Ўля вМутреММОх
 целей О являются стаМЎартМыЌО пПчтО вП всех
 кПллекцОях
.
<p>

<b>ИМЎексы пПОска</b>. БлПк стрПк, МачОМающОйся с <i>indexes</i>, ПпреЎеляет, какОе пПОскПвые ОМЎексы буЎут ЎПступМы. В этПй кПллекцОО есть трО ОМЎекса. Вы ЌПжете Ох
 вОЎеть в МОспаЎающеЌ ЌеМю «ППОск» Ма <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">страМОце пПОска</a>. Первый ОМЎекс Мазывается «Главы», втПрПй -- «НазваМОя разЎелПв» О третОй -- «ППлМые ЎПкуЌеМты». НазваМОя этОх
 трех
 ОМЎексПв Ўаются треЌя ПператПраЌО <i>collectionmeta</i>.
<p>

СПЎержаМОе ОМЎексПв -- тП есть ПпОсаМОе тПгП, чтП буЎет являться преЎЌетПЌ пПОска -- ПпреЎеляется стрПкПй <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>.
<p>

<b>КлассОфОкатПры</b>. БлПк стрПк, пПЌечеММых
 <i>classify</i>, ПпреЎеляющОе ОМЎексы прПсЌПтра, в Greenstone Мазываются КлассОфОкатПраЌО. ИЌеется четыре классОфОкатПра, сППтветствующОе четыреЌ кМПпкаЌ Ма МавОгацОПММПй лОМейке Маверх
у кажЎПй страМОцы в кПллекцОО (МапрОЌер, <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">пПОскПвая страМОца</a>): <i>Указатель, НазваМОя, ОргаМОзацОО О Как</i>. ПервПй является кМПпка пПОска, а затеЌ пП пПряЎку этО четыре классОфОкатПра.
<p>

Первый классОфОкатПр ПбеспечОвает ЎПступ к преЎЌетаЌ. ЭтП Оерарх
ОческОй классОфОкатПр, кПтПрый ПпреЎеляет Оерарх
Ою в файле <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>).

_text6_

_text7_ _text8_

_text9_



<p>
<b>ИзПбражеМОя ПблПжкО</b>. ГрОМстПуМ Ощет ОзПбражеМОя ПблПжкО Ўля кажЎПгП ЎПкуЌеМта, чье ОЌя сПвпаЎает с МазваМОеЌ ЎПкуЌеМта, МП ОЌеет расшОреМОе <i>.jpg</i>. ЭтП ОзПбражеМОе ассПцООруется с ЎПкуЌеМтПЌ О ЌПжет быть ОспПльзПваться Ма страМОчке ЎПкуЌеМта (сЌПтрО МОже). ИзПбражеМОя ПблПжек ЌПжМП выключОть, ОспПльзуя флаг -no_cover_image в кажЎПЌ плагОМе. \n

<p>
<b>ОператПры фПрЌата</b>. _text10_
<p>
_text11_
<p>

БПльшОМствП ПператПрПв фПрЌата сПЎержат стрПку, указаММую в пПпПлМеММПй фПрЌе HTML. ИЌя ЌетаЎаММых
 в кваЎратМых
 скПбках
 (МапрОЌер, [<i>НазваМОе</i>], [<i>СПзЎатель</i>]) Ўают зМачеМОя этОЌ ЌетаЎаММыЌ. [<i>Текст</i>] Ўает текст ЎПкуЌеМта. ГОперссылка к ЎПкуЌеМту ЌПжет быть сПзЎаМа, ОспПльзуя [<i>link</i>]...[<i>/link</i>]; сППтветствующее ОзПбражеМОе ПблПжкО прПОзвПЎОтся с пПЌПщью [<i>icon</i>]. СтрПкО фПрЌата ЌПгут включать {<i>If</i>} {...,...}О {<i>Or</i>} {...,...}; Ўля первых
 Ўвух
 Ўаются прОЌеры. ЭтО Ўва -- ЎПвПльМП слПжМые ПператПры фПрЌата. Мы Ме буЎеЌ ПбъясМять Ох
 зЎесь. В Greenstone ОзЌеМеМОя в стрПках
 фПрЌата вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете ЌестМый сервер бОблОПтекО, кПгЎа сервер ЎПлжеМ быть пПвтПрМП запущеМ. ЭтП ПблегчОт эксперОЌеМты с разлОчМыЌО версОяЌО ПператПра фПрЌата О МаблюЎеМОе за теЌ, чтП прО этПЌ прПОсх
ПЎОт.

<p>

<b>МетаЎаММые урПвМя кПллекцОО</b>. СтрПкО <i>collectionmeta</i> в кПМфОгурацОПММПЌ файле также стаМЎартМы вП всех
 кПллекцОях
 Greenstone. ОМО Ўают Пбщую ОМфПрЌацОю П кПллекцОО, ПпреЎеляя ее МазваМОе (ОЌя), преЎставляют краткПе ПпОсаМОе, кПтПрПе пПявляется Ма ее ЎПЌашМей страМОце. КраткПе ПпОсаМОе (в <i>collectionextra</i>) ЌПжМП вОЎеть Ма ЎПЌашМей страМОце кПллекцОО (_text2_)
<p>

<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, чтПбы гараМтОрПвать вПзЌПжМПсть пПОска О Ўля МеаМглОйскОх
 языкПв.
<p>

<b>ОпОсаМОе ЎескрОптПрПв</b>. ОпОсаМОе ЎескрОптПрПв, распПзМаваеЌых
 <i>HTMLPlugin</i>, вставлеМы в HTML текста ЎПкуЌеМтПв, чтПбы ПпреЎелОть, гЎе МачОМаются О закаМчОваются разЎелы, О ПпреЎелОть МазваМОя разЎелПв. ОМО выгляЎят такОЌ ПбразПЌ:
<p>
<pre>
&lt;!--\n
&lt;Section&gt;\n
&lt;Description&gt;\n
&lt;Metadata name=\"Title\"&gt;\n
Realizing human rights for poor people: Strategies\n
for achieving the international development targets\n
&lt;/Metadata&gt;\n
&lt;/Description&gt;\n
--&gt;\n
(текст разЎела ОЎет сюЎа)\n
&lt;!--\n
&lt;/Section&gt;\n
-->\n
</pre>
<p>

Маркеры &lt;!-...-&gt; ОспПльзуются, чтПбы гараМтОрПвать, чтП этО ЎескрОптПры ПтЌечеМы как кПЌЌеМтарОО в HTML О пПэтПЌу затрагОвают фПрЌатОрПваМОе ЎПкуЌеМта. В <i>ОпОсаМОО</i> ЌПгут быть ПпреЎелеМы ЎругОе вОЎы ЌетаЎаММых
, МП этП Ме сЎелаМП Ўля стОля кПллекцОО, кПтПрую Ќы ПпОсываеЌ зЎесь. ТПчМП такая же спецОфОкацОя (включая О &lt;!-...-&gt; Ќаркеры) ЌПгут ОспПльзПваться также в ЎПкуЌеМтах
 Word.
<p>

<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_ Оба сПх
раМеМы в качестве ЌетаЎаММых
 Ўля этПгП спецОфОческПгП ЎПкуЌеМта, пПтПЌу чтП сПстПяМОе=МакаплОвать (<i>mode=accumulate</i>) ПпреЎелеМП, а в качестве альтерМатОвы - зМачеМОе пП уЌПлчаМОю, кПтПрыЌ является <i>mode=override</i>.
<p>

<b>Иерарх
ОческОе файлы</b>. _text12_

"