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

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

buildtype   mgpp
infodbtype  gdbm

indexes     text dls.Title,ex.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 -partition_type_within_level constant_size

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

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

classify    List -metadata dls.Keyword -buttonname Howto -partition_type_within_level constant_size

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_[dmsafe: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"

# strings that use macros
# these don't need translating unless you want something different from the
# default
collectionmeta  .text [l=en] "_labeltext_"
collectionmeta  .dls.Title,Title [l=en] "_labelTitle_"
collectionmeta  .dls.Subject [l=en] "_labelSubject_"
collectionmeta  .dls.Organization [l=en] "_labelOrganization_"
collectionmeta  .dls.Keyword [l=en] "_labelHowto_"

collectionmeta  .document [l=en] "_textbook_"
collectionmeta  .section [l=en] "_textchapter_"

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

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"

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

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

# -- Simplified Chinese strings ----------------
collectionmeta  collectionname [l=zh] "Garish版本的挔瀺銆藏"

# -- 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>greenstone/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 las macros modificadas en un archivo llamado <i>extra.dm</i> en el directorio <i>macros</i> de la colección. 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 hoja de estilos Greenstone estándar está guardada en <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Esta colección especifica una hoja de estilo auxiliar, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, a ser usada en adición a la default. Esto incluye algunos comentarios para aquellos que no están familiarizados con hojas de estilo. Algunas de las macros 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 \"_\" 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> dada anteriormente usa la imagen <i>horzline.gif</i> como un separador (esta imagen 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 estilo 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, llamada <i>header</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. Esta llama a la macro <i>cssheader</i> la cual le imprime el formato a la página. Esta macro incluye a <i>collectionspecificstyle</i> la cual permite a la colección sumar algunos elementos de estilo al default.

<p>
Para utilizar enteramente el nuevo estilo para la colección, especifique la macro <i>cssheader</i> en <i>extra.dm</i>. Para simplemente agregar un par de declaraciones de estilos al estilo por defecto, especifique <i>collectionspecificstyle</i> en <i>extra.dm</i>. Eso es lo que la colección ha hecho. La macro mencionada arriba, <i>collectionspecificstyle</i> incluye el \'stylesheet\' propio de la colección, y a la vez anula un par de declaraciones de imagen, 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 banner con el fin de suprimir estas imágenes, a excepción del botón de la página de inicio-- 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 <i>content</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 ésta cambia de una colección a otra, la macro <i>navigationbar</i> es definida internamente por Greenstone y utiliza la macro <i>navbarspacer</i> descripta 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 <i>query</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>content</i> en el paquete de <i>query</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 <i>document</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 la 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 la macro <i>textheader</i> (normalmente definida 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 navegació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> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
"

# -- Simplified Chinese text ----------------
collectionmeta  collectionextra [l=zh] "
本銆藏所包
含的文档䞎GreenstoneæŒ”ç€ºéŠ†è—äž­çš„äž€æ ·ïŒŒäœ†å…
¶å€–观被曎改䞺garishé£Žæ Œã€‚\n

<h3>本銆藏劂䜕工䜜</h3>\n

<p>Greenstone銆藏的倖观由<i>greenstone/macros</i>目圕䞋的\"宏文件\"定义修改这些文件的内
容将曎改所有銆藏的倖观。
劂果只修改䞀䞪銆藏的倖观将修改后的宏攟å…
¥è¯¥éŠ†è—<i>macros</i>目圕䞋的<i>extra.dm</i>文件䞭。䟋劂这䞪銆藏䜿甚这䞪文件
<a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>。\n

<p>䞺了将呈现细节从宏文件䞭分犻出来Greenstone䜿甚<i>å±‚çº§æ ·åŒè¡š</i>曎倚信息请参见<a href=\"http://www.w3.org/Style/CSS/\">
http://www.w3.org/Style/CSS/</a>这å…
è®žæŒ‡å®šHTML页面的字䜓、颜色、闎隔以及å…
¶ä»–å…
ƒçŽ ã€‚æ ‡å‡†çš„Greenstoneæ ·åŒè¡šäœäºŽ
<a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>ã€‚æœ¬éŠ†è—äœ¿ç”šäž€äžªé™„å±žçš„æ ·åŒè¡šïŒŒ
<a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>ïŒŒäžŽçŒºçœæ ·åŒè¡šäž€èµ·äœ¿ç”šã€‚è¯¥æ ·åŒè¡šåŒ…
括䞀些泚释信息以
äŸ¿äžç†Ÿæ‚‰å±‚çº§æ ·åŒè¡šçš„äººç†è§£ã€‚<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>这些宏按\"packages\"包
分组。䜆是并䞍每䞪包
郜䞍需芁䞀䞪单独的文件。<i>Global</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>的倌被甚于圚星瀺文档时高亮星瀺查询词。猺省情
况时将背景讟眮成黄色。䞊面的第䞀䞪讟眮即将查询词的高亮讟眮䞺黑䜓。\n

<p>接䞋来<i>navbarspacer</i>宏莟莣将浏览条䞭的搜玢按钮䞎分类按钮分匀。通垞情
况䞋Greenstone有䞀䞪氎平的绿色的浏览条。接䞋来的定义将垂盎眗列这些按钮
䞀䞪圚及䞀䞪之䞊。
<pre>
&#095;navbarspacer&#095; {&lt;br\/&gt;}
</pre>\n

前面给出的<i>navbarspacer</i>定义甚到了<i>horzline.gif</i>囟片䜜䞺分隔笊这䞪囟片圚銆藏的<i>images</i>目圕䞭。圚这䞪页面的顶端即可看到效果。\n

<p>若芁按氎平方匏排列这些按钮并仍䜿甚<i>horzline.gif</i>è€Œäžæ˜¯ç»¿è‰²æ¡äœœäžºåˆ†éš”ç¬ŠïŒŒåˆ é™€<i>br</i>æ ‡è®°å¹¶å®šä¹‰å®çš„äž»äœ“ïŒˆåœšå€§æ‹¬å·äž­çš„éƒšåˆ†ïŒ‰äžºïŒš
<pre>
&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
</pre>\n

<i>widthtspace</i>变量定义了按钮闎的宜床Greenstone将计算这䞪宜床。\n

<p>䞋面所列的<i>extra.dm</i>郚分重定义了<i>Style</i>包
äž­çš„å®ïŒŒè¿™äžªå®å°†èŽŸèŽ£åˆ›å»ºæ¯äžªé¡µé¢çš„é¡µå€Žå’Œé¡µå°ŸïŒŒå¹¶å®šä¹‰åžžç”šçš„æ ·åŒä¿¡æ¯ïŒš

<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的片倎宏即<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>侭的<i>header</i>将星瀺该銆藏的名称或者
æ ‡å¿—ïŒŒ
并铟接到䞻页、垮助页面䞎偏奜页面。它将调甚<i>htmlhead</i>宏这䞪宏将星瀺HTML文件的匀倎郚分。这里调甚<i>cssheader</i>宏
è¿™äžªå®æ˜Ÿç€ºé¡µé¢çš„æ ·åŒä¿¡æ¯ã€‚è¿™é‡ŒåŒ…
括了<i>collectionspecificstyle</i>宏这䞪宏å…
è®žéŠ†è—åœšçŒºçœæ ·åŒçš„åŸºç¡€äžŠæ·»åŠ å…
¶ä»–æ ·åŒå…
ƒçŽ 。

<p>若芁圚该銆藏䞭䜿甚å…
šæ–°çš„æ ·åŒïŒŒåœš<i>extra.dm</i>䞭定义<i>cssheader</i>å®ã€‚è‹¥åªæ˜¯åœšçŒºçœæ ·åŒäž­æ·»åŠ å‡ äžªæ ·åŒå®šä¹‰ïŒŒåœš<i>extra.dm</i>䞭定义
<i>collectionspecificstyle</i>。这就是銆藏的圢成方匏。䞊面的<i>collectionspecificstyle</i>宏包
å«äº†è¯¥éŠ†è—è‡ªå·±çš„æ ·åŒè¡šïŒŒåŒæ—¶ä¹ŸèŠ†å†™äº†äž€äº›å›Ÿç‰‡çš„å®šä¹‰ïŒŒ
去掉了绿色旋蜬条纹的背景囟片并将浏览条的悬停背景变䞺蓝色。

<p>页面倎宏也调甚<i>pagebanner</i>来包
å«è¯¥éŠ†è—çš„æ ‡å¿—ïŒŒäž»é¡µ/垮助/åå¥œæŒ‰é’®ïŒŒä»¥åŠå·ŠäžŠæ–¹æŒ‡ç€ºåœ“å‰é¡µé¢çš„å›Ÿç‰‡ïŒˆè¯Žæ˜Žé¡µé¢ïŒŒæœçŽ¢é¡µé¢ç­‰ç­‰ïŒ‰ã€‚äžŠé¢çš„ä»£ç é‡
å®šä¹‰çš„æ ‡å¿—é™€åŽ»äº†æ‰€æœ‰å›Ÿç‰‡ïŒŒé™€äº†äž»é¡µæŒ‰é’®ä¹‹å€–â€”â€”è¿™äº›å›Ÿç‰‡æ²¡æœ‰å‡ºçŽ°åœšè¿™äžªé¡µé¢çš„é¡¶ç«¯ã€‚\n

<p><i>extra.dm</i>接䞋来的䞀郚分重新定义了<i>about</i>包
䞭的宏包
含圚<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>䞭
这䞪宏将产生\"å…
³äºŽæœ¬éŠ†è—\"页面劂䞋所瀺

<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>About</i>页面的<i>content</i>宏通垞包
含了浏览条铟接到<i>搜玢</i>䞎任意䞀䞪分类噚接䞋来是\"å…
³äºŽæœ¬éŠ†è—\"侎\"劂䜕扟到盞å…
³ä¿¡æ¯\"çš„æ–‡æœ¬ã€‚å› äžºè¿™äžª
宏是随銆藏的䞍同而䞍同<i>navigationbar</i>宏是由Greenstone内
郚定义的而䞔䜿甚前面定义的<i>navbarspacer</i>宏。<i>å…
³äºŽ</i>页面的<i>content</i>宏
劂䞊面所瀺䞍同于垞规的宏比劂挔瀺銆藏的宏见<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">这里</a>䞍同之倄圚于浏览条并䞍是居
䞭星瀺的
而䞔没有搜玢框。\n

<p><i>extra.dm</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>query</i>䞭定义的<i>content</i>å®äžŽäžŠè¿°å®šä¹‰ç±»äŒŒïŒŒé™€äº†æ ‡å‡†å®šä¹‰äŒšå±…
䞭星瀺<i>navigationbar</i>宏而䞊述定义䞍居
䞭星瀺而䞔它还额倖包
含了䞀䞪绿色条。
比蟃<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">这䞪</a>和<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">这䞪</a>.\n

<p><a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>文件也重新定义了<i>document</i>包
䞭的宏这些宏被甚于星瀺文档参见
<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>。事实䞊分类噚所创建的页面䟋劂题名列衚也是被这些宏所定义。

##########################################################################\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将芆写<i>header</i>宏。假讟我们䞍想让GreenstoneèŠ†å†™è¿™äžªå®ïŒŒåˆ™äžŠé¢çš„ä»£ç å°†é‡æ–°å®šä¹‰<i>textheader</i>宏
通垞圚<i>document.dm</i>䞭定义并䜜䞺原始的<i>header</i>宏的内
容。䞊述<i>content</i>çš„å®šä¹‰èŠ†å†™äº†çŒºçœçš„å€ŒïŒŒå› æ­€æµè§ˆæ¡ä¹ŸäžäŒšå±…
䞭星瀺。
"