source: collections/documented-examples/trunk/bibtex-e/etc/collect.cfg@ 19362

creator     [email protected]
maintainer  [email protected]
public      true

buildtype   mgpp

groupsize   200

indexes     text metadata

plugin  BibTexPlugin -OIDtype assigned -OIDmetadata Number
plugin  GreenstoneXMLPlugin
plugin  MetadataXMLPlugin
plugin  ArchivesInfPlugin
plugin  DirectoryPlugin

classify    AZList -metadata Title
classify    AZCompactList -metadata Author -buttonname Creator
classify    DateList -metadata Date

classify    Phind -text document:Title,document:Creator,document:Booktitle,document:Publisher

format SearchTypes "form,plain"

format VList "<td valign=top>[link][icon][/link]</td>
<td valign=top><b>[Title]</b> - <i>{Or}{[Creator],[Editor]}</i>
{If}{[Year], - [Month] [Year]}</td>"

format CL2VList "<td valign=top>[link][icon][/link]</td>
<td valign=top>{If}{[numleafdocs],<b>[Title]</b>,
<b>[Author]</b> ([Creator]) -- <i>[Title]</i>}
{If}{[Year], - [Month] [Year]}</td>"

format DateList "<td valign=top>[link][icon][/link]</td>
<td valign=top><b>[Title]</b> - <i>{Or}{[Creator],[Editor]}</i></td>"

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

format DocumentHeading "<H1>[Title]</H1><hr><table>
{If}{[Creator],<tr><td><b>_AuthoredBy_:</b></td><td>[Creator]</td></tr>}
{If}{[Title],<tr><td><b>_PaperTitle_:</b></td><td>[Title]</td></tr>}
{If}{[Editor],<tr><td><b>_Editors_:</b></td><td>[Editor]</td></tr>}
{If}{[EditorRole],<tr><td><b>_EditorRole_:</b></td><td>[EditorRole]</td></tr>}
{If}{[Booktitle],<tr><td><b>_BookJournalTitle_:</b></td><td>[Booktitle]</td></tr>}
{If}{[Journal],<tr><td><b>_In_:</b></td><td>[Journal]</td></tr>}
{If}{\\"[Volume][Number]\\",<tr><td>}
{If}{[Number], <b>_Number_:</b></td><td> [Number]}
{If}{[Volume], <b>_Vol_:</b> [Volume]}
{If}{\\"[Volume][Number]\\",</td></tr>}
{If}{[MeetingDate],<tr><td><b>_MeetingDate_:</b></td><td>[MeetingDate]</td></tr>}
{If}{[MeetingPlace],<tr><td><b>_MeetingPlace_:</b></td><td>[MeetingPlace]</td></tr>}
{If}{[PublicationPlace],<tr><td><b>_PublicationPlace_:</b></td><td>[PublicationPlace] </td></tr>}
{If}{[Publisher],<tr><td><b>_Publisher_:</b></td><td>[Publisher]</td></tr>}
{If}{[Year],<tr><td><b>_PublicationDate_:</b></td><td>[Month] [Year]</td></tr>}
{If}{[Pages],<tr><td><b>_Pages_:</b></td><td>[Pages]</td></tr>}
{If}{[DocType],<tr><td><b>_DocType_:</b></td><td>[DocType]</td></tr>}
{If}{[Location],<tr><td><b>_LocationURL_:</b></td><td>[Location]</td></tr>}
{If}{[Notes],<tr><td><b>_Annotations_:</b></td><td>[Notes]</td></tr>}
{If}{[Abstract],<tr><td><b>_Abstract_:</b></td><td>[Abstract]</td></tr>}
{If}{[Keywords],<tr><td><b>_Keywords_:</b></td><td>[Keywords]</td></tr>}
</table><hr>"

format DocumentText "{If}{_cgiargshowrecord_,
<b>_BibTeXrecord_:</b><br/><tt>[Text]</tt><br><center>
<a href=\'_gwcgi_?e=_cgiarge_&c=_cgiargc_&cl=_cgiargcl_&a=d&d=_cgiargd_\'>_HideBibTeXrecord_</a></center>,
<center><a href=\'_gwcgi_?e=_cgiarge_&c=_cgiargc_&cl=_cgiargcl_&a=d&d=_cgiargd_&showrecord=1\'>
_ShowBibTeXrecord_</a></center>}"

format DocumentButtons ""
format DocumentContents false

collectionmeta  sampleoid [l=en] "13/2004"

collectionmeta  collectionname [l=en] "Bibliography collection"
collectionmeta  .text [l=en] "full records"
collectionmeta  .Title [l=en] "titles"
collectionmeta  .Source [l=en] "filenames"

collectionmeta  AuthoredBy [l=en] "Authored By"
collectionmeta  PaperTitle [l=en] "Paper Title"
collectionmeta  Editors [l=en] "Editor(s)"
collectionmeta  EditorRole [l=en] "Editor Role"
collectionmeta  BookJournalTitle [l=en] "Book/Journal Title"
collectionmeta  In [l=en] "In"
collectionmeta  Number [l=en] "Number"
collectionmeta  Vol [l=en] "Vol."
collectionmeta  MeetingDate [l=en] "Meeting Date"
collectionmeta  MeetingPlace [l=en] "Meeting Place"
collectionmeta  PublicationPlace [l=en] "Publication Place"
collectionmeta  Publisher [l=en] "Publisher"
collectionmeta  PublicationDate [l=en] "Publication Date"
collectionmeta  Pages [l=en] "Pages"
collectionmeta  DocType [l=en] "DocType"
collectionmeta  LocationURL [l=en] "Location/URL"
collectionmeta  Annotations [l=en] "Annotations"
collectionmeta  Abstract [l=en] "Abstract"
collectionmeta  Keywords [l=en] "Keywords"

collectionmeta  BibTeXrecord [l=en] "BibTeX Record"
collectionmeta  ShowBibTeXrecord [l=en] "Show BibTeX Record"
collectionmeta  HideBibTeXrecord [l=en] "Hide BibTeX Record"

# -- French strings ----------------
collectionmeta  collectionname [l=fr] "Collection bibliographie"

collectionmeta  .text [l=fr] "enregistrements complets"

collectionmeta  AuthoredBy [l=fr] "Nom de l\'auteur"
collectionmeta  PaperTitle [l=fr] "Titre de l\'article"
collectionmeta  Editors [l=fr] "Editeur(s)"
collectionmeta  EditorRole [l=fr] "RÎle de l\'éditeur"
collectionmeta  BookJournalTitle [l=fr] "Titre de Livre/Journal"
collectionmeta  In [l=fr] "Dans"
collectionmeta  Number [l=fr] "Numéro"
collectionmeta  Vol [l=fr] "Vol."
collectionmeta  MeetingDate [l=fr] "Date de rencontre"
collectionmeta  MeetingPlace [l=fr] "Lieu de rencontre"
collectionmeta  PublicationPlace [l=fr] "Lieu de publication"
collectionmeta  Publisher [l=fr] "Editeur"
collectionmeta  PublicationDate [l=fr] "Date de publication"
collectionmeta  Pages [l=fr] "Pages"
collectionmeta  DocType [l=fr] "TypeDocument"
collectionmeta  LocationURL [l=fr] "Emplacement/URL"
collectionmeta  Annotations [l=fr] "Annotations"
collectionmeta  Abstract [l=fr] "Résumé"
collectionmeta  Keywords [l=fr] "Mots-clés"

collectionmeta  BibTeXrecord [l=fr] "Enregistrement BibTeX"
collectionmeta  ShowBibTeXrecord [l=fr] "Montrer Enregistrement BibTeX"
collectionmeta  HideBibTeXrecord [l=fr] "Cacher l\'enregistrement BibTeX"

# -- Spanish strings ----------------
collectionmeta  collectionname [l=es] "Colección bibliográfica"

collectionmeta  .text [l=es] "registros completos"

collectionmeta  AuthoredBy [l=es] "Autor"
collectionmeta  PaperTitle [l=es] "Título del documento"
collectionmeta  Editors [l=es] "Editor(es)"
collectionmeta  EditorRole [l=es] "Papel del editor"
collectionmeta  BookJournalTitle [l=es] "Título del libro o revista"
collectionmeta  In [l=es] "En"
collectionmeta  Number [l=es] "Número"
collectionmeta  Vol [l=es] "Volumen"
collectionmeta  MeetingDate [l=es] "Fecha de la reunión"
collectionmeta  MeetingPlace [l=es] "Lugar de la reunión"
collectionmeta  PublicationPlace [l=es] "Lugar de la publicación"
collectionmeta  Publisher [l=es] "Editorial"
collectionmeta  PublicationDate [l=es] "Fecha de publicación"
collectionmeta  Pages [l=es] "Páginas"
collectionmeta  DocType [l=es] "Tipo de documento"
collectionmeta  LocationURL [l=es] "Ubicación/URL"
collectionmeta  Annotations [l=es] "Anotaciones"
collectionmeta  Abstract [l=es] "Resumen"
collectionmeta  Keywords [l=es] "Palabras clave"

collectionmeta  BibTeXrecord [l=es] "Registro BibTeX"
collectionmeta  ShowBibTeXrecord [l=es] "Mostrar registro BibTeX"
collectionmeta  HideBibTeXrecord [l=es] "Ocultar registro BibTeX"

# -- Russian strings ----------------
collectionmeta  collectionname [l=ru] "БОблОПграфОческая кПллекцОя"

collectionmeta  .text [l=ru] "ППлМые запОсО"

collectionmeta  AuthoredBy [l=ru] "АвтПр"
collectionmeta  PaperTitle [l=ru] "НазваМОе статьО"
collectionmeta  Editors [l=ru] "РеЎактПр (ы)"
collectionmeta  EditorRole [l=ru] "РПль реЎактПра"
collectionmeta  BookJournalTitle [l=ru] "НазваМОе кМОгО/журМала"
collectionmeta  In [l=ru] "В"
collectionmeta  Number [l=ru] "ЧОслП (НПЌер)"
collectionmeta  Vol [l=ru] "ТПЌ"
collectionmeta  MeetingDate [l=ru] "Дата встречО"
collectionmeta  MeetingPlace [l=ru] "МестП встречО"
collectionmeta  PublicationPlace [l=ru] "Дата ПублОкацОО"
collectionmeta  Publisher [l=ru] "ИзЎатель"
collectionmeta  PublicationDate [l=ru] "Дата ПублОкацОО"
collectionmeta  Pages [l=ru] "СтраМОцы"
collectionmeta  DocType [l=ru] "ТОп ЎПкуЌеМта"
collectionmeta  LocationURL [l=ru] "МестПпПлПжеМОе/URL"
collectionmeta  Annotations [l=ru] "АММПтацОО"
collectionmeta  Abstract [l=ru] "РезюЌе"
collectionmeta  Keywords [l=ru] "Ключевые слПва"

collectionmeta  BibTeXrecord [l=ru] "ЗапОсь BibTeX"
collectionmeta  ShowBibTeXrecord [l=ru] "ППказать запОсь BibTeX"
collectionmeta  HideBibTeXrecord [l=ru] "Скрытая запОсь BibTeX"

# -- English text ----------------
collectionmeta  collectionextra [l=en] "
This collection, which contains _about:numdocs_
BibTeX entries, is a collection of working papers published from 1997 to 2006
at <a href=\"http://www.cs.waikato.ac.nz/\">Department of Computer Science</a>,
<a href=\"http://www.waikato.ac.nz/\">the University of Waikato</a>.\n

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

<p>
The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
configuration file</a> begins with the specification <i>groupsize 200</i>.
This groups 200 documents together into a single archive file. Bibliography collections
typically have many small documents, and grouping them together prevents
Greenstone\'s internal file structures from becoming bloated and occupying more
disk space than necessary.\n

<p>
Apart from the standard plugins, this collection uses <i>BibTexPlugin</i>,
which processes references in the BibTeX format (well known to computer
scientists). Two options have been set for BibTexPlugin:
<i>-OIDtype assigned -OIDmetadata Number</i>. This means the metadata
element \"Number\" will be used as the record identifier, instead of
Greenstone\'s default hash identifiers. These options are available for
all plugins.\n

<p>
Fielded searching, with a form-based interface, is selected by <i>format SearchTypes \"form,plain\"
</i> in the configuration file. In fact, a plain textual full-text search
index is included in this collection as well (since <i>form</i> comes first,
it is the default interface; you reach the <i>plain</i> search through
the <i>Preferences</i> page).\n

<p>
The <i>buildtype</i> option shows that the default search engine <i>mgpp</i> is
used. The <i>indexes</i> line specifies indexes for \"text\", and \"metadata\". In this case, \"text\" will be the original BibTeX record. \"metadata\" is a special keyword signifying that an index should be built for any metadata item found in the collection.
Thus when the \"field\" menus in the
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1\">search page</a> are pulled down, they show
<i>full records</i> followed by an entry for each metadata element.
Collection-level metadata <i>collectionmeta</i> can be specified for any index
to determine what it is called in the menu (except for <i>metadata</i>, which
produces many menu items). In this case, the
<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>configuration
file</a> specifies that the text index should be named \"full records\" because it
contains the original bibliographic record.\n
<p>
An additional keyword, \"allfields\", could also be used in the <i>indexes</i> line, specifying that combined searching over all indexes should be available. 
<p>
The <i>levels</i> lines specifies only document level, as bibliographic records don\'t have internal structure.
<p>
This collection contains <i>Title, Author</i>, and <i>Date</i> browsers, and a
special kind of phrase index called \"Phind.\" The <i>AZCompactList</i>
classifier used for the <i>Author</i> browser is like <i>AZList</i> but
generates a bookshelf for duplicate items as shown <a
href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">here</a>. The BibTeX plugin records each
author as <i>Author</i> metadata; it also puts a list containing all authors
into the <i>Creator</i> metadata element. Consequently the <i>AZCompactList</i>
classifier is based on <i>Author</i>. However, Greenstone has a standard button
reading <i>authors</i> whose name is (confusingly) \"Creator\", so this
button name is specified for the classifier.\n

<p>
The \"Phind\" classifier creates a phrase index like
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL4\">this</a>. It contains a browsable list
of phrases extracted from the material specified
in the <i>text</i> argument of the <i>classify Phind</i> line in the
<a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>configuration file</a>.
Here the specification is\n
<pre>
document:Title,document:Creator,document:Booktitle,document:Publisher
</pre>\n

-- that is, the title, list of authors, title of the collected work (if any) in
which this item appears, and publisher. Note that this specification follows
the <i>mg</i> convention with <i>level:field</i>. <i>Phind</i> indexes are more
usually based on the entire full text of a collection, using the specification
<i>document:text</i>.\n

<p>
The best way to see what Phind does is to play with this index. You type a word in
the search box, click <i>Search</i>, and a list of phrases containing that term
appears in the top panel. Click on one of these phrases and a list of phrases
containing that <i>phrase</i> appears in the bottom panel. You can continue
doing this, expanding the phrase more and more. The lists can be lengthened
using the <i>get more phrases </i> button. At the end of the list of phrases
appears a list of documents containing that phrase, in blue text; you can
lengthen this list by clicking get <i>more documents</i>.\n

<p>
The format statements for the search results list and the title browser are
both determined by the <i>VList</i> specification. It gives a document icon
that links to the document itself (which in this collection is the full
reference); the title in bold; <i>Creator</i> metadata if there is any,
otherwise <i>Editor</i> metadata; and <i>Month, Year</i> metadata if there is any.
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1&r=1&hs=1&fqa=0&fqv=Jain,,,&fqf=TX,CR,BO,SO\">Here</a>
is an example.\n

<p>
The format statement for the author browser (<i>CL2VList</i>) is more
complex. The <i>AZCompactList</i> classifier generates a tree whose nodes are
either leaf nodes, representing documents, or internal nodes. A metadata item
called <i>numleafdocs</i> gives the total number of documents below an internal
node. This format statement checks whether numleafdocs exists. If so the node
must be an internal node, in which case the node is labeled by its
<i>Title</i>. But beware: this classifier is generated on <i>Author</i>
metadata, so its title -- the title of the classifier -- is actually the author\'s
name! This means that the bookshelf nodes
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">here</a> are labeled by author\'s name.
The leaf nodes, however, are labeled the same way as documents (i.e. references)
are in the search results list.\n

<p>
The documents themselves (here is an
<a href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_\">example</a>)
are generated by two format statements, one (a long one)
called <i>DocumentHeading</i>, and another called <i>DocumentText</i>. The
<i>DocumentHeading</i>, which is the top two-thirds of the page, contains the
document\'s <i>Title</i> followed by a table that gives all the metadata
elements that the BibTeX plugin can generate. The role of all the <i>If</i>
statements in the <a href=\"_httpcollection_/etc/collect.cfg\"
target=collect.cfg>configuration file</a> is to determine which elements are
defined.\n

<p>
The <i>DocumentText</i> shows the BibTeX version of the reference. However,
when the document is displayed initially, only a hyperlink reading <i>Show
BibTex Record</i> appears -- this corresponds to the last part (that is, the
\"else\" part) of the <i>If</i> statement in <i>DocumentText</i>. When this
hyperlink is clicked, the <i>href</i> goes to the same URL but with
<i>showrecord=1</i>, which generates a page like <a
href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_&showrecord=1\">this</a>.
The <i>If</i> test succeeds, which shows the <i>Text</i> of the document. With
the BibTeX plugin, the text of a document is its unadulterated BibTeX record.\n
"

# -- French text ----------------
collectionmeta  collectionextra [l=fr] "
Cette collection qui contient des entrées _about:numdocs_ BibTex, est working papers éditées de 1997 à 2006
au <a href=\"http://www.cs.waikato.ac.nz/\">Département d\'informatique</a>, <a href=\"http://www.waikato.ac.nz/\">Université de Waikato</a>.\n

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

<p>
Le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de
configuration de la collection</a> commence par la spécification
<i>groupsize 200</i>. _text2_
Les collections de bibliographies ont généralement beaucoup de petits documents; le fait de les regrouper empêche le gonflement des structures de fichiers internes et l\'occupation inutile d\'espace disque.

<p>
_text1_

<p>
La recherche par champ à travers une interface basée sur un formulaire est sélectionnée par <i>format SearchTypes \"form,plain\"</i> dans le fichier de configuration. En fait, cette collection utilise <i>format SearchTypes \"form,plain\"</i> qui contient aussi un index de recherche de texte simple textuelle (puisque <i>form</i> vient en premier, c\'est l\'interface par defaut; vous accédez à la recherche <i>plain</i> a travers la page <i>Préférences</i>).

<p>
_text3_
Ainsi, quand les menus déroulants \"Field\" dans la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1\">page recherche</a> sont
sélectionnés, ils montrent <i>Full records</i> suivi par une entrée pour
chaque élément de méta-donnée. Une méta-donnée <i>collectionmeta</i> de niveau collection peut être spécifiée pour tout index pour déterminer
ce qui est appele dans le menu (exceptÚ pour <i>metadata</i> qui
produit beaucoup d\'éléments de menu). Dans ce cas,le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier
de configuration</a> spécifie que l\'index du texte devrait être
appele \"full records\" parcequ\'il contient l\'enregistrement bibliographique
original.
<p>
_text4_
<p>
Cette collection contient les \"browsers\" <i>Title</i>, <i>Author</i>,et <i>Date</i> ainsi qu\'un type special d\'index de phrase appele \"Phind\".
Le classificateur <i>AZCompactList</i> utilisé pour le browser <i>Author</i> est comme <i>AZList</i> mais produit un rayon pour les éléments dupliqués comme montré <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">ici</a>. Le plugin BibTEX enregistre chaque auteur comme méta-donnée <i>Author</i>; il met aussi une liste contenant tous les auteurs dans l\'élément de méta-donnée <i>Creator</i>.
Par conséquent, le classificateur <i>AZCompactList</i> est basé sur <i>Author</i>. Cependant, Greenstone a un bouton standard appelé <i>authors</i> dont le nom (qui prête à confusion) est \"Creator\", ainsi le nom
de ce bouton est spécifié pour le classificateur.

<p>
Le classificateur \"Phind\" crée un index d\'expression comme <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL4\">ceci</a>. Il contient une liste d\'expressions qu\'on peut parcourir extraite du materiel spécifié dans l\'argument <i>text</i> de la ligne
<i>Classify Phind</i> du <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de configuration</a>.
Ici, la spécification est :
<pre>
document:Title,document:Creator,document:Booktitle,document:Publisher
</pre>

-- c\'est le titre, la liste des auteurs, le titre du travail
recueilli (s\'il y en a) dans lequel chaque article apparaît,
et l\'éditeur. Il faut noter que cette spécification suit la
convention <i>mg</i> avec <i>level:field</i>. Les indexes <i>Phind</i>
sont généralement plus basés sur le texte entier de la collection,
en utilisant la spécification <i>document:text</i>.

<p>
La meilleure façon de voir ce que fait Phind est de jouer
avec cet index. Vous tapez un mot dans la boîte recherche,
cliquez <i>Search</i>, et une liste d\'expressions contenant ce terme
apparaît en haut du tableau. Cliquez sur une de ces expressions
et une liste d\'expressions contenant cette <i>expression</i> apparaît
au bas du tableau. Vous pouvez continuer à faire ceci en
allongeant l\'expression de plus en plus. Ces listes peuvent
être allongees en utilisant le bouton <i>Get more phrases</i>.
A la fin de la liste d\'expression une liste de document
contenant cette expression apparaît dans un texte bleu, vous
pouvez allonger cette liste en cliquant sur Get <i>more documents</i>.

<p>
Le format de déclaration pour la liste de résultats de recherche
et le browser de titre sont tous les deux déterminés par la spécification <i>VList</i>. Elle donne une icÎne de document qui renvoie sur le document lui-même (qui est la référence complÚte dans cette collection);
le titre en gras; la méta-donnée <i>Creator</i> s\'il y en a, sinon la méta-donnée <i>Editor</i>; et la méta-donnée <i>Month, Year</i> s\'il y en a. En <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1&r=1&hs=1&fqa=0&fqv=Jain,,,&fqf=TX,CR,BO,SO\">voici</a> un exemple.

<p>
Le format de déclaration pour le browser auteur (<i>CL2VList</i>) est plus
complexe. Le classificateur <i>AZCompactList</i> donne un arbre dont les nœuds
sont soit des nœuds de feuilles représentant des documents ou des
nœuds internes. Un élément de de méta-donnée appelé <i>numleafdocs</i> donne le nombre total de documents en dessous d\'un nœud interne. La déclaration de
format vérifie si numleafdocs existe. Si le nœud doit être un nœud
interne, dans ce cas le nœud est catalogue par son <i>Title</i>.
Mais attention : ce classificateur est produit sur la méta-donnée <i>Author</i>, donc son titre -- le titre du classificateur -- est en fait le nom de l\'auteur! Ceci signifie que les nœuds des rayons sont catalogués <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">ici</a> suivant le nom de l\'auteur. Les nœuds d\'extrémité sont catalogués dans la liste des résultats de recherche de la même façon que les documents (c.-à -d. les références) .

<p>
Les documents eux-mêmes (voici un <a href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_\">exemple</a>) sont produits par
deux déclarations de format, une (longue celle-la) appelée <i>DocumentHeading</i>, et une autre appelée <i>DocumentText</i>. Le <i>Document Heading</i>, qui est représente les deux tiers supérieurs de la page contient le <i>Titre</i> du document suivi d\'une table qui
donne tous les éléments de méta-donnée que le plugin BibTex peut générer.
Le rÃŽle de toutes les instructions <i>If</i> dans le <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>fichier de
configuration</a> est de déterminer les éléments définis.

<p>
Le <i>DocumentText</i> montre la version BibTex de la référence.
Cependant, quand le document est affiché la premiÚre fois, seul
le lien <i>ShowBibtexRecord</i> apparaît --- ceci correspond à la derniÚre partie (c\'est la partie \"else\") de l\'instruction <i>If</i> dans <i>DocumentText</i>. Quand le lien est cliqué, <i>href</i> va vers la même URL mais avec <i>showrecord=1</i>, qui génÚre une page comme <a
href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_&showrecord=1\">celle-ci</a>. Le test <i>If</i> marche, ce qui affiche le <i>Text</i> du document. Avec le plugin BibTex, le texte d\'un document est son enregistrement BibTEX pur.
"

# -- Spanish text ----------------
collectionmeta  collectionextra [l=es] "
Esta colección contiene entradas _about:numdocs_ BibTeX y ha sido creada a partir de la Bibliografía de la working papers published from 1997 to 2006 at <a href=\"http://www.cs.waikato.ac.nz/\">Department of Computer Science</a>, <a href=\"http://www.waikato.ac.nz/\">the University of Waikato</a>.\n

<h3>Cómo trabaja esta colección</h3>
<p>
El <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración de la colección</a> empieza con la especificación <i>groupsize 200</i>. Esto agrupa 200 documentos dentro de un único archivo. Por lo general las colecciones bibliográficas tienen muchos documentos pequeños y al agruparlos se evita que las estructuras de archivos internos de Greenstone se inflen demasiado y ocupen más espacio del necesario.
<p>
Además de los plugins estándar, esta colección utiliza <i>BibTexPlugin</i>, 
el cual procesa referencias en formato BibTeX  (bien conocido entre los científicos). Se han fijado dos  opciones para BibTexPlugin: 
<i>-OIDtype assigned -OIDmetadata Number</i>. Esto significa que el elemento de metadato \"Number\" se usará como identificador de registro, en lugar de los identificadores hash de Greenstone. Estas opciones están disponibles para todos los plugins.\n

<p>
La búsqueda por campos con una interfaz basada en formas se selecciona por medio de la <i>format SearchTypes \"form,plain\"</i> en el archivo de configuración. De hecho, esta colección también utiliza la <i>forma searchtype de sólo texto</i>, la cual incluye asimismo un  índice de búsqueda de textos completos (ya que <i>form</i> viene primero, ésta es la interfaz por omisión; la búsqueda <i>plain</i> se puede seleccionar por medio de la página de <i>Preferencias</i>).

<p>
La opción <i>buildtype</i> muestra que el motor de búsqueda utilizado por defecto es el <i>mgpp</i>. La línea <i>indexes</i>  especifica los índices \"text\", y \"metadata\". En este caso, \"text\" será el registro original BibTeX. \"metadata\" es una clave especial que significa que debe construirse un índice por cada metadato encontrado en la colección. 

Así, cuando los menús de \"campo\" se despliegan en la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1\">página de búsqueda</a>, muestran el <i>registro completo</i> seguido de una entrada para cada elemento del metadato. El metadato a nivel de colección <i>collectionmeta</i> se puede especificar para cualquier índice con el fin de determinar lo que se llama en el menú (excepto metadato, que produce varios ítems). En este caso el <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración</a> especifica que el índice de texto debería llamarse \"registro completo\", debido a que contiene el registro bibliográfico original.
<p>
Una clave adicional, \"allfields\", también puede usarse en la línea <i>indexes</i>, especificando una búsqueda combinada sobre todos los índices disponibles.<p> La línea <i>levels</i> indica solamente el nivel de documento, ya que los registros bibliográficos no poseen una estructura interna.
<p>
Esta colección contiene exploradores de <i>Título</i>, <i>Autor</i> y <i>Fecha</i>, así como un tipo especial de índice de frases llamado \"Phind\". El clasificador <i>AZCompactList</i> que se usa para el explorador de <i>Autor</i> es como <i>AZList</i>, pero genera un estante para los ítems duplicados tal como se muestra <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">aquí</a>. El plugin BibTeX registra a cada autor como metadato de <i>Author</i>. También coloca una lista de todos los autores en el elemento del metadato <i>Creator</i>. Como resultado de ello, el clasificador <i>AZCompactList</i> se basa en el <i>Author</i>. Sin embargo, Greenstone tiene un botón estándar que lee los <i>autores</i> y cuyo nombre es (de manera un tanto confusa) \"Creator\", por lo que el nombre de este botón ha sido especificado para el clasificador.
<p>

El clasificador \"Phind\" crea un índice de frases como <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL4\">este</a>, el cual contiene una lista que se puede explorar de frases extraídas del material especificado en el argumento de texto de la línea <i>clasificar Phind</i> en el <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>archivo de configuración</a>. Aquí la especificación es
<p>

<pre>
document:Title,document:Creator,document:Booktitle,document:Publisher
</pre>\n

<p>

es decir, el título, la lista de autores, el título del trabajo (si es que hay alguno) en el que aparece este ítem y el editor. Recuerde que esta especificación sigue la convención <i>mg</i> con <i>level:field</i>. Los índices <i>Phind</i> se basan más comúnmente en el texto completo de una colección por medio de la especificación <i>document:text</i>.
<p>

La mejor forma de ver lo que hace Phind es practicar con este índice. Escriba una palabra en el cuadro de búsqueda, haga click en <i>Buscar</i> y una lista de frases con dicho término aparecerá en el panel de la parte superior. Haga click en una de estas frases y una lista de frases que contengan dicha <i>frase</i> aparecerá en el panel de la parte inferior. Usted puede continuar extendiendo la frase más y más. Las listas se pueden alargar utilizando el botón <i>obtener más frases</i>. Al final de la lista de frases aparece una lista de los documentos que contienen dicha frase en azul. Usted puede extender esta lista haciendo click en más documentos.
<p>

Los enunciados de formato para la lista de resultados de la búsqueda y el explorador de títulos se determinan por medio de la especificación <i>VList</i>. Ésta proporciona un icono de documento que lo vincula con el documento mismo (el cual es en esta colección la referencia completa), el título en negritas, el metadato <i>Creator</i> si es que hay alguno o en su defecto el metadato <i>Editor</i>, y el metadato de <i>Month, Year</i> si es que hay alguno. He <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1&r=1&hs=1&fqa=0&fqv=Jain,,,&fqf=TX,CR,BO,SO\">aquí</a> un ejemplo.
<p>

El enunciado de formato para el explorador de autor (<i>CL2VList</i>) es más complejo. El clasificador AZCompactList genera un árbol cuyos nodos son hojas representando documentos o nodos internos. Un ítem de metadato llamado <i>numleafdocs</i> proporciona el número total de documentos debajo de un nodo interno. Este enunciado de formato comprueba si numleafdocs existe. En caso afirmativo se trata de un nodo interno, en cuyo caso el nodo se etiquetará por su <i>Título</i>. ¡Pero cuidado! Este clasificador se genera en el metadato <i>Autor</i>, por lo que su título -- el título del clasificador -- es realmente el nombre del autor, lo que significa que los nodos del estante que están <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">aquí</a> se etiquetan de acuerdo al nombre del autor. Las hojas se etiquetan de la misma manera que los documentos (es decir, referencias) en la lista de resultados de la búsqueda.
<p>

Los documentos mismos (he aquí un <a href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_\">ejemplo</a>) se generan por medio de dos enunciados de formato, uno llamado <i>DocumentHeading</i>, que es bastante largo, y otro llamado <i>DocumentText</i>. DocumentHeading ocupa los dos tercios superiores de la página y contiene el <i>Título</i> del documento seguido por una tabla de todos los elementos del metadato que el plugin BibTeX puede generar. El papel de todos los enunciados <i>If</i> en el <a href=\"_httpcollection_/etc/collect.cfg\"
target=collect.cfg>archivo de configuración</a> es determinar los elementos que se definen.
<p>

<i>DocumentText</i> muestra la versión BibTeX de la referencia. Sin embargo, cuando el documento se despliega por primera vez únicamente aparece un hipervínculo llamado <i>Mostrar Registro BibTex</i>. Este corresponde a la última parte (es decir, a la parte \"adicional\") del enunciado <i>If</i> en <i>DocumentText</i>. Cuando se hace click en este hipervínculo la <i>href</i> va al mismo URL pero con showrecord=1, que genera una página como <a
href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_&showrecord=1\">ésta</a>. A continuación sigue la prueba <i>If</i>, que muestra el <i>Texto</i> del documento. Con el plugin BibTeX el texto de un documento es su registro BibTeX no adulterado.
"

# -- Russian text ----------------
collectionmeta  collectionextra [l=ru] "
Эта кПллекцОя, кПтПрая сПЎержОт элеЌеМты запОсО _about:numdocs_ BibTeX, is a collection of working papers published from 1997 to 2006
at <a href=\"http://www.cs.waikato.ac.nz/\">Department of Computer Science</a>,
<a href=\"http://www.waikato.ac.nz/\">the University of Waikato</a>.\n.

<p>

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

<p>

Ѐайл кПМфОгурацОО кПллекцОО МачОМается с ПпреЎелеМОя <i>groupsize 200</i>, **кПтПрПе ПбъеЎОМяет ЎПкуЌеМты в группы пП 200**. БОблОПграфОческОе кПллекцОО ПбычМП сПстПят Оз бПльшПгП чОсла МебПльшОх
 ЎПкуЌеМтПв, О группОрПвка Ох
 вЌесте преЎПтвращает вМутреММОе файлПвые структуры Greenstone Пт увелОчеМОя ПбъёЌа О заМятОя бПльшегП ЎОскПвПгП прПстраМства, чеЌ МеПбх
ПЎОЌП.

<p>

_text1_

<p>
_text5_


<p>
_text3_

<p>


ТакОЌ ПбразПЌ, кПгЎа Ма пПОскПвПй страМОце пПявляется спускающееся ЌеМю \"пПле\", в МёЌ пПказаМ пПлМый спОсПк, сПпрПвПжЎающОй прО
вх
ПЎе Ўля кажЎПгП элеЌеМта ЌетаЎаММых
. МетаЎаММые Ма урПвМе кПллекцОО <i>collectionmeta</i> ЌПгут быть заЎаМы Ўля любПгП ОМЎекса, чтПбы ПпреЎелОть, чтП этП ПзМачает в ЌеМю (за ОсключеМОеЌ <i>metadata</i>, кПтПрПе сПзЎает ЌМПгП пуМктПв ЌеМю). В этПЌ случае <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>кПМфОгурацОПММый файл</a> ПпреЎеляет, чтП текстПвый ОМЎекс ЎПлжеМ быть МазваМ \"<i>full record</i>\", пПтПЌу чтП ПМа сПЎержОт ПрОгОМальМую бОблОПграфОческую запОсь.

<p>
_text4_
<p>
Эта кПллекцОя сПЎержОт прПграЌЌы прПсЌПтра пП <i>НазваМОю</i>, <i>АвтПру О Дате</i>, О спецОальМый вОЎ ОМЎекса фразы, МазываеЌый \"<i>Phind</i>\". КлассОфОкатПр <i>AZCompactList</i>, ОспПльзуеЌый Ўля прПсЌПтра пП <i>АвтПру</i>, пПх
Пж <i>Ма AZList</i>, МП геМерОрует кМОжМую пПлку Ўля ЎублОкатПв, как пПказаМП зЎесь. ПлагОМ BibTeX сПставляет запОсь Ўля кажЎПгП автПра пП ЌетаЎаММыЌ <i>Author</i>; ПМ также пПЌещает спОсПк, сПЎержащОй перечеМь всех
 автПрПв, в элеЌеМт ЌетаЎаММых
 <i>СПзЎатель</i> (<i>Creator</i>). ТакОЌ ПбразПЌ, классОфОкатПр <i>AZCompactList</i> базОруется Ма пПле <i>Author</i>. ОЎМакП в Greenstone ОЌеется стаМЎартМая кМПпка, чОтающаяся как <i>АвтПры</i>, чье МаОЌеМПваМОе ПтЎалеММП сППтветствует <i>Creator</i>, так чтП МазваМОе этПй кМПпкО ОспПльзПваМП Ўля классОфОкатПра.

<p>

КлассОфОкатПр \"Phind\" сПзЎает ОМЎекс фразы пПЎПбМП <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL4\">пПказаММПЌу зЎесь</a>. ОМ сПЎержОт спОсПк ЎПступМых
 Ўля прПсЌПтра фраз, ОзвлечеММых
 Оз ЌатерОала, указаММПгП в аргуЌеМте <i>text</i> стрПкО <i>classify</i> в <i>Phind</i> кПМфОгурацОПММПгП файла. ОпреЎелеМОяЌО зЎесь являются

<p>
<pre>
document:Title,document:Creator,document:Booktitle,document:Publisher
</pre>\n
<p>

(<i>ЎПкуЌеМт:НазваМОе, ЎПкуЌеМт:СПзЎатель, ЎПкуЌеМт:ЗагПлПвПк кМОгО, ЎПкуЌеМт: ИзЎатель</i>)

тП есть МазваМОе, спОсПк автПрПв, МазваМОе любПгП сбПрМОка рабПт, в кПтПрПЌ этПт пуМкт пПявляется, О ОзЎатель. ОбратОте вМОЌаМОе, чтП этО ПпреЎелеМОя сППтветствуют ПбычМПЌу <i>mg</i> Ма урПвМе:пПле (<i>level:field</i>). ИМЎексы чаще базОруются Ма ПсМПве пПлМПтекстПвПй кПллекцОО, ОспПльзуя спецОфОкацОю <i>ЎПкуЌеМта:text</i>.

<p>

ￜучшОй спПсПб увОЎеть, чтП <i>Phind</i> Ўелает, сПстПОт в тПЌ, чтПбы пПОграть с этОЌ ОМЎексПЌ. Вы МапечаталО слПвП в пПле пПОска, щелкМулО <i>ППОск</i>, О спОсПк фраз, сПЎержащОх
 этПт терЌОМ, пПявляется Ма верх
Мей паМелО. ЩелкМОте Ма ПЎМПй Оз этОх
 фраз, О спОсПк, сПЎержащОй эту фразу, пПявляется Ма МОжМей паМелО. Вы ЌПжете прПЎПлжать Ўелать этП, расшОряя фразу все бПлее. СпОскО ЌПгут быть увелОчеМы, ОспПльзуя кМПпку <i>get more phrases</i>. В кПМце спОска фраз пПявляется спОсПк ЎПкуЌеМтПв, сПЎержащОх
 эту фразу, ПкрашеММый в сОМОй цвет. Вы ЌПжете расшОрОть этПт спОсПк путеЌ щелчка Ма <i>more documents</i>.

<p>

ОператПры фПрЌата Ўля спОска результатПв пПОска О МаОЌеМПваМОе браузера Пба ПпреЎелеМы в спецОфОкацОО <i>VList</i>. ОМО сПзЎают ОзПбражеМОе (ОкПМку) ЎПкуЌеМта, кПтПрПе связывается с саЌОЌ ЎПкуЌеМтПЌ (кПтПрый в ЎаММПй кПллекцОО является пПлМПй ссылкПй); <i>НазваМОе</i> выЎелеМП пПлужОрМыЌ шрОфтПЌ; ЌетаЎаММые <i>Creator??СПзЎателя</i> ЎПкуЌеМта, еслО такПвПй ОЌеется, ОлО же ЌетаЎаММые <i>Editor??ИзЎателя</i> О ЌетаЎаММые <i>Month, YearДаты</i>, еслО ПМа существует. <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q&ct=1&qt=1&r=1&hs=1&fqa=0&fqv=Jain,,,&fqf=TX,CR,BO,SO\">ЗЎесь</a> прОвПЎОтся прОЌер.

<p>

ОператПр фПрЌата Ўля пПказа автПра (<i>CL2Vlist</i>) является бПлее слПжМыЌ. КлассОфОкатПр <i>AZCompactList</i> геМерОрует ЎеревП, узлы кПтПрПгП являются ОлО узлаЌО спОска, преЎставляя ЎПкуЌеМты, ОлО же вМутреММОЌО узлаЌО. ПуМкт ЌетаЎаММых
, МазываеЌый <i>numleafdocs</i>, Ўает Пбщее кПлОчествП ЎПкуЌеМтПв, распПлПжеММых
 МОже вМутреММегП узла. ЭтПт ПператПр фПрЌата прПверяет, существуют лО чОслП лОстПв ЎПкуЌеМтПв <i>numleafdocs</i>. ЕслО этП так, тП узел ЎПлжеМ быть вМутреММОЌ узлПЌ. В этПЌ случае ОЌеет свПю Ќетку <i>НазваМОе</i>. НП ОЌейте в вОЎу, чтП этПт классОфОкатПр прПОзвеЎеМ Ма ПсМПве ЌетаЎаММых
 <i>АвтПра</i>, так чтП егП МазваМОе - МазваМОе классОфОкатПра -- является фактОческО ОЌеМеЌ автПра. ЭтП ПзМачает, чтП узлы кМОжМПй пПлкО <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2\">зЎесь</a> МазваМы ОЌеМеЌ автПра. Узлы лОста, ПЎМакП, пПЌечеМы такОЌ же ПбразПЌ, как ЎПкуЌеМты (тП есть ссылкО Ма МОх
), Мах
ПЎящОеся в спОске результатПв пПОска.

<p>

СаЌО же ДПкуЌеМты (зЎесь ОЌеется <a href=\"_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=CL1.12&d=_sampleoid_\">прОЌер</a>), геМерОруются ЎвуЌя ПператПраЌО фПрЌата, ПЎОМ Оз кПтПрых
 (ЎлОММый) МазваМ <i>DocumentHeading</i>, а ЎругПй - <i>DocumentText</i>. <i>DocumentHeading</i>, кПтПрый сПставляет верх
МОе Ўве третО страМОцы, сПЎержОт <i>НазваМОе</i> ЎПкуЌеМта, сПпрПвПжЎаеЌПе таблОцей, кПтПрая сПЎержОт все элеЌеМты ЌетаЎаММых
, кПтПрые плагОМ BibTex ЌПжет геМерОрПвать. НазМачеМОе всех
 ПператПрПв <i>If</i> в кПМфОгурацОПММПЌ файле сПстПОт в тПЌ, чтПбы решОть, какОе элеЌеМты ПпреЎелеМы.

<p>

<i>DocumentText</i> пПказывает BibTex-версОю ссылкО. ОЎМакП, кПгЎа ЎПкуЌеМт пПказаМ в первый раз, пПявляется тПлькП гОперссылка <i>Show BibTex Record</i>. ЭтП сППтветствует пПслеЎМей частО, тП есть зМачеМОю \"ЎругПй\" ПператПра <i>If</i> в <i>DocumentText</i>. ЕслО щелкМуть Ма этПй гОперссылке, <i>href</i> ОЎет к тПЌу же саЌПЌу URL, МП с <i>Showrecord=1</i>, кПтПрый геМерОрует страМОцу пПЎПбМП этПй. ППслеЎующОй тест <i>If</i> пПказывает <i>Текст</i> ЎПкуЌеМта. ПлагОМ <i>BibTeX</i> Ўает запОсь текста ЎПкуЌеМта в фПрЌате <i>BibTeX</i>.
"