source: collections/documented-examples/trunk/garish-e/etc/collect.cfg@ 19115

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

buildtype   mgpp
searchtypes plain,form

indexes     text dls.Title,Title dls.Subject dls.Organization dls.Keyword

levels  section document

plugin  GreenstoneXMLPlugin
plugin  HTMLPlugin -description_tags
plugin  MetadataXMLPlugin
plugin  ArchivesInfPlugin
plugin  DirectoryPlugin

classify    List -metadata dls.Title

classify    Hierarchy -metadata "dls.Subject" -sort dls.Title

classify    List -sort_leaf_nodes_using dls.Title -metadata dls.Organization -bookshelf_type always

classify    List -metadata dls.Keyword -buttonname Howto

format CL4VList "<td>[link][icon][/link]</td><td>[link][dls.Keyword][/link]"

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

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

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

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

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

format SearchTypes "plain,form"

# -- English strings ----------------
collectionmeta  collectionname [l=en] "Garish version of demo collection"

collectionmeta  .text [l=en] "text"
collectionmeta  .dls.Title,Title [l=en] "titles"
collectionmeta  .dls.Subject [l=en] "subjects"
collectionmeta  .dls.Organization [l=en] "organizations"
collectionmeta  .dls.Keyword [l=en] "how to"

collectionmeta  .document [l=en] "book"
collectionmeta  .section [l=en] "chapter"

collectionmeta  depositormetadata [l=en] "{\"name\":\"dls.Title\",\"label\":\"Title\",\"tooltip\":\"dls.Title: The title of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Organization\",\"label\":\"Organization\",\"tooltip\":\"dls.Organization: The organization responsible for producing this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Subject\",\"label\":\"Subject\",\"tooltip\":\"dls.Subject: The subject of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Keyword\",\"label\":\"Keyword\",\"tooltip\":\"dls.Keyword: A more specific indication of what the resource can be used for.\",\"type\":\"text\"}, {\"name\":\"dls.Language\",\"label\":\"Language\",\"tooltip\":\"dls.Language: The language of this resource.\",\"type\":\"text\"}"

# -- French strings ----------------
collectionmeta  collectionname [l=fr] "Version Garish de la collection de démonstration"

collectionmeta  .text [l=fr] "texte"
collectionmeta  .dls.Title,Title [l=fr] "titres"
collectionmeta  .dls.Subject [l=fr] "sujets"
collectionmeta  .dls.Organization [l=fr] "organisations"
collectionmeta  .dls.Keyword [l=fr] "comment faire"
collectionmeta  .document [l=fr] "livre"
collectionmeta  .section [l=fr] "châpitre"

# -- Spanish strings ----------------
collectionmeta  collectionname [l=es] "Versión Garish de la colección de muestra"

collectionmeta  .text [l=es] "texo"
collectionmeta  .dls.Title,Title [l=es] "títulos"
collectionmeta  .dls.Subject [l=es] "temas"
collectionmeta  .dls.Organization [l=es] "organizaciones"
collectionmeta  .dls.Keyword [l=es] "cómo"
collectionmeta  .document [l=es] "libro"
collectionmeta  .section [l=es] "capítulo"

# -- Russian strings ----------------
collectionmeta  collectionname [l=ru] "Резкая версОя ЎеЌПМстрацОПМ-МПй кПллекцОО"

collectionmeta  .text [l=ru] "текст"
collectionmeta  .dls.Title,Title [l=ru] "загПлПвкО"
collectionmeta  .dls.Subject [l=ru] "указателО"
collectionmeta  .dls.Organization [l=ru] "ПргаМОзацОО"
collectionmeta  .dls.Keyword [l=ru] "спПсПбы"
collectionmeta  .document [l=ru] "кМОга"
collectionmeta  .section [l=ru] "глава"

# -- Arabic strings ----------------

collectionmeta  .text [l=ar] "نص"
collectionmeta  .dls.Title,Title [l=ar] "العناوين"
collectionmeta  .dls.Subject [l=ar] "الم
وضوعات"
collectionmeta  .dls.Organization [l=ar] "الم
ن؞م
ات"
collectionmeta  .dls.Keyword [l=ar] "إر؎اد"
collectionmeta  .document [l=ar] "كتاؚ"
collectionmeta  .section [l=ar] "فصل"

# -- Brazilian Portuguese strings ----------------

collectionmeta  .text [l=pt-br] "texto"
collectionmeta  .dls.Title,Title [l=pt-br] "títulos"
collectionmeta  .dls.Subject [l=pt-br] "assuntos"
collectionmeta  .dls.Organization [l=pt-br] "organizações"
collectionmeta  .dls.Keyword [l=pt-br] "como fazer"
collectionmeta  .document [l=pt-br] "livro"
collectionmeta  .section [l=pt-br] "capítulo"

# -- Thai strings ----------------
collectionmeta  .text [l=th] "àž‚à¹‰àž­àž„àž§àž²àž¡"
collectionmeta  .dls.Title,Title [l=th] "àžŠàž·à¹ˆàž­à¹€àž£àž·à¹ˆàž­àž‡"
collectionmeta  .dls.Subject [l=th] "àž«àž±àž§à¹€àž£àž·à¹ˆàž­àž‡"
collectionmeta  .dls.Organization [l=th] "àž«àž™à¹ˆàž§àž¢àž‡àž²àž™"
collectionmeta  .dls.Keyword [l=th] "àž§àžŽàž˜àžµà¹ƒàžŠà¹‰"

collectionmeta  .document [l=th] "àž«àž™àž±àž‡àžªàž·àž­"
collectionmeta  .section [l=th] "àžšàž—"

# -- Simplified Chinese strings ----------------
collectionmeta  .text [l=zh] "文本"
collectionmeta  .dls.Title,Title [l=zh] "题名"
collectionmeta  .dls.Subject [l=zh] "䞻题"
collectionmeta  .dls.Organization [l=zh] "机构"
collectionmeta  .dls.Keyword [l=zh] "劂䜕"

collectionmeta  .document [l=zh] "乊"
collectionmeta  .section [l=zh] "ç« "

# -- English text ----------------
collectionmeta  collectionextra [l=en] "This demonstration collection contains the same material as the original Greenstone demo collection, but its appearance has been altered to look garish.\n

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

<p> 
The appearance of Greenstone collections is defined by \"macro files\" in the
<i>greenstone/macros</i> directory, and can be completely altered by changing the contents of these files.
Editing them will change the appearance of all collections. To change the appearance of just one collection, place appropriately modified macros in a file called <i>extra.dm</i> in the collection's <i>macros</i> directory. For example, this collection uses the file <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
<p>
To separate presentation details from the macro files,
Greenstone uses <i>Cascading Style Sheets</i>
(see <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> for
more information), which allow you to specify fonts, colours, spacings, and
other elements for HTML pages. The standard Greenstone stylesheet is located in <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. This collection specifies an auxiliary stylesheet, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, to be used in addition to the default ones. It includes some comments
for those unfamiliar with cascading style sheets. Some of the
macros in <i>extra.dm</i> reference images that have been placed in
<i>greenstone/collect/_cgiargc_/images</i>.\n
<p>
The
<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
macro file overrides some of the macros that Greenstone
uses by default. In macro files, the \"\#\" character signals a comment line
(<i>extra.dm</i> is commented to help explain what it does). 
Macros themselves are signalled by
underscores, and they can reference other macros. This means that the
content of a page can be split into many small chunks, and it can be
difficult to work through the chain of which macro calls what. Fortunately,
changes in macros (like changes in format strings) take effect immediately
unless you are using the Greenstone local library server, in which case the
server needs to be restarted. This makes it easy to experiment by editing
the macro files.\n

<p>
Macros are grouped into \"packages\". But each package does not necessarily reside in
a single file. The <i>Global</i> package, most of which is in file
<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>
(parts of it are also in the language-specific macro files such as
<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> and
<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
contains default macros that can be overridden by macros in other packages. Here is the part
of <i>extra.dm</i> that redefines global macros.
<pre>
##########################################################################\n
package Global\n
##########################################################################\n
\n
&#095;starthighlight&#095; {&lt;b&gt;}\n
&#095;endhighlight&#095;   {&lt;/b&gt;}\n
\n
&#095;navbarspacer&#095; { \n
&lt;br/&gt;\n
&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
&lt;br/&gt;\n
}\n
</pre>\n
The values of <i>starthighlight</i> and <i>endhighlight</i> are used to
highlight query terms when displaying a document. The default is to set the
background to yellow. The first specification above places query terms in
bold instead.\n

<p>
Next, the <i>navbarspacer</i> macro is what separates the search button and
classifier buttons in the navigation bar. It is normally Greenstone\'s
familiar horizontal green bar. The following definition has the effect of 
stacking the buttons vertically, one above the other.
<pre>
&#095;navbarspacer&#095; {&lt;br\/&gt;}
</pre>\n

 The definition of <i>navbarspacer</i> given earlier uses the image
<i>horzline.gif</i> as a separator (this image appears in the
<i>images</i> directory of the collection). The effect can be seen at the top of this page.\n

<p>
To arrange the buttons horizontally, still using
<i>horzline.gif</i> instead of the green bar as separator,
remove the <i>br</i> tags and define the body of the macro
(the part in curly brackets) to be:
<pre>
&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
</pre>\n

The <i>widthtspace</i> variable gives the width of the gap between the
buttons, which Greenstone calculates.\n

<p>
The part of <i>extra.dm</i> reproduced below redefines macros in the
<i>Style</i> package, which is responsible for creating the header and
footer of every page, and defining common style information:
<pre>
##########################################################################\n
package Style\n
##########################################################################\n
\n

&#095;collectionspecificstyle&#095; {\n
&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
&lt;style&gt;\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
&lt;/style&gt;\n
}\n
\n
&#095;pagebanner&#095; {\n
&lt;div class=\"pageinfo\"&gt; \n
&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
&lt;/div&gt;\n
}\n
</pre>\n

Greenstone\'s page header macro, which is called <i>header</i> in
<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>,
prints the collection\'s name or logo, and links to the
home, help, and preferences pages. It calls the macro <i>htmlhead</i> which
outputs the beginning of an HTML file. This calls the macro <i>cssheader</i> which outputs style information for the page. This macro includes the <i>collectionspecificstyle</i> macro which allows a collection to add some style elements to the default. 

<p>To use an entirely new style for the collection, specify the <i>cssheader</i> macro in <i>extra.dm</i>. To just add just a few style declarations to the default style, specify <i>collectionspecificstyle</i> in <i>extra.dm</i>. That is what this collection has done. The above <i>collectionspecificstyle</i> macro includes the collection's own stylesheet, and also overrides a couple of the image declarations, getting rid of the green swirly bar background, and changing the hover background for navigation bar buttons to blue.

<p>
 The page header macro also calls <i>pagebanner</i> to include the collection\'s logo,
home/help/preferences buttons, and the image at the top left that
identifies the page (about page, search page, etc). The code above
redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear
at the top of this page.\n

<p>
The next part of <i>extra.dm</i> redefines macros in the <i>about</i>
package (contained in
<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), which generates the
\"About this collection\" page that you are looking at now:
<pre>
##########################################################################\n
package about\n
##########################################################################\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;textabout&#095;\n
\n
&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
&#095;help:simplehelp&#095;\n
}
</pre>\n

The macro <i>content</i> for the <i>About</i> page normally contains the
navigation bar (with links to <i>Search</i> and any classifiers),
followed by \"About this collection\" and \"how to find information\"
text. Because it changes from one collection to another, the
<i>navigationbar</i> macro is defined internally by Greenstone, and uses
the <i>navbarspacer</i> macro discussed above. The <i>content</i> macro for
the <i>About</i> page, given above, differs from the regular one
(such as the one for the demo collection <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">here</a>)
in that the navigation bar is not centered, and there is no search box.\n

<p>
The next part of <i>extra.dm</i> redefines macros in the <i>query</i> package (in
<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
which is used to generate the
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>:
<pre>
##############################################################################\n
package query\n
##############################################################################\n

&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&lt;center&gt;\n
&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
&lt;/center&gt;\n
&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
&lt;center&gt;\n
&#095;searchhistorylist&#095;\n
&lt;/center&gt;)\n
&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
&lt;br&gt;\n
}\n
</pre>\n

The definition of <i>content</i> in the standard <i>query</i> package is
similar to the version given above, except that it centers the
<i>navigationbar</i> macro, whereas the above version does not, and it
includes an additional green bar. Compare
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">this</a>
and
<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">this</a>.\n

<p>
The file
<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
also redefines macros in the <i>document</i> package,
which is used to display documents (see 
<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). In fact, pages
generated by classifiers (e.g. lists of titles) are also governed by these macros.
<pre>
##########################################################################\n
package document\n
##########################################################################\n
\n
&#095;textheader&#095; {\n
&#095;cgihead&#095;\n
&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
}\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
&lt;p style=\"text-align: center;\"&gt;\n
&#095;phindclassifier&#095;\n
&#095;collageclassifier&#095;\n
&lt;/p&gt;\n
)\n
\n
&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
&lt;ul id=\"searchresults\"&gt;\n
&#095;prevsearchresult&#095;\n
&#095;nextsearchresult&#095;\n
&lt;/ul&gt;)\n
\n
&lt;div class=\"document\"&gt;\n
}\n
</pre>\n

Greenstone overrides the <i>header</i> macro if a document (and not a
classifier) is being displayed. Suppose we don\'t want it to. The code
above redefines the <i>textheader</i> macro (normally defined in
<i>document.dm</i>) to be the content of the original <i>header</i> macro. The definition of <i>content</i> above overrides the
default so that the navigation bar is not centered.
"


# -- French text ----------------
collectionmeta  collectionextra [l=fr] "
Cette collection de démonstration contient le même matériel que la collection de démontration originale de Greenstone, mais son apparence a été altéré pour avoir une allure criarde.

<h3>Comment la collection marche</h3>

<p>
L'apparence des collections Greenstone est définie par des \"fichiers de macros\" dans le répertoire <i>greenstone/macros</i> et elle peut être complÚtement modifiée en changeant le contenu de ces fichiers. L' édition de ceux-ci changera l' apparence de toutes les collections.Pour changer l' apparence d' une seule collection, il faut placer correctement les macros modifiés dans un fichier appelé <i>extra.dm</i> dans le répertoirede la collection <i>macros</i>. Par exemple, cette collection utilise le fichier <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
<p>
Pour séparer certains détails de présentation des fichiers de macros, Greenstone utilise <i>Cascading Style Sheets</i>(voir <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> pour plus d' information), ce qui vous permet de spécifier la police, les couleurs, les espaces, et autres éléments pour les pages HTML. Le 'stylesheet' de Greenstone standardisé est alloqué dans <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Cette collection spécifie un 'stylesheet' auxiliaire, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, à être utilisé à part ceux du défaut. Ceci inclus quelques commentaires qui ont été placés dans <i>greenstone/collect/_cgiargc_/images</i>.\n
<p>
Le fichier de macros <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
l'emporte sur certaines des macros que Greenstone utilise par défaut. Dans des fichiers de macros, le caractÚre \"\#\" signale une ligne de commentaire(<i>extra.dm</i> est commenté pour expliquer ce qu'il fait). Les macros elles-mêmes sont signalées par des caractÚres \"souligné\" (\"_\") et elles peuvent référencer d'autres macros. Ceci signifie que le contenu d'une page peut être éclaté en plusieurs petits morceaux et il peut être difficile de retrouver dans la chaîne et de savoir quelle macro appelle quoi. Heureusement, des modifications dans des macros (comme des modifications dans les chaînes de format) prennent effet immédiatement, à moins que vous n'utilisiez le serveur de bibliothÚque locale de Greenstone; dans ce cas, le serveur doit être redémarré. Ceci rend facile l'expérimentation en éditant les fichiers de macros.

<p>
Les macros sont regroupées en \"paquetages\". Mais chaque paquetage ne réside pas forcément dans un fichier unique. Le paquetage <i>Global</i>, dont la majeure partie réside dans le fichier 
<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (d'autres parties se trouvent aussi dans les fichiers de macros spécifiques aux langues, comme <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> et <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
contient des macros par défaut qui peuvent être écrasées par des macros d'autres paquetages. Voici la partie de <i>extra.dm</i> qui redéfinit des macros globales.

<pre>
##########################################################################\n
package Global\n
##########################################################################\n
\n
&#095;starthighlight&#095; {&lt;b&gt;}\n
&#095;endhighlight&#095;   {&lt;/b&gt;}\n
\n
&#095;navbarspacer&#095; { \n
&lt;br/&gt;\n
&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
&lt;br/&gt;\n
}\n
</pre>\n

Les valeurs de <i>starthighlight</i> et <i>endhighlight</i> sont utilisées pour mettre en valeur des termes de requête au moment de l'affichage d'un document. Le défaut est de mettre l'arriÚre-plan en jaune. La premiÚre des spécifications ci-dessus place les termes de requête en gras.

<p>
Ensuite, la macro <i>navbarspacer</i> est ce qui sépare le bouton de recherche des bouton de classificateurs dans la barre de navigation. C'est normalement la horizontale verte familiÚre de Greenstone. La définition suivante a l' effet d' entasser les boutons verticalement, un sur l' autre.
<pre>
&#095;navbarspacer&#095; {&lt;br\/&gt; }
</pre>\n

La définition de <i>navbarspace</i> donnée auparavant utilise l' image <i>horzline.gif</i> comme un séparateur (cette image apparaît dans le répertoire <i>images</i> de la collection). L' effet peut être visualisé dans la partie suppérieure de cette page. \n

<p>
Pour ranger les boutons horizontalement, utilisez toujours <i>horzline.gif</i> comme séparateur au lieu de la barre verte, supprimez les étiquettes <i>br</i> et définissez le corps de la macro (la partie entre parenthÚses) comme ceci:
<pre>
&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
</pre>\n

La variable <i>widthtspace</i> donne la largeur de l'espace entre les boutons que Greenstone calcule.

<p>
La partie de <i>extra.dm</i> reproduite ci-dessous redéfinit des macros dans le paquetage <i>Style</i>, qui est responsable de la création de l'en-tête et du pied de chaque page, et définissant information de style commun:

<pre>
##########################################################################\n
package Style\n
##########################################################################\n
\n

&#095;collectionspecificstyle&#095; {\n
&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
&lt;style&gt;\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
&lt;/style&gt;\n
}\n
\n
&#095;pagebanner&#095; {\n
&lt;div class=\"pageinfo\"&gt; \n
&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
&lt;/div&gt;\n
}\n
</pre>\n

La macro de l'en-tête de la page de Greenstone, appelée <i>header</i> dans 
<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, affiche le nom ou le logo de la collection, et crée un lien vers la page d'accueil, l'aide, et les pages des préférences. Elle appelle la macro <i>htmlhead</i> qui affiche le début d'une page HTML. Ceci appelle le macro <i>cssheader</i> qui output le style d' information pour cette page. Ce macro comprend le macro <i>collectionspecificstyle</i> qui permet la collection d' additionner quelques éléments-style au défaut. 
<p>
Pour utiliser entiÚrement un nouveau style pour la collection, spécifiez le macro <i>cssheader</i> dans <i>extra.dm</i>. Pour ajouter seulement quelques déclarations de style, spécifiez le <i>collectionspecificstyle</i> dans <i>extra.dm</i>. C' est ceci ce que la collection a fait. Le macro ci-dessus <i>collectionspecificstyle</i> comprend la feuillestyle de la propre collection, et annule aussi quelques une des déclarations images, enlevant la barre verte curvée du fond d' écran, et en changeant le fond hover pour les boutons de la barre de navigation en bleu. \n 
<p>
La macro d'entête de page appelle aussi <i>pagebanner</i> pour inclure le logo de la collection, des boutons /accueil/aide/préférences, et l'image en haut à gauche qui identifie la page (page \"à propos\", page de recherche, etc). Le code ci-dessus redéfinit la banniÚre pour supprimer ces images à l' exception du bouton de la page d' entrée -- comme vous pouvez le voir, elles n'apparaissent pas en haut de cette page. \n 

<p>
La partie suivante de <i>extra.dm</i> redéfinit des macros dans la paquetage <i>about</i> (\"<i>à propos</i>\") (contenu dans <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), qui génÚre la page \"About this collection\" que vous voyez actuellement:
<pre>
##########################################################################\n
package about\n
##########################################################################\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;textabout&#095;\n
\n
&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
&#095;help:simplehelp&#095;\n
}
</pre>\n

La macro <i>content</i> pour la page <i>About</i> (\"<i>A propos</i>\") contient normallement la barre de navigation (avec des liens vers <i>Search</i> et tous classificateurs), suivie du texte \"About this collection\" (\"A propos de cette collection\") et \"how to find information\" (\"comment trouver de l'information\"). Parce qu'elle change d'une collection à l'autre, la macro de la <i>barre de navigation</i> est définie en interne par Greenstone, et utilise la macro <i>navbarspacer</i> traitéé ci-dessus. La macro <i>content</i> (\"<i>contenu</i>\") pour la page <i>About</i> (\"<i>A propos</i>\"), donnée ci-dessus, diffÚre de la macro habituelle (comme celle pour la collection Demo <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">ici</a>)
en ce sens que la barre de navigation n'est pas centrée et qu'il n'y a pas de boîte de recherche.

<p>
La partie suivante de <i>extra.dm</i> redéfinit des macros dans le paquetage <i>query</i> (\"<i>requête</i>\") (dans <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
qui est utilisé pour générer la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>:
<pre>
##############################################################################\n
package query\n
##############################################################################\n

&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&lt;center&gt;\n
&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
&lt;/center&gt;\n
&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
&lt;center&gt;\n
&#095;searchhistorylist&#095;\n
&lt;/center&gt;)\n
&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
&lt;br&gt;\n
}\n
</pre>\n

La définition de <i>content</i> dans le paquetage de <i>requête</i> standard est similaire à la version donnée ci-dessus, excepté le fait qu'elle centre la macro <i>barre de navigation</i>, alors que la version ci-dessu ne le fait pas, et qu'elle inclut une barre verte supplémentaire. Comparez
<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ceci</a> Ã  <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">ceci</a>.

<p>
Le fichier <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> redéfinit aussi des macros dans le paquetage <i>document</i> qui est utilisé pour afficher des documents (voir 
<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). En fait, les pages générées par des classificateurs (par xemple listes de titres) sont aussi contrÎlées par ces macros.

<pre>
##########################################################################\n
package document\n
##########################################################################\n
\n
&#095;textheader&#095; {\n
&#095;cgihead&#095;\n
&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
}\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
&lt;p style=\"text-align: center;\"&gt;\n
&#095;phindclassifier&#095;\n
&#095;collageclassifier&#095;\n
&lt;/p&gt;\n
)\n
\n
&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
&lt;ul id=\"searchresults\"&gt;\n
&#095;prevsearchresult&#095;\n
&#095;nextsearchresult&#095;\n
&lt;/ul&gt;)\n
\n
&lt;div class=\"document\"&gt;\n
}\n
</pre>\n

Greenstone neutralise le macro <i>header</i> si un document (et non un classificateur) est en-train d' être visualisé. Supposons qu' on ne veut pas ceci. Le code ci-dessus redéfinit le macro <i>textheader</i> (normalement définit dans <i>document.dm,/i>) pour être le contenu du macro <i>header</i> originel. La définition de <i>content</i> ci-dessus neutralise le défault pour que la barre de navigation ne soit pas sentrée.
"


# -- Spanish text ----------------
collectionmeta  collectionextra [l=es] "
Esta colección de muestra contiene el mismo material que la colección de muestra Greenstone original, pero su apariencia ha sido modificada para hacerla más llamativa.
<p>

<h3>Cómo trabaja esta colección</h3>
<p>
La apariencia de las colecciones Greenstone se define por medio de los \"archivos de macros\" que se encuentran en el directorio de <i>macros</i> y puede ser modificada completamente cambiando el contenido de estos archivos. Editando estos cambiará la apariencia de todas las colecciones. Para cambiar la apariencia de unicamente una colección, coloque apropiadamente la macros modificado en un archivo llamado <i>extra.dm</i> en el directorio de la colección <i>macros</i>. Por ejemplo, este directorio utiliza un archivo llamado <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n

<p>
Para separar ciertos detalles de la presentación de los archivos de macros, Greenstone utiliza <i>Cascading Style Sheets</i>(ver <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> para mas información), que le permite especificar la fuente, los colores, espacios, y otros elementos para las páginas HTML. La hojaestilo Greenstone estándar está alocada en <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Esta colección especifica una hojaestilo auxiliar, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, a ser usada en adición a las de defaul. Esto incluye algunos comentarios para aquellos para aquellos que no están familiarizados con hojas estilo cascada. Algunos de los macro en <i>extra.dm</i> refieren a imágenes que han sido colocadas en <i>greenstone/collect/_cgiargc_/images</i>.\n

<p>

El archivo <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> sustituye algunas de las macros que Greenstone utiliza por omisión. En los archivos de macros el carácter \"\#\" indica una línea de comentario (<i>extra.dm</i> incluye comentarios que explican lo que hace). Las macros se indican por medio de corchetes y pueden hacer referencia a otras macros. Esto significa que el contenido de una página puede dividirse en muchas cadenas más pequeñas, ya que puede resultar difícil trabajar a través de la cadena a la cual la macro hace referencia. Afortunadamente los cambios en las macros (al igual que los cambios en las cadenas de formato) tienen efecto inmediatamente a menos que se esté usando el servidor local Greenstone, en cuyo caso el servidor necesita reiniciarse. Esto hace que sea fácil experimentar editando archivos de macros. 
<p>

Las macros se agrupan en \"paquetes\". Pero cada paquete no reside necesariamente en un solo archivo. El paquete <i>Global</i>, cuya mayor parte se encuentra en el archivo <a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (partes de él también están en los archivos de macros específicas de cada idioma como <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> y <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>) contiene macros por omisión que se pueden sustituir por macros de otros paquetes. Esta es la parte de <i>extra.dm</i> que redefine las macros globales. 
<p>

<pre>
##########################################################################\n
package Global\n
##########################################################################\n
\n
&#095;starthighlight&#095; {&lt;b&gt;}\n
&#095;endhighlight&#095;   {&lt;/b&gt;}\n
\n
&#095;navbarspacer&#095; { \n
&lt;br/&gt;\n
&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
&lt;br/&gt;\n
}\n
</pre>\n

<p>
Los valores de <i>starthighlight</i> y <i>endhighlight</i> se utilizan para resaltar los términos de la consulta cuando aparece en pantalla un documento. El valor por omisión es poner el fondo en amarillo. En vez de eso la primera especificación que aparece arriba pone los términos de la consulta en negritas. 
<p>

A continuación la macro <i>navbarspacer</i> es la que separa el botón de búsqueda y los botones de los clasificadores en la barra de navegación. Por lo general es la familiar barra verde horizontal de Greenstone. La siguiente definición tiene el efecto de amontonar los botones verticalmente, uno sobre el otro.
<p>

<pre>
&#095;navbarspacer&#095; {&lt;br\/&gt;} \n
</pre>\n
<p>

La definición de <i>navbarspacer</i> data anteriormente usa la imágen <i>horzline.gif</i> como un separador (esta imágen aparece en el directorio de la colección <i>images</i>).  El efecto puede ser visto en la parte superior de esta página. \n
<p>

Para ordenar los botones horizontalmente y seguir usando <i>horzline.gif</i> en vez de la barra verde como separador, quite las etiquetas <i>br</i> y defina el cuerpo de la macro (la parte entre llaves {} ) de la siguiente manera:
<p>

<pre>
&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
</pre>\n
<p>

La variable <i>widthtspace</i> da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
<p>

La parte de <i>extra.dm</i> que se reproduce a continuación redefine las macros que se encuentran en el paquete de <i>Estilo</i>, el cual es responsable de crear el encabezado y pie de cada página, y define información de estylo común:

<p>

<pre>
##########################################################################\n
package Style\n
##########################################################################\n
\n

&#095;collectionspecificstyle&#095; {\n
&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
&lt;style&gt;\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
&lt;/style&gt;\n
}\n
\n
&#095;pagebanner&#095; {\n
&lt;div class=\"pageinfo\"&gt; \n
&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
&lt;/div&gt;\n
}\n
</pre>\n

<p>

La macro de encabezado de página de Greenstone, llamado <i>encabezado</i> en <a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, imprime el nombre o el logotipo de la colección y establece vínculos con las páginas principal, de ayuda y de preferencias. También remite a la macro <i>htmlhead</i>, que muestra el inicio de un archivo HTML. Esto llama al macro <i>cssheader</i> lo que hace que salga información para la página. Este macro incluye el macro <i>collectionspecificstyle</i> el cual permite a la colección sumar algunos elementos de estilo a la falla.

<p>
Para utilizar enteramente el nuevo estilo para la colección, especifique el macro <i>cssheader</i> en <i>extra.dm</i>. Para simplemente agregar un par de declaraciones de estilos al estilo de falla, especifique <i>collectionspecificstyle</i> en <i>extra.dm</i>. Eso es lo que la colección ha hecho. El macro arriba <i>collectionspecificstyle</i> incluye el 'stylesheet' de la colección misma, y a la vez anula un par de declaraciones de imágen, deshaciendose del fondo de pantalla de la barra verde curva, y cambiando a azul el fondo planeado para los botones de la barra de navegación.
<p>
La macro de encabezado de la página también remite a <i>pagebanner</i> para incluir el logotipo de la colección, los botones principal/ayuda/preferencias y la imagen en la parte superior izquierda que identifica la página (acerca de esta página, buscar página, etc.). Este código redefine el rótulo con el fin de suprimir estas imágenes a la exepción del boton de la página de entrada-- como se puede ver aquí, no aparecen en la parte superior de esta página.
<p>

La siguiente parte de <i>extra.dm</i> redefine las macros del paquete <i>acerca de</i> (que se encuentra en <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), el cual genera la página \"Acerca de esta colección\" que usted está viendo en este momento. 
<p>

<pre>
##########################################################################\n
package about\n
##########################################################################\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;textabout&#095;\n
\n
&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
&#095;help:simplehelp&#095;\n
}
</pre>\n
<p>

La macro de <i>contenido</i> para la página <i>Acerca de</i> normalmente contiene la barra de navegación (con vínculos hacia <i>Búsqueda</i> y cualquier clasificador) seguida por el texto \"Acerca de esta colección\" y \"cómo encontrar información\". Debido a que éste cambia de una colección a otra, la macro <i>navigationbar</i> es definida internamente por Greenstone y utiliza la macro <i>navbarspacer</i> descrita arriba. La macro de <i>contenido</i> para la página <i>Acerca de</i> que se menciona arriba difiere de la normal (como la de la colección Demo que se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">aquí</a>) en que la barra de navegación no está centrada y no hay cuadro de búsqueda. 
<p>

La siguiente parte de <i>extra.dm</i> redefine las macros del paquete de <i>consulta</i> (que se encuentra en <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>), el cual se utiliza para generar la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">página de búsqueda</a>. 
<p>

<pre>
##############################################################################\n
package query\n
##############################################################################\n

&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&lt;center&gt;\n
&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
&lt;/center&gt;\n
&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
&lt;center&gt;\n
&#095;searchhistorylist&#095;\n
&lt;/center&gt;)\n
&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
&lt;br&gt;\n
}\n
</pre>\n
<p>

La definición de <i>contenido</i> en el paquete de <i>consulta</i> estándar es similar a la versión dada arriba, excepto que centra la macro <i>navigationbar</i>, mientras que la versión de arriba no lo hace, e incluye una barra verde adicional. Compárese <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ésta</a> con <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">ésta</a>. 
<p>

El archivo <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> también redefine las macros del paquete de <i>documentos</i>, el cual se utiliza para mostrar los documentos en pantalla (véase <a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). De hecho, las páginas generadas por medio de clasificadores (p. ej. las listas de títulos) también se rigen por estas macros. 
<p>

<pre>
##########################################################################\n
package document\n
##########################################################################\n
\n
&#095;textheader&#095; {\n
&#095;cgihead&#095;\n
&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
}\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
&lt;p style=\"text-align: center;\"&gt;\n
&#095;phindclassifier&#095;\n
&#095;collageclassifier&#095;\n
&lt;/p&gt;\n
)\n
\n
&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
&lt;ul id=\"searchresults\"&gt;\n
&#095;prevsearchresult&#095;\n
&#095;nextsearchresult&#095;\n
&lt;/ul&gt;)\n
\n
&lt;div class=\"document\"&gt;\n
}\n
</pre>\n
<p>

Greenstone anula el macro <i>header</i> si el documento (y no un clasificador) está siendo mostrado. Supongamos que no queremos que esto suceda. El código aqui arriba redefine el macro <i>textheader</i> (normalmente definido en <i>document.dm</i>) para ser el contenido del macro original <i>header</i>. La definición de <i>content</i> aqui arriba anula la omisión para que la barra de navidgación no esté centrada.
"


# -- Russian text ----------------
collectionmeta  collectionextra [l=ru] "
Эта ЎеЌПМстрацОПММая кПллекцОя сПЎержОт тПт же ЌатерОал, чтП О ПрОгОМальМая ЎеЌПМстрацОПММая кПллекцОя Greenstone, МП её вОЎ был ОзЌеМеМ., чтПбы улучшОть резкПсть.
<p>

<h3>Как рабПтает кПллекцОя</h3>
<p>
ВОЎ кПллекцОй ГрОМстПуМ заЎается «ЌакрПфайлаЌО» в ЎОректПрОО ЌакрПса (<i>greenstone/macros</i>>) О ЌПжет быть пПлМПстью ОзЌеМеМП с пПЌПщью ЌПЎОфОкацОй в файлах
 ЌакрПсПв. ЭтО ЌПЎОфОкацОО ОзЌеМят вОЎ всех
 кПллекцОй. ЧтПбы ОзЌеМОть вОЎ всегП лОшь ПЎМПй кПллекцОО, пПЌестОте сППтветствующОй ЌПЎОфОцОрПваММый ЌакрПс в файл МазваММый <i>extra.dm</i> в папке <i>macros</i> этПй кПллекцОО. НапрОЌер, эта кПллекцОя ОспПльзует файл <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>.\n
<p>

Для ПтЎелеМОя МекПтПрых
 Ўеталей презеМтацОО Пт ЌакрПфайлПв ГрОМстПуМ ОспПльзует  <i>Cascading Style Sheets</i> (сЌ. ЎПпПлМОтельМую ОМфПрЌацОя Ма <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a>), кПтПрые пПзвПляют ВаЌ устаМавлОвать шрОфты, цвета, ОМтервалы О ЎругОе элеЌеМты Ўля страМОц HTML. Ѐайл сП стаМЎартМыЌ МабПрПЌ стОлей в ГрОМстПуМ пПЌещеМ зЎесь: <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a> (ПМ пПЌещеМ в ЎОректПрОО <i>images</i>, пПтПЌу чтП ЌакрП файлы ЌПгут сПЎержать уЎПбМые ссылкО к этПй ЎОректПрОО.) Эта кПллекцОя ОЌеет вспПЌПгательМый стОлевПй файл, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, кПтПрый сПЎержОт МескПлькП кПЌЌеМтарОев Ўля тех
, ктП Ме разбОрается с CSS. НекПтПрые ЌакрПсы в <i>extra.dm</i> ОЌеют ссылкО к ОзПбражеМОяЌ пПЌещеММыЌ в <i>greenstone/collect/_cgiargc_/images</i>.\n 

<p>

МакрПфайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> Птвергает часть ЌакрПсПв, кПтПрые ОспПльзуются в Greenstone пП уЌПлчаМОю. В ЌакрПфайлах
 \"\#\" ПпПвещает П стрПке кПЌЌеМтарОев (<i>extra.dm</i> сПЎержОт кПЌЌеМтарОО, чтПбы пПЌПчь ПбъясМОть, чтП ПМ Ўелает). СаЌО ЌакрПсы сППбщаются путеЌ пПЎчеркОваМОя, О ПМО ЌПгут Пбращаться к ЎругОЌ ЌакрПсаЌ. ЭтП ПзМачает, чтП сПЎержаМОе страМОцы ЌПжет быть разбОтП Ма ЌМПгОе ЌалеМькОе кускО, О ЌПгут вПзМОкать труЎМПстО прО рабПте пП цепО, кПтПрую ЌакрПс вызывает. К счастью, ОзЌеМеМОя в ЌакрПсах
, пПЎПбМП ОзЌеМеМОяЌ в фПрЌатМых
 стрПках
, вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете сервер лПкальМПй бОблОПтекО Greenstone, в случае чегП сервер МужЎается в перезагрузке. ЭтП Пблегчает эксперОЌеМтОрПваМОе путеЌ реЎактОрПваМОя ЌакрПфайлПв.
<p>


МакрПсы сгруппОрПваМы в «пакеты». НП кажЎый пакет Ме ПбязательМП разЌещается в ПтЎельМПЌ файле. <i>ГлПбальМый</i>  пакет, бПльшая часть кПтПрПгП Мах
ПЎОтся в файле <a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (часть егП Мах
ПЎОтся также в спецОфОческОх
 языкПвых
 ЌакрПфайлах
 тОпа <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> О <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>), сПЎержОт ЌакрПсы пП уЌПлчаМОю, кПтПрые ЌПгут быть ПтвергМутыЌО ЌакрПсаЌО в ЎругОх
 пакетах
. ЗЎесь ОЌеется часть <i>extra.dm</i>.

<pre>
##########################################################################\n
package Global\n
##########################################################################\n
\n
&#095;starthighlight&#095; {&lt;b&gt;}\n
&#095;endhighlight&#095;   {&lt;/b&gt;}\n
\n
&#095;navbarspacer&#095; { \n
&lt;br/&gt;\n
&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
&lt;br/&gt;\n
}\n
</pre>\n

кПтПрая ПпреЎеляет глПбальМые ЌакрПсы, зМачеМОя <i>starthighlight</i> О <i>endhighlight</i> ОспПльзуются Ўля пПЎсвечОваМОя терЌОМПв запрПса прО преЎставлеМОО ЎПкуЌеМта. ПП уЌПлчаМОю ЎПлжеМ быть устаМПвлеМ желтый фПМ. Первая спецОфОкацОя вЌестП этПгП выЎеляет запрПс пПлужОрМыЌ шрОфтПЌ.
<p>

СлеЎующОй ЌакрПс <i>navbarspacer</i> служОт Ўля тПгП, чтПбы ПтЎелОть кМПпку пПОска О кМПпкО классОфОкатПрПв в МавОгацОПММПй лОМейке. ОбычМП этП х
ПрПшП зМакПЌая в Greenstone гПрОзПМтальМая зелеМая лОМейка. СлеЎущее ПпреЎелеМОе ОЌеет эффект вертОкальМПгП распПлПжеМОя кМПпПк, ПЎМа МаЎ ЎругПй.
<p>
<pre>
&#095;navbarspacer&#095; {&lt;br\/&gt;}
</pre>\n
<p>

ОпреЎелеМОе <i>navbarspacer</i>, ЎаММПе раМее ОспПльзует рОсуМПк <i>horzline.gif</i> в качестве разЎелОтеля (этПт рОсуМПк сПЎержОтся в папке кПллекцОО пПЎ МазваМОеЌ <i>images</i>). Эффект вОЎеМ в Мачале этПй страМОцы.\n

<p>

РазЌещеМОе кМПпПк гПрОзПМтальМП, все ещё ОспПльзуя <i>horzline.gif</i>, вЌестП зелеМПй лОМейкО как разЎелОтеля, уЎаляя тэгО <i>br</i> О ПпреЎеляет телП ЌакрПса (часть в фОгурМых
 скПбках
), как:

<p>
<pre>
&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
</pre>\n

<p>
ПереЌеММая <i>widthtspace</i> заЎаёт шОрОМу прПЌежутка ЌежЎу кМПпкаЌО, кПтПрую вычОсляет Greenstone.
<p>


Часть <i>extra.dm</i>, вПспрПОзвеЎеММая МОже, переПпреЎеляет ЌакрПсы в пакете <i>Style</i>, кПтПрый Птвечает за сПзЎаМОе загПлПвка О МОжМей сМПскО Ма кажЎПй страМОце:\n

<p>

<pre>
##########################################################################\n
package Style\n
##########################################################################\n
\n

&#095;collectionspecificstyle&#095; {\n
&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
&lt;style&gt;\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
&lt;/style&gt;\n
}\n
\n
&#095;pagebanner&#095; {\n
&lt;div class=\"pageinfo\"&gt; \n
&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
&lt;/div&gt;\n
}\n
</pre>\n

<p>

ЌакрПс загПлПвка страМОцы Greenstone, кПтПрый Мазывается <i>header</i> в <a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, печатает МаОЌеМПваМОе кПллекцОО О её эЌблеЌу О связывает её с ЎПЌашМей страМОцей, пПЌПщью О страМОцаЌО преЎпПчтеМОй. ОМ вызывает ЌакрПс <i>htmlhead</i>, кПтПрый ПпреЎеляет МачалП файла HTML. ЭтП вызывает ЌакрП <i>cssheader</i>, кПтПрый пПказывает ОМфПрЌацОю П стОле страМОцы. ЭтПт ЌакрП включает ЌакрП <i>collectionspecificstyle</i>, кПтПрый пПзвПляет ЎПбавОть к кПллекцОО стОлОстОческОе элеЌеМты к МабПру пП уЌПлчаМОю.

<p>
ЧтПбы ОспПльзПвать сПвершеММП ЎругПй стОль в кПллекцОО, выберОте ЌакрП <i>cssheader</i> в <i>extra.dm</i>. ЧтПбы всегП лОшь ЎПбавОть МескПлькП МПвых
 стОлевых
 ПпреЎелеМОй к стОлю пП уЌПлчаМОю, выберОте <i>collectionspecificstyle</i> в <i>extra.dm</i>. ЭтП былП сЎелаМП в этПй кПллекцОО. ВышеуказаМый ЌакрП <i>collectionspecificstyle</i> сПЎержОт таблОцу стОлей кПллекцОО, О переПпреЎеляет пару стОлей Ўля ОзПбражеМОй: ЗелеМая фПМПвая плаМка с завОткаЌО Осчезла, а фПМ МавОгацОПММПй паМелО теперь сОМОй.\n

<p>
МакрПс загПлПвкО страМОцы также вызывает <i>pagebanner</i>, чтПбы включОть эЌблеЌу кПллекцОО, кМПпкО home/help/preferences О ОзПбражеМОе слева вверх
у, кПтПрПе ОЎеМтОфОцОрует страМОцу (П страМОце, пПОскПвая страМОца О т.ÐŽ.). ПрПграЌЌа, указаММая выше, ПпреЎеляет баММер, чтПбы пПЎавОть этО ОзПбражеМОя. Как Вы ЌПжете вОЎеть, ПМО Ме пПявляются Маверх
у этПй страМОцы.\n 

<p>
СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс Ўля ПпОсаМОя О <i>пакете</i>, сПЎержащОйся в <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>, кПтПрый геМерОрует страМОцу <i>«Об этПй кПллекцОО»</i>, кПтПрую Вы вОЎОте сейчас.

<pre>
##########################################################################\n
package about\n
##########################################################################\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;textabout&#095;\n
\n
&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
&#095;help:simplehelp&#095;\n
}
</pre>\n

МакрПсПЎержаМОе Ўля текста <i>О страМОце</i> ПбычМП сПЎержОт МавОгацОПММую лОМейку (сП ссылкаЌО к ППОску О любыЌ классОфОкатПраЌ), сПпрПвПжЎаеЌую ПпОсаМОеЌ «Об этПй кПллекцОО» О текстПЌ «Как МайтО ОМфПрЌацОю». ППскПльку ПМО ОзЌеМяются Пт ПЎМПй кПллекцОО к ЎругПй, ЌакрПc <i>navigationbar</i> ПпреЎелеМ вМутрО Greenstone О ОспПльзует ЌакрПс <i>navbarspacer</i>, кПтПрый был ПбсужЎеМ выше. МакрПс <i>content</i> Ўля ПпОсаМОя <i>О страМОце</i>, преЎставлеММый выше, ПтлОчается Пт ПбычМПгП (такПгП, как кПллекцОО <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">Demo</a>) теЌ, чтП МавОгацОПММая лОМейка Ме ПтцеМтрОрПваМа О зЎесь Мет МОкакПгП пПля пПОска.
<p>

СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс в пакете <i>запрПса</i> (<i>query</i>) в <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>), кПтПрый ОспПльзуется Ўля геМерацОО <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">пПОскПвПй страМОцы</a>.

<pre>
##############################################################################\n
package query\n
##############################################################################\n

&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&lt;center&gt;\n
&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
&lt;/center&gt;\n
&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
&lt;center&gt;\n
&#095;searchhistorylist&#095;\n
&lt;/center&gt;)\n
&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
&lt;br&gt;\n
}\n
</pre>\n

ОпреЎелеМОе <i>сПЎержаМОя</i> в стаМЎартМПЌ пакете <i>запрПса</i> пПЎПбМП версОО, ЎаММПй выше, за ОсключеМОеЌ тПгП, чтП ПМП пПЌещает в цеМтре ЌакрПс <i>navigationbar</i>, тПгЎа как вышеупПЌяМутая версОя Ме Ўелает этПгП О включает ЎПпПлМОтельМую зелеМую лОМейку. СравМОте <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">тП</a> О <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">этП</a>.
<p>


Ѐайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> также переПпреЎеляет ЌакрПс в пакете <i>ЎПкуЌеМт</i> (<i>document</i>), кПтПрый ОспПльзуется Ўля тПгП, чтПбы пПказать ЎПкуЌеМты (сЌ. <a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). ЀактОческО страМОцы, геМерОруеЌые классОфОкатПраЌО (МапрОЌер, спОскПЌ МаОЌеМПваМОй) также управляются О этОЌО ЌакрПсаЌО.

<pre>
##########################################################################\n
package document\n
##########################################################################\n
\n
&#095;textheader&#095; {\n
&#095;cgihead&#095;\n
&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
}\n
\n
&#095;content&#095; {\n
&#095;navigationbar&#095;\n
\n
&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
&lt;p style=\"text-align: center;\"&gt;\n
&#095;phindclassifier&#095;\n
&#095;collageclassifier&#095;\n
&lt;/p&gt;\n
)\n
\n
&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
&lt;ul id=\"searchresults\"&gt;\n
&#095;prevsearchresult&#095;\n
&#095;nextsearchresult&#095;\n
&lt;/ul&gt;)\n
\n
&lt;div class=\"document\"&gt;\n
}
</pre>\n

ГрОМстПуМ аММулОрует ЌакрП <i>header</i>, еслО ОзПбражеМ ЎПкуЌеМт (а Ме классОфОкатПр). ПреЎпПлПжОЌ, Ќы Ме х
ПтОЌ этПгП. ВышестПящОй кПЎ переПпреЎеляет ЌакрП <i>textheader</i> (ПбычМП ПпреЎелеММПЌ в <i>document.dm</i>) в качестве первПМачальМПгП сПЎержаМОя ЌакрП <i>header</i>. ВышестПящее ПпреЎелеМОе  <i>content</i> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
"