root/documented-example-collections/trunk/garish/etc/collect.cfg @ 18738

Revision 18738, 52.5 KB (checked in by oranfry, 10 years ago)

the rest of the documented example collections

  • Property svn:executable set to *
Line 
1creator     greenstone@cs.waikato.ac.nz
2maintainer  greenstone@cs.waikato.ac.nz
3public      true
4
5beta        false
6
7plugin      HTMLPlug -description_tags
8plugin      WordPlug 
9plugin      GAPlug
10plugin      ArcPlug
11plugin      RecPlug -use_metadata_files
12
13indexes     section:text section:Title document:text
14
15classify    Hierarchy -metadata dls.Subject -sort Title -buttonname Subject
16classify    Hierarchy -hlist_at_top -metadata dls.AZList -sort Title -buttonname Title
17classify    Hierarchy -metadata dls.Organization -sort Title -buttonname Organization
18classify    Hierarchy -metadata dls.Keyword -sort Title -buttonname Howto
19
20format VList "<td valign=top>[link][icon][/link]</td>
21    <td valign=top>[highlight]{Or}{[Title],Untitled}[/highlight]
22    <i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages],
23    <br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i>
24    </td>"
25
26format SearchVList "<td valign=top>[link]<img src='[DocImage]' height='21'>[/link]</td>
27    <td>{If}{[parent(All': '):Title],
28      [parent(All': '):Title]:}[link][Title][/link]</td>"
29format DocumentText "<h2>[Title]</h2><p>[Text]</p>"
30
31
32collectionmeta  iconcollection [l=en] _httpprefix_/collect/garish/images/en/garish.gif
33collectionmeta  iconcollection [l=fr] _httpprefix_/collect/garish/images/fr/garish.gif
34collectionmeta  iconcollection [l=es] _httpprefix_/collect/garish/images/es/garish.gif
35collectionmeta  iconcollection [l=ru] _httpprefix_/collect/garish/images/ru/garish.gif
36
37
38# -- English strings ----------------
39collectionmeta  collectionname [l=en] "Garish version of demo collection"
40
41collectionmeta  .section:text [l=en] "chapters"
42collectionmeta  .section:Title [l=en] "section titles"
43collectionmeta  .document:text [l=en] "entire documents"
44
45
46# -- French strings ----------------
47collectionmeta  collectionname [l=fr] "Version Garish de la collection de démonstration"
48
49collectionmeta  .section:text [l=fr] "chapitres"
50collectionmeta  .section:Title [l=fr] "titres des sections"
51collectionmeta  .document:text [l=fr] "documents entiers"
52
53
54# -- Spanish strings ----------------
55collectionmeta  collectionname [l=es] "Versión Garish de la colección de muestra"
56
57collectionmeta  .section:text [l=es] "capítulos"
58collectionmeta  .section:Title [l=es] "títulos de las secciones"
59collectionmeta  .document:text [l=es] "documentos completos"
60
61
62# -- Russian strings ----------------
63collectionmeta  collectionname [l=ru] "Резкая версОя ЎеЌПМстрацОПМ-МПй кПллекцОО"
64
65collectionmeta  .section:text [l=ru] "Главы"
66collectionmeta  .section:Title [l=ru] "НазваМОя разЎелПв"
67collectionmeta  .document:text [l=ru] "ППлМые ЎПкуЌеМты"
68
69
70# -- English text ----------------
71collectionmeta  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
72
73<h3>How the collection works</h3>\n
74
75<p> 
76The appearance of Greenstone collections is defined by \"macro files\" in the
77<i>greenstone/macros</i> directory, and can be completely altered by changing the contents of these files.
78Editing 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/garish/macros/extra.dm</a>. \n
79<p>
80To separate presentation details from the macro files,
81Greenstone uses <i>Cascading Style Sheets</i>
82(see <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> for
83more information), which allow you to specify fonts, colours, spacings, and
84other elements for HTML pages. The standard Greenstone stylesheet is located in <a href=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (it is placed in the <i>images</i> directory because
85macro files can easily reference this directory). This collection specifies an auxiliary stylesheet, <a href=\"_httpcimages_/style.css\">greenstone/collect/garish/images/style.css</a>, to be used in addition to the default ones. It includes some comments
86for those unfamiliar with cascading style sheets. Some of the
87macros in <i>extra.dm</i> reference images that have been placed in
88<i>greenstone/collect/garish/images</i>.\n
89<p>
90The
91<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
92macro file overrides some of the macros that Greenstone
93uses by default. In macro files, the \"\#\" character signals a comment line
94(<i>extra.dm</i> is commented to help explain what it does).
95Macros themselves are signalled by
96underscores, and they can reference other macros. This means that the
97content of a page can be split into many small chunks, and it can be
98difficult to work through the chain of which macro calls what. Fortunately,
99changes in macros (like changes in format strings) take effect immediately
100unless you are using the Greenstone local library server, in which case the
101server needs to be restarted. This makes it easy to experiment by editing
102the macro files.\n
103
104<p>
105Macros are grouped into \"packages\". But each package does not necessarily reside in
106a single file. The <i>Global</i> package, most of which is in file
107<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>
108(parts of it are also in the language-specific macro files such as
109<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> and
110<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
111contains default macros that can be overridden by macros in other packages. Here is the part
112of <i>extra.dm</i> that redefines global macros.
113<pre>
114##########################################################################\n
115package Global\n
116##########################################################################\n
117\n
118&#095;starthighlight&#095; {&lt;b&gt;}\n
119&#095;endhighlight&#095;   {&lt;/b&gt;}\n
120\n
121&#095;navbarspacer&#095; { \n
122&lt;br/&gt;\n
123&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;\n
124&lt;br/&gt;\n
125}\n
126</pre>\n
127The values of <i>starthighlight</i> and <i>endhighlight</i> are used to
128highlight query terms when displaying a document. The default is to set the
129background to yellow. The first specification above places query terms in
130bold instead.\n
131
132<p>
133Next, the <i>navbarspacer</i> macro is what separates the search button and
134classifier buttons in the navigation bar. It is normally Greenstone\'s
135familiar horizontal green bar. The following definition has the effect of
136stacking the buttons vertically, one above the other.
137<pre>
138&#095;navbarspacer&#095; {&lt;br\/&gt;}
139</pre>\n
140
141 The definition of <i>navbarspacer</i> given earlier uses the image
142<i>horzline.gif</i> as a separator (this image appears in the
143<i>images</i> directory of the collection). The effect can be seen at the top of this page.\n
144
145<p>
146To arrange the buttons horizontally, still using
147<i>horzline.gif</i> instead of the green bar as separator,
148remove the <i>br</i> tags and define the body of the macro
149(the part in curly brackets) to be:
150<pre>
151&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
152   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
153</pre>\n
154
155The <i>widthtspace</i> variable gives the width of the gap between the
156buttons, which Greenstone calculates.\n
157
158<p>
159The part of <i>extra.dm</i> reproduced below redefines macros in the
160<i>Style</i> package, which is responsible for creating the header and
161footer of every page, and defining common style information:
162<pre>
163##########################################################################\n
164package Style\n
165##########################################################################\n
166\n
167
168&#095;collectionspecificstyle&#095; {\n
169&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
170   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
171&lt;style&gt;\n
172body.bgimage \{ background-image: none; \}\n
173span.navlink:hover \{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \}\n
174&lt;/style&gt;\n
175}\n
176\n
177&#095;pagebanner&#095; {\n
178&lt;div class=\"pageinfo\"&gt; \n
179&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
180&lt;/div&gt;\n
181}\n
182</pre>\n
183
184Greenstone\'s page header macro, which is called <i>header</i> in
185<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>,
186prints the collection\'s name or logo, and links to the
187home, help, and preferences pages. It calls the macro <i>htmlhead</i> which
188outputs 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.
189
190<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.
191
192<p>
193 The page header macro also calls <i>pagebanner</i> to include the collection\'s logo,
194home/help/preferences buttons, and the image at the top left that
195identifies the page (about page, search page, etc). The code above
196redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear
197at the top of this page.\n
198
199<p>
200The next part of <i>extra.dm</i> redefines macros in the <i>about</i>
201package (contained in
202<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), which generates the
203\"About this collection\" page that you are looking at now:
204<pre>
205##########################################################################\n
206package about\n
207##########################################################################\n
208\n
209&#095;content&#095; {\n
210&#095;navigationbar&#095;\n
211\n
212&#095;textabout&#095;\n
213\n
214&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
215&#095;help:simplehelp&#095;\n
216}
217</pre>\n
218
219The macro <i>content</i> for the <i>About</i> page normally contains the
220navigation bar (with links to <i>Search</i> and any classifiers),
221followed by \"About this collection\" and \"how to find information\"
222text. Because it changes from one collection to another, the
223<i>navigationbar</i> macro is defined internally by Greenstone, and uses
224the <i>navbarspacer</i> macro discussed above. The <i>content</i> macro for
225the <i>About</i> page, given above, differs from the regular one
226(such as the one for the DLS collection <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">here</a>)
227in that the navigation bar is not centered, and there is no search box.\n
228
229<p>
230The next part of <i>extra.dm</i> redefines macros in the <i>query</i> package (in
231<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
232which is used to generate the
233<a href=\"_gwcgi_?l=_cgiargl_&c=garish&a=q\">search page</a>:
234<pre>
235##############################################################################\n
236package query\n
237##############################################################################\n
238
239&#095;content&#095; {\n
240&#095;navigationbar&#095;\n
241\n
242&lt;center&gt;\n
243&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
244&lt;/center&gt;\n
245&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
246&lt;center&gt;\n
247&#095;searchhistorylist&#095;\n
248&lt;/center&gt;)\n
249&#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
250&lt;br&gt;\n
251}\n
252</pre>\n
253
254The definition of <i>content</i> in the standard <i>query</i> package is
255similar to the version given above, except that it centers the
256<i>navigationbar</i> macro, whereas the above version does not, and it
257includes an additional green bar. Compare
258<a href=\"_gwcgi_?l=_cgiargl_&c=garish&a=q\">this</a>
259and
260<a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">this</a>.\n
261
262<p>
263The file
264<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
265also redefines macros in the <i>document</i> package,
266which is used to display documents (see
267<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). In fact, pages
268generated by classifiers (e.g. lists of titles) are also governed by these macros.
269<pre>
270##########################################################################\n
271package document\n
272##########################################################################\n
273\n
274&#095;textheader&#095; {\n
275&#095;cgihead&#095;\n
276&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
277}\n
278\n
279&#095;content&#095; {\n
280&#095;navigationbar&#095;\n
281&lt;p&gt;\n
282&lt;center&gt;\n
283&#095;phindclassifier&#095;\n
284&#095;collageclassifier&#095;
285&lt;/center&gt;\n
286}
287</pre>\n
288
289Greenstone overrides the <i>header</i> macro if a document (and not a
290classifier) is being displayed. Suppose we don\'t want it to. The code
291above redefines the <i>textheader</i> macro (normally defined in
292<i>document.dm</i>) to be the content of the original <i>header</i> macro. The definition of <i>content</i> above overrides the
293default so that the navigation bar is not centered.
294"
295
296
297# -- French text ----------------
298collectionmeta  collectionextra [l=fr] "
299Cette 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.
300
301<h3>Comment la collection marche</h3>
302
303<p>
304L'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/garish/macros/extra.dm</a>. \n
305<p>
306Pour 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=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (il est placé dans le répertoire <i>images</i> car les macros fichiers peuvent reférer ce répertoire facilement). Cette collection spécifie un 'stylesheet' auxiliaire, <a href=\"_httpcimages_/style.css\">greenstone/collect/garish/images/style.css</a>, à être utilisé à part ceux du défaut. Ceci inclus quelques commentaires qui ont été placés dans <i>greenstone/collect/garish/images</i>.\n
307<p>
308Le fichier de macros <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
309l'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.
310
311<p>
312Les 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
313<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>),
314contient 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.
315
316<pre>
317##########################################################################\n
318package Global\n
319##########################################################################\n
320\n
321&#095;starthighlight&#095; {&lt;b&gt;}\n
322&#095;endhighlight&#095;   {&lt;/b&gt;}\n
323\n
324&#095;navbarspacer&#095; { \n
325&lt;br/&gt;\n
326&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;\n
327&lt;br/&gt;\n
328}\n
329</pre>\n
330
331Les 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.
332
333<p>
334Ensuite, 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.
335<pre>
336&#095;navbarspacer&#095; {&lt;br\/&gt; }
337</pre>\n
338
339La 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
340
341<p>
342Pour 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:
343<pre>
344&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
345   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
346</pre>\n
347
348La variable <i>widthtspace</i> donne la largeur de l'espace entre les boutons que Greenstone calcule.
349
350<p>
351La 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:
352
353<pre>
354##########################################################################\n
355package Style\n
356##########################################################################\n
357\n
358
359&#095;collectionspecificstyle&#095; {\n
360&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
361   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
362&lt;style&gt;\n
363body.bgimage \{ background-image: none; \}\n
364span.navlink:hover \{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \}\n
365&lt;/style&gt;\n
366}\n
367\n
368&#095;pagebanner&#095; {\n
369&lt;div class=\"pageinfo\"&gt; \n
370&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
371&lt;/div&gt;\n
372}\n
373</pre>\n
374
375La macro de l'en-tête de la page de Greenstone, appelée <i>header</i> dans
376<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.
377<p>
378Pour 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
379<p>
380La 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
381
382<p>
383La 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:
384<pre>
385##########################################################################\n
386package about\n
387##########################################################################\n
388\n
389&#095;content&#095; {\n
390&#095;navigationbar&#095;\n
391\n
392&#095;textabout&#095;\n
393\n
394&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
395&#095;help:simplehelp&#095;\n
396}
397</pre>\n
398
399La 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 DLS <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">ici</a>)
400en ce sens que la barre de navigation n'est pas centrée et qu'il n'y a pas de boîte de recherche.
401
402<p>
403La 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>),
404qui est utilisé pour générer la <a href=\"_gwcgi_?l=_cgiargl_&c=garish&a=q\">page de recherche</a>:
405<pre>
406##############################################################################\n
407package query\n
408##############################################################################\n
409
410&#095;content&#095; {\n
411&#095;navigationbar&#095;\n
412\n
413&lt;center&gt;\n
414&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
415&lt;/center&gt;\n
416&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
417&lt;center&gt;\n
418&#095;searchhistorylist&#095;\n
419&lt;/center&gt;)\n
420&#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
421&lt;br&gt;\n
422}\n
423</pre>\n
424
425La 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
426<a href=\"_gwcgi_?l=_cgiargl_&c=garish&a=q\">ceci</a> Ã  <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">ceci</a>.
427
428<p>
429Le 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
430<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.
431
432<pre>
433##########################################################################\n
434package document\n
435##########################################################################\n
436\n
437&#095;textheader&#095; {\n
438&#095;cgihead&#095;\n
439&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
440}\n
441\n
442&#095;content&#095; {\n
443&#095;navigationbar&#095;\n
444&lt;p&gt;\n
445&lt;center&gt;\n
446&#095;phindclassifier&#095;\n
447&#095;collageclassifier&#095;
448&lt;/center&gt;\n
449}
450</pre>\n
451
452Greenstone 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.
453"
454
455
456# -- Spanish text ----------------
457collectionmeta  collectionextra [l=es] "
458Esta 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.
459<p>
460
461<h3>Cómo trabaja esta colección</h3>
462<p>
463La 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/garish/macros/extra.dm</a>. \n
464
465<p>
466Para 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=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (está colocado en el directorio <i>images</i> porque los archivos macro puede sencillamente referir el directorio). Esta colección especifica una hojaestilo auxiliar, <a href=\"_httpcimages_/style.css\">greenstone/collect/garish/images/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/garish/images</i>.\n
467
468<p>
469
470El 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.
471<p>
472
473Las 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.
474<p>
475
476<pre>
477##########################################################################\n
478package Global\n
479##########################################################################\n
480\n
481&#095;starthighlight&#095; {&lt;b&gt;}\n
482&#095;endhighlight&#095;   {&lt;/b&gt;}\n
483\n
484&#095;navbarspacer&#095; { \n
485&lt;br/&gt;\n
486&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;\n
487&lt;br/&gt;\n
488}\n
489</pre>\n
490
491<p>
492Los 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.
493<p>
494
495A 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.
496<p>
497
498<pre>
499&#095;navbarspacer&#095; {&lt;br\/&gt;} \n
500</pre>\n
501<p>
502
503La 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
504<p>
505
506Para 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:
507<p>
508
509<pre>
510&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
511   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
512</pre>\n
513<p>
514
515La variable <i>widthtspace</i> da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
516<p>
517
518La 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:
519
520<p>
521
522<pre>
523##########################################################################\n
524package Style\n
525##########################################################################\n
526\n
527
528&#095;collectionspecificstyle&#095; {\n
529&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
530   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
531&lt;style&gt;\n
532body.bgimage \{ background-image: none; \}\n
533span.navlink:hover \{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \}\n
534&lt;/style&gt;\n
535}\n
536\n
537&#095;pagebanner&#095; {\n
538&lt;div class=\"pageinfo\"&gt; \n
539&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
540&lt;/div&gt;\n
541}\n
542</pre>\n
543
544<p>
545
546La 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.
547
548<p>
549Para 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.
550<p>
551La 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.
552<p>
553
554La 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.
555<p>
556
557<pre>
558##########################################################################\n
559package about\n
560##########################################################################\n
561\n
562&#095;content&#095; {\n
563&#095;navigationbar&#095;\n
564\n
565&#095;textabout&#095;\n
566\n
567&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
568&#095;help:simplehelp&#095;\n
569}
570</pre>\n
571<p>
572
573La 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 DLS que se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">aquí</a>) en que la barra de navegación no está centrada y no hay cuadro de búsqueda.
574<p>
575
576La 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=garish&a=q\">página de búsqueda</a>.
577<p>
578
579<pre>
580##############################################################################\n
581package query\n
582##############################################################################\n
583
584&#095;content&#095; {\n
585&#095;navigationbar&#095;\n
586\n
587&lt;center&gt;\n
588&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
589&lt;/center&gt;\n
590&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
591&lt;center&gt;\n
592&#095;searchhistorylist&#095;\n
593&lt;/center&gt;)\n
594&#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
595&lt;br&gt;\n
596}\n
597</pre>\n
598<p>
599
600La 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=garish&a=q\">ésta</a> con <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">ésta</a>.
601<p>
602
603El 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.
604<p>
605
606<pre>
607##########################################################################\n
608package document\n
609##########################################################################\n
610\n
611&#095;textheader&#095; {\n
612&#095;cgihead&#095;\n
613&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
614}\n
615\n
616&#095;content&#095; {\n
617&#095;navigationbar&#095;\n
618&lt;p&gt;\n
619&lt;center&gt;\n
620&#095;phindclassifier&#095;\n
621&#095;collageclassifier&#095;
622&lt;/center&gt;\n
623</pre>\n
624<p>
625
626Greenstone 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.
627"
628
629
630# -- Russian text ----------------
631collectionmeta  collectionextra [l=ru] "
632Эта ЎеЌПМстрацОПММая кПллекцОя сПЎержОт тПт же ЌатерОал, чтП О ПрОгОМальМая ЎеЌПМстрацОПММая кПллекцОя Greenstone, МП её вОЎ был ОзЌеМеМ., чтПбы улучшОть резкПсть.
633<p>
634
635<h3>Как рабПтает кПллекцОя</h3>
636<p>
637ВОЎ кПллекцОй ГрОМстПуМ заЎается «ЌакрПфайлаЌО» в ЎОректПрОО ЌакрПса (<i>greenstone/macros</i>>) О ЌПжет быть пПлМПстью ОзЌеМеМП с пПЌПщью ЌПЎОфОкацОй в файлах ÐŒÐ°ÐºÑ€ÐŸÑÐŸÐ². ЭтО ЌПЎОфОкацОО ОзЌеМят вОЎ всех ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹. ЧтПбы ОзЌеМОть вОЎ всегП лОшь ПЎМПй кПллекцОО, пПЌестОте сППтветствующОй ЌПЎОфОцОрПваММый ЌакрПс в файл МазваММый <i>extra.dm</i> в папке <i>macros</i> этПй кПллекцОО. НапрОЌер, эта кПллекцОя ОспПльзует файл <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/garish/macros/extra.dm</a>.\n
638<p>
639
640Для ПтЎелеМОя МекПтПрых ÐŽÐµÑ‚алей презеМтацОО Пт ЌакрПфайлПв ГрОМстПуМ ОспПльзует  <i>Cascading Style Sheets</i> (сЌ. ЎПпПлМОтельМую ОМфПрЌацОя Ма <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a>), кПтПрые пПзвПляют ВаЌ устаМавлОвать шрОфты, цвета, ОМтервалы О ЎругОе элеЌеМты Ўля страМОц HTML. Ѐайл сП стаМЎартМыЌ МабПрПЌ стОлей в ГрОМстПуМ пПЌещеМ зЎесь: <a href=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (ПМ пПЌещеМ в ЎОректПрОО <i>images</i>, пПтПЌу чтП ЌакрП файлы ЌПгут сПЎержать уЎПбМые ссылкО к этПй ЎОректПрОО.) Эта кПллекцОя ОЌеет вспПЌПгательМый стОлевПй файл, <a href=\"_httpcimages_/style.css\">greenstone/collect/garish/images/style.css</a>, кПтПрый сПЎержОт МескПлькП кПЌЌеМтарОев Ўля тех, ктП Ме разбОрается с CSS. НекПтПрые ЌакрПсы в <i>extra.dm</i> ОЌеют ссылкО к ОзПбражеМОяЌ пПЌещеММыЌ в <i>greenstone/collect/garish/images</i>.\n
641
642<p>
643
644МакрПфайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> Птвергает часть ЌакрПсПв, кПтПрые ОспПльзуются в Greenstone пП уЌПлчаМОю. В ЌакрПфайлах \"\#\" ПпПвещает П стрПке кПЌЌеМтарОев (<i>extra.dm</i> сПЎержОт кПЌЌеМтарОО, чтПбы пПЌПчь ПбъясМОть, чтП ПМ Ўелает). СаЌО ЌакрПсы сППбщаются путеЌ пПЎчеркОваМОя, О ПМО ЌПгут Пбращаться к ЎругОЌ ЌакрПсаЌ. ЭтП ПзМачает, чтП сПЎержаМОе страМОцы ЌПжет быть разбОтП Ма ЌМПгОе ЌалеМькОе кускО, О ЌПгут вПзМОкать труЎМПстО прО рабПте пП цепО, кПтПрую ЌакрПс вызывает. К счастью, ОзЌеМеМОя в ЌакрПсах, пПЎПбМП ОзЌеМеМОяЌ в фПрЌатМых ÑÑ‚рПках, вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете сервер лПкальМПй бОблОПтекО Greenstone, в случае чегП сервер МужЎается в перезагрузке. ЭтП Пблегчает эксперОЌеМтОрПваМОе путеЌ реЎактОрПваМОя ЌакрПфайлПв.
645<p>
646
647
648МакрПсы сгруппОрПваМы в «пакеты». НП кажЎый пакет Ме ПбязательМП разЌещается в ПтЎельМПЌ файле. <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>.
649
650<pre>
651##########################################################################\n
652package Global\n
653##########################################################################\n
654\n
655&#095;starthighlight&#095; {&lt;b&gt;}\n
656&#095;endhighlight&#095;   {&lt;/b&gt;}\n
657\n
658&#095;navbarspacer&#095; { \n
659&lt;br/&gt;\n
660&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;\n
661&lt;br/&gt;\n
662}\n
663</pre>\n
664
665кПтПрая ПпреЎеляет глПбальМые ЌакрПсы, зМачеМОя <i>starthighlight</i> О <i>endhighlight</i> ОспПльзуются Ўля пПЎсвечОваМОя терЌОМПв запрПса прО преЎставлеМОО ЎПкуЌеМта. ПП уЌПлчаМОю ЎПлжеМ быть устаМПвлеМ желтый фПМ. Первая спецОфОкацОя вЌестП этПгП выЎеляет запрПс пПлужОрМыЌ шрОфтПЌ.
666<p>
667
668СлеЎующОй ЌакрПс <i>navbarspacer</i> служОт Ўля тПгП, чтПбы ПтЎелОть кМПпку пПОска О кМПпкО классОфОкатПрПв в МавОгацОПММПй лОМейке. ОбычМП этП хПрПшП зМакПЌая в Greenstone гПрОзПМтальМая зелеМая лОМейка. СлеЎущее ПпреЎелеМОе ОЌеет эффект вертОкальМПгП распПлПжеМОя кМПпПк, ПЎМа МаЎ ЎругПй.
669<p>
670<pre>
671&#095;navbarspacer&#095; {&lt;br\/&gt;}
672</pre>\n
673<p>
674
675ОпреЎелеМОе <i>navbarspacer</i>, ЎаММПе раМее ОспПльзует рОсуМПк <i>horzline.gif</i> в качестве разЎелОтеля (этПт рОсуМПк сПЎержОтся в папке кПллекцОО пПЎ МазваМОеЌ <i>images</i>). Эффект вОЎеМ в Мачале этПй страМОцы.\n
676
677<p>
678
679РазЌещеМОе кМПпПк гПрОзПМтальМП, все ещё ОспПльзуя <i>horzline.gif</i>, вЌестП зелеМПй лОМейкО как разЎелОтеля, уЎаляя тэгО <i>br</i> О ПпреЎеляет телП ЌакрПса (часть в фОгурМых ÑÐºÐŸÐ±ÐºÐ°Ñ…), как:
680
681<p>
682<pre>
683&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
684   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
685</pre>\n
686
687<p>
688ПереЌеММая <i>widthtspace</i> заЎаёт шОрОМу прПЌежутка ЌежЎу кМПпкаЌО, кПтПрую вычОсляет Greenstone.
689<p>
690
691
692Часть <i>extra.dm</i>, вПспрПОзвеЎеММая МОже, переПпреЎеляет ЌакрПсы в пакете <i>Style</i>, кПтПрый Птвечает за сПзЎаМОе загПлПвка О МОжМей сМПскО Ма кажЎПй страМОце:\n
693
694<p>
695
696<pre>
697##########################################################################\n
698package Style\n
699##########################################################################\n
700\n
701
702&#095;collectionspecificstyle&#095; {\n
703&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
704   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
705&lt;style&gt;\n
706body.bgimage \{ background-image: none; \}\n
707span.navlink:hover \{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \}\n
708&lt;/style&gt;\n
709}\n
710\n
711&#095;pagebanner&#095; {\n
712&lt;div class=\"pageinfo\"&gt; \n
713&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
714&lt;/div&gt;\n
715}\n
716</pre>\n
717
718<p>
719
720ЌакрПс загПлПвка страМОцы 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>, кПтПрый пПзвПляет ЎПбавОть к кПллекцОО стОлОстОческОе элеЌеМты к МабПру пП уЌПлчаМОю.
721
722<p>
723ЧтПбы ОспПльзПвать сПвершеММП ЎругПй стОль в кПллекцОО, выберОте ЌакрП <i>cssheader</i> в <i>extra.dm</i>. ЧтПбы всегП лОшь ЎПбавОть МескПлькП МПвых ÑÑ‚Олевых ÐŸÐ¿Ñ€ÐµÐŽÐµÐ»ÐµÐœÐžÐ¹ к стОлю пП уЌПлчаМОю, выберОте <i>collectionspecificstyle</i> в <i>extra.dm</i>. ЭтП былП сЎелаМП в этПй кПллекцОО. ВышеуказаМый ЌакрП <i>collectionspecificstyle</i> сПЎержОт таблОцу стОлей кПллекцОО, О переПпреЎеляет пару стОлей Ўля ОзПбражеМОй: ЗелеМая фПМПвая плаМка с завОткаЌО Осчезла, а фПМ МавОгацОПММПй паМелО теперь сОМОй.\n
724
725<p>
726МакрПс загПлПвкО страМОцы также вызывает <i>pagebanner</i>, чтПбы включОть эЌблеЌу кПллекцОО, кМПпкО home/help/preferences О ОзПбражеМОе слева вверху, кПтПрПе ОЎеМтОфОцОрует страМОцу (П страМОце, пПОскПвая страМОца О т.ÐŽ.). ПрПграЌЌа, указаММая выше, ПпреЎеляет баММер, чтПбы пПЎавОть этО ОзПбражеМОя. Как Вы ЌПжете вОЎеть, ПМО Ме пПявляются Маверху этПй страМОцы.\n
727
728<p>
729СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс Ўля ПпОсаМОя О <i>пакете</i>, сПЎержащОйся в <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>, кПтПрый геМерОрует страМОцу <i>«Об этПй кПллекцОО»</i>, кПтПрую Вы вОЎОте сейчас.
730
731<pre>
732##########################################################################\n
733package about\n
734##########################################################################\n
735\n
736&#095;content&#095; {\n
737&#095;navigationbar&#095;\n
738\n
739&#095;textabout&#095;\n
740\n
741&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
742&#095;help:simplehelp&#095;\n
743}
744</pre>\n
745
746МакрПсПЎержаМОе Ўля текста <i>О страМОце</i> ПбычМП сПЎержОт МавОгацОПММую лОМейку (сП ссылкаЌО к ППОску О любыЌ классОфОкатПраЌ), сПпрПвПжЎаеЌую ПпОсаМОеЌ «Об этПй кПллекцОО» О текстПЌ «Как МайтО ОМфПрЌацОю». ППскПльку ПМО ОзЌеМяются Пт ПЎМПй кПллекцОО к ЎругПй, ЌакрПc <i>navigationbar</i> ПпреЎелеМ вМутрО Greenstone О ОспПльзует ЌакрПс <i>navbarspacer</i>, кПтПрый был ПбсужЎеМ выше. МакрПс <i>content</i> Ўля ПпОсаМОя <i>О страМОце</i>, преЎставлеММый выше, ПтлОчается Пт ПбычМПгП (такПгП, как кПллекцОО <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">DLS</a>) теЌ, чтП МавОгацОПММая лОМейка Ме ПтцеМтрОрПваМа О зЎесь Мет МОкакПгП пПля пПОска.
747<p>
748
749СлеЎующая часть <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=garish&a=q\">пПОскПвПй страМОцы</a>.
750
751<pre>
752##############################################################################\n
753package query\n
754##############################################################################\n
755
756&#095;content&#095; {\n
757&#095;navigationbar&#095;\n
758\n
759&lt;center&gt;\n
760&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
761&lt;/center&gt;\n
762&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
763&lt;center&gt;\n
764&#095;searchhistorylist&#095;\n
765&lt;/center&gt;)\n
766&#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
767&lt;br&gt;\n
768}\n
769</pre>\n
770
771ОпреЎелеМОе <i>сПЎержаМОя</i> в стаМЎартМПЌ пакете <i>запрПса</i> пПЎПбМП версОО, ЎаММПй выше, за ОсключеМОеЌ тПгП, чтП ПМП пПЌещает в цеМтре ЌакрПс <i>navigationbar</i>, тПгЎа как вышеупПЌяМутая версОя Ме Ўелает этПгП О включает ЎПпПлМОтельМую зелеМую лОМейку. СравМОте <a href=\"_gwcgi_?l=_cgiargl_&c=garish&a=q\">тП</a> О <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">этП</a>.
772<p>
773
774
775Ѐайл <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>). ЀактОческО страМОцы, геМерОруеЌые классОфОкатПраЌО (МапрОЌер, спОскПЌ МаОЌеМПваМОй) также управляются О этОЌО ЌакрПсаЌО.
776
777<pre>
778##########################################################################\n
779package document\n
780##########################################################################\n
781\n
782&#095;textheader&#095; {\n
783&#095;cgihead&#095;\n
784&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
785}\n
786\n
787&#095;content&#095; {\n
788&#095;navigationbar&#095;\n
789&lt;p&gt;\n
790&lt;center&gt;\n
791&#095;phindclassifier&#095;\n
792&#095;collageclassifier&#095;
793&lt;/center&gt;\n
794}
795</pre>\n
796
797ГрОМстПуМ аММулОрует ЌакрП <i>header</i>, еслО ОзПбражеМ ЎПкуЌеМт (а Ме классОфОкатПр). ПреЎпПлПжОЌ, Ќы Ме хПтОЌ этПгП. ВышестПящОй кПЎ переПпреЎеляет ЌакрП <i>textheader</i> (ПбычМП ПпреЎелеММПЌ в <i>document.dm</i>) в качестве первПМачальМПгП сПЎержаМОя ЌакрП <i>header</i>. ВышестПящее ПпреЎелеМОе  <i>content</i> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
798"
Note: See TracBrowser for help on using the browser.